www.beck-ipc.com

@CHIP-RTOS C Library V2.06 - Fossil API


fossil_set_flowcontrol

Enable/disable flow control.

void fossil_set_flowcontrol ( int port, FOS_FLOW_CTRL flowctrl );

Parameters

flowctrl

Enumerator specifies desired type of flow control:

FOSSIL_FLOWCTRL_OFF = 0x0: No flow control
FOSSIL_FLOWCTRL_XONXOFF_SEND = 0x1:
    XON/XOFF on transmit  (watch for XOFF while sending)
FOSSIL_FLOWCTRL_RTSCTS = 0x2:
    CTS/RTS (CTS on transmit/RTS on receive)
FOSSIL_FLOWCTRL_XONXOFF_RECV = 0x8:
    XON/XOFF on receive (send XOFF when buffer near full)
FOSSIL_FLOWCTRL_XONXOFF_SEND_RECV = 0x9:
    XON/XOFF used on both Tx and Rx

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

-- none --

Comments

Configures the flow control for a port.

Since SC12 @CHIP-RTOS 1.02B XON/XOFF mode is also available if the DMA mode for the COM port is enabled but because of the internal functionality of DMA it is not possible to detect an XON or XOFF of the peer immediateley.   It is possible that an overrun situation at the connected peer (e.g. GSM modem) could occur.   We enable this mode now because GSM modems (any??) supports only XON/XOFF flow ctrl.

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