How yangosoft/dpf works
Main Components
• ESP32 Firmware (located in src/dpf.cpp and src/dpf.hpp) – This is the central logic that reads diagnostic information, interacts with the peripherals, and manages the user interface.
• Hardware Peripherals:
• TFT Screen (ILI9341 based): The code drives the screen via defined GPIO connections (pins 15, 4, 23, 18, 2, etc. as per the README pinout table).
• ELM327 Bluetooth Module: Provides OBD interfacing to communicate diagnostic data.
• WiFi Access Point: Built-in functionality to allow configuration changes, such as modifying the Bluetooth device, PIN, etc.
• Schematics and Physical Design:
• PCB Design files (in schema/dpf1): Designed with Eagle, these represent the printed circuit board.
• Supporting Files:
• PlatformIO configuration (platformio.ini) defines the build, flashing, and debugging settings.
• CI/CD Workflows (.github/workflows/main.yml), documentation (doc folder), and additional hardware design files.
Relationships and Interactions
• The ESP32 microcontroller is the system’s core; it interfaces directly with all hardware components.
• The firmware running on the ESP32 handles:
• Data acquisition from the vehicle’s diagnostic signals (via ELM327 Bluetooth)
• Displaying information on the TFT screen.
• Providing a WiFi access point for configuration and possibly remote monitoring.
• The README’s external links and prototypes images indicate that the system was built iteratively, suggesting a direct mapping between the software drivers and hardware accessories.
Architectural Patterns and Design Principles
• Modular Hardware Integration: Separating functions such as display handling, Bluetooth interfacing, and network configuration in the firmware.
• Separation of Concerns: Distinct directories for firmware code (src), design schematics (schema), and documentation (doc).
• Use of PlatformIO indicates an embedded systems development workflow, which benefits from clear build and configuration management.
Final Recommendations
• Be as detailed as possible by now listing each individual component and its direct interactions.