5.7 Reference Guide for using DLL
161
tester_vers // The local version information of a tester.
read_tester_pin_code
Description
This function writes the PIN length and PIN code(passkey) of a tester. Refer to write_tester_pin_code
for more details.
Syntax
unsigned long read_tester_pin_code(unsigned char *pin_length, unsigned char *pin);
Return Value
The return value of this function will be zero if the function is successful. Otherwise, the return value will be
an error code.
Parameter
pin_length // The PIN code length specifics the length, in bytes, of the PIN code to be used.
// Range : 0 ~ 16
pin // PIN code for the DUT.
// Endianess does therefore not apply to the PIN code Parameter.
// The first byte of the PIN code should be transmitted first.
// Default Value is “30 30 30 30 30 30 30 30 30 30 30 30 30 30 30 30”.
write_tester_pin_code
Description
This function reads the PIN length and PIN code(passkey) of a tester. Then PIN is used to authenticate
two Bluetooth Devices(that have not previously exchanged link keys) to each other and create a trusted
relationship between them and is used in pairing precedure to generate the initial link key that is used for
further authentication.
Syntax
unsigned long write_tester_pin_code(unsigned char pin_length, unsigned char *pin);
Return Value
The return value of this function will be zero if the function is successful. Otherwise, the return value will be
an error code.
Parameter
pin_length // The PIN code length specifics the length, in bytes, of the PIN code to be used.
// Range : 0 ~ 16, Default : 4.
pin // PIN code for the DUT.
// Endianess does therefore not apply to the PIN code Parameter.
// The first byte of the PIN code should be transmitted first.
// Default Value is “30 30 30 30 30 30 30 30 30 30 30 30 30 30 30 30”.
read_tester_pin_type
Description
This function reads the PIN type of a tester. Tester uses the PIN type information during pairing.
Syntax
unsigned long read_tester_pin_type(unsigned char *pin_type);
Return Value
The return value of this function will be zero if the function is successful. Otherwise, the return value will be
an error code.
Parameter
pin_type // 0: Variable PIN, 1:Fixed PIN
write_tester_pin_type