5.7 Reference Guide for using DLL
163
Syntax
unsigned long write_auth_link_key(unsigned char *link_key);
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
link_key // the first byte of 16-bytes array of the link key for the associated BD_ADDR
// Default value is “00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00”.
read_tester_tone_freq
Description
This function reads the tone frequency of the audio signal in Hz which would be send by a tester.
Syntax
unsigned long read_tester_tone_freq(unsigned short *tone_freq);
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
tone_freq // Range : 1 ~ 4000
write_tester_tone_freq
Description
This function writes the tone frequency of the audio signal in Hz which would be send by a tester.
Syntax
unsigned long write_tester_tone_freq(unsigned short tone_freq);
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
tone_freq // Range : 1 ~ 4000, Default : 1000.
read_tester_tone_ampl
Descriptionis function reads the tone amplitude of the audio signal which would be send by a tester. Refer
to write_tester_tone_ampl for more details.
Syntax
unsigned long read_tester_tone_ampl(unsigned short *tone_ampl);
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
tone_ampl // Range : 0 ~ 32767.
write_tester_tone_ampl
Description
This function writes the tone amplitude of the audio signal which would be send by a tester.
[Note] How to calculate tone_ampl in relation to Tone Level(dBm0) of TC-3000C GUI ?