About Sun SPOT Manager

Sun SPOT Manager Tool version 2.0

The Sun SPOT Manager Tool is a Java WebStart Application made up of several tabs, each managing a different part of the Sun SPOT development and deployment SDK. The tabs are organized as follows:

	The Sun SPOT Tab helps you manage the software installed on your individual Sun SPOT devices, allowing you to quickly and easily upgrade the installed VM and libraries, select and manage basestation SPOTs, and enable and disable some common settings on your Sun SPOT Devices like the Over The Air (OTA) Command Server, shared or single-user basestations, etc.
	The Sun SPOT SDK Tab controls the installation, activation, and other activities around installing, updating and managing Sun SPOT SDK Software on your host computer.
	The SPOTWorld Tab is an easy place to begin your investigation of the SPOTWorld Application included with the Sun SPOT Developer SDK. See the SPOTWorld section below for more information.
	The Preferences Tab allows you to control certain aspects of the Sun SPOTManager Tool. See the Preferences section below for more information.
	The Docs Tab gives you instant access to the the complete documentation for the currently active Sun SPOT SDK. You can easily browse the Javadoc and Tutorials right in the Sun SPOT Manager tool, or launch the Application Notes (PDF) in an external viewer.
	The Console Tab gives you access to the output from the Sun SPOT SDKWorks tooland any of its sub-processes. If something is not working the way you expect it to, check the console tab for any errors. The Console tab will turn red when there is new output in the Console, and will return to black once you have clicked on and viewed the contents of the Console.

Interaction with and Management of Sun SPOT Devices

Update the Firmware on your SPOTs to the currently active SDK Firmware. This button will install the firmware/powercontroller/libraries/etc. from the currently active SDK to your Sun SPOTs. You should connect your Sun SPOTs, and either select the individual SPOT(s) you wish to upgrade or select "All Connected Sun SPOTs" to upgrade them all.

Enable or Disable the different BaseStation Modes on a SPOT or SPOTs. Select the Sun SPOT or Sun SPOTs from the list, and enable the selected BaseStation Mode on that Sun SPOT.

Start Basestation: Starts a single-user basestation on the selected Sun SPOT or Sun SPOTs.

Start Shared Basestation: Enables and starts the Shared Basestation feature. This command adds the property multi.process.basestation.sharing=true to your .sunspot.properties file and then starts the Shared basestation.

Stop Shared Basestation: Disables the Shared Basestation feature by removing the multi.process.basestation.sharing=true property from your .sunspot.properties file. This command does not quit any already-running shared basestation processes.

Run "ant info" against a specific Sun SPOT (or All Connected Sun SPOTs) to see what firmware revision and/or application is currently installed on the Sun SPOT.

Enable or Disable the Over The Air Command Listener (OTA) on the selected Sun SPOT device, or on All Connected Sun SPOTs. This will allow you to deploy code to Sun SPOTs that are not directly connected to your host computer. This button uses a pop-up menu like the Basestation button to select Enabling/Disabling of the OTA Command Listener.

Note: It is not advisable to enable the OTA Command Listener on a Basestation Sun SPOT.

Management of Installed Sun SPOT SDKs

Manage locally installed versions of the Sun SPOT SDK

Instant activation of any installed Sun SPOT SDK

Add Comments to any installed Sun SPOT SDK. Comments added this way will be added to the SDK's version.properties file and will be visible in the SPOTManager tool

Rename any installed Sun SPOT SDK

Safely delete any installed Sun SPOT SDK (Note: You cannot delete the currently Active SDK. To delete it, make another SDK Active, then delete the desired SDK, or use the "Remove SDK" button on the Preferences Tab to remove all Sun SPOT Software).

To view Release information of any installed Sun SPOT SDK , just click on the "Sun SPOT SDK (SDK Info)" link inside the SDK folder.

Upgrade, Downgrade, or Re-Install Sun SPOT SDKs

Install any available Sun SPOT SDK from the update server

Refresh the list of available Sun SPOT SDKs (this list is not automatically refreshed on a schedule).

To view Release information of any available Sun SPOT SDK , just click on the "Sun SPOT SDK (SDK Info)" link inside the SDK folder.

Manage Sun SPOT Demos

Instant notification when new Sun SPOT Demos are made available

Visual confirmation that your Sun SPOT SDK Demos are up-to-date

Note: When active, clicking this button will install new Sun SPOT SDK Demos when available

Manage Sun SPOT SDK NetBeans Modules

Instant notification when new Sun SPOT SDK NetBeans Modules are available

Visual confirmation that your Sun SPOT SDK NetBeans Modules are up-to-date

