Description

Welcome to Firmware! For your first project, you’ll be creating your own version of the flashing LEDs demo that comes with the STM32 devkits. By the end of this task, you’ll know how to:

• Create and edit a project in the STM32CubeIDE
• Understand registers, bitmasks, and interrupts
• Read a datasheet and find the information you need
• Clone, commit, push, and create pull requests on GitHub

This also serves as an introduction to the Roadmap . To avoid cluttering the tracker, instead of updating the status, I’ll move you to a “Reviewing” and “Task Complete” chapter once you finish.

As we continue through onboarding, I’ll add relevant notes to the section below.

TODO

• [ ] Clone the firmware-onboarding project to your computer
  • Create a new branch called firm-2023F-YOUR-NAME, and commit your changes to this branch
  • If you’re unsure on how to do this, check out the Git resources linked below
• [ ] Create a new STM32 project for the NUCLEO-H743ZI2 or NUCLEO-G431RB
  • Make sure you create it in the repo folder (you may need to create an empty folder within it if the IDE says “folder is not empty”)
• [ ] Write the program (see requirements below)
• [ ] Test it on a physical devkit
• [ ] Create a pull request and rebase your changes

Requirements

These are worded like formal requirements, which you’ll often find in regulatory permits, control documents, and system requirements (ex. ESP, Praxis engineering design courses). The use of SHALL and must make it clear that they need to be met, with SHOULD and may for an optional requirement. Usually, requirements from other subsystems won’t be explicitly stated like this (which is both a good and a bad thing).

The following set of requirements only applies to those using the NUCLEO-H743ZI2 for their onboarding project. If you are using the NUCLEO-G431RB, please see the second set of requirements below.

• [ ] The program shall read input from user button B1 and flash the LEDs labelled LD1, LD2, and LD3.
• LEDs
  • [ ] No LED shall flash slower than 1 Hz (on → off → on must take less than 1 second on the slowest LED)
  • [ ] Each LED must flash at double the speed of the previous LED in a sequential manner (ex. 1 Hz, 2 Hz, 4 Hz)
  • [ ] No LED shall remain flashing or turned on while another LED is flashing