3 Installing and Running Applications on the Qualcomm IoE Board

Installing the Oracle Java ME SDK 8 Plugin for NetBeans

After installing NetBeans, use these steps to install the remaining software.

1. Ensure that Java ME is enabled in NetBeans. This can be done by selection Tools -> Plugins and selecting the Installed pane. Activate the Java ME plugin if it is not already activated.

2. Install the Java ME SDK 8 distribution, if you have not done so already. See the Java ME SDK 8 documentation for details.

3. Install the Oracle Java ME SDK 8 NetBeans plugin. This is a downloadable ZIP file that consists of a number of NetBeans modules (.nbm files) that can be added using the Tools -> Plugins dialog and selecting the Downloaded pane. Unzip the plugin file, and add all of the.nbm files to NetBeans. The Oracle Java ME SDK 8 NetBeans plugins are required to interface with the Device Selector and connect to the board.

4. Ensure that the Oracle Java ME SDK 8 appears in the list of Java ME platforms. In the NetBeans IDE, go to Tools -> Java Platforms. If the Oracle Java Platform Micro Edition SDK 8 does not appear in the list of Java ME platforms, follow these steps:

   • Click on Add Platform.

   • Select Java ME CLDC Platform Emulator and click Next.

   • Select the folder where the Oracle Java ME SDK 8 distribution resides and follow the instructions to install it. Then, click Finish to close the dialog.

5. Ensure that the Qualcomm IoE board has the Oracle Java ME Embedded distribution. See Chapter 1, "Installing Oracle Java ME Embedded on the Qualcomm IoE Board" for more information on how to install the runtime distribution on the Qualcomm IoE board.

Assigning the Qualcomm IoE Board to Your Project

If you already have an existing NetBeans project with an IMlet that you want to run or debug on the board, follow these steps:

1. Right-click on your project and choose Properties.

2. Select the Platform category on the properties window.

3. Select the entry that represents the board (EmbeddedExternalDevice1) from the device list.

If you are creating a new NetBeans project from scratch, follow these steps:

1. Select File -> New Project.

2. Select the Java ME Embedded category and Java ME Embedded Application in Projects. Click Next.

3. Provide a project name and click Next. Be sure that the Create MIDlet option is checked.

4. Ensure the Java ME Platform is Oracle Java Micro Edition SDK 8.0 EA. Then, select the entry that represents the board (EmbeddedExternalDevice1) from the device list and click Finish.

The configured Platform dialog is shown in Figure 3-1. After you assign the board to your project, the IMlets run on the board instead of on the emulator when you click on Run Project on the NetBeans IDE.

Figure 3-1 NetBeans Platform Properties Dialog

Description of "Figure 3-1 NetBeans Platform Properties Dialog"

Sample Source Code

Once the project is created, use the source code in Example 3-1 for the default IMlet.java source file.

package embeddedapplication1;
 
import com.oracle.deviceaccess.PeripheralManager;
import com.oracle.deviceaccess.gpio.GPIOPin;
import java.io.IOException;
import javax.microedition.midlet.*;
 
 
public class IMlet extends MIDlet {
 
    public void startApp() {
        
        try {
            
            GPIOPin pin = (GPIOPin)PeripheralManager.open(14);
            
            for (int i = 0; i < 10; i++) {
                pin.setValue(true);
                Thread.sleep(1000);
                pin.setValue(false);
                Thread.sleep(1000);
            }
            
            pin.close();

        } catch (IOException ex) {
            ex.printStackTrace();
        } catch (InterruptedException ex) {
            ex.printStackTrace();
        } 
        
    }
    
    public void pauseApp() {
    }
    
    public void destroyApp(boolean unconditional) {
    }
}

This sample application will obtain an object representing GPIO pin 14 from the PeripheralManager, and set it from low to high at intervals of one second. This has the effect of blinking one of the LEDs on the Qualcomm IoE board. For more information on using the Device Access APIs, see the Device Access API - Version 8 Specification at:

http://docs.oracle.com/javame/embedded/embedded.html

Signing the Application with API Permissions

First, the JAD file must have the proper API permissions. Here is how to sign the application both in NetBeans and without an IDE.

• In NetBeans, right-click the project name (ME8EmbeddedApplication1 in this example) and choose Properties. Select Application Descriptor, then in the resulting pane, select API Permissions. Click the Add... button, and add the com.oracle.deviceaccess.gpio API, as shown in Figure 3-3. Click OK to close the project properties dialog.

  Figure 3-3 Adding API Permissions with NetBeans

  
  Description of "Figure 3-3 Adding API Permissions with NetBeans"
  
  

• If you are not using an IDE, manually modify the application descriptor file to contain the following permissions.

  MIDlet-Permission-1: com.oracle.deviceaccess.PeripheralMgmtPermission "*:*" "open"
  MIDlet-Permission-2: com.oracle.deviceaccess.gpio.GPIOPinPermission "*:*" "open"
  Microedition-Profile: MEEP
  

[internal]
authentication.provider = com.oracle.meep.security.NullAuthenticationProvider