A fast and easily customised operating system
for ARM devices
HAL_UARTLineStatus
Hardware Abstraction Layer
HAL entry points from RISC OS
ยป HAL_UARTLineStatus
HAL_UARTLineStatus
(HAL entry #71)
int HAL_UARTLineStatus(int port)
| Entry | |
|---|---|
| port | Port number to query |
| Exit | |
|---|---|
| Bit 0 | Receiver Data Ready |
| Bit 1 | Overrun Error |
| Bit 2 | Parity Error |
| Bit 3 | Framing Error |
| Bit 4 | Break Error |
| Bit 5 | Transmitter Holding Register Empty |
| Bit 6 | Transmitter Empty (including FIFO) |
| Bit 7 | FIFO contains a Parity, Framing or Break error |
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.
Parity, Framing and Break errors are associated with each byte received. Whether the values reported here are associated with the last byte read using ReceiveByte or with the next byte to be read is undefined. You should request the status using ReceiveByte to ensure accurate identification of bytes with errors.
Error bits are cleared whenever status is read, using either HAL_UARTLineStatus or HAL_UARTReceiveByte with status non-NULL.