2015-01-14 07:09:08 -08:00
# CANtact Firmware
2016-02-29 16:42:22 -08:00
[![Build Status ](https://travis-ci.org/linklayer/cantact-fw.svg?branch=master )](https://travis-ci.org/linklayer/cantact-fw)
2015-01-28 13:10:41 -08:00
2015-01-14 07:09:08 -08:00
This repository contains sources for CANtact firmware.
## Building
2015-01-28 13:10:41 -08:00
Firmware builds with GCC. Specifically, you will need gcc-arm-none-eabi, which
is packaged for Windows, OS X, and Linux on
[Launchpad ](https://launchpad.net/gcc-arm-embedded/+download ). Download for your
2015-01-14 07:09:08 -08:00
system and add the `bin` folder to your PATH.
2016-07-24 16:06:39 -07:00
With that done, you should be able to compile using `make` . If you are compiling for a device that has no external crystal, compile with `make INTERNAL_OSCILLATOR=1` .
2015-01-14 07:09:08 -08:00
## Flashing & Debugging
2015-01-28 13:10:41 -08:00
Debugging and flashing can be done with any STM32 Discovery board as a
2015-01-14 07:09:08 -08:00
programmer. You can also use other tools that support SWD.
To use an STM32 Discovery, run [OpenOCD ](http://openocd.sourceforge.net/ ) using
the stm32f0x.cfg file: `openocd -f fw/stm32f0x.cfg` .
With OpenOCD running, arm-none-eabi-gdb can be used to load code and debug.
2015-01-28 13:46:46 -08:00
## Contributors
- [Ethan Zonca ](https://github.com/normaldotcom ) - Makefile fixes and code size optimization
2015-05-06 11:45:08 -07:00
- [onejope ](https://github.com/onejope ) - Fixes to extended ID handling
2015-05-15 11:38:53 -07:00
- Phil Wise - Added dfu-util compatibility to Makefile
2015-01-28 13:46:46 -08:00
2015-01-14 07:09:08 -08:00
## License
See LICENSE.md