www.beck-ipc.com

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


fossil_user_callback

Install a Fossil User Callback Function. The User Callback function will be called when a fossil event occurs.

void fossil_user_callback ( int port,
                            FOSSIL_USER_CALLBACK pfFossUCB );

Parameters

pfFossUCB

Pointer to Fossil User CallBack function

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

Comments

This call installs a User callback function for the specified serial port. The Callback function must be very short! Long fossil callback functions could be lead to characters losing. To use the fossil callback functions you have to switch the serial port into the IRQ Mode (use CHIP.INI to do that). In DMA Mode the callback functions does not work!

The callback function must be declared like the function below:
fossil_event_t far *(huge my_fossil_callback)( fossil_event_t far *e )

The callback function must be installed like below:
fossil_user_callback(PORT, (FOSSIL_USER_CALLBACK) my_fossil_callback);

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.10V1.00V1.00V0.90

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


End of document