www.beck-ipc.com

@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

    SC12SC13SC11SC1x3
    V1.00V1.00V1.00V0.90

This API List
List of C Libraries
@CHIP-RTOS Main Index


End of document