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


Emulate button press event on HMI for the common climate or radio control buttons in vehicle

ButtonPress represents a request from an application to change settings of requested RC module by pressing the appropriate button.
This RPC can be sent to the HMI from an application that is registered with REMOTE_CONTROL appHMIType and in one of the following states: FULL, LIMITED, BACKGROUND.
Module signed by the application in such request has to be available on HMI and allowed for control change settings.
The system shall list all available RC radio buttons and RC climate buttons in the existing ButtonCapabilities list.

  1. Modules sent by application must be available on HMI.
  2. Access to control module settings is defined by access mode entered by user on HMI.
  3. Requested control buttons have to be available for such module on HMI.
  4. HMI must send BC.OnResetTimeout notification to SDL to reset the timeout in case it needs more time to process the request.



Name Type Mandatory Additional Description
moduleType Common.ModuleType true The module where the button should be pressed
moduleId String false maxlength: 100 Id of a module, published by System Capability.
buttonName Common.ButtonName true
buttonPressMode Common.ButtonPressMode true Indicates whether this is a LONG or SHORT button press event.
appID Integer true Internal SDL-assigned ID of the related application



This RPC has no additional parameter requirements

Sequence Diagrams

JSON Message Examples

Example Request

    "id": 32,
    "jsonrpc": "2.0",
    "method": "Buttons.ButtonPress",
    "params": {
        "appID": 680015438,
        "buttonName": "VOLUME_UP",
        "buttonPressMode": "LONG",
        "moduleId" : "12jie32ice496hnr68swe",
        "moduleType": "RADIO"

Example Response

    "id": 32,
    "jsonrpc": "2.0",
    "result": {
        "code": 0,
        "method": "Buttons.ButtonPress"

Example Error

  "id" : 32,
  "jsonrpc" : "2.0",
  "error" :
    "code" : 22,
    "message" : "An unknown issue occurred ",
    "data" :
      "method" : "Buttons.ButtonPress"
View on GitHub.com
Previous Section Next Section