@CHIP-RTOS C Library V2.06 - Fossil API
fossil_setbaud
Set baud rate and port configuration. int fossil_setbaud (int port, long baudrate, int parity,
int wordlen, int stopbits ); Parameters
baudrate
- Desired baud rate, bits per second
parity
- Enumeration type:
FOSSIL_PARITY_NO = 0
FOSSIL_PARITY_ODD = 1
FOSSIL_PARITY_EVEN = 2
FOSSIL_PARITY_MARK = 3
FOSSIL_PARITY_SPACE = 4
wordlen
- Bits per character (7 or 8)
stopbits
- Stop bits (1 or 2)
SC1x Parameters
- port
- Port specifier:
FOSSIL_EXT = 0 for EXT port
FOSSIL_COM = 1 for COM port
SC1x3 Parameters
- port
- Port specifier:
FOSSIL_EXT = 0 for EXT port
FOSSIL_COM = 1 for COM port
FOSSIL_SER2 = 2 for SER2 port
FOSSIL_SER3 = 3 for SER3 port
Return Value
- -1 = Illegal parameter
Else status code (bit field):
bit 6: FOSSIL_OUTPUT_BUFFER_EMPTY
bit 5: FOSSIL_OUTPUT_NOT_FULL
bit 4: FOSSIL_LINE_BREAK Line break detected
bit 3: FOSSIL_FRAMING_ERROR Framing error detected
bit 2: FOSSIL_PARITY_ERROR Parity error detected
bit 1: FOSSIL_OVERRUN_ERROR Set if overrun occurred on receiver.
bit 0: FOSSIL_DATA_AVAILABLE Set if data is available in receiver buffer.
The header file contains the indicated mask definitions.
Comments
- Set baud rate and other parameters for specified port.
For standard baud rates, this function uses Fossil interrupt
0x14 Service 0x00.
For non-standard baud rates the HAL interrupt 0xA1 "Get Frequencies"
function 0x8A
is used to determine the maximum baud rate. Based on this
maximum baud rate a baud rate divider is computed for the
"Extended Line Control Initialization" Fossil interrupt
0x81 service.
Then the Fossil interrupt
0x03 service reports
the port's status.
If the DMA mode (send or receive mode) is enabled at
Chip.ini,
the following port settings are not allowed:
1. 8N2 (this limitation applies only to SC1x systems)
2. 8S2
3. 8M2
SC1x Comments- Two stop bits are only available if no parity is set.
SC1x3 Comments- Two stop bits are only available if no parity is set or word length is
equal to 7 bits.
See Also
RTOS API
- This library function invokes a RTOS software interrupt.
Refer to this RTOS API function's
documentation
for more details.
Supported since or modified in @CHIP-RTOS version-
SC12 | SC13 | SC11 | SC1x3 |
-
V1.00 | V1.00 | V1.00 | V0.90 |
This API List
List of C Libraries
@CHIP-RTOS Main Index
End of document
|