User Manual

199
CATC MERLIN’S WAND 1.22 APPENDIX C
User’s Manual Merlin’s Wand Scripting Commands
Return values
Returns a list with two values: status and data.
Status (element 0) is one of the following:
• “Success”
• “Failure”
Data (element 1) is a list containing zero or more pairs of the following
two values:
• BDADDR: the Bluetooth Address that the link key corresponds to
• LinkKey: the link key for the specified address
Comments
Attempts to read the stored link key for the specified address or for all
addresses, depending on the value of ReadAll.
Example
result = HCIReadStoredLinkKey('6E8110AC0008', 1);
Trace("HCIReadStoredLinkKey() returned: ", result[0],
"\n\n");
if (result[0] == "Success")
{
list = result[1];
i = 0;
while (list[(i*2)] != null)
{
Trace("************************\n");
Trace("BDADDR: ", list[(i*2)], "\n");
Trace("Link Key: ", list[(i*2)+1], "\n");
Trace("************************\n");
i = i + 1;
}
}
ReadAll Boolean value
that indicates
whether to
read only the
specified
address's link
key, or all link
keys
00 or 1
Parameter Meaning Default Value Comments