Warning Older Docs! - You are viewing documentation for a previous released version of RhoMobile Suite.

Reboot Module

The Reboot Module is used to reboot the terminal immediately.

Syntax

reboot (Module) <META> Syntax

<META HTTP-Equiv="Reboot" content="[parameter]">
Reboot JavaScript Object Syntax:
By default the JavaScript Object 'reboot' will exist on the current page and can be used to interact directly with the reboot.
To Set reboot parameters via JavaScript use the following syntax: reboot.parameter = 'value'; remembering to enclose your value in quotes where appropriate.

e.g. reboot.bootType = 'value';
To set multiple EMML parameters / events on a single line use the following syntax: reboot.setEMML("[Your EMML Tags]");

e.g. reboot.setEMML("bootType:value");
Reboot Ruby Object Syntax:
By default the Ruby Object 'Reboot' will exist on the current page and can be used to interact directly with the Reboot. All Methods, Parameters and Events are the same as JavaScript, however, notice 'Reboot' needs to start with an uppercase letter. Another difference in Ruby is that methods do not end in '()'
To Set Reboot parameters via Ruby use the following syntax: Reboot.parameter = 'value' remembering to enclose your value in quotes where appropriate.

e.g. Reboot.bootType = 'value'

Parameters

Items listed in this section indicate parameters, or attributes which can be set.

Name Possible Values Description Default Value
bootType:[Value] "Warm", "Cold" or "ColdCAD" Reboots the device using either a Warm or Cold software boot (as specified). Note on CE6 & CE7 devices a 'ColdCAD' boot is required to replicate the Coldboot key sequence, e.g. 1+9+Power on an MC3000. N/A

Remarks

Suggested Use

The Reboot tag can be used to apply new settings after downloading files (eg. .REG) or applications from a server.

Windows Mobile

Not all Windows Mobile/CE devices support Cold or ColdCAD features. If a cold boot is attempted on such devices, a warm boot will be performed instead. On WM 5.0 and higher, there is no software difference between a warm and a cold boot as the device uses persistent storage; both the file and registry will remain the same after boot.

Requirements

RhoElements Version 1.0.0 or above
Supported Devices All supported devices. (See Above comment for behavior on Windows Mobile)
Minimum Requirements None.
Persistence Immediate - These methods are actioned immediately.

HTML/Javascript Examples

The following example Warm boots the terminal:

<META HTTP-Equiv="Reboot" Content="BootType:Warm">

Ruby Examples

The following example warm boots the device after displaying a warning:

def warmBoot
    Alert.show_popup "The device will now warm boot"
    Reboot.bootType='Warm'
end

To call the this function from HTML, use the following code:

<li onclick="doWarmBoot(); ">Warm boot the device</li>

Where ‘doWarmBoot()’ is a JavaScript function which looks like:

function doWarmBoot() {
    $.get('/app/RebootModule/warmBoot', { });
    return false;
}

Similarly, the following example cold boots the device:

def coldBoot
    Alert.show_popup "The device will now cold boot"
    Reboot.bootType='Cold'
end

If applicable, the following example performs a cold CAD boot on CE6 devices (1+9+power)

def coldCADBoot
    Alert.show_popup "The device will now attempt a cold CAD boot"
    Reboot.bootType='ColdCAD'
end

Both ‘coldBoot’ and ‘coldCADBoot’ can be called from HTML in a way similar to the one described for ‘warmBoot’ above.

Back to Top