aboutsummaryrefslogtreecommitdiffstats
path: root/demos/STM32/RT-STM32F103-MAPLEMINI/readme.txt
blob: 197a1b1433713a0c810c2f1086c8338a6a27477a (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
*****************************************************************************
** 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, an additional Make target has been
added. It requies dfu-util. While the MapleMini is connected via USB and
still in bootloader mode, just run

     > make flash_usb

If you compiled without the bootloader support, you will have to flash via the
original serial flashing 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