Network Connection

PC and BBG is connected by Ethernet.

[Router]
  |
[ Ethernet Hub ]
  |       |
[PC]     [BBG]

Router offers IP addresses to PC and BBG by DHCP.

BBG connections

Here is a figure of BBG.

Top View of BeagleBone Green (BBG):
                                     Insert FST-01G here
                                              |
  /-[=================]----\                  V
  |                       +-+ USB  +--------------+
  |                       +-+======|   USB Hub    |
  []     BeagleBone        |       +--------------+
  |         Green        +--+
  []                     |  |=============> Ethernet
  |                      +--+
  |                        |==============> USB Power
  \-[=================]----/
               | | |
               V | | Wires to FST-01G SWD port
  BLACK (SWD-IO) | |
                 V |
   WHITE (SWD-CLK) V
                   BLUE (GND)

Power is supplied by USB to BBG (USB Power).

USB Hub is connected to BBG to connect FST-01G.

Three wires are connected from BBG GPIO port to FST-01 SWD port.

Pins for SWD access

We use three lines from BBG for SWD control.

BBG-SWD also has SRST for resetting target board, but we don't use this signal for FST-01G.

SSH login to BBG

Log into BBG from PC by SSH. The username is "debian". Since the password is displayed when you connect to BBG, use the password.

Firmware ELF file

There is a file, neug.elf.

OpenOCD patched for BBG-SWD

OpenOCD is installed in /usr/local.

Become ROOT

Type "sudo" command to be ROOT:

debian@beaglebone:~$ sudo -s

Then, the prompt will be changed to the one with "#".

Execution of the setup script

1. Execute the setup script (only once after login):

   # ./bbg-setup.sh
   

This command execution is only done at the first time.

Execution of OpenOCD

1. Execute the openocd command:

   # openocd -f stm32f1x-bbg-swd.cfg -f fst01g-flash-write.tcl
   

2. Expected behavior of the board and expected output of the command

   Successfully done, output is something like:

   Open On-Chip Debugger 0.10.0-dev-00323-g9601c25-dirty (2016-06-22-01:41)
   Licensed under GNU GPL v2
   For bug reports, read
      http://openocd.org/doc/doxygen/bugs.html
   Info : only one transport option; autoselect 'swd'
   adapter speed: 1000 kHz
   adapter_nsrst_delay: 100
   none separate
   cortex_m reset_config sysresetreq
   none separate
   adapter_nsrst_assert_width: 1
   Info : BBG-SWD: Interface ready
   Info : clock speed 1000 kHz
   Info : SWD DPIDR 0x1ba01477
   Info : stm32f1x.cpu: hardware has 6 breakpoints, 4 watchpoints
   Error: stm32f1x.cpu -- clearing lockup after double fault
   Polling target stm32f1x.cpu failed, trying to reexamine
   Info : stm32f1x.cpu: hardware has 6 breakpoints, 4 watchpoints
   stm32f1x.cpu: target state: halted
   target halted due to debug-request, current mode: Thread
   xPSR: 0x01000000 pc: 0xfffffffe msp: 0xfffffffc
   Info : device id = 0x20036410
   Info : flash size = 128kbytes
   Option Byte: 0x3fffffc
   Readout Protection Off
   Software Watchdog
   Stop: No reset generated
   Standby: No reset generated
   User Option0: 0xff
   User Option1: 0xff
   auto erase enabled
   wrote 82944 bytes from file neug.elf in 4.369664s (18.537 KiB/s)
   shutdown command invoked
   

   The line "wrote 82944 bytes from file neug.elf" means success. When failure, you won't be able to see this line.

   After successful programming of flash, the LED on FST-01G emits light.

3. Execute the checking script:

   # ./check-fst-01g.sh
   

4. Expected behavior of the board and expected output of the script

   Successfully done, output is:

   /mnt/COPYING: OK
   /mnt/INDEX.HTM: OK
   /mnt/README: OK
   SUCCESS
   

   This means that these files on FST-01G are correct.

   LED blinks after this command.

To repeat writing and checking for another board of FST-01G, you can use command line history of BASH; You can use arrow key UP (↑) to repeat same command line.

USB Hub

I connect USB Hub to BeagleBone Green for two purposes.

1. It allows flexibility for the wire connection of SWD between BBG and FST-01G.
2. For some reasons, BeagleBone Green's root hub doesn't work well after FST-01G's reset (using 4.4.5-bone5 kernel). With external USB Hub, it works well.

bbg-setup.sh

The content is:

#! /bin/sh

echo gpio >/sys/devices/platform/ocp/ocp:P8_12_pinmux/state
echo gpio >/sys/devices/platform/ocp/ocp:P8_11_pinmux/state
echo gpio_pu >/sys/devices/platform/ocp/ocp:P8_15_pinmux/state

check-fst-01g.sh

The content is:

#! /bin/bash -e

mount /dev/sda /mnt
sha256sum -c <<EOF
8ceb4b9ee5adedde47b31e975c1d90c73ad27b6b165a1dcd80c7c545eb65b903  /mnt/COPYING
b1d5ba03e787e8f4f8a06a6e7fc37279a7eae18a4bab2d0f9192e928830db568  /mnt/INDEX.HTM
756ae8f73580117a9ff47bd7dda4807adc33b78baddf3a56eb4ab1d3e6d1007f  /mnt/README
EOF
umount /mnt
eject /dev/sda
echo SUCCESS

stm32f1x-bbg-swd.cfg

The content is:

interface bbg-swd
source [find target/stm32f1x.cfg]
reset_config none
adapter_nsrst_assert_width 1

fst01g-flash-write.tcl

The content is:

init
reset halt
#
stm32f1x options_read 0
#
flash write_image erase neug.elf
#
reset run
#
shutdown

FST-01G flashed with NeuG 1.0.5

Note that the flash ROM is not protected by this test plan, so that an enduser can check the content of the flash ROM.