Note: When active, clicking this button will install or upgrade Sun SPOT SDK NetBeans Modules when available

View SDK Documentation

View all included SDK Documentation via links in each listed SDK

PDF Files viewable if a suitable PDF Viewer is installed for your platform

Tutorials loaded in your default browser (platform dependent)

Javadoc loaded into your default browser (platform dependent)

Readme and other txt files loaded in platform-dependent text tool

View the included Application Notes in default PDF Viewer (platform dependent)

Set Up and Run the Sun SPOT World Application

Start the Sun SPOT World Application. You should already have set a Sun SPOT as a BaseStation from the Sun SPOT Tab, and have that Sun SPOT selected from the menu.

Sun SPOT Manager Preferences

Clicking this button will completely remove the Sun SPOT SDK from your computer. This removal cannot be undone! All of the Sun SPOT SDK Components will be removed from your system, including Demos, Sample Code, Documentation, SDK Properties, and any work you may have saved in the Sun SPOT SDK Directory. Use this button very carefully, as it cannot be undone!

Proxy Settings The Sun SPOT Manager Application now supports various kinds of Network Proxies. If you are behind a firewall or Network Proxy, select 'Use Proxies' and then fill in the appropriate settings. If you are unsure of the settings, please consult your Network Administrator. If any field is not required (i.e. Username or Password) just leave it blank. When your settings are correctly entered, click "Set Proxies" to save and enable your proxy settings. These settings will be remembered and reloaded on subsequent use of the Sun SPOT Manager Tool.

Beta vs. Release The Sun SPOT Manager Application now supports both released versions of the Sun SPOT SDK (no password required!) and Beta Versions of the Sun SPOT SDK (password may be required). If you select the Beta update site, you may need a Beta username and password from the Sun SPOT Development team.

Network Timeout This setting will change the amount of time between various checks performed by the Sun SPOT Manager application. If your computer is connected to the internet, the Sun SPOT Manager will periodically check for updates to the Sun SPOT SDK, the Demos, Sample Code and the NetBeans modules. This setting determines the amount of time between such checks. If your computer has been off-line, any change to this setting will force an immediate reconnection and network check of all components.

Console Output from the Sun SPOT Manager Tool

See all output from the Sun SPOT Manager tool

Report an issue with your Sun SPOTs to the Sun SPOT Engineering Team.

This will gather information on your system configuration and any connected Sun SPOTs and send it directly to the Sun SPOT Engineering Team for evaluation. If you are having trouble with your Sun SPOTs, and you cannot find an answer on the Sun SPOT World Forums then this might be a good option.
Note: This does not submit a bug report, but only submits your configuration and any output from any Sun SPOTs to the Engineering Team for evaluation.

Web Site

This button (available from anywhere in the Sun SPOT Manager Tool) will take you directly to the SunSPOTWorld.com Forums to easily search for answers to your questions, find solutions to your programming problems, and to join in the community discussion of Sun SPOTs.

Information about Sun SPOT Manager

