Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Info
iconfalse
This page is deprecated. Latest UI documentation is available here

Table of Contents
include.*

...

This version of the RDK release has a revamped version of the RDK application framework, which provides rdkservicesprovides RDKServices to access all the functionalities provided by the RDK platform. In additionAlso, it includes RDKShell, an application manager that handles application lifecycle, input control, and graphics composition.  

This release also features the reference user interface, which demonstrates the capabilities of rdkservicesof RDKServices. 

Accelerator Home UI 

Accelerator Home UI is a lightning Lightning application which that allows users to manage apps, Bluetooth, and WIFI settings 

...

You will be prompted to the below screen if the Bluetooth remote is not connected to the device 

You will be prompted to the below screen if the network is not connected to the device. To connect to the WIFI network, please refer to the section ‘Connect to WIFI’ available in this documentation 

Image Removed

You can switch to Full HD mode if needed 

Image Removed

Home Screen 

The home screen contains sections for apps, tv shows, and settings. YouTube and the metrological app can be launched from app listings. Video content can be played from the TV Shows section. Bluetooth and WIFI settings can be managed from the settings section. Search bar and time display are also available in the home UI. As of now, functionalities with the search bar and mic are not implemented. 

Note: The user should set the timezone in you STB before loading the UI using the curl command

curl -X POST -H "Content-Type: application/json" 'http://127.0.0.1:9998/jsonrpc' -d '{"jsonrpc":"2.0","id":"3","method":"org.rdk.System.1.setTimeZoneDST","params":{"timeZone":"Asia/Kolkata"}}';echo

If the timezone is not properly set in the box the UI by default shows Eastern Standard Time.

  1. Use the Enter/Right key from the side panel icon to move the focus to apps/tv-shows/settings 
  2. Use Left/Right/Up/Down keys to navigate within the home UI

...

The first row in the main view of home UI contains app listings. YouTube, Metrological, Xumo,, and Xumo Bluetooth Audio app can be launched from app listings .'Premium Content 4' will not launch any apps.

  1. Use the Left and Right key to navigate through the app listings
  2. Use the Enter key from the tiles in the first row to launch apps 
  3. Use M/Home/1 key to exit from the launched apps

...

  1. Use the Left and Right key to navigate through tv-shows  
  2. Use the Enter key from the tiles in the tv show listings to launch the player 
  3. Use M/Home/1 key to exit from playback
  4. Use the Enter key in the Pause icon to pause the video. Fast-forward and rewind are not supported in the current video(as the video content is not an I-framed one

Image RemovedImage Added

Settings list 

...

  1. Use the Enter key in the WIFI thumbnail to launch WIFI Screen. It will scan for available SSID’s
  2. Use the Up and Down arrow keys to navigate through available networks. 
  3. Use the Enter key to select a particular network.  
  4. Connect to an SSID by providing the password for the network

Note: If we turn on Wi-Fi the default interface is set to Wi-Fi even though the ethernet cable is connected. The terminal won't be accessible in this case.

Connect to Bluetooth 

The Bluetooth screen supports discovery, pairing, and connecting to Bluetooth devices. 

  1. Use the Enter key in the Bluetooth thumbnail to launch Bluetooth Screen. It will scan for available HID devices
  2. Use the Up and Down arrow keys to navigate through the available HID devices. 
  3. Use the Enter key to select and pair an HID device.  

Key Handling

KeyFunctionality
S keyTo display UI Switch screen from the splash screen
Enter key/Right arrowTo move the focus to app list/tv-shows/settings from side panel icons in Home UI
Enter key

To select the UI from the UI Switch screen

To launch apps from the app list

To launch player from tv-shows

To launch the Bluetooth screen from the settings list

To launch the WiFi screen from the settings list

To enable/disable Bluetooth scanning in Bluetooth screen

To enable/disable wifi scanning in wifi screen

To pause player from Player controls

To connect/disconnect/pair/unpair a Bluetooth device from the Bluetooth screen

To connect/disconnect a WiFi network inWiFi screen

Left/Right/Up/Down arrow

To navigate within Home UI

To navigate through available Bluetooth devices on the Bluetooth screen

To navigate through available wifi networks in WiFi screen

M/Home/1 key

To exit from apps 

To exit from player launched

To exit from the Bluetooth screen

To exit from the WiFi screen

Esc/M keyTo exit from password panel on WiFi screen
Down arrowTo display player controls menu from Player screen
key Code : 27 , 77, 49 , 36 ,158 To display Home Page
key Code : 112,142To STANDBY and POWER_ON
key Code : 228 , 116 To deep sleep
key Code 175 174To audio increase  and decrease


Load partnerapps 

  1. Mount USB
  2. Restart the service (`systemctl restart referenceApp`) 

...

User can update the apps list by specifying the config file in `/opt/appmanagerregistry.conf` 

...

Note: Right now it supports only lightning Lightning apps as startup app.

Steps to build and launch Accelerator Home UI 

  • Prerequisites - Node.js , npm, Lightning-CLI should be available in PC

-To install Node.js and npm  - https://nodejs.org/en/download/

-To install Lightning CLI -  npm install -g @lightningjs/cli

  • Clone the RDKAPPS repo using the below command in git bash

git clone "https://code.rdkcentral.com/r/components/opensource/RDK_apps"

  • Move to accelerator-home-ui project

cd RDK_apps/accelerator-home-ui/

  • Install npm dependencies

npm install

  • Build your project

lng build

  • Copy the build folder created to /opt/www directory of your RPI/Accelerator device and Launch the app using ResidentApp plugin in RPI/Accelerator device via console

curl -X POST -H "Content-Type: application/json" 'http://127.0.0.1:9998/jsonrpc' -d ' {"jsonrpc":"2.0", "id":3, "method":"org.rdk.RDKShell.1.launch", "params":{"callsign": "ResidentApp", "type":"ResidentApp", "uri": "http://127.0.0.1:50050/build/index.html#splash"}} ' ; echo 

Note: You can also deploy your app locally in your PC and launch the app using ResidentApp plugin in RPI/Accelerator device .But your PC(where app is deployed) and the RPI/Accelerator device has to be under same network

  • Deploy app in PC

lng dev

  • Launch the app using ResidentApp plugin in RPI/Accelerator device via console (Replace the uri parameter in below command with the deployed URL of your app)

curl -X POST -H "Content-Type: application/json" 'http://127.0.0.1:9998/jsonrpc' -d ' {"jsonrpc":"2.0", "id":3, "method":"org.rdk.RDKShell.1.launch", "params":{"callsign": "ResidentApp", "type":"ResidentApp", "uri": "https://rdkwiki.com/rdk-apps/accelerator-home-ui/index.html#splash"}} ' ; echo 


Note: The user should set the timezone in you STB before loading the UI using the curl command

curl -X POST -H "Content-Type: application/json" 'http://127.0.0.1:9998/jsonrpc' -d '{"jsonrpc":"2.0","id":"3","method":"org.rdk.System.1.setTimeZoneDST","params":{"timeZone":"Asia/Kolkata"}}';echo

If the timezone is not properly set in the box the UI by default shows Eastern Standard Time.

Controller UI 

Users can interact with plugins using Controller UI. It helps the user to activate or deactivate the plugin and the user can go through each plugin and look for properties and methods to execute. 

...

Interactions with ResidentApp plugin 

  1. Activate the plugin from the Controller tab
  2. Go to the ResidentApp plugin tab
  3. You can see all properties and methods for ResidentApp
  4. Ex. User can set different URL to load 

...