Mobile Wearable

Event Injector

In the Emulator Control Panel (ECP), you can inject various types of events.

Providing Device Data

The Emulator Control Panel (ECP) can be used to simulate device data, such as the battery level, adding or removing a earjack (headset) or USB device, setting RSSI (remote signal strength indicator) information, and attaching and detaching the SD card in the Device tab:

  • Setting the battery level

    In the Battery tab, set the battery level using the Level slider. To set the charger status to connected or disconnected, select the appropriate Charger radio button.

  • Adding or removing an earjack

    In the EarJack tab, select the earjack setting:

    • 3 Wire
    • 4 Wire
    • Disconnect
  • Adding or removing a USB device

    In the USB tab, set the USB device setting to the connected or disconnected state.

  • Setting the RSSI information

    In the RSSI tab, set the RSSI information level using the Level slider.

  • Attaching and detaching the SD card

    In the SD Card tab, select the 4G, 8G, 16G, or 32G SD card and attach it to the Emulator at runtime.

    Note
    The same SD card cannot be attached to multiple Emulators at the same time.

The device information set using the ECP is reflected on the indicator bar of the device.

Providing Location Data

The Emulator Control Panel (ECP) can be used to provide imitated responses to location data requests by loading GPS log files, manually entering location coordinates, or injecting markers directly on the map in the Location tab:

  • Loading a GPS log file

    In the Log section, select the pre-logged GPS data file (NMEA183 format) and click Inject Log to send the location data to the Emulator.

  • Manually entering location coordinates

    In the Manual section, enter the coordinates and click Inject Location to send the location data to the Emulator. The range of the latitude, longitude, altitude, and horizontal accuracy is from -90 to 90, -180 to 180, -300 to 100000, and 0 to 100000, respectively.

  • Injecting markers on the map

    In the Map section, right-click the desired map locations and click Inject Markers to send the location data to the Emulator.

Providing NFC Data

The Emulator Control Panel (ECP) can be used to test the near-field communication (NFC) features, such as NFC data exchange format (NDEF) events, NFC tag detection, and peer-to-peer (P2P) data connections in the NFC tab.

Note
The Event Injector view sends only NFC-related events to the Emulator. There is no actual information exchange between the Event Injector and Emulator. Therefore, for features such as writing information to an NFC tag, the Emulator simply displays a success message.

Creating NDEF Messages

An NDEF message contains one or more NDEF records.

In the NDEF Message section:

  1. Select the record type name format.
  2. Enter the record type name, ID, and payload.
  3. Click Add.

    You can add multiple NDEF records as required in the NDEF message.

Click Edit or Remove to modify or delete a selected record.

Attaching and Detaching NFC Tags

In the NFC Tag section:

  1. Select the tag type.
  2. Click Tag Attach.

    If the NDEF records list is not empty, an NDEF message is created using this list and the attach message is sent to the Emulator with the NDEF message.

  3. When the tag operation is finished, click Tag Detach.

Creating a P2P data Connection

In the Peer to Peer section:

  1. To send the Emulator the discovered state of the new device, click P2P Discovered.
  2. To send the Emulator an NDEF message, click P2P Send.
  3. To send the Emulator the detached state of the connected device, click P2P Detached.

Providing Sensor Data

In the Emulator Control Panel (ECP), you can model your actions, such as shaking, throwing, and tilting the device for the emulator instance. In addition, you can generate a single sensor event on the instance, or inject sequences of 3-axis sensor events to the instance.

Controlling 3-axis Sensors

