INFO: New SerialDevice read mode property introduced [27856]

This article applies to:

E-Prime 3.0

Detail

E-Prime 3.0.3.80 (Update 2) introduces a new SerialDevice property, "mode", which defines how data is read from the SerialDevice. When SerialDevice mode = 0, serial data is pushed onto the device's response history in its own thread; this results in asynchronous retrieval which can provide faster performance. When mode = 1, then serial data is read directly from the serial port via a polling mechanism.    Lastly, when mode = -1, reading from the serial port is disabled; the serial port becomes a write-only device.  

The default mode is 0. Users should rarely, if ever, need to modify the SerialDevice mode. One exception would be when replicating a study which was run prior to E-Prime 3 Update 2. The SerialDevice's data was polled in prior versions; therefore, if replicating a prior study, users may want to consider setting the mode to 1. As with other E-Prime devices, the SerialDevice mode property is checked once when the device is first opened. Therefore, the mode must be assigned via a StartupInfo file with a <SerialDeviceName>.Mode startup info integer property.  Attempts to change the SerialDevice mode after it has been opened will result in a runtime error message. 

See Also:

DEVICE: Serial Device [17355]

E-STUDIO: StartupInfo Editor [22727]

DEVICE: How To: Serial Port Communication [25287]

RELEASE INFO: E-Prime 3.0 Change History (3.0.3.60 Update 1 to 3.0.3.80 Update 2) [27275]