diff options
| author | Dario Nieuwenhuis <[email protected]> | 2024-01-11 21:23:07 +0100 |
|---|---|---|
| committer | Dario Nieuwenhuis <[email protected]> | 2024-01-11 21:23:07 +0100 |
| commit | e18d6737212fe9a2a606cef210c64bf45ecc925c (patch) | |
| tree | b883d932d82cc89a02ef5f7de6fc520521090676 /embassy-nrf/README.md | |
| parent | 0d62e9c96ca14d9d9596f72d090e41855050e83c (diff) | |
More readme fixes.
Diffstat (limited to 'embassy-nrf/README.md')
| -rw-r--r-- | embassy-nrf/README.md | 16 |
1 files changed, 13 insertions, 3 deletions
diff --git a/embassy-nrf/README.md b/embassy-nrf/README.md index 1ead96b2c..50662749d 100644 --- a/embassy-nrf/README.md +++ b/embassy-nrf/README.md | |||
| @@ -4,7 +4,7 @@ HALs implement safe, idiomatic Rust APIs to use the hardware capabilities, so ra | |||
| 4 | 4 | ||
| 5 | The Embassy nRF HAL targets the Nordic Semiconductor nRF family of hardware. The HAL implements both blocking and async APIs | 5 | The Embassy nRF HAL targets the Nordic Semiconductor nRF family of hardware. The HAL implements both blocking and async APIs |
| 6 | for many peripherals. The benefit of using the async APIs is that the HAL takes care of waiting for peripherals to | 6 | for many peripherals. The benefit of using the async APIs is that the HAL takes care of waiting for peripherals to |
| 7 | complete operations in low power mod and handling interrupts, so that applications can focus on more important matters. | 7 | complete operations in low power mode and handling interrupts, so that applications can focus on more important matters. |
| 8 | 8 | ||
| 9 | NOTE: The Embassy HALs can be used both for non-async and async operations. For async, you can choose which runtime you want to use. | 9 | NOTE: The Embassy HALs can be used both for non-async and async operations. For async, you can choose which runtime you want to use. |
| 10 | 10 | ||
| @@ -18,16 +18,26 @@ The `embassy-nrf` HAL supports most variants of the nRF family: | |||
| 18 | * nRF53 ([examples](https://github.com/embassy-rs/embassy/tree/main/examples/nrf5340)) | 18 | * nRF53 ([examples](https://github.com/embassy-rs/embassy/tree/main/examples/nrf5340)) |
| 19 | * nRF91 ([examples](https://github.com/embassy-rs/embassy/tree/main/examples/nrf9160)) | 19 | * nRF91 ([examples](https://github.com/embassy-rs/embassy/tree/main/examples/nrf9160)) |
| 20 | 20 | ||
| 21 | Most peripherals are supported. | 21 | Most peripherals are supported. To check what's available, make sure to pick the MCU you're targeting in the top menu in the [documentation](https://docs.embassy.dev/embassy-nrf). |
| 22 | |||
| 23 | For MCUs with TrustZone support, both Secure (S) and Non-Secure (NS) modes are supported. Running in Secure mode | ||
| 24 | allows running Rust code without a SPM or TF-M binary, saving flash space and simplifying development. | ||
| 22 | 25 | ||
| 23 | ## Time driver | 26 | ## Time driver |
| 24 | 27 | ||
| 25 | If the `time` feature is enabled, the HAL uses the RTC peripheral as a global time driver for [embassy-time](https://crates.io/crates/embassy-time), with a tick rate of 32768 Hz. | 28 | If the `time-driver-rtc1` feature is enabled, the HAL uses the RTC peripheral as a global time driver for [embassy-time](https://crates.io/crates/embassy-time), with a tick rate of 32768 Hz. |
| 26 | 29 | ||
| 27 | ## Embedded-hal | 30 | ## Embedded-hal |
| 28 | 31 | ||
| 29 | The `embassy-nrf` HAL implements the traits from [embedded-hal](https://crates.io/crates/embedded-hal) (v0.2 and 1.0) and [embedded-hal-async](https://crates.io/crates/embedded-hal-async), as well as [embedded-io](https://crates.io/crates/embedded-io) and [embedded-io-async](https://crates.io/crates/embedded-io-async). | 32 | The `embassy-nrf` HAL implements the traits from [embedded-hal](https://crates.io/crates/embedded-hal) (v0.2 and 1.0) and [embedded-hal-async](https://crates.io/crates/embedded-hal-async), as well as [embedded-io](https://crates.io/crates/embedded-io) and [embedded-io-async](https://crates.io/crates/embedded-io-async). |
| 30 | 33 | ||
| 34 | ## Interoperability | ||
| 35 | |||
| 36 | This crate can run on any executor. | ||
| 37 | |||
| 38 | Optionally, some features requiring [`embassy-time`](https://crates.io/crates/embassy-time) can be activated with the `time` feature. If you enable it, | ||
| 39 | you must link an `embassy-time` driver in your project. | ||
| 40 | |||
| 31 | ## EasyDMA considerations | 41 | ## EasyDMA considerations |
| 32 | 42 | ||
| 33 | On nRF chips, peripherals can use the so called EasyDMA feature to offload the task of interacting | 43 | On nRF chips, peripherals can use the so called EasyDMA feature to offload the task of interacting |
