Page History

Table of Contents

Scope

Goal is to understand and bringup required platform for supporting various IoT protocols including, WiFi, thread & Bluetooth in RDK-B Bananapi R4 with silabs module

Banana Pi R4 release used

• Beta engineering release of 05 Feb 2025

Hardware used (as of Jan 2026 PoC, to be expanded with more devices, device types)

BoM:

1. Banana Pi R4 with WiFi chipset (whole kit)
2. SiLabs EFR32xG24 Explorer kit

•  Silabs xG24 Explorer Kit (brd2703a)

1. Matter/WiFi Mini smartplug (110vAC, US power) example, TP-link Tapo
2. Thread Mini smartplug (110vAC, US power) example, Onvis Smartplug S4
3. 2 x generic (110vAC, US power) generic LED “night lights” to be plugged into smartplugs 
4. Associated cabling/serial adapters

RDK image tool (easy way to Image the SD card for RDK-B) -> https://rdkcentral.com/download-instructions/?caller=broadband

Where to purchase SiLabs

...

hardware

• https://www.silabs.com/development-tools/wireless/efr32xg24-explorer-kit?tab=overview

Highlevel block diagram of Thread & Bluetooth

• draw.io Diagram
  border true diagramName otbr simpleViewer false width links auto tbstyle top lbox true diagramWidth

  671

  851 height

  321

  564 revision

  1

  9

Kernel side changes for Thread

• Minimal kernel changes

  • CONFIG_USB_ACM=y

    • drivers/usb/class/Makefile

    • Description - ACM support for UART communication

  • CONFIG_TUN=y

    • drivers/net/tap.c

    • Description - TUN generic  support 

  • CONFIG_IEEE802154=y

    • net/ieee802154

    • Description - Generic IEEE802154

  • CONFIG_MAC802154=y

    • net/mac802154

    • Description - Generic MAC layer for IEEE802154

  • draw.io Diagram
    border true diagramName kcmf simpleViewer false width links auto tbstyle top lbox true diagramWidth 930 height 350 revision 1

User space code changes for Thread in meta-cmf-broadband/recipes-connectivity

• cpcd

  • https://gerrit.teamccp.com/plugins/gitiles/rdk/yocto_oe/layers/meta-rdk-comcast-broadband/+/refs/heads/25Q1_sprint/recipes-connectivity/cpcd

• otbr-agent

  • https://gerrit.teamccp.com/#/c/887931/

Yocto changes for Thread

• Image install changes in BPI for thread

  • draw.io Diagram
    border true diagramName otbrinstall11 simpleViewer false width links auto tbstyle top lbox true diagramWidth 901 height 301 revision 1

Runtime changes for Thread

• cpcd.conf

  • set disable_encryption to true

• cpcd.service

  • Remove ExecStartPre=/usr/bin/init-iot-radio.sh

• Directory creation

  • mkdir /nvram/icontrol/etc/thread

• systemctl enable otbr-agent

• otbr-agent.service

  • update debug level to 7 from 5 

Testing of thread

• cpcd service should be up and running
• otbr-agent service should be up and running
• ot-ctl shoule be accessible and get state

  • Code Block
    W:~# ot-ctl > state disabled Done >

Firmware upgrade of BRD module

• Use simplicity studio
  • Use commander tool 
  • Installed software in ubuntu and connected module with USB Type C
• Get Approval from Thomas Lea to get access to the firmware - rcp-multi-all-4.4.5-2-brd2703a.hex

Documentation for thread

• https://docs.silabs.com/multiprotocol/latest/multiprotocol-solution-linux/
• https://openthread.io/

Key check points when we land in issues for thread

• Make sure we have wpan0 interface up
• brlan0 should be up and running
• wpan0 - who creates wpan0it ? - otbr-agent

  • More technical explanation on user space

    • Initial OTBR-agent startup:
      • OTBR-agent process starts
      • At this point, no wpan0 interface exists yet
      • No socket exists yet at /run/openthread-wpan0.sock
    • OTBR-agent creates socket:
      • Creates Unix domain socket at /run/openthread-wpan0.sock
      • This socket will be used for IPC/control operations
    • OTBR-agent creates network interface:
      • Creates the wpan0 network interface
      • Takes ownership of managing this interface
    • Runtime dependencies:
      • The wpan0 interface is ONLY available while OTBR-agent is running
      • If OTBR-agent stops, the wpan0 interface goes away
      • Other services/processes should not expect wpan0 to exist without OTBR-agent running
    • Communication flow:
      • Other processes can communicate with OTBR-agent through the socket at /run/openthread-wpan0.sock
      • Network traffic goes through the wpan0 interface managed by OTBR-agent

  • Can i assume that the above mentioned kernel config to be enabled,if so why , kernel side explanation

    • 1. CONFIG_TUN=y
         • Required since OTBR-agent creates the wpan0 network interface
         • The TUN/TAP driver support enables creation of virtual network interfaces
         • Without this, OTBR-agent wouldn't be able to create the wpan0 interface
      2. CONFIG_IEEE802154=y
         • Required as the base IEEE 802.15.4 protocol support
         • Provides the fundamental IEEE 802.15.4 networking stack
         • OTBR-agent uses this for Thread networking which runs on 802.15.4
      3. CONFIG_MAC802154=y
         • Required for MAC layer operations of IEEE 802.15.4
         • Handles MAC layer functionality like addressing and frame formatting
         • OTBR-agent relies on this for proper 802.15.4 packet handling

      Without these kernel configurations:

      • The wpan0 interface creation would fail
      • The IEEE 802.15.4 networking stack wouldn't be available
      • The MAC layer operations for Thread networking wouldn't work

Code changes to support Bluetooth 

• Prerequisite - Bluetooth support in Banana Pi R4(Reference) - Generic Module
• steps
  • cd meta-cmf-broadband/recipes-connectivity
  • mkdir bt-host-cpc-hci-bridge

  • download recipies

    • get the bb file and service files from - https://github.com/cpokuru/yocto-staging/

  • Install btattach

    • draw.io Diagram
      border true diagramName install-btattach simpleViewer false width links auto tbstyle top lbox true diagramWidth 660 height 350 revision 1

  • Image install

    • draw.io Diagram
      border true diagramName imagebthci simpleViewer false width links auto tbstyle top lbox true diagramWidth 990 height 380 revision 1

Testing bluetooth

• process state

  • draw.io Diagram
    border true diagramName psatet simpleViewer false width links auto tbstyle top lbox true diagramWidth 410 height 210 revision 1

• hciconfig

  • draw.io Diagram
    border true diagramName hciconfigefr simpleViewer false width links auto tbstyle top lbox true diagramWidth 640 height 220 revision 1

• Device connection using bluetoothctl

  • draw.io Diagram
    border true diagramName btefrtest simpleViewer false width links auto tbstyle top lbox true diagramWidth 760 height 2000 revision 1

  • Module test - TAPO Matter smart plug

• systemctl status

  • draw.io Diagram
    border true diagramName sysbt simpleViewer false width links auto tbstyle top lbox true diagramWidth 950 height 1270 revision 1