User's Guide

API Protocol Reference
EZ-Serial BLE Firmware Platform User Guide, Doc. No. 002-11259 Rev. *E 118
Binary Header:
Type
Length
Group
ID
Notes
CMD
C0
00
04
0B
None.
RSP
C0
02
04
0B
None.
Text Info:
Text Name
Response Length
Category
Notes
/SX
0x0009
ACTION
None.
Command Arguments:
None.
Response Parameters:
None.
Related Commands:
• gap_start_scan (/S, ID=4/10)
Related Events:
• gap_scan_state_changed (SSC, ID=4/3)
7.2.4.12 gap_query_peer_address (/QPA, ID=4/12)
Query remote peer Bluetooth address.
This command provides returns the Bluetooth address of the currently connected remote peer device. An active
connection is required in order to use this command successfully.
Binary Header:
Type
Length
Group
ID
Notes
CMD
C0
01
04
0C
None.
RSP
C0
09
04
0C
None.
Text Info:
Text Name
Response Length
Notes
/QPA
0x001E
None.
Command Arguments:
Data Type
Name
Text
Description
uint8 conn_handle C
Handle of connection for which to query remote peer address
(Ignored in current release due to internal BLE stack functionality, set to 0)
Response Parameters:
Data Type
Name
Text
Description
macaddr
address
A
Peer Bluetooth address
uint8
address_type
T
Address type
Related Commands:
• gap_connect (/C, ID=4/1)
• gap_query_rssi (/QSS, ID=4/13)
7.2.4.13 gap_query_rssi (/QSS, ID=4/13)
This command provides returns the remote signal strength indication (RSSI) value detected in the packet received most
recently from the currently connected remote peer device. An active connection is required in order to use this command
successfully.
NOTE: RSSI values in real-world environments often fall in the -50 dBm to -70 dBm range. An RSSI
value at this level does not necessarily indicate a poor connection.