# pngo250199/explorer_car_project architecture

> Architecture diagram of the GitHub repository pngo250199/explorer_car_project, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-21). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/pngo250199/explorer_car_project
- Repository: https://github.com/pngo250199/explorer_car_project

## Overview

This repository combines an autonomous-car prototype with STM32 firmware projects and a Zynq/Vitis-to-FPGA communication milestone. The demonstrated workflow is Cortex-A9 software reading FPGA switch inputs and writing the resulting value to LED outputs; README-described vision processing and STM32 vehicle control are broader planned capabilities. The Explorer firmware’s main-module references support its sensor and UART branches, but unsampled implementation details are not inferred.

Main entry points: [`STM/workspace/Explorer_car/Sources/main.c`](https://github.com/pngo250199/explorer_car_project/blob/main/STM/workspace/Explorer_car/Sources/main.c) (Explorer app), [`STM/workspace/AutonomouseCar/Core/Src/main.c`](https://github.com/pngo250199/explorer_car_project/blob/main/STM/workspace/AutonomouseCar/Core/Src/main.c) (STM32 application), [`Vitis/car_project/car_software_part/src/main.c`](https://github.com/pngo250199/explorer_car_project/blob/main/Vitis/car_project/car_software_part/src/main.c) (Cortex-A9 app), [`Vivado/Car_project/ip_repo/customIP_1_0/drivers/customIP_v1_0/src/customIP.c`](https://github.com/pngo250199/explorer_car_project/blob/main/Vivado/Car_project/ip_repo/customIP_1_0/drivers/customIP_v1_0/src/customIP.c) (Custom AXI IP)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_zynq["Zynq and FPGA"]
  node_cortex["Cortex-A9 app<br/>[main.c]"]
  node_custom_ip["Custom AXI IP<br/>[customIP.c]"]
  node_switches["FPGA switches"]
  node_leds["FPGA LEDs"]
end

subgraph group_stm32["STM32 Firmware"]
  node_stm_main["STM32 application<br/>[main.c]"]
  node_stm_ir["IR sensing<br/>[ir.c]"]
  node_stm_motor["Motor control<br/>[motor.c]"]
  node_stm_timer["Timer support<br/>[SysTick.c]"]
end

subgraph group_explorer["Explorer Firmware"]
  node_explorer_main["Explorer app<br/>[main.c]"]
  node_explorer_uart["UART firmware<br/>[uart.c]"]
  node_explorer_ir["IR sensing<br/>[ir_sensor.c]"]
  node_ultrasound["Ultrasonic sensing"]
  node_uart1["UART1 firmware<br/>[uart1.c]"]
end

subgraph group_planned["Planned Perception"]
  node_camera["Camera pipeline"]
  node_image_processing["Image processing"]
  node_vehicle_control["Vehicle control"]
end

node_operator(("Vehicle / operator"))

node_cortex -->|"reads and writes"| node_custom_ip
node_switches -->|"input register"| node_custom_ip
node_custom_ip -->|"drives outputs"| node_leds
node_operator -.->|"sets inputs"| node_switches
node_explorer_main -->|"uses UART"| node_explorer_uart
node_explorer_main -->|"uses sensor"| node_explorer_ir
node_explorer_main -->|"uses sensor"| node_ultrasound
node_stm_main -.->|"coordinates sensing"| node_stm_ir
node_stm_main -.->|"commands motors"| node_stm_motor
node_stm_main -.->|"uses timing"| node_stm_timer
node_camera -.->|"supplies frames"| node_image_processing
node_image_processing -.->|"returns results"| node_cortex
node_cortex -.->|"coordinates control"| node_vehicle_control
node_vehicle_control -.->|"communicates with"| node_stm_main
node_explorer_main -.->|"may use UART1"| node_uart1

click node_cortex "https://github.com/pngo250199/explorer_car_project/blob/main/Vitis/car_project/car_software_part/src/main.c"
click node_custom_ip "https://github.com/pngo250199/explorer_car_project/blob/main/Vivado/Car_project/ip_repo/customIP_1_0/drivers/customIP_v1_0/src/customIP.c"
click node_stm_main "https://github.com/pngo250199/explorer_car_project/blob/main/STM/workspace/AutonomouseCar/Core/Src/main.c"
click node_stm_ir "https://github.com/pngo250199/explorer_car_project/blob/main/STM/workspace/AutonomouseCar/Core/Src/Sensor_sources/ir.c"
click node_stm_motor "https://github.com/pngo250199/explorer_car_project/blob/main/STM/workspace/AutonomouseCar/Core/Src/Sensor_sources/motor.c"
click node_stm_timer "https://github.com/pngo250199/explorer_car_project/blob/main/STM/workspace/AutonomouseCar/Core/Src/Firmware_sources/SysTick.c"
click node_explorer_main "https://github.com/pngo250199/explorer_car_project/blob/main/STM/workspace/Explorer_car/Sources/main.c"
click node_explorer_uart "https://github.com/pngo250199/explorer_car_project/blob/main/STM/workspace/Explorer_car/Sources/Firmwares_sources/uart.c"
click node_explorer_ir "https://github.com/pngo250199/explorer_car_project/blob/main/STM/workspace/Explorer_car/Sources/Sensors_sources/ir_sensor.c"
click node_ultrasound "https://github.com/pngo250199/explorer_car_project/blob/main/STM/workspace/Explorer_car/Sources/Sensors_sources/ultrasound_sensor.c"
click node_uart1 "https://github.com/pngo250199/explorer_car_project/blob/main/STM/workspace/Explorer_car/Sources/Firmwares_sources/uart1.c"
click node_camera "https://github.com/pngo250199/explorer_car_project/tree/main/Vivado/Car_project"
click node_image_processing "https://github.com/pngo250199/explorer_car_project/tree/main/Vivado/Car_project"
click node_vehicle_control "https://github.com/pngo250199/explorer_car_project/tree/main/STM/workspace/AutonomouseCar/Core/Src"

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_cortex,node_custom_ip,node_switches,node_leds toneBlue
class node_stm_main,node_stm_ir,node_stm_motor,node_stm_timer toneAmber
class node_explorer_main,node_explorer_uart,node_explorer_ir,node_ultrasound,node_uart1 toneMint
class node_camera,node_image_processing,node_vehicle_control toneRose
class node_operator toneIndigo
```

## Components

### Zynq and FPGA

- [Cortex-A9 app](https://github.com/pngo250199/explorer_car_project/blob/main/Vitis/car_project/car_software_part/src/main.c): `Vitis/car_project/car_software_part/src/main.c`
- [Custom AXI IP](https://github.com/pngo250199/explorer_car_project/blob/main/Vivado/Car_project/ip_repo/customIP_1_0/drivers/customIP_v1_0/src/customIP.c): `Vivado/Car_project/ip_repo/customIP_1_0/drivers/customIP_v1_0/src/customIP.c`
- **FPGA switches**
- **FPGA LEDs**

### STM32 Firmware

- [STM32 application](https://github.com/pngo250199/explorer_car_project/blob/main/STM/workspace/AutonomouseCar/Core/Src/main.c): `STM/workspace/AutonomouseCar/Core/Src/main.c`
- [IR sensing](https://github.com/pngo250199/explorer_car_project/blob/main/STM/workspace/AutonomouseCar/Core/Src/Sensor_sources/ir.c): `STM/workspace/AutonomouseCar/Core/Src/Sensor_sources/ir.c`
- [Motor control](https://github.com/pngo250199/explorer_car_project/blob/main/STM/workspace/AutonomouseCar/Core/Src/Sensor_sources/motor.c): `STM/workspace/AutonomouseCar/Core/Src/Sensor_sources/motor.c`
- [Timer support](https://github.com/pngo250199/explorer_car_project/blob/main/STM/workspace/AutonomouseCar/Core/Src/Firmware_sources/SysTick.c): `STM/workspace/AutonomouseCar/Core/Src/Firmware_sources/SysTick.c`

### Explorer Firmware

- [Explorer app](https://github.com/pngo250199/explorer_car_project/blob/main/STM/workspace/Explorer_car/Sources/main.c): `STM/workspace/Explorer_car/Sources/main.c`
- [UART firmware](https://github.com/pngo250199/explorer_car_project/blob/main/STM/workspace/Explorer_car/Sources/Firmwares_sources/uart.c): `STM/workspace/Explorer_car/Sources/Firmwares_sources/uart.c`
- [IR sensing](https://github.com/pngo250199/explorer_car_project/blob/main/STM/workspace/Explorer_car/Sources/Sensors_sources/ir_sensor.c): `STM/workspace/Explorer_car/Sources/Sensors_sources/ir_sensor.c`
- [Ultrasonic sensing](https://github.com/pngo250199/explorer_car_project/blob/main/STM/workspace/Explorer_car/Sources/Sensors_sources/ultrasound_sensor.c): `STM/workspace/Explorer_car/Sources/Sensors_sources/ultrasound_sensor.c`
- [UART1 firmware](https://github.com/pngo250199/explorer_car_project/blob/main/STM/workspace/Explorer_car/Sources/Firmwares_sources/uart1.c): `STM/workspace/Explorer_car/Sources/Firmwares_sources/uart1.c`

### Planned Perception

- [Camera pipeline](https://github.com/pngo250199/explorer_car_project/tree/main/Vivado/Car_project): `Vivado/Car_project`
- [Image processing](https://github.com/pngo250199/explorer_car_project/tree/main/Vivado/Car_project): `Vivado/Car_project`
- [Vehicle control](https://github.com/pngo250199/explorer_car_project/tree/main/STM/workspace/AutonomouseCar/Core/Src): `STM/workspace/AutonomouseCar/Core/Src`

### Other components

- **Vehicle / operator**

## Connections

- Cortex-A9 app → Custom AXI IP: reads and writes
- FPGA switches → Custom AXI IP: input register
- Custom AXI IP → FPGA LEDs: drives outputs
- Vehicle / operator → FPGA switches: sets inputs
- Explorer app → UART firmware: uses UART (evidence: `STM/workspace/Explorer_car/Sources/main.c`)
- Explorer app → IR sensing: uses sensor (evidence: `STM/workspace/Explorer_car/Sources/main.c`)
- Explorer app → Ultrasonic sensing: uses sensor (evidence: `STM/workspace/Explorer_car/Sources/main.c`)
- STM32 application → IR sensing: coordinates sensing
- STM32 application → Motor control: commands motors
- STM32 application → Timer support: uses timing
- Camera pipeline → Image processing: supplies frames
- Image processing → Cortex-A9 app: returns results
- Cortex-A9 app → Vehicle control: coordinates control
- Vehicle control → STM32 application: communicates with
- Explorer app → UART1 firmware: may use UART1
