diff options
| author | xengineering <me@xengineering.eu> | 2021-09-26 16:59:03 +0200 |
|---|---|---|
| committer | xengineering <me@xengineering.eu> | 2021-09-26 16:59:44 +0200 |
| commit | 9e822663cbbb841ee7636cfd169426e91d8fa643 (patch) | |
| tree | c14cf0c90a5fc8da4b44c01b50e389a7e8459e9d /README.md | |
| parent | 45a6fdb04f3bf605eb4280473dd22db041ece6a7 (diff) | |
| download | ledcontrol-9e822663cbbb841ee7636cfd169426e91d8fa643.tar ledcontrol-9e822663cbbb841ee7636cfd169426e91d8fa643.tar.zst ledcontrol-9e822663cbbb841ee7636cfd169426e91d8fa643.zip | |
Add Helper Scripts and Documentation
Diffstat (limited to 'README.md')
| -rw-r--r-- | README.md | 34 |
1 files changed, 34 insertions, 0 deletions
@@ -3,6 +3,40 @@ A firmware project for the STM32F103C8T6 to control LED strips. +## Usage + +Install the necessary software. For Arch Linux this works like this: +``` +sudo pacman -S \ + base-devel \ + arm-none-eabi-binutils \ + arm-none-eabi-gcc \ + arm-none-eabi-gdb \ + arm-none-eabi-newlib +``` + +Clone this repository with all Git submodules: +``` +git clone --recurse-submodules https://gitea.xengineering.eu/xengineering/ledcontrol.git +``` + +Enter the repository and build the software +``` +cd ledcontrol +make +``` + +Connect your STM32F103C8T6 with an STLINK V2 debugger and flash the firmware: +``` +bash ocd.sh +# switch to a second terminal in the same folder +bash gdb.sh build/ledcontrol.elf +load +run +# CTRL + C will stop the execution +# leave GDB with CTRL + D +``` + ## External References - Nice [Tutorial](https://jacobmossberg.se/posts/2018/08/11/run-c-program-bare-metal-on-arm-cortex-m3.html) about C programs on bare-metal ARM chips |