Porting Guide - OneWifi

Scope:

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

Target Audience:

           RDK-B Software Architects and Engineers

Prerequisites:

TBD

Supported platforms:

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

Supported yocto version:

1. Dunfell
2. Kirkstone(supported from 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)

Integration segments:

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/
  • https://code.rdkcentral.com/r/c/rdk/components/generic/rdk-oe/meta-cmf-raspberrypi/+/85744/1/meta-rdk-broadband/recipes-ccsp/hal/files/0002_onewifi_process_bringup_changes.patch

           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.
  • All existing reference patches in Raspberry pi may not be applicable for real targets,Because of hardware limitation & functionality limitation we have added patches.

           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

Stats implementation:

• • • This is vendor specific.we can use vendor based implementation from device specific HAL.pls refer this ticket for reference( REFPLTB-2510 - Getting issue details... STATUS )

wifi database:

• • • rdkb-wifi.db

64 bit build support:

• • • Comcast doesnt have 64 bit support in the current platforms.from RDK team side we have Raspberrypi 4 platform which support 64bit.we have supported Onewifi as part of this platform and fixed lot of alignment issues and warning treated as errors

State machine for reference:

• • • Flow Diagram/Pseudo Code
    • Message Sequence Diagrams

Wi-Fi 7 segment:

                              Initial Headers: https://code.rdkcentral.com/r/plugins/gitiles/rdkb/components/opensource/ccsp/halinterface/+/490e08dc0edc9180a18c60eb4d6d3b0c85a1ebe3

                           Below things will be supported by Onewifi as part of Wi-Fi 7 which includes changes in onewifi ,rdk-wifi-hal & libhostap(for Wi-Fi 7 we use libhostap 2.11 version )

1. 1. 1. 320 MHZ
      2. 4kQAM
      3. MLO