FirmwareStatusNotification
Reports progress of a firmware update: downloading, installing, installed, or failed.
- Version
- OCPP 1.6
- Direction
- Charge Point → CSMS
- Feature profile
- Firmware Management
FirmwareStatusNotification also exists in OCPP 2.0.1, with a different payload. See the OCPP 2.0.1 version.
Because UpdateFirmware returns nothing useful, this message is the only way to know what happened. The charge point sends it at each stage transition.
A complete successful update produces Downloading, Downloaded, Installing, Installed, followed by a reboot and a fresh BootNotification with the new firmwareVersion.
Request
| Field | Type | Required | Description |
|---|---|---|---|
status | FirmwareStatus | Required | The current stage of the update. |
[2, "19223201", "FirmwareStatusNotification", {
"status": "Installing"
}]Response
No fields — the payload is an empty object {}.
[3, "19223201", {}]Values
FirmwareStatus
| Value | Meaning |
|---|---|
Idle | No update in progress. |
Downloading | Currently downloading. |
Downloaded | Download complete, not yet installing. |
DownloadFailed | The download failed after all retries. |
Installing | Currently installing. |
Installed | Installation complete. |
InstallationFailed | The installation failed. |
Implementation notes
`Installed` is not confirmation that the new version is running. Confirm with the firmwareVersion in the BootNotification that follows the reboot. A charger can report Installed and then roll back.
Chargers that go quiet between Downloaded and Installing for a long time are usually waiting for an active session to finish. Do not treat silence as failure without a generous timeout.
A DownloadFailed almost always means the location URL was unreachable from the charger.