Command Line Interface

Thank you for purchasing an AIRcable. Your satisfaction is very important to us, so please read this guide before installing your AIRcable modules. We'd appreciate your feedback

AIRcable modules are intelligent and run firmware-based onboard Bluetooth connection software. Other than a USB class driver for virtual COM ports for the AIRcable USB on Windows, there is no need to install and configure extra software to establish a wireless connection. Because the AIRcable is designed to replace physical connections, you can run the same software that would support a physical cable.

Each module has a button accessible through a hole in the device which is used to pair two modules to become a point-to-point "Wireless Cable(TM)". During this pairing process, make sure no other Bluetooth device is discoverable within range (approx. 10 meters).

Each module has one power LED (green) which shows that the firmware is running correctly and a connection LED (blue) that shows the status of a connection. The connection LED is on solid if a connection to another device is active. Otherwise it is blinking or it is off.

Establishing a Command Line Interface Connection With Your AIRcable Module

This has already been addressed in the Quickstart guide. Click here to go directly to it.

Cable Mode

In cable-mode, two AIRcable devices are paired together and create a bond so no other device can interfere.

To pair two AIRcables use this simple procedure:

  1. Press and hold the pairing button for 5 seconds. The AIRcable module automatically configures itself and starts in slave mode. The power LED (green) will be on again and the connection LED (blue) starts flashing rapidly.
  2. Do this on both devices that are going to be paired.
  3. On one device press the pairing button again (short click) to change the mode to master.
    At this time the two devices will find each other, pair and establish a connection.
  4. The pairing information has been stored in flash and the two AIRcable modules will connect automatically when they are powered on. No other device can connect to either AIRcable.

Advanced Modes

Our AIRcable products "AIRcable Serial", "AIRcable USB", "AIRcable Zaurus2" and "AIRcable for Nextel" can be set into various advanced modes. Use the command line interface to change into these modes.

Using the Command Line Interface

To utilize the command line interface, you must plug the AIRcable serial device to a com port on your computer. Male plugs will require a null modem cable. Power must be applied to the unit through it's power jack or through the pins as described in this manual. A terminal program can then be used to access the settings.

The serial parameters for the command line interface are fixed at:

Each command starts with a "^A" (control-A or 0x1) character, then follows one of the commands listed below in all caps letters and finishes with a single <CR> (carriage return or 0xd). The command has to be completed within 3 seconds. Otherwise the received characters are deleted and ignored. All commands respond with an "OK".

Be aware that some commands in some states require the device to reset. They are marked with (*). This process will take a few seconds during which the AIRcable will not respond to any commands. The power light will go out briefly.

Service-Slave Mode

In the Service-Slave Mode, the AIRcable allows other Bluetooth devices to connect to it. This mode can be used to allow a Palm with Bluetooth or a Laptop with Bluetooth support to connect. The main advantage of this mode is that it allows several devices to connect to it as oppose to the previously described point-to-point cable modes.

In order to switch the AIRcable module into "Service-Slave Mode" use the command line interface detailed below. This is just an example. Please adjust the commands to the situation you need, including your security needs.

Service-Master Mode

The Service-Master Mode is the counter part to the Service-Slave Mode. It can be used as a master to connect to several Bluetooth devices which are in range, one at a time. The advantage is that it does not require pairing or bonding with the other end. It is a truly automatic-connect to many other Bluetooth devices. Certainly you can configure automatic pairing with a PIN number of your choice.

For example, it can connect to Bluetooth scanners without pairing it to a particular one. In this case the Service-Master AIRcable would be configured with the PIN number of the scanner (often "0000") with authentication enabled and it will automatically connect to the first scanner it finds. You can change the scanner without changing the configuration.

The Bluetooth Service-Master Mode can also be used to connect to a number of AIRcable devices in Service Mode. This is designed for field usage where the AIRcable Service modules are stationary and the AIRcable Master-Service is mobile going from one Service module to another. Again this is an example. Adjust to your needs.

Manual Mode

The manual mode is designed to give Bluetooth support to devices that cannot run a full Bluetooth stack. The command line interface is a collection of the simple most common Bluetooth commands. It allows the discovery of other devices, pairing, inbound slave and outbound master connections and disconnect by software.

You should understand Bluetooth before you can use the manual mode. Please contact us if you have any questions.

Disconnect by Software

Once a connection is established the command line interface is no longer available since all input and output is routed through transparently to the other end.

In this mode it is possible to disconnect a link programmatically. Depending on the type of device (DTE, DCE or USB) your software would disable either the DTR or the DSR line, whichever is an input on the AIRcable side.

List of Commands for the Command Line Interface

