Firmware-72 Command-001

From I-CubeX Wiki
Jump to: navigation, search

STREAM (1, 01h)

The STREAM command sets the sensor input activation status, ie. whether USB-microDig is sampling the sensor input.

In stand-alone mode, only if a signal processing method has been selected (impulse and/or continuous signal processing, see EDIT CONFIG command) each sensor input of the USB-microDig can be turned on or off with the STREAM command. If no signal processing method has been selected the STREAM command has no effect. The activation status of the sensor input is stored in non-volatile memory as well as volatile memory for immediate use. Following the activation of a sensor input the MIDI message to which the sensor value is mapped as set using the EDIT CONFIG command, is sent out by the USB-microDig. After a RESET command in stand-alone mode the activation status is retrieved from non-volatile memory - each sensor input is turned on or off depending on whether any of the signal processing methods is activated.

In host mode the STREAM command has immediate effect and if the sensor input is activated, STREAM DATA messages are output. The activation status of the sensor input is only stored in volatile memory for immediate use. After a RESET command in host mode each sensor input is turned off.

Upon completion of the command the USB-microDig sends out the same message.

The [BODY] of the STREAM command consists of a single 7-bit byte with the following format :

0x000yyy: x = 1; on
x = 0; off
yyy = [0..7]; sensor input number, where the first sensor input number = 0, and the last (8th) sensor input number = 7

Example:

In order to turn on the 3rd sensor input, the following message is sent:

240, 125, 0 {DEV}, 1 {STREAM}, 66 {x = 1, yyy = 02}, 247 (F0h, 7Dh, 00h, 01h, 42h, F7h)

In order to turn off the same sensor input, the following message is sent:

240, 125, 0 {DEV}, 1 {STREAM}, 2 {x = 0, yyy = 02}, 247 (F0h, 7Dh, 00h, 01h, 02h, F7h)