Overview

To validate lightning refapp on rdk 4.0 (rdk-generic-hybrid-image-raspberrypi) along with video playback, need to do some necessary code customizations/modifications in lightning refapp side for video player implementation provided by lightning-sdk framework and rdk library side for variable setting and url configurations.

Please follow the below instructions to validate lightning refapp on rdk-generic-hybrid-image.

Prerequisites

Before you follow the steps below, make sure you have installed all the required prerequisites in your dev PC - Node.js , npm, Lightning-CLI

$ npm install -g @lightningjs/cli


reference image for Lightning-CLI install

Build instructions

refer below screenshots for reference

reference images for build instructions-1

reference images for build instructions-2

once npm install complete, you will get message at the end "Do you want us to automatically check for old Lightning-SDK imports and update them in your project files? y/n

press n and hit enter button because on pressing y it gets hanged or stuck, in this case press ctrl+c 


reference images for build instructions-3

reference images for build instructions-4

Running refapp

by default vscode launch generated url on chrome browser in dev pc.

reference image for running app on browser

Download customized pre-build refapp code which has lightning sdk video player integrated: build.zip

(or)


$ lng dist


reference image for dist creation

Hosting Lighting refapp

  1. copy the lighting build app from dist folder.
  2. host build folder into any http server.
  3. test the hosted application on browser 

Lighting refapp integration 


Download pre-build rdk-generic-hybrid-image-raspberrypi image from here: rdk-generic-hybrid-image-raspberrypi-rdk-hybrid.zip

(or)


$ repo init -u https://code.rdkcentral.com/r/manifests -b yocto-dunfell-upgrade -m rdkv-nosrc.xml
$ repo sync -j4 --no-clone-bundle
$ MACHINE=raspberrypi-rdk-hybrid source meta-cmf-raspberrypi/setup-environment
$ bitbake rdk-generic-hybrid-image



# sudo dd if=<r-pi sdimg> of=<SD card device> bs=1M 
  
for ex: # sudo dd if=rdk-mc-rpi.sdimg of=/dev/sdb bs=1M

(or)

Windows user can download and install Balena Etcher to write the Raspberry Pi SD card: https://www.balena.io/etcher/



  1. login into raspberrypi and change directory:


$ ssh root@<<IP address>>

# after login into box 
$ cd /lib/rdk/

 

2. add startup_app_conf variable into referenceApp.sh config file, if referenceApp.sh file is not available in /lib/rdk then refer method 2 below to validate refapp.


startup_app_conf=/opt/residentapp.conf 



        3. add below line to avoid loading default app  


url="http://192.168.0.106:8080/"
echo $url


       

4. replace exting url https://px-apps.sys.comcast.net/lightning_apps/SwitcherApp/dist/index.html in /opt/residentapp.conf with lighting app url which is hosted on server

       for example your server providing url http://192.168.56.1:8080


     

5. reboot the box 

     

Validated on rdk-generic-hybrid-wpe-image_rdk-next image, download image link: https://drive.google.com/file/d/1_VgFDk_lRWLoMwv0JKQrZ4HUifN-F6Qa/view?usp=sharing

step 1: login to box $ ssh root@<your box ip>

step 2: copy refapp build into /opt/www

step3: $ cd /lib/rdk

step 4: $ vi residentApp.sh

step 5: configure refapp url into residentApp.sh > find in residentApp.sh line "offlineApp="http://127.0.0.1:50050/lxresui/index.html" and replace with refapp url, Example: "offlineApp="http://127.0.0.1:50050/refapp/index.html"

Note: if you are downloading prebuild refapp from download link: build.zip after extract you will see build/build/<files>, you can copy build folder as it is and in this case url will be "offlineApp="http://127.0.0.1:50050/build/build/index.html".

step 6: After reboot app come up with a splash screen. Lighting application will launch instead of switcher app. Main menu screen is displayed which allows users to launch apps, vod, and play video content.


RefApp Video Playback



Dependencies


 Reference Video