Skip to content

Home

Jump to bottom
Shane Rounce edited this page Jan 25, 2026 · 4 revisions

aiov2_ctl

aiov2_ctl is a system-level control and telemetry tool for the HackerGadgets uConsole AIO v2 Upgrade Kit.

It provides:

  • GPIO power control (GPS, LoRa, SDR, USB)
  • Battery-first power telemetry (hardware truth source)
  • Live power monitoring and delta measurement
  • A lightweight system tray GUI
  • Turnkey setup for common radio and GNSS applications

This tool is designed to feel like a first-class system utility, not a script.

Quick Start

Install required system packages:

sudo apt update
sudo apt install -y python3 python3-pip python3-pyqt6 git

Then get and install:

git clone https://github.com/AceMedia/aiov2_ctl.git
cd aiov2_ctl
sudo python3 aiov2_ctl.py --install

Open a new shell and try:

aiov2_ctl --status
aiov2_ctl --gui

Bash tab-completion is installed automatically.

GUI Autostart (Optional)

To start the system tray GUI automatically on login:

aiov2_ctl --autostart

To disable it later:

aiov2_ctl --no-autostart

Hardware Context

This project targets the uConsole AIO v2 Upgrade Kit, providing software-level control and visibility over hardware.

Key characteristics:

  • GPIO-controlled RF peripherals
  • On-board battery and current sensing
  • Battery current as the only reliable power truth
  • CM4 / CM5 compatible
  • Designed for off-grid, radio-heavy use

Product page: https://hackergadgets.com/products/uconsole-upgrade-kit

Important Notes (Read This)

Some behaviour users encounter is hardware-related, not software bugs.

If you experience instability with Wi-Fi + Bluetooth, SDR audio issues, or USB device resets, see:

These are documented plainly so users can make informed decisions.

What aiov2_ctl Is (and Is Not)

It is:

  • A control plane for the AIO v2 board
  • A visibility layer for real power usage
  • A practical workaround for hardware constraints

It is not:

  • A driver replacement
  • A fix for under-spec’d hardware
  • A generic GPIO wrapper

Wiki Structure

Use the pages below depending on what you’re doing:

Wiki

  • Installation
    System-wide install, updates, autostart, bash completion

  • CLI Usage
    Commands, measurement mode, examples

  • GUI
    Tray behaviour, left-click status window

  • Power & Telemetry
    How power is measured, noise floor, why battery current matters

  • Applications
    Meshtastic, SDR++, tar1090, PyGPSClient

  • Troubleshooting
    Known hardware limits, SDR audio, Wi-Fi/Bluetooth power, compensation options


   db    88  dP"Yb      Yb    dP oP"Yb.
  dPYb   88 dP   Yb      Yb  dP  "' dP'
 dP__Yb  88 Yb   dP       YbdP     dP'
dP""""Yb 88  YbodP         YP    .d8888

---------------------------------------

aiov2_ctl — HackerGadgets uConsole AIOv2 control + telemetry tool

https://hackergadgets.com/products/uconsole-upgrade-kit

Clone this wiki locally