Expand Minimize Picture-in-picture Power Device Status Voice Recognition Skip Back Skip Forward Minus Plus Play Search
Internet Explorer alert
This browser is not recommended for use with smartdevicelink.com, and may not function properly. Upgrade to a different browser to guarantee support of all features.
close alert
To Top Created with Sketch. To Top
To Bottom Created with Sketch. To Bottom
HMI Documentation


Obtain current UTC time

When an application needs to start a protected service with SDL core the app sends a certificate to SDL during the TLS or DTLS handshake process.
In order to validate the certificate and to check whether this certificate is not expired SDL core needs an accurate UTC system time value.


SDL sends a GetSystemTime request after receiving a BC.OnSystemTimeReady notification from the HMI.
After sending the request SDL starts <DefaultTimeout> (value from .ini file) waiting for response from HMI.


This RPC has no additional parameter requirements


  1. Send a valid response during the <DefaultTimeout>(value from the smartDeviceLink.ini file)
  2. Provide all parameters of the "DateTime" struct inside of the GetSystemTime response.

SDL logs the corresponding error internally and fails the handshake process if at least one of the following failures occurs:
1. HMI does NOT respond during <DefaultTimeout>;
2. HMI responds with any <errorCode> during <DefaultTimeout>;
3. HMI sends invalid for any reason in the response:
a. at least one String param is empty (exception: in case empty String param is allowed by HMI_API)
b. at least one String param has '\n', '\t' or completely white-space
c. wrong json format
d. at least one param has invalid type
e. at least one mandatory param was omitted
f. at least one param is out of bounds

If the handshake process fails, SDL behavior depends on the "ForceProtectedService"/"ForceUnprotectedService" params configured in the 'Security Manager' section of the smartDeviceLink.ini file.


Name Type Mandatory Description
systemTime Common.DateTime true Current UTC system time

Sequence Diagrams

JSON Message Examples

Example Request

  "id" : 59546,
  "jsonrpc" : "2.0",
  "method" : "BasicCommunication.GetSystemTime"

Example Response

      "systemTime": {  

Example Error

      "message":"Mandatory parameters not provided.",
View on GitHub.com
Previous Section Next Section