 |
Morse Micro IoT SDK
2.12.3
|
|
Morse Micro IoT SDK
2.12.3
|
Structure to hold the QR enrollee specific arguments for the DPP process.
#include <mmwlan.h>
Data Fields | |
| const uint8_t * | bootstrap_private_key |
| DER-encoded EC private key for the DPP bootstrap identity (P-256 / prime256v1). More... | |
| uint16_t | bootstrap_private_key_len |
Length of bootstrap_private_key in bytes. More... | |
| uint16_t | chirp_iterations |
| Number of chirp iterations (0 = default of 1). More... | |
| const uint8_t* mmwlan_dpp_qr_args::bootstrap_private_key |
DER-encoded EC private key for the DPP bootstrap identity (P-256 / prime256v1).
If non-NULL (and bootstrap_private_key_len is non-zero), this key is used as the bootstrap identity. It must match the key used to generate the QR code printed on the device label. The data pointed to must remain valid until mmwlan_dpp_start() returns.
If NULL (the default for zero-initialized structs), a fresh key pair is generated automatically. This is useful for ephemeral/dynamic QR codes where the URI is retrieved at run-time via mmwlan_dpp_get_uri() rather than printed on a fixed label.
A suitable DER key can be generated with:
| uint16_t mmwlan_dpp_qr_args::bootstrap_private_key_len |
| uint16_t mmwlan_dpp_qr_args::chirp_iterations |
Number of chirp iterations (0 = default of 1).
A chirp is a DPP Presence Announcement action frame broadcast on candidate channels to make the enrollee discoverable to a nearby DPP configurator without requiring the enrollee to know in advance which channel the configurator is listening on.
One iteration consists of one complete pass through the candidate channel list. The channel list is built from the preferred S1G frequency plus any channels where DPP configurator connectivity was detected in a scan; the list is refreshed by a new scan every 4 rounds. Between iterations the device waits approximately 30 seconds before starting the next round.
When all iterations are exhausted without receiving a DPP configuration, chirping stops and MMWLAN_DPP_EVT_CONF_RECEIVED will not be delivered. The application may re-invoke mmwlan_dpp_start() to begin another round of chirps if desired.