Expand Minimize Picture-in-picture Power Device Status Voice Recognition Skip Back Skip Forward Minus Plus Play Search

Connecting to an Infotainment System

Getting Started

We assume that you have SDL Core (We recommend Ubuntu 16.04) and an HMI set up prior to this point. Most people getting started with this tutorial will be using SDL Core and our Generic HMI. If you don't want to set up a virtual machine for testing, we offer Manticore, which is a free service that allows you to test your apps in the cloud.


SDL Core and an HMI or Manticore are needed to run the cloud app to ensure that it connects.

Configuring Core

To let SDL Core connect to your app, first you will have to know the IP address of the machine that is running the cloud app. If you don't know what it is, running ifconfig in the terminal will usually let you see it for the interface you are connected with to your network.

After getting the IP address, you will have to set App ID, App Websocket Endpoint, and App Nicknames in SDL Core to let it know where your instance of cloud app is running.


The App Websocket Endpoint contains the IP Address and port as the following: ws://<ip address>:<port>/.


If you are using Manticore, the app information can be easily set in the settings tab:

Main Screen


Manticore needs to access you machine's IP address 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. The other solution is to setup Core and HMI on your machine instead of using Manticore so Core can access your local IP address.

SDL Core and Generic HMI

If you are using SDL Core and Generic HMI, you will have to add a policy table entry as the following one to the existing entries:

 "8678309": {
     "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>"]

For more information about policy tables please visit Policy Tables Guides.


Don't forget to replace ws://<ip address>:<port> with your own IP address and app port. Also <app name> should be replaced with the actual app name.

Following this, you should see an application appears on HMI as in the following screenshot:

HMI Apps


Even though you see the app appears on HMI, you still cannot lunch the app at this point. You will have to run the app from IntelliJ IDEA first as described next.

Running the App

After setting the app information in SDL Core, you can run the project in IntelliJ IDEA. The cloud should compile and launch on your machine. After that, you can click on the app icon in the HMI.

HMI Apps

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

View on GitHub.com
Previous Section Next Section