Live demo — data resets daily at 03:00 UTC. Nothing you enter is saved. Server UI →

Accordion Pilot — GUI Application Guide

Source: accordionpilot/AccordionPilot/docs/ (separate repository: accordionpilot) Full per-feature docs are linked from each section below.


What is Accordion Pilot?

Accordion Pilot is a Windows desktop application for interacting with, controlling, and testing Accordion hardware systems. It provides a graphical interface for all hardware operations.

Architecture

Accordion Pilot (Windows WPF)
  └── HTTP → AccordionQ2 WebApi (:5000) on Raspberry Pi

Installation & Launch

Run AccordionPilot.exe. The splash screen displays while the application initialises.

Connecting to a Device

  1. Enter the device hostname or IP in the toolbar host field (e.g. agent64.local or 192.168.0.222)
  2. Click Connect (or press Enter)
  3. The status bar shows Connected when the WebApi and hardware manager are both reachable

Use the left-side navigation panel to switch views. Keyboard shortcuts for quick navigation:

Shortcut View
Alt+1 Channels
Alt+2 Settings
Alt+3 Chart
Alt+4 Transactions
Alt+5 Log
Alt+6 PSUs
Alt+7 Cal Table
Ctrl+F Open Find/Filter
F5 Refresh current view

Full shortcuts list: ap-shortcuts.md


Views

Channels

ap-channels.md

The primary view. Every hardware endpoint (GPIO, ADC, I2C, etc.) appears here as a row.

Grid columns: NetName · Alias · GroupName · ChannelType · Capability · Direction · Unit · Value · DeviceName

Key operations:

  • Read value — double-click a row, or enable polling for continuous refresh
  • Write value — right-click → Write, or use the editor panel
  • Filter — Ctrl+F; supports wildcard and regex
  • Sort — click column header; Shift+click for multi-column sort
  • Group — drag column header to the grouping panel
  • Alias file — load a .json alias file to display friendly names instead of net names

Bus Transactions

ap-transactions.md

Real-time monitor for all bus communications (I2C, SPI, UART, Socket).

Bus Typical use cases
I2C Sensors, EEPROM, PMBus, RTC, I/O expanders
SPI Flash, ADC/DAC chips, display controllers
UART Serial console, GPS, AT commands
Socket TCP/IP instrument control (SCPI over LAN)

Send custom commands from this view as well as monitor passive traffic.

Power Supplies (PSUs)

ap-power-supplies.md

Dedicated controls for programmable power supplies.

  • Set voltage / current setpoint
  • Read back actual voltage and current
  • Enable / disable output
  • Configure over-current protection (OCP)
  • PMBus device programming

Charts

ap-charts.md

Live strip-chart and scope-style plotting of channel values over time.

Modules

ap-modules.md

Load, unload, configure, and clone software modules at runtime.

Ribbon → Tools → Modules

Module operations are also accessible via AccordionShell:

accordionshell module --module "MyModule" --file config.xml   # load
accordionshell module --module "MyModule" --rename "Clone"    # clone
accordionshell module --module "MyModule" --deactivate        # unload

Audio & Video

ap-audio-video.md

  • Audio signal generation and playback
  • Audio capture, FFT, and spectral analysis
  • Video output control
  • Image display
  • Media file management (upload/download)

Calibration

ap-calibration.md

Per-channel gain/offset calibration. Calibration data is stored persistently by product ID, revision, and serial number.

Firmware

ap-firmware.md

  • View current firmware version
  • Upload and apply firmware updates
  • Start/stop the hardware service

System Settings

ap-system-settings.md

Network discovery, workspace management, event monitoring, alias file management.

Logs

ap-logs.md

Application and device log viewer with filtering.


Troubleshooting

ap-troubleshooting.md

Common issues and remedies including connection failures, channel read errors, and firmware update problems.

An unhandled error has occurred. Reload 🗙

Rejoining the server...

Rejoin failed... trying again in seconds.

Failed to rejoin.
Please retry or reload the page.

The session has been paused by the server.

Failed to resume the session.
Please retry or reload the page.