Skip to content
Snippets Groups Projects
Commit 6b1347b3 authored by Jakob Olsson's avatar Jakob Olsson
Browse files

dpp: update README and other docs

parent 3c8dad94
Branches
No related tags found
1 merge request!379Dpp cleanup
Pipeline #99184 passed
......@@ -1217,6 +1217,100 @@ For guest-to-guest isolation see [here](./docs/README-Traffic_Separation.md#wi-f
For layer 3 setup guide see [here](./docs/layer3_ts.md).
## DPP Easy Connect
To enable URI generation and DPP chirping map-agent must have `dpp_uri` UCI
configuration sections provided.
```
config dpp_uri
option device 'wl1'
option band '2'
option ifname 'wl1'
list chan '81/1'
option type 'qrcode'
option chirp_interval '10'
config dpp_uri
option device 'wl0'
option band '5'
option ifname 'wl0'
list chan '128/36'
option type 'qrcode'
option chirp_interval '10'
```
Map-agent will accordingly generate URIs for the respective bands and start
chirping.
The URI's can be retreived from the UBUS API
`ubus call map.agent dpp_enrollee_uri`:
```
root@eagle-44d43771bb20:~# ubus call map.agent dpp_enrollee_uri
{
"enrollees": [
{
"ifname": "wl0",
"band": 2,
"device": "wl0",
"uri": "DPP:C:128/36;M:44d43771bb2f;V:2;K:MDkwEwYHKoZIzj0CAQYIKoZIzj0DAQcDIgAD/ebYNHPhud+3C/t47dLffnPCzKAI3RYsr7z0zz5pSHQ=;;",
"type": "qrcode",
"chirp_interval": 10,
"num_chan": 1,
"chan": [
{
"channel": 36,
"opclass": 128,
"freq": 0
}
]
},
{
"ifname": "wl1",
"band": 1,
"device": "wl1",
"uri": "DPP:C:81/1;M:44d43771bb2e;V:2;K:MDkwEwYHKoZIzj0CAQYIKoZIzj0DAQcDIgAD5ANLCEXDDO7vnLVgSDoiJJ5H2Mo7aPXVriSVZ0ygP7M=;;",
"type": "qrcode",
"chirp_interval": 10,
"num_chan": 1,
"chan": [
{
"channel": 1,
"opclass": 81,
"freq": 0
}
]
}
]
}
```
Once DPP onboarding is complete, credentials are provided as ubus events that
are picked up by map-agent and written to its configuration and used for future
connections.
```
{ "wifi.bsta": {"ifname":"wl1","event":"dpp-confobj-akm","data":"sae"} }
{ "wifi.bsta": {"ifname":"wl1","event":"dpp-confobj-ssid","data":"MAP-44D43771BF50-BH-2.4GHz"} }
{ "wifi.bsta": {"ifname":"wl1","event":"dpp-connector","data":"eyJ0eXAiOiJkcHBDb24iLCJraWQiOiI4MUNrdEdFNW5qTXBRSVJaUFVRT2M2dUNzZDd0MUd0ZHc5bGFFaHlETU5RIiwiYWxnIjoiRVMyNTYifQ.eyJncm91cHMiOlt7Imdyb3VwSWQiOiIqIiwibmV0Um9sZSI6Im1hcEFnZW50In1dLCJuZXRBY2Nlc3NLZXkiOnsia3R5IjoiRUMiLCJjcnYiOiJQLTI1NiIsIngiOiJNN1BOaG5xZnZRNzlJQl9vRXpXcGx6dldKXzJVR3l5SUxhSjVWYWdaUGlzIiwieSI6IkJrM0d6ZXkyQU5XWXdNOThZdGZIeUdVR2ZYR2NqZU9hUzRTYk50bXFrRWsifX0.1V96nYzO2TAl8CSEI7AwQE9C2Wybf-zgnaZVifzIATbCcAaPEmMbxUqdlIT754PXwoCKgdN8iTeJL7Siw6GVtQ"} }
{ "wifi.bsta": {"ifname":"wl1","event":"dpp-confobj-pass","data":"313231356330393634303739386239346262303164656663653964656537376139396666386163366137643738313162366362653133626336653931653565"} }
{ "wifi.bsta": {"ifname":"wl1","event":"dpp-c-sign-key","data":"3039301306072a8648ce3d020106082a8648ce3d030107032200031ae7f42438e80a1b3a65df7855eb945125afe371182aa5f052a43859707089c9"} }
{ "wifi.bsta": {"ifname":"wl1","event":"dpp-net-access-key","data":"307702010104205b06ffdcfb8af6c7904731ec74c84a2789c0c37c86f111499451781ed99c1b66a00a06082a8648ce3d030107a1440342000433b3cd867a9fbd0efd201fe81335a9973bd627fd941b2c882da27955a8193e2b064dc6cdecb600d598c0cf7c62d7c7c865067d719c8de39a4b849b36d9aa9049"} }
```
Today, BSS Configuration Request, Response and Result are not implemented. Thus,
while it is possible to onboard and use dpp AKM, it is effectively not
supported due to the lack of possibility to set dpp as exclusive AKM on the bbss.
Additionally, this means legacy akms (i.e. sae, sae-mixed, psk2) will be the
preferred connection type used by map-agent.
NOTE: Currently, `wpa_supplicant` will prioritize scanning over chirping. This
means 5GHz is much less reliable as it will scan a larger number of channels and
DPP chirp may get aborted. **For this reason is strongly recommended to use
2.4GHz for DPP onboarding.**
## Misc
### Netdev Format
......@@ -1274,8 +1368,8 @@ config agent 'agent'
## UBUS
```
root@iopsys-44d43771b730:~# ubus -v list map.agent
'map.agent' @1237706b
root@eagle-44d43771bb20:~# ubus -v list map.agent
'map.agent' @822ee9c6
"apconfig":{"band":"Integer"}
"steer_policy":{"vif":"String","rule":"String"}
"steer":{"vif":"String","type":"String","sta":"String","to_bss":"Array","optime":"Integer"}
......@@ -1288,12 +1382,16 @@ root@iopsys-44d43771b730:~# ubus -v list map.agent
"higher_layer_data":{"agent":"String","protocol":"Integer","data":"String"}
"backhaul_info":{}
"status":{}
"nodes":{}
"info":{}
"assoc_notify":{"bss_status_list":"Array"}
"sync":{}
"timers":{}
"dynamic_backhaul_upgrade":{}
"backhaul_blacklist":{}
"bss_config_request":{}
"ec_key":{}
"dpp_enrollee_uri":{}
```
This diff is collapsed.
......@@ -529,6 +529,55 @@
"description": "Channels to which the preference applies"
}
]
},
{
"section": "dpp_uri",
"required": "no",
"description": "Values necessary for proper DPP bootstrap URI generation and chirping",
"multi": true,
"options": [{
"name": "device",
"type": "string",
"required": "no",
"default": "",
"description": "The radio of that of the corresponding interface that wpa_supplicant is running on."
},
{
"name": "band",
"type": "integer",
"required": "yes",
"default": "Unknown (0x10)",
"description": "Band of the radio of the radio at which wpa_supplicant is running on."
},
{
"name": "ifname",
"type": "string",
"required": "yes",
"default": "",
"description": "Interface name of the backhaul station interface."
},
{
"name": "chan",
"type": "list",
"required": "yes",
"default": "",
"description": "Channel opclass pair provided in the format of '<channel>/<opclass> used for the DPP bootstrap URI."
},
{
"name": "type",
"type": "string",
"required": "no",
"default": "qrcode",
"description": "Type of the URI (qrcode, pkex nfc). NOTE: Today only qrcode is supported."
},
{
"name": "chirp_interval",
"type": "integer",
"required": "no",
"default": "10",
"description": "The interval at which to send DPP chirp messages."
}
]
}
]
}
\ No newline at end of file
0% Loading or .
You are about to add 0 people to the discussion. Proceed with caution.
Please register or to comment