max/embassy
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

Merge pull request #224 from rukai/readme_examples

Browse Source 
Improve examples section of readme
This commit is contained in:
Dario Nieuwenhuis 2021-06-06 00:52:56 +02:00 committed by GitHub
commit 4dda7be968
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
1 changed files with 14 additions and 4 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

18
README.md
View File

@ -37,11 +37,21 @@ The `embassy-nrf` crate contains implementations for nRF 52 series SoCs.
- `gpiote`: GPIOTE driver. Allows `await`ing GPIO pin changes. Great for reading buttons or receiving interrupts from external chips.
- `rtc`: RTC driver implementing `Clock` and `Alarm`, for use with `embassy::executor`.
## Running the examples
## Examples
Examples are for the nRF52840 chip but should be easily adaptable to other nRF52 chips.
Examples are found in the `examples/` folder seperated by the chip manufacturer they are designed to run on:
* `examples/nrf` are designed to run on the `nrf52840-dk` board (PCA10056) but should be easily adaptable to other nRF52 chips and boards.
* `examples/rp` are for the RP2040 chip.
* `examples/stm32` are designed for the STM32F429ZI chip but should be easily adaptable to other STM32F4xx chips.
* `examples/std` are designed to run locally on your pc.
GPIO pins are set up for the `nrf52840-dk` board (PCA10056)
### Running examples
- Setup git submodules (needed for STM32 examples)
```
git submodule init
git submodule update
```
- Install `probe-run` with defmt support.
@ -57,7 +67,7 @@ cargo run --bin rtc_async
## Minimum supported Rust version (MSRV)
Only recent nighly supported. Nightly is required for:
Required nightly version is specified in the `rust-toolchain.toml` file. Nightly is required for:
- `generic_associated_types`: for trait funcs returning futures.
- `type_alias_impl_trait`: for trait funcs returning futures implemented with `async{}` blocks, and for `static-executor`.