docs: add MLD configuration

README.md

@@ -394,6 +394,48 @@ The support of the feature on the agent depends on the used WiFi driver. The
 agent passes the generated map directly to the driver, and it is up to driver
 to decide whether to activate it or not.
 
+### Multi-Link Operation
+
+If an agent indicates MLO support via Early AP Capability Report message,
+map-controller may provide MLD interface configuration via
+Agent AP MLD Configuration TLVs and Backhaul STA MLD Configuration TLVs.
+
+To configure MLD propagation, `mld` sections must be provided with the credentials
+that are to be applied across all the links that are configured within the MLD.
+
+```
+config mld
+	option id '1'
+	option ssid 'IOWRT-MLO-SSID'
+	option key '1234567890'
+	option type 'fronthaul'
+```
+
+To add a link to the MLD, the ID of the mld must be added to the to the
+respective `ap` section.
+
+```
+config ap
+	option band '2'
+	option ssid 'IOWRT-MLO-SSID'
+	option encryption 'sae-mixed'
+	option key '1234567890'
+	option vid '1'
+	option type 'fronthaul'
+	option mld_id '1'
+
+```
+All `ap` sections that belong to an MLD will have their SSID and key propagated
+with that of the corresponding MLD.
+
+NOTE: If the encryption is NOT provided in the `mld` section, the encryption of
+the `ap` section will not be overwritten. That link will then use the encryption
+of the `ap` section.
+
+NOTE: If the agent does NOT support Wi-Fi 7 and MLO as reported in the Early AP
+Capabilities Report, the APs will be propagated as legacy, SLO, APs
+with the credentials of the respective `ap` sections.
+
 ## AP-Autoconfig Renew (Network Reconfiguration)
 
 Autoconfig Renew will trigger all agents to be reconfigured with updated

schemas/uci/mapcontroller.json

@@ -254,6 +254,13 @@
                     "required": "no",
                     "default": "",
                     "description": "Pass any custom vendor extension as a part of the WSC M2."
+                },
+                {
+                    "name": "mld_id",
+                    "type": "integer",
+                    "required": "no",
+                    "default": null,
+                    "description": "Indiciates whether the interface is a part of an MLD. The value maps towards the ID of the mld section, if present."
                 }
             ]
         },
@@ -535,6 +542,48 @@
                     "description": "Inclusion policy of Associated Wi-Fi 6 STA Status Report TLV in the AP metrics response."
                 }
             ]
+        },
+        {
+            "section": "mld",
+            "required": "no",
+            "description": "Section storing MLD credentials.",
+            "multi": true,
+            "options": [{
+                    "name": "id",
+                    "type": "integer",
+                    "required": "yes",
+                    "default": "0",
+                    "description": "Unique ID assigned to this MLD."
+                },
+                {
+                    "name": "ssid",
+                    "type": "string",
+                    "required": "no",
+                    "default": "",
+                    "description": "SSID used by all the links that are a part of this MLD."
+                },
+                {
+                    "name": "key",
+                    "type": "string",
+                    "required": "no",
+                    "default": "",
+                    "description": "Password used by all links that are a part of this MLD."
+                },
+                {
+                    "name": "type",
+                    "type": "string",
+                    "required": "no",
+                    "default": "unknown",
+                    "description": "Human readable type of the interfaces belonging to the MLD (fronthaul/backhaul/combined)."
+                },
+                {
+                    "name": "enabled",
+                    "type": "boolean",
+                    "required": "no",
+                    "default": "true",
+                    "description": "Whether the MLD is enabled or not."
+                }
+            ]
         }
     ]
 }
\ No newline at end of file