3 Using the Emulators

The AMS Tab

The first tab in the emulator, the AMS tab, displays which Oracle Java ME SDK 8 EA 2 applications are installed, running, or stopped.

You can use the buttons in the AMS tab, as shown in Figure 3-3, to do the following:

• Install or Reload an application

• Remove an application

• Display Info about an application

• Display Output about an application in a separately-displayed Output Console

Figure 3-3 Buttons on the AMS Tab

Description of "Figure 3-3 Buttons on the AMS Tab"

The Output Console Window

The Output Console window of the AMS tab allows you to display logging information about a selected application, as shown in Figure 3-4.

Figure 3-4 The AMS Tab Output Console

Description of "Figure 3-4 The AMS Tab Output Console"

Output Console information can be Error output, Standard output, or All output. The selected output can be saved to a file in your file system by selecting the Save button.

The GPIO Pins Tab

The GPIO tab lists the emulator's current General Purpose I/O (GPIO) pins and their directional state (output). For GPIO pins, the current value is shown as low or high. The GPIO Pins tab is shown in Figure 3-5.

Figure 3-5 The Emulator GPIO Pins Tab

Description of "Figure 3-5 The Emulator GPIO Pins Tab"

The GPIO Ports Tab

For GPIO ports, the port ID and port Name is shown, along with the port's Maximum Value and current Value. If you select the line that displays the available ports, it displays the pins bound to that specific port, as shown in Figure 3-6.

Figure 3-6 The Emulator GPIO Ports Tab

Description of "Figure 3-6 The Emulator GPIO Ports Tab"

Selecting the line that displays the available ports shows the pins bound to that port, as shown in Figure 3-7.

Figure 3-7 The GPIO Ports Bound Pins

The I2C Tab

The Inter-Integrated Circuit (I2C) tab emulates a simple peripheral slave device that echoes back any data that is sent to it. Both the sent and received data are shown in their appropriate window panes, as shown in Figure 3-8.

Figure 3-8 The Emulator I2C Tab

Description of "Figure 3-8 The Emulator I2C Tab"

The SPI Tab

The Serial Peripheral Interface (SPI) tab is similar to the I2C tab. It emulates a simple peripheral slave device that echoes back any data that is sent to it. Both the sent and received data are shown in their appropriate tabs, as shown in Figure 3-9.

Figure 3-9 The Emulator SPI Tab

Description of "Figure 3-9 The Emulator SPI Tab"

The MMIO Tab

The MMIO tab emulates the Memory-Mapped I/O (MMIO) interface bus. It displays an information table about the selected device, as shown in Figure 3-10.

Figure 3-10 The Emulator MMIO Tab

Description of "Figure 3-10 The Emulator MMIO Tab"

The ADC Tab

The Analog-to-Digital Converter (ADC) tab displays current Channel information, such as ID, Converter Number, Minimum and Maximum Values, Sampling Intervals, and more, as shown in Figure 3-11.

Figure 3-11 The Emulator ADC Tab

Description of "Figure 3-11 The Emulator ADC Tab"

The DAC Tab

The Digital-to-Analog Converter (DAC) tab displays current Channel information, such as Minimum and Maximum Values, Sampling Interval, Reference Voltage, and more, as shown in Figure 3-12.

Figure 3-12 The Emulator DAC Tab

Description of "Figure 3-12 The Emulator DAC Tab"

The PWM Tab

The Pulse Width Modulation (PWM) tab allows you to monitor a signal (pulse) that can be encoded for a specific width (duration). It displays information about a specific pulse counter, such as its configuration and current state, as shown in Figure 3-13.

To encode and send a pulse of a specific duration, use the PWM tab of the External Events Generator. For more information, see Chapter 4.

Figure 3-13 The Pulse Width Modulation Tab

Description of "Figure 3-13 The Pulse Width Modulation Tab"

The Pulse Counters Tab

The Pulse Counters tab allows you to send pulse information to as many as four counters. as shown in Figure 3-14. There are four kinds of pulses:

• Falling Pulse Edge - Can only be bound to input pins with the Falling Edge trigger.

• Rising Pulse Edge - Can only be bound to input pins with the Rising Edge trigger.

• Negative Pulse Edge - Can only be bound to input pins with the Both Edges trigger.

• Positive Pulse Edge - Can only be bound to input pins with the Both Edges trigger.

Figure 3-14 The Emulator Pulse Counters Tab

Description of "Figure 3-14 The Emulator Pulse Counters Tab"

The Displays and Input Devices Tab

The Displays and Input Devices tab allows you to gather information about specific displays attached to your device. This includes both primary and auxiliary displays. This tab also displays information about any input devices, such as a Qualcomm Orion IoE or Raspberry Pi embedded platform, as shown in Figure 3-15.

Figure 3-15 The Displays and Input Devices Tab

Description of "Figure 3-15 The Displays and Input Devices Tab"

The Application Menu

The Application menu lets you install and run IMlet suites.

