0. Introduction - RDK Extender

• RDK Extender profile is a Yocto based RDK miniature build with opensource OpenSync agent
• OpenSync agent is cloud agnostic and it forms mesh orchestrated by Plume cloud
• RPI4 target is chosen for extender profile since this target is chip and widely available
• Two external Wi-Fi dongles are used for 2.4GHz and 5GHz radio support
• OpenSync's minimum requirement on the WiFi radio is the support for 2AP and 1 Station interface
• Conceptually, RPI4 extender can be used with different Gateway devices(which has OpenSync agent). But currently validated with TurrisOmnia RDKB GW
• Prerequisite: Need to contact Plume to acquiring TLS certificate and backhaul credential

1. Host Setup

• For Host SetUp details refer this link - How to Build#SettinguptheHostEnvironment

NOTE: Observing fetch errors in VMs with Ubuntu14.x. Thus, suggesting to use VMs with Ubuntu16.x or higher.

2. Building

Note: Cloning the code before login once to code.rdkcentral.com, user would get the Authentication error, even though the account is in good standing and has all the required access. Please login to code.rdkcentral.com before attempting to clone.

To build, follow below instructions

Create workspace directory

mkdir <workspace dir>
cd <workspace dir>

RPI4 Extender Kirkstone build(32-bit) instructions:

repo init -u https://code.rdkcentral.com/r/manifests -b rdkb-2024q2-kirkstone -m rdkb-pod-extsrc.xml
repo sync -j4 --no-clone-bundle
<UPDATE 0001-Update-bhaul-credential.patch in meta-cmf-broadband layer>
MACHINE=raspberrypi4-rdk-extender source meta-cmf-raspberrypi/setup-environment
bitbake rdk-generic-extender-image

3. Flashing Procedure

Following command can be used to flash the RPI image to sd card using linux machine . bmap tool should be available in linux

bzip2 -d <path to ImageName.wic.bz2>
sudo -E bmaptool copy --nobmap <path to ImageName.wic> <path to SD card space>

Example:

$ bzip2 -d rdk-generic-broadband-image-raspberrypi-rdk-broadband.wic.bz2
$ sudo -E bmaptool copy --nobmap rdk-generic-broadband-image-raspberrypi-rdk-broadband.wic.bz2 /dev/sdb

4. OpenSync version details:

Ported OpenSync version is 4.4.0.

5. References:

Kirkstone build errors and its fixes in this link Kirkstone RDK-B RPI4 32-bit Extender User Manual

Validation test results and their corresponding fixes in this link Kirkstone RDK-B RPI4 32-bit Extender Validation

6. Jira Tickets :

REFPLTB-3030 - Getting issue details... STATUS