Skip to content

Latest commit

 

History

History
94 lines (73 loc) · 4.41 KB

INSTALL.md

File metadata and controls

94 lines (73 loc) · 4.41 KB

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 mcu chip used ( stm32f030k4 ) can be flashed to 32k, but unfortunately some modifications to openocd 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 Boldclash Thread First Post for now.

There is a bug involving flashing from Keil and this mcu, while workarounds are available, the current procedure avoids this by using the ST-Link Utility program instead for flashing.

Mac

On mac the app on this page can be used. Replace the code folder with one from this repository.

Or: Install gcc-arm-none-eabi compiler from it's webpage. Install openocd using these instructions.

For actual flashing, use the openocd linux lines, but you may have to adjust the paths to suit. Example

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/BoldClash-BWHOOP-B-03.git
cd BoldClash-BWHOOP-B-03

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 bwhoop 0x08000000" -c "verify_image bwhoop 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.