Skip to content

Latest commit

 

History

History
84 lines (67 loc) · 3.6 KB

INSTALL.md

File metadata and controls

84 lines (67 loc) · 3.6 KB
Raw

Install and Flashing Instructions

The flashing procedure consists of the "unlocking" of the board,as it is read/write protected originally, and flashing the actual firmware. A ST-LINK v2 is used, either clone, original, or Discovery/Nucleo board.

Connections to the programming port require 3 wires, ground, swclk and swdat (swio). While flashing, the quad is powered from its battery.

Flashing over 16k

The chip used can be flashed to 32k, but unfortunately some modifications to software need to be performed first. This is useful if some features make the binary over 16K. Read this post for more info

Windows

See RC Groups Thread First Post for now.

Linux

For flashing on Linux, the OpenOCD toolchain is used. The install instructions have been tested to work with OpenOCD 0.9.0 on Debian-based systems (Ubuntu 14.04).

Install OpenOCD 0.9.0

On some OS versions, older versions of OpenOCD might be the default. On Debian-based systems you can check which version is the default by running

apt-cache policy openocd
  • If the output indicates a version below 0.9.0, you can install it on Debian-based systems (such as Ubuntu 14.04) using these commands:
wget http://lug.mtu.edu/ubuntu/pool/universe/h/hidapi/libhidapi-hidraw0_0.8.0~rc1+git20140201.3a66d4e+dfsg-3_amd64.deb
sudo dpkg -i libhidapi-hidraw0_0.8.0~rc1+git20140201.3a66d4e+dfsg-3_amd64.deb
wget http://ubuntu.mirrors.tds.net/ubuntu/pool/universe/j/jimtcl/libjim0.76_0.76-1_amd64.deb
sudo dpkg -i libjim0.76_0.76-1_amd64.deb
wget http://ubuntu.mirrors.tds.net/ubuntu/pool/universe/o/openocd/openocd_0.9.0-1build1_amd64.deb
sudo dpkg -i openocd_0.9.0-1build1_amd64.deb
  • If the output of the check indicates a version equal or higher to 0.9.0, just install openocd:
sudo apt-get install openocd

Toolchain Install and Build

Run the following to install the necessary build tools:

apt-get install git build-essential gcc-arm-none-eabi libnewlib-arm-none-eabi

Clone the repository:

git clone https://github.com/silver13/H8mini_blue_board
cd H8mini_blue_board

Build the firmware:

cd gcc
make

Flashing

Before being able to flash, the board needs to be unlocked. This only has to be performed once for every flight controller board.

openocd -f /usr/share/openocd/scripts/interface/stlink-v2.cfg -f /usr/share/openocd/scripts/target/stm32f0x.cfg -c init -c "reset halt" -c "stm32f0x unlock 0" -c "reset run" -c shutdown

The board needs a power cycle after unlocking.

Once the board is unlocked, the firmware can be flashed using

openocd -f /usr/share/openocd/scripts/interface/stlink-v2.cfg -f /usr/share/openocd/scripts/target/stm32f0x.cfg -c init -c "reset halt" -c "flash write_image erase h8blue 0x08000000" -c "verify_image h8blue 0x08000000" -c "reset run" -c shutdown

Troubleshooting

It appears that on Ubuntu 14.04, there is an issue with the standard .deb install for the build toolchain. You might get an error saying

arm-none-eabi-gcc: error: nano.specs: No such file or directory

In that case, another version of the ggc arm toolchain needs to be installed (see bug reports: 1, 2):

sudo apt-get remove binutils-arm-none-eabi gcc-arm-none-eabi
sudo add-apt-repository ppa:terry.guo/gcc-arm-embedded
sudo apt-get update
sudo apt-get install gcc-arm-none-eabi

After this, the "Build the firmware" step above can be performed.