device-change

device-change

Switches the currently-selected device. Once changed, all further device-related commands will be address to the newly selected device.

Usage

device-change <index>

Parameters

This command takes the following parameters:
Parameter 	Description

<index>
	

An integer index of device, as printed by the device-list command.

Responses

This command may return the following responses:
Response 	Description

<<device-change,OK,current device is changed
	

The command has been processed successfully; the current device was changed.

<<device-change,FAIL,invalid parameters
	

An invalid number of parameters have been specified (either no parameters or more than one parameter).

<<device-change,FAIL,incorrect device index
	

The index is not an integer.

<<device-change,FAIL,device not found
	

There is no such device.

<<device-change,FAIL,the device is already current
	

An attempt was made to switch to a device that is already the current device.