3DR Solo Web Utility Owner's Manual
The definitive guide for installing, configuring, updating, and operating the on-board web management application for the 3DR Solo drone.
1. System Architecture & Overview
The 3DR Solo Web Utility is an open-source, on-board management server and flight deck application designed specifically for the 3DR Solo drone running Open Solo. Rather than relying on cloud servers or legacy mobile applications, the Web Utility operates natively on the Solo's internal companion computer.
The server runs directly inside the Solo's i.MX6 Linux operating system on port
80, making it instantly accessible from any web browser on any smartphone, tablet, or PC connected to the SoloLink Wi-Fi network.
Network Topology
- Copter Companion Computer:
10.1.1.10(Web Server & Telemetry Host) - Artoo Controller:
10.1.1.1(Internal SSH Gateway & NAT Router) - Pixhawk Autopilot: Connected via internal MAVLink UART bridge (`/dev/ttymxc1` at 57600 baud)
2. One-Click Installation & Setup
Deploying the Web Utility onto your Solo requires a single execution of deploy_to_solo.exe from any Windows computer connected to the Solo's Wi-Fi network.
Step-by-Step Installation Procedure:
- Power on your 3DR Solo Copter and Artoo Controller.
- Connect your Windows PC to the Solo's Wi-Fi access point (e.g.
SoloLink_XXXXXX). - Launch
deploy_to_solo.exe. - The installer automatically detects the Copter at
10.1.1.10over SSH, creates the installation directory at/log/SoloWebUtility(utilizing the 6.5 GB partition), and copies all application files. - The installer configures
/etc/rc.localfor automatic startup on every power cycle and launches the live web server immediately.
# Verification via SSH:
ssh root@10.1.1.10 (Password: TjSDBkAu)
ps | grep solo_web_app.py
# Output: root 1245 python /log/SoloWebUtility/solo_web_app.py --port 80
3. Automated Firmware Update Engine
The Web Utility includes an integrated custom ArduPilot compilation engine capable of fetching, building, and flashing the latest ArduCopter stable releases for both Stock Black Cubes and Green Cubes.
โฌ Stock Solo Cube (Black)
Compiles and flashes arducoptercubesolo-latest.apj tailored specifically for the original Stock Black Cube autopilot hardware.
๐ฉ Green Cube
Compiles and flashes arducoptercubegreen-solo-latest.apj optimized for the upgraded Green Cube hardware.
Flashing Options:
- Full Install: Flashes the Pixhawk Cube autopilot AND stages the full Open Solo Linux operating system images (`3dr-solo.tar.gz` and `3dr-controller.tar.gz`).
- Cube Only: Flashes only the Pixhawk Cube APJ binary while preserving current Linux OS partitions.
Full OS installations trigger a sequential reboot of the Copter and Controller. The web UI displays an active countdown timer that survives page refreshes until the system fully settles.
4. Wi-Fi & Internet NAT Router
The Web Utility features a built-in Wi-Fi manager that connects your Artoo Controller to your home 2.4 GHz Wi-Fi network while maintaining the active SoloLink access point connection.
Bi-Directional IP Forwarding:
When connected to home Wi-Fi, the Controller enables kernel IP forwarding and iptables NAT masquerading. This allows your laptop or tablet on your home network to access the Solo (`10.1.1.10`) directly without disconnecting from home internet.
Home Wi-Fi credentials are saved strictly in RAM at
/tmp/wpa_client.conf. Credential files and non-default routes are automatically cleared upon reboot to guarantee default SoloLink AP recovery.
5. Telemetry & Cockpit HUD Flight Screen
The Cockpit HUD tab renders an interactive Primary Flight Display (PFD) receiving real-time MAVLink telemetry streams over MAVLink UDP port 14560.
Live Flight Displays:
- Attitude Artificial Horizon: Live pitch and roll synthetic horizon indicator.
- Speed & Altitude Tapes: Real-time Airspeed, Groundspeed, Altitude (MSL/AGL), and Compass Heading.
- System Gauges: Battery Voltage, Current Draw, Battery Remaining %, GPS Satellites & HDOP, Flight Mode, and Armed/Disarmed Safety Status.
- Live Video Stream: Integrated video canvas supporting seamless video handoff between mobile apps (Solex / Tower) and the web server.
6. Sensor Calibration Wizard
The Web Utility provides a step-by-step post-flash sensor calibration pipeline to ensure your Solo is fully calibrated and flight-ready.
Calibration Sequence:
- 6-Axis Accelerometer & IMU Calibration: Samples level, left, right, nose-down, nose-up, and back positions.
- Autopilot Reboot: Automatically sends
MAV_CMD_PREFLIGHT_REBOOT_SHUTDOWNto commit IMU offsets to persistent EKF storage. - Compass Calibration ("The Solo Dance"): Dual-magnetometer calibration with live 3-axis rotation cards and real-time fitness scores.
7. ArduPilot Parameters & Calibrated Presets
Manage, search, edit, and save over 1,000 ArduPilot flight parameters with instant MAVLink ACK verification.
One-Click Hardware Presets:
- Here GPS / uBlox M8N: Sets `GPS_TYPE=1`, `GPS_GNSS_MODE=65`, and `GPS_RATE_MS=200` for high-accuracy satellite tracking.
- Landing Gear Retracts: Configures auxiliary servo channels for automatic gear retraction.
- Speed Modes: Standard, Sport, and Cinematic flight tuning.
- Battery Chemistry: Calibrated voltage curves for standard 4S LiPo and custom 4S Li-ion high-capacity packs.
8. Artoo Controller Button Customization
The Controller Setup tab presents an interactive SVG diagram of the 3DR Artoo Controller for customizing physical hardware button mappings.
Supported Buttons:
Configure Short Hold and Long Hold actions for: A Button, B Button, Preset 1, Preset 2, and Camera Button. Mappings are written directly to /usr/bin/extSettings.conf on the Solo.
9. Sololink Viewer Android APK
For mobile pilots who prefer a dedicated Android app for FPV video and On-Screen Display (OSD), the Sololink Viewer APK is available for direct installation.
Installation Instructions:
- Download
sololink_viewer.apkdirectly onto your Android device. - Enable "Install from Unknown Sources" in Android Security settings.
- Open the APK file to install the application.
- Connect your Android device to the SoloLink Wi-Fi network and launch Sololink Viewer for low-latency RTSP video.
10. Safety Interlocks & Security
Firmware flashing, hostapd cycling, Wi-Fi credential modifications, and autopilot reboots are hard-locked whenever
cockpit_mgr.is_vehicle_armed() returns True. Arming the vehicle automatically disconnects home Wi-Fi mode to ensure 100% telemetry link priority.
Authentication & Password Management:
- Default password:
sololink - Passwords are hashed using SHA-256 with random salt strings and stored in
auth.json. - CLI password reset script:
python change_password.py --reset
11. Official Downloads & Community Links
3DR Solo Web Utility ยท Built for the Open Solo Community.
3DR Solo is a product of 3D Robotics, Inc. This project is not affiliated with 3DR.