"H" Shows status of the AIRcable
"B" Print its own BT address: "ADDR: 1A2B3C4D5E6F"
"O" Print or set "Class Of Device". Example: "OC20104" sets class of device to INFO+MODEM+NET, major PC, minor DESKTOP, see "Bluetooth Assigned Numbers" documentation (*)
"P" Display PIN number: "PIN: 12345"
"P12345" Set PIN number to "12345", and enable authentication. Pin number can be between 2 and 5 digits long.
"PD" Disable authentication but keeps the PIN number if another device asks for it. For slave mode only.
"PU" This command creates a unique 5 digit PIN number and appends it to the name.
"E" Disable encryption mode: "encryption disabled"
"E1" Example: enable encryption mode.
"N" Returns the name of the device: "AIRcable"
"NAIRcable" Set name to AIRcable, name has to be exactly 8 characters, fill up with space if required name is shorter.
"I" Do an inquiry scan for default 11 seconds. The following commands are useful only in manual mode. Upon start it will respond with: "INQUIRING". At the end it will print "OK".
"I90" Do an inquiry scan for 90 seconds, number must be between 1 and 90 seconds. The result for example looks like: "1A2B3C4D5E6F, class 0xC20104, name AIRtag 12345".
"CS1A2B3C4D5E6F" Connect as master command. Use authentication as configured. Example: connect to this BT address at port serial. Second letter specifies the port to connect to: S-serial D-dialup L-lan or O-obex. The command responses with "CONNECTING", then "CONNECTED" or "FAILED".
"R1A2B3C4D5E6F" Manual pair request. This pairs the AIRcable with the partner specified with the address. It uses the PIN number configured. The the AIRcable stores the link key it receives to be used in a subsequent connect command. The command responses with "PAIRING" and then "OK" or "FAILED".
"L" Read the link key that was stored by previous commands.
"L1234567890ABCDEF..." Set the link key. These are 32 hex numbers.
"D" Display the services enabled, it is a hex number that is or'd from these services: serial 0x8, dial up 0x4, lan 0x2, obex 0x1.
"DDSDLO" Set discoverable mode and advertise SPP (serial), DUN (dial-up), LAN, OBEX profiles. First specify if the device should be discoverable "D" or not "U", then select the profiles: S-serial D-dialup L-lan or O-obex. (*)
"DU" Make device undiscoverable, keep the selected profiles.
"S" Slave connect command. This is a one time slave command for 11 seconds. After that the devices is in manual mode again. The command responses with "OPEN" and then "CONNECTED" or "FAILED".
"S20" Start slave connect for 20 seconds. If authentication is enabled the PIN number configured is being used. You can specify up to 90 seconds.
"A" Display automatic mode (manual=0, master=1, slave=2, service=3, service-master=4)
"A0" Manual mode
"A1" Cable-slave mode. The AIRcable becomes discoverable and will be in pairing mode if no pairing information has been stored. Then it will be not discoverable and will allow connections only from the paired partner. In this mode, only the SPP profile is active.
"A2"

Cable-master mode: do inquiry first, then pairing with the configured PIN number, then connect as master (not discoverable).

"A3" Service-slave Mode: Use the authentication, profiles, pin number and name configured before. (*)
"A4" Service-master mode. If authentication is enables it first discovers a partner, tries to pair with it and makes a connection. If authentication is disabled, it discovers a partner and tries to connect to it. It uses the PIN number configured before.
"U" UART configuration command. Display the settings in hex: "UART: 0x6". It is an add up of the following: external switches enabled: 6, even parity: 4, odd parity: 2, two stop bits: 1.
"UN1E" Configure the UART: First letter is parity: none=N, E=even, O=odd. Second is number of stop bits: 1=one, 2=two. Third letter enables the external baud rate switches: external=E, internal=I.
"UE2I" Example 2: Even parity, 2 stop bits, internal baud rate settings.
"UO1E" Example 3: Odd parity, 1 stop bit, external switches enabled.
"T" Display the baud rate of the UART after a connection has been established. "BAUD: 0" means that the external switches determine the baud rate.
"T472" Set the baud rate while connected to this value. It is a 3 digit decimal value with leading zeros to this formula: baud * 0.004096. Example: set baud to 115200. (*)
"K" AIRcable USB only: command to configure hardware handshake
"K1" Disable hardware handshake, this is for poorly written MS applications. Use the dip switches on the AIRcable Serial modules.
"Z" Remove pairing information and go into manual mode (*)
"X0" Disable debug mode
"X1" Switch debug mode on, print status information
"Y" Send a "cancel" command to abort any ongoing activity.
"K" AIRcable USB has the ability to switch off hardware handshake. Use "K1" to disable hardware handshake and "K0" to enable hardware handshake.
"F" Display the sniff max interval: "SNIFF 0x0"
"F000" Specify the maximum sniff interval for slave connections. "000" means, sniff is off, "540" is the maximum. The three digits are in hex specifying the number of slots.
"V" Display the page scan interval window: PAGESCAN INTV/WIND: 0x800/0x12"
"V08000012" Set the page scan interval to 0x0800 and the window to 0x0012

 

Note that the (*) in the description means that this command may reset the processor. Wait for 3 seconds before issuing another command.