How masontl/ae86-4age-hil-validation-testbed works
This repository is an evolving AE86 engine hardware-in-the-loop testbed: a virtual engine plant drives a cockpit/recorder observer through conditioned signals, while host tools inject faults and analyze recorded telemetry. The diagram combines documented capabilities with sampled Python tools; the Arduino firmware and circuit files are represented by paths from the tree, but their internals were not sampled. The repository contains many dated iterations, so several analysis nodes group related processors by subsystem and directory.
Main entry points: lesson14_MCU2_interface_device.ino Cockpit Observer MCU · MCU2_Hachi_cockpit_FDR_L10_SD_card_integration.ino SD Flight Recorder · lesson14_MCU1_4A-GE_ECU.ino Engine Plant MCU · hil_automated_fault_test_CSV_name_update.py Fault Injection
Components 18
HIL Testbed
- SimulIDE Circuit
HIL simulation 20261114/AE86_HIL_simulation_ECU-to-Interface_MCU.sim2 - Signal Conditioning
Embedded System
- Engine Plant MCU
HIL simulation 20261114/lesson14_MCU1_4A-GE_ECU/lesson14_MCU1_4A-GE_ECU.ino - Cockpit Observer MCU
HIL simulation 20261114/lesson14_MCU2_interface_device/lesson14_MCU2_interface_device.ino - Freeze-Frame Recorder
HIL simulation 20261027/MCU2_Hachi_cockpit_os_and_20_10_recorder_20261027/MCU2_Hachi_cockpit_os_and_20_10_recorder_20261027.ino - SD Flight Recorder
HIL simulation 20261030/MCU2_Hachi_cockpit_FDR_L10_SD_card_integration/MCU2_Hachi_cockpit_FDR_L10_SD_card_integration.ino
Host Tools
- Fault Injection
HIL simulation 20261023/hil_automated_fault_test_CSV_name_update.py - BIST Diagnostics
HIL simulation 20261027/diagnostic_and_automation_BIST_script.py - Serial Interface
- SD Card Daemon
HIL simulation 20261030/sd_card_daemon.py
Telemetry Analysis
- Image Extraction
HIL simulation 20261102/hachi_read_SDimg_create_csv.py - Mission Dissection
HIL simulation 20261029 - Control Analysis
HIL simulation 20261030 - Warmup Analysis
HIL simulation 20261101 - Igniter Analysis
HIL simulation 20261102 - HIL Verification
HIL simulation 20261114/sd_post_processor_HIL_CRC_verification_harness_robust.py - Mission Archives
HIL simulation 20261114/hachi_mission_archive_00.csv
Other components
- Test Engineer
Connections 18
- Test Engineer → Fault Injection: runs tests
HIL simulation 20261023/hil_automated_fault_test_CSV_name_update.py - Fault Injection → Serial Interface: injects faults
HIL simulation 20261023/hil_automated_fault_test_CSV_name_update.py - BIST Diagnostics → Serial Interface: reads telemetry
HIL simulation 20261027/diagnostic_and_automation_BIST_script.py - Serial Interface → Cockpit Observer MCU: exchanges data
- Engine Plant MCU → Signal Conditioning: outputs signals
README.md - Signal Conditioning → Cockpit Observer MCU: conditions signals
README.md - Cockpit Observer MCU → Engine Plant MCU: feedback actuators
README.md - Cockpit Observer MCU → Freeze-Frame Recorder: stores freeze-frame
README.md - Cockpit Observer MCU → SD Flight Recorder: streams telemetry
README.md - SD Flight Recorder → SD Card Daemon: streams telemetry
README.md - SD Card Daemon → Mission Dissection: writes CSV log
HIL simulation 20261029/sd_post_processor.py - Mission Dissection → Mission Archives: archives report
HIL simulation 20261029/sd_post_processor.py - SD Flight Recorder → Image Extraction: records SD image
- Image Extraction → Control Analysis: produces CSV
- Control Analysis → Warmup Analysis: analyzes control
- Warmup Analysis → Igniter Analysis: extends diagnosis
- Igniter Analysis → HIL Verification: supports verification
- HIL Verification → Mission Archives: reports results