# shynaac/nx26 architecture

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

- Interactive diagram: https://gitdiagram.com/shynaac/nx26
- Repository: https://github.com/shynaac/nx26

## Overview

This repository is a ROS 2 stack and challenge starter for the NXP B3RB autonomous medical-response buggy, with Gazebo support and CogniPilot/Cranium communication components. The intended user-to-result workflow is to perceive lane markings and signs, find and identify patients, obtain hospital assignments, navigate and deliver patients, then exit and park. The README documents this mission and the starter perception package; sampled source also shows planning and transport internals. Several challenge stages are documented capabilities rather than inspected implementations, so their connections are cited to the README.

Main entry points: [`src/b3rb_ros_line_follower/b3rb_ros_line_follower`](https://github.com/shynaac/nx26/tree/main/src/b3rb_ros_line_follower/b3rb_ros_line_follower) (Mission decisions), [`src/synapse_gz/src/clients/tcp_client.cpp`](https://github.com/shynaac/nx26/blob/main/src/synapse_gz/src/clients/tcp_client.cpp) (TCP client), [`src/synapse_ros/src/synapse_ros.cpp`](https://github.com/shynaac/nx26/blob/main/src/synapse_ros/src/synapse_ros.cpp) (Synapse ROS node), [`src/synapse_gz/src/clients/gz_client.cpp`](https://github.com/shynaac/nx26/blob/main/src/synapse_gz/src/clients/gz_client.cpp) (Gazebo client)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_mission["Mission workflow"]
  node_lane["Lane following"]
  node_edge["Edge vectors"]
  node_signs["Sign recognition"]
  node_qr["QR detection"]
  node_mission_logic["Mission decisions"]
end

subgraph group_robot["Robot navigation"]
  node_nav["Nav2 navigation<br/>[nav2.launch.py]"]
  node_localization["Localization and SLAM"]
  node_planner["Rover planning<br/>[rover_planning.py]"]
  node_control["Rover control<br/>[rover_control.py]"]
  node_planner_node["Planner node<br/>[rover_planner.cpp]"]
  node_bezier["Bezier trajectory<br/>[bezier6.h]"]
  node_description["Robot description"]
end

subgraph group_bridge["ROS and simulation bridge"]
  node_sim["Gazebo simulation<br/>[sil.launch.py]"]
  node_gz_client["Gazebo client<br/>[gz_client.cpp]"]
  node_tcp_client["TCP client<br/>[tcp_client.cpp]"]
  node_ros_bridge["Synapse ROS node<br/>[synapse_ros.cpp]"]
  node_udp_link["UDP link<br/>[udp_link.cpp]"]
end

subgraph group_protocol["Synapse protocol"]
  node_frame["TinyFrame transport<br/>[TinyFrame.c]"]
  node_topics["Synapse topics<br/>[SynapseTopics.h]"]
  node_proto["Protobuf messages"]
end

node_participant(("Challenge participant"))
node_buggy["B3RB buggy"]
node_camera["Camera and sensors"]
node_municipality["Municipality server"]

node_participant -->|"extends starter"| node_lane
node_camera -.->|"provides imagery"| node_lane
node_lane -.->|"uses vectors"| node_edge
node_participant -->|"implements recognition"| node_signs
node_participant -->|"implements scanning"| node_qr
node_signs -->|"guides turns"| node_mission_logic
node_qr -->|"identifies patient"| node_mission_logic
node_mission_logic -->|"requests assignment"| node_municipality
node_municipality -->|"returns hospital"| node_mission_logic
node_mission_logic -.->|"sets destination"| node_nav
node_nav -.->|"controls travel"| node_buggy
node_camera -->|"provides sensor data"| node_localization
node_planner -->|"uses Lie operations"| node_control
node_planner_node -->|"uses trajectory code"| node_bezier
node_description -.->|"configures robot"| node_nav
node_sim -.->|"runs simulation bridge"| node_gz_client
node_gz_client -->|"shares frames"| node_tcp_client
node_tcp_client -->|"parses frames"| node_frame
node_tcp_client -->|"dispatches topics"| node_topics
node_tcp_client -->|"publishes actuators"| node_gz_client
node_ros_bridge -->|"creates link"| node_udp_link
node_udp_link -->|"accepts frames"| node_frame
node_udp_link -->|"publishes messages"| node_ros_bridge
node_ros_bridge -->|"serializes messages"| node_proto
node_gz_client -.->|"serializes sensor data"| node_proto
node_ros_bridge -->|"uses topic IDs"| node_topics

click node_lane "https://github.com/shynaac/nx26/blob/main/src/b3rb_ros_line_follower/b3rb_ros_line_follower/b3rb_ros_line_follower/b3rb_ros_line_follower.py"
click node_edge "https://github.com/shynaac/nx26/blob/main/src/b3rb_ros_line_follower/b3rb_ros_line_follower/b3rb_ros_line_follower/b3rb_ros_edge_vectors.py"
click node_signs "https://github.com/shynaac/nx26/blob/main/src/b3rb_ros_line_follower/b3rb_ros_line_follower/b3rb_ros_line_follower/b3rb_ros_object_recog.py"
click node_qr "https://github.com/shynaac/nx26/blob/main/src/b3rb_ros_line_follower/b3rb_ros_line_follower/b3rb_ros_line_follower/b3rb_ros_qr_detector.py"
click node_mission_logic "https://github.com/shynaac/nx26/tree/main/src/b3rb_ros_line_follower/b3rb_ros_line_follower"
click node_nav "https://github.com/shynaac/nx26/blob/main/src/b3rb/b3rb_nav2/launch/nav2.launch.py"
click node_localization "https://github.com/shynaac/nx26/blob/main/src/b3rb/b3rb_nav2/launch/localization.launch.py"
click node_planner "https://github.com/shynaac/nx26/blob/main/src/corti/corti/rover_planning.py"
click node_control "https://github.com/shynaac/nx26/blob/main/src/corti/corti/rover_control.py"
click node_planner_node "https://github.com/shynaac/nx26/blob/main/src/corti/src/rover_planner.cpp"
click node_bezier "https://github.com/shynaac/nx26/blob/main/src/corti/src/casadi/bezier6.h"
click node_description "https://github.com/shynaac/nx26/blob/main/src/b3rb/b3rb_description/launch/robot_description.launch.py"
click node_sim "https://github.com/shynaac/nx26/blob/main/src/b3rb_simulator/b3rb_gz_bringup/launch/sil.launch.py"
click node_gz_client "https://github.com/shynaac/nx26/blob/main/src/synapse_gz/src/clients/gz_client.cpp"
click node_tcp_client "https://github.com/shynaac/nx26/blob/main/src/synapse_gz/src/clients/tcp_client.cpp"
click node_ros_bridge "https://github.com/shynaac/nx26/blob/main/src/synapse_ros/src/synapse_ros.cpp"
click node_udp_link "https://github.com/shynaac/nx26/blob/main/src/synapse_ros/src/proto/udp_link.cpp"
click node_frame "https://github.com/shynaac/nx26/blob/main/src/synapse_tinyframe/src/TinyFrame.c"
click node_topics "https://github.com/shynaac/nx26/blob/main/src/synapse_tinyframe/include/synapse_tinyframe/SynapseTopics.h"
click node_proto "https://github.com/shynaac/nx26/tree/main/src/synapse_protobuf/proto"

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_lane,node_edge,node_signs,node_qr,node_mission_logic toneBlue
class node_nav,node_localization,node_planner,node_control,node_planner_node,node_bezier,node_description toneAmber
class node_sim,node_gz_client,node_tcp_client,node_ros_bridge,node_udp_link,node_municipality toneMint
class node_frame,node_topics,node_proto toneRose
class node_participant,node_buggy,node_camera toneIndigo
```

## Components

### Mission workflow

- [Lane following](https://github.com/shynaac/nx26/blob/main/src/b3rb_ros_line_follower/b3rb_ros_line_follower/b3rb_ros_line_follower/b3rb_ros_line_follower.py): `src/b3rb_ros_line_follower/b3rb_ros_line_follower/b3rb_ros_line_follower/b3rb_ros_line_follower.py`
- [Edge vectors](https://github.com/shynaac/nx26/blob/main/src/b3rb_ros_line_follower/b3rb_ros_line_follower/b3rb_ros_line_follower/b3rb_ros_edge_vectors.py): `src/b3rb_ros_line_follower/b3rb_ros_line_follower/b3rb_ros_line_follower/b3rb_ros_edge_vectors.py`
- [Sign recognition](https://github.com/shynaac/nx26/blob/main/src/b3rb_ros_line_follower/b3rb_ros_line_follower/b3rb_ros_line_follower/b3rb_ros_object_recog.py): `src/b3rb_ros_line_follower/b3rb_ros_line_follower/b3rb_ros_line_follower/b3rb_ros_object_recog.py`
- [QR detection](https://github.com/shynaac/nx26/blob/main/src/b3rb_ros_line_follower/b3rb_ros_line_follower/b3rb_ros_line_follower/b3rb_ros_qr_detector.py): `src/b3rb_ros_line_follower/b3rb_ros_line_follower/b3rb_ros_line_follower/b3rb_ros_qr_detector.py`
- [Mission decisions](https://github.com/shynaac/nx26/tree/main/src/b3rb_ros_line_follower/b3rb_ros_line_follower): `src/b3rb_ros_line_follower/b3rb_ros_line_follower`

### Robot navigation

- [Nav2 navigation](https://github.com/shynaac/nx26/blob/main/src/b3rb/b3rb_nav2/launch/nav2.launch.py): `src/b3rb/b3rb_nav2/launch/nav2.launch.py`
- [Localization and SLAM](https://github.com/shynaac/nx26/blob/main/src/b3rb/b3rb_nav2/launch/localization.launch.py): `src/b3rb/b3rb_nav2/launch/localization.launch.py`
- [Rover planning](https://github.com/shynaac/nx26/blob/main/src/corti/corti/rover_planning.py): `src/corti/corti/rover_planning.py`
- [Rover control](https://github.com/shynaac/nx26/blob/main/src/corti/corti/rover_control.py): `src/corti/corti/rover_control.py`
- [Planner node](https://github.com/shynaac/nx26/blob/main/src/corti/src/rover_planner.cpp): `src/corti/src/rover_planner.cpp`
- [Bezier trajectory](https://github.com/shynaac/nx26/blob/main/src/corti/src/casadi/bezier6.h): `src/corti/src/casadi/bezier6.h`
- [Robot description](https://github.com/shynaac/nx26/blob/main/src/b3rb/b3rb_description/launch/robot_description.launch.py): `src/b3rb/b3rb_description/launch/robot_description.launch.py`

### ROS and simulation bridge

- [Gazebo simulation](https://github.com/shynaac/nx26/blob/main/src/b3rb_simulator/b3rb_gz_bringup/launch/sil.launch.py): `src/b3rb_simulator/b3rb_gz_bringup/launch/sil.launch.py`
- [Gazebo client](https://github.com/shynaac/nx26/blob/main/src/synapse_gz/src/clients/gz_client.cpp): `src/synapse_gz/src/clients/gz_client.cpp`
- [TCP client](https://github.com/shynaac/nx26/blob/main/src/synapse_gz/src/clients/tcp_client.cpp): `src/synapse_gz/src/clients/tcp_client.cpp`
- [Synapse ROS node](https://github.com/shynaac/nx26/blob/main/src/synapse_ros/src/synapse_ros.cpp): `src/synapse_ros/src/synapse_ros.cpp`
- [UDP link](https://github.com/shynaac/nx26/blob/main/src/synapse_ros/src/proto/udp_link.cpp): `src/synapse_ros/src/proto/udp_link.cpp`

### Synapse protocol

- [TinyFrame transport](https://github.com/shynaac/nx26/blob/main/src/synapse_tinyframe/src/TinyFrame.c): `src/synapse_tinyframe/src/TinyFrame.c`
- [Synapse topics](https://github.com/shynaac/nx26/blob/main/src/synapse_tinyframe/include/synapse_tinyframe/SynapseTopics.h): `src/synapse_tinyframe/include/synapse_tinyframe/SynapseTopics.h`
- [Protobuf messages](https://github.com/shynaac/nx26/tree/main/src/synapse_protobuf/proto): `src/synapse_protobuf/proto`

### Other components

- **Challenge participant**
- **B3RB buggy**
- **Camera and sensors**
- **Municipality server**

## Connections

- Challenge participant → Lane following: extends starter
- Camera and sensors → Lane following: provides imagery
- Lane following → Edge vectors: uses vectors
- Challenge participant → Sign recognition: implements recognition
- Challenge participant → QR detection: implements scanning
- Sign recognition → Mission decisions: guides turns
- QR detection → Mission decisions: identifies patient
- Mission decisions → Municipality server: requests assignment
- Municipality server → Mission decisions: returns hospital
- Mission decisions → Nav2 navigation: sets destination
- Nav2 navigation → B3RB buggy: controls travel
- Camera and sensors → Localization and SLAM: provides sensor data
- Rover planning → Rover control: uses Lie operations (evidence: `src/corti/corti/rover_planning.py`)
- Planner node → Bezier trajectory: uses trajectory code (evidence: `src/corti/src/rover_planner.cpp`)
- Robot description → Nav2 navigation: configures robot
- Gazebo simulation → Gazebo client: runs simulation bridge
- Gazebo client → TCP client: shares frames (evidence: `src/synapse_gz/src/clients/tcp_client.cpp`)
- TCP client → TinyFrame transport: parses frames (evidence: `src/synapse_gz/src/clients/tcp_client.cpp`)
- TCP client → Synapse topics: dispatches topics (evidence: `src/synapse_gz/src/clients/tcp_client.cpp`)
- TCP client → Gazebo client: publishes actuators (evidence: `src/synapse_gz/src/clients/tcp_client.cpp`)
- Synapse ROS node → UDP link: creates link (evidence: `src/synapse_ros/src/synapse_ros.cpp`)
- UDP link → TinyFrame transport: accepts frames (evidence: `src/synapse_ros/src/proto/udp_link.cpp`)
- UDP link → Synapse ROS node: publishes messages (evidence: `src/synapse_ros/src/proto/udp_link.cpp`)
- Synapse ROS node → Protobuf messages: serializes messages (evidence: `src/synapse_ros/src/synapse_ros.cpp`)
- Gazebo client → Protobuf messages: serializes sensor data
- Synapse ROS node → Synapse topics: uses topic IDs
