Scope

The scope of this activity to add support of MLO enabling / disabling via TR-181 Datamodel in RDK-B BPI Reference platform.

High Level Architecture

RDK > WiFi 7 MLO configuration via TR-181 DataModel support in RDKB BPI - User Manual > onwifi.png

The internal functional entities of the OneWifi process are as shown in the above diagram. OneWifi software architecture is essentially a multi-threaded software architecture, the three main threads are

Core thread: this thread is the fundamental engine of the process that is responsible for all configuration of WiFi parameters, command/control/status response and WiFi state indications. The core thread is also responsible for steering related activities.
DML thread: this thread handles the TR-181 set/get handlers.
Apps thread: this thread is responsible for supporting all WiFi related application/features such as harvester, motion sensing, blaster, single client measurements etc.

BPI-R4 Build instructions

repo init -u https://code.rdkcentral.com/r/manifests -b kirkstone -m rdkb-bpi-extsrc.xml
repo sync -j`nproc` --no-clone-bundle
MACHINE=bananapi4-rdk-broadband source meta-cmf-bananapi/setup-environment-refboard-rdkb
bitbake rdk-generic-broadband-image

Flashing Instructions (SD card)

Copy *.wic.bz2 from build machine (image path is ~/build-bananapi4-rdk-broadband/tmp/deploy/images/bananapi4-rdk-broadband/)

bzip2 -d <Path to ImageName.wic.bz2>
sudo -E bmaptool copy --nobmap <Path to ImageName.wic> <Path to SD card device file>

Test Procedure

Pre-requisites

802.11be enabled on all bands — 2.4 GHz, 5 GHz, and 6 GHz radios must each have 11be enabled (and be enabled).
Same SSID on all VAPs participating in the MLO group.
Same password on all VAPs participating in the MLO group.
Security mode:
- 2.4 GHz & 5 GHz → WPA3-Personal-Transition, WPA3-Personal-Compatibility or WPA3-Personal
- 6 GHz → WPA3-Personal
All participating VAPs enabled (one link per radio; STA/mesh VAPs excluded).

Mismatched SSID, password, or an incompatible security mode causes that band's link to be silently excluded from the MLD group.

Enable 3-link MLO for private VAPs via TR-181 DM

# Make sure BE mode is enabled.
dmcli eRT setv Device.WiFi.Radio.1.OperatingStandards string g,n,ax,be
dmcli eRT setv Device.WiFi.ApplyRadioSettings bool true

dmcli eRT setv Device.WiFi.SSID.1.X_RDK_MLDLinkID uint 2
dmcli eRT setv Device.WiFi.SSID.2.X_RDK_MLDLinkID uint 0
dmcli eRT setv Device.WiFi.SSID.17.X_RDK_MLDLinkID uint 1

dmcli eRT setv Device.WiFi.SSID.1.MLDUnit int 0
dmcli eRT setv Device.WiFi.SSID.2.MLDUnit int 0
dmcli eRT setv Device.WiFi.SSID.17.MLDUnit int 0

dmcli eRT setv Device.WiFi.ApplyAccessPointSettings bool true

sleep 30

Test Results

root@Filogic-GW:~# dmcli eRT setv Device.WiFi.SSID.1.X_RDK_MLDLinkID uint 2
CR component name is: eRT.com.cisco.spvtg.ccsp.CR
subsystem_prefix eRT.
Execution succeed.

root@Filogic-GW:~# dmcli eRT setv Device.WiFi.SSID.2.X_RDK_MLDLinkID uint 0
CR component name is: eRT.com.cisco.spvtg.ccsp.CR
subsystem_prefix eRT.
Execution succeed.

root@Filogic-GW:~# dmcli eRT setv Device.WiFi.SSID.17.X_RDK_MLDLinkID uint 1
CR component name is: eRT.com.cisco.spvtg.ccsp.CR
subsystem_prefix eRT.
Execution succeed.

root@Filogic-GW:~# 
root@Filogic-GW:~# dmcli eRT setv Device.WiFi.SSID.1.MLDUnit int 0
CR component name is: eRT.com.cisco.spvtg.ccsp.CR
subsystem_prefix eRT.
Execution succeed.

root@Filogic-GW:~# dmcli eRT setv Device.WiFi.SSID.2.MLDUnit int 0
CR component name is: eRT.com.cisco.spvtg.ccsp.CR
subsystem_prefix eRT.
Execution succeed.

