Support : Industrial : AIRcable AIRmotes Programming Handbook : PART 1

PART 1: Access to the AIRmote

The AIRmote has three access interfaces available over the air.
(Our previous AIRcable Command Line Interface through the UART serial interface is no longer available.)

• OBEX FTP file transfer (client and server)
• OBEX item exchange (client and server)
• SPP port interactive (master and slave)

Using another Bluetooth compatible device, such as a PC or Palmpilot, the AIRmote can be detected and will, by default, display the OBEX FTP profile and the OBEX item-exchange profile. The OBEX FTP allows users to access the file system and to configure the AIRmote device.

Two files are always present:

• AIRcable.bas
• config.txt

These files are for the configuration of the AIRmote. AIRcable.bas is the BASIC program, and config.txt is the persistent configuration.

In config.txt, further configuration can be disabled. This will prevent upload, download and changing of these two files. The FTP protocol will still allow access to user files stored in the file system of the AIRmote.

The OBEX item-exchange profile is used for communicating with other AIRmote devices. For further details, see Part 3, Message Passing.

Configuration

The file config.txt contains the configuration of the AIRmote. This file is downloadable from the AIRmote to the PC so that PC users can view the configuration. It is also uploadable from the PC to the AIRmote so that the user can configure the hardware and the Bluetooth radio.

The configuration is a string of 16-bit hex numbers. The first hex number starts with "@" and the address of the configuration parameter. Then the syntax requires a space, an equal sign, and another space. A number of hex values follow.

Example: @0000 = 00c2 0104 0014

These configuration variables are defined as follows:

• Date
  This configures the internal real-time clock with this date string.

  // date @cccc = 20050828T005500Z

  8/28/2005 Time = 00:55.00 Zulu

• Bluetooth class of device definition
  The class definition is a 24-bit value according to the Bluetooth-assigned numbers. The default is 00c2 0104, describing a PC.
  
  The second number is the version of the configuration file that is defined by the version number of the current firmware. A configuration file without the matching firmware version number is rejected.
  // BT Class of device & version
  @0000 = 00c2 0104 0014
• Bluetooth device name
  This string can be up to 32 characters long. Every character is a 16-bit value, but only uses the lower 8 bits.
  // Name of device
  @0001 = 0041 0049 0052 0070 0068 006f 006e 0065 0020 0031 0032 0000
• Bluetooth sniff parameter definition
  Sniff interval and sniff window, maximum, and attempts are specified for power saving modes during a valid Bluetooth connection.
  

  // sniff max, min intv, attempt, timeout @0002 = 0150 0050 0002 0028

  = 150 ms, 50 ms, 2 attempts, 28 sec timeout

  NOTE: In the current version, these parameters cannot be changed.
• Bluetooth scan parameters
  Page interval and window scan interval, and window parameters specify the radio parameters while waiting for a connection. The defaults are: 0800 0012 1000 0012, the lowest possible values are designed to save battery life.
  // pg scan intv, wind, inq scan intv, wind
  @0003 = 0800 0012 1000 0012
• Bluetooth RF transmit power
  Default and maximum output power of the radio is specified in dBm. Maximum output power is 6 dBm (6dBm = 4mwatts).
  // default and max RF output power
  @0004 = 0000 0006
• PIN code configuration
  The PIN code is the first level of authentication to allow access to the AIRmote device. If the BASIC program does not respond to PIN code requests, this PIN code is used.
  // default PIN code
  @0005 = 0030 0030 0030 0030
• Security Configuration
  These parameters configure access permission to the file system (Obex FTP) and the message passing system (Obex vNotes, biz cards). For details please refer to the chapter about Security.
• UART configuration parameters
  These parameters indicate the baud rate, stop bits, and parity configuration.
  // baud rate, stop bits, parity
  @0007 = 009d 0000 0000
• Analog-input Correction Factor
  This value corrects the samples analog input from AIO0 to the actual value. The input range is 0-1.8V. When a voltage divisor network is used, the correction can be made here. A decimal value of 1000 means a correction of factor 1.0. Note, the values are set here in hex.
  

  // analog input correction @0008 = 03e8
  	= hex 0000 0011 1110 1000 = decimal = 8 + 32 + 64 + 128 + 256 + 512 = 1000 (1.000)

Example config.txt file: