A Running Sample Applications

Starting Sample Applications

There are two ways to start sample applications in Oracle Java ME SDK:

• From the IMPNGDevice1 emulator:

  1. Select Application --> Run IMlet Suite

  2. Fill in the Run IMlet Suite dialog box and provide the Path or URL for the IMlet Suite, as shown in Figure A-1.

     Figure A-1 The Run IMlet Suite Dialog Box

     
     Description of "Figure A-1 The Run IMlet Suite Dialog Box"
     
     

• From the Windows command line. Enter the following:

  emulator.exe -Xdevice:IMPNGDevice1 -Xdescriptor:C:\Java_ME_platform_SDK_3.4\apps\sample\<sample_demo_folder>\<sample_demo_name>.jad

For the four demos described in this chapter, all but GPIODemo can be started using both of the ways shown here.

The GPIODemo Sample Application

The GPIODemo can be run on the Oracle Java ME SDK emulator, IMPNGDevice1:

1. Launch the External Events Generator by selecting Tools > External Events Generator or clicking on the External Events Generator icon.

2. Click the GPIO tab. This displays the GPIO screen, as shown in Figure A-2.

   Figure A-2 The External Events Generator GPIO Tab

   
   Description of "Figure A-2 The External Events Generator GPIO Tab"
   
   

   The External Events Generator GPIO tab approximates actions on a device. Each button is a toggle that turns an LED on and off, changing the value of the corresponding Pin from High to Low, or Low to High.

   When a button is clicked, information is written to the IMPNGDevice1 GPIO Pins tab. Changes in the value of a Button can be seen in the Output and Value columns for Buttons 1, 2, and 3, as shown in Figure A-3.

3. Click each button to change the value in the Output column of the GPIO Pins tab, in the IMPNGDevice1.

Figure A-3 The GPIO Pins Tab

Description of "Figure A-3 The GPIO Pins Tab"

Notice the following about Buttons 1, 2, and 3 in the IMPNGDevice1 GPIO Pins tab:

• Button 1 corresponds to Hardware Port Number 0 and Hardware Pin Number 0. Button 1 has a Rising Edge Trigger.

• Button 2 corresponds to Hardware Port Number 2 and Hardware Pin Number 13. Button 2 has a Falling Edge Trigger.

• Button 3 corresponds to Hardware Port Number 6 and Hardware Pin Number 15. Button 3 has a Falling Edge Trigger.

  For more information on Rising and Falling Edge Triggers, see "The Pulse Counter Tab."

The I2CDemo Sample Application

This demo is designed to work with the IMP-NG runtime for Windows. It has no user interaction.

To launch the I2C demo, click the I2C tab in IMPNGDevice1.

Figure A-4 The I2C Tab

Description of "Figure A-4 The I2C Tab"

This demo acquires a slave named I2C_JOYSTICK, writes data to the slave, and retrieves it. The demo is successful if the Sent Data and Received Data match.

The NetworkDemoIMPNG Sample Application

The NetworkDemoIMPNG demo can be configured as a server or as a client by editing the application descriptor. You launch two instances of this demo, the first one acts as a server and the second one acts as a client. The client instance attempts to connect to the server instance and if the connection is successful they exchange a message.

1. Create two instance projects of the NetworkDemoIMPNG sample project.

2. Right click the first project and select Properties.

3. In the Platform category choose the device IMPNGDevice1. In the Application Description category set the value of the following property:

   Oracle-Demo-Network-Mode:Server

4. Click OK.

5. Launch the first project. It opens on the emulator IMPNGDevice1 and waits for a connection. You should see messages like the following:

6. Right click the second project and select Properties.

7. In the Platform category choose the device IMPNGDevice2. In the Application Description category set the value of the following property:

   Oracle-Demo-Network-Mode:Client

8. Click OK.

9. Launch the second project. It opens on the emulator IMPNGDevice2.

10. The client attempts to connect to the server. If successful, you see the following in the output tab of the first project (the server):

    Waiting for connection on port 500
    [AMS-TRACE] MIDlet:NetworkDemoIMPNG status=2
    [AMS-TRACE] MIDlet:NetworkDemoIMPNG status=1
    Connection accepted
    Message received - Client messages
    

    The output of the second project (the client) shows the following:

    [AMS-TRACE] MIDlet:NetworkDemoIMPNG status=2
    [AMS-TRACE] MIDlet:NetworkDemoIMPNG status=1
    Connected to server localhost on port 500
    Message received - Server string
    

The PDAPDemoIMPNG Sample Application

Follow these steps to run the PDADemoIMPNG demo on the IMPNGDevice1 emulator:

1. Create test files and directories inside the emulator's file system:

   Documents and Settings\<user>\javame-sdk\<version>\work\IMPNGDevice1\appdb\filesystem\root1

2. Right click the project and select Properties. In the Platform category choose the device IMPNGDevice1 and click OK.

3. Launch the project. It runs on IMPNGDevice1.

4. On the emulator menu, select Tools > File Connection to see a list of mounted file systems.

   Figure A-5 The Manage File System Window

   
   Description of "Figure A-5 The Manage File System Window"
   
   

5. Open a terminal emulator and create a raw connection to localhost on port 5001. For example:

   telnet localhost 5001

   
   

   Note: The Telnet negotiation mode must be set to Passive. The negotiation mode can be set inside a Telnet client application (for example, PuTTY), by choosing Category > Connection > Telnet > Passive.

   
   

   A command line opens where you can browse the emulator's file system. You can use the following commands:

   • cd <dir_name> - Change directory

   • ls - List information about the files for the current directory

   • new file <file_name> - Create a new file

   • new dir <directory_name> - Create a new directory

   • prop <file_name> - Show properties of a file

   • rm <file_name> - Remove the file

   • view <file_name> - View a file's content