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
- Enter the device hostname or IP in the toolbar host field (e.g.
agent64.localor192.168.0.222) - Click Connect (or press Enter)
- The status bar shows Connected when the WebApi and hardware manager are both reachable
Navigation
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
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
.jsonalias file to display friendly names instead of net names
Bus Transactions
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)
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
Live strip-chart and scope-style plotting of channel values over time.
Modules
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
- Audio signal generation and playback
- Audio capture, FFT, and spectral analysis
- Video output control
- Image display
- Media file management (upload/download)
Calibration
Per-channel gain/offset calibration. Calibration data is stored persistently by product ID, revision, and serial number.
Firmware
- View current firmware version
- Upload and apply firmware updates
- Start/stop the hardware service
System Settings
Network discovery, workspace management, event monitoring, alias file management.
Logs
Application and device log viewer with filtering.
Troubleshooting
Common issues and remedies including connection failures, channel read errors, and firmware update problems.