1 Installing Oracle Java ME Embedded on the Qualcomm IoE Board

Setting Up the Qualcomm IoE Board

First, download the Qualcomm IoE Development Platform User's Guide in PDF format, which can be downloaded at:

https://developer.qualcomm.com/mobile-development/development-devices-boards/development-boards/internet-of-everything-development-platform/tools-and-resources

This document contains important information about the Qualcomm IoE board and its hardware.

Next, perform the following steps, in order.

1. Assemble and connect the board's components as listed in Chapter 3, "Hardware", and Chapter 5, "Hardware Configuration", of the Qualcomm IoE Development Platform User's Guide.

2. Connect the power supply as shown in the Qualcomm IoE Development Platform User's Guide and power on the board.

   • To use an AC-power source, see Section 5.3.5.5, "AC-powered operation."

   • To use a battery source, see Section 5.3.5.4, "Battery-powered operation."

Downloading and Installing the Brew MP SDK Tools

Download the Brew MP SDK tools from the following site:

https://developer.brewmp.com/tools/brew-mp-sdk

The version used in this documentation is 7.12.5. Double-click on the installer executable, and install the application on your Windows platform desktop as per the instructions shown. You will need the Loader and Logger applications that are installed with the Brew MP SDK Tools in later sections.

Installing the Qualcomm IoE USB Drivers

To develop on the Qualcomm IoE board, you must first install the Windows USB drivers for the board. If you have not already done this, use the following steps:

1. Download the Qualcomm IoE USB drivers from the following site:

   https://developer.qualcomm.com/mobile-development/development-devices-boards/development-boards/internet-of-everything-development-platform/tools-and-resources

2. Ensure that the Qualcomm IoE board is powered up by pressing the "PWR KEY" button on the board. Then, follow the instructions in Chapter 2, "Software Setup," of the Qualcomm IoE Development Platform User's Guide to properly install the USB drivers in Windows.

3. Open the Windows Device Manager (Start -> Search for 'Device Manager').

4. Ensure that the drivers are successfully installed by verifying the following hardware ports, as shown in Figure 1-1.

   • HS-USB Modem (AT command port)

   • HS-USB Serial Port (Java tooling port)

   • HS-USB Diagnostics Port

   • HS-USB NMEA Port (GPS)

   Figure 1-1 Device Manager with Qualcomm IoE USB Device Drivers Loaded

   
   Description of "Figure 1-1 Device Manager with Qualcomm IoE USB Device Drivers Loaded"
   
   

Copying Files to the Qualcomm IoE Board

Finally, you must install the Java ME Embedded Software on the Qualcomm IoE board using the Loader and Logger applications. Follow these steps to copy the appropriate files to the board:

1. Download and uncompress the Oracle Java ME Embedded Software 3.4 for the Qualcomm IoE board.

2. Obtain the latest java.sig and netsetup.sig signature files from the Qualcomm IoE website:

   https://developer.qualcomm.com/mobile-development/development-devices-boards/development-boards/internet-of-everything-development-platform/tools-and-resources

3. Start the Loader application that was installed with the Brew SDK. Click Start, and then type Loader in the Search box. Right-click Loader under Programs.

4. When the Loader application starts, connect to the board using the Connection type: Brew Devices (COM/DIAG), and whichever port matches the Qualcomm HS-USB Diagnostics Port, as shown in Figure 1-2.

   Figure 1-2 Brew SDK Loader Connection Manager Dialog

   
   Description of "Figure 1-2 Brew SDK Loader Connection Manager Dialog"
   
   

5. If you are upgrading from the Oracle Java ME Embedded 3.2 release, you will need to delete all the files in the /sys/mod/java and /sys/mod/netsetup directories, including the .sig files. After deleting the files, reboot the board.

6. If it doesn't already exist, create the /sys/mod/java directory and drag and drop following files from the Oracle Java ME Embedded distribution's java folder into it.

   • appdb (folder)

   • java.mif

   • java.mod

   • jwc_properties.ini

   • watchdog.ini

7. Copy the java.sig signature file obtained from Qualcomm to the /sys/mod/java directory.

8. If it doesn't already exist, create the /sys/mod/netsetup directory and drag and drop following files from the Oracle Java ME Embedded distribution's netsetup folder into it.

   • netsetup.mif

   • netsetup.mod

9. Copy the netsetup.sig signature file obtained from Qualcomm to the /sys/mod/netsetup directory.

10. Reset the board by pressing the "RESET KEY" on the board, then wait approximately 40 seconds for the Java VM to startup.

11. Start the Logger application in the same way you started the Loader application. Connect to the board using the Connection type: Brew Devices (COM/DIAG), and whichever port matches the Qualcomm HS-USB Diagnostics Port. Connect to the board, press the Start Logging button, and verify that the Java VM is sending logging information to the Logger application by checking for messages that come from the [JVMStdout] file name. See Figure 1-3.

    Figure 1-3 The Brew SDK Logger Application

    
    Description of "Figure 1-3 The Brew SDK Logger Application"
    
    

12. Once Java is successfully running on the Qualcomm IoE board, continue on to the next chapter to learn how to use the tooling features of the Oracle Java ME Embedded software on the board. If Java is not running, please see Chapter 4, "Troubleshooting" to diagnose possible problems.