Jump to main content

# 1.1.3.4.12 DRV_RF215_SetChannelRequest Function

## C

    void DRV_RF215_SetChannelRequest (
        DRV_HANDLE drvHandle,
        uint64_t timeCount,
        uint16_t channelNum,
        DRV_RF215_TX_TIME_MODE timeMode
    );

## Summary

Allows a client to request RX frequency channel switch at specified time.

## Description

This routine allows a client to request a RX frequency channel switch at specified time. Result will be notified by callback.

## Precondition

DRV_RF215_Open must have been called to obtain a valid opened driver handle.

## Parameters

Param | Description
--- | ---
drvHandle | A valid open-instance handle, returned from the driver's open routine.
timeCount | Frequency channel switch time, referred to system 64-bit time counter.
channelNum | Frequency channel number to set.
timeMode | Set channel time mode (absolute/relative).

## Returns

None.

## Example

    DRV_HANDLE drvRf215Handle; // returned from DRV_RF215_Open

    // Switch to channel 8 in 100 ms
    DRV_RF215_SetChannelRequest(drvRf215Handle, 100000, 8, TX_TIME_RELATIVE);

## Remarks

This function is only available if `Frequency hopping support` is enabled through MCC.

Rev: G