Manage your bluetooth device and Affix. Affix is a Bluetooth protocol stack for Linux. Btctl consistsof several sub commands. They are grouped according to their purpose and listed here below.
-i The interface name which settings you want to manage. E.g. "bt0"
-v Verbose mode.
-V Print version number.
-m <map_file> Set the uart map file.
-r Set the uart rate
Here belongs commands for device initialization, debuging and to get help.
Use these commands to set pin codes for devices, create pairings and set your security level.
Set the used security level. Mode is on of the following: open, link, service, pairable, auth, encrypt.
Add a pin code to pin code database. The pin code is linked to certain Bluetooth device address. If default keyword is used instead of a device address the pin code is applied to all addresses that are not listed in the pin code database.
Deletes a pin code that linked to given device address. Giving "default" keyword the default pin code will be deleted.
Command's in this group are used to control the Bluetooth device. These command operates at low level and an ordinary end user probably do not need these.
Set the name for the device. This name is shown to others inquiring your device. If the name is not given as a parameter the current is printed.
Enables or disables scanning for connect or discovery attempt. If disabled this device cannot be connected or seen by remote devices. Enable discovery to allow others to see your device (disc) and to enable connecting (conn) to allow remote device establish a connection. Plus and minus signs in the front of keywords states enabled and disabled respectively.
Set the devices initial role to master or slave. Master device establishes the Bluetooth connection. First parameter defines if a role switch is possible. If allowed then this device can change its role according to the situation.
The class of device parameter is used to indicate the capabilities of the local device to other devices. Give the class in hex decimal in form 0x1234.
Try to authenticate the connected device with given address. This command is used to try to authenticate the remote device associated with the specified Connection Handle. On an authentication failure, the Controller or Link Manager shall not automatically detach the link. Instead you can issue a disconnect command to terminate the link if the action is appropriate.
This command is used to change packet types can be used for a connection that is currently established. This allows current connections to be dynamically modified to support different types of user data. Multiple packet types may be specified for the command parameter by bitwise OR operation of the different packet types.
This parameter defines the maximum time the local Link Manager will wait for a baseband page response from the remote device at a locally initiated connection attempt. If this time expires and the remote device has not responded to the page at baseband level, the connection attempt will be considered to have failed.
Broadcast packets are not acknowledged and are unreliable. The number of broadcast retransmissions parameter is used to increase the reliability of a broadcast message by retransmitting the broadcast message multiple times. This parameter defines the number of times the device will retransmit a broadcast data packet.
Ping a remote device which BDA was given as a parameter. The ping packet size is defined as the second parameter.
Print the link quality value. It ranges from 0-255, which represents the quality of the link between two Bluetooth devices. The higher the value, the better the link quality is.
Read the value for the difference between the measured Received Signal Strength Indication (RSSI) and the limits of the Golden Receive Power Range for a connection handle to another Bluetooth device.
The RSSI measurement compares the received signal power with two threshold levels, which define the Golden Receive Power Range. The lower threshold level corresponds to a received power between -56 dBm and 6 dB above the actual sensitivity of the receiver. The upper threshold level is 20 dB above the lower threshold level to an accuracy of +/- 6 dB.
This performs an automatic inquiry. Max_Period_Length and Min_Period_Length define the time range between two consecutive inquiries, from the beginning of an inquiry until the start of the next inquiry. The Controller will use this range to determine a new random time between two consecutive inquiries for each inquiry. The len parameter specifies the total duration of the InquiryMode and, when time expires, Inquiry will be halted.
Use these command to manage serial Bluetooth devices.
Currently SCP profile is supported only by PCMCIA cards. There are some problems using audio devices with USB dongles. The bda argument for the following command can be replaced by cache entry number (btclt list).
This is Ericsson specific command that sets the SCO data path. Setting 0x00 means that audio data is transmitted as usual using HCI. 0x01 means that audio is sent for example through PCM plug. This command needs hardware that supports it and has become nowadays almost obsolete.
Configure audio settings. Option 'on' enables audio support, the 'off' disables it. Option 'async' is used to enable the chip mechanism to signal affix to send packets to the chip. Option 'sync' is used to enable affix to send synchrnously SCO packets to the chip. Option 'setting' values can be found in section 6.12 page 387 in the BT Core V2.0 + EDR specification.