Skip to content

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 ChangeConfiguration and returned by GetConfiguration.
  • RO — returned by GetConfiguration but not writable (a ChangeConfiguration attempt is rejected).
  • WO — accepted by ChangeConfiguration but never returned (or masked) by GetConfiguration.
KeyAccessTypeDefaultAccepted valuesDescription
AuthorizeRemoteTxRequestsRWbooleanfalsetrue / falseRequire an Authorize before a RemoteStartTransaction is accepted.
ClockAlignedDataIntervalRWinteger0Interval (s) for clock-aligned MeterValues; 0 disables.
ConnectionTimeOutRWinteger60Seconds to wait for a transaction response before timing out.
ConnectorPhaseRotationROCSLNotApplicablePhase rotation per connector.
GetConfigurationMaxKeysRWinteger50Max keys returned in one GetConfiguration response.
HeartbeatIntervalRWinteger300Seconds between Heartbeat messages.
LocalAuthorizeOfflineRWbooleantruetrue / falseAllow locally cached idTags to authorize while offline.
LocalPreAuthorizeRWbooleanfalsetrue / falseUse a cached Accepted authorization to pre-authorize a transaction.
MeterValuesAlignedDataROCSLsee note belowMeasurands sent in clock-aligned MeterValues.
MeterValuesSampledDataROCSLsee note belowMeasurands sent in periodic sampled MeterValues.
MeterValueSampleIntervalRWinteger60≥ 60Seconds between sampled MeterValues (values below 60 are rejected).
NumberOfConnectorsROinteger1Number of connectors on the charge point.
ResetRetriesRWinteger1< 5Reset retry attempts (5 or more rejected).
StopTransactionOnEVSideDisconnectRWbooleantruetrue / falseStop the transaction automatically when the EV disconnects the cable.
StopTransactionOnInvalidIdRWbooleantruetrue / falseStop the transaction if an invalid idTag is presented.
StopTxnAlignedDataROCSLEnergy.Active.Import.RegisterMeasurands in a StopTransaction’s clock-aligned data.
StopTxnSampledDataROCSLEnergy.Active.Import.RegisterMeasurands in a StopTransaction’s sampled data.
SupportedFeatureProfilesROCSLCore, FirmwareManagement, LocalAuthListManagement, Reservation, RemoteTrigger, SmartChargingOCPP feature profiles the charger implements.
SupportedFeatureProfilesMaxLengthROinteger15Max string length of SupportedFeatureProfiles.
TransactionMessageAttemptsRWinteger3< 5Transaction-message retry attempts (5 or more rejected).
TransactionMessageRetryIntervalRWinteger30≤ 180Seconds between transaction-message retries (above 180 rejected).
UnlockConnectorOnEVSideDisconnectRWbooleantruetrue / falseAuto-unlock the connector when the EV disconnects.
AuthorizationCacheEnabledRWbooleantruetrue / falseUse the local authorization cache.
AllowOfflineTxForUnknownIdRWbooleanfalsetrue / falseAllow an idTag not present locally to start a transaction while offline.
KeyAccessTypeDefaultDescription
LocalAuthListEnabledRObooleantrueLocal Authorization List feature enabled.
LocalAuthListMaxLengthROinteger1000Max entries the Local Auth List can hold.
SendLocalListMaxLengthROinteger30Max entries per SendLocalList.
ReserveConnectorZeroSupportedRObooleanfalseWhether connector 0 can be reserved.
KeyAccessTypeDefaultDescription
ChargeProfileMaxStackLevelROinteger5Max stack level accepted for a charging profile.
ChargingScheduleMaxPeriodsROinteger8Max periods in a single charging schedule.
MaxChargingProfilesInstalledROinteger5Max charging profiles stored simultaneously.
ChargingScheduleAllowedChargingRateUnitROstringCurrentAllowed charging-rate unit (Current / Power).
ConnectorSwitch3to1PhaseSupportedRObooleanfalseWhether the connector supports 3↔1-phase switching.

Vendor-specific keys, not part of standard OCPP 1.6.

KeyAccessTypeDefaultAccepted valuesDescription
FreemodeRWbooleanfalsetrue / falsePlug-and-play mode — a session can start without idTag authorization.
NetworkStatusLEDRWbooleanfalsetrue / falseEnable the white network-type flash on the Available LED (1 = WiFi, 2 = SIM, 3 = LAN). See LED status. Business / HomePlus.
DefaultIdTagRWstringdevice-specific (derived from the device ID at first boot)The idTag used for Freemode / default-authorization sessions.
MaxCurrentLimit(A)RWintegermodel-dependent (32 A on 22 kW builds, 16 A on 11 kW builds)6–32Charging current cap in amps; applied immediately on change.
OcppServerAddressRWstringsite-specific (unset until configured)valid ws:// or wss:// URL, port requiredThe OCPP backend (CSMS) WebSocket URL. The URL must include a port, even the default (ws://host:80/path, wss://host:443/path). Reboot required.
OcppChargerIdRWstringdevice-specific (BB + MAC, generated at first boot)Charge-point identity used in the OCPP URL and BootNotification. Reboot required.
WiFiSsidRWstringN/ASSID to join when the unit uses WiFi instead of the cellular SIM.
WiFiPassWOstringN/AWiFi password. GetConfiguration masks it (***********), so it is effectively write-only.
WiFiConnectRWbooleanfalsetrue / falseSwitch the active network to WiFi (true) or SIM (false). Only accepted once WiFiSsid and WiFiPass are set. Reboot required.
OnPowerLossRestartRWbooleanfalsetrue / falseWhether the unit auto-resumes on power-loss recovery.
suspendedEVTimeoutRWinteger900Seconds to wait in the SuspendedEV state before acting on the session.
  • AuthorizationKey — standard OCPP 1.6 security key: the HTTP Basic-Auth password used for the WebSocket connection. Accepted by ChangeConfiguration, never returned by GetConfiguration.
  • WiFiPass — returned by GetConfiguration only as a mask (***********); the real value is never disclosed.