MakAir Firmware
Versions
See CHANGELOG.md.
Pre-compiled binaries are available in the Releases section.
Documentation
Code documentation can be found there.
How To Build?
In order to setup your environment and build the code, please follow the following commands (for MacOS):
brew install arduino-cli
arduino-cli config init --additional-urls https://github.com/stm32duino/BoardManagerFiles/raw/master/STM32/package_stm_index.json
arduino-cli core update-index
arduino-cli core install STM32:stm32@1.9.0
arduino-cli lib install LiquidCrystal@1.0.7 && arduino-cli lib install OneButton@1.5.0 && arduino-cli lib install CRC32@2.0.0
Then, compile the project:
arduino-cli compile --fqbn STM32:stm32:Nucleo_64:opt=o3std,pnum=NUCLEO_F411RE --verbose srcs/respirator.cpp --output output/respirator-production
How To Flash?
In order to flash the firmware that you just built using the instructions above:
- Plug your ST-Link programmer to the motherboard, and switch the motherboard to flash mode (switch position to flash mode on the motherboard);
- Plug the ST-Link programmer to your computer, over USB, and fetch its device name via the
arduino-cli board list
command (we will call it{SERIAL_PORT}
); - Make sure that STM32CubeProgrammer is installed on your computer, and run:
arduino-cli upload --port {SERIAL_PORT} --fqbn STM32:stm32:Nucleo_64:pnum=NUCLEO_F411RE,upload_method=swdMethod --input output/respirator-production
Make sure to replace {SERIAL_PORT} with your serial port, which should begin with /dev/
.
Configuration
High-level configuration options are available and documented in includes/config.h.
Low-level configuration options can be found in includes/parameters.h.