Smart Dog BackTalk User Guide

Contents

Registration

The BackTalk ObEx Stack requires registration in order to run. (None of the other Smart Dog BackTalk modules currently available require registration.) If the stack module is not registered, or is registered with an incorrect registration code, the following warning will appear whenever you try to send or receive using the BackTalk ObEx Transport:

Registration can be done through Kagi's web site, or through e-mail via the Register application. Be sure to send your Owner Info name, or your NewtonID name, as the registration code will be generated from one of those names.

Once you receive your registration code, go into the Extras drawer, choose Extensions from the tab at the top, and find the ObEx Stack icon:

Click on the icon; the following screen will appear:

Enter the registration code in the field provided. When the code is correct, the field will become non-editable (to avoid unintentional changes).

Sending with the BackTalk ObEx Transport

Inside an application, click on the action button, and choose Beam:

The beaming envelope appears.

(If the beaming envelope does not appear, and instead beaming starts immediately, go to the Extras Drawer, choose the InOut Box, and click on the Information button in the lower-left corner. Choose Beam Preferences, click on When beaming, and select Specify when.)

Click on the stamp in the upper-right corner, and choose ObEx, to activate the BackTalk ObEx Transport:

The beaming envelope will disappear, and will be replaced by the ObEx envelope:

Underneath the envelope is an Encode as: field. Use this to choose an encoding for the data you have selected. Available encodings will depend on what InterChange translators are present in your Newton, and can include some or all of:

Choose the desired encoding from the selector. Then click on the ObEx button; depending on your settings in the In/Out Box, the object will either be sent immediately, or will be submitted into the Out Box for later transmission.

The Out Box

If Later is chosen, the object is encoded and stored in the Out Box. The Out Box will appear something like this:

The encoded item itself can be viewed by clicking on it. It will look something like this:

The Headers are standard IrDA IrOBEX headers that describe the object. The data, which can be displayed as ASCII or in hexadecimal, is displayed below.

The view can be closed with the close box in the lower right-hand corner. Then click on the Send button, and choose ObEx:

The BackTalk ObEx Transport will then open a connection.

Sending Immediately

If the Preferences for the BackTalk ObEx Transport are set to send data immediately, or if a Send ObEx operation is started from the Out Box, the following status dialog will be visible:

Move a receiving device (such as a Palm device, set in its Prefs application to have Beam Receive: On) into range of the transmitter on the Newton.

The transfer should begin automatically, and finish automatically, with status dialog boxes indicating the state of the transfer. If something goes wrong, see Troubleshooting.

Receiving with the BackTalk ObEx Transport

First, open the InOut application, and choose the In Box radio button. Then click on the Receive button, and choose ObEx from the menu:

The BackTalk ObEx Transport server will begin to run; the following dialog will be displayed:

indicating that the server is waiting for a peer device to begin a connection.

Bring another device within range of the Newton's infrared receiver, and begin a beaming operation. The Newton should receive the data automatically, and return to Listening status, to allow more items to be received.

When all desired items are received, click the Stop button on the Listening dialog box.

The received items, still in binary format, should be visible within the In Box:

The received items can be displayed in their binary format by clicking on them.

Translating binary objects

Select the checkbox of the desired item or items, and then click on the tag button at the bottom of the view. Alternatively, click on the item to view it, and then click on the tag button at the bottom of the view:

A set of available translations will appear. Choose the desired translation; when the translation is complete, a new object will appear in the In Box:

This new object is of the chosen type. It can be examined in the In Box, operated upon, and Put Away with the tag button normally.

Some aggregate items (in particular, VCF and TXT files representing Palm categories) will translate to multiple objects. Each object will appear individually in the In Box after translation.

Note that the original binary object will remain in the In Box until you dispose of it yourself.

See also

[an error occurred while processing this directive]
This page was last modified on April 24, 2001.