RDK Camera in RPI Reference Platform - WebPA Support - User manual - 2020 - M3

Introduction

• This page dedicated to bringing up and validation of Webpa functionality in R-Pi Zero.
• WebPA is the communication channel from Cloud to RDK based home gateway devices. It helps to manage devices from Cloud. WEBPA protocol provides functionality of read/write access to device management parameters.

Required Equipment

• Raspberry Pi 0 Device
• SD Card
• Power Cable
• OTG Cable
• Standard USB keyboard
• Mini HDMI connector
• HDMI Cable
• Television set/monitor with HDMI input

System Setup

Build Procedure

$ repo init -u "https://code.rdkcentral.com/r/rdkcmf/manifests" -m rdkc-nosrc.xml -b master

$ repo sync

$ source meta-cmf-raspberrypi/setup-environment

select meta-cmf-raspberrypi/conf/machine/raspberrypi0-rdk-camera.conf

$ bitbake rdk-generic-camera-image

Image Flash Procedure

$ sudo dd if="Image Name" of="Device Name" bs=4M

Example:

sudo dd if=rdk-generic-camera-image_default_20200130060729.rootfs.rpi-sdimg of=/dev/sdb bs=4M

WEBPA Validation Procedure

STEP 1:

Add require SSID and PSK in /etc/wpa_supplicant.conf file in below format

network={

ssid="username"

psk="password"

}

STEP 2:

Reboot the Target

After Reboot don't do step 1 and 2.

Note : Step 1 & 2 is only applicable for fresh target boot-up with new image.

STEP 3:

WiFi connection is must needed for WEBPA validation.

Check WiFi connection by using below command.

ifconfig

STEP 4:

check Parodus binary running status in RPI by using below command

ps -Af | grep parodus

STEP 5:

check Webpacamera binary running status in RPI by using below command

ps -Af | grep webpacamera

STEP 6:

Parameter fetching from client( RPI ) device

Fetch device or feature parameter detail from client( RPI ) device through parodus by using webpa server.

Command :

curl -H ’ Authorization:Basic <AUTH_TOKEN>’ -i http://<WEBPA_URL>/api/v2/devices

Example : 

curl -H 'Authorization:Basic dXNlcjp3ZWJwYQo=' -i 'http://192.168.2.75:9003/api/v2/device/mac:b827eb2e722b/config?names=Device.DeviceInfo.X_RDKCENTRAL-COM_IMAGENAME'

Output :

{"parameters":[{"name":"Device.DeviceInfo.X_RDKCENTRAL-COM_IMAGENAME","value":"RPI-CAM_stable2_20200318070913","dataType":0,"parameterCount":1,"

message":"Success"}],"statusCode":200}

Able to fetch below list of parameter from client( RPI ) device.

Limitations

• Validated only the above get parameters mentioned.

Troubleshooting

• Error Message

         Following are the error message that user may taken into considerations:

1. "message":"Invalid parameter value"}],"statusCode":520

   For Invalid parameter value, check for correct parameter name and the unwanted space in the command.

2. "message":"Error unsupported namespace","statusCode":520

   For Unsupported namespace, check for the respective services that are essential to fetch tha data. For example, WiFi related information can be accessed only if ccspwifiagent service is active.

3. "message":Service Unavailable", "statusCode":531

   For this error, ensure the network connection and the server and client-side services are up.

Special Considerations

         Since different services are involved in the communication, port-number specification should be taken into account.

1. In Client-side, along with ServerURL Port number of Talaria should be specified.
2. From user-end, while requesting for information Tr1d1um's Port number should be given.