Configuration Keys
These are the configuration keys the BRIGHTBLU communication controller exposes over OCPP 1.6J. Read them with GetConfiguration and change writable ones with ChangeConfiguration.
Access:
- RW — writable with
ChangeConfigurationand returned byGetConfiguration. - RO — returned by
GetConfigurationbut not writable (aChangeConfigurationattempt is rejected). - WO — accepted by
ChangeConfigurationbut never returned (or masked) byGetConfiguration.
Core profile
Section titled “Core profile”| Key | Access | Type | Default | Accepted values | Description |
|---|---|---|---|---|---|
| AuthorizeRemoteTxRequests | RW | boolean | false | true / false | Require an Authorize before a RemoteStartTransaction is accepted. |
| ClockAlignedDataInterval | RW | integer | 0 | — | Interval (s) for clock-aligned MeterValues; 0 disables. |
| ConnectionTimeOut | RW | integer | 60 | — | Seconds to wait for a transaction response before timing out. |
| ConnectorPhaseRotation | RO | CSL | NotApplicable | — | Phase rotation per connector. |
| GetConfigurationMaxKeys | RW | integer | 50 | — | Max keys returned in one GetConfiguration response. |
| HeartbeatInterval | RW | integer | 300 | — | Seconds between Heartbeat messages. |
| LocalAuthorizeOffline | RW | boolean | true | true / false | Allow locally cached idTags to authorize while offline. |
| LocalPreAuthorize | RW | boolean | false | true / false | Use a cached Accepted authorization to pre-authorize a transaction. |
| MeterValuesAlignedData | RO | CSL | see note below | — | Measurands sent in clock-aligned MeterValues. |
| MeterValuesSampledData | RO | CSL | see note below | — | Measurands sent in periodic sampled MeterValues. |
| MeterValueSampleInterval | RW | integer | 60 | ≥ 60 | Seconds between sampled MeterValues (values below 60 are rejected). |
| NumberOfConnectors | RO | integer | 1 | — | Number of connectors on the charge point. |
| ResetRetries | RW | integer | 1 | < 5 | Reset retry attempts (5 or more rejected). |
| StopTransactionOnEVSideDisconnect | RW | boolean | true | true / false | Stop the transaction automatically when the EV disconnects the cable. |
| StopTransactionOnInvalidId | RW | boolean | true | true / false | Stop the transaction if an invalid idTag is presented. |
| StopTxnAlignedData | RO | CSL | Energy.Active.Import.Register | — | Measurands in a StopTransaction’s clock-aligned data. |
| StopTxnSampledData | RO | CSL | Energy.Active.Import.Register | — | Measurands in a StopTransaction’s sampled data. |
| SupportedFeatureProfiles | RO | CSL | Core, FirmwareManagement, LocalAuthListManagement, Reservation, RemoteTrigger, SmartCharging | — | OCPP feature profiles the charger implements. |
| SupportedFeatureProfilesMaxLength | RO | integer | 15 | — | Max string length of SupportedFeatureProfiles. |
| TransactionMessageAttempts | RW | integer | 3 | < 5 | Transaction-message retry attempts (5 or more rejected). |
| TransactionMessageRetryInterval | RW | integer | 30 | ≤ 180 | Seconds between transaction-message retries (above 180 rejected). |
| UnlockConnectorOnEVSideDisconnect | RW | boolean | true | true / false | Auto-unlock the connector when the EV disconnects. |
| AuthorizationCacheEnabled | RW | boolean | true | true / false | Use the local authorization cache. |
| AllowOfflineTxForUnknownId | RW | boolean | false | true / false | Allow an idTag not present locally to start a transaction while offline. |
Local Authorization List
Section titled “Local Authorization List”| Key | Access | Type | Default | Description |
|---|---|---|---|---|
| LocalAuthListEnabled | RO | boolean | true | Local Authorization List feature enabled. |
| LocalAuthListMaxLength | RO | integer | 1000 | Max entries the Local Auth List can hold. |
| SendLocalListMaxLength | RO | integer | 30 | Max entries per SendLocalList. |
| ReserveConnectorZeroSupported | RO | boolean | false | Whether connector 0 can be reserved. |
Smart Charging
Section titled “Smart Charging”| Key | Access | Type | Default | Description |
|---|---|---|---|---|
| ChargeProfileMaxStackLevel | RO | integer | 5 | Max stack level accepted for a charging profile. |
| ChargingScheduleMaxPeriods | RO | integer | 8 | Max periods in a single charging schedule. |
| MaxChargingProfilesInstalled | RO | integer | 5 | Max charging profiles stored simultaneously. |
| ChargingScheduleAllowedChargingRateUnit | RO | string | Current | Allowed charging-rate unit (Current / Power). |
| ConnectorSwitch3to1PhaseSupported | RO | boolean | false | Whether the connector supports 3↔1-phase switching. |
BRIGHTBLU custom keys
Section titled “BRIGHTBLU custom keys”Vendor-specific keys, not part of standard OCPP 1.6.
| Key | Access | Type | Default | Accepted values | Description |
|---|---|---|---|---|---|
| Freemode | RW | boolean | false | true / false | Plug-and-play mode — a session can start without idTag authorization. |
| NetworkStatusLED | RW | boolean | false | true / false | Enable the white network-type flash on the Available LED (1 = WiFi, 2 = SIM, 3 = LAN). See LED status. Business / HomePlus. |
| DefaultIdTag | RW | string | device-specific (derived from the device ID at first boot) | — | The idTag used for Freemode / default-authorization sessions. |
| MaxCurrentLimit(A) | RW | integer | model-dependent (32 A on 22 kW builds, 16 A on 11 kW builds) | 6–32 | Charging current cap in amps; applied immediately on change. |
| OcppServerAddress | RW | string | site-specific (unset until configured) | valid ws:// or wss:// URL, port required | The OCPP backend (CSMS) WebSocket URL. The URL must include a port, even the default (ws://host:80/path, wss://host:443/path). Reboot required. |
| OcppChargerId | RW | string | device-specific (BB + MAC, generated at first boot) | — | Charge-point identity used in the OCPP URL and BootNotification. Reboot required. |
| WiFiSsid | RW | string | N/A | — | SSID to join when the unit uses WiFi instead of the cellular SIM. |
| WiFiPass | WO | string | N/A | — | WiFi password. GetConfiguration masks it (***********), so it is effectively write-only. |
| WiFiConnect | RW | boolean | false | true / false | Switch the active network to WiFi (true) or SIM (false). Only accepted once WiFiSsid and WiFiPass are set. Reboot required. |
| OnPowerLossRestart | RW | boolean | false | true / false | Whether the unit auto-resumes on power-loss recovery. |
| suspendedEVTimeout | RW | integer | 900 | — | Seconds to wait in the SuspendedEV state before acting on the session. |
Write-only keys
Section titled “Write-only keys”- AuthorizationKey — standard OCPP 1.6 security key: the HTTP Basic-Auth password used for the WebSocket connection. Accepted by
ChangeConfiguration, never returned byGetConfiguration. - WiFiPass — returned by
GetConfigurationonly as a mask (***********); the real value is never disclosed.