Display this help page with information about the Sun SPOT Manager Tool

	Interaction with and Management of Sun SPOT Devices
		Update the Firmware on your SPOTs to the currently active SDK Firmware. This button will install the firmware/powercontroller/libraries/etc. from the currently active SDK to your Sun SPOTs. You should connect your Sun SPOTs, and either select the individual SPOT(s) you wish to upgrade or select "All Connected Sun SPOTs" to upgrade them all.
		Enable or Disable the different BaseStation Modes on a SPOT or SPOTs. Select the Sun SPOT or Sun SPOTs from the list, and enable the selected BaseStation Mode on that Sun SPOT.
		Start Basestation: Starts a single-user basestation on the selected Sun SPOT or Sun SPOTs. Start Shared Basestation: Enables and starts the Shared Basestation feature. This command adds the property multi.process.basestation.sharing=true to your .sunspot.properties file and then starts the Shared basestation. Stop Shared Basestation: Disables the Shared Basestation feature by removing the multi.process.basestation.sharing=true property from your .sunspot.properties file. This command does not quit any already-running shared basestation processes.
		Run "ant info" against a specific Sun SPOT (or All Connected Sun SPOTs) to see what firmware revision and/or application is currently installed on the Sun SPOT.
		Enable or Disable the Over The Air Command Listener (OTA) on the selected Sun SPOT device, or on All Connected Sun SPOTs. This will allow you to deploy code to Sun SPOTs that are not directly connected to your host computer. This button uses a pop-up menu like the Basestation button to select Enabling/Disabling of the OTA Command Listener.
		Note: It is not advisable to enable the OTA Command Listener on a Basestation Sun SPOT.

	Management of Installed Sun SPOT SDKs
	Manage locally installed versions of the Sun SPOT SDK
		Instant activation of any installed Sun SPOT SDK
		Add Comments to any installed Sun SPOT SDK. Comments added this way will be added to the SDK's version.properties file and will be visible in the SPOTManager tool
		Rename any installed Sun SPOT SDK
		Safely delete any installed Sun SPOT SDK (Note: You cannot delete the currently Active SDK. To delete it, make another SDK Active, then delete the desired SDK, or use the "Remove SDK" button on the Preferences Tab to remove all Sun SPOT Software).
		To view Release information of any installed Sun SPOT SDK , just click on the "Sun SPOT SDK (SDK Info)" link inside the SDK folder.
	Upgrade, Downgrade, or Re-Install Sun SPOT SDKs
		Install any available Sun SPOT SDK from the update server
		Refresh the list of available Sun SPOT SDKs (this list is not automatically refreshed on a schedule).
		To view Release information of any available Sun SPOT SDK , just click on the "Sun SPOT SDK (SDK Info)" link inside the SDK folder.
	Manage Sun SPOT Demos
		Instant notification when new Sun SPOT Demos are made available
		Visual confirmation that your Sun SPOT SDK Demos are up-to-date
		Note: When active, clicking this button will install new Sun SPOT SDK Demos when available
	Manage Sun SPOT SDK NetBeans Modules
		Instant notification when new Sun SPOT SDK NetBeans Modules are available
		Visual confirmation that your Sun SPOT SDK NetBeans Modules are up-to-date
		Note: When active, clicking this button will install or upgrade Sun SPOT SDK NetBeans Modules when available
	View SDK Documentation
	View all included SDK Documentation via links in each listed SDK PDF Files viewable if a suitable PDF Viewer is installed for your platform Tutorials loaded in your default browser (platform dependent) Javadoc loaded into your default browser (platform dependent) Readme and other txt files loaded in platform-dependent text tool View the included Application Notes in default PDF Viewer (platform dependent)

	Set Up and Run the Sun SPOT World Application
		Start the Sun SPOT World Application. You should already have set a Sun SPOT as a BaseStation from the Sun SPOT Tab, and have that Sun SPOT selected from the menu.

	Sun SPOT Manager Preferences
		Clicking this button will completely remove the Sun SPOT SDK from your computer. This removal cannot be undone! All of the Sun SPOT SDK Components will be removed from your system, including Demos, Sample Code, Documentation, SDK Properties, and any work you may have saved in the Sun SPOT SDK Directory. Use this button very carefully, as it cannot be undone!
	Proxy Settings	The Sun SPOT Manager Application now supports various kinds of Network Proxies. If you are behind a firewall or Network Proxy, select 'Use Proxies' and then fill in the appropriate settings. If you are unsure of the settings, please consult your Network Administrator. If any field is not required (i.e. Username or Password) just leave it blank. When your settings are correctly entered, click "Set Proxies" to save and enable your proxy settings. These settings will be remembered and reloaded on subsequent use of the Sun SPOT Manager Tool.
	Beta vs. Release	The Sun SPOT Manager Application now supports both released versions of the Sun SPOT SDK (no password required!) and Beta Versions of the Sun SPOT SDK (password may be required). If you select the Beta update site, you may need a Beta username and password from the Sun SPOT Development team.
	Network Timeout	This setting will change the amount of time between various checks performed by the Sun SPOT Manager application. If your computer is connected to the internet, the Sun SPOT Manager will periodically check for updates to the Sun SPOT SDK, the Demos, Sample Code and the NetBeans modules. This setting determines the amount of time between such checks. If your computer has been off-line, any change to this setting will force an immediate reconnection and network check of all components.

	Console Output from the Sun SPOT Manager Tool
		See all output from the Sun SPOT Manager tool

	Report an issue with your Sun SPOTs to the Sun SPOT Engineering Team.
		This will gather information on your system configuration and any connected Sun SPOTs and send it directly to the Sun SPOT Engineering Team for evaluation. If you are having trouble with your Sun SPOTs, and you cannot find an answer on the Sun SPOT World Forums then this might be a good option. Note: This does not submit a bug report, but only submits your configuration and any output from any Sun SPOTs to the Engineering Team for evaluation.

	Web Site
		This button (available from anywhere in the Sun SPOT Manager Tool) will take you directly to the SunSPOTWorld.com Forums to easily search for answers to your questions, find solutions to your programming problems, and to join in the community discussion of Sun SPOTs.

	Information about Sun SPOT Manager
		Display this help page with information about the Sun SPOT Manager Tool