ARMinARM software install scripts

The ARMinARM installation scripts assume you're running an up-to-date Raspbian Jessie distribution on your Raspberry Pi. Other distributions will probably also work, but you may need to install additional software.

sudo apt-get update
sudo apt-get upgrade

You'll want to install the following additional packages on Raspbian Jessie 2015-11-21 or newer:

sudo apt-get install minicom screen autoconf libusb-1.0-0-dev libtool libftdi-dev texinfo

Setup and install software for the ARMinARM board by cloning the repository from github, and run setup.

git clone https://github.com/ARMinARM/arminarm
cd arminarm
./setup

When you run setup, you'll see a menu.

#######################################################################
#                              ARMinARM                               #
#######################################################################

Essentials:
    0) Update Self
    1) Update/Install ARMinARM + GCC Toolchain
    2) Add /opt/arminarm* to PATH env (needs reboot)
    3) Disable serial port (required for ARMinARM board, needs reboot)
    4) Enable serial port (for booting RPI over serial port, default)

Fast start:
    10) Upload espruino.bin to ARMinARM board
    11) Upload elua.bin to ARMinARM board

Source code:
    a) Update/Install CMSIS_StdPeriph Examples
    b) Update/Install Espruino source code
    c) Update/Install esp-cli
    d) Update/Install eLua source code
    e) Update/Install libmaple
    f) Update/Install libopencm3-prj
    g) Update/Install OpenOCD
    h) Update/Install ST-Link
    i) Update/Install dfu-util
    j) Update/Install stm32flash

    q) Quit

Enter your choice:

You'll want to run the numeric options (0-3) at least once, to install all the basic tools and make the serial port available.

The alfabetic options (a-j) installs optional tools, frameworks or projects. Install all of them, or pick and choose as you like. If you want to start right away, choose option 10 (espruino) or 11 (elua). After you uploaded one of them, start 'minicom' or 'screen' to start an interactive session. Espruino communicates on 9600 baud, elua on 115200. Both use /dev/ttyAMA0 as the serial port.

Toolchain (arm-none-eabi-gcc)

Since Raspbian Jessie, the toolchain that's installed is arm-none-eabi-gcc from the standard Jessie repositories (gcc, gdb, binutils, newlib). This is recommended.

If you must use Wheezy, run install_toolchain.sh in the bin directory manually in stead of installing the toolchain from the setup menu.

Tools

A set of tools for uploading firmware to the STM32 on the ARMinARM board come with the toolchain. The tool 'arminarm' is automatically installed to /opt/arminarm when you install the toolchain from the 'setup' menu. It uses the default bootloader that's available on every STM32 chip.

Under the hood, communicating with the bootloader is done with one of two tools: stm32flash, or a modified stm32loader.py. They both work well, but you may find stm32flash has a somewhat cleaner interface, and handles errors a little better. The default is to use stm32flash. When adding the -l flag, stm32loader.py is used.

Whatever firmware you have compiled (say 'blinky.bin'), you can upload it with:

arminarm flash path/to/blinky.bin   # deprecated
arminarm -f path/to/blinky.bin      # use stm32flash
arminarm -lf path/to/blinky.bin     # use stm32loader.py

To reset the STM32 on the ARMinARM board:

arminarm reset        # deprecated
arminarm -r           # use stm32flash
arminarm -lr          # use stm32loader.py

To put the STM32 in bootloader mode:

arminarm bootloader   # deprecated
arminarm -b           # use stm32flash
arminarm -lb          # use stm32loader.py

To start openocd server using sysfsgpio interface:

arminarm openocd      # deprecated
arminarm -d

Connect to it in arm-none-eabi-gdb using:

(gdb) target extended-remote localhost:3333

You can only use the tool 'arminarm' if the path to it (/opt/arminarm/tools) is added to your PATH environment variable. There's a menu option in 'setup' to do this for you. You only have to run this option once. The path is remembered even after reboots.

Put jumpers on the first 2 and last 2 set of pins on the CONN header on the board (BOOT0, NRST, RX, TX).

Uploading firmware

Using the 'arminarm' tool to upload firmware with stm32flash looks like this:

pi@raspberrypi ~ $ arminarm -f myfirmware.bin
stm32flash 0.4

http://stm32flash.googlecode.com/

Using Parser : Raw BINARY
Interface serial_posix: 115200 8E1
Version      : 0x22
Option 1     : 0x00
Option 2     : 0x00
Device ID    : 0x0414 (High-density)
- RAM        : 64KiB  (512b reserved by bootloader)
- Flash      : 512KiB (sector size: 2x2048)
- Option RAM : 16b
- System RAM : 2KiB
Write to memory
Erasing memory
Wrote and verified address 0x080004a4 (100.00%) Done.

Starting execution at address 0x08000000... done.

Adding the '-l' flag to use stm32loader.py, it will look like this:

pi@raspberrypi ~ $ arminarm -lf myfirmware.bin
GPIO version: 0.5.7
Pi revision 3
Open port /dev/ttyAMA0, baud 115200
initChip
ACK
Bootloader version 22
Chip id ['0x4', '0x14']
Write 256 bytes at 0x8000000
Write 256 bytes at 0x8000100
Write 256 bytes at 0x8000200
Write 256 bytes at 0x8000300
Write 256 bytes at 0x8000400
Read 256 bytes at 0x8000000
Read 256 bytes at 0x8000100
Read 256 bytes at 0x8000200
Read 256 bytes at 0x8000300
Read 256 bytes at 0x8000400
Verification OK
cleaning up...
done.

Run 'arminarm' without any flags, or '-h' will show all options.