RDK-B (Raspberry Pi 3 B+) Build and Setup Manual - Router Profile

Introduction

The Raspberry Pi 3 Model B+ featuring a 64-bit quad core processor running at 1.4 Ghz. R-Pi3 B+ supports the dual band 2.4GHz and 5GHz IEEE 802.11.b/g/n/ac wireless LAN which provides an high edge for the broadband developer community to test the RDK-B stack with Router, WiFi functionalities. 

Build Instructions

Repo setup

In order 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

machine code.rdkcentral.com
login YOUR_USERNAME
password YOUR_PASSWORD

Yocto Build Steps

To build, follow below instructions

$ mkdir <workspace dir>
$ cd <workspace dir>
$ repo init -u https://code.rdkcentral.com/r/manifests -b rdk-next -m rdkb-extsrc.xml
$ repo sync -j4 --no-clone-bundle
$ source meta-cmf-raspberrypi/setup-environment (Select option raspberrypi-rdk-broadband.conf)
$ bitbake rdk-generic-broadband-image

• RDKB RPI Setup Information

Note : RPI-3 B and B+ have same Build instructions and testing procedure

Flashing Procedure

sudo dd if=<path to ImageName.rpi-sdimg> of=<path to SD card space> bs=4M
Example:
$ sudo dd if=rdk-generic-broadband-image-raspberrypi-rdk-broadband.rpi-sdimg of=/dev/sdb bs=4M

RDK-B Bootup Sequence 

• GwProvApp-Ethwan is the entry point for RDK-B stack middleware. It does all gateway initialization as above
• Responsible to initiate the registration of all services on boot -up. Responsible for all provisioning of LAN,FIREWALL(iptables),BRIDGE,etc
• GwProvApp-EthWan is specifically designed for Ethernet only Input feed for WAN Network Connection(i,e erouter0)

Router Profile Test Bed using RPI

Router Functionality Use Case

Lists of Supported Features

1. DHCP Gateway Configuration
2. Connected Devices (Wired/Wireless)
3. Private Wifi 2g/5g
4. Xfinity-wifi 2g/5g
5. Parental Control(Managed Devices,Managed Sites,Managed Services)
6. Port Forwarding
7. Remote Management
8. DMZ
9. Factory-Reset
10. Captive Portal 
11. Password-Reset
12. Test and Diagnostics
13. Bridge Mode
14. Webpa
15. WPS
16. Bootchart
17. MAC Filtering
18. Firewall Settings
19. Log level control through EthLogAgent
20. Firmware Upgrade using Dual bank

Supported Features User manual

• Clients Connection and its set up Diagram in RPI - User Manual
  • RDK Based WiFi Management 
• Additional Routing features user manual - Bridge Mode, Test and Diagnostics,DMZ,Xfinity hotspot (wifi connection) and Remote Management
  • Demo Videos - which covers mentioned features
• Captive Portal in R-Pi User Manual - Captive Portal
• WebPA Client Support - User Manual - Webpa
• Wireless Protection Setup - User Manual - WPS
• RDK-B Boot time data automation - User Manual - Bootchart
• MAC Filtering in R-Pi - User Manual - MAC Filtering 
• RDKB CcspLogAgent Component in RPI - User Manual - Log level control through EthLogAgent
• RDKB(V) Firmware Upgrade in RPI - User Manual  - Firmware Upgrade using Dual bank

Additional Links

• RDK-B Components - covers components supported by RDKB
• Utopia covers basic routing features of RDKB 
• Webui provides the snapshot of RDKB-RPI-webui and control options for routing functionality 

Yocto Modification for RDK B+ Support

1. Back port of Linux kernel from sumo branch(4.14.68) to morty branch in meta-raspberrypi layer
2. Modified linux-firmware bbappend in meta-raspberrypi layer to bring up wireless interface
3. Modified bcm2835-bootfiles bbappend and rdk-rpi.inc (added dtb files) in meta-cmf-raspberrypi layer to boot up  RPI B+ Board