Repository navigation
Home
The Singularity Camper Control System (SCCS) Wiki
Install and configuration guide for the Singularity Camper Control System (SCCS).
For features and screenshots see the README.
Follow these steps to end up with an operational system. Make sure you have everything from the shopping list before starting.
- Wiring and Hardware — Shopping list and wiring connections
- Software Installation — imaging the SD card and installing the SCCS
- Software Configuration — Customise the UI for your setup
- Victron Setup — pair SmartShunt / MPPT
| Topic | Page |
|---|---|
| Networking Documentation and Information | Networking |
| Apple Home app / Siri (optional) | HomeKit |
| Google Home / Gemini (optional) | Google Home |
| UniFi controller (if you have UniFi access points in your installation) | UniFi OS Server |
Terms used throughout this wiki and in sccs.conf.
| Term | Meaning |
|---|---|
| SCCS | Singularity Camper Control System — the software and hardware in this project. |
| SCCS Core | The circuit board that carries the Raspberry Pi, GPS, ESP32 dimmers, relays, reed inputs, and field screw terminals. |
| Reed / reed switch | A magnetic door or panel sensor wired to the Core. Open means that door/panel is open; closed means shut. |
| Reed-linked light | A light that turns on/off or changes brightness when its linked reed opens or closes (and to the level set for the current phase). |
| Phase | Time-of-day lighting mode: Day, Evening, or Night. Day/Evening track sunrise/sunset (with minute offsets); Night is a fixed clock time. Editable in the settings tab. |
| Ambient light | Exterior/site lighting (e.g. under-camper accent strips, awning lights) that comes on while any reed is open and the phase allows it, and fades out when everything is closed. |
| Accent light | Under-body lights used as soft ground wash; typically configured as ambient lights. |
| Scene | A one-touch lighting preset (e.g. Bedtime, All Off) that sets several lights at once, then reverts back to normal reed/phase behaviour. |
| Manual override | Brightness or on/off set with a slider or button in the UI. It persists until the linked reed or the phase changes (relays keep their setting until you change them again). |
| Interlock | A reed that only counts as open if another reed is open too (e.g. an inner door that only matters when the outer door is open). |
| Ramp | Smooth fade between brightness levels instead of snapping. Ramp times are set under [lighting]. |
| PWM light | A single-channel dimmable light. |
| RGB bug / anti-bug mode | A dual-channel light with white and red outputs so you can switch to red at night to reduce insect attraction. |
| Relay | On/off channel for non-dimmable loads (water pump, lighting circuit, fridge, floodlights). Controlled manually only. |
| ESP32 | Microcontrollers on the Core that handle multi-channel PWM dimming (and the water-tank level read). |
| WS281X | Addressable LED strips where each LED can have a separate colour. These are separate from the PWM dimmer channels and do not support white very well so not suitable for task lighting, mainly effect lighting. |
| 1-Wire | Bus used for DS18B20 temperature sensors (ambient, fridge and freezer). |
| Toast | Short coloured popup notification at the bottom of the UI (success, info, warning, error). |
| Explain | System-tab tool that shows why a light or relay is at its current level (override, reed, scene, safety, etc.). |
| Safety clamp | Hard rule that forces a light off for safety (e.g. rooftop tent light held at 0% while the tent reed is closed so the strip is not pressed into bedding). |
| HomeKit | Optional Apple Home / Siri bridge on the LAN/Wi-Fi. Off by default; enable under [homekit]. Phone must be on LAN/Wi-Fi. Remote Siri needs a HomePod or Apple TV on the LAN/Wi-Fi. |
| Google Home / Matter | Optional Google Home / Gemini bridge on the LAN/Wi-Fi. Off by default; enable under [matter]. Needs IPv6 link-local on the LAN/Wi-Fi. Remote Gemini needs a Nest Hub / Nest Mini. Runs beside HomeKit. |
| Victron SmartShunt | Battery monitor that provides battery information to the SCCS (state of charge, voltage, current). |
| MPPT / SmartSolar | Victron solar charge controller; SCCS reads generation data the same way as the shunt. |
| Instant Readout | Victron’s broadcast of live values so the Raspberry Pi can display the information on the UI. |
| LAN/Wi-Fi | The SCCS’s internal network (wired Ethernet from the Raspberry Pi, plus Wi-Fi via WAPs): screens, Sonos, etc. live here. |
| WAN | Upstream internet path (Wi-Fi/USB hotspot, Starlink, 5G modem etc.) that the Raspberry Pi provides internet from to the LAN/Wi-Fi. |
| WAP | Wireless access point — Provides Wi-Fi for phones, laptops etc. to join. |
| Pi-hole | Provides DNS, DHCP and ad-filtering for the LAN/Wi-Fi. |
| Samba share | Network file share of the project directory so you can edit sccs.conf from another computer. |