Embassy RP2040 template

Links

Embassy docs:

• https://embassy.dev
• https://embassy.dev/book
• https://embassy.dev/book/#_a_basic_embassy_application
• https://embassy.dev/book/#_starting_a_new_project
• https://youtu.be/pDd5mXBF4tY - intro to embassy

Embassy repo:

• https://github.com/embassy-rs
• https://github.com/embassy-rs/embassy/tree/main/examples/rp - an rp2040 example
• https://github.com/embassy-rs/embassy/tree/main/examples/rp/src/bin/blinky.rs - the blinky for pico
• https://github.com/embassy-rs/embassy/tree/main/examples/rp/src/bin/wifi_blinky.rs - the blinky for pico w

Steps

How to use the template to generate a new project and flash into a target:

• https://github.com/bus710/embassy-rp2040-template

# Install rustup and probe-rs
$ curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
$ curl -LsSf https://github.com/probe-rs/probe-rs/releases/latest/download/probe-rs-tools-installer.sh | sh

# Install utilities
$ cargo install cargo-generate
$ cargo install elf2uf2-rs

# Get this template and generate a new project
$ git clone https://github.com/bus710/embassy-rp2040-template.git
$ cargo generate --path ./embassy-rp2040-template/

🤷   Project Name: test-a
🔧   Destination: test-a ...
🔧   project-name: test-a ...
🔧   Generating template ...
✔ 🤷   USB Support · false
✔ 🤷   Network Support · false
Memory Config
✔ 🤷   System Flash Size in KiB · 16384
✔ 🤷   Flash Reserved for Storage in KiB · 256
[ 1/16]   Done: .cargo/config.toml
[ 2/16]   Done: .cargo
[ 3/16]   Done: .gitignore
[ 4/16]   Done: .vscode/.gitignore
[ 5/16]   Done: .vscode/extensions.json
[ 6/16]   Done: .vscode/settings.json
[ 7/16]   Done: .vscode
[ 8/16]   Done: Cargo.lock
[ 9/16]   Done: Cargo.toml
[10/16]   Done: LICENSE
[11/16]   Done: build.rs
[12/16]   Ignored: memory.rhai
[13/16]   Done: memory.x
[14/16]   Done: rust-toolchain.toml
[15/16]   Done: src/main.rs
[16/16]   Done: src
🔧   Moving generated files into: `test-a`...
💡   Initializing a fresh Git repository
✨   Done! New project created test-a

# Build
$ cd test-a
$ cargo build --release

# Update the .cargo/cargo.toml to select either probe-rs or elf2uf2-rs
# Run this command - for the elf2uf2-rs, make sure the target board is in the drive mode
$ cargo run --bin test-a --release 

To update the versions

Embassy-rs libraries' version can be found in the repo. Each version may vary. When the executor's version is 0.7.0, the other libraries can be 0.4.0.

If you see there is any error even after all the dependencies got updated, the toolchain file can be used to point something older version of rust toolchain.

Troubleshoot

If the build is not going well:

• Remove the target directory and Cargo.lock file from the template. Also cargo update can be helpful
• Use packages/versions from the crate.io in the Cargo.toml. Packages from git may create conflicts.

Adopt the blinky and other examples

• Basic examples: https://github.com/embassy-rs/embassy/tree/main/docs/examples/basic
• RP2040 examples: https://github.com/embassy-rs/embassy/tree/main/examples/rp/src/bin
• RP2040 drivers: https://github.com/embassy-rs/embassy/tree/main/embassy-rp/src

CYW43 firmware

https://github.com/embassy-rs/embassy/tree/main/cyw43-firmware

$ cd $PROJECT
$ mkdir cyw43-firmware
$ cd cyw43-firmware
$ wget https://github.com/embassy-rs/embassy/blob/main/cyw43-firmware/43439A0.bin
$ wget https://github.com/embassy-rs/embassy/blob/main/cyw43-firmware/43439A0_clm.bin