PuppetMaster Quickstart guide for Java GPRS Phones

The Java GPRS client uses your mobile network to communicate data. In many countries, this is cheap or free, but for some networks, this could be very costly.

DO NOT USE THE JAVA GPRS CLIENT/SERVER IF PUPPETMASTER SUPPORTS AN ALTERNATIVE FOR YOUR PHONE.

DO NOT USE THE JAVA GPRS CLIENT/SERVER IF YOU DO NOT UNDERSTAND HOW YOU ARE CHARGED FOR GPRS DATA.

A typical interactive PuppetMaster session will consume between 10kb to 15kb per minute of operation.

Setting up PuppetMaster involves the following steps

1. Download and Install PuppetMaster
2. Transfer the Java client to your phone
3. Setting up PuppetMaster under Windows as a client
4. Determining the correct connection address to use
5. FAQ

1. Download and Install PuppetMaster

Go to http://www.lim.com.au/PuppetMaster

Select the download page and click on the “Windows Installer” package.

Save the file to your computer. When it has finished downloading run the installer.

2. Transfer the Java client to your phone

You will either need a serial cable, usb cable or bluetooth connection to send the java client to your phone. For Nokia users, Nokia Application Installer is strongly recommended.

The file is included with the PuppetMaster distribution - you can normally find it at:

C:\Program Files\PuppetMaster\Java GPRS Client\PuppetMasterGPRS.jar

Alternatively, if you your phone supports downloading .jar files, you can get it from:

http://www.lim.com.au/PuppetMaster/PuppetMaster.jar

3. Setting up PuppetMaster under Windows as a client

Run PuppetMaster. Click on Preferences. Under Device selection, click to add a new device.

When the “Add Device” dialog shows, select “Server for Java Phones via GPRS.”

4. Determining the correct host address to use

Launch PuppetMaster on your phone. A list of connections will be shown - but if it’s the first time, you’ll just get the option to add a new connection.

Give the connection a name – any name will do (or just use the default of “Personal”).

If you are connected to the internet directly [ie. Modem, ADSL Modem (but NOT ADSL router)], then PuppetMaster on Windows should show the address to use. Use the section before the “:” – eg. If PuppetMaster says “123.145.167.189:20557” then enter “123.145.167.189” as the Host. If you are NOT, then

If you do NOT connect to the internet directly, then you will have to set up your router to forward the ports to your computer. You will also have to determine what your world-visible IP address is. Since this is different for every manufacturer and device, this is out of the scope of this document, but a few pointers are given:

http://www.google.com/search?q=server+behind+router&ie=UTF-8&oe=UTF-8

http://www.google.com/search?q=port+forward+server&ie=UTF-8&oe=UTF-8

For the Port setting, the default of 20557 should work fine. Advanced users may want to change this.

The password setting in the options must match whatever password you’ve typed in for the Java server in Windows. This password is required to prevent unauthorized access to your computer. It defaults to an empty password – so you can test out PuppetMaster easily - but you should change this if you intend to leave PuppetMaster running.

5. FAQ

Q: I’ve set up everything correctly, but PuppetMaster (Java Client) just says “Connecting” indefinitely.

A: Most probably, the host address is incorrect. If you’re sure you’ve got this right, then you may be out of luck - not all mobile networks support the connection required to run PuppetMaster.

Q: There is a long delay between pressing a key and receiving a response. What can I do about this?

A: Unfortunately, sending data via the mobile network is considerably slower than bluetooth connections. Also, the latency of data passing through the network is highly dependent upon your carrier. Depending on the speed of your own internet connection, you may find that the response improves if you are not using it for any other activities.