Skip to content
Documentation Menu

Update Firmware

Source: OCPP 1.6 Specification — Section 5.19 (Operation), Sections 6.55 / 6.56 (Messages)

Overview

Central System can notify a Charge Point that it needs to update its firmware. The Central System SHALL send an UpdateFirmware.req PDU to instruct the Charge Point to install new firmware. The PDU SHALL contain a date and time after which the Charge Point is allowed to retrieve the new firmware and the location from which the firmware can be downloaded.

Upon receipt of an UpdateFirmware.req PDU, the Charge Point SHALL respond with an UpdateFirmware.conf PDU. The Charge Point SHOULD start retrieving the firmware as soon as possible after retrieveDate.

While the firmware download and installation are in progress, the Charge Point informs the Central System using FirmwareStatusNotification.req.

Sequence Diagram

Figure 41. Sequence Diagram: Update Firmware

Central System  ──── UpdateFirmware.req ────▶  Charge Point
                     (location, retrieveDate, retries?, retryInterval?)
Central System  ◀─── UpdateFirmware.conf ────  Charge Point

Initiator

Central System → Charge Point

Fields

Field NameField TypeCard.Description
locationanyURI1..1Required. This contains a string containing a URI pointing to a location from which to retrieve the firmware.
retriesinteger0..1Optional. This specifies how many times Charge Point must try to download the firmware before giving up. If this field is not present, it is left to Charge Point to decide how many times it wants to retry.
retrieveDatedateTime1..1Required. This contains the date and time after which the Charge Point must retrieve the (new) firmware.
retryIntervalinteger0..1Optional. The interval in seconds after which a retry may be attempted. If this field is not present, it is left to Charge Point to decide how long to wait between attempts.

Examples

{
  "location": "https://firmware.example.com/cp/1.5.0/firmware.bin",
  "retries": 3,
  "retrieveDate": "2026-04-28T02:00:00Z",
  "retryInterval": 600
}

Schema

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

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