Installation instructions

• Stuff you'll need for our stuff

• How to build our stuff

• How to get get our stuff on your chip

Step 1 - Stuff you'll need for our stuff - Tools:

• GCC ARM
  Download and install the [ ARM-maintained GCC toolchain (gcc-arm-none-eabi-4_7-2012q4 or later) ]. I HIGHLY RECOMMEND installing the prebuilt version, as rebuilding any gcc is quiet painful and time consuming!
• Some version of gmake (http://www.gnu.org/software/make/)
• USB Firmware upgrading tool that supports the DFU protocol.
  We use dfu-util. There are Debian Wheezy (aptitude install dfu-util) and Macports (sudo port -u install dfu-util) packages for easy install and their website has binaries for many platforms including Windows.
• And/Or If you have a ST-LINK debugger you will need OpenOCD
  There are Debian Wheezy (aptitude install openocd +stlink) and Macports (sudo port -u install openocd +stlink) packages for easy installation. For windows users the OpenOCD site points users to Freddie Chopin under the 'Downloads' tab.

If you plan on rebuilding the library foundation you will also need :

• Python (2.7 or higher)(Default in Debian Wheezy 2.7.3)
• The numpy python Package (Debian Wheezy python-numpy)
• The scipy python Package (Debian Wheezy python-scipy), which you can avoid if you studiously avoid rebuilding 'readDocs/irritating'.
• pdftotext and pdftoppm (from Poppler)(Debian poppler-utils)

Step 2 - How to build our stuff - The Peripheral library:

• For now only the current version is available to clone from github:
  git clone [email protected]:ashima/embedded-STM32F-lib.git
• Build the information base: cd readDocs; make
• Build the library: cd library; make; make install
• Build some of the examples: cd examples/your-fav-example; make

if you have scipy installed and current version of libXML, you can also rebuild files in the 'irritating' directory.

Step 3 - How to get get our stuff on your chip - Flashing a chip.

• using dfu-util and the STM32 booted with its on board boot loader : $ dfu-util -l will show you all the possible targets; you should see a line that looks like this: Found DFU: [0483:df11] devnum=0, cfg=1, intf=0, alt=0, name="@Internal Flash /0x08000000/04*016Kg,01*064Kg,07*128Kg" If you don't see that, ensure the power LEDs are on, and that the board is set to boot form 'system' (SYS) memory. To load a binary file onto the chip do : $ dfu-util -d 0483:df11 -a 0 --dfuse-address 0x08000000 -D name-of-the-binary.bin
• using ST-LINK/V2 (via openocd): You can also do this through ST-LINK. (coming soon)