README.md

Course: Discovery

Course link: https://docs.rust-embedded.org/discovery/microbit/index.html

Status: 🚧 (WIP)

Notes

• Get a USB cable that is suitable not only for charging but also for data transfer. No, seriously, otherwise you will have to spend 2 hours debugging like me 😉
• To exclude problems with $ probe-rs info, it is better to update firmware beforehand.
• If you get errors like:

➜  05-led-roulette git:(main) ✗ cargo embed       
   Compiling chapter-05-led-roulette v0.1.0 (<REPO_PATH>/rust-embedded-discover-microbit-book/05-led-roulette)
    Finished `dev` profile [unoptimized + debuginfo] target(s) in 0.06s
      Config default
      Target <REPO_PATH>/target/thumbv7em-none-eabihf/debug/chapter-05-led-roulette
 WARN probe_rs::flashing::loader: No loadable segments were found in the ELF file.
       Error No loadable segments were found in the ELF file.

In that case, make sure that the files memory.x, build.rs, and Embed.toml are present inside the chapter folder (e.g. 05-led-roulette) and .cargo/config.toml relative to the root of the repository.

• In Cargo.toml for chapters, the microbit (v1) dependency is deliberately commented out and microbit-v2 is left so that RustRover IDE can understand which crate to take imports from. If you have the first version, you should do the opposite.

Index legend

• 📝 - a link to a book page
• ✏️ - a link to an .rs file (code)
• 🚧 - not finished

Index

• 📝 0. Introduction
• 📝 1. Background
• 📝 2. Hardware/knowledge requirements
• 📝 3. Setting up a development environment
  • 📝 3.1. Linux
  • 📝 3.2. Windows
  • 📝 3.3. macOS
  • 📝 3.4. Verify the installation
  • 📝 3.5. Setting up your IDE
• 📝 4. Meet your hardware
  • 📝 4.1. micro:bit v2
  • 📝 4.2. micro:bit v1
  • 📝 4.3. Rust Embedded terminology
• 📝 5. LED roulette
  • 📝 5.1. Build it
  • 📝 5.2. Flash it
  • 📝 5.3. Debug it
  • 📝 5.4. Light it up
  • 📝 5.5. It blinks
  • 📝 5.6. The challenge (✏️ link)
  • 📝 5.7. My solution
• 📝 6. Serial communication
  • 📝 6.1. *nix tooling
  • 📝 6.2. Windows tooling
• 📝 7. UART
  • 📝 7.1. Send a single byte (✏️ link (commit))
  • 📝 7.2. Send a string (✏️ link (commit))
  • 📝 7.3. Naive approach and write! (✏️ link (commit))
  • 📝 7.4. Receive a single byte
  • 📝 7.5. Echo server
  • 📝 7.6. Reverse a string
  • 📝 7.7. My solution
• 📝 8. I2C
  • 📝 8.1. The general protocol
  • 📝 8.2. LSM303AGR
  • 📝 8.3. Read a single register
  • 📝 8.4. Using a driver
  • 📝 8.5. The challenge
  • 🚧 8.6. My solution
• 🚧 9. LED compass
  • 🚧 9.1. Calibration
  • 🚧 9.2. Take 1
  • 🚧 9.3. Solution 1
  • 🚧 9.4. Take 2
  • 🚧 9.5. Solution 2
  • 🚧 9.6. Magnitude
• 🚧 10. Punch-o-meter
  • 🚧 10.1. Gravity is up?
  • 🚧 10.2. The challenge
  • 🚧 10.3. My solution
• 🚧 11. Snake game
  • 🚧 11.1. Game logic
  • 🚧 11.2. Controls
  • 🚧 11.3. Non-blocking display
• 🚧 12. What's left for you to explore

---

• 🚧 Appendix 1. General troubleshooting
• 🚧 Appendix 2. How to use GDB