3.24 Send Local List

The SendLocalList message in OCPP 1.6J is used by the central system to send or update a local authorization list on the charge point. This list contains authorized user IDs (such as RFID tags). The message includes the list's version and specifies whether it is a complete update or an addition. The charge point responds to confirm whether the list was successfully updated. This helps manage user access to the charge point.


API Syntax	Description	Input Params	Return Value
SetSendLocalListStatus	Sets the status of the Send Local List response.	SEND_LOCAL_LIST_STATUS_T status	void

Example:

    if (sendLocalListFailFlag == true)
    {
      SetSendLocalListStatus(SEND_LOCAL_LIST_FAILED);
      LogDebug("APP_LOG", " SendLocalList request Failed\n");
    }
    else if (responsecode == SEND_LOCAL_LIST_ACCEPTED)
    {
      SetSendLocalListStatus(SEND_LOCAL_LIST_ACCEPTED);
      LogDebug("APP_LOG", " SendLocalList request accepted\n");
    }


API Syntax	Description	Input Params	Return Value
SendLocalListInit	Initializes the Send Local List response structure.	void	void

Example:

void OCPPMessagesInit(void)
{
    DataTransferInit();
    ResetInit();
    MeterValueStructInit();
    SetLocalListVersionNumber(DEFAULT_SEND_LOCAL_LIST_VERSION);   
    SetChargePointConnectorId(CHARGEPOINT_DEFAULT_CONTROLLER);
    ChargePointStatusInit();
    (void)SetAuthorizeStatus(AUTHORIZE_INVALID);
    SetOCPPWebsocketOnlineMode();
    UnlockConnectorInit();
    ReserveNowInit();
    ChangeAvailabilityInit();
    ClearCacheInit();
    ChangeConfigurationInit();
    CancelReservationInit();
    GetAllIDsFromDB();
    CheckAndStartClockAlignedMeterValueTimer();
    ClearChargingProfileInit();
    GetCompositeScheduleInit();
    GetLocalListVersionInit();
    SendLocalListInit();
    SetChargingProfileInit();
    TriggerMessageInit();
    RemoteStopTransactionInit();
    RemoteStartTransactionInit();
}


API Syntax	Description	Input Params	Return Value
GetSendLocalListParams	Retrieves the parameters from the global Send Local List structure.	RX_SENDLOCALLIST_T *params	void

Example:

  case SEND_LOCALLIST:
  {
    RX_SENDLOCALLIST_T params;
    GetSendLocalListParams(&params);
    LogDebug("APP_LOG", " SendLocalList Params listVersion: %d updateType: %d \n", params.listVersion, params.updateType);

    /* Sending send local list failed for the test case TC_043_3_CS */


Syntax	Description	Constants/Members
SENDLOCALLIST_RESPONSE_T	Structure defining the response for sending a local list	SEND_LOCAL_LIST_STATUS_T status
RX_SENDLOCALLIST_T	Structure defining the request for sending a local list	char uuid[]; int listVersion; uint16_t taglocallistlen; TAGLOCALLIST_T taglocallist[]; UPDATE_TYPE_T updateType;
TAGLOCALLIST_T	Structure defining a tag in the local list	idToken tagid[]; TAGLOCALLISTINFO_T taginfo; uint8_t delete;
TAGLOCALLISTINFO_T	Structure defining information about a tag in the local list	char status[]; char expiryDate[]; char parentIdTag[];
SEND_LOCAL_LIST_STATUS_T	Enumeration defining possible statuses for sending local lists	SEND_LOCAL_LIST_ACCEPTED, SEND_LOCAL_LIST_FAILED, SEND_LOCAL_LIST_NOT_SUPPORTED, SEND_LOCAL_LIST_VERSION_MISMATCHED, SEND_LOCAL_LIST_MISSING_LIST_VERSION, SEND_LOCAL_LIST_MISSING_UPDATE_TYPE.
UPDATE_TYPE_T	Enumeration defining possible update types for sending local lists	UPDATETYPE_DIFFERENTIAL, UPDATETYPE_FULL