pySRD9c

A Python library application for the Renovatio SRD-9c display (http://www.renovatio-dev.com/).

This makes use of the pywinusb module (https://github.com/rene-aguirre/pywinusb) to interface with the SRD-9c display. The display uses the HID protocol to provide an input interface as a joystick and an output interface for the nine 7-segment displays and 16 LEDs.

The output report is structured as follows (41 bytes total):

• report id: 1 byte, always 0 as this is the only output report
• left display: 4 bytes, each bit is a single segment of the display in the standard order (4 digits)
• right display: 4 bytes, each bit is a single segment of the display in the standard order (4 digits)
• green/red RPM LEDs: 1 byte, the four low bits are the green LEDs, the four high bits are the red LEDs
• blue/status LEDs: 1 byte, the four low bits are the blue RPM LEDs, the four high bits are the status LEDS (low to high: red, yellow, blue, green)
• gear display: 1 byte, each bit is a single segment of the display in the standard order (1 digit)
• padding/unknown: 29 bytes, all 0 during normal operation, setting all bytes to 0xff resets the device

Run by itself, pySRD9c.py will conduct a self-test on the display.

A sample application providing real-time telemetry data for RaceRoom Racing Experience and rFactor 1/Stock Car Extreme/Automobilista/Formula Truck/Copa Petrobras de Marcas is available in pyDash.py. It makes use of the psutil module (https://github.com/giampaolo/psutil) to detect which sim is running. It demonstrates custom mapping of RPM LEDs for use as push-to-pass/DRS indicators as well as warnings that blink the status LEDs during a critical state. It also features live lap timing, lap split time, field position, and lap progession during a race. The dash configuration is controlled via the pyDash.settings.json file (created on start-up if not found, re-read if modified while running).

Support for rFactor 1 is provided by the shared memory map plugin available at https://github.com/dallongo/rFactorSharedMemoryMap.

Releases

2016-06-30 (v2.0.1.1)

• Fix 'best' delta showing '0.00' in pyDashRF1 when setting new best time
• Add initial invalid lap detection to pyDashRF1

2016-06-26 (v2.0.1.0)

• Allow gear display to go up to 9
• Fix session restart not clearing session variables
• Add support for Formula Truck and Copa Petrobras de Marcas

2016-05-31 (v2.0.0.1)

• Fix array index type error (float instead of int) for fuel array slicing

2016-05-30 (v2.0.0.0)

• Merged pyDashR3E and pyDashRF1 into single application
• Improved session detection and clearing/resetting of session-specific variables
• Improved logging prints time stamp and information when new session is detected, average fuel use/temperature ranges and lap times
• Improved fuel use estimates and overheating detection by using weighted averages
• Display now cleared upon exiting sim
• Mulitple instance detection to protect against race condition that causes settings JSON to be infinitely rewritten to disk
• Automatic sim detection
• Tachometer range and shift light point can now be configured via settings
• Fuel and temperature warnings can now be disabled/tuned via settings

2016-05-14 (v1.1.0.0)

• Fix DRS LEDs for R3E DTM 2013-2016 cars
• 32-bit builds for pySRD9c, pyDashR3E, and pyDashRF1
• Live gameplay video with R3E available at https://youtu.be/A4aYvwhkx8I

2016-05-09 (v1.0.1.0)

• Added pyRF1.py and pyDashRF1.py to support rFactor 1-based sims
• Fixed errors in fuel and sector split time calculations
• Added missing checks on 'drs_ptp' settings

2016-05-07 (v1.0.0.0)

• First compiled/binary release!
• Update fuel/temp logic (average over first two laps as baseline)
• Consolidate DRS and PTP light code
• Add spec, version, and icon file (from https://smarticons.co/set/glyph) for building with pyinstaller
• Add wait time to srd9c.hw_reset()

2016-05-06

• Split r3e.py into pyDashR3E.py and pyR3E.py for the memory API structure
• Added configuration control via pyDashR3E.settings.json

2016-05-05

• Added sector split times
• Lap and sector splits now compared to previous lap (and proper handling of invalid laps)
• Fix improper display of session time/laps remaining
• Remove psutil dependency
• Consolidated sector split time and lap split time functions
• Fixed position and session time/laps remaining not showing when current lap invalidated within first few seconds
• Added very basic logging to log.txt
• Basic code clean-up and added comments
• Added hardware tests to pySRD9c.py

2016-05-04

• Refactor pySRD9c.py and add testing loop as self test method
• Update r3e.py shared memory struct to include push-to-pass from https://github.com/mrbelowski/CrewChiefV4/blob/master/CrewChiefV4/R3E/RaceRoomData.cs and correct an enum error
• Add lap timing, split times, blinking status indicators, PTP/DRS meter, and text warnings such as 'fuel' for low fuel and 'heat' for overheating.
• Added r3e.py application for live telemetry data in RaceRoom Racing Experience

2016-05-02

• Initial release