accordionq2 1.0.0

Python client for the AccordionQ2 Hardware Management REST API

AccordionQ2 Python Client

Python client library for the AccordionQ2 Hardware Management REST API. This is the Python counterpart of the .NET WebApiClient; both libraries expose the same API surface so switching between them feels natural.

Requirements

Requirement	Details
Python	3.8 or later
Platform	Windows, Linux (including ARM / Raspberry Pi)
Architecture	32-bit and 64-bit
Dependencies	None — stdlib only (urllib, json, enum, dataclasses)

Installation

Install directly from a local checkout (editable mode recommended during development):

pip install -e .

Or, for a regular install:

pip install .

Quick Start

from accordionq2 import AccordionQ2Client

with AccordionQ2Client("http://agent64.local:5000") as client:
    # Check the hardware connection
    status = client.connection.get_status()
    print("Connected:", status.is_connected)

    # Read a sensor value
    temp = client.resources.get_value("TempRegulator.CPU_TEMP")
    print("CPU temperature:", temp)

    # List all channels
    for ch in client.channels.get_all():
        print(f"  {ch.alias}: type={ch.channel_type}, unit={ch.unit}")

The client can also be used without a with block:

client = AccordionQ2Client("http://agent64.local:5000")
names = client.resources.get_names()
client.close()

Constructor

AccordionQ2Client(base_url, timeout=30.0)

Parameter	Description
base_url	Base URL of the AccordionQ2 WebApi, e.g. "http://raspberrypi:5000"
timeout	HTTP request timeout in seconds (default 30)

---

API Reference

The client exposes six groups, each covering one area of the hardware API. All methods are synchronous and raise AccordionQ2ApiError on HTTP errors.

client.connection — Connection Status

Method	Returns	Description
get_status()	ConnectionStatusDto	Check whether the API is connected to the hardware manager.

status = client.connection.get_status()
if not status.is_connected:
    print("Error:", status.last_error)

---

client.resources — Resource Values

Resources represent readable/writable hardware values such as voltages, temperatures, and firmware revisions. They are identified by a dotted name string (e.g. "TempRegulator.CPU_TEMP").

Method	Returns	Description
get_names()	list[str]	List all available resource names.
get_value(name)	str	Read the current value of a single resource.
set_value(name, value)	—	Write a value to a single resource.
get_values(names)	dict[str, str]	Read multiple resources in one call.
set_values(resources)	—	Write multiple resources in one call.
transact(name, value)	str	Write then read (command/response pattern).

# Single read
voltage = client.resources.get_value("0.1.ESH10000158.MON_3V3")

# Batch read
values = client.resources.get_values([
    "TempRegulator.CPU_TEMP",
    "Engine.Uptime",
])
for name, val in values.items():
    print(f"{name} = {val}")

---

client.channels — Hardware Channels

Channels represent multi-purpose I/O pins (analog, digital, I2C, SPI, etc.).

Method	Returns	Description
get_all()	list[ChannelDto]	Return every configured channel.
get_channel(alias=, net_name=)	ChannelDto	Look up one channel by alias or net name.
configure(config)	—	Partial-update a single channel.
configure_many(configs)	—	Partial-update multiple channels.

from accordionq2.models import ChannelConfigRequest
from accordionq2.enums import ChannelTypes

# Look up by alias
ch = client.channels.get_channel(alias="0.1.ESH10000158.MON_3V3")
print(f"Type: {ch.channel_type}, Direction: {ch.direction}")

# Check flags
if ch.channel_type & ChannelTypes.ANALOG:
    print("This is an analog channel")

# Partial update (only the fields you set are changed)
client.channels.configure(ChannelConfigRequest(
    alias="0.1.ESH10000158.MON_3V3",
    description="Main 3.3 V rail monitor",
    unit="V",
))

---

client.modules — Module Management

Method	Returns	Description
get_all()	list[ModuleSettingsDto]	All modules (loaded and unloaded).
get_loaded()	list[ModuleSettingsDto]	Currently loaded modules only.
load(module)	—	Load a module.
unload(module)	—	Unload a module.
configure(module)	—	Update module configuration.
get_physical_system()	PhysicalSystemDto	Hardware topology (host, MAC, modules).
get_licensed_apps()	list[AppLicenseDto]	Licensed applications.
get_all_apps()	list[AppLicenseDto]	All applications.

system = client.modules.get_physical_system()
print(f"Host: {system.host}, MAC: {system.mac}")
for mod in system.modules:
    print(f"  Slot {mod.index}: {mod.name} ({mod.product_id})")

for m in client.modules.get_loaded():
    print(f"  {m.name} (enabled={m.enabled})")

