User's Guide

API Protocol Reference
EZ-Serial BLE Firmware Platform User Guide, Doc. No. 002-11259 Rev. *E 96
Related Events:
• system_boot (BOOT, ID=2/1)
7.2.2.7 system_query_unique_id (/QUID, ID=2/7)
Query EZ-Serial module unique identifier.
The module’s unique identifier comes from factory-stored data in the chipset’s supervisory flash (SFLASH) area. The four
bytes returned are:
1. Die X position
2. Die Y position
3. Die wafer number
4. Die lot number
Binary Header:
Type
Length
Group
ID
Notes
CMD
C0
00
02
07
None.
RSP
C0
07
02
07
None.
Text Info:
Text Name
Response Length
Category
Notes
/QUID
0x0016
ACTION
None.
Command Arguments:
None.
Response Parameters:
Data Type
Name
Text
Description
uint8a id U
Unique ID (1 length byte equal to 0x04, followed by 4 data bytes)
NOTE: uint8a data type requires one prefixed “length” byte before binary parameter payload
7.2.2.8 system_query_random_number (/QRND, ID=2/8)
Query random number generator for 8-byte pseudo-random sequence.
This command provides simple access to the random number generator in the EZ-BLE module’s chipset. The query
always provides exactly eight bytes of random data.
NOTE: This pseudo-random generation mechanism is FIPS PUB 140-2 compliant.
Binary Header:
Type
Length
Group
ID
Notes
CMD
C0
00
02
08
None.
RSP
C0
0B
02
08
None.
Text Info:
Text Name
Response Length
Category
Notes
/QRND
0x001E
ACTION
None.
Command Arguments:
None.
Response Parameters:
Data Type
Name
Text
Description
uint8a data D
Random 8-byte sequence (1 length byte equal to 0x08, followed by 8 data bytes)
NOTE: uint8a data type requires one prefixed “length” byte before binary parameter payload