RPLidar C1 Terrain Mapping System v2.0

Real-time lidar terrain mapping with web visualization.

Quick Start

RPLidar C1 → Raspberry Pi → Companion Computer → Web Server → Browser

Installation

Raspberry Pi:

cd raspberry_pi/
sudo ./install.sh

Companion Computer:

cd companion_computer/
sudo ./install.sh

That's it! The install scripts handle everything automatically.

After Installation

# Start services
sudo systemctl start rplidar-streamer    # Raspberry Pi
sudo systemctl start rplidar-forwarder   # Companion Computer

# Check status
sudo systemctl status rplidar-streamer
sudo systemctl status rplidar-forwarder

# View logs
sudo journalctl -u rplidar-streamer -f
sudo journalctl -u rplidar-forwarder -f

Documentation

All documentation is in the docs/ folder:

• docs/SETUP_GUIDE.md - Complete installation and configuration guide
• docs/QUICK_REFERENCE.md - Commands, configuration, and troubleshooting
• docs/DEPLOYMENT_CONFIG.md - Current working configuration values
• docs/SYSTEM_SUMMARY.md - System overview and features

Package Contents

.
├── README.md                    # This file
├── rplidar_c1_library/          # Python library
│   └── rplidar_c1.py
├── raspberry_pi/                # Raspberry Pi components
│   ├── install.sh               # Automated installer
│   ├── rplidar_c1.py
│   ├── pointcloud_streamer.py
│   ├── rplidar-streamer.service
│   └── requirements.txt
├── companion_computer/          # Companion computer components
│   ├── install.sh               # Automated installer
│   ├── pointcloud_forwarder.py
│   ├── forwarder.env            # Pre-configured
│   ├── forwarder.env.example
│   ├── rplidar-forwarder.service
│   └── requirements.txt
└── docs/                        # Complete documentation
    ├── SETUP_GUIDE.md
    ├── QUICK_REFERENCE.md
    ├── DEPLOYMENT_CONFIG.md
    └── SYSTEM_SUMMARY.md

Key Features

• ✅ Automated installation - One command per machine
• ✅ Pre-configured - Real API keys and URLs included
• ✅ Complete 360° scans - Full coverage, not sparse dots
• ✅ 10 Hz data rate - Smooth real-time visualization
• ✅ Systemd services - Auto-start on boot
• ✅ Comprehensive docs - Everything you need

System Requirements

• Python 3.7+
• RPLidar C1 unit
• Raspberry Pi (any model with USB)
• Companion computer (Ubuntu/Linux)
• Network connectivity

Configuration

All configuration is pre-set with working values:

Raspberry Pi: 192.168.144.11 → sends to 192.168.144.15:5555
Companion Computer: 192.168.144.15 → forwards to web server
Web Server: https://3000-iba222u2jpd2ykg2e4k61-4b5573f1.manusvm.computer
API Key: sp10G8P9XCXUBidys1KJaoeCSxOFLUo5E1CDhc9L85M

See docs/DEPLOYMENT_CONFIG.md for complete configuration details.

Support

For detailed information, see the documentation in the docs/ folder.

License

MIT License

Version

2.0.0