The premier open source telemetry system for your race vehicle. RaceCapture/Pro is a hardware device that is installed in your vehicle that beams driving and vehicle telemetry to the cloud in real time. Combined with RaceCapture App and RaceCapture Live, teams and drivers can use the platform to learn how to drive faster an drive better, giving them the edge to win.
Please checkout the contributing document and follow all rules in there prior to submitting pull requests.
The only fully supported building system for RaceCapture Firmware is most any modern Linux based operating system.
The following are platforms that are known to work:
We will also support development on non-linux machines through the use of a Vagrant image. This will allow any developer with a computer capable of running virtualization to compile firmware.
Updating firmware to unreleased versions may restore the default configuration on RaceCapture/Pro Be sure to save your configuration using the Race Analyzer software. We will do what we can to help but do understand that this is unreleased code, and sometimes it has bugs.
The project is designed with multiple platforms in mind. Most platforms are hardware based but the testing platform is a pseudo platform that we use for mock operations to test our firmware. Info on each platform and how to use/compile for it can be found below.
To make things super simple there is a script called do_release.sh
that will build all platforms and test. To invoke it simply run
./do_release.sh from the root directory of the project.
MK1 is the original RaceCapture/Pro unit. Based on the AT91SAM7s chipset, it provided a solid platform for our initial release. It allows for up to a 100Hz channel sampling rate and up to 10Hz GPS sampling. It also supports CAN & OBD-II via the extrernal CANx module, various I/O, an SD card, and a remote GPS mouse for high quality GPS reception. It optionally comes with a separate telemetry unit that can handle passing the data over the cellular network. It, has now been succedded by the next generation of RaceCapture/Pro, MK2.
Do the following to setup the MK1 toolchain
Before compiling the firmware you must compile the LUA library for MK1. Do the following from the root of the project
cd lib_lua/src/make PLAT=stm32 genericmake PLAT=sam7x from the root directory of the RCP firmware
project.The output from the compilation should create a main.elf file. The flashing utility can be found in SAM7s_base/installer.
Before you can flash the firmware you MUST put the MK1 device into flashing mode. Do the following:
Perform the following steps from the root level of the project:
sudo SAM7s_base/installer/flasher main.elfMK2 is the second generation RaceCapture/Pro unit. Like its successor it has many of the same features that were originally loved, all of which have been improved upon. It also has some new features that were unavailable in the original MK1. MK2 supports sampling rates of up to 1 Kilo Hertz per channel (a 10x improvement from MK1) and a GPS unit that can sample up to 50Hz (a 5x improvement from MK1). It also includes a betteriInertial unit, an upgraded processor (STM32 base), more RAM (for better LUA support) and an integrated cellular device (optinal). The GPS unit is also integrated into this unit, allowing for a thinner wire and adjustable antenna (for those needing higher signal gain in wooded areas).
Do the following to setup the MK2 toolchain:
sudo pip install crcmod https://s3-us-west-2.amazonaws.com/asl-firmware/vagrant_setup/asl_f4_loader-0.0.6.tgz
to install the asl_f4_loader package. This does post-processing on MK2 firmware and provides a firmware loading
utility.Before compiling the firmware you must compile the LUA library for MK2. Do the following from the root of the project
cd lib_lua/src/make PLAT=stm32 genericFrom the root of the project do the following:
cd stm32_basemake PLAT=stm32The Test platform is used to validate and stress test our firmware code. While not a real platform per se, its easier to treat it this way. The test platform will work natively with Linux and OSX (>10.10).
brew install cppunitFrom the root of the project do the following:
cd testmakeFrom the root of the project do the following:
test/rcptest