Select Event Injector > Sensor > 3-Axis Sensor. The 3-Axis Sensor tab consist of 4 subtabs, in which you can adjust the acceleration, magnetic, and gyro sensors of the emulator instance. In the GUI subtab, you can intuitively adjust various sensor data by using 3D graphics. In the other subtabs, you can inject a single event into the individual sensor, and sequences of events into the sensor by using the sensor data files.

  • GUI

    In the GUI subtab, you can select an active sensor and move the 3D model of the emulator instance by the 3 axis sliders or direction buttons (Portrait, Landscape, Reverse Portrait, and Reverse Landscape). The instance monitor displays the acceleration, magnetic, and gyro values.

    To better control the movement, select the With axis check box to see the axes in the Emulator image. You can also fix the Y or Z axis by selecting the X/Z or X/Y radio button, respectively. To change the Emulator accelerator value in the direction of the movement, select the Move radio button.

  • Acceleration

    You can control the acceleration of the instance along the coordinate axes. When the instance is standing, the acceleration value of the Y axis is -1 g as gravitational acceleration. By using the sliders in the Acceleration subtab, you can control the acceleration 3-axis values from -2 g to 2 g.

  • Magnetic

    You can control the magnetic values of the instance along the coordinate axes. When the instance is standing, the magnetic 3-axis tesla values (azimuth 0) are set for the North. By using the sliders in the Magnetic subtab, you can control the magnetic 3-axis values from -2000 uT to 2000 uT.

  • Gyro

    You can control the gyro (rotation angle per second) of the instance along the coordinate axes. By using the sliders in the Gyro subtab, you can control the gyro 3-axis values from -10 rad to 10 rad.

  • Event file

    The event file consists of predefined events. It is written in ASCII. By loading the event file in the Acceleration, Magnetic, or Gyro subtabs, you can replay a sequence of predefined events. You can also add multiple event files to replay. The format of each line in the event file is:

    timestamp, x, y, z

    When you add the event files and click Start, the predefined events are injected at their specified relative timestamp. The timestamp unit is 0.01 seconds. Some events can be discarded, if they exceed certain limits of performance, resource, or logic.When you add multiple event files, the files are executed in sequence. You can also repeat the replay.

Controlling Other Sensors

In the Event Injector > Sensor tab, you can control the light, proximity, pressure, ultraviolet, and HRM sensors:

  • To control the light sensor, set the Lux value in the Light tab. The range of this value is from 0 Lux to 65635 Lux.

  • To control the proximity sensor, set it on or off in the Proximity tab.

  • To control the pressure sensor, set the hPa (Hectopascal) value in the Pressure tab. The range of this value is from 260 hPa to 1260 hPa.

  • To control the ultraviolet sensor, use the slider in the Ultraviolet tab. The unit is UV index and the range of this value is from 0 to 15.0.

  • To control the HRM (Heart Rate Monitor) sensor, use the sliders in the Heart Rate Monitor tab. You can set the Heart Rate value between 0 and 220, and the Peek-to-Peek value between 0 and 5000.

Providing Telephony Features

The Emulator Control Panel (ECP) can be used to generate incoming calls and messages in the Telephony tab.

Generating Incoming Calls

Incoming calls are generated in the Event Injector > Telephony > Call tab.

Note
A Mobile Termination (MT) call is made from the Event Injector view to the Emulator. A Mobile Origination (MO) call is made from the Emulator to the Event Injector view using the phone application of the Emulator.

To make an MT call:

  1. Enter the phone number you want to imitate the call from.
  2. Click Connect.

  3. To hide the phone number on the Emulator, select the Hidden option.

    The caller ID on the Emulator is set to "Unknown".

To make an MO call, use the Emulator's phone application:

  1. To ready the Emulator for the connection, click Alert.
  2. To ready the Emulator for the call, click Connect.

Generating Messages

SMS messages are generated in the Event Injector > Telephony > Messaging tab. After sending a message, your application waits for the asynchronous send status message. You can generate this status report for SMS messages using the same Messaging tab.

To generate an SMS message:

  1. Enter the sender phone number you want to imitate.
  2. Enter the message body text and click Send Msg.

To generate status reports, set the sending status value for the SMS message:

  • SMS OK (Success)
  • SMS Not Available

You can also generate MMS message status reports. To generate MMS status reports, set the sending status value for the MMS message:

  • MMS OK (Success)
  • MMS Failure

Providing Memory Data

The Emulator Control Panel (ECP) can be used to simulate low memory status in the Memory tab.

Set the low memory status using the radio buttons:

  • Hard-Warning (40 MB and under)
  • Soft-Warning (60 MB and under)
  • Normal (sufficient)
Go to top