Skip to content

Conversation

@DhruvaG2000
Copy link
Member

Add documentation for the Arduino Core API for zephyr which sits as an external module as of today.

.. code-block:: bash

git clone https://github.com/arduino/ArduinoCore-API # Any location
ln -s /<your>/<location>/ArduinoCore-API/api cores/arduino/.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

the destination is assuming folks are in the module's folder, which is very unlikely the case.

Copy link
Member

@Ayush1325 Ayush1325 Oct 18, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Can we just make the arduino core api repo an optional west project? Or maybe make both arduino core api and arduino zephyr project part of a group (disabled by default).

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Yeah no, this would not be added to the main Zephyr repo. But having the Arduino API as a zephyr module to simplify it's provisioning in people's workspace is a good idea for sure

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

having the Arduino API as a zephyr module to simplify it's provisioning in people's workspace is a good idea for sure

@kartben @Ayush1325 sorry I am not following this conversation too well, What's the conclusion on this one?
Should I add the arduino core zephyr to zephyr/west.yml ?

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

my suggestion was to contribute a zephyr/module.yml to https://github.com/arduino/ArduinoCore-API so that it could then be pulled as a module alongside "arduino-core-zephyr" ; this way simplifying the experience for folks who would not have to git clone and crerate symbolic links?

Copy link
Member

@Ayush1325 Ayush1325 Oct 31, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

my suggestion was to contribute a zephyr/module.yml to https://github.com/arduino/ArduinoCore-API so that it could then be pulled as a module alongside "arduino-core-zephyr" ; this way simplifying the experience for folks who would not have to git clone and crerate symbolic links?

What do you mean by pulled alongside arduion-core-zephyr?

Even if the ArduinoCore-API is a zephyr module, do we add it to the normal zephyr west.yaml? Or do we expect users to add the module manually to west.yaml?

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Or do we expect users to add the module manually to west.yaml?

yes, it's the whole point of this PR to document how users can add arduinocore-zephyr manually to their workspace, similar to all the others external modules documented hee https://docs.zephyrproject.org/latest/develop/manifest/index.html#external-projects-modules

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Got it, I missed that it will be an external module. Then it makes sense.

@DhruvaG2000 DhruvaG2000 force-pushed the arduino-api-doc branch 2 times, most recently from 4d9735b to 81d384c Compare October 26, 2025 17:21
Add documentation for the Arduino Core API for zephyr which sits
as an external module as of today.

Signed-off-by: Dhruva Gole <[email protected]>
@sonarqubecloud
Copy link

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

5 participants