版本 213b97a9a3f97abd5dea4aacac082e0a98942dbf

Lab6: Hardware

預期目標

實際體驗 STM32 硬體操作
以 STM32F4-Discovery<http://www.st.com/internet/evalboard/product/252419.jsp>_ 為參考硬體，探討相關的軟體開發工具與流程
Unit Test 概念的落實

開發工具介紹與準備

GNU Toolchain: 同之前 Lab
ICE = In-Circuit Emulator
Remote Debugging using GDB<http://www.codeproject.com/Articles/14983/Remote-Debugging-using-GDB>_

.. code-block:: prettyprint

sudo apt-get install automake* libtool libusb-1.0-0-dev
git clone http://github.com/texane/stlink.git
cd stlink
./autogen.sh
./configure --prefix=/usr
make
sudo make install
sudo cp 49-stlinkv2.rules /etc/udev/rules.d/

取得 OpenOCD 原始程式碼

.. code-block:: prettyprint

git clone git://openocd.git.sourceforge.net/gitroot/openocd/openocd

或者 openocd-d2f61e1a4592449188305164b27f495f78dca00a.tar.bz2</embedded/Lab6/openocd-d2f61e1a4592449188305164b27f495f78dca00a.tar.bz2>_
編譯 OpenOCD

.. code-block:: prettyprint

cd openocd
./bootstrap
./configure --prefix=/opt/openocd \
    --enable-jlink \
    --enable-amtjtagaccel \
    --enable-buspirate \
    --enable-stlink \
    --disable-libftdi
echo -e "all:\ninstall:" > doc/Makefile
make
sudo make install

Programming STM32 F2, F4 ARMs under Linux

A Tutorial from Scratch<http://www.triplespark.net/elec/pdev/arm/stm32.html>_
- Introduction STM32, STM32F2, STM32F4
- Obtaining and Setting Up OpenOCD
- Setting up the Hardware: STM32F4Discovery with integrated ST-Link/V2
- The Minimalistic Hello-World Program
- Running the Minimalistic Hello-World Program
- Debugging
- Automating the Steps

工作環境

取得最新 Labs 內容 (與之前 Lab3</embedded/Lab3>_ 操作相似)：

.. code-block:: prettyprint

git clone git://gitcafe.com/embedded2012/Labs.git
cd Labs/Lab-6

或是

.. code-block:: prettyprint

cd Labs/Lab-6
git pull

具備互動操作的 USB serial 實做

http://www.sparetimelabs.com/usbcdcacm/ (文末提到與之前指定作業相關的技術議題)
USB list: /var/lib/usbutils/usb.ids
neocon 離開方法: ~.
- neocon /dev/ttyACM0
http://wiki.openmoko.org/wiki/NeoCon
http://wiki.openmoko.org/wiki/CDC_ACM

示範程式碼

.. code-block:: prettyprint

cd Labs/Lab-6/discoveryF4
make
cd discovery_demo
make flash
cd ../serialUSB/
make flash

Unit Test

「在以往我們常常不停地改寫程式，在這個過程中，有意無意地常常會有東西被改壞掉還不知道，而我們檢查的方式可能很常是透過一直修改程式碼或輸入的資料來測試
但是當程式越來越大，我們測試時只專注在一個地方，此時所要測試的程式越來越多，不小心出錯的可能也越來越多，每改寫一次就是一次昂貴的人力檢查，最後程式就像一艘漏水的船，補了這裡，那裡卻又多了一個洞，船員像無頭蒼蠅一樣四處補洞，這樣的情況就是 Unit Test 能解決的問題
透過Unit Test，每次寫的程式碼都交給程式自動測試，一來測試的速度很快，不管是一百次還是一千次，總比人工測試來得快速、正確、廣範，但這不是免費的，代價就是程式設計師要寫很多 Unit Test 的程式碼，還要想要如何寫 Unit Test 的程式
進一步的還有測試導向的開發模式(Test-driven development)，程式是在Unit Test寫完之後才開始寫，這樣一來迫使程式設計師在一開始就得把設計想好」
- http://blog.ez2learn.com/2009/01/21/try-google-unit-test-framework/
http://www.dotblogs.com.tw/hatelove/archive/2012/05/08/unit-test-introduction.aspx
http://teddy-chen-tw.blogspot.tw/2011/11/unit-tests.html
CUnit: A Unit Testing Framework for C
- http://cunit.sourceforge.net/screenshots.html
- sudo apt-get install libcunit1-dev
- make check
參考輸出：

.. code-block:: prettyprint

./unit-test


     CUnit - A Unit testing framework for C - Version 2.1-0
     http://cunit.sourceforge.net/

Suite: Suite_1
  Test: test of fprintf() ... passed
  Test: test of fread() ... passed

--Run Summary: Type      Total     Ran  Passed  Failed
               suites        1       1     n/a       0
               tests         2       2       2       0
               asserts       5       5       5       0

作業

透過 OpenOCD 對 STM32F4Discovery 內建的 ST-Link/V2 介面，設計一個驗證硬體的 unit test 環境
- 可參照 Group Presentation 的週邊測試方式
- 至少需要包含 USB, ADC, RTC
藉由 OpenOCD + GDB，實做 firmware download 程式，可視為 boot loader
一旦系統藉由特製的 boot loader 載入於 STM32F4-Discovery 硬體並啟動後，可監控系統運作並執行特定的 unit test 程式
驗證方式: cd Labs/Lab-6 && make all check

參考資訊

STM32F4-Discovery 繁體中文簡易操作<http://cms.mcuapps.com/products/stm32f4-discovery/README.html>_
OpenOCD 繁體中文簡易操作<http://cms.mcuapps.com/techinfo/toolchains/openocd/>_