www.beck-ipc.com

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


fossil_getbyte

Get byte from input buffer (no wait).

int fossil_getbyte ( int port );

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 if no data is available in receiver buffer, else next received byte

Comments

This function uses Fossil interrupt 0x14 Service 0x18 to read out a block of length one.  This method of polling for single characters at the receiver will be considerably more efficient than the alternative method using the fossil_status_request and fossil_getbyte_wait function pair.

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