DevMgr - Manufacturing Data Abstraction Module#
Overview#
DevMgr is the entry point for accessing manufacturing-related device
information (BD address, IEEE 802.15.4 address, crystal trim values and future
provisioning data). It abstracts the underlying storage backend behind a single
stable public DEVMGR_* API.
Public API#
Get API |
Set API |
|---|---|
|
|
|
|
|
|
|
|
Get APIs#
Behavior of a DEVMGR_Get*:
Read the parameter from the backend.
Address Get APIs#
DEVMGR_Get*Address APIs take an optional uint32_t *from_location in/out
argument selecting/reporting the address source (DEVMGR_MAC_SRC_*).
If from_location is a NULL pointer, or its value is 0 or DEVMGR_MAC_SRC_ANY,
the possible sources are read in order of precedence: CUST backend
(HWParameter or CFPA) -> NMPA -> UUID.
If the
from_locationmask has theDEVMGR_MAC_SRC_CUSTbit, read the parameter (address octet string) from the backend.If the parameter is not blank, copy it to the output, set
from_locationtoDEVMGR_MAC_SRC_CUSTand returnDEVMGR_Success_c.If the parameter is blank (all
0xFF) and thefrom_locationmask has theDEVMGR_MAC_SRC_NMPAbit:read the octet string from NMPA,
if provisioned copy it to the output,
set
from_locationtoDEVMGR_MAC_SRC_NMPAandreturn
DEVMGR_Success_c.
If the parameter is blank again and the
from_locationmask has theDEVMGR_MAC_SRC_UUIDbit and the UUID octet string is not blank:copy the derived MAC address (derived from
CRC32(UID)),set
from_locationtoDEVMGR_MAC_SRC_UUIDandreturn
DEVMGR_Success_c.
If the build option
DEVMGR_MAC_GEN_ENABLEDis enabled (HWParameter backend only) and thefrom_locationmask has theDEVMGR_MAC_SRC_CUSTbit:generate a random MAC address,
set it permanently in the backend by calling
DEVMGR_Set*Address,copy it to the output,
set
from_locationtoDEVMGR_MAC_SRC_CUSTandreturn
DEVMGR_Success_c. The platform/CFPA backend never generates an address.
Otherwise (
DEVMGR_MAC_GEN_ENABLEDnot enabled, and none of thefrom_location-specified methods produced an address):fill the output with
0xFF,return
DEVMGR_Blank_c(read-only behavior, nothing is written).
Return status#
Status |
Meaning |
|---|---|
|
Operation completed successfully |
|
Generic error (backend read/write failure or bad argument) |
|
Parameter is empty (all |
|
Parameter not supported by the active backend |
Architecture#
Files#
File |
Description |
|---|---|
|
Public API and return-status types |
|
HWParameter storage backend implementation |
|
Platform/CFPA storage backend implementation |
|
Optional MAC-address generation service (OUI + RNG / CRC32(UID)) |
|
Build configuration options (backend selection) |
|
Build integration |
|
Per-platform |
|
Per-platform |
|
KW43/MCXW70 CFPA/CMPA IFR transactional flash engine backing the platform store |
Backend status per platform#
Platform |
Default backend |
Notes |
|---|---|---|
KW45x / K32W1x / MCXW71x |
HWParameter |
|
KW47x / MCXW72x |
HWParameter |
|
MCXW23 |
Platform / CFPA |
CFPA is the active backend on this family |
KW43 / MCXW70 |
HWParameter |
The platform/CFPA backend is implemented but not yet active. On KW43/MCXW70 the interim default remains HWParameter; the CFPA-store accessors in |