Revision as of 14:29, 19 July 2013

Toolchain

The toolchain we use comes from https://launchpad.net/gcc-arm-embedded. This is a toolchain maintained by ARM employees and is available for Linux, Windows and OS X.

Linux (Ubuntu based)

There is a PPA for gcc-arm-embedded.

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

Linux (generic)

• Download gcc-arm-none-eabi-4_7-2013q2-20130614-linux.tar.bz2
• Uncompress into /opt (arm-none-eabi-ld should be in /opt/xdev/gcc-arm-none-eabi-4_7-2013q2/bin/)

Windows

• download gcc-arm-none-eabi-4_7-2013q2-20130614-win32.zip
• unzip in C:\xdev\tools\gcc-arm\4.7_2013q2 (arm-none-eabi-gcc.exe should be in C:\xdev\tools\gcc-arm\4.7_2013q2\bin)
• download gnuwin-make-3.81.zip
• unzip in c:\xdev\tools\gnuwin\make\3.81 (make.exe should be in c:\xdev\tools\gnuwin\make\3.81\bin)
• add make.exe to your PATH.

openocd

Linux

• install openocd (should be in the repository of your favorite distribution)
• create the file /etc/udev/rules.d/10-jtag.rules whith the following content:

# AMREBS4-like (ftdi) integrated debugger
ATTRS{idProduct}=="3100", ATTRS{idVendor}=="08ee", MODE="666", GROUP="plugdev"
 
# Amontec JTAGkey 2
ATTRS{idProduct}=="cff8", ATTRS{idVendor}=="0403", MODE="666", GROUP="plugdev"
 
# STM32F4 discovery board (stlink-v2 and DFU)
ATTRS{idProduct}=="3748", ATTRS{idVendor}=="0483", MODE="666", GROUP="plugdev"
ATTRS{idProduct}=="df11", ATTRS{idVendor}=="0483", MODE="666", GROUP="plugdev"

• make sure you're in the plugdev group

Windows

• Download and install openocd-0.7.0
• Unzip into c:\xdev\tools\openocd\0.7 (openocd-0.7.0.exe should be in C:\xdev\tools\openocd\0.7.0\bin)
• rename openocd-0.7.0.exe into openocd.exe
• Download and install the ST-LINK/V2 USB driver from here (STSW-LINK003)
  • Optional: Test the connection with the STM32 ST-LINK Utility V2
• For the other boards FIXME

Eclipse

Tested with eclipse 4.3 (Kepler), but at least works with Juno (4.2) and Indigo (4.1)

• Help -> Install new software ... -> work with "-- All available sites --" and add at least :

 * Programming Languages : C/C++ development Tools
 * Mobile and Device Development : C/C++ Hardware Debugging
 * Mobile and Device Development : C/C++ Cross compiler support
 * Subversive SVN Team provider + subversive connector

• After setup and restart, subversive should ask to choose a connector, choose:

 * SVNkit 1.7.9

Project Setup

In the project properties make sure

* C/C++ build > settings -> Settings tab : "Cross settings" :
    * prefix : "arm-none-eabi-"
    * path (windows) : "C:\xdev\tools\gcc-arm\4.7_2013q2\bin"
    * path (Linux generic) : "/opt/xdev/gcc-arm-none-eabi-4_7-2013q2/bin/"
    * path (Unbutu based) : arm-none-eabi- tools are in the PATH.
* C/C++ build > settings -> Settings tab : "Cross GCC compiler" :
  * Symbols :
    * STM32F4XX=1
    * ARM_MATH_CM4=1
    * __FPU_PRESENT=1
    * USE_STM324xG_EVAL=1
  * Includes :
    * "${workspace_loc:/${ProjName}/libheivs_stm32/include}"
    * "${workspace_loc:/${ProjName}}"
  * Debugging: 
    * Maximum -g3
  * Warnings:
    * -Wall
  * Miscellaneous
    * "-c -fmessage-length=0 -mthumb -mcpu=cortex-m4 -mfloat-abi=hard -mfpu=fpv4-sp-d16"
* C/C++ build > settings -> Settings tab : "Cross GCC linker" :
  * General :
    * No shared libraries (-static)
  * Libraries
    * m
  * Miscellaneous
    * Linker flags : "-T "${workspace_loc:/${ProjName}/libheivs_stm32/stm32f407ig_flash.ld}" -mthumb -mcpu=cortex-m4 -mfloat-abi=hard -mfpu=fpv4-sp-d16"
    * Other options (-Xlinker [option])
      * -Map=linker.map
      * --gc-sections
* C/C++ build > settings -> Settings tab : "Cross GCC assembler" :
  * General:
    * Assembler flags : "-mthumb -mcpu=cortex-m4 -mfloat-abi=hard -mfpu=fpv4-sp-d16 -g3"

Debug settings

• Debug configuration -> GDB Hardware debugging

* At the bottom of the page, make sure the project uses "Standard Hardware Debugging Laucher" (DSF won't work).
* Debugger tab
  * GDB command (Ubuntu based) : "arm-none-eabi-gdb"
  * GDB command (Linux generic) : "/opt/xdev/gcc-arm-none-eabi-4_7-2013q2/bin/arm-none-eabi-gdb"
  * GDB command (Windows) : "C:\xdev\tools\gcc-arm\4.7_2013q2\bin\arm-none-eabi-gdb.exe"
  * Use remote target : checked
  * JTAG Device (via pipe)
  * GDB Connection string (stlink): "| openocd -f interface/stlink-v2.cfg -f target/stm32f4x_stlink.cfg -c "gdb_port pipe""
  * GDB Connection string (jtagkey2): "| openocd -f interface/jtagkey2.cfg -f board/stm3241g_eval.cfg -c "gdb_port pipe""
* Startup tab
  
  * disable Reset and delay (this command is not supported by openocd)
  * disable halt
  * commands (This will make sure the core is in a known state)
    monitor reset halt
    monitor flash erase_sector 0 0 0
    monitor reset halt
  * Load image : use project binary (this will load the software to flash)
  * Load symbols : use project binary (no debugging without symbols)
  * Set breakpoint at main
  * Run commands ( 1) reset the cpu -> reload PC 2) enable clock when in WFI 3) run to main
    monitor reset halt
    set *(uint32_t *)0xe0042004 = 0x00000001
    continue
* Common tab
  Save as shared file, so the debugging parameters will be saved into the project.