Home command

Brings the device to its idle/home screen.

For iOS and Android devices, the device is unlocked and returned to its default rotate orientation. For example, iOS devices are returned to portrait mode and iPad devices to landscape mode.

Use this function at the beginning of a script to ensure a known starting point for the user.

Parameters

Name	Type	Possible values	Description
Device ID^*	String		The device for this command. By default, this is the device under test (DUT).
Target	String	All \| Menu \| Position	Specifies the home target, where: All resets the location in the navigation tree (device menus to IDLE state) and device state to the default position (rotate/flip state) Menu resets the location in the navigation tree Position resets the device state (rotate/flip) to the default position
Comment	String		Adds a comment to the script.
On-fail Result^*	Condition	Ignore \| Break \| Continue \| Abort \| Catch	The behavior when the command fails.

^* Mandatory parameter