How shynaac/nx26 works
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: b3rb_ros_line_follower Mission decisions · tcp_client.cpp TCP client · synapse_ros.cpp Synapse ROS node · gz_client.cpp Gazebo client
Components 24
Mission workflow
- Lane following
src/b3rb_ros_line_follower/b3rb_ros_line_follower/b3rb_ros_line_follower/b3rb_ros_line_follower.py - Edge vectors
src/b3rb_ros_line_follower/b3rb_ros_line_follower/b3rb_ros_line_follower/b3rb_ros_edge_vectors.py - Sign recognition
src/b3rb_ros_line_follower/b3rb_ros_line_follower/b3rb_ros_line_follower/b3rb_ros_object_recog.py - QR detection
src/b3rb_ros_line_follower/b3rb_ros_line_follower/b3rb_ros_line_follower/b3rb_ros_qr_detector.py - Mission decisions
src/b3rb_ros_line_follower/b3rb_ros_line_follower
Robot navigation
- Nav2 navigation
src/b3rb/b3rb_nav2/launch/nav2.launch.py - Localization and SLAM
src/b3rb/b3rb_nav2/launch/localization.launch.py - Rover planning
src/corti/corti/rover_planning.py - Rover control
src/corti/corti/rover_control.py - Planner node
src/corti/src/rover_planner.cpp - Bezier trajectory
src/corti/src/casadi/bezier6.h - Robot description
src/b3rb/b3rb_description/launch/robot_description.launch.py
ROS and simulation bridge
- Gazebo simulation
src/b3rb_simulator/b3rb_gz_bringup/launch/sil.launch.py - Gazebo client
src/synapse_gz/src/clients/gz_client.cpp - TCP client
src/synapse_gz/src/clients/tcp_client.cpp - Synapse ROS node
src/synapse_ros/src/synapse_ros.cpp - UDP link
src/synapse_ros/src/proto/udp_link.cpp
Synapse protocol
- TinyFrame transport
src/synapse_tinyframe/src/TinyFrame.c - Synapse topics
src/synapse_tinyframe/include/synapse_tinyframe/SynapseTopics.h - Protobuf messages
src/synapse_protobuf/proto
Other components
- Challenge participant
- B3RB buggy
- Camera and sensors
- Municipality server
Connections 26
- 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
src/corti/corti/rover_planning.py - Planner node → Bezier trajectory: uses trajectory code
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
src/synapse_gz/src/clients/tcp_client.cpp - TCP client → TinyFrame transport: parses frames
src/synapse_gz/src/clients/tcp_client.cpp - TCP client → Synapse topics: dispatches topics
src/synapse_gz/src/clients/tcp_client.cpp - TCP client → Gazebo client: publishes actuators
src/synapse_gz/src/clients/tcp_client.cpp - Synapse ROS node → UDP link: creates link
src/synapse_ros/src/synapse_ros.cpp - UDP link → TinyFrame transport: accepts frames
src/synapse_ros/src/proto/udp_link.cpp - UDP link → Synapse ROS node: publishes messages
src/synapse_ros/src/proto/udp_link.cpp - Synapse ROS node → Protobuf messages: serializes messages
src/synapse_ros/src/synapse_ros.cpp - Gazebo client → Protobuf messages: serializes sensor data
- Synapse ROS node → Synapse topics: uses topic IDs