diff options
| author | Román Cárdenas Rodríguez <rcardenas.rod@gmail.com> | 2025-02-18 09:39:38 +0100 |
|---|---|---|
| committer | Henrik Tjäder <henrik@tjaders.com> | 2025-03-12 19:41:40 +0000 |
| commit | 5d5ecb95c2dc52b414f5a2aeb3fa77b4089b6320 (patch) | |
| tree | f5f7bd7d7ba6a309226d389c649a6bd88f1eeda7 /book/en/src/starting_a_project.md | |
| parent | 4542367fc9f2683afa5cd02df7322654aef5eb10 (diff) | |
Adding docs about RISC-V
Diffstat (limited to 'book/en/src/starting_a_project.md')
| -rw-r--r-- | book/en/src/starting_a_project.md | 19 |
1 files changed, 19 insertions, 0 deletions
diff --git a/book/en/src/starting_a_project.md b/book/en/src/starting_a_project.md index c78c5a2..915ff31 100644 --- a/book/en/src/starting_a_project.md +++ b/book/en/src/starting_a_project.md @@ -12,6 +12,25 @@ protection using [`flip-link`]. There is also a multitude of examples provided b For inspiration, you may look at the [RTIC examples]. +## RTIC on RISC-V devices + +Even though RTIC was initially developed for ARM Cortex-M, it is possible to use RTIC on RISC-V devices. +However, the RISC-V ecosystem is more heterogeneous. +To tackle this issue, currently, RTIC implements three different backends: + +- **`riscv-esp32c3-backend`**: This backend provides support for the ESP32-C3 SoC. + In these devices, RTIC is very similar to its Cortex-M counterpart. + +- **`riscv-mecall-backend`**: This backend provides support for **any** RISC-V device. + In this backend, pending tasks trigger Machine Environment Call exceptions. + The handler for this exception source dispatches pending tasks according to their priority. + The behavior of this backend is equivalent to `riscv-clint-backend`. + The main difference of this backend is that all the tasks **must be** [software tasks](./by-example/software_tasks.md). + Additionally, it is not required to provide a list of dispatchers in the `#[app]` attribute, as RTIC will generate them at compile time. + +- **`riscv-clint-backend`**: This backend supports devices with a CLINT peripheral. + It is equivallent to `riscv-mecall-backend`, but instead of triggering exceptions, it triggers software interrupts via the `MSIP` register of the CLINT. + [`defmt`]: https://github.com/knurling-rs/defmt/ [`flip-link`]: https://github.com/knurling-rs/flip-link/ [RTIC examples]: https://github.com/rtic-rs/rtic/tree/master/examples |
