robopi-config

A system configuration tool for RoboParty boards, forked from raspi-config and adapted for RK3588 / Orange Pi platforms.

robopi-config provides a terminal-based GUI (whiptail) for system setup, interface configuration, and hardware testing — without editing config files by hand.

Features

System Configuration

• WiFi & network management
• User password, hostname, boot target
• Auto login (console / desktop)
• CPU governor & frequency limits
• Read-only root filesystem (Overlay FS)
• SSH & sudo configuration
• Firmware update (apt update && apt upgrade)

Display

• HDMI / display connection status
• Screen blanking (screensaver timeout)
• Resolution information (DRM + X11/Wayland)

Interface Options

• Device tree overlay management (SPI, I2C, UART, CAN, PWM, etc.)
• SSH & VNC toggle

Advanced

• Predictable network interface names
• Network proxy (HTTP/HTTPS/FTP/RSYNC)
• Beta / release software repository
• X11 / Wayland backend switch
• Journald log storage location
• WLAN power save
• Link-local fallback

Hardware Test

• WiFi & Ethernet ping monitor (real-time)
• USB 2.0 / 3.0 device detection
• CAN bus interface check
• ADB debug port status
• Serial port list & loopback test
• RS485 send/receive test with GPIO direction control
• GPIO pin state viewer
• RoboPi Addon test menu for WS2812 effects and a SIG dual-output check
• Read-only head-motor communication test with selectable CAN interface and IDs
• Active daisy-chain test with selectable CAN interface and motor count
• BMS package, interface, service, and live read-only communication test

The read-only head-motor test sends manufacturer queries only and supports one to eight explicitly selected motor IDs. The active daisy-chain test assigns motor IDs consecutively from 1 to the selected count. It enables and zeroes the motors and sends MIT control frames, so motors may move immediately. Two safety confirmations are required, and configured motors are disabled when the test exits or is interrupted with Ctrl+C.

The BMS hardware test checks the configured serial/CAN interface, restarts bms.service, and observes its logs for ten seconds. It does not perform OTA, write configuration, or send battery-control commands.

The WS2812 entries require robopi-ws2812 from robopi_addon; the SIG dual-output test is included directly in robopi-config. Open Hardware Test -> RoboPi Addon, then select a WS2812 color/demo or SIG Dual Out. The SIG test waits for a GPIO1_D5 rising edge, latches GPIO1_B0 and GPIO0_C2 high. Pressing Ctrl+C once restores both outputs low and returns to the Addon test menu.

Electrical safety: GPIO1_D5 is not 5 V tolerant. The SIG input must be converted to the board's GPIO voltage before it reaches the RK3588S pin.

Localisation

• Locale (language & regional format)
• Timezone

Requirements

• Board: RK3588S RoboPi2 CM5 Tablet (or compatible Orange Pi / RoboParty boards)
• OS: Orange Pi 1.0.9 Jammy (Ubuntu 22.04 based) with Linux 6.1+ RT kernel
• Dependencies: whiptail, parted, psmisc, ethtool, usbutils, iw, wireless-tools, iproute2, can-utils
• Optional: gpiod, adb, nmtui (NetworkManager)

Quick Start

# Run as root
sudo robopi-config

# Or run with a specific function directly
sudo robopi-config do_wifi_ssid_passphrase

Navigate with ↑ ↓ arrow keys, Enter to select, Tab to switch buttons, Esc to go back.

Build & Install

# Build the .deb package
dpkg-buildpackage -us -uc -b

# Install on target board
sudo dpkg -i robopi-config_0.1.7-1_arm64.deb

Device Tree Overlays

robopi-config manages hardware module toggles via device tree overlays in /boot/dtb/rockchip/overlay/. Selected overlays are written to overlays= in /boot/orangepiEnv.txt and take effect after a reboot.

License

MIT License — based on raspi-config by Alex Bradbury.

Related

• raspi-config — upstream project
• orangepi-config — Orange Pi reference