KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#developer-tools #typescript #dsh #dsh-plugin #ai-agent #codex #ai-agents #deepseek-harness #claude-code #cli #react #mcp

arminarm

★ 29 Open GitHub ↗

Setup and install for ARMinARM board.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

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](https://code.google.com/p/stm32flash/), or a modified [stm32loader.py](https://github.com/jsnyder/stm32loader). 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.

arminarm

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README