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:
- Fedora (x86_64) >= 18
- Centos >= 7
- Ubuntu (x86_64) >= 14.04
- Debian >= Jessie
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.
Easy. Its make! Just run make and it will build it all.
MK2 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:
- Download the official MK2 toolchain
- Extract the tarball to a directory of your choice
- Add the 'bin' directory from within the newly extracted directory to your system PATH.
- Install pip (the Python package manager)
- Go to the ASL F4 Loader Project and follow the instructions on the README.md to install the asl_f4_loader application. This package does all the post-processing on MK2 firmware and provides a firmware loading utility.
From the root of the project, simply run make mk2. For a package run
make mk2-package.
When building from the command line, a debug version of the firmware is built by default. To disable debug and enable standard optimization, prefix the make command with:
RELEASE_TYPE=RELEASE_TYPE_BETA
The 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).
- Install the 64bit GCC packages for your system (need ld)
- Install libstdc++-static and libstdc++-devel for linking in test applications.
- Install the 64bit libcppunit library and its header and devel packages
- Install glibc-devel and glibc-headers
make test