Jump to main content

# 1.1.3.4.19 DRV_RF215_READY_STATUS_CALLBACK Typedef

## C

    typedef void ( *DRV_RF215_READY_STATUS_CALLBACK ) (uintptr_t context, SYS_STATUS status);

## Summary

Pointer to a RF215 driver ready status callback function.

## Description

This data type defines the required function signature for the RF215 driver ready status event handling callback function. A client uses DRV_RF215_ReadyStatusCallbackRegister to register a pointer to a function which must match the signature (parameter and return value types) specified by this data type.

## Parameters

Param | Description
--- | ---
context | Value identifying the context of the client that registered the callback function.
status | SYS_STATUS_READY or SYS_STATUS_ERROR, depending on initialization result.

## Returns

None.

## Example

    static void APP_ReadyNotCb(uintptr_t ctxt, SYS_STATUS status)
    {
        DRV_HANDLE drvRf215Handle;

        // The context handle was set to an application specific object
        // It is now retrievable easily in the event handler
        MY_APP_OBJ myAppObj = (MY_APP_OBJ *) ctxt;

        if (status == SYS_STATUS_READY)
        {
            // Driver ready to be opened.
            drvRf215Handle = DRV_RF215_Open(DRV_RF215_INDEX_0, RF215_TRX_ID_RF09);
        }
    }

    MY_APP_OBJ myAppObj; // Application specific data object

    DRV_RF215_ReadyStatusCallbackRegister(APP_ReadyNotCb, (uintptr_t) myAppObj);

## Remarks

The context parameter contains a handle to the client context, provided at the time the callback function was registered using DRV_RF215_ReadyStatusCallbackRegister. This context value is passed back to the client as parameter. It can be any value necessary to identify the client context or instance (such as a pointer to the client's data) of the client that registered the callback.

Rev: G