This step by step guide provides detailed instructions to assist the RDK-B community in porting the OneWifi component to the RPi4 reference platform

Architectural details

RDK-B Layers:

Integration segments:

Dependencies to build OneWifi

Change details

Systemd Service File

onewifi.service

Platform Layer

Target Platform: MediaTek platform (using RPi4 as a reference)

Platform Layer: Create a platform layer for MediaTek, using RPi4 as the reference.

Code References

HAL Changes

OneWifi Process Bringup Patches 

Manifest entries

OneWifi component entry: onewifi manifest

HAL component entry: rdk-wifi-hal manifest 

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-<platform_name>
   • RDK-B specific changes to the 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 common to 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
   • Note: All existing reference patches in RPi4 may not be applicable for real targets, Because of hardware limitation & functionality limitation we have added patches.

Bug Fixes or Feature Enhancements

Generic Bug Fixes:
Any bug fixes or feature enhancements that are generic enough should be committed to the OneWifi generic repository.

Flags defined in OneWifi

Platform-Specific Flags:

RPi4 has certain limitations related to driver support and end-to-end functionality for OneWifi. To manage these limitations, a flag _PLATFORM_RASPBERRYPI_ has been introduced to enable conditional compilation.

• Note: This flag is not needed for real targets. 

HAL APIs

Bulk Atomic HAL APIs:

For bulk atomic HAL APIs related to common configuration, refer to the HAL APIs documentation.

Stats Implementation

• Vendor-Specific Implementation:
  Stats implementation is vendor-specific. The implementation from the device-specific HAL can be used. Refer to for more details. 

Wi-Fi database

Database File:

rdkb-wifi.db

64-bit build support:

At present, support for 64-bit platforms is limited. However, the RDK team provides support for 64-bit builds on RPi4 platforms, with full integration of OneWifi. Many alignment issues and warnings that were previously treated as errors have been resolved in this support.

Difference Between CcspWifiAgent and OneWifi Apply settings

CcspWifiAgent:

dmcli eRT setv Device.WiFi.Radio.2.X_CISCO_COM_ApplySetting bool true
dmcli eRT setv Device.WiFi.Radio.1.X_CISCO_COM_ApplySetting bool true

OneWifi:

#Any dmcli commands specific to SSID and AccessPoint execute the Below Access Point Related apply settings
dmcli eRT setv Device.WiFi.ApplyAccessPointSettings bool true
 
#Any dmcli executions specific to Radio level use the below Radio apply settings command
dmcli eRT setv Device.WiFi.ApplyRadioSettings bool true

Debugging Tips

Below is the list of logs present in /rdklogs/logs for Debugging OneWifi issues. For Additional in-depth Debugging one should enable below commands:

• touch /nvram/wifiMgrDbg
• touch /nvram/wifiDbDbg
• touch /nvram/wifiWebConfigDbg
• touch /nvram/wifiHalDbg
• touch /nvram/wifiCtrlDbg
• touch /nvram/wifiMonDbg
• touch /nvram/wifiDMCLI
• touch /nvram/wifiLib
• touch /nvram/wifiLibhostapDbg

check for the respective logs in /tmp:

• tail -f wifiCtrl &
• tail -f wifiHal &
• tail -f wifiMgr &
• tail -f wifiDMCLI &
• tail -f wifiDb &
• tail -f wifiWebConfig &
• tail -f wifilibhostap &

Wi-Fi 7 segment

Initial headers are available in this commit. The following features will be supported by OneWifi as part of Wi-Fi 7, which includes changes in OneWifi, rdk-wifi-hal and libhostap (for Wi-Fi 7 we use libhostap 2.11 version):

1. 320 MHZ
2. 4kQAM
3. MLO

Additional References

For more info refer Porting Guide - OneWifi