Sun Microsystems V2.0 - Manuals

7 [delete] Deleting directory C:\MyApplication\build [delete] Deleting directory C:\MyApplication\suite [delete] Deleting directory C:\MyApplication\j2meclasses -post-clean: clean: -pre-compile: -do-compile: [mkdir] Created dir: C:\MyApplication\build [javac] Compiling 1 source file to C:\MyApplicat...

9 or ant –Dport=COM2 info The difference between these two commands is that the “ spotport ” version will check that there is a Sun SPOT connected to the specified port, whereas the “ port ” version will attempt to connect to a Sun SPOT on the specified port regardless. You should normally use the “...

12 [java] -------------------------------------------------------------------- [java] Hits - Class:95.74% Monitor:92.38% Exit:100.00% New:98.43% [java] GCs: 2 full, 0 partial [java] ** VM stopped: exit code = 0 ** [java] Exiting [delete] Deleting: C:\SunSPOT\dev\temp\spot-temp-674916937 -post-run: r...

13 Excluding files from the compilation To exclude files or folders matching a specific pattern from the java compilation, set the ant property spot.javac.exclude.src , either on the command line with –D or in the build.properties file of the project. The value of the property should be specified us...

14 resources/META-INF/MANIFEST.MF within its root folder. The adderlib extension has such a file, whose content is FavouriteSnake: Viper This defines a property whose value will be available to all applications in a similar fashion to application-specific manifest properties. The addertest applicati...

15 Hos t Sun SPO T (“base s ta tion”) Sun SPO T (“Ta rg e t”) U SB 8 02 .15 .4 radio The Host can be any of the supported platforms (e.g. Windows PC, Mac). The Host application is a J2SE program. The Target application is a Squawk Java program. In the SPOT SDK and documentation the 64-bit addresses ...

16 Base Station configuration It is possible to select a channel and pan id for the base station using command line properties in conjunction with ant host-run . The properties are: -Dremote.channel=nn -Dremote.pan.id=nn Alternatively, if you are operating in dedicated mode, the IRadioPolicyManager ...

17 To configure the SPOT so that this thread is started each time the SPOT starts issue this command via a USB connection: ant enableota The SPOT remembers this setting in its configuration area in flash memory. To configure the SPOT so that the OTA Command Server is not started each time the SPOT s...

18 remote.pan.id either on the command line or in the .sunspot.properties file in your user root folder. Using short names for SPOTs As a shortcut, it is possible to use short names for SPOTs instead of the full 16-digit IEEE address. To do this create a file called “spot.names” in your user home di...

19 Even if you aren’t concerned about security, you need to be aware of this if you want to be able to use Sun SPOTs interchangeably amongst two or more SDK installations. See the section Sharing Sun SPOTs . Changing the owner of a Sun SPOT Once set, only the owner can change the public key remotely...

20 ant deploy for each Sun SPOT. What is protected? Applications and customized libraries are always verified and unless the digital signature can be successfully verified using the trusted public key, the application will not be executed. Extra security is provided for over-the-air deployment. In t...

21 When the switch is specified a basestation will still be correctly identified if one is available, but if no basestation is available the port property will be set to dummyport. Your own host application You should base your host application on the template provided. Your host application can ope...

22 For situation 2 above you should configure the SPOT as a dedicated mesh router, using the command: ant selectmeshrouter When the SPOT is reset (by pressing the attention button or by an ant run command) it will begin acting as a dedicated router. A SPOT set in this configuration does not need the...

24 Developing and debugging Sun SPOT applications Overview of an application A Sun SPOT application is actually implemented as a MIDlet. This should not concern most developers greatly: the simplest thing is to copy a template, as described above, and start editing the copy. The most significant imp...

25 The libraries only use system priorities in three cases: 1. To guarantee that application threads don't run during a system operation during which the system may be in an inconsistent state. 2. To guarantee short uninterruptible periods of operation for critical hardware interaction. 3. To ensure...

26 Each physical device is controlled by a single instance of the respective class, accessed through the interfaces listed above. The single instance of the Sun SPOT class creates and manages access to the device driver singletons. The singletons are created only as required. For example, to get acc...

27 - there is a possibility that another isolate has written a new value for the property since the current isolate started - your application has overwritten the user-defined property’s value in memory but not in flash (by executing System.setProperty ). All user-defined properties can be accessed ...

28 example above two sectors are allocated (and thus erased), starting with the first sector available to applications. Using the Record Management Store The Record Management Store (RMS) that is part of the Java IM Profile provides a simple record-based mechanism for access to persistent data. Here...

29 Configuring USART parameters The URL for USART access can uniquely be extended with additional parameters to configure the USART if required. For example: InputStream inputStream = Connector.openInputStream( "serial://usart?baudrate=57600&databits=7&parity=even&stopbits=1.5");...

