uConsole AIO V2 Documentation

The AIO V2 (All-In-One) is an expansion board that adds seven key functions to the ClockworkPi uConsole in a single module: an RTL-SDR receiver, a LoRa/Meshtastic radio, GPS, a real-time clock (RTC), a USB 3.0 hub, a 1 Gbps Ethernet port, and an internal USB-C port. Everything fits inside the uConsole enclosure - no external dongles, no cables hanging off the side.

Note: sapsan-sklep.pl is an official distributor of HackerGadgets uConsole accessories. The version we sell ships as a ready-to-use kit with the antenna mounting hardware and a full antenna set included.

Table of Contents

1. Introduction
2. What's in the Box
3. Technical Specifications
4. Compatibility
5. Quick Installation
6. GPIO Power Control
7. Module Setup
   • RTC
   • RTL-SDR
   • GPS
   • LoRa / Meshtastic
8. Installation Safety
9. For Developers
10. Support

Introduction

The AIO V2 turns the uConsole into a self-contained mobile command center. Instead of buying a separate RTL-SDR dongle, a GPS module, and an Ethernet adapter, all of these live on one board inside the case.

Compared to the original AIO board, V2 replaces the side USB-A port with a 1 Gbps RJ45 Ethernet port and adds GPIO power control for the GPS, LoRa, RTL-SDR, and internal USB - each of these is powered off by default and only comes online when its GPIO pin is pulled high. This is a deliberate design choice: the radios do not drain the battery until you actually enable them.

What's in the Box

The SAPSAN version of the AIO V2 is the antenna-kit edition:

• AIO V2 All-In-One extension board
• Antenna mounting kit
• Antenna set (7-antenna configuration)

The uConsole itself, the compute module (CM4/CM5), and the Upgrade Kit adapter board are not included.

Technical Specifications

Compatibility

• Designed for uConsole with a CM4 or CM5 compute module.
• The RTL-SDR, LoRa, GPS, and RTC functions work on the AIO V2 without the adapter board.
• USB 3.0 speed and the 1 Gbps Ethernet port require the uConsole Upgrade Kit adapter board, which routes PCIe and USB 3.0 from the compute module. Without it (and without CM5), USB is limited to USB 2.0 and the RJ45 port will not function.

Quick Installation

The fastest way to bring everything online is the HackerGadgets package. After logging into the uConsole:

sudo apt install hackergadgets-uconsole-aio-board

Then reboot. After the reboot, the SDR, GPS, LoRa, and internal USB modules are enabled and configured. If you prefer to set up each module by hand, use the manual steps below.

A ported Bookworm or Trixie image with SDR++ pre-installed (by Rex, from the ClockworkPi forum) is recommended as the base OS.

GPIO Power Control

On the AIO V2 each radio is powered through a GPIO pin and is off by default. The package above handles this automatically, but you can also toggle them manually:

Example - enable and disable the GPS rail:

pinctrl 27 op && pinctrl 27 dh   # Enable GPS power
pinctrl 27 op && pinctrl 27 dl   # Disable GPS power

A module will not be detected by the system until its GPIO pin is pulled high. A helper control script is available at github.com/hackergadgets/aiov2_ctl.

Module Setup

The steps below are the manual configuration path. If you used the hackergadgets-uconsole-aio-board package, most of this is already done for you.

RTC

Add the following to /boot/firmware/config.txt.

CM4:

# RTC
dtparam=i2c_arm=on
dtoverlay=i2c-rtc,pcf85063a

CM5:

# RTC
dtparam=rtc=off
dtoverlay=i2c-rtc,pcf85063a,i2c_csi_dsi0

Reboot, then verify:

sudo hwclock -r

The command should print the current date and time. The RTC keeps time across power-off thanks to the CR1220 battery.

RTL-SDR

1. Connect an antenna to the IPEX connector labeled SDR.
2. Install SDR++:

   sudo apt install sdrpp

3. Launch sdrpp, select the RTL-SDR device in the source dropdown.
4. Tune to a frequency and pick a modulation (WFM for broadcast FM).
5. Click play - a local FM station is a quick way to confirm the receiver works.

The 5V bias tee (software-controllable) can power active antennas and LNAs.

GPS

Add to /boot/firmware/config.txt:

CM4:

enable_uart=1

On CM4 also remove console=serial0,115200 from /boot/firmware/cmdline.txt.

CM5:

dtparam=uart0

Then:

1. Connect an antenna to the IPEX connector labeled GPS (active or passive).
2. Read the NMEA stream:

   sudo minicom -D /dev/ttyS0 -b 9600      # CM4
   sudo minicom -D /dev/ttyAMA0 -b 9600    # CM5

3. A valid fix shows $GNGGA and $GNRMC sentences with coordinates.
4. Go outside - GPS needs a clear view of the sky to acquire a fix.

For microsecond-accurate NTP, the GPS PPS output can be routed to GPIO6 (see the manufacturer guide for the PPS configuration).

LoRa / Meshtastic

Add to /boot/firmware/config.txt:

CM4:

dtparam=spi=on
dtoverlay=spi1-1cs

CM5:

dtoverlay=spi1-1cs

1. Connect an 860 - 960 MHz antenna to the IPEX connector labeled LoRa.
2. On the Bookworm image, free the SPI bus used by the DevTerm printer:

   sudo systemctl stop devterm-printer.service
   sudo systemctl disable devterm-printer.service

3. Install the Meshtastic build dependencies:

   sudo apt install libgpiod-dev libyaml-cpp-dev libbluetooth-dev libusb-1.0-0-dev libi2c-dev openssl libssl-dev libulfius-dev liborcania-dev

4. Install meshtasticd (download the latest arm64 .deb from the Meshtastic firmware releases):

   sudo apt install ./meshtasticd_<version>_arm64.deb

5. Configure the LoRa radio in /etc/meshtasticd/config.yaml:

   Lora:
     Module: sx1262
     DIO2_AS_RF_SWITCH: true
     DIO3_TCXO_VOLTAGE: true
     IRQ: 26
     Busy: 24
     Reset: 25
     spidev: spidev1.0

6. To feed GPS into Meshtastic, add:

   GPS:
     SerialPath: /dev/ttyS0     # /dev/ttyAMA0 on CM5

7. Enable and start the service:

   sudo systemctl daemon-reload
   sudo systemctl enable meshtasticd
   sudo systemctl start meshtasticd
   sudo systemctl status meshtasticd

8. View logs with sudo journalctl -u meshtasticd -b.
9. Optionally enable the web UI in /etc/meshtasticd/config.yaml:

   Webserver:
     Port: 443
     RootPath: /usr/share/meshtasticd/web

   Then open https://localhost (accept the self-signed certificate warning) and set your region under Config > LoRa.

Installation Safety

Warning: After installing the AIO V2, make sure the ribbon cable is connected exactly as shown in the instructions. An incorrectly connected ribbon cable combined with charging can damage the uConsole mainboard.

For Developers

Key pin assignments for the SX1262 LoRa module (SPI1):

Module power-control GPIO map (see GPIO Power Control): GPS = 27, LoRa = 16, RTL-SDR = 7, Internal USB = 23.

Support

For technical support and setup help:

• email: contact@sapsan-sklep.pl
• Manufacturer setup guide: HackerGadgets uConsole AIO setup guide