h6. [[Hardware Abstraction Layer]] h6(. [[HAL entry points from RISC OS]] h6((. » HAL_UARTReceiveByte h2. HAL_UARTReceiveByte h5. (HAL entry #69) <pre> int HAL_UARTReceiveByte(int port, int *status) </pre> |_<. Entry | | |port |Port number to read from | |status |Optional location to store [[HAL_UARTLineStatus|line status]] | |_<. Exit | | |/2^. - |Returns the read byte. | |Return value undefined if no byte was available. | h4. Use This is an internal call for use by the [[DualSerial]] module and should not be used by user code. Instead of calling the HAL directly, user code should interact with the Serial* entries that DualSerial creates in DeviceFS. Returns the next byte from the FIFO (if enabled) or the holding register. If _status_ is non-NULL, the line status associated with the byte is read (see [[HAL_UARTLineStatus]]). The return value is only meaningful if a received byte is available (bit 0 of *_status_ will be set). h4. See also * [[HAL UART API]] h6. Information source: Kernel.Docs.HAL.Serial in CVS