System Commands
These commands are available on all device variants.
:SYSTem:FIRMware:VERSion?
Query the current firmware version.
Short form: :SYST:FIRM:VERS?
Response: Quoted string
Example:
:SYSTem:FIRMware:STATus?
Query firmware update status.
Short form: :SYST:FIRM:STAT?
Response: Status string in one of the following formats:
| Response | Description |
|---|---|
"IDLE" |
No update in progress |
"UPDATING,<progress>,<message>" |
Update in progress with percentage and status |
"COMPLETE" |
Last update completed. After a single-slot update, reboot (:SYSTem:REBoot) to activate it. |
"ERROR,<message>" |
Last update failed |
COMPLETE is reported until the device restarts, including after a both-slots update started from the web UI or REST API. A both-slots update interrupted after its reboot reports "UPDATING,55,Re-upload the firmware bundle to finish the second slot.". It can only be finished or cancelled from the web UI or REST API.
Example:
:SYSTem:FIRMware:UPDate \<url>
Download a firmware bundle from a URL and install it to the inactive slot. Only HTTPS URLs are accepted. The update runs asynchronously — poll :SYSTem:FIRMware:STATus? for progress, then reboot with :SYSTem:REBoot to activate the new firmware. To update both slots, use the web UI or the REST API.
Short form: :SYST:FIRM:UPD
Example:
Errors:
-101— Missing URL parameter-200— Update failed to start (already in progress, empty or non-HTTPS URL, etc.)
:SYSTem:REBoot
Reboot the device. The device will be unreachable for approximately 30 seconds.
Short form: :SYST:REB
Example: