# mrdevanagalingam/rb-imx6ul-integrated-qtp architecture

> Architecture diagram of the GitHub repository mrdevanagalingam/rb-imx6ul-integrated-qtp, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-08). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/mrdevanagalingam/rb-imx6ul-integrated-qtp
- Repository: https://github.com/mrdevanagalingam/rb-imx6ul-integrated-qtp

## Overview

RB-IMX6UL Integrated QTP is a host-and-target hardware qualification tool. An operator selects a numbered check; the host gathers any required input, sends a framed command over RS232, the target dispatches it to board tests, and the host displays and logs the result. The README documents DDR, NAND, UART, RTC/I2C, GPIO and ADC coverage, though sampled target-test excerpts show only some implementations. Host and target protocol framing are separate implementations; their communication is documented. GPIO utilities form an internal layer used by target tests. Unsampled test paths are represented from README capabilities, not source inspection.

Main entry points: [`RB_IMX6UL_Integrated_QTP_Host/interactive_menu.py`](https://github.com/mrdevanagalingam/rb-imx6ul-integrated-qtp/blob/main/RB_IMX6UL_Integrated_QTP_Host/interactive_menu.py) (Test menu), [`RB_IMX6UL_Integrated_QTP_Host/main.py`](https://github.com/mrdevanagalingam/rb-imx6ul-integrated-qtp/blob/main/RB_IMX6UL_Integrated_QTP_Host/main.py) (Host startup), [`RB_IMX6UL_Integrated_QTP_Target/tests.py`](https://github.com/mrdevanagalingam/rb-imx6ul-integrated-qtp/blob/main/RB_IMX6UL_Integrated_QTP_Target/tests.py) (Hardware tests), [`RB_IMX6UL_Integrated_QTP_Host/uart_handler.py`](https://github.com/mrdevanagalingam/rb-imx6ul-integrated-qtp/blob/main/RB_IMX6UL_Integrated_QTP_Host/uart_handler.py) (Host UART framing)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_host["Host operator workflow"]
  node_host_start["Host startup<br/>[main.py]"]
  node_menu["Test menu"]
  node_command["Command handling<br/>[command_handler.py]"]
  node_report["Result logging"]
  node_host_logs["Host text logs"]
end

subgraph group_link["UART protocol link"]
  node_host_uart["Host UART framing<br/>[uart_handler.py]"]
end

subgraph group_target["Target test execution"]
  node_target_uart["Target UART server<br/>[main.py]"]
  node_dispatcher["Frame dispatch<br/>[dispatcher.py]"]
  node_tests["Hardware tests<br/>[tests.py]"]
end

subgraph group_board["Board access layer"]
  node_config["Board configuration<br/>[config.py]"]
  node_gpio["GPIO operations<br/>[gpio.py]"]
end

node_operator(("Operator"))
node_board{{"IMX6UL board"}}

node_operator -->|"starts"| node_host_start
node_host_start -->|"connects"| node_host_uart
node_host_start -->|"creates handler"| node_command
node_host_start -->|"starts menu"| node_menu
node_operator -->|"selects test"| node_menu
node_menu -->|"dispatches selection"| node_command
node_command -->|"sends command"| node_host_uart
node_host_uart -->|"exchanges frames"| node_target_uart
node_target_uart -->|"serves UART"| node_dispatcher
node_dispatcher -->|"dispatches tests"| node_tests
node_dispatcher -->|"reads settings"| node_config
node_tests -->|"uses settings"| node_config
node_tests -->|"uses GPIO"| node_gpio
node_tests -->|"runs hardware checks"| node_board
node_gpio -->|"operates pins"| node_board
node_host_uart -->|"returns response"| node_command
node_menu -->|"records outcomes"| node_report
node_report -->|"writes logs"| node_host_logs
node_menu -->|"shows results"| node_operator

click node_host_start "https://github.com/mrdevanagalingam/rb-imx6ul-integrated-qtp/blob/main/RB_IMX6UL_Integrated_QTP_Host/main.py"
click node_menu "https://github.com/mrdevanagalingam/rb-imx6ul-integrated-qtp/blob/main/RB_IMX6UL_Integrated_QTP_Host/interactive_menu.py"
click node_command "https://github.com/mrdevanagalingam/rb-imx6ul-integrated-qtp/blob/main/RB_IMX6UL_Integrated_QTP_Host/command_handler.py"
click node_report "https://github.com/mrdevanagalingam/rb-imx6ul-integrated-qtp/blob/main/RB_IMX6UL_Integrated_QTP_Host/interactive_menu.py"
click node_host_uart "https://github.com/mrdevanagalingam/rb-imx6ul-integrated-qtp/blob/main/RB_IMX6UL_Integrated_QTP_Host/uart_handler.py"
click node_target_uart "https://github.com/mrdevanagalingam/rb-imx6ul-integrated-qtp/blob/main/RB_IMX6UL_Integrated_QTP_Target/main.py"
click node_dispatcher "https://github.com/mrdevanagalingam/rb-imx6ul-integrated-qtp/blob/main/RB_IMX6UL_Integrated_QTP_Target/dispatcher.py"
click node_config "https://github.com/mrdevanagalingam/rb-imx6ul-integrated-qtp/blob/main/RB_IMX6UL_Integrated_QTP_Target/config.py"
click node_tests "https://github.com/mrdevanagalingam/rb-imx6ul-integrated-qtp/blob/main/RB_IMX6UL_Integrated_QTP_Target/tests.py"
click node_gpio "https://github.com/mrdevanagalingam/rb-imx6ul-integrated-qtp/blob/main/RB_IMX6UL_Integrated_QTP_Target/gpio.py"
click node_host_logs "https://github.com/mrdevanagalingam/rb-imx6ul-integrated-qtp/blob/main/RB_IMX6UL_Integrated_QTP_Host/interactive_menu.py"

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_host_start,node_menu,node_command,node_report,node_host_logs toneBlue
class node_host_uart toneAmber
class node_target_uart,node_dispatcher,node_tests toneMint
class node_config,node_gpio toneRose
class node_operator,node_board toneIndigo
```

## Components

### Host operator workflow

- [Host startup](https://github.com/mrdevanagalingam/rb-imx6ul-integrated-qtp/blob/main/RB_IMX6UL_Integrated_QTP_Host/main.py): `RB_IMX6UL_Integrated_QTP_Host/main.py`
- [Test menu](https://github.com/mrdevanagalingam/rb-imx6ul-integrated-qtp/blob/main/RB_IMX6UL_Integrated_QTP_Host/interactive_menu.py): `RB_IMX6UL_Integrated_QTP_Host/interactive_menu.py`
- [Command handling](https://github.com/mrdevanagalingam/rb-imx6ul-integrated-qtp/blob/main/RB_IMX6UL_Integrated_QTP_Host/command_handler.py): `RB_IMX6UL_Integrated_QTP_Host/command_handler.py`
- [Result logging](https://github.com/mrdevanagalingam/rb-imx6ul-integrated-qtp/blob/main/RB_IMX6UL_Integrated_QTP_Host/interactive_menu.py): `RB_IMX6UL_Integrated_QTP_Host/interactive_menu.py`
- [Host text logs](https://github.com/mrdevanagalingam/rb-imx6ul-integrated-qtp/blob/main/RB_IMX6UL_Integrated_QTP_Host/interactive_menu.py): `RB_IMX6UL_Integrated_QTP_Host/interactive_menu.py`

### UART protocol link

- [Host UART framing](https://github.com/mrdevanagalingam/rb-imx6ul-integrated-qtp/blob/main/RB_IMX6UL_Integrated_QTP_Host/uart_handler.py): `RB_IMX6UL_Integrated_QTP_Host/uart_handler.py`

### Target test execution

- [Target UART server](https://github.com/mrdevanagalingam/rb-imx6ul-integrated-qtp/blob/main/RB_IMX6UL_Integrated_QTP_Target/main.py): `RB_IMX6UL_Integrated_QTP_Target/main.py`
- [Frame dispatch](https://github.com/mrdevanagalingam/rb-imx6ul-integrated-qtp/blob/main/RB_IMX6UL_Integrated_QTP_Target/dispatcher.py): `RB_IMX6UL_Integrated_QTP_Target/dispatcher.py`
- [Hardware tests](https://github.com/mrdevanagalingam/rb-imx6ul-integrated-qtp/blob/main/RB_IMX6UL_Integrated_QTP_Target/tests.py): `RB_IMX6UL_Integrated_QTP_Target/tests.py`

### Board access layer

- [Board configuration](https://github.com/mrdevanagalingam/rb-imx6ul-integrated-qtp/blob/main/RB_IMX6UL_Integrated_QTP_Target/config.py): `RB_IMX6UL_Integrated_QTP_Target/config.py`
- [GPIO operations](https://github.com/mrdevanagalingam/rb-imx6ul-integrated-qtp/blob/main/RB_IMX6UL_Integrated_QTP_Target/gpio.py): `RB_IMX6UL_Integrated_QTP_Target/gpio.py`

### Other components

- **Operator**
- **IMX6UL board**

## Connections

- Operator → Host startup: starts (evidence: `README.md`)
- Host startup → Host UART framing: connects (evidence: `RB_IMX6UL_Integrated_QTP_Host/main.py`)
- Host startup → Command handling: creates handler (evidence: `RB_IMX6UL_Integrated_QTP_Host/main.py`)
- Host startup → Test menu: starts menu (evidence: `RB_IMX6UL_Integrated_QTP_Host/main.py`)
- Operator → Test menu: selects test (evidence: `README.md`)
- Test menu → Command handling: dispatches selection (evidence: `RB_IMX6UL_Integrated_QTP_Host/interactive_menu.py`)
- Command handling → Host UART framing: sends command (evidence: `RB_IMX6UL_Integrated_QTP_Host/command_handler.py`)
- Host UART framing → Target UART server: exchanges frames (evidence: `README.md`)
- Target UART server → Frame dispatch: serves UART (evidence: `RB_IMX6UL_Integrated_QTP_Target/main.py`)
- Frame dispatch → Hardware tests: dispatches tests (evidence: `RB_IMX6UL_Integrated_QTP_Target/dispatcher.py`)
- Frame dispatch → Board configuration: reads settings (evidence: `RB_IMX6UL_Integrated_QTP_Target/dispatcher.py`)
- Hardware tests → Board configuration: uses settings (evidence: `RB_IMX6UL_Integrated_QTP_Target/tests.py`)
- Hardware tests → GPIO operations: uses GPIO (evidence: `RB_IMX6UL_Integrated_QTP_Target/tests.py`)
- Hardware tests → IMX6UL board: runs hardware checks (evidence: `README.md`)
- GPIO operations → IMX6UL board: operates pins (evidence: `README.md`)
- Host UART framing → Command handling: returns response (evidence: `RB_IMX6UL_Integrated_QTP_Host/command_handler.py`)
- Test menu → Result logging: records outcomes (evidence: `RB_IMX6UL_Integrated_QTP_Host/interactive_menu.py`)
- Result logging → Host text logs: writes logs (evidence: `RB_IMX6UL_Integrated_QTP_Host/interactive_menu.py`)
- Test menu → Operator: shows results (evidence: `RB_IMX6UL_Integrated_QTP_Host/interactive_menu.py`)
