The tvlabs connect command uses the Tizen SDK to connect with Samsung devices on the TV Labs platform as if they were in front of you.
Prerequisites
Ensure that Tizen Studio is installed following the instructions given by the Tizen Developer documentation, and sdb and tizen are in your PATH.
Connecting
After the Tizen Studio and the SDK is installed, start a Tizen session on TV Labs and run tvlabs connect.
Once tvlabs connect has successfully created a vendor connection, run sdb devices to check that the device is connected properly. The Tizen device should appear in the list of devices as 127.0.0.1:26101.
Port Mapping
The port mapping when tvlabs connect is running and connected to a Tizen session is as follows:
- Local port 26101 to Tizen device port 26101 (Samsung Debug Bridge interface)
- Local port 9222 to dynamic inspector port when Web Inspector is started
Certificates
To run your application on the TV Labs device, please ensure that you have a certificate to sign your application with. If you already have a certificate, you can skip ahead to Installing.
If you have not created a certificate, please create one now. As of Tizen CLI 2.5.25, a certificate can be created with the following commands:
tizen certificate -a tvlabs -p tvlabsdev -f tvlabs
tizen security-profiles add -n TVLabs -a /path/to/tizen-studio-data/keystore/author/tvlabs.p12 -p tvlabsdev
tizen cli-config "profiles.path=/path/to/tizen-studio-data/profile/profiles.xml"
Replace the /path/to/tizen-studio-data portion with the path to your Tizen Studio data folder.
See the Tizen documentation about creating certificates for further information.
The certificate can now be used to sign your Tizen application when packaging:
tizen build -- /path/to/application
tizen package --type wgt --sign TVLabs -- /path/to/application/.buildResult
Replace the /path/to/application portion with the path to your application.
Installing
Once your application has been built and packaged using your certificate, you will be able to install and run your Tizen app on the device by running tizen install -n application.wgt. The installation command will output your application ID. You can then use tizen run -p <application id> to start the application.
Web Inspector
The Chrome web inspector is available to use on Tizen with web applications. Before beginning, ensure that Chrome is installed.
To start the inspector, the tvlabs connect command must know the ID of your application you are targeting. Provide it with --application-id or -a.
tvlabs connect -a AvsPHsIO4r.HelloTVLabs
After the vendor connection is made and your application is installed, press "d" to launch the inspector.
Once the inspector is active, navigate to chrome://inspect within the Chrome browser. The device will appear on this page.
If nothing appears in the inspector list, please check the tvlabs connect UI for errors. If there are no errors, ensure that your development application is open and running.
The Tizen inspector runs on port 9222 by default, but can be configured by setting the -i argument.
tvlabs connect -i 5678 -a AvsPHsIO4r.HelloTVLabs
Troubleshooting
If application installation fails, please ensure that the device storage is not full.
If tvlabs connect fails on vendor connection, please ensure that development mode is enabled and the Host PC IP is set to 10.42.1.1.
If tvlabs connect still cannot make a connection after trying these steps, please contact TV Labs for support.