Skip to content

Latest commit

 

History

History
30 lines (23 loc) · 1.86 KB

README.md

File metadata and controls

30 lines (23 loc) · 1.86 KB
Raw

PyGauge

PyGauge is a Python service (also available as a pre-built exe, see releases) and accompanying Arduino sketch to display DiRT Rally telemetry data (currently gear, speed, and rev lights) on the TM1638 LED module.

Additional information is available here: http://www.billiam.org/2015/07/02/dirt-rally-shift-light-tm1648-arduino/

Prerequisites

Instructions assume that you have an Arduino connected via USB serial that you can upload sketches to, and that is hooked up to the TM1638 LED module.

Install

  1. Download the latest gauge.zip file release
  2. Download the TM1638 library and place in your Arduino libraries directory.
  3. Download the arduino sketch, update the pin values for strobe, clock and data pins, and upload your sketch.
  4. Update your DiRT Rally hardware_settings_config (located in <user>\Documents\My Games\DiRT Rally\hardwaresettings, setting motion_platform > udf enabled to true, and extradata to 3.
<motion_platform>
  ...
  <udp enabled="true" extradata="3" ip="127.0.0.1" port="20777" delay="1" />
</motion_platform>
  1. Update the config.yml file in the gauge.zip, setting the port and ip address to match your DiRT Rally information above, and the COM port your arduino is connected to.
  2. Run gauge.exe and launch DiRT Rally. If everything's set up correctly, you should begin to see telemetry information when your stage begins.

Building / Contributing

Assuming you're running in a git bash / cygwin / etc environment:

  1. Install python dependencies with pip install -r requirements.txt
  2. Run build.sh

This will build an exe and copy the config file in the dist directory, and create a zip containing these files.