# masontl/ae86-4age-hil-validation-testbed architecture

> Architecture diagram of the GitHub repository masontl/ae86-4age-hil-validation-testbed, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-20). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/masontl/ae86-4age-hil-validation-testbed
- Repository: https://github.com/masontl/ae86-4age-hil-validation-testbed

## Overview

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: [`HIL simulation 20261114/lesson14_MCU2_interface_device/lesson14_MCU2_interface_device.ino`](https://github.com/masontl/ae86-4age-hil-validation-testbed/blob/main/HIL%20simulation%2020261114/lesson14_MCU2_interface_device/lesson14_MCU2_interface_device.ino) (Cockpit Observer MCU), [`HIL simulation 20261030/MCU2_Hachi_cockpit_FDR_L10_SD_card_integration/MCU2_Hachi_cockpit_FDR_L10_SD_card_integration.ino`](https://github.com/masontl/ae86-4age-hil-validation-testbed/blob/main/HIL%20simulation%2020261030/MCU2_Hachi_cockpit_FDR_L10_SD_card_integration/MCU2_Hachi_cockpit_FDR_L10_SD_card_integration.ino) (SD Flight Recorder), [`HIL simulation 20261114/lesson14_MCU1_4A-GE_ECU/lesson14_MCU1_4A-GE_ECU.ino`](https://github.com/masontl/ae86-4age-hil-validation-testbed/blob/main/HIL%20simulation%2020261114/lesson14_MCU1_4A-GE_ECU/lesson14_MCU1_4A-GE_ECU.ino) (Engine Plant MCU), [`HIL simulation 20261023/hil_automated_fault_test_CSV_name_update.py`](https://github.com/masontl/ae86-4age-hil-validation-testbed/blob/main/HIL%20simulation%2020261023/hil_automated_fault_test_CSV_name_update.py) (Fault Injection)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_hil["HIL Testbed"]
  node_simulide["SimulIDE Circuit"]
  node_conditioning["Signal Conditioning"]
end

subgraph group_embedded["Embedded System"]
  node_plant["Engine Plant MCU"]
  node_observer["Cockpit Observer MCU"]
  node_eeprom[("Freeze-Frame Recorder")]
  node_fdr[("SD Flight Recorder")]
end

subgraph group_host["Host Tools"]
  node_faulttest["Fault Injection"]
  node_bist["BIST Diagnostics"]
  node_serial["Serial Interface"]
  node_sddaemon["SD Card Daemon<br/>[sd_card_daemon.py]"]
end

subgraph group_analysis["Telemetry Analysis"]
  node_extract["Image Extraction"]
  node_processor29["Mission Dissection"]
  node_processor30["Control Analysis"]
  node_processor01["Warmup Analysis"]
  node_processor02["Igniter Analysis"]
  node_verification["HIL Verification"]
  node_archive["Mission Archives"]
end

node_engineer(("Test Engineer"))

node_engineer -->|"runs tests"| node_faulttest
node_faulttest -->|"injects faults"| node_serial
node_bist -->|"reads telemetry"| node_serial
node_serial -.->|"exchanges data"| node_observer
node_plant -->|"outputs signals"| node_conditioning
node_conditioning -->|"conditions signals"| node_observer
node_observer -->|"feedback actuators"| node_plant
node_observer -->|"stores freeze-frame"| node_eeprom
node_observer -->|"streams telemetry"| node_fdr
node_fdr -->|"streams telemetry"| node_sddaemon
node_sddaemon -->|"writes CSV log"| node_processor29
node_processor29 -->|"archives report"| node_archive
node_fdr -.->|"records SD image"| node_extract
node_extract -.->|"produces CSV"| node_processor30
node_processor30 -.->|"analyzes control"| node_processor01
node_processor01 -.->|"extends diagnosis"| node_processor02
node_processor02 -.->|"supports verification"| node_verification
node_verification -.->|"reports results"| node_archive

click node_simulide "https://github.com/masontl/ae86-4age-hil-validation-testbed/blob/main/HIL%20simulation%2020261114/AE86_HIL_simulation_ECU-to-Interface_MCU.sim2"
click node_plant "https://github.com/masontl/ae86-4age-hil-validation-testbed/blob/main/HIL%20simulation%2020261114/lesson14_MCU1_4A-GE_ECU/lesson14_MCU1_4A-GE_ECU.ino"
click node_observer "https://github.com/masontl/ae86-4age-hil-validation-testbed/blob/main/HIL%20simulation%2020261114/lesson14_MCU2_interface_device/lesson14_MCU2_interface_device.ino"
click node_eeprom "https://github.com/masontl/ae86-4age-hil-validation-testbed/blob/main/HIL%20simulation%2020261027/MCU2_Hachi_cockpit_os_and_20_10_recorder_20261027/MCU2_Hachi_cockpit_os_and_20_10_recorder_20261027.ino"
click node_fdr "https://github.com/masontl/ae86-4age-hil-validation-testbed/blob/main/HIL%20simulation%2020261030/MCU2_Hachi_cockpit_FDR_L10_SD_card_integration/MCU2_Hachi_cockpit_FDR_L10_SD_card_integration.ino"
click node_faulttest "https://github.com/masontl/ae86-4age-hil-validation-testbed/blob/main/HIL%20simulation%2020261023/hil_automated_fault_test_CSV_name_update.py"
click node_bist "https://github.com/masontl/ae86-4age-hil-validation-testbed/blob/main/HIL%20simulation%2020261027/diagnostic_and_automation_BIST_script.py"
click node_sddaemon "https://github.com/masontl/ae86-4age-hil-validation-testbed/blob/main/HIL%20simulation%2020261030/sd_card_daemon.py"
click node_extract "https://github.com/masontl/ae86-4age-hil-validation-testbed/blob/main/HIL%20simulation%2020261102/hachi_read_SDimg_create_csv.py"
click node_processor29 "https://github.com/masontl/ae86-4age-hil-validation-testbed/tree/main/HIL%20simulation%2020261029"
click node_processor30 "https://github.com/masontl/ae86-4age-hil-validation-testbed/tree/main/HIL%20simulation%2020261030"
click node_processor01 "https://github.com/masontl/ae86-4age-hil-validation-testbed/tree/main/HIL%20simulation%2020261101"
click node_processor02 "https://github.com/masontl/ae86-4age-hil-validation-testbed/tree/main/HIL%20simulation%2020261102"
click node_verification "https://github.com/masontl/ae86-4age-hil-validation-testbed/blob/main/HIL%20simulation%2020261114/sd_post_processor_HIL_CRC_verification_harness_robust.py"
click node_archive "https://github.com/masontl/ae86-4age-hil-validation-testbed/blob/main/HIL%20simulation%2020261114/hachi_mission_archive_00.csv"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_simulide,node_conditioning toneBlue
class node_plant,node_observer,node_eeprom,node_fdr toneAmber
class node_faulttest,node_bist,node_serial,node_sddaemon toneMint
class node_extract,node_processor29,node_processor30,node_processor01,node_processor02,node_verification,node_archive toneRose
class node_engineer toneIndigo
```

## Components

### HIL Testbed

- [SimulIDE Circuit](https://github.com/masontl/ae86-4age-hil-validation-testbed/blob/main/HIL%20simulation%2020261114/AE86_HIL_simulation_ECU-to-Interface_MCU.sim2): `HIL simulation 20261114/AE86_HIL_simulation_ECU-to-Interface_MCU.sim2`
- **Signal Conditioning**

### Embedded System

- [Engine Plant MCU](https://github.com/masontl/ae86-4age-hil-validation-testbed/blob/main/HIL%20simulation%2020261114/lesson14_MCU1_4A-GE_ECU/lesson14_MCU1_4A-GE_ECU.ino): `HIL simulation 20261114/lesson14_MCU1_4A-GE_ECU/lesson14_MCU1_4A-GE_ECU.ino`
- [Cockpit Observer MCU](https://github.com/masontl/ae86-4age-hil-validation-testbed/blob/main/HIL%20simulation%2020261114/lesson14_MCU2_interface_device/lesson14_MCU2_interface_device.ino): `HIL simulation 20261114/lesson14_MCU2_interface_device/lesson14_MCU2_interface_device.ino`
- [Freeze-Frame Recorder](https://github.com/masontl/ae86-4age-hil-validation-testbed/blob/main/HIL%20simulation%2020261027/MCU2_Hachi_cockpit_os_and_20_10_recorder_20261027/MCU2_Hachi_cockpit_os_and_20_10_recorder_20261027.ino): `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](https://github.com/masontl/ae86-4age-hil-validation-testbed/blob/main/HIL%20simulation%2020261030/MCU2_Hachi_cockpit_FDR_L10_SD_card_integration/MCU2_Hachi_cockpit_FDR_L10_SD_card_integration.ino): `HIL simulation 20261030/MCU2_Hachi_cockpit_FDR_L10_SD_card_integration/MCU2_Hachi_cockpit_FDR_L10_SD_card_integration.ino`

### Host Tools

- [Fault Injection](https://github.com/masontl/ae86-4age-hil-validation-testbed/blob/main/HIL%20simulation%2020261023/hil_automated_fault_test_CSV_name_update.py): `HIL simulation 20261023/hil_automated_fault_test_CSV_name_update.py`
- [BIST Diagnostics](https://github.com/masontl/ae86-4age-hil-validation-testbed/blob/main/HIL%20simulation%2020261027/diagnostic_and_automation_BIST_script.py): `HIL simulation 20261027/diagnostic_and_automation_BIST_script.py`
- **Serial Interface**
- [SD Card Daemon](https://github.com/masontl/ae86-4age-hil-validation-testbed/blob/main/HIL%20simulation%2020261030/sd_card_daemon.py): `HIL simulation 20261030/sd_card_daemon.py`

### Telemetry Analysis

- [Image Extraction](https://github.com/masontl/ae86-4age-hil-validation-testbed/blob/main/HIL%20simulation%2020261102/hachi_read_SDimg_create_csv.py): `HIL simulation 20261102/hachi_read_SDimg_create_csv.py`
- [Mission Dissection](https://github.com/masontl/ae86-4age-hil-validation-testbed/tree/main/HIL%20simulation%2020261029): `HIL simulation 20261029`
- [Control Analysis](https://github.com/masontl/ae86-4age-hil-validation-testbed/tree/main/HIL%20simulation%2020261030): `HIL simulation 20261030`
- [Warmup Analysis](https://github.com/masontl/ae86-4age-hil-validation-testbed/tree/main/HIL%20simulation%2020261101): `HIL simulation 20261101`
- [Igniter Analysis](https://github.com/masontl/ae86-4age-hil-validation-testbed/tree/main/HIL%20simulation%2020261102): `HIL simulation 20261102`
- [HIL Verification](https://github.com/masontl/ae86-4age-hil-validation-testbed/blob/main/HIL%20simulation%2020261114/sd_post_processor_HIL_CRC_verification_harness_robust.py): `HIL simulation 20261114/sd_post_processor_HIL_CRC_verification_harness_robust.py`
- [Mission Archives](https://github.com/masontl/ae86-4age-hil-validation-testbed/blob/main/HIL%20simulation%2020261114/hachi_mission_archive_00.csv): `HIL simulation 20261114/hachi_mission_archive_00.csv`

### Other components

- **Test Engineer**

## Connections

- Test Engineer → Fault Injection: runs tests (evidence: `HIL simulation 20261023/hil_automated_fault_test_CSV_name_update.py`)
- Fault Injection → Serial Interface: injects faults (evidence: `HIL simulation 20261023/hil_automated_fault_test_CSV_name_update.py`)
- BIST Diagnostics → Serial Interface: reads telemetry (evidence: `HIL simulation 20261027/diagnostic_and_automation_BIST_script.py`)
- Serial Interface → Cockpit Observer MCU: exchanges data
- Engine Plant MCU → Signal Conditioning: outputs signals (evidence: `README.md`)
- Signal Conditioning → Cockpit Observer MCU: conditions signals (evidence: `README.md`)
- Cockpit Observer MCU → Engine Plant MCU: feedback actuators (evidence: `README.md`)
- Cockpit Observer MCU → Freeze-Frame Recorder: stores freeze-frame (evidence: `README.md`)
- Cockpit Observer MCU → SD Flight Recorder: streams telemetry (evidence: `README.md`)
- SD Flight Recorder → SD Card Daemon: streams telemetry (evidence: `README.md`)
- SD Card Daemon → Mission Dissection: writes CSV log (evidence: `HIL simulation 20261029/sd_post_processor.py`)
- Mission Dissection → Mission Archives: archives report (evidence: `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
