IV — Interface Version
Queries the microcontroller interface firmware version and initiates a microcontroller firmware update.
Format
- Query:
>QIV< - Set (start update):
>SIV{VERSION}< - Response (query):
>RIV{VERSION}[,{STATUS},{LINES}]<
| Field | Description |
|---|---|
VERSION | Firmware version string (e.g., 1.7.1.1A) |
STATUS | Update status code (only present during active update) |
LINES | Number of firmware lines sent so far |
Parameters
Minimum set command length: 12 characters (>SIV1.7.1.1A<)
Examples
Query interface version:
>QIV<
>RIV1.7.1.1A< ← No update in progress
During firmware update:
>QIV<
>RIV1.7.1.1A,1,256< ← Update running, 256 lines sent
Start firmware update:
>SIV1.8.0.0A<
Status Monitoring
Check update progress with IV:
>QIV<
>RIV1.7.1.1A,1,256<
Update Status Codes
| Code | Name | Description |
|---|---|---|
| 0 | BOOTLOADER_DOWNLOADING_FILE | Downloading firmware file |
| 1 | BOOTLOADER_FILE_DOWNLOADED | Download complete |
| 2 | BOOTLOADER_FILE_SENT | File sent to bootloader |
| 3 | BOOTLOADER_VALID_FILE | File validated |
| 4 | BOOTLOADER_RUNNING | Update in progress |
| 5 | BOOTLOADER_SUCCESSFUL_UPGRADE | Update successful |
| 6 | BOOTLOADER_ERROR_DOWNLOADING_FILE | Download failed |
| 99 | BOOTLOADER_NOT_RUNNING | No update active |
caution
Do not interrupt power during a firmware update.
Related Signals
- Firmware update also available via XAFU (long format)
- Quick version query:
>QVR<for main firmware version