Skip to content
Documentation Menu

Firmware Status Notification

Source: OCPP 1.6 Specification — Section 4.5 (Operation), Sections 6.19 / 6.20 (Messages)

Overview

A Charge Point sends notifications to inform the Central System about the progress of the firmware update. The Charge Point SHALL send a FirmwareStatusNotification.req PDU for informing the Central System about the progress of the downloading and installation of a firmware update. The Charge Point SHALL only send the status Idle after receipt of a TriggerMessage for a Firmware Status Notification, when it is not busy downloading/installing firmware.

Upon receipt of a FirmwareStatusNotification.req PDU, the Central System SHALL respond with a FirmwareStatusNotification.conf.

Sequence Diagram

Figure 16. Sequence Diagram: Firmware Status Notification

Charge Point  ──── FirmwareStatusNotification.req ────▶  Central System
                   (status)
Charge Point  ◀─── FirmwareStatusNotification.conf ────  Central System

Initiator

Charge Point → Central System

Fields

Field NameField TypeCard.Description
statusFirmwareStatus1..1Required. This contains the progress status of the firmware installation.

FirmwareStatus values

  • Downloaded — New firmware has been downloaded by the Charge Point.
  • DownloadFailed — Charge Point failed to download firmware.
  • Downloading — Firmware is being downloaded.
  • Idle — Charge Point is not performing firmware update related tasks.
  • InstallationFailed — Installation of new firmware has failed.
  • Installing — Firmware is being installed.
  • Installed — New firmware has successfully been installed in the Charge Point.

Examples

{
  "status": "Downloading"
}

Schema

Source: schemas/FirmwareStatusNotification.json, schemas/FirmwareStatusNotificationResponse.json (OCPP 1.6, JSON Schema draft-04)

Request schema (JSON Schema)
Response schema (JSON Schema)