Firmware-73 Command-001

STREAM (1, 01h)

The STREAM command sets the slot activation status for sensor input, ie. whether USB-microDig is sampling the slot's sensor input, whether virtual (ie. via I2C communication from a digital sensor) or physical (i.e from an analog sensor).

In stand-alone mode, only if a signal processing method has been selected (impulse and/or continuous signal processing, see EDIT CONFIG command) each slot of the USB-microDig can be turned on or off for sensor input with the STREAM command. If no signal processing method has been selected the STREAM command has no effect. The activation status of the slot for sensor input is stored in non-volatile memory as well as volatile memory for immediate use. Following the activation of a slot for sensor input the MIDI message to which the sensor value(s) is/are mapped as set using EDIT CONFIG commands, 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 slot is turned on or off depending on whether any of the signal processing methods is activated for the first sensor input, whether from an analog or digital sensor.

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

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]; slot number, where the first slot number = 0, and the last (8th) slot number = 7

Example:

In order to turn on the 3rd slot for 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 slot for 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)