How nmwilk/arduino_fanatec_wheel works
Project type and purpose
• This is a hardware-centric DIY embedded system with companion PC software.
• Purpose: enable a standard Arduino (Nano/Uno) steering-wheel “slave” to talk SPI with a Fanatec wheel-base, add buttons/D-pad and an alphanumeric display on the wheel, and optionally offer a Windows GUI for calibration/status.
• Key artifacts:
• Firmware (arduino_fanatec_wheel.ino) running on an Arduino Nano/Uno
• Level shifter circuit and PCB (KiCad project)
• 3D-printed mechanical fixtures (SolidWorks/STL in 3d Models)
• .NET WinForms display app (FanatecWindowsDisplay)
• TM1637 library for 7-segment display
File structure
• Top-level directories:
• “3d Models” → mechanical parts for connector, adapter, paddle shifters
• “Schematics & pcb layout” → KiCad source and Gerber for the board that integrates level shifter, connectors, buttons, display
• “libraries/TM1637” → driver library for alphanumeric display
• “FanatecWindowsDisplay” → C# WinForms project to show serial output
• Single source firmware at root: arduino_fanatec_wheel.ino
• README.md describes architecture: SPI comms, level shifting, analog inputs, diode isolation, serial-monitor calibration protocol
README for additional insights
• Describes hardware-electrical design:
• Fanatec base = SPI master, Arduino = SPI slave
• Level shifter recommended on MOSI/MISO/SCLK lines
• Diode in the 5 V supply line for isolation
• Buttons + D-pad wired as digital/analog inputs
• TM1637 alphanumeric display on two-wire interface
• Mentions calibration flow: D-pad and display drive interactive menu via serial or built-in controls
Main components and interactions (
a. Hardware blocks:
• Fanatec Wheel Base (SPI master, 3.3 V domain)
• Arduino Nano/Uno (SPI slave, 5 V domain)
• Logic Level Shifter (bidirectional on SPI lines)
• Diode on 5 V power rail (isolates wheel-base 5 V from USB 5 V)
• PCB Buttons & D-Pad (wired to digital/analog pins)
• TM1637 Alphanumeric Display (two‐wire bus to two digital pins)
• USB-Serial link (Arduino ↔ PC)
• 3D-Printed Connector/Adapter (mechanical interface)
b. Software blocks:
• Arduino Firmware (main loop: SPI_IRQ handler, button polling, display driver, serial handler)
• TM1637 Library (C++ abstraction for 7-segment display)
• Windows App (FanatecWindowsDisplay) reading serial port, rendering characters
c. Relationships & data flows:
• SPI lines (MISO/MOSI/SCLK/CS) flow between Wheel Base ↔ Level Shifter ↔ Arduino
• Arduino polls buttons & D-pad, updates SPI payload on next exchange
• Arduino drives TM1637 bus (CLK/DIO) to update display contents
• Arduino emits diagnostics/calibration messages over USB-Serial
• Windows App listens on COM port, parses messages, displays status
d. Architectural patterns & design principles:
• Hardware/Software separation: discrete blocks for power, logic, UI, mechanics
• Embedded event loop: interrupts for SPI, polling for inputs
• Isolation and voltage-domain crossing: diode and level shifter enforce 3.3 V vs 5 V boundaries
• Extensibility: 3D models and PC app are independent modules
e. Technology stack:
• Arduino C/C++ + TM1637 library
• KiCad for PCB capture & Gerber generation
• SolidWorks/STL for mechanical parts (3d Models)
• C#/.NET WinForms for PC GUI