root@Filogic-GW:~# dmcli eRT setv Device.WiFi.SSID.17.MLDUnit int 0
CR component name is: eRT.com.cisco.spvtg.ccsp.CR
subsystem_prefix eRT.
Execution succeed.

root@Filogic-GW:~# 
root@Filogic-GW:~# dmcli eRT setv Device.WiFi.ApplyAccessPointSettings bool true
CR component name is: eRT.com.cisco.spvtg.ccsp.CR
subsystem_prefix eRT.
Execution succeed.

root@Filogic-GW:~# iw dev
phy#0
	Interface mld0
		ifindex 21
		wdev 0x4
		addr 02:02:30:ec:07:95
		ssid BPI-RDKB-MLO-AP-ec078e
		type AP
		multicast TXQ:
			qsz-byt	qsz-pkt	flows	drops	marks	overlmt	hashcol	tx-bytes	tx-packets
			0	0	0	0	0	0	0	0		0
		MLD with links:
		 - link ID  0 link addr 02:02:10:ec:07:92
		   channel 1 (2412 MHz), width: 40 MHz, center1: 2422 MHz
		   txpower 6.00 dBm
		 - link ID  1 link addr 02:02:20:ec:07:93
		   channel 44 (5220 MHz), width: 80 MHz, center1: 5210 MHz
		   txpower 7.00 dBm
		 - link ID  2 link addr 02:02:30:ec:07:94
		   channel 37 (6135 MHz), width: 160 MHz, center1: 6185 MHz
		   txpower 12.00 dBm
		Radios: 0 1 2
	Interface wifi2
		ifindex 20
		wdev 0x3
		addr 02:02:30:ec:07:94
		type AP
		txpower 12.00 dBm
		multicast TXQ:
			qsz-byt	qsz-pkt	flows	drops	marks	overlmt	hashcol	tx-bytes	tx-packets
			0	0	0	0	0	0	0	0		0
		Radios: 0 1 2
	Interface wifi1
		ifindex 19
		wdev 0x2
		addr 02:02:20:ec:07:93
		type AP
		txpower 7.00 dBm
		multicast TXQ:
			qsz-byt	qsz-pkt	flows	drops	marks	overlmt	hashcol	tx-bytes	tx-packets
			0	0	0	0	0	0	0	0		0
		Radios: 0 1 2
	Interface wifi0
		ifindex 18
		wdev 0x1
		addr 02:02:10:ec:07:92
		type AP
		txpower 6.00 dBm
		multicast TXQ:
			qsz-byt	qsz-pkt	flows	drops	marks	overlmt	hashcol	tx-bytes	tx-packets
			0	0	0	0	0	0	0	0		0
		Radios: 0 1 2
root@Filogic-GW:~#

Disable MLO for private vaps via TR-181 DM

# Whole group dmcli eRT setv Device.WiFi.SSID.1.MLDUnit int -1 dmcli eRT setv Device.WiFi.SSID.2.MLDUnit int -1 dmcli eRT setv Device.WiFi.SSID.17.MLDUnit int -1 dmcli eRT setv Device.WiFi.ApplyAccessPointSettings bool true

Test Results

root@Filogic-GW:~# iw dev
phy#0
	Interface mld0
		ifindex 21
		wdev 0x4
		addr 02:02:30:ec:07:95
		ssid BPI-RDKB-MLO-AP-ec078e
		type AP
		multicast TXQ:
			qsz-byt	qsz-pkt	flows	drops	marks	overlmt	hashcol	tx-bytes	tx-packets
			0	0	0	0	0	0	0	0		0
		MLD with links:
		 - link ID  0 link addr 02:02:10:ec:07:92
		   channel 1 (2412 MHz), width: 40 MHz, center1: 2422 MHz
		   txpower 6.00 dBm
		 - link ID  1 link addr 02:02:20:ec:07:93
		   channel 44 (5220 MHz), width: 80 MHz, center1: 5210 MHz
		   txpower 7.00 dBm
		 - link ID  2 link addr 02:02:30:ec:07:94
		   channel 37 (6135 MHz), width: 160 MHz, center1: 6185 MHz
		   txpower 12.00 dBm
		Radios: 0 1 2
	Interface wifi2
		ifindex 20
		wdev 0x3
		addr 02:02:30:ec:07:94
		type AP
		multicast TXQ:
			qsz-byt	qsz-pkt	flows	drops	marks	overlmt	hashcol	tx-bytes	tx-packets
			0	0	0	0	0	0	0	0		0
		Radios: 0 1 2
	Interface wifi1
		ifindex 19
		wdev 0x2
		addr 02:02:20:ec:07:93
		type AP
		multicast TXQ:
			qsz-byt	qsz-pkt	flows	drops	marks	overlmt	hashcol	tx-bytes	tx-packets
			0	0	0	0	0	0	0	0		0
		Radios: 0 1 2
	Interface wifi0
		ifindex 18
		wdev 0x1
		addr 02:02:10:ec:07:92
		type AP
		multicast TXQ:
			qsz-byt	qsz-pkt	flows	drops	marks	overlmt	hashcol	tx-bytes	tx-packets
			0	0	0	0	0	0	0	0		0
		Radios: 0 1 2
