fem_al.h

Go to the documentation of this file.

/*
 * Copyright (c) 2021 Nordic Semiconductor ASA
 *
 * SPDX-License-Identifier: LicenseRef-Nordic-5-Clause
 */
 
#ifndef FEM_AL_H_
#define FEM_AL_H_
 
#ifdef __cplusplus
extern "C" {
#endif
 
#include <stdint.h>
#include <stdbool.h>
 
#include <hal/nrf_radio.h>
 
enum fem_antenna {
        FEM_ANTENNA_1,
 
        FEM_ANTENNA_2
};
 
typedef uint8_t fem_tx_power_control;
 
int fem_init(NRF_TIMER_Type *timer_instance, uint8_t compare_channel_mask);
 
int fem_power_up(void);
 
int fem_power_down(void);
 
int fem_tx_power_control_set(fem_tx_power_control tx_power_control);
 
uint32_t fem_default_ramp_up_time_get(bool rx, nrf_radio_mode_t mode);
 
int fem_tx_configure(uint32_t ramp_up_time);
 
int fem_rx_configure(uint32_t ramp_up_time);
 
int fem_txrx_configuration_clear(void);
 
void fem_txrx_stop(void);
 
int fem_antenna_select(enum fem_antenna ant);
 
uint32_t fem_radio_tx_ramp_up_delay_get(bool fast, nrf_radio_mode_t mode);
 
uint32_t fem_radio_rx_ramp_up_delay_get(bool fast, nrf_radio_mode_t mode);
 
int8_t fem_tx_output_power_prepare(int8_t power, int8_t *radio_tx_power, uint16_t freq_mhz);
 
int8_t fem_tx_output_power_check(int8_t power, uint16_t freq_mhz, bool tx_power_ceiling);
 
static inline int8_t fem_tx_output_power_min_get(uint16_t freq_mhz)
{
        /* Using INT8_MIN returns the minimum supported Tx output power value. */
        return fem_tx_output_power_check(INT8_MIN, freq_mhz, false);
}
 
static inline int8_t fem_tx_output_power_max_get(uint16_t freq_mhz)
{
        /* Using INT8_MAX returns the maximum supported Tx output power value. */
        return fem_tx_output_power_check(INT8_MAX, freq_mhz, true);
}
 
int8_t fem_default_tx_output_power_get(void);
 
void fem_errata_25X(nrf_radio_mode_t mode);
 
#ifdef __cplusplus
}
#endif
 
#endif /* FEM_AL_H_ */