Management
The management commands identify the reader, report its status, and configure its network, MQTT endpoints, certificates, event reporting and firmware. Your application publishes them to a management endpoint's command topic, for example <tenantId>/MGMT/clients/cmnd/<deviceSerialNumber>, and reads each reply on its response topic, paired by requestId. Commands and replies travel at QoS 1 and are not retained.
| Group | Commands |
|---|---|
| Device Info and Status | get_version, get_status, get_current_region |
| Network Configuration | get_eth, get_wifi, set_wifi, delete_wifi_profile |
| Endpoint Configuration | get_endpoint_config, config_endpoint |
| Certificate Management | get_installed_certificates, install_certificate, delete_certificate |
| Event Management | config_events |
| Device Lifecycle | set_os, reboot |
Every get_* command is safe to send again. set_os, install_certificate and reboot reply with code 1 before their work is done.
In This Section
Device Info and Status
Identify the reader and read its state — firmware and API version, device status.
Network Configuration
Inspect Ethernet and Wi-Fi, configure Wi-Fi, and manage saved Wi-Fi profiles.
Endpoint Configuration
Read and configure the MQTT endpoints the reader connects through.
Certificate Management
List, install, and delete TLS certificates on the reader.
Event Management
Enable or disable event streams, set the heartbeat interval.
Device Lifecycle
System-level actions — OS update and reboot.