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
JavaSE Guides
Connecting to an Infotainment System

Connecting to an Infotainment System

In order to view your SDL app, you must connect your device to a head unit that supports SDL Core. If you do not have access to a head unit, we recommend using the Manticore web-based emulator for testing how your SDL app reacts to real-world vehicle events, on-screen interactions and voice recognition.

Your SDL embedded app will only work with head units that support RPC Spec v5.1+.

Configuring the Connection

Generic SDL Core

To connect to your app to a local Ubuntu SDL Core-based emulator you need to know the IP address of the machine that is running the cloud app. If needed, running ifconfig in the terminal will give you the current network configuration information.

Policy Table Configuration

Once you know the IP address, you need to set the websocket endpoint and app nicknames for your SDL app in the policy table under the "app_policies" section. This will let Core know where your instance of the SDL app is running. The websocket endpoint needs to include both the IP address and port: ws://<ip address>:<port>/.

 "<Your SDL App ID>": {
     "keep_context": false,
     "steal_focus": false,
     "priority": "NONE",
     "default_hmi": "NONE",
     "groups": ["Base-4"],
     "RequestType": [],
     "RequestSubType": [],
     "hybrid_app_preference": "CLOUD",
     "endpoint": "ws://<ip address>:<port>",
     "enabled": true,
     "auth_token": "",
     "cloud_transport_type": "WS",
     "nicknames": ["<app name>"]

The <app name> value in "nicknames" must match the app name value used in Integration Basics when implementing the SDL manager.

For more information about policy tables please visit the Policy Table guide.


If you are using Manticore, the app connection information can be easily added in the settings tab of the Manticore web page. Please note that Manticore needs to access your machine's IP address in order to be able to start a websocket connection with your app. If you are hosting the app on your local machine, you may need to do extra setup to make your machine publicly accessible.

Manticore - Cloud and Embedded App Settings

Running the SDL App

Once you have a configured instance of Core running, you should see your SDL app name appear in a box on HMI. However, nothing will happen when you tap on the box until you build and run your SDL app.

Generic - SDL Apps Tab

Once your SDL app is running, either locally in an IDE or on a server, you will be able to launch the SDL app by clicking on the app icon in the HMI.

Generic - SDL App Main Screen

This is the main screen of your SDL app. If you get to this point, your SDL app is working.

View on GitHub.com
Previous Section Next Section