7.1. Terms

Bluetooth address (bdaddr) consists of six hex digits separated by a colon. For example, "00:07:80:80:bf:01". With commands requiring a Bluetooth address, you can also use the Bluetooth friendly name instead.

Bluetooth RFCOMM channels are numbered from 1 to 30. In Access Server, Serial Port Profile is assigned to channel number two, Object Push Profile and File Transfer Profile to channel number three, and LAN Access Profile is on channel number four. The other channels are free for user applications.

Link Identifier (link_id) is a number from 0 to 99. It is used to identify established Bluetooth connections.

7.2. Starting iWRAP

Normally, the iWRAP servers are started automatically upon power-up. You can restart them manually (for example, to apply changes made to the iWRAP settings with the setup application without rebooting the system). To restart the servers manually, execute the startup script with option restart:

[root@wrap /] service bluetooth restart

When the iWRAP servers start up, they use settings configured with the setup application. You can put additional iWRAP commands to /etc/bluetooth.conf file. Commands in that file are processed as the last task every time the iWRAP server is started.

7.3. Writing iWRAP Applications

There are two approaches when writing a iWRAP server program (a program accepting incoming calls) for Access Server, both having different pros and cons:

1. Forklistener

2. iWRAP Client

7.4. btcli - iWRAP Command Line Interface Utility

You can send iWRAP commands from the command line by using the btcli application.

Usage:

btcli [options] command

To see the command options, enter the btcli --help command.

The specified command is sent to iWRAP server (the first server at port 10101 by default) and all replies are echoed to the standard output. The application waits and prints the replies for a certain amount of time (6 seconds by default) and exits.

7.5. iWRAP Commands

7.6. Finding Bluetooth Devices

7.7. Bluetooth Connections

7.8. Service Discovery

This section describes the commands used for Bluetooth service discovery and local SDP record manipulation. The commands and their replies use SDP UUID and attribute values, which are listed in the Bluetooth Assigned Numbers documentation. In the commands below, the most useful UUID and attribute values can, however, be replaced with keywords listed in Table 7-5. The same keywords are used in the command replies instead of numeric values, if the parameter SET BLUETOOTH READABLE is set to 1.

7.9. Example Sessions

Outgoing RFCOMM Call:

      READY.
      CALL 00:07:80:80:bf:01 1 RFCOMM
      CALL 2
      RINGING 2
      CONNECT 2 RFCOMM 1042
      STATUS 2 MSC 8d
      <Client opens socket connection to port 1042 and transfers data>
      CLOSE 2
      NO CARRIER 2 ERROR 000
    

Incoming RFCOMM Call:

      READY.
      RING 2 00:07:80:80:bf:01 1 RFCOMM 1042
      STATUS 2 MSC 8d
      <Client opens socket connection to port 1042 and transfers data>
      NO CARRIER 2 ERROR 000
    

7.10. Error Codes

Some commands may reply with an error code. The human-readable name of the error is displayed, if the SET BLUETOOTH READABLE setting has value 1. Error code 8 indicates that the iWRAP server is busy executing a number of commands; there can be several client applications using the stack. Just wait a few seconds and try again. Other error codes indicate unexpected, but often only temporary, communication problems.

You can analyze the error from the numeric code. Values bigger than or equal to 900 are iWRAP errors, described in Table 7-7.

Other error codes can be analyzed as follows. For example, NO CARRIER ERROR 465: The number 465 is hexadecimal, the sum of 0x400 and 0x65, where 0x400 is a mask, which means that this is an RFCOMM level error. 0x65 (decimal 101) means that the RFCOMM error was a connection timeout.

The error codes for each mask are listed in the following tables.

If the problems persist after restarting the communication parties, please contact Bluegiga Technologies as instructed in Section 1.2.