• To install an IMlet suite, select Application > Install IMlet Suite.

  This displays the Install IMlet Suite box, as shown in Figure 3-16. Click OK.

  Figure 3-16 The Install IMlet Suite Box

  
  Description of "Figure 3-16 The Install IMlet Suite Box"
  
  

• To run an IMlet suite, select Application > Run IMlet Suite.

  This displays the Run IMlet Suite box, as shown in Figure 3-17. Enter the path or URL for the IMlet suite and click OK.

  Figure 3-17 The Run IMlet Suite Box

  
  Description of "Figure 3-17 The Run IMlet Suite Box"
  
  

• Exit. Shuts down the emulator process and quits.

The Device Menu

The Device menu allows you to see messages in the Messages box that are directed at the currently-running emulator from other devices. Messages provide information such as the timestamp, subject, encoding, and other information, as shown in Figure 3-18.

Select Device > Messages to see what is written in the message area. Messages are sent to a device in the following cases:

• An SMS message is sent without a port in the address (or the port number is 0)

• An SMS text message is sent with a port in the address, but there is not a Java ME application listening on the specified port

To test sending messages to the device use the WMA Console in NetBeans 8.0 Beta, or from the command line, use wma-tool.exe to send SMS messages.

Figure 3-18 The View Menu Messages Box

Description of "Figure 3-18 The View Menu Messages Box"

The Tools Menu

The Tools menu allows you to manage landmarks, file systems, and access points. It also provides another way to launch the External Events Generator.

• Manage Landmarks. Landmarks are used to emulate location information for an embedded device.

  You can use the default Landmark store, create new landmark stores, define landmark categories, and carry out other landmark operations, as shown in Figure 3-19.

  Figure 3-19 The Manage Landmarks Box

  
  Description of "Figure 3-19 The Manage Landmarks Box"
  
  

• Manage File System. Managing a file system allows you to mount a file tree to your emulation environment, providing access to components not installed in your immediate location.

  Once a file tree is mounted, it can also be unmounted, as shown in Figure 3-20.

  Figure 3-20 The Manage File System Box

  
  Description of "Figure 3-20 The Manage File System Box"
  
  

• Connectivity. Setting Connectivity allows you to define the network connectivity for your embedded emulation environment.

  As shown in Figure 3-21, four tabs are available on the Connectivity screen:

  • Access Points. Allows you to add and remove access points, and characteristics of a specific access point, such as the bearer type, network interface, and the service set ID (SSID).

  • Network Interfaces. Allows you to add and remove network interfaces, and define characteristics of a specific network interface, such as the type, timeout interval, and connection interface device.

  • Cellular Network. Allows you to add and remove a cellular network, and define characteristics for a specific cellular network, such as CDMA or 3GPP, connection protocol, and other details.

  • Subscribers. Allows you to add or remove a subscriber, and define characteristics for a subscribers, such as phone number, network type, international mobile subscriber identity (IMSI), and other details.

  Figure 3-21 The Connectivity Box

  
  Description of "Figure 3-21 The Connectivity Box"
  
  

• External Events Generator. For more information on the External Events Generator, see Chapter 4, "Using the External Events Generator"

The View Menu

The View menu allows you to view output in a device log or output console, to set your Embedded emulator so it always appears on top on your desktop, and show additional information on exit.

• Output Console.... Allows you to see output from an application running in the emulator, as shown in Figure 3-22. You have three choices for filtering output: All, Standard Output, and Error Output.

  You can save system output information to a text file by clicking Save in the output window.

  Figure 3-22 The Output Console Window

  
  Description of "Figure 3-22 The Output Console Window"
  
  

• Device Log. Allows you to display logging info, as shown in Figure 3-23. You have several levels of logging to choose from, including Trace, Debug, info, Warn, Error, and Fatal.

  You can save log information to a text file by clicking Save in the output window.

  Figure 3-23 The Device Log Window

  
  Description of "Figure 3-23 The Device Log Window"
  
  

• Always on Top. Allows you to keep the emulator on top of other windows open on your desktop.

• Show Hot Deployment Hint on Exit. Upon exit from the emulator, provides suggestions on how to save your work and easily restart the emulator.

The Help Menu

The Help menu allows you to get additional information about the Oracle Java ME SDK 8 EA 2 emulation environment. Put your cursor over any part of the Embedded emulator screen, and select Help > Help Contents.

Starting an Emulator

Typically an emulator is launched when a Oracle Java ME SDK 8 EA 2 project is run from the NetBeans 8.0 Beta IDE or from the command line. The default emulator is determined by the Java ME platform selected for the project.

You can open an emulator without running an application from the IDE. From the Windows Start menu, click Start > All Programs and select Java(TM) ME Platform SDK 8.0. On the pull-right menu, select the default emulator. You can also click the emulator shortcuts installed on your Windows desktop.

To run an application from the emulator, click the Application menu and select Run IMlet Suite. Provide the path to the application and any other information, and click OK.