read_serial — 从串行设备读取。
read_serial( : : SerialHandle, NumCharacters : Data)
read_serial tries to read NumCharacters from the
serial device given in SerialHandle. The read characters
are returned in Data as a tuple of integers. This allows
to read NUL characters, which would otherwise be interpreted as the
end of a string. If the timeout of the serial device has been set
to a value greater than 0 with set_serial_param,
read_serial waits at most as long for the arrival of the
first character as indicated by the timeout. Otherwise, the
operator returns immediately. In any case, the number of characters
available at the time of return are passed back to the caller, i.e.,
fewer characters than requested can be returned. This can be
checked by the length of the tuple Data。
SerialHandle (输入控制) serial → (handle)
Serial interface handle.
NumCharacters (输入控制) integer → (integer)
Number of characters to read.
默认值： 1
建议值： 1, 2, 3, 4, 5, 10, 20, 40, 100
Data (输出控制) integer(-array) → (integer)
Read characters (as tuple of integers).
If the parameters are correct and the read from the device was
successful, the operator read_serial 返回值 2 ( H_MSG_TRUE )。否则将抛出异常。
基础