30 The radiogram protocol provides datagram-based communication between two devices. This protocol provides no guarantees about delivery or ordering. Datagrams sent over more than one hop could be silently lost, be delivered more than once, and be delivered out of sequence. Datagrams sent over a sin...

31 Program 2 RadiostreamConnection conn = (RadiostreamConnection) Connector.open("radio://0014.4F01.0000.0007:100"); DataInputStream dis = conn.openDataInputStream(); DataOutputStream dos = conn.openDataOutputStream(); try { String question = dis.readUTF(); if (question.equals("Hello up ...

32 where serverAddr is the 64bit IEEE Address of the radio of the server, and portNo is a port number in the range 0 to 255 that identifies this particular connection. Note that 0 is not a valid IEEE address in this implementation. The port number must match the port number used by the server. Data ...

33 There are some points to note about using datagrams: • Only datagrams obtained from the connection may be passed in send or receive calls on the connection. You cannot obtain a datagram from one connection and use it with another. • A connection opened with a specific address can only be used to ...

34 There are some important points to note about using this operation: • If setting a timeout it must be set before opening streams or creating datagrams. • A TimeoutException is generated if the caller is blocked waiting for input for longer than the period specified. • Setting a timeout of 0 cause...

37 RSSI (received signal strength indicator) measures the strength (power) of the signal for the packet. It ranges from +60 (strong) to -60 (weak). To convert it to decibels relative to 1 mW (= 0 dBm) subtract 45 from it, e.g. for an RSSI of -20 the RF input power is approximately -65 dBm. CORR meas...

39 If it is important that your application knows whether or not deep sleep happened, then you can alternatively execute this code: ISleepManager sleepManager = Spot.getInstance().getSleepManager(); SleepManager.ensureDeepSleep(5000); This code will either deep sleep for the specified time of 5,000 ...

40 2. Of all threads executing a Thread.sleep() it determines which will resume soonest. If the sleep interval is less than the minimum deep sleep time it shallow sleeps. 3. If the sleep interval is at least the minimum deep sleep time and deep sleeping is enabled, it sends a request to the SleepMan...

41 http protocol support The http protocol is implemented to allow remote SPOT applications to open http connections to any web service accessible from a correctly configured host computer. To open a connection do: HttpConnection connection = (HttpConnection)Connector.open("http:// host :[ port]...

42 HTTP Proxy If the host computer running the Socket Proxy is behind a proxy server, the device can still access the Internet if the following property is specified in the MANIFEST.MF: com.sun.squawk.io.j2me.http.Protocol-HttpProxy: <proxyaddress>:<port> where proxyaddress is the hostna...

43 Classpath configuration The classpath for an application that runs on a Sun SPOT needs to include the following jars in this order: SDK_INSTALL_DIRECTORY/lib/transducerlib_rt.jar SDK_INSTALL_DIRECTORY/lib/multihoplib_rt.jar SDK_INSTALL_DIRECTORY/lib/spotlib_device.jar SDK_INSTALL_DIRECTORY/lib/sp...

45 Using non-default channel or pan id It is not possible for an application being debugged to select dynamically a different channel or pan id. Instead the required channel or pan id must be selected using manifest properties (see section Using manifest properties to adjust the radio ). Then the re...

46 Expand each of the first four of these, then select and edit the “Source attachment”. Point this to the relevant source jar as follows: transducerlib_rt.jar SDK_INSTALL_DIRECTORY/src/transducerlib_source.jar multihoplib_rt.jar SDK_INSTALL_DIRECTORY/src/multihoplib_source.jar spotlib_common.jar SD...

47 Start by copying LibraryExtensionSampleCode to a working area. This contains two sub-directories: adderlib and addertest . adderlib contains the library. You should find a sub-directory containing the library Java source: you can add to or edit this as you see fit. 1. Build any new .jar files con...

49 The source code for the libraries is supplied in three parts: spotlib_source.jar contains the code that supports the SPOT main board; multihop_source.jar contains the radio communications stack; and transducerlib_source.jar contains the code that supports the Demo Sensor Board. This example shows...

51 Reference Persistent system properties Property name Meaning spot.hardware.rev spot.powercontroller.firmware.version spot.sdk.version spot.external.0.part.id spot.external.0.hardware.rev spot.external.0.firmware.version spot.external.1.part.id spot.external.1.hardware.rev spot.external.1.firmware...

52 Memory usage The Sun SPOT flash memory runs from 0x10000000 to 0x10400000 (4M bytes), and is organized as 8 x 8Kb followed by 62 x 64Kb followed by 8 x 8Kb sectors. The flash memory is allocated as follows: Start address Space Use 0x10000000 64Kb Bootloader 0x10010000 256Kb VM executable 0x100500...

53 debugger_classes.jar The classes of the Sun SPOT high-level debugger. Used by the debug proxy. desktop_signing.jar Classes that are used to security sign suites and commands. j2se_classes.jar The J2SE classes used by Squawk on the desktop. Used by the debug proxy. junit.jar The well-know Java tes...