Skip to content
GitLab
Explore
Sign in
Primary navigation
Search or go to…
Project
M
map-controller
Manage
Activity
Members
Labels
Plan
Issues
Issue boards
Milestones
Wiki
Code
Merge requests
Repository
Branches
Commits
Tags
Repository graph
Compare revisions
Snippets
Build
Pipelines
Jobs
Pipeline schedules
Artifacts
Deploy
Releases
Container registry
Model registry
Operate
Environments
Monitor
Incidents
Analyze
Value stream analytics
Contributor analytics
CI/CD analytics
Repository analytics
Issue analytics
Model experiments
Help
Help
Support
GitLab documentation
Compare GitLab plans
Community forum
Contribute to GitLab
Provide feedback
Terms and privacy
Keyboard shortcuts
?
Snippets
Groups
Projects
Show more breadcrumbs
Multi-AP
map-controller
Commits
1b8747eb
Commit
1b8747eb
authored
2 years ago
by
Jakob Olsson
Browse files
Options
Downloads
Patches
Plain Diff
README: add dpp section
parent
b5d2e328
No related branches found
No related tags found
1 merge request
!245
README: add dpp section
Changes
1
Hide whitespace changes
Inline
Side-by-side
Showing
1 changed file
README.md
+62
-3
62 additions, 3 deletions
README.md
with
62 additions
and
3 deletions
README.md
+
62
−
3
View file @
1b8747eb
...
@@ -527,7 +527,6 @@ To enable Guest WiFi and Easymesh Traffic Segregation, the option 'primary_vid'
...
@@ -527,7 +527,6 @@ To enable Guest WiFi and Easymesh Traffic Segregation, the option 'primary_vid'
and 'enable_ts' must be set to a non-zero value in the map-controller config's
and 'enable_ts' must be set to a non-zero value in the map-controller config's
global section.
global section.
NOTE: Currently, only primary_vid = '1' is supported:
```
```
config controller 'controller'
config controller 'controller'
...
@@ -659,6 +658,62 @@ To easily identify a backhaul BSS, a vendor extension TLV is optionally added to
...
@@ -659,6 +658,62 @@ To easily identify a backhaul BSS, a vendor extension TLV is optionally added to
Topology Response CMDUs and parsed by map-controller. This is merely a cosmetic
Topology Response CMDUs and parsed by map-controller. This is merely a cosmetic
improvement in the map-controller
`status`
UBUS API.
improvement in the map-controller
`status`
UBUS API.
## DPP Easy Connect
NOTE: The enrollee and the controller/configurator device must be operating at
the same channel, as off channeling listening for DPP Chirp messages is
currently not supported.
To perform DPP Easy Connect, the enrollees bootstrap information must provided
to the map-controller via its UBUS API:
```
ubus call map.controller dpp_enrollee_uri '{"uri":"DPP:C:128/44;M:44d43771bb2f;V:2;K:MDkwEwYHKoZIzj0CAQYIKoZIzj0DAQcDIgADa1Eoz/Lz0u0XO+Y+786MMst2kqGFJmCb8iOQWcekwS8=;;"}'
```
All provided URIs are stored in reboot persistent memory in
`/etc/multiap/dpp_uris.json`
:
```
root@eagle-44d43771bf50:~# cat /etc/multiap/dpp_uris.json
{"uris":[{"uri":"DPP:C:81\/1;M:44d43771bb2e;V:2;K:MDkwEwYHKoZIzj0CAQYIKoZIzj0DAQcDIgACQiHpcmOs5LhdwCBylPoDRdVS21swh6nrM+XQxGnGpG0=;;","type":"qr"}]}
```
If map-controller is compiled with the ubus debug method (default) it can
additionally be observed from its debug object:
```
root@eagle-44d43771bf50:~# ubus call map.controller.dbg list_uris
{
"uris": [
{
"macadr": "44:d4:37:71:bb:2e",
"type": "qrcode",
"uri": "DPP:C:81/1;M:44d43771bb2e;V:2;K:MDkwEwYHKoZIzj0CAQYIKoZIzj0DAQcDIgACQiHpcmOs5LhdwCBylPoDRdVS21swh6nrM+XQxGnGpG0=;;",
"hashlen": 32,
"frames": [
]
}
]
}
```
For map-controller to accept the URI, some optional fields are mandated:
*
Opclass/Channel list must be provided. In the case of multiple, each
Opclass/Channel must be provided separately, i.e. C:128/44,128/36;
*
The enrolle mac address must be included and match the backhaul station mac address
of the enrollee.
Once the map-controller has received the enrollee URI, it will listen and parse
its chirps and proceed to onboard the enrollee onto the network.
NOTE: Legacy AKMs are strongly recommended, as backhaul configuration Request/Response/Result
are not yet implemented, fronthaul configurations relies on AP-Autoconfiguration,
which does not support passing DPP AKMs. With this said, it is possible to onboard
via DPP only AKMs and establish a connection.
## UBUS APIs
## UBUS APIs
Map-controller offers a variety of UBUS APIs, most of them map to CMDU request
Map-controller offers a variety of UBUS APIs, most of them map to CMDU request
...
@@ -670,10 +725,12 @@ each agent
...
@@ -670,10 +725,12 @@ each agent
*
`steer_summary`
and
`steer_history`
- Maps to TR-181 data model.
*
`steer_summary`
and
`steer_history`
- Maps to TR-181 data model.
```
```
root@
iopsys-021000000001
:~# ubus -v list map.controller
root@
eagle-44d43771bf50
:~# ubus -v list map.controller
'map.controller' @
35515cda
'map.controller' @
52dd51f5
"status":{}
"status":{}
"status_full":{}
"timers":{}
"timers":{}
"dpp_enrollee_uri":{"uri":"String","type":"String"}
"steer_summary":{"sta":"String"}
"steer_summary":{"sta":"String"}
"steer_history":{"sta":"String"}
"steer_history":{"sta":"String"}
"ap_caps":{"agent":"String"}
"ap_caps":{"agent":"String"}
...
@@ -701,4 +758,6 @@ root@iopsys-021000000001:~# ubus -v list map.controller
...
@@ -701,4 +758,6 @@ root@iopsys-021000000001:~# ubus -v list map.controller
"higher_layer_data":{"agent":"String","protocol":"Integer","data":"String"}
"higher_layer_data":{"agent":"String","protocol":"Integer","data":"String"}
"send_combined_metrics":{"agent":"String","bssid":"String"}
"send_combined_metrics":{"agent":"String","bssid":"String"}
"sync":{"agent":"String"}
"sync":{"agent":"String"}
"dpp_cce_indication":{"agent":"String","cce_advertise":"Boolean"}
```
```
This diff is collapsed.
Click to expand it.
Preview
0%
Loading
Try again
or
attach a new file
.
Cancel
You are about to add
0
people
to the discussion. Proceed with caution.
Finish editing this message first!
Save comment
Cancel
Please
register
or
sign in
to comment