Interface to a microcontroller that supports the Firmata protocol.
Most Arduino boards and compatible devices (e.g. Teensy) can be configured to support the Firmata protocol via the Arduino Firmata library.
The device can be connected via a serial port or Bluetooth low energy (BLE). If both serial_port and bluetooth_local_name are omitted, MWorks looks for a single, connected serial device. If it finds one, it assumes it to be the desired Firmata device and attempts to connect.
If the Firmata device is connected via a serial port, this parameter specifies the filesystem path that represents the serial port
If the Firmata device is connected via Bluetooth low energy, this parameter specifies its local name
Sampling interval for analog inputs. Must be a whole number of milliseconds.
Variable in which to store connection state of the Firmata device (true if currently connected, false otherwise).
Normally, the device should be connected at all times. However, by monitoring the value of the specified variable, you can detect and respond to unexpected disconnections.
If the Firmata device disconnects unexpectedly (e.g. due to power failure), and the value of this parameter is greater than zero, then the device will attempt to reconnect at this interval.
For example, if this parameter is set to
10s, then, upon
disconnection, the device will wait for 10 seconds and then try to
reconnect. If the reconnection attempt fails, the device will wait for
another 10 seconds, then try again, and so on.
If the value of this parameter is zero, the device will never attempt to reconnect.
YES, the device will start I/O automatically (as if by an
implicit Start IO Device action) when the experiment starts running.
Note: Device I/O will always stop automatically when the experiment stops running, irrespective of this setting.
Alternative device to use if this one fails to initialize (e.g. because the required hardware is not available). If
#allowAltFailover is set to 0 or false, this parameter is ignored.
Allowed at top level:
Firmata Analog Input Channel, Firmata Analog Output Channel, Firmata Digital Input Channel, Firmata Digital Input Pullup Channel, Firmata Digital Input Pulse Channel, Firmata Digital Output Channel, Firmata Digital Output Pulse Channel, Firmata Servo Channel, Firmata Word Output Channel