root@Filogic-GW:~# 
root@Filogic-GW:~# 
root@Filogic-GW:~# dmcli eRT setv Device.WiFi.SSID.1.MLDUnit int -1 
CR component name is: eRT.com.cisco.spvtg.ccsp.CR
subsystem_prefix eRT.
Execution succeed.

root@Filogic-GW:~# dmcli eRT setv Device.WiFi.SSID.2.MLDUnit int -1
CR component name is: eRT.com.cisco.spvtg.ccsp.CR
subsystem_prefix eRT.
Execution succeed.

root@Filogic-GW:~# dmcli eRT setv Device.WiFi.SSID.17.MLDUnit int -1
CR component name is: eRT.com.cisco.spvtg.ccsp.CR
subsystem_prefix eRT.
Execution succeed.

root@Filogic-GW:~# dmcli eRT setv Device.WiFi.ApplyAccessPointSettings bool true 
CR component name is: eRT.com.cisco.spvtg.ccsp.CR
subsystem_prefix eRT.
Execution succeed.

root@Filogic-GW:~# iw dev
phy#0
	Interface mld0
		ifindex 21
		wdev 0x4
		addr 02:02:30:ec:07:95
		type AP
		txpower 6.00 dBm
		multicast TXQ:
			qsz-byt	qsz-pkt	flows	drops	marks	overlmt	hashcol	tx-bytes	tx-packets
			0	0	0	0	0	0	0	0		0
		Radios: 0 1 2
	Interface wifi2
		ifindex 20
		wdev 0x3
		addr 02:02:30:ec:07:94
		ssid BPI-RDKB-MLO-AP-ec078e
		type AP
		channel 37 (6135 MHz), width: 160 MHz, center1: 6185 MHz
		txpower 12.00 dBm
		multicast TXQ:
			qsz-byt	qsz-pkt	flows	drops	marks	overlmt	hashcol	tx-bytes	tx-packets
			0	0	0	0	0	0	0	0		0
		Radios: 0 1 2
	Interface wifi1
		ifindex 19
		wdev 0x2
		addr 02:02:20:ec:07:93
		ssid BPI-RDKB-MLO-AP-ec078e
		type AP
		channel 44 (5220 MHz), width: 80 MHz, center1: 5210 MHz
		txpower 7.00 dBm
		multicast TXQ:
			qsz-byt	qsz-pkt	flows	drops	marks	overlmt	hashcol	tx-bytes	tx-packets
			0	0	0	0	0	0	0	0		0
		Radios: 0 1 2
	Interface wifi0
		ifindex 18
		wdev 0x1
		addr 02:02:10:ec:07:92
		ssid BPI-RDKB-MLO-AP-ec078e
		type AP
		channel 1 (2412 MHz), width: 40 MHz, center1: 2422 MHz
		txpower 6.00 dBm
		multicast TXQ:
			qsz-byt	qsz-pkt	flows	drops	marks	overlmt	hashcol	tx-bytes	tx-packets
			0	0	0	0	0	0	0	0		0
		Radios: 0 1 2
root@Filogic-GW:~# 

==========================================================================================================================================

Deprecated old Read-only DML (Can be used only for debugging purposes)

dmcli eRT getv Device.WiFi.AccessPoint.1.MLD_Enable
dmcli eRT getv Device.WiFi.AccessPoint.1.MLD_ID
dmcli eRT getv Device.WiFi.AccessPoint.1.MLD_Link_ID
dmcli eRT getv Device.WiFi.AccessPoint.1.MLD_Addr
# dmcli eRT getv Device.WiFi.AccessPoint.1.MLD_Apply (Completly removed)