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

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

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

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

Required Hardware

                   The equipment listed below is required for complete functionality of the standalone environment. The only devices that are tested to work properly in this solution are the specific brands and models listed below. Support for other types of equipment is not available at this time.

                            RPI 3B

                          RPI 3B+                          

1. Raspberry Pi 3 b or Raspberry Pi 3 b+ device

2. Standard USB keyboard

3. Television set/monitor with HDMI input.

4. Ethernet cables

5. USB-Ethernet Adapter

6. SD Card ( Preferably 8GB or more )

7. Tp-link dongles
8. USB to Serial Debugging Adaptor ( Needed only for serial debugging )

USB to Serial Debug converter Link and set up

Purchase Link(PL2303) - USB to Serial           

RPI 3 Pin Diagram

The above mentioned adaptor (PL2303) will support Linux host machine ( ubuntu ) with proper connection between RPI (for both 3B and B+) as below

• Connect GND (Pin 6) of RPI with PL2303 GND Pin
• Connect GPIO14 (Pin 8) of RPI with PL2303 RX Pin
• Connect GPIO15 (Pin 10) of RPI with PL2303 TX Pin

After connection, please run minicom in host machine to establish serial connection with RPI

https://help.ubuntu.com/community/Minicom

Note : In usual, adaptor will have device name as ttyUSB0 after connected to host PC ( can be checked using dmesg command in host ). Please configure minicom accordingly. 

Dongles Information Links

• For xfinity-wifi - 2g - Purchase Link - TP-LINK TL-WN823N
• For Private-wifi and xfinity-wifi - 5g - Purchase Link - TP-Link AC1300

Router Profile Test Bed using RPI

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