Page History

Build Instructions

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

Introduction

The Raspberry Pi 3 Model B+ is the latest production Raspberry Pi 3 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

Required Equipment

                   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.

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

7. Tp-link dongles

Dongles Information Links

                   For xfinity-wifi - 2g - https://www.amazon.in/TP-LINK-TL-WN823N-300Mbps-Wireless-Adapter/dp/B00X3OUQDG?tag=googinhydr18418-21&gclid=EAIaIQobChMI5-KK1_Ot3gIVFw4rCh3-PAsiEAQYAyABEgJFDvD_BwE

                  For Private-wifi and xfinity-wifi - 5g - https://www.amazon.in/TP-Link-Archer-T4U-Wireless-Adaptor/dp/B01N2U8YRF/ref=sr_1_14?ie=UTF8&qid=1540893691&sr=8-14&keywords=tp-link+ac1200

Lists of Supported Features

                    1. DHCP Gateway Configuration

. 

Build Instructions and Flashing Procedure 

• For Host SetUp details refer this link - How to Build#SettinguptheHostEnvironment
• For Build Instructions and Flashing Procedure details refer this link - RDK-B Raspberrypi - Host SetUp and Build Instructions#BRaspberrypi-HostSetUpandBuildInstructions-YoctoBuildSteps

Hardware and Setup Information

• RDKB RPI Setup Information 

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

RDK-B Bootup Sequence 

Image Added

• 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

Image Added

Router Functionality Use Case - Internet connectivity for Wired and Wireless Client(s)

1. Ethernet Port of RPI should be connected to WAN Network
2. Connect WiFi Dongle to RPI ( Please refer to supported dongle here RDKB RPI Setup Information#DonglesInformationLinks )
3. Client PC(s)  should be connected to RPI through Usb2Ethernet Adaptor which should be supported by RPI ( Please refer to https://elinux.org/RPi_USB_Ethernet_adapters for supported usb to ethernet adapter by RPI ). Ethernet switch is an optional in between usb2ethernet adapter and Client PC
4. Once powered on, RPI should be able to list interfaces erouter0,brlan0 and wlan0 after boot up 
5. Logs can be verified under /rdklogs/logs folder 
6. Now, client pc should be able to get private ip in the rage 10.0.0.x range 
7. Two radios are supported by RPI (2.4 and 5 GHz) respectively. By default following SSID's are broadcasted by RPI under respective radio 
   1. 2.4GHz (Private WiFi)
      1. SSID name - "RPI3_RDKB-AP0" 
      2. Password - "rdk@1234"
   2. 5 GHz (Xfinity WiFi)
      1. SSID name - "RPI3_RDKB-AP1" 
      2. Password - "rdk@1234"
8. Connect mobile with above default SSID name and password for respective radio. Any one radio should be used for establishing connection in mobile
9. Now, mobile should be able to get private ip in the rage 10.0.0.x range 
10. To get Internet for both mobile and wired client pc , user should configure captive portal by accessing any url or 10.0.0.1 from mobile browser or PC browser. When RPI image is flashed for the first time captive portal will be enabled which will auto redirect to captive portal page and asks user to re-configure the default SSID name and password of radio(s) . Please refer to Captive Portal in R-Pi User Manual for more information. 
11. Client PC should be able to connect to internet now. Ping test can also be done by connecting gateway ip 10.0.0.1
12. Since reconfiguration is done for default SSID username and password in webUI, provide the reconfigured SSID and password in mobile for reconnection with RPI
13. Now, mobile and wired client pc should be able to browse the internet. Please refer to Clients Connection and its set up Diagram in RPI - User Manual for more information regarding the same for both wired and wireless connection information
14. Connected client(s) PC and mobile information can be verified through webui by executing URL 10.0.0.1 in Client PC Browser and login with following credentials 
    1. Username : admin
    2. Password : password
15. Please refer to link Webui Functions for various features that can be controlled through webui 

Lists of Supported Features

...

1. DHCP Gateway Configuration

1. Connected Devices (Wired/Wireless)

...

1. Private Wifi 2g/5g

...

1. Xfinity-wifi 2g/5g

...

1. Parental Control(Managed Devices,Managed Sites,Managed Services)

...

1. Port Forwarding

...

1. Remote Management

...

                     8. DMZ

...

1. ( Available only with http support )
2. DMZ
3. Factory-Reset

                     10. CaptivePortal

                     11. Password-Reset

                     12. TestandDiagnostics

                     13. BridgeMode

                     14. Webpa

                     15. WPS

                     16. Bootchart

...

1. Captive Portal 
2. Password-Reset
3. Test and Diagnostics
4. Bridge Mode
5. Webpa
6. WPS
7. Bootchart
8. MAC Filtering
9. Firewall Settings
10. Log level control through CcspLogAgent
11. Firmware Upgrade using Dual bank
12. Log Rotation Support 
13. SNMP
14. Band Steering using RSSI
15. Backup and Restore
16. SelfHeal
17. Telemetry

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
• Log Rotation Support in RPI User manual - Broadband - 2019 M8 - Log Rotation
• SNMP - RDKB RPI - User Manual - 2020 - M7 - SNMP
• Firmware Upgrade with Support of HTTP Protocol & TFTP Protocol in RDKB RPI - Broadband - User Manual - 2020 - M6 - Firmware Upgrade using Http Protocol
• Self Heal Support in RPI - Design - 2019 M10 - Self Heal
• Telemetry(1.0) in RPI User manual Broadband - 2019 M9 - Telemetry
• Backup and Restore Feature in RPI - User Manual - Backup and Restore
• Band Steering User manual(With CcspWifiAgent) - RDKB - Band Steering
• RDKB EthAgent Component in RPI - User Manual - 2019 M7 - Associated LAN clients informations

Additional Links

• RDK-B Components - covers components supported by RDKB
• Utopia covers basic routing features of RDKB 

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

...

1. Modified linux-firmware bbappend in meta-raspberrypi layer to bring up wireless interface

...

1. Modified bcm2835-bootfiles bbappend and rdk-rpi.inc (added dtb files) in meta-cmf-raspberrypi layer to boot up  RPI B+ Board

...