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

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
• Optional: can-utils, 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.0_all.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