Porting Guide - OneWifi

Scope:

              This guide will help RDK-B community to port OneWifi on their platforms

Prerequisites:

TBD

Supported platforms:

1.       Raspberry Pi4 64 bit
2.       Raspberry Pi4 32 bit

Supported yocto version:

1. Dunfell
2. Kirkstone(supported in rdkb2023q3 kirkstone beta release and planned for rdkb2023q4 official release)

Epic details:

• REFPLTB-2020 - Getting issue details... STATUS

Approach followed:

• Full Management frame approach(Highly recommended for SoC vendors,OEM's and Operators)
• Event based approach(Only for Raspberry Pi4,Since there is no much support for full management from broadcom driver side we opted this approach.To continue using this approach,this should be discussed with Operators and RDK-B Architecture Review Board)

Step by step procedure:       

Include rdkb2023q2 release on top of SoC SDK.this is the recommended rdkb stable release for OneWifi (rdkb-2023q2-dunfell)

Dependencies to build OneWifi

Systemd Service file:

• •    onewifi.service

Create platform layer for mediatek platform,please consider raspberry pi as reference

• •   https://code.rdkcentral.com/r/plugins/gitiles/rdkb/components/opensource/ccsp/hal/rdk-wifi-hal/+/refs/heads/rdk-next/platform/

           Manifest entries:

• •        Onewifi component entry in manifest file (OneWifi) and rdk-wifi-hal component entry in manifest (rdk-wifi-hal)

Layers to consider:

           1.meta-raspberrypi ( Or )meta-cmf-soc-<soc name>  ------- Firmware/drivers/kernel to be available

• •                     For proposing a new component,please create a bb file here

           2.meta-cmf-raspberrypi (Or) meta-cmf-<platformname> --------- RDK-B changes to specific to SOC platform 

• •                     All changes that need to be done for the primary recipe are handled in the form of bbappend 
  •                     Patches: Patches are recommended if the changes are very specific and tied with SOC platform code.

           3.meta-cmf-broadband ----------- RDK-B changes which are common for all RDK-B community members

• •                    All changes that need to be done for the primary recipe are handled in the form of bbappend
  •                    Patches: Patches are recommended if the changes are very specific and tied with SOC platform code.

           Bug fixing or feature enhancement:

• •             Bug fixing or feature enhancement done as part of OneWifi which are generic enough should come to OneWifi generic repo 

Flags defined in Onewifi:

• •        Raspberry Pi has certain limitations on the driver side to support end to end use case of OneWifi and Build dependencies which are specific to comcast.to avoid such issues we have introduced a flag (_PLATFORM_RASPBERRYPI_) to keep it under conditional compilation.for Real targets we dont really need this flags

Bulk atomic HAL apis for common configuration