# Firmware changelog and release policy

## Distribution channels:

> When updating many chargers, ensure you use an adequate risk-mitigation strategy to prevent large-scale issues and downtime. See [Risk mitigation strategy](risk-mitigation-strategy).

1. Updates and release notes are published to the [public changelog](#firmware-changelog), from where you can download the firmware.
    * Additionally, if a OTA download certificate for azure blob store has been provisioned, or the charger is running plain http, links are provided that may be given directly to the charger to update it.
    * Firmware updates files are considered public information, feel free to re-host them.

> For critical security fixes, amina will make best-effort contact with affected customers to ensure they are informed of the security issue and fix.

(risk-mitigation-strategy)=
## Risk mitigation strategy

amina performs best-effort testing on all firmware before release, focusing especially on ensuring chargers do not go permanently offline, or become "un-updatable" (bricked). But in practice it is difficult to test all possible combinations of settings, with all combinations of back-ends. Therefore, we urge you to employ an adequate risk-mitigation strategy when deploying updates to fleets of chargers. An example of this is performing staggered rollouts.

(firmware-changelog=)
# Firmware Changelog

This lists all the public releases of the FW for *amina* OCPP charging stations.

- All public releases are avaliable as OTA updates and follows the [semantic versioning](https://semver.org/) scheme (releases including minor and patch increases are always backwards compatible)
- Only the latest firmware version is available for download

## Latest FW OTA Update

### Instructions
1. Send an `UpdateFirmare.req` OCPP message to the charge point with the appropriate link in the `location` field
    1. Charge points configured for LTE or Ethernet only support OTA updates over HTTPS, and the update file must therefore be provided through an HTTPS link
    2. Charge points configured for Wi-Fi support OTA updates over either HTTP or HTTPS depending on whether the configured CSMS endpoint is using TLS or not. The update file must be provided using the same security as the CSMS endpoint, i.e. if the CSMS endpoint starts with `wss://` an HTTPS link must be used, and if the CSMS endpoint starts with `ws://` an HTTP link must be used
    3. We recommend using the links we provide below directly. However, it's also possible to download the files and host them elsewhere. In the case where the update file is hosted elsewhere and the charge point is provisioned for LTE, Ethernet or Wi-Fi TLS (i.e. OTA updates are downloaded over HTTPS) the charge point must also have the appropriate certificate provisioned to be able to download the file
2. We recommend updating charge points to the latest firmware version provided in the link below to ensure that they benefit from the most recent features, stability enhancements, security updates, and bug fixes. We also recommend deploying updates using a "rolling update" approach. This allows issues to be identified early before impacting a large number of chargers

### Limitations
1. Chargers running FW with a major versions of `3` **cannot** be updated to FW with major version `4` (a migration is planned)

### amina C

#### 4.x.x
- `4.2.106`
    - [Release notes](#md-4-2-106-2026-03-25)
    - HTTPS: <a href="https://dataexplorerblob.blob.core.windows.net/shared/aminaC_4.2.106-rtm_v3.bin?sv=2025-07-05&spr=https%2Chttp&st=2026-03-30T10%3A40%3A37Z&se=2126-03-31T10%3A40%3A00Z&sr=b&sp=r&sig=UWhC8eh3BDhSfB0Xoanv8%2FbujEQRfHGQdwjRIHKVaFo%3D">4.2.106</a>
    - HTTP: <a href="http://dataexplorerblob.blob.core.windows.net/shared/aminaC_4.2.106-rtm_v3.bin?sv=2025-07-05&spr=https%2Chttp&st=2026-03-30T10%3A40%3A37Z&se=2126-03-31T10%3A40%3A00Z&sr=b&sp=r&sig=UWhC8eh3BDhSfB0Xoanv8%2FbujEQRfHGQdwjRIHKVaFo%3D">4.2.106</a>

- `4.2.85`
    - [Release notes](#md-4-2-85-2026-02-27)
    - HTTPS: <a href="https://dataexplorerblob.blob.core.windows.net/shared/aminaC_4.2.85-rtm_v3.bin?sv=2025-07-05&spr=https&st=2026-02-27T14%3A17%3A01Z&se=2126-02-28T14%3A17%3A00Z&sr=b&sp=r&sig=3EC%2BaPdhXyjc0TGuKTtc4goTGem0gSDl6EYYQRDh44Q%3D">4.2.85</a>
    - HTTP: <a href="http://dataexplorerblob.blob.core.windows.net/shared/aminaC_4.2.85-rtm_v3.bin?sv=2025-07-05&spr=https%2Chttp&st=2026-02-27T14%3A17%3A01Z&se=2126-02-28T14%3A17%3A00Z&sr=b&sp=r&sig=MfRfHCBgrpPox1iKOJm%2F75f0cRWvH%2FEpBRs360YQ8NI%3D">4.2.85</a>

- `4.2.61`
    - [Release notes](#md-4-2-61-63-2026-01-23)
    - HTTPS: <a href="https://dataexplorerblob.blob.core.windows.net/shared/aminaC_4.2.61-rtm_v3.bin?sp=r&st=2026-01-23T07:47:51Z&se=2126-01-23T16:02:51Z&sv=2024-11-04&sr=b&sig=SHd9QVzcT%2B36Q01mD7KlrVfaGOJLv0boq94NNn0s1zY%3D">4.2.61</a>
    - HTTP: <a href="http://dataexplorerblob.blob.core.windows.net/shared/aminaC_4.2.61-rtm_v3.bin?sp=r&st=2026-01-23T07:47:51Z&se=2126-01-23T16:02:51Z&sv=2024-11-04&sr=b&sig=SHd9QVzcT%2B36Q01mD7KlrVfaGOJLv0boq94NNn0s1zY%3D">4.2.61</a>

#### 3.x.x
- `3.5.54`
    - [Release notes](#md-4-2-85-2026-02-27)
    - HTTPS: <a href="https://dataexplorerblob.blob.core.windows.net/shared/aminaC_3.5.54-rtm_v2.bin?sv=2025-07-05&spr=https&st=2026-03-03T09%3A09%3A35Z&se=2126-03-04T09%3A09%3A00Z&sr=b&sp=r&sig=C9Be0HUtci%2BkcffHklVetI9iIgrzG5cbqH%2B%2BYk4kGcg%3D">3.5.54</a>
    - HTTP: <a href="http://dataexplorerblob.blob.core.windows.net/shared/aminaC_3.5.54-rtm_v2.bin?sv=2025-07-05&spr=https%2Chttp&st=2026-03-03T09%3A09%3A35Z&se=2126-03-04T09%3A09%3A00Z&sr=b&sp=r&sig=c0NcrxGD0u3wPSwpvXxRRtcXRqtS8d%2BjIuTFYwOcgG4%3D">3.5.54</a>

- `3.5.2`
    - [Release notes](#md-3-5-2-2025-12-09)
    - HTTPS: <a href="https://dataexplorerblob.blob.core.windows.net/shared/aminaC_3.5.2-rtm-3-4-nfc-improvements-from-4-2-34.6_v2.bin?sp=r&st=2025-12-10T06:43:07Z&se=2125-12-10T14:58:07Z&sv=2024-11-04&sr=b&sig=oTcEMfyKUIVC52iET%2Fnc8HFa3KTCD%2BhYwJkHnkQ5tPY%3D">3.5.22</a>
    - HTTP: <a href="http://dataexplorerblob.blob.core.windows.net/shared/aminaC_3.5.2-rtm-3-4-nfc-improvements-from-4-2-34.6_v2.bin?sp=r&st=2025-12-10T06:43:07Z&se=2125-12-10T14:58:07Z&sv=2024-11-04&sr=b&sig=oTcEMfyKUIVC52iET%2Fnc8HFa3KTCD%2BhYwJkHnkQ5tPY%3D">3.5.2</a>

### amina M
- `4.2.106`
    - [Release notes](#md-4-2-106-2026-03-25)
    - HTTPS: <a href="https://dataexplorerblob.blob.core.windows.net/shared/aminaM_4.2.106-rtm_v3.bin?sv=2025-07-05&spr=https%2Chttp&st=2026-03-30T10%3A39%3A38Z&se=2126-03-31T10%3A39%3A00Z&sr=b&sp=r&sig=2SCuwjPT6gcnpO68W2csxD0BVLCnmo2CccO8CSbRlp8%3D">4.2.106</a>
    - HTTP: <a href="http://dataexplorerblob.blob.core.windows.net/shared/aminaM_4.2.106-rtm_v3.bin?sv=2025-07-05&spr=https%2Chttp&st=2026-03-30T10%3A39%3A38Z&se=2126-03-31T10%3A39%3A00Z&sr=b&sp=r&sig=2SCuwjPT6gcnpO68W2csxD0BVLCnmo2CccO8CSbRlp8%3D">4.2.106</a>

- `4.2.63`
    - [Release notes](#md-4-2-61-63-2026-01-23)
    - HTTPS: <a href="https://dataexplorerblob.blob.core.windows.net/shared/aminaM_4.2.63-rtm_v3.bin?sp=r&st=2026-01-26T06:23:42Z&se=2126-01-26T14:38:42Z&sv=2024-11-04&sr=b&sig=nbK5dga3xvMxUgOX9NnA8JhNqfLb5oA2SbadUTyzvVY%3D">4.2.63</a>
    - HTTP: <a href="http://dataexplorerblob.blob.core.windows.net/shared/aminaM_4.2.63-rtm_v3.bin?sp=r&st=2026-01-26T06:23:42Z&se=2126-01-26T14:38:42Z&sv=2024-11-04&sr=b&sig=nbK5dga3xvMxUgOX9NnA8JhNqfLb5oA2SbadUTyzvVY%3D">4.2.63</a>



(md-4-2-106-2026-03-25)=
## C 4.2.106 and M 4.2.106 (2026-03-25)

### Features
- Charge stations can be factory-provisioned with a default root CA bundle
  (see [Supported Root CA Bundle Certificates](ocpp-root-ca-bundle.md)).

### Improvements
- Grid detection.
---

(md-4-2-85-2026-02-27)=
## C 4.2.85, C 3.5.54, and M 4.2.86 (2026-02-27)

### Features
- Add ability to migrate CSMS endpoint url via OCPP (see [Migrate to a New CSMS Using OCPP](ocpp-csms-migration.md))
- (amina M) Automatically switch to Ethernet when an Ethernet cable is plugged in. (see [In Field Commissioning](in-field-commissioning.md))

### Improvements
- Fix WiFi potentially not connecting if eSIM is blocked or LTE signal is poor
- Fix bug keeping charger in preparing even when no car is connected, untill a hard reset.
- Filesystem stability improvements
---

(md-4-2-61-63-2026-01-23)=
## 4.2.61 and 4.2.63 (2026-01-23)

### Features
- Wi-Fi TLS
- Add support for permanently switching from LTE to Wi-Fi TLS
- `StatusNotification` can now report the invalid grid type error

### Improvements
- Wi-Fi reliability
----

(md-4-2-34-2025-12-05)=
## 4.2.34 (2025-12-05)

### Features

### Improvements
- NFC reliability and detection
- OCPP transaction handling
----

(md-4-2-17-2025-11-17)=
## 4.2.17 (2025-11-17)

### Features
- amina M release
- Support OCPP-J 1.6 `AuthorizationKey`

### Improvements
- Wi-Fi OTA download stability
----

(md-4-0-17-2025-10-08)=
## 4.0.17 and 4.0.19 (2025-10-08)

### Features
- Compliant with EN18031-1

### Improvements
- Improve network stability
- Fix OCPP connection issues when using LTE in certain geographical areas
- Fix incorrect reporting of `InstallationFailed` instead of `DownloadFailed` in `FirmwareStatusNotification` when a OTA update download fails
----

(md-3-5-2-2025-12-09)=
## 3.5.2 (2025-12-09)

### Features
- Support OCPP-J 1.6 `AuthorizationKey`

### Improvements
- NFC reliability and detection
- OCPP transaction handling
- Wi-Fi OTA download stability
- Improve network stability
- Fix OCPP connection issues when using LTE in certain geographical areas
- Fix incorrect reporting of `InstallationFailed` instead of `DownloadFailed` in `FirmwareStatusNotification` when a OTA update download fails

### Additional Comments
- Not yet recommended for use on charge points configured with Wi-Fi
----

(md-3-3-1-2025-07-02)=
## 3.3.1 (2025-07-02)

### Features
- Add Wi-Fi captive portal to commission Wi-Fi credentials in the field (see [In Field Commissioning](in-field-commissioning.md))
- Add `Cst_MaxCurrentRotarySwitchSetting` as custom read-only OCPP setting (see [OCPP 1.6j Configuration Settings](ocpp-settings.md))

### Improvements
- Improve network stability
- Fix OCPP connection issue with some Azure based CSMS endpoints
----

(md-3-0-96-2025-05-16)=
## 3.0.96 (2025-05-16)

### Features
- Set CSMS endpoint URL remotely

### Improvements
- Improve overall stability
- Improve reading of NFC tags
----

(md-3-0-82-2025-04-29)=
## 3.0.82 (2025-04-29)

### Features
- Add OCPP 1.6j over Wi-Fi support (only over HTTP)

### Improvements
- Improve overall stability
----

(md-3-0-35-2025-02-19)=
## 3.0.35 (2025-02-19)

### Features
- Add OCPP 1.6j support over LTE (only over HTTPS)

### Improvements