2 Using NetBeans with the Raspberry Pi Board

Using an Existing NetBeans 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 Platform Type (CLDC) and make sure Oracle Java(TM) Platform Micro Edition SDK 8.0 EA is selected in the Java ME Platform list.

4. Select EmbeddedExternalDevice1 from the Device list, as shown in Figure 2-3. Check (or uncheck) Optional Packages as needed for your project, and press OK.

   Figure 2-3 Adding a Device to Your Project

   
   Description of "Figure 2-3 Adding a Device to Your Project"
   
   

Creating a New NetBeans Project

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 8 Embedded Application in Projects. Click Next.

3. Provide a project name, for example, ME8EmbeddedApplication1. Be sure that the Java ME Platform is Oracle Java(TM) Platform Micro Edition SDK 8.0 EA and Create MIDlet option is checked.

4. Select EmbeddedExternalDevice1 from the Device list and click Finish, as shown in Figure 2-4.

   Figure 2-4 Creating a New Project

   
   Description of "Figure 2-4 Creating a New Project"
   
   

When the new project is created, it is displayed in NetBeans IDE with the name ME8EmbeddedApplication1.

Sample Source Code

Once the new project is created, use the source code in Example 2-1 to create a sample IMlet.java source file.

package me8embeddedapplication1;
 
import com.oracle.deviceaccess.PeripheralManager;
import com.oracle.deviceaccess.UnavailablePeripheralException;
import com.oracle.deviceaccess.PeripheralNotFoundException;
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(2);
            boolean b = pin.getValue();
        } catch (UnavailablePeripheralException ex) {
            ex.printStackTrace();
        } catch (PeripheralNotFoundException ex) {
            ex.printStackTrace();
        } catch (IOException ex) {
            ex.printStackTrace();
        }
        
    }
    
    public void pauseApp() {
    }
    
    public void destroyApp(boolean unconditional) {
    }
}

This sample application will obtain an object representing GPIO pin 2 from the PeripheralManager, and attempt to obtain its high/low value.

Including Your Sample IMlet Code

Now you can update the generic project you created with your sample code. In the NetBeans Projects window, you see the sample project with file ME8EmbeddedApplication1.java. Do the following

1. Right click to select ME8EmbeddedApplication1.java in the Projects window and select Properties.

2. This displays the ME8EmbeddedApplication1.java Properties window.

   To see the path to the location of the ME8EmbeddedApplication1.java file, look in the All Files line. Make a note of this path.

3. Take the IMlet.java file you created and copy it into the me8embeddedapplication1 directory in the file path you noted.

4. Delete the file ME8EmbeddedApplication1.java or remove it from the directory.

5. This changes the content of the NetBeans Project window to the content in the IMlet.java file. (If it does not double-click IMlet.java in the Projects window.)

6. Clean and build the ME8EmbeddedApplication1 project by clicking on the hammer-and-broom icon in the NetBeans toolbar or by selecting Run > Clean and Build Project (ME8EmbeddedApplication1).

7. Run the newly cleaned and built ME8EmbeddedApplication1 project by selecting the green right-arrow icon in the NetBeans toolbar or by selecting Run > Run Project (ME8EmbeddedApplication1.)

   When the Run is successful, the EmbeddedExternalDevice1 emulator starts with the ME8EmbeddedApplication1 Suite running.

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 2-5. Click OK to close the project properties dialog.

  Figure 2-5 Adding API Permissions with NetBeans

  
  Description of "Figure 2-5 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