Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Add documentation for Rust support #83715

Draft
wants to merge 4 commits into
base: main
Choose a base branch
from

Conversation

d3zd3z
Copy link
Collaborator

@d3zd3z d3zd3z commented Jan 8, 2025

This brings in some basic documentation for Rust support, as well as adding workflow support to build the rust docs as part of CI.

@zephyrbot
Copy link
Collaborator

zephyrbot commented Jan 8, 2025

The following west manifest projects have changed revision in this Pull Request:

Name Old Revision New Revision Diff
zephyr-lang-rust zephyrproject-rtos/zephyr-lang-rust@7af3db4 (v4.0-branch) zephyrproject-rtos/zephyr-lang-rust@f82407c (main) zephyrproject-rtos/[email protected]

Additional metadata changed:

Name URL Submodules West cmds module.yml
zephyr-lang-rust

DNM label due to: 1 project with metadata changes

Note: This message is automatically posted and updated by the Manifest GitHub Action.

@zephyrbot zephyrbot added manifest manifest-zephyr-lang-rust DNM This PR should not be merged (Do Not Merge) labels Jan 8, 2025
@d3zd3z d3zd3z force-pushed the r/docs-2025-01-08 branch 26 times, most recently from 89e25b8 to 45860a3 Compare January 13, 2025 22:48
@d3zd3z d3zd3z force-pushed the r/docs-2025-01-08 branch 2 times, most recently from 56c3f29 to c60aaf1 Compare January 14, 2025 19:44
Move to the latest version:

    commit f82407c13059528e88bfcc892a488504e9caa80c
    Author: David Brown <[email protected]>
    Date:   Thu Jan 16 17:05:59 2025 -0700

This brings in numerous features to the rust support including:

  - Simple logging through Zephyr's logging
  - Mutex/Condvar (k_mutex, k_condvar), Semaphores (k_sem), and Queue
    (k_queue)
  - A rust interface to timers, both waiting for events and callback based
  - A SpinMutex that protects data in a rust safe way using a spinlock
  - Some documentation for the rust support.  Documentation is generated,
    per-pr, on the module to allow preview
  - A dining philosopher sample that implements using several different
    mechanism.
  - Basic device support.  The device tree is imported into Rust, with a
    yaml file describing the association between DT nodes and devices.
  - Basic interface to GPIO and flash devices.

Signed-off-by: David Brown <[email protected]>
Create an initial document describing how to get started a Rust application
on Zephyr.

Signed-off-by: David Brown <[email protected]>
This adds a job that builds the rustdoc documentation.

Signed-off-by: David Brown <[email protected]>
@d3zd3z d3zd3z force-pushed the r/docs-2025-01-08 branch from c60aaf1 to 56dda2d Compare January 24, 2025 22:19
Include the generated Rust documentation in the published docs, both for PR
and for main, if they were generated.

Signed-off-by: David Brown <[email protected]>
@d3zd3z d3zd3z force-pushed the r/docs-2025-01-08 branch from 56dda2d to 19e46e6 Compare January 24, 2025 22:40
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
DNM This PR should not be merged (Do Not Merge) manifest manifest-zephyr-lang-rust
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants