HAL_UARTLineStatus (changes)
Showing changes from revision #2 to #3:
Added | Removed | Changed
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 |
| Bit 6 | Transmitter |
| Bit 7 | FIFO contains a Parity, Framing or Break error |
| Bit 8 | TX FIFO full (may only be reported if HAL_UARTFeatures bit 4 set) |
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.
See also
Information source: Kernel.Docs.HAL.Serial in CVS
Social
Follow us on
and
and
ROOL Store
Buy RISC OS Open merchandise here, including SD cards for Raspberry Pi and more.