UTIL Extension Vendor Specific API¶
UTIL Extension Commands¶
UTIL_NV_Read¶
| Opcode: | 0xFE81 |
|---|---|
| Command Description: | |
| Send this command to read an NV parameter. | |
Command Parameters
| nvID: |
|
||||||
|---|---|---|---|---|---|---|---|
| nvLen: |
|
Events Generated
When this command is received, the host will send the CommandStatus Event.
UTIL_NV_Write¶
| Opcode: | 0xFE82 |
|---|---|
| Command Description: | |
| Send this command to write an NV parameter. | |
Command Parameters
| nvID: |
|
||||||
|---|---|---|---|---|---|---|---|
| nvDataLen: | Size of NV data
|
||||||
| nvData: | NV Data Field. Structure can be different for each NV item
|
Events Generated
When this command is received, the host will send the CommandStatus Event.
UTIL_ForceBoot¶
| Opcode: | 0xFE83 |
|---|---|
| Command Description: | |
| Force the boot loader to run. | |
Events Generated
When this command is received, the device resets if the boot loader is present. Otherwise, the host will send the CommandStatus Event.
UTIL_BuildRevision¶
| Opcode: | 0xFE84 |
|---|---|
| Command Description: | |
| This command is used to read the build revision information of the BLE stack software. | |
Events Generated
When this command is received, the host will send the CommandStatus Event.
Additional Command Status Return Parameters
| dataLen: |
|
||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| stk ver (mj/mn/ph): | |||||||||||||||||||||||
|
|||||||||||||||||||||||
| bld ver: |
|
||||||||||||||||||||||
| stk info: |
|
||||||||||||||||||||||
| ctrl info: |
|
||||||||||||||||||||||
| host info: |
|
||||||||||||||||||||||
UTIL_GetMemStats¶
| Opcode: | 0xFE87 |
|---|---|
| Command Description: | |
| Get memory statistics | |
Command Parameters
| command ID: |
|
|---|
Events Generated
When this command is received, the host will send the CommandStatus Event.
Additional Command Status Return Parameters
| dataLen: |
|
|---|
:all cmdID receive :
Size: 1 byte(s)
Range:
Value Description 0x01 Light Heap Statistic 0x02 Full Heap Statistic (requieres HEAPMGR_METRICS) 0x04 Thread usage Statistic (requieres HEAPMGR_METRICS)
| cmdID: |
|
||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Heap Size: |
|
||||||||||||||
| Heap Size Free: |
|
||||||||||||||
| Biggest free buffer Available: | |||||||||||||||
|
|||||||||||||||
| cmdID: |
|
||||||||||||||
| Heap Fail number: | |||||||||||||||
|
|||||||||||||||
| Heap Allocated: |
|
||||||||||||||
| Heap Max Allocated: | |||||||||||||||
|
|||||||||||||||
| cmdID: |
|
||||||||||||||
| Number of Thread: | |||||||||||||||
|
|||||||||||||||
An array of size “Count” will be returned containing the parameters starting here:
| Priority: |
|
||||||
|---|---|---|---|---|---|---|---|
| Handle: |
|
||||||
| max Stack used: |
|
||||||
| stack size: |
|
The array of parameters ends here.
UTIL Extension Events¶
UTIL_GetMemStats¶
| Opcode: | 0x0681 |
|---|---|
| Event Description: | |
| This event displays memory statistics for debugging. | |
Event Parameters
| Status: |
|
||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Module: |
|
||||||||||||||
| cmdID: |
|
||||||||||||||
| cmdID: |
|
||||||||||||||
| Heap Size: |
|
||||||||||||||
| Heap Size Free: |
|
||||||||||||||
| Biggest free buffer Available: | |||||||||||||||
|
|||||||||||||||
| cmdID: |
|
||||||||||||||
| Heap Fail number: | |||||||||||||||
|
|||||||||||||||
| Heap Allocated: |
|
||||||||||||||
| Heap Max Allocated: | |||||||||||||||
|
|||||||||||||||
| cmdID: |
|
||||||||||||||
| Number of Thread: | |||||||||||||||
|
|||||||||||||||
An array of size “Count” will be returned containing the parameters starting here:
| Priority: |
|
||||||
|---|---|---|---|---|---|---|---|
| Handle: |
|
||||||
| max Stack used: |
|
||||||
| stack size: |
|
The array of parameters ends here.