The PureThermal 1 is an embedded development platform for the FLIR Lepton thermal imager, created by GroupGets Labs. It is based around the STM32F4, a powerful ARM Cortex-M MCU by ST Microelectronics, and its various IO capabilities and open source firmware to make it easy integrate a FLIR Lepton into any environment.
It is intended that you use this firmware as a starting point for you own applications. For many applications where you wish to process thermal image data on a host PC, you can probably use pre-built binaries of this firmware and use as-is. For others, forking this project and making your own modifications to this firmware is encouraged.
This is a Makefile-based project, and we use the GCC ARM Embedded toolchain from https://launchpad.net/gcc-arm-embedded/+download, however, other toolchains that work for the STM32 (such as Mentor's Sourcery toolchain) should also work.
The following are compiler installation instructions for various platforms, required for building the firmware.
sudo add-apt-repository ppa:terry.guo/gcc-arm-embedded
sudo apt-get update
sudo apt-get install gcc-arm-none-eabi
Launchpad has toolchain binaries for OS X. To keep things simple, we'll install then into /usr/local/gcc-arm-none-eabi-*
sudo mkdir -p /usr/local
curl -L https://launchpad.net/gcc-arm-embedded/4.9/4.9-2015-q3-update/+download/gcc-arm-none-eabi-4_9-2015q3-20150921-mac.tar.bz2 -o ~/Downloads/gcc-arm-embedded.tar.bz2
sudo tar xjf ~/Downloads/gcc-arm-embedded.tar.bz2 -C /usr/local && rm ~/Downloads/gcc-arm-embedded.tar.bz2
Then you need to add this location to your path. Add to your .bashrc, or every time you open a new shell and wish to build execute:
export PATH=$PATH:/usr/local/gcc-arm-none-eabi-4_9-2015q3/bin
Toolchain https://launchpad.net/gcc-arm-embedded
Msys http://www.mingw.org/wiki/msys -or- install MINGW with MSYS. http://sourceforge.net/projects/mingw/files/latest/download?source=files
Command Line directions for building and updating the firmware:
Install Above software.
Add to your path, MSYS /bin
and Toolchain arm gcc /bin
folders.
git clone https://github.com/groupgets/purethermal1-firmware
cd purethermal1-firmware
If you wish, you can modify Src/project_config.h
to customize your build. Then you can simply build:
make
or
make USART_DEBUG=1
alternatively, you can enable semihosting support to printf over JTAG/SWD:
make GDB_SEMIHOSTING=1
See the "Debugging" section below for more information.
To put the device in boot loader mode: Plug in USB Cable Power on device first with ON/OFF button press While holding the BOOT0 button, press the RST button, Release the RST first, then release the BOOT0 button
Install dfu-util:
sudo apt-get install dfu-util
Then run:
dfu-util -a 0 -D main.bin -s 0x08000000
or use:
scripts/flash.sh
Install dfu-util via Homebrew
brew install dfu-util
Then run:
dfu-util -a 0 -D main.bin -s 0x08000000
or use:
scripts/flash.sh
DfuSe USB drivers. http://www.st.com/web/en/catalog/tools/FM147/CL1794/SC961/SS1533/PF257916#
win32 DFU tools https://files.groupgets.com/purethermal/win32_dfu.zip
To unstall DFU drivers, may need to use the device manager to select the st drivers
extract win32_dfu.zip
to the current folder.
win32_dfu\bin2dfu --i main.bin --a 0x08000000 --o main.dfu
win32_dfu\DfuSeCommand -c -d --fn main.dfu
or use:
scripts/make_and_flash.bat
Also, see the document GroupGets PureThermal 1 Firmware Installation Guide for Windows OS
This section covers printf
over JTAG/SWD though GDB semihosting. You can also set breakpoints using GDB+OpenOCD,
or with using the provided Eclipse projects. Additionally, you can enable printf support over UART.
For Makefile projects, you can enable semihosting support to enable printf over JTAG/SWD. This works with STLink/V2, Segger JLink, and should work with others as well.
You must build the code with semihosting support enabled (GDB_SEMIHOSTING=1). Note that if you get build errors,
you might have to make clean
and retry. Simply run the following:
GDB_SEMIHOSTING=1 make debug
The debugger should remain attached, and you should see printf output on the console, like so:
...
xPSR: 0x01000000 pc: 0x08010b8c msp: 0x20020000
semihosting is enabled
auto erase enabled
Info : device id = 0x10006431
Info : flash size = 512kbytes
wrote 131072 bytes from file main.bin in 4.133242s (30.968 KiB/s)
adapter speed: 2000 kHz
Info : JTAG tap: stm32f4x.cpu tap/device found: 0x4ba00477 (mfg: 0x23b (ARM Ltd.), part: 0xba00, ver: 0x4)
Info : JTAG tap: stm32f4x.bs tap/device found: 0x06431041 (mfg: 0x020 (STMicroelectronics), part: 0x6431, ver: 0x0)
Hello, Lepton!
reading_tmp007_regs...
Initialized...
Semihosting also works in Eclipse/OpenSTM32 projects. To enable this, locate the target debug configuration for the project and add the following line to Initialization Commands in the Startup tab:
monitor arm semihosting enable
You should see print statements appear in the debugger console view.
Refer to PureThermal 1 development wiki.
This firmware is licensed under The MIT License (MIT), see LICENSE
file for details.
Inquiries for support should be directed at this project's maintainers, GroupGets, LLC (GroupGets), and not FLIR Systems, Inc. (FLIR). Additional FLIR-provided source code is being released by GroupGets to this project under the express written consent of FLIR, and covered by the project's license, with the expectation that no warranties or support of any kind will be provided by FLIR.