Update FST-01SZ test plan. master
authorNIIBE Yutaka <gniibe@fsij.org>
Tue, 4 Dec 2018 06:16:55 +0000 (15:16 +0900)
committerNIIBE Yutaka <gniibe@fsij.org>
Tue, 4 Dec 2018 06:16:55 +0000 (15:16 +0900)
content/memo/development/fst-01/fst-01sz-testplan.rst

index c0da07a..3e53db9 100644 (file)
@@ -2,7 +2,7 @@
 Flying Stone Tiny 01SZ Test Plan
 ================================
 :slug: memo/development/fst-01/fst-01sz-testplan
-:date: 2018-11-22
+:date: 2018-12-04
 :category: memo
 :tags: fst-01, development
 
@@ -252,8 +252,8 @@ It should show the string of "uio_pruss_enable" at the last line.
 You only need to run this command only at the first time.
 
 
-Execution of OpenOCD
---------------------
+Execution of OpenOCD to flash and test the board
+------------------------------------------------
 
 1. Execute the openocd command: ::
 
@@ -350,6 +350,14 @@ Please record the test results:
 Those three should be successful.
 
 
+Shut down the BBG
+=================
+
+After testing FST-01SZ boards, to power down BBG, please type following command. ::
+
+    $ sudo shutdown -h now
+
+
 Example connection
 ==================
 
@@ -623,3 +631,61 @@ FST-01SZ flashed with NeuG 1.0.9
 
 Note that the flash ROM is not protected by this test plan,
 so that an enduser can check the content of the flash ROM.
+
+
+Other Tips
+==========
+
+Resetting FST-01SZ
+------------------
+
+In the test procedure, at the check script step, it may be possible to
+encounter a failure when it takes more than ten seconds to move
+a magnet.
+
+In this case, please type following command to reset FST-01SZ: ::
+
+    $ openocd -f bbg-fst-01sz.cfg -c "init" -c "reset run" -c "shutdown"
+
+and then, try again with the check script.
+
+
+Erase flash of FST-01SZ
+-----------------------
+
+In the test procedure, at the flashing FST-01SZ step, it might be possible
+to flash wrong image to FST-01SZ accidentally.
+
+In this case, please type following commands to erase flash of FST-01SZ: ::
+
+    $ openocd -f bbg-fst-01sz.cfg -c "init" -c "reset halt" -c "flash erase_address 0x801000 0x10000" -c "shutdown"
+    $ openocd -f bbg-fst-01sz.cfg -c "init" -c "reset halt" -c "flash erase_address 0x800000 0x10000" -c "shutdown"
+
+And then, try flashing with correct image.
+
+We do by these two commands, because of GD32F103 while we can do that
+for STM32F103 in a single step.  It's the difference of flash ROM
+implementation between GD32F103 and STM32F103.  Future version of
+OpenOCD may support GD32F103 better, hopefully.
+
+
+Locking flash access by SWD
+---------------------------
+
+In the test procedure, flash is not protected.  If you need, you can
+do by following command. ::
+
+    $ openocd -f bbg-fst-01sz.cfg -c "init" -c "reset halt" -c "stm32f1x lock 0" -c "shutdown"
+
+
+Unocking flash access by SWD
+----------------------------
+
+When GD32F103 is shipped from a factory, it should have empty unlocked
+flash.  If it is accidentaly locked for some reason, you can unlock it
+by following command. ::
+
+    $ openocd -f bbg-fst-01sz.cfg -c "init" -c "reset halt" -c "stm32f1x unlock 0" -c "shutdown"
+
+And then, remove off the FST-01SZ from the USB connector and then
+insert it the USB connector again, to power off -> power on GD32F103.