README.md

card10 Firmware Readme

Setup

To compile the firmware you need meson(>0.40.0) and a arm-none-eabi-gcc. You should also have python3 installed on your system.

Compiler (arm-none-eabi-gcc)

Install the cross-compiler and debugger either from your distributions repositories, or alternatively download a precompiled toolchain from ARM.

On Ubuntu, the package is called gcc-arm-none-eabi

Compiling the card10 firmware

# Configure the build system
./bootstrap.sh
# Start the build
ninja -C build/

You can also build individual targets using

ninja -C build/ <target>

where target is one of

• hw-tests/bmatest/bmatest.elf - Test for BMA400
• hw-tests/bmetest/bmetest.elf - Test for BME680
• hw-tests/ecgtest/ecgtest.elf - Test for MAX30003 ECG
• hw-tests/hello-freertos/hello-freertos.elf - FreeRTOS Demo
• hw-tests/hello-world/hello-world.elf - General Demo
• hw-tests/imutest/imutest.elf - Compass Test
• hw-tests/ips/ips.elf - Display Test
• hw-tests/dual-core/dual-core{0,1}.elf - Dual-Core Demo

GDB (arm-none-eabi-gdb)

If you want to debug code or replace the bootloader, you need OpenOCD and GDB.

Use arm-none-eabi-gdb (might be packaged as gdb-arm-none-eabi or get it from the binary distribution above).

Add the following line to your ~/.gdbinit file:

add-auto-load-safe-path <PATH TO THIS REPOSITORY>

This allows gdb to use our .gdbinit files without specifying them on the command line.

OpenOCD

If you want to debug code or replace the bootloader, you need OpenOCD and GDB.