QMK/lib/chibios/demos/STM32/RT-STM32F103-MAPLEMINI
2020-03-23 10:48:11 +01:00
..
cfg initial upload 2020-03-23 10:48:11 +01:00
source initial upload 2020-03-23 10:48:11 +01:00
main.c initial upload 2020-03-23 10:48:11 +01:00
Makefile initial upload 2020-03-23 10:48:11 +01:00
readme.txt initial upload 2020-03-23 10:48:11 +01:00

*****************************************************************************
** ChibiOS/RT port for ARM-Cortex-M3 STM32F103 on LeafLabs MapleMini       **
*****************************************************************************

** TARGET **

The demo runs on the MapleMini with the original MapleMini bootloader.

You can also use this firmware without the original bootloader. To do so,
pass USE_MAPLEMINI_BOOTLOADER=0 to make:

> make USE_MAPLEMINI_BOOTLOADER=0

** The Demo **

This demo flashes the board LED using a thread. Also, a simple command shell
is activated on virtual serial port via USB-CDC driver.

** Build Procedure **

The demo has been tested by using the free arm gcc embedded toolchain.
Just modify the TRGT line in the makefile in order to use different GCC ports.

** Flashing Target Board **

To flash the firmware to the maplemini, you can use dfu-util. While the MapleMini is connected via USB and
still in bootloader mode, just run

     > dfu-util -a1 -d 1eaf:0003 -D build/ch.bin -R

If you compiled without the bootloader support, you will have to flash via the
original serial flashing method or via SWD. For the serial method please see
http://static.leaflabs.com/pub/leaflabs/maple-docs/latest/bootloader.html#id7
for a howto. there you can also get the official bootloader files.
As a quick reference:

  1) connect TTL UART:
     TX to maple rx1 ("25")
     RX to tx1 ("26")
     GND to gnd
     3.3V to vcc  or  5V to vin
  
  2) hold RESET and BUT buttons, release RESET, then after a sec BUT
     (this sets the STM32 into serial upload mode)
  
  3) use stm32loader.py from the link above to upload the firmware
     > stm32loader.py -p <uart-device> -evw build/ch.bin
  
  4) reset device

** Notes **

Some files used by the demo are not part of ChibiOS/RT but are copyright of
ST Microelectronics and are licensed under a different license.
Also note that not all the files present in the ST library are distributed
with ChibiOS/RT, you can find the whole library on the ST web site:

                             http://www.st.com