Device Module

RhoElements 2.x API


The Device Module controls device functions.


device (Module) <META> Syntax

<META HTTP-Equiv="Device" content="[method]">

Device JavaScript Object Syntax:
By default the JavaScript Object 'device' will exist on the current page and can be used to interact directly with the device.
To Invoke device methods via JavaScript use the following syntax: device.method();

e.g. device.suspend();

To set multiple EMML parameters / events on a single line use the following syntax: device.setEMML("[Your EMML Tags]");

e.g. device.setEMML("suspend");


Items listed in this section indicate methods or, in some cases, indicate parameters which will be retrieved.

NameDescriptionDefault Value
suspendputs the device into suspend modeNot in suspend mode
powerOffputs the device into power off mode. In this mode the device will draw no power. Only supported on SB1.Not in Power Off mode
wakeWakes the device from suspend modewake mode
calibrateCarries out the screen calibration routineNot calibrating

Multi Instance

When multiple RhoElememts applications are running the following considerations should be made: Only the application with Focus will have the ability to control device functions.


Interaction with Unattended Method of the Push Module

The Suspend functionality is incompatible with the unattended functionality of the push module and they should not be used together.

wake Method

The wake functionality can be used along with Push module. For eg: in the push detected event the user can call the wake method to wake the device. Please note that the Enterprise Tablet opens in Lock Screen mode if wake method is used and the screen stays active until the user swicthes it off and hence this method consumes more battery power.


RhoElements Version1.0.0 or above
Supported DevicesAll supported devices.
Minimum RequirementsNone.
PersistenceImmediate - These methods are actioned immediately.

HTML/JavaScript Examples

The following example put the device into suspend mode:

<META HTTP-Equiv="Device" Content="Suspend">

The following example wakes the device from Suspend mode:

<META HTTP-Equiv="Device" Content="wake">