Palm OS How To: Step-By-Step

Setup a BlueSnapXP module with Palm TX using SerialMagic Pro Tx

SerialMagic Home

The BlueSnapXP Bluetooth RS-232 module is ideal for connecting to legacy RS-232 devices in a mobile environment and legacy RS-232 devices in general.

SerialMagic Professional Tx software for PalmOS is a powerful tool that can be used both for configuration of the BlueSnapXP and for capturing data from RS-232 devices connected to the BlueSnap.

This document details how to connect and configure the BlueSnapXP over a Bluetooth connection to a Palm TX. SerialMagic Professional Tx (SerialMagic Professional Tx was on the market before the Palm TX, the name match is coincidental)

The first step to configure the BlueSnapXP with the Palm TX is turn on the BlueSnapXP and make it a trusted Bluetooth device by "pairing" it with the Palm TX.

If SerialMagic Professional Tx is running tap the Bluetooth icon at the bottom of the screen of the Palm TX and you should see the screen below left. Then tap Prefs, and the screen below right should be displayed.

Now tap Setup Devices and the screen similar to the below left should appear. Any trusted devices that have been paired with the Palm TX will show up in this window. For a new Palm TX device this list will be empty. To add trusted Bluetooth devices to the list tap the Add Device button, and you should see similar to the screen below right, except for the Show: drop-down may have All known devices selected. If this is the case, select Nearby devices as shown. If the BlueSnap is not found, then tap the Find More button until it shows up.

If the BlueSnap does not show up, insure the power is on and the link LED is blinking. You can also press the reset button on the back of the Palm TX, as the Bluetooth stack on PalmOS can sometimes need to be reset.

Once you see the BlueSnapXP tap on it in the list (below left) then tap OK and you should be prompted for a passkey. The default Bluetooth passkey for the BlueSnapXP is 1234.

The passkey should then be accepted and you should see the BlueSnapXP in the trusted device list similar to the image below left. You can now switch to SerialMagic Pro Tx and select Device: Other and Choose new device, as shown below right then tap Start.

Tapping Start on SerialMagic should bring up the PalmOS trusted Bluetooth device list. Insure Nearby devices is selected, and the BlueSnapXP should be shown. Tap on the BlueSnapXP in the list then tap OK. The SerialMagic Pro Tx main dialog should then appear and you should see the Bluetooth connection established as shown below right.

Once you have an active Bluetooth connection you can tap the PalmOS menu key and select the Send Command option that will display the SerialMagic Send Command dialog. The 'XP Command Mode' (or whatever you would like to name the command) can be entered and defined as $$$, then select CR to be send following the command (see below left).

Once this command is defined (you may also want to save it using the Save button) the command can be sent by tapping the Send button. If successful the BlueSnapXP will return the "CMD" prompt indicating that it is in command mode. The link LED on the BlueSnapXP should also start to blink at a rapd rate to indicate command mode is active.

You can create any command in the Send Commands list to configure the BlueSnapXP.

Note: The SerialMagic Pro Tx Send Commands dialog can be used to send virtually any command to any device connected to the PalmOS device using Bluetooth, a Palm Universal cable, or a Palm Multi cable. The two images below show the result of sending the 'D' (Display Basic) command to the BlueSnapXP.