www.beck-ipc.com

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


fossil_set_flowcontrol

Enable/disable flow control.

void fossil_set_flowcontrol ( int port, FOS_FLOW_CTRL flowctrl );

Parameters

port

Port specifier:   FOSSIL_EXT = 0 for EXT port,   FOSSIL_COM = 1 for COM port

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

Return Value

-- none --

Comments

Configures the flow control for a port.

See Also

RTOS API

This library function invokes a RTOS software interrupt. Refer to this RTOS API function's documentation for more details.


Developer Notes

Since @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.


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


End of document