Skip to main content

CSMS Actions

A comprehensive guide to all TimeTick CSMS actions used for hardware testing.

Updated yesterday

"NOTE: These actions wait for 10 minutes and if nothing will be received - the action will be failed (because of the timeout)"

  1. Remote: Cancel Reservation - Cancels an existing reservation. Choose the simulator with protocol in the "Requirements" dropdown.
    ​
    Parameters: Reservation ID - The identifier of the reservation to be canceled.
    ​
    Response: Execution status:
    - Accepted (there is a reservation matching the reservationId.
    - Rejected
    ​

  2. Remote: Change Availability - Changes the availability of the charging station. Choose the simulator with protocol in the "Requirements" dropdown.
    ​
    Parameters: Status: Type of change (Inoperative, Operative), Connector Id
    ​
    Response: Execution status:
    - Accepted (the CSMS requests a change of the charging station's status to the one it is already in) - Scheduled (when a transaction is in progress, to indicate that the change is scheduled to occur after the transaction has finished)
    ​

  3. Remote: Change Configuration - Changes the configuration of the charging station. Choose the simulator with protocol in the "Requirements" dropdown.
    ​
    Parameters: key: Configuration parameter name; value: New value.
    ​
    Response: Execution status:
    - Accepted (If the change was applied successfully, and the change if effective immediately)
    - RebootRequired (If the change was applied successfully, but a reboot is needed to make it effective)
    - NotSupported (If "key" does not correspond to a configuration setting supported by Charge Point)
    - Rejected (If the Charge Point did not set the configuration, and none of the previous statuses applies)
    ​

  4. Remote: Clear Cache - Clears the local data cache on the station. Choose the simulator with protocol in the "Requirements" dropdown.
    ​
    Parameters: No required parameters.
    ​
    Response: Execution status:
    - Accepted (if the Charge Point has executed the request)
    - Rejected (Command will not be executed)
    ​

  5. Remote: Clear Charging Profile - Deletes an existing charging profile. Choose the simulator with protocol in the "Requirements" dropdown.
    ​
    Parameters:
    - connectorId,
    - chargingProfilePurpose (Specifies to purpose of the charging profiles that will be cleared, if they meet the other criteria in the request),
    - stackLevel (specifies the stackLevel for which charging profiles will be cleared, if they meet the other criteria in the request)
    ​
    Response: Execution status:
    - Accepted (Request has been accepted and will be executed)
    - Unknown (No Charging Profile(s) were found matching the request)
    ​

  6. Remote: Data Transfer - Transfers arbitrary data between the CSMS and the station. Choose the simulator with protocol in the "Requirements" dropdown.
    ​
    Parameters:
    - vendorId,
    - messageId (Additional identification field),
    - data (Data without specified length or format).
    ​
    Response: Execution status:
    - UnknownVendor (if the recipient of the request has no implementation for the specific vendorId)
    - UnknownMessageId (in case of a messageId mismatch (if used))
    - Accepted (message has been accepted and the contained request is accepted)
    - Rejected (message has been accepted but the contained request is rejected)

  7. Remote: Get Composite Schedule - Retrieve charging schedules for multiple ports simultaneously. Choose the simulator with protocol in the "Requirements" dropdown.
    ​
    Parameters:
    - connectorId,
    - duration (time in seconds for which the schedule is requested),
    - unit (Can be used to force a power or current profile)
    ​
    Response: Execution status:
    - Accepted (request has been accepted and will be executed)
    - Rejected (request has not been accepted and will not be executed)
    ​

  8. Remote: Get Configuration - Retrieve the current settings of the station. Choose the simulator with protocol in the "Requirements" dropdown.
    ​
    Parameters: key - The name of a specific parameter.
    "NOTE: If not specified — all settings are returned."
    ​
    Response: Execution status:
    - configurationKey (list of requested or known keys)
    - unknownKey (requested keys that are unknown)
    ​

  9. Remote: Get Diagnostics - Request station diagnostics to troubleshoot issues. Choose the simulator with protocol in the "Requirements" dropdown.
    ​
    Parameters:
    - location (This contains the location (directory) where the diagnostics file shall
    be uploaded to),
    - retries (This specifies how many times Charge Point must try to upload the
    diagnostics before giving up. If this field is not present, it is left to Charge Point
    to decide how many times it wants to retry),
    - retryInterval (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)
    - startTime (This contains the date and time of the oldest logging information to include in the diagnostics)
    - stopTime (This contains the date and time of the latest logging information to include in the diagnostics)
    ​
    Response: Execution status:

    - fileName (This contains the name of the file with diagnostic information that will be uploaded) "NOTE: This field is not present when no diagnostic information is available"
    ​

  10. Remote: Get Local List Version - Retrieve the current version of the local list of authorized active cards. Choose the simulator with protocol in the "Requirements" dropdown.
    ​
    Parameters: No fields are defined.
    ​
    Response: Execution status:
    - listVersion (This contains the current version number of the local authorization list in the Charge Point)
    ​

  11. Remote: Start Transaction - Start a charging session. Choose the simulator with protocol in the "Requirements" dropdown.
    ​
    Parameters:
    - connectorId
    - idTag (The identifier that Charge Point must use to start a transaction)
    - chargingProfile (Charging Profile to be used by the Charge Point for the requested transaction)
    ​
    Response: Execution status:
    - Accepted (Command will be executed)
    - Rejected (Command will not be executed)
    ​

  12. Remote: Stop Transaction - Stop a charging session. Choose the simulator with protocol in the "Requirements" dropdown.
    ​
    Parameters:
    - transactionId (The identifier of the transaction which Charge Point is requested to stop)
    ​
    Response: Execution status:
    - Accepted (Command will be executed)
    - Rejected (Command will not be executed)
    ​

  13. Remote: Reserve Now - Reserve a cable for future use. Choose the simulator with protocol in the "Requirements" dropdown.
    ​
    Parameters:
    - connectorId,
    - expiryDate (This contains the date and time when the reservation ends),
    - idTag (The identifier for which the Charge Point has to reserve a connector),
    - reservationId (Unique id for this reservation)
    ​
    Response: Execution status:
    - Accepted (Reservation has been made)
    - Faulted (Reservation has not been made, because connectors or specified connector are in a faulted state)
    - Occupied (Reservation has not been made. All connectors or the specified connector are occupied)
    - Rejected (Reservation has not been made. Charge Point is not configured to accept reservations)
    ​

  14. Remote: Reset - Reboot the station or reset its state to the initial level. Choose the simulator with protocol in the "Requirements" dropdown.
    ​
    Parameters: type:
    - Hard (Restart (all) the hardware, the Charge Point is not required to gracefully stop ongoing transaction)
    - Soft (Stop ongoing transactions gracefully)
    ​
    Response: Execution status:
    - Accepted (Command will be executed)
    - Rejected (Command will not be executed)
    ​

  15. Remote: Send Local List - Update the local authorization list on the station from the CSMS. Choose the simulator with protocol in the "Requirements" dropdown.
    ​
    Parameters:
    - listVersion (In case of a full update this is the version number of the full list. In case of a differential update it is the version number of the list after the update has been applied)
    - localAuthorizationList (In case of a full update this contains the list of values that form the new local authorization list. In case of a differential update it contains the changes to be applied to the local authorization list in the Charge Point)
    - updateType (This contains the type of update (full or differential) of this request)
    ​
    Response: Execution status:
    - Accepted (Local Authorization List successfully updated)
    - Failed (Failed to update the Local Authorization List)
    ​

  16. Remote: Set Charging Profile - Set or modify the charging profile for a cable/transaction. Choose the simulator with protocol in the "Requirements" dropdown.
    ​
    Parameters:
    - chargingProfileId (Unique identifier for this profile),
    - stackLevel (Value determining level in hierarchy stack of profiles. Higher values have precedence over lower values. Lowest level is 0),
    - chargingProfilePurpose (Defines the purpose of the schedule transferred by this message),
    - chargingProfileKind (Indicates the kind of schedule),
    - validFrom (Point in time at which the profile starts to be valid),
    - validTo (Point in time at which the profile stops to be valid),
    - chargingSchedule (Contains limits for the available power or current over time)
    ​
    Response: Execution status:
    - Accepted (Request has been accepted and will be executed)
    - Rejected (Request has not been accepted and will not be executed,
    - NotSupported (Charge Point indicates that the request is not supported)
    ​

  17. Remote: Trigger Message - Send a message to the station for display or logging. Choose the simulator with protocol in the "Requirements" dropdown.
    ​
    Parameters:
    - requestedMessage - You need to choose (BootNotification, DiagnosticsStatusNotification, FirmwareStatusNotification, Heartbeat, MeterValues, StatusNotification),
    - connectorId
    ​
    Response: Execution status:
    - Accepted (Requested notification will be sent)
    - Rejected (Requested notification will not be sent)
    - NotImplemented (Requested notification cannot be sent because it is either not implemented or unknown)
    ​

  18. Remote: Unlock Connector - Unlock the cable after transaction completion or upon request. Choose the simulator with protocol in the "Requirements" dropdown.
    ​
    Parameters:
    - connectorId
    ​
    Response: Execution status:
    - Unlocked (Connector has successfully been unlocked)
    - UnlockFailed (Failed to unlock the connector: The Charge Point has tried to unlock the connector and has detected that the connector is still locked or the unlock mechanism failed)
    - NotSupported (Charge Point has no connector lock, or ConnectorId is unknown)
    ​

  19. Remote: Update Firmware - Firmware update of the station. Choose the simulator with protocol in the "Requirements" dropdown.
    ​
    Parameters:
    - location URL (This contains a string containing a URI pointing to a location from which to retrieve the firmware),
    - retries (This specifies how many times Charge Point must try to download the firmware before giving up),
    - retrieveDate (This contains the date and time after which the Charge Point is allowed to retrieve the (new) firmware),
    - retryInterval (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)
    ​
    Response: Execution status:
    - Installed (The firmware has been successfully installed)

Did this answer your question?