---

client.application — Application Lifecycle

Method	Returns	Description
get_name()	str	Application module name.
get_identification()	str	Application identification string.
get_status()	ModuleStatus	Current status (enum).
reset()	—	Reset the application engine.
list_config_files()	list[str]	Available configuration files.
get_loaded_config_files()	list[str]	Currently loaded config files.
load_config_file(name)	—	Load a configuration file.
save_config_file(name)	—	Save configuration to a file.
download_config_file(name)	bytes	Download a config file as raw bytes.
upload_config_file(name, data)	—	Upload a config file (bytes).
delete_config_file(name)	—	Delete a config file from the device.

from accordionq2.enums import ModuleStatus

status = client.application.get_status()
if status == ModuleStatus.OK:
    print("Application is running normally")

# Configuration file round-trip
data = client.application.download_config_file("factory.cfg")
client.application.upload_config_file("factory_backup.cfg", data)

---

client.media — Media Files

Method	Returns	Description
list_files()	list[str]	List media files on the device.
download_file(name)	bytes	Download a media file.
upload_file(name, data)	—	Upload a media file (bytes).
delete_file(name)	—	Delete a media file.

for f in client.media.list_files():
    print(f)

# Download and save locally
content = client.media.download_file("waveform.bin")
with open("waveform.bin", "wb") as fp:
    fp.write(content)

---

Models

All models live in accordionq2.models.

Class	Description
ConnectionStatusDto	is_connected (bool), last_error (str or None)
ChannelDto	Full channel description (18 fields including type, direction, alias, unit, etc.)
ChannelConfigRequest	Partial-update request — only non-None fields are applied
ChannelLookupRequest	Identify a channel by alias or net_name
ModuleSettingsDto	Module configuration (name, enabled, class_name, initial_data, etc.)
PhysicalSystemDto	Hardware topology (host, mac, firmware, modules list)
PhysicalModuleDto	One hardware slot (index, name, product_id, revision, serial_number)
AppLicenseDto	License info (name, key, expires, type)

Response models provide a from_dict(data) class method; request models provide a to_dict() instance method.

Enumerations

All enums live in accordionq2.enums.

Enum	Type	Values
ModuleStatus	str, Enum	UNKNOWN, OK, WARNING, ERROR, DISABLED
AppTypes	str, Enum	UNKNOWN, SOFTWARE_MODULE, HARDWARE_MODULE
MpioUsageTypes	str, Enum	UNDEFINED, HIDDEN_SYSTEM_CONTROL, READ_ONLY_SYSTEM_CONTROL, USER_ALLOCATABLE, BUS_SIGNAL
DirectionTypes	IntFlag	UNDEFINED, IN, OUT
ChannelTypes	IntFlag	UNDEFINED, ANALOG, DIGITAL, TEMPERATURE, I2C, SPI, UART, and many more

IntFlag enums support bitwise operations:

from accordionq2.enums import ChannelTypes, DirectionTypes

combined = ChannelTypes.ANALOG | ChannelTypes.DIGITAL
if ch.channel_type & ChannelTypes.I2C:
    print("I2C channel")

if ch.direction & DirectionTypes.IN:
    print("Input capable")

---

Error Handling

All API errors raise AccordionQ2ApiError (importable from the top-level package). The exception carries the HTTP status code and the server's error message:

from accordionq2 import AccordionQ2ApiError

try:
    ch = client.channels.get_channel(alias="does.not.exist")
except AccordionQ2ApiError as e:
    print(f"HTTP {e.status_code}: {e}")

---

Running the Integration Tests

The test suite uses pytest and talks to a live AccordionQ2 device.

# Install with test dependencies
pip install -e ".[dev]"

# Run all integration tests
pytest tests/ -m integration -v

# Override the default device URL
ACCORDIONQ2_API_URL=http://mydevice:5000 pytest tests/ -m integration

The default URL is http://agent64.local:5000.

---

Comparison with the .NET Client

Both clients expose the same API surface with idiomatic naming for their respective language:

Concept	.NET (AccordionQ2Client)	Python (AccordionQ2Client)
Lifecycle	IDisposable / using	Context manager / with
Methods	GetValueAsync(name)	get_value(name)
Concurrency	async / await	Synchronous (thread-safe)
Nullability	string?	None
Config	ChannelConfigRequest.Enabled = true	ChannelConfigRequest(enabled=True)
Enums	ChannelTypes.Analog	ChannelTypes.ANALOG
Errors	AccordionQ2ApiException	AccordionQ2ApiError
Dependencies	Newtonsoft.Json	None (stdlib only)

---

License

Proprietary — see your license agreement for details.