Support : Industrial Male : AIRcable AIRmotes Programming Handbook :

AIRmote Firmware

Since Version 22 the AIRcable Industrial devices' firmware can be upgraded using the serial port.

You will need a Bluetooth USB dongle for your computer. Install the Bluetooth dongle on your machine. Follow the manual from the Bluetooth USB dongle manufacturer for Windows XP. XP already has Bluetooth software installed. Please make sure that there is no conflict between two different Bluetooth software installations.

To Upgrade AIRcable Industrial Male Firmware

Download the Upgrade Wizard and new version of the AIRmote firmware

1. Install the AIRmote_upgrade_wizard.zip on Windows by unpacking the file into a directory of your choice. The directory name is "DFU Wizard".
2. Download the new version of the AIRmote firmware and unpack the file. Filename is "AIRmote_Firmware_R25.dfu" for example.
3. Download the "update program", download it here. Installing this program puts the AIRcable into an update mode.

Access to the AIRcable Industrial

1. Start Bluetooth with "Explore my Bluetooth Places" by clicking on the Bluetooth B icon on your desktop.
2. Click on "Search for devices in range".
3. Find the "AIRcable 12345" and double click on it.
   
4. You see the services the AIRcable Industrial provides. Double click on the OBEX FTP to see the files.
   
5. It will ask for a PIN code. It is "1234" by default. You must be able to see files using the Bluetooth OBEX file transfer on the AIRcable Industrial.


6. Drag and drop the upgrade AIRcable.bas program onto the file. It is in the folder UPGRADE_SW The file name must be AIRcable.bas. Do not rename. Click OK to overwrite the existing program.
7. Now the AIRcable is in upgrade mode. Look at the green LED, it will come on and stay on.

Upgrading the Firmware

1. Plug in the RS232 Null-Modem cable into the PC COM1 port and into the AIRcable Industrial.
2. Start the upgrade wizzard: DFUWizard.exe
   • click NEXT
     • select COM port (RS232)
   • click NEXT
     • select COM1
     • unselect "automatic detection"
     • set baud rate to 115200 baud
     • select H4 protocol
       
   • click NEXT
     • select Download with saving of the current version
   • click NEXT
     • select the firmeware file "AIRmote_Firmware_R25.dfu" (or newer) by browsing for the firmware file.
       Do not attempt to use any other CSR Bluetooth firmware or stack software, since it is not compatible, only use AIRmote firmware supplied by Wireless Cables Inc.
       
   • click NEXT
     • review the summary
   • click NEXT
     • firmware upload will be started.
       Do not abort or interrupt since it will render the unit inoperable. It will take about 2 minutes for the download and 2 minutes for the upgrade. File system space needed for the old firmware is 750kByte.
   • click FINISH
     • power cycle the AIRcable Industrial

New Application Install

1. Now install the new application since the new firmware has deleted the BASIC program and the configuration. Make sure the config.txt file matches the version number of the new upgraded firmware. In this case config.txt must show version 0x0018 (version 24).
2. Use the same steps as outlined above.
   • Find the "AIRcable 12345" again using the Bluetooth Neighborhood. You already have the pairing stored.
   • Go into the OBEX FTP folder, drag and drop the new config.txt file and then the new application file AIRcable.bas into this folder.
   • Everytime confirm the overwrite.
   • The files are in the "AIRind_smallslave" folder in the download file.

Version History

Latest Version:

VERSION NUMBER 25, 4/26/06

• Download AIRcable Industrial version

VERSION NUMBER pre-26, 4/26/06

• Download AIRcable OEM version

Version 25 Release

• CAPTURE instruction behaves better when timeout
• PRINT $0[0] will print the character stored at that location and not the integer number. Also null-characters can be output.
• Fixed bug in the printing of null-characters like "\x00" in a string.
• The build-in function nextsns can now schedule sensor readings beyond 60 seconds up to 16383s, which is 4.5h.
• added two new built-in functions: enable and disable. Disable removes the FTP or OBEX record. Parameter is a bitmap. 1 is the FTP service, 2 is the OBEX service. 3 as a parameter means that both FTP and OBEX services are disabled. Enable enables the service records again.
• change of getuniq function: this function gets a string parameter and prints the unique number into the first 5 characters of this string, with leading zeros.
• Transmitting data on channel UART and SLAVE at the same time can lead to overflow of stack. Fixed.
• Inquiry process is now reliably finding all devices
• The BASIC shell does not longer start automatically on slave connections. This allows the BASIC program to read data later which was sent to the SLAVE port. Otherwise the shell would have consumed it. We added a built-in function "A=shell" which starts the shell in the @SLAVE routine when the user needs it. See new smallslave.bas program.
• The timeout for data input which is not read immediately is changed from 2 seconds to 3 seconds.

Release Notes

• 1/18/06
  • UART command now puts the number of bytes read into the variable given as parameter
• 1/20/06
  • failed to ftp a file now closes the file descriptor
• 2/2/06
  • master connect changed from no parameter to string parameter address can be in the parameter like: A = master $1
  • added new built-in function: "unpair", it removes the pairing information from a single bt address given or it remove all stored pairings when parameter is 0. Note, the first paired device is considered the default device and cannot be removed individually.
  • Added function getconn to return the address of the recent SPP connection to the BASIC program. The application can then find out who has connected. It can be used for unpair or disconnect.
  • PIN code length limited to 15
  • ALARM 0 now cancels a previously scheduled ALARM
• 2/4/06
  • added @UNPAIR to the BASIC file, it will remove all pairing information stored from other devices
  • shell's version number will print the compile date
  • added two functions zerocnt and readcnt, which is a second counter. zerocnt resets the counter. readcnt returns the number of seconds passed, range is 16383 seconds
  • the following interrupt routines are indeed interrupting the BASIC program execution: pair request, inquiry result, message and alarm. All other routines are scheduled for execution after all other scheduled tasks are completed.
• 2/9/06
  • fixed bug in "strcmp" when comparing an empty string with a nonempty. It returns -1.
  • added function "dfumode" to put the device into firmware upgrade mode
  • when the security disable jumper is plugged in during reboot, the device will automatically go into firmware upgrade mode
  • the function "slave" now takes negative numbers. It means that the unit becomes undiscoverable for that amount of time.
• 2/11/06
  • added BASIC variable U for debugging. If U = 1 the lines the BASIC interpreter executes are printed on the UART.
  • the shell now echos the value of BASIC variables, e.g. "echo A" prints the content of variable A, "echo $0" prints the string in $0.
• 2/14/06
  • more variables can be used now, from A - Y (Z is special)
  • added BASIC variable Z for debugging. If Z = 1 the lines the BASIC interpreter executes are printed on the UART. If Z = 2, it prints to the slave port, if Z = 3 it prints to the master SPP port.
  • the shell can now print the value of BASIC variables, e.g. "PRINT A" prints the content of variable A, "PRINT $0" prints the string in $0.
  • Fixed bug, A = $0[0], if $0[0] is negative (8 bit) then A is negative too (16 bit)