Introduction

This manual describes the rdk-generic-broadband-image build procedure for Yocto 4.0 builds. Yocto 4.0 contain Long term Support release feature. The upgraded build tools from Yocto 4.0 will be used to generate rdk-generic-broadband-image for BananaPi reference platform.

Yocto 4.0 support the following:

• Yocto BSP layer for meta-filogic
• OpenEmbedded and Yocto kirkstone.
• linux kernel 5.4.271
• Version upgrades for bitbake, and other oe/python recipes.

Each component in RDK is a standalone repository with its own individual build tools producing a library or set of binaries. 

Host Setup

The OpenEmbedded build system should be able to run on Ubuntu 20.0 distribution/other compatible linux distribution with the following versions for Git, tar, and Python.

• Git 2.25.1 or greater
• tar 1.30 or greater
• Python 3.10.4 or greater
• Coreutils(E.g realpath)

Note: You should also have about 50 Gbytes of free disk space for building images.

The essential packages you need for a supported Ubuntu or Debian distribution are shown in the following command:

Repo Setup

In order to use Yocto build system, the repo tool must be properly installed on the machine.

To install Repo make sure you have a /bin directory in your home directory and that it is included in your path

$ mkdir ~/bin
$ PATH=~/bin:$PATH
Download the repo tool and ensure that it is executable
$ curl http://commondatastorage.googleapis.com/git-repo-downloads/repo > ~/bin/repo
$ chmod a+x ~/bin/repo

Note: it is also recommended to put credentials in ~/.netrc when interacting with repo.

A sample ~/.netrc file is illustrated below

To generate the HTTP_CREDENTIALS 

• Sign in to https://code.rdkcentral.com/
• Click on Settings
• Navigate to HTTP Credentials
• Generate a new password
• Update netrc with new http credentials

machine code.rdkcentral.com login usermail@company.com password HTTP_CREDENTIALS

Note: For futher SSO authentication details please go through this RDKM Managed Applications Migration

Yocto Build Steps

mkdir <workspace dir>
cd <workspace dir>
repo init -u https://code.rdkcentral.com/r/manifests -b kirkstone -m rdkb-bpi-extsrc.xml
repo sync -j `nproc` --no-clone-bundle --no-tags
MACHINE=bananapi4-rdk-broadband source meta-cmf-bananapi/setup-environment-refboard-rdkb
bitbake rdk-generic-broadband-image

Note: For sd card build, in case of not having access to artifactory repository , follow the below link to generate bl2.img and fip.bin
SD Monolitic image build and flashing steps for BPI R4.#Buildingbl2.imgandfip.binincaseofnothavingaccesstoartifactoryrepository

mkdir <workspace dir>
cd <workspace dir>
repo init -u https://code.rdkcentral.com/r/manifests -b kirkstone -m rdkb-bpi-extsrc.xml
repo sync -j `nproc` --no-clone-bundle --no-tags
MACHINE=bananapi4-rdk-broadband BPI_IMG_TYPE=nand source meta-cmf-bananapi/setup-environment-refboard-rdkb
bitbake rdk-generic-broadband-image

Flashing Procedure for sd card

Following command can be used to flash the BPI 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 rrdkb-generic-broadband-image_rdk-next_20250130114818.bin.wic.bz2
$ sudo -E bmaptool copy --nobmap rdkb-generic-broadband-image_rdk-next_20250130114818.bin.wic /dev/sdb

Flashing Procedure for Nand image

Pre-requirements: Install tftp server in you local machine and copy the image to tftp server location

Step 1: Power on the BPi board
Step 2:You will see U-Boot Boot Menu procedure (ie, startup system, upgarde firmware, ...)
Step 3:Select the second option upgrade firmware -> Run image after upgrading? (Y/n): Y
Step 4:Next on Available load methods select 0 which is TFTP client.
Step 5:Setup device network
Input U-Boot's IP address: (same network as tftp server, eg:192.168.2.1)
Input TFTP server's IP address: (tftp server IP address)
Input IP netmask: 255.255.255.0
Input file name: rdk-generic-broadband-image-bananapi4-rdk-broadband-sysupgrade.bin (BPI image in bin format)
Step 6:Then enter, image will be downloaded from tftp server to BPI and will start flashing the image to BPI device if success.

Validated Functionalities

S.No	Features tested on	Supported
1	WebPa get and set should work, query device.
2	LogUpload/Logrotation
3	RFC
4	Webconfig
5	Telemetry 2
6	Usppa get and set are working through DM’s
7	Cellular Mode
8	Local WebUI
9	Firewall
10	OneWiFi Triband
11	CPU Proc Analyser
12	WAN Connectivity (i,e Ipv4)
13	WAN Connectivity (i,e Ipv6)
14	WiFi Connectivity
15	LAN Connectivity
16	SNMP
17	Bridge Mode
18	DAC
19	OneWifi with Single WiPhy Design
20	TR069
21	eSDK
22	PopulateSDK
23	SelfHeal
24	Test and Diagnostic
25	Crash Upload
26	SD card support
27	Factory reset