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
OnDeviceStateChanged

OnDeviceStateChanged

Type
Notification
Sender
HMI
Purpose
Inform about BLUETOOTH device state changed

SDL PoliciesManager needs this notification for updating the data in policies database. Information about unpaired device will cause SDL PoliciesManager to remove all data related to it from the database.

Must

Notify SDL when the state of bluetooth paired device has been changed.

Note

SDL ignores all invalid notifications which come from HMI (invalid JSON, invalid data types/bounds etc).
Unpairing of the device is NOT a trigger for new PTU sequence.

Notification

Parameters

Name Type Mandatory Additional
deviceState Common.DeviceState true
deviceInternalId String true minlength: 0
maxlength: 500
deviceId Common.DeviceInfo false

JSON Message Examples

Example Notification

{
  "jsonrpc" : "2.0",
  "method" : "SDL.OnDeviceStateChanged",
  "params" :  
  {
    "deviceInternalId":"0017CAF56A51",
    "deviceState":"UNPAIRED"
  }
}
View on GitHub.com
Previous Section Next Section