Welcome to Rose City Robotics Common Platform Documentation

Welcome to the comprehensive documentation for the RCR Common Robotics Platform! This documentation provides everything you need to build, operate, and maintain your robotics system.

🔗 GitHub Repository: https://github.com/RoseCityRobotics/common_platform - Source code, hardware designs, and issue tracking

Quick Start

Initial Setup

• Virtual Machine Setup - Set up Ubuntu VM on Windows/macOS for ROS2 development

• Host Configuration - Connect to your robot’s Raspberry Pi

• Network Configuration - Configure WiFi and network settings

• Software Setup - Install ROS2 and configure the development environment

• Flash Teensy Firmware - Program the robot’s microcontroller

Getting Started

• Quick Start
• Introduction
  • What is the Romi Chassis?
  • About Rose City Robotics’ Implementation
  • Getting Started
  • Project Components
  • How to Use This Documentation
  • Contact and Support
  • Conclusion
• Raspberry Pi Connection Guide
  • Direct Connection (Initial Setup)
  • SSH Connection (Development)
• Host and Network Setup
  • Pull the Latest Changes from GitHub
  • Host Settings
  • Network Configuration
  • SSH Connection
  • Robot Namespacing Setup
• Pull the Latest Changes from GitHub
• Flashing the Teensy Microcontroller
  • Overview
  • Flashing Procedure
• Keyboard Teleoperation
  • Prerequisites
  • Power and Log on to Raspberry Pi
  • Setup a terminal with miniterm to monitor Teensy debug output
  • Start the micro-ROS Agent
  • Start the Keyboard Monitor Node
  • Keyboard Commands 🎮
• LiDAR Operations
  • Launch ROS Node
  • LiDAR Data Analysis
  • Troubleshooting
  • Hardware Connection
  • Calibration
  • LiDAR Specifications
  • Performance Optimization
• SLAM Operations
  • Prerequisites
  • Topics
• Camera Operations
  • Overview
  • Camera Specifications
  • Prerequisites
  • Camera Setup
  • Camera Applications
  • Recording Image Files
  • Recording Video Files
  • Camera Calibration
  • Camera Data Analysis
  • Troubleshooting
  • Maintenance
  • Performance Optimization
• Image Classification Data Annotation
  • Recording Images
  • Image Directory Structure
  • Label Studio
  • Roboflow
• Using a Bluetooth Gamepad
  • 🧐 Prerequisites & Setup
  • 🛠️ Creating the Teleop Package
  • ⚙️ Configuration Files
  • 🚀 Building and Running
  • 📚 Resources
• Hardware Assembly Guide
  • Solder Your PARTS CRP Board
  • Solder Accessories
  • Assemble the Pololu Romi Chassis
  • Starting with the Basic Test
• 3D Printed Parts
  • Coming Soon

Robot Operations

• ROS Discovery Server
• Startup Procedure
• Shutdown Procedure
• Reboot Procedure
• Emergency Shutdown
• Routine Maintenance

Advanced Operations

• Advanced Operations
• Performance Tuning Guide
• Custom Controllers

ROS2 Desktop Tools

• Virtual Machine Setup
• RViz Sensor Visualization

Object Detection (YOLO)

• Running the Object Detection Node
• YOLOv11n Fine-Tuning Workflow (Ultralytics on macOS)
• YOLOv11n to Hailo-8 HEF Compilation Guide

Testing and Validation

• Testing and Validation
• Contributing to the Common Platform

Getting Help

If you need assistance or have questions:

1. Check the Operations Manual for step-by-step guides

2. Review the troubleshooting sections

3. Visit our GitHub repository for source code and issue tracking

4. Contact the RCR team for additional support

---

Last updated: October 2025 Version: 1.0