Specify when EOS character is written or read
For GPIB, VISA-GPIB, VISA-VXI, and VISA-GPIB-VXI objects, you can configure EOSMode to be none, read, write, or read&write.
If EOSMode is none, the End-Of-String (EOS) character is ignored. If EOSMode is read, the EOS character is used to terminate a read operation. If EOSMode is write, the EOS character is appended to the ASCII command being written whenever \n is encountered. When the EOS character is written to the instrument, the End Or Identify (EOI) line is asserted. If EOSMode is read&write, the EOS character is used in both read and write operations.
The EOS character is specified by the EOSCharCode property. For GPIB objects, the CompareBits property specifies the number of bits that must match the EOS character to complete a read operation, or to assert the EOI line.
For any EOSMode value, the read operation completes when
The EOI line is asserted.
Specified number of values is read.
A timeout occurs.
Additionally, if EOSMode is read or read&write (reading is enabled), then the read operation can complete when the EOSCharCode property value is detected.
Regardless of the EOSMode value, a write operation completes when
The specified number of values is written.
A timeout occurs.
Additionally, if EOSMode is write or read&write, the EOI line is asserted each time the EOSCharCode property value is written to the instrument.
The EOS character is ignored.
The EOS character is used for each read operation.
The EOS character is used for each write operation.
The EOS character is used for each read and write operation.
Suppose you input a nominal voltage signal of 2.0 volts into a function generator, and read back the voltage value using fscanf.
g = gpib('ni',0,1); fopen(g) fprintf(g,'Volt?') out = fscanf(g) out = +2.00000E+00
The EOSMode and EOSCharCode properties are configured to terminate the read operation when an E character is encountered.
set(g,'EOSMode','read') set(g,'EOSCharCode','E') fprintf(g,'Volt?') out = fscanf(g) out = +2.00000