Getting Started with C Pro Camera Server

# Connect hardware components
1. Connect camera(s) to camera ports
2. Connect Ethernet cable
3. Connect power supply
4. Wait 30-60 seconds for boot

# Using mDNS (Linux/Mac)
avahi-browse -rt _http._tcp

# Or scan your network
nmap -sn 192.168.1.0/24

# Or check DHCP leases on your router

# Open browser and navigate to:
http://rotoclear-XXXXXX.local
# or
http://<device-ip-address>

# Default credentials:
Username: admin
Password: admin  # Change immediately!

# Install system dependencies
sudo apt update
sudo apt install -y \
  build-essential \
  git \
  pkg-config \
  sqlite3 \
  libleveldb-dev \
  gstreamer1.0-tools \
  gstreamer1.0-plugins-base \
  gstreamer1.0-plugins-good \
  gstreamer1.0-plugins-bad \
  gstreamer1.0-plugins-ugly \
  libgstreamer1.0-dev \
  libgstreamer-plugins-base1.0-dev

# Install Nim compiler
curl https://nim-lang.org/choosenim/init.sh -sSf | sh
export PATH=$HOME/.nimble/bin:$PATH
choosenim stable

nim --version      # Should show Nim 1.6+
gst-inspect-1.0    # Should list GStreamer plugins

git clone https://github.com/cortona-rotoclear/rotordream.git
cd rotordream

# Install required Nim packages
nimble install -y corun

# Check tools directory exists
ls tools/

# Build for development (with debug symbols)
nim c -d:debug rotordream.nim

# Or use the build tool
nim c -r tools/buildRelease.nim --target:local

# Run with default settings
./rotordream

# Or with custom configuration
./rotordream --config=config.json

GStreamer initialized
Camera client started
State system initialized
HTTP server listening on :80
HTTPS server listening on :443
RTSP server listening on :554

# Open browser
http://localhost:80

# Default development credentials:
Username: admin
Password: admin

rsc_config/
├── config_DEFAULT/      # Development
├── config_DEMO/         # Demo mode
├── config_DEV/          # Factory testing
├── config_EDU/          # Education variant
├── config_rc_DMG/       # Production
└── config_VB/           # OEM variant

# Build with specific variant
nim c -d:variant_EDU rotordream.nim

# Check status
systemctl status rotordream

# Start service
sudo systemctl start rotordream

# Stop service
sudo systemctl stop rotordream

# Restart service
sudo systemctl restart rotordream

# Enable auto-start on boot
sudo systemctl enable rotordream

# Start in foreground
./rotordream

# Stop with Ctrl+C

# Run in background
./rotordream &

# Stop background process
killall rotordream

# System info
curl http://localhost/api/info

# System status
curl http://localhost/api/status

# Camera status
curl http://localhost/api/camera/status

# Embedded system
journalctl -u rotordream -f

# Development
tail -f /var/log/rotordream.log

# List V4L2 devices
v4l2-ctl --list-devices

# Get camera capabilities
v4l2-ctl -d /dev/video0 --all

# Test camera capture
gst-launch-1.0 v4l2src device=/dev/video0 ! videoconvert ! autovideosink

# Test encoding
gst-launch-1.0 v4l2src device=/dev/video0 ! videoconvert ! x264enc ! filesink location=test.h264

# Using VLC
vlc rtsp://localhost:554/stream1

# Using FFmpeg
ffplay rtsp://localhost:554/stream1

# Using GStreamer
gst-launch-1.0 playbin uri=rtsp://localhost:554/stream1

# Using websocat (install: cargo install websocat)
websocat ws://localhost/api/v1

# Send state update
{"light0": true}

# Start recording
curl -X POST http://localhost/api/recording/start

# Stop recording
curl -X POST http://localhost/api/recording/stop

# List recordings
curl http://localhost/api/recordings

// Connect to WebSocket
const ws = new WebSocket('ws://localhost/api/v1');

// Start recording
ws.send(JSON.stringify({
  "record": true
}));

// Stop recording
ws.send(JSON.stringify({
  "record": false
}));

curl -X POST http://localhost/api/users \
  -u admin:admin \
  -H "Content-Type: application/json" \
  -d '{
    "username": "doctor1",
    "password": "secure_password",
    "email": "doctor1@hospital.com",
    "role": "operator"
  }'

# Edit network configuration
sudo nano /etc/network/interfaces

# Example static configuration:
auto eth0
iface eth0 inet static
  address 192.168.1.100
  netmask 255.255.255.0
  gateway 192.168.1.1
  dns-nameservers 8.8.8.8

# Apply changes
sudo systemctl restart networking

# Check USB devices
lsusb

# Check V4L2 devices
ls -l /dev/video*

# Check permissions
sudo usermod -aG video $USER

# Reboot if needed
sudo reboot

# Check if service is running
systemctl status rotordream

# Check port availability
sudo netstat -tlnp | grep :80

# Check firewall
sudo ufw status
sudo ufw allow 80/tcp

# Check GStreamer plugins
gst-inspect-1.0 | grep v4l2

# Test camera directly
gst-launch-1.0 v4l2src ! autovideosink

# Check system logs
journalctl -u rotordream -n 100

# Build EDU variant
nim c -d:variant_EDU rotordream.nim

# Configure dual cameras
# - Scope camera (main view)
# - Overview camera (PIP)

# Enable features:
# - Picture-in-Picture
# - Real-time tagging
# - Multi-user annotation

# Build rc_DMG variant
nim c -d:variant_rc_DMG rotordream.nim

# Configure for continuous operation
# - Enable auto-recording on motion
# - Set retention policy (30 days)
# - Configure network storage (SMB/NFS)
# - Enable ONVIF for NVR integration

# Build DEFAULT variant
nim c rotordream.nim

# Configure for flexibility
# - Enable all recording modes
# - Configure detailed metadata
# - Enable tag categories
# - Export recordings with metadata