xref: /hal_nordic-3.4.0/drivers/nrf_802154/driver/src/nrf_802154.c

/*
 * Copyright (c) 2018 - 2023, Nordic Semiconductor ASA
 * All rights reserved.
 *
 * SPDX-License-Identifier: BSD-3-Clause
 *
 * Redistribution and use in source and binary forms, with or without
 * modification, are permitted provided that the following conditions are met:
 *
 * 1. Redistributions of source code must retain the above copyright notice, this
 *    list of conditions and the following disclaimer.
 *
 * 2. Redistributions in binary form must reproduce the above copyright
 *    notice, this list of conditions and the following disclaimer in the
 *    documentation and/or other materials provided with the distribution.
 *
 * 3. Neither the name of Nordic Semiconductor ASA nor the names of its
 *    contributors may be used to endorse or promote products derived from this
 *    software without specific prior written permission.
 *
 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
 * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
 * IMPLIED WARRANTIES OF MERCHANTABILITY, AND FITNESS FOR A PARTICULAR PURPOSE
 * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
 * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
 * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
 * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
 * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
 * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
 * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
 * POSSIBILITY OF SUCH DAMAGE.
 *
 */

/**
 * @file
 *   This file implements the nrf 802.15.4 radio driver.
 *
 */

#define NRF_802154_MODULE_ID NRF_802154_DRV_MODULE_ID_APPLICATION

#include "nrf_802154.h"

#include <assert.h>
#include <stdbool.h>
#include <stddef.h>
#include <stdint.h>
#include <string.h>

#include "nrf_802154_config.h"
#include "nrf_802154_const.h"
#include "nrf_802154_core.h"
#include "nrf_802154_critical_section.h"
#include "nrf_802154_debug.h"
#include "nrf_802154_notification.h"
#include "nrf_802154_nrfx_addons.h"
#include "nrf_802154_pib.h"
#include "nrf_802154_request.h"
#include "nrf_802154_rx_buffer.h"
#include "nrf_802154_tx_power.h"
#include "nrf_802154_stats.h"
#include "hal/nrf_radio.h"
#include "platform/nrf_802154_clock.h"
#include "platform/nrf_802154_random.h"
#include "platform/nrf_802154_temperature.h"
#include "rsch/nrf_802154_rsch.h"
#include "rsch/nrf_802154_rsch_crit_sect.h"
#include "timer/nrf_802154_timer_coord.h"

#include "mac_features/nrf_802154_ack_timeout.h"
#include "mac_features/nrf_802154_delayed_trx.h"
#include "mac_features/nrf_802154_ie_writer.h"
#include "mac_features/nrf_802154_ifs.h"
#include "mac_features/nrf_802154_security_pib.h"
#include "mac_features/ack_generator/nrf_802154_ack_data.h"

#include "nrf_802154_sl_ant_div.h"
#include "nrf_802154_sl_crit_sect_if.h"
#include "nrf_802154_sl_capabilities.h"
#include "nrf_802154_sl_timer.h"

#if !NRF_802154_USE_RAW_API || NRF_802154_CARRIER_FUNCTIONS_ENABLED
/** Static transmit buffer used by @sa nrf_802154_transmit() family of functions.
 *
 * If none of functions using this buffer is called and link time optimization is enabled, this
 * buffer should be removed by linker.
 */
static uint8_t m_tx_buffer[RAW_PAYLOAD_OFFSET + MAX_PACKET_SIZE];

#endif // !NRF_802154_USE_RAW_API || NRF_802154_CARRIER_FUNCTIONS_ENABLED

#if !NRF_802154_USE_RAW_API
/**
 * @brief Fill transmit buffer with given data.
 *
 * @param[in]  p_data   Pointer to array containing payload of a data to transmit. The array
 *                      should exclude PHR or FCS fields of 802.15.4 frame.
 * @param[in]  length   Length of given frame. This value shall exclude PHR and FCS fields from
 *                      the given frame (exact size of buffer pointed by @p p_data).
 */
static void tx_buffer_fill(const uint8_t * p_data, uint8_t length)
{
    assert(length <= MAX_PACKET_SIZE - FCS_SIZE);

    m_tx_buffer[RAW_LENGTH_OFFSET] = length + FCS_SIZE;
    memcpy(&m_tx_buffer[RAW_PAYLOAD_OFFSET], p_data, length);
}

#endif // !NRF_802154_USE_RAW_API

#if NRF_802154_CARRIER_FUNCTIONS_ENABLED
/**
 * @brief Fill the transmit buffer with given data in order to use it with the
 * modulated carrier functionality.
 *
 * @param[in]  p_data   Pointer to array containing modulating data.
 */
static void tx_buffer_fill_for_modulated_carrier(const uint8_t * p_data)
{
    uint8_t length = p_data[RAW_LENGTH_OFFSET];

    assert(length <= MAX_PACKET_SIZE);

    memcpy(m_tx_buffer, p_data, RAW_PAYLOAD_OFFSET + length);
}

#endif // NRF_802154_CARRIER_FUNCTIONS_ENABLED

static inline bool are_frame_properties_valid(const nrf_802154_transmitted_frame_props_t * p_props)
{
    return p_props->dynamic_data_is_set || !(p_props->is_secured);
}

void nrf_802154_channel_set(uint8_t channel)
{
    bool changed = nrf_802154_pib_channel_get() != channel;

    nrf_802154_pib_channel_set(channel);

    if (changed)
    {
        (void)nrf_802154_request_channel_update(REQ_ORIG_HIGHER_LAYER);
    }
}

uint8_t nrf_802154_channel_get(void)
{
    return nrf_802154_pib_channel_get();
}

void nrf_802154_tx_power_set(int8_t power)
{
    nrf_802154_pib_tx_power_set(power);
}

int8_t nrf_802154_tx_power_get(void)
{
    nrf_802154_fal_tx_power_split_t split_power = {0};

    return nrf_802154_tx_power_split_pib_power_get(&split_power);
}

bool nrf_802154_coex_rx_request_mode_set(nrf_802154_coex_rx_request_mode_t mode)
{
    return nrf_802154_pib_coex_rx_request_mode_set(mode);
}

nrf_802154_coex_rx_request_mode_t nrf_802154_coex_rx_request_mode_get(void)
{
    return nrf_802154_pib_coex_rx_request_mode_get();
}

bool nrf_802154_coex_tx_request_mode_set(nrf_802154_coex_tx_request_mode_t mode)
{
    return nrf_802154_pib_coex_tx_request_mode_set(mode);
}

nrf_802154_coex_tx_request_mode_t nrf_802154_coex_tx_request_mode_get(void)
{
    return nrf_802154_pib_coex_tx_request_mode_get();
}

void nrf_802154_temperature_changed(void)
{
    nrf_802154_request_cca_cfg_update();
}

void nrf_802154_pan_id_set(const uint8_t * p_pan_id)
{
    nrf_802154_pib_pan_id_set(p_pan_id);
}

void nrf_802154_extended_address_set(const uint8_t * p_extended_address)
{
    nrf_802154_pib_extended_address_set(p_extended_address);
}

void nrf_802154_short_address_set(const uint8_t * p_short_address)
{
    nrf_802154_pib_short_address_set(p_short_address);
}

int8_t nrf_802154_dbm_from_energy_level_calculate(uint8_t energy_level)
{
    return nrf_802154_addons_dbm_from_energy_level_calculate(energy_level);
}

uint8_t nrf_802154_ccaedthres_from_dbm_calculate(int8_t dbm)
{
    return dbm - ED_RSSIOFFS;
}

uint64_t nrf_802154_first_symbol_timestamp_get(uint64_t end_timestamp, uint8_t psdu_length)
{
    uint32_t frame_symbols = PHY_SHR_SYMBOLS;

    frame_symbols += (PHR_SIZE + psdu_length) * PHY_SYMBOLS_PER_OCTET;

    return end_timestamp - (frame_symbols * PHY_US_PER_SYMBOL);
}

uint64_t nrf_802154_mhr_timestamp_get(uint64_t end_timestamp, uint8_t psdu_length)
{
    return end_timestamp - (psdu_length * PHY_SYMBOLS_PER_OCTET * PHY_US_PER_SYMBOL);
}

void nrf_802154_init(void)
{
    static const nrf_802154_sl_crit_sect_interface_t crit_sect_int =
    {
        .enter = nrf_802154_critical_section_enter,
        .exit  = nrf_802154_critical_section_exit
    };

    nrf_802154_ack_data_init();
    nrf_802154_core_init();
    nrf_802154_clock_init();
    nrf_802154_critical_section_init();
    nrf_802154_sl_crit_sect_init(&crit_sect_int);
    nrf_802154_debug_init();
    nrf_802154_notification_init();
    nrf_802154_pib_init();
    nrf_802154_security_pib_init();
    nrf_802154_sl_timer_module_init();
    nrf_802154_random_init();
    nrf_802154_request_init();
    nrf_802154_rsch_crit_sect_init();
    nrf_802154_rsch_init();
    nrf_802154_rx_buffer_init();
    nrf_802154_temperature_init();
    nrf_802154_timer_coord_init();
#if NRF_802154_ACK_TIMEOUT_ENABLED
    nrf_802154_ack_timeout_init();
#endif
#if NRF_802154_DELAYED_TRX_ENABLED
    nrf_802154_delayed_trx_init();
#endif
#if NRF_802154_IFS_ENABLED
    nrf_802154_ifs_init();
#endif
}

void nrf_802154_deinit(void)
{
    nrf_802154_timer_coord_uninit();
    nrf_802154_temperature_deinit();
    nrf_802154_rsch_uninit();
    nrf_802154_random_deinit();
    nrf_802154_security_pib_deinit();
    nrf_802154_sl_timer_module_uninit();
    nrf_802154_clock_deinit();
    nrf_802154_core_deinit();
#if NRF_802154_ACK_TIMEOUT_ENABLED
    nrf_802154_ack_timeout_deinit();
#endif
#if NRF_802154_DELAYED_TRX_ENABLED
    nrf_802154_delayed_trx_deinit();
#endif
#if NRF_802154_IFS_ENABLED
    nrf_802154_ifs_deinit();
#endif
}

bool nrf_802154_antenna_diversity_rx_mode_set(nrf_802154_sl_ant_div_mode_t mode)
{
    bool result = false;

#if defined(RADIO_INTENSET_SYNC_Msk)
    result = nrf_802154_sl_ant_div_cfg_mode_set(NRF_802154_SL_ANT_DIV_OP_RX, mode);
#endif

    if (result)
    {
        nrf_802154_request_antenna_update();
    }

    return result;
}

nrf_802154_sl_ant_div_mode_t nrf_802154_antenna_diversity_rx_mode_get(void)
{
    return nrf_802154_sl_ant_div_cfg_mode_get(NRF_802154_SL_ANT_DIV_OP_RX);
}

bool nrf_802154_antenna_diversity_tx_mode_set(nrf_802154_sl_ant_div_mode_t mode)
{
    bool result = false;

#if defined(RADIO_INTENSET_SYNC_Msk)
    result = nrf_802154_sl_ant_div_cfg_mode_set(NRF_802154_SL_ANT_DIV_OP_TX, mode);
#endif

    if (result)
    {
        nrf_802154_request_antenna_update();
    }

    return result;
}

nrf_802154_sl_ant_div_mode_t nrf_802154_antenna_diversity_tx_mode_get(void)
{
    return nrf_802154_sl_ant_div_cfg_mode_get(NRF_802154_SL_ANT_DIV_OP_TX);
}

bool nrf_802154_antenna_diversity_rx_antenna_set(nrf_802154_sl_ant_div_antenna_t antenna)
{
    bool result =
        nrf_802154_sl_ant_div_cfg_antenna_set(NRF_802154_SL_ANT_DIV_OP_RX, antenna);
    bool is_manual_mode = nrf_802154_sl_ant_div_cfg_mode_get(NRF_802154_SL_ANT_DIV_OP_RX) ==
                          NRF_802154_SL_ANT_DIV_MODE_MANUAL;

    if (result && is_manual_mode)
    {
        nrf_802154_request_antenna_update();
    }

    return result;
}

nrf_802154_sl_ant_div_antenna_t nrf_802154_antenna_diversity_rx_antenna_get(void)
{
    return nrf_802154_sl_ant_div_cfg_antenna_get(NRF_802154_SL_ANT_DIV_OP_RX);
}

bool nrf_802154_antenna_diversity_tx_antenna_set(nrf_802154_sl_ant_div_antenna_t antenna)
{
    bool result =
        nrf_802154_sl_ant_div_cfg_antenna_set(NRF_802154_SL_ANT_DIV_OP_TX, antenna);
    bool is_manual_mode = nrf_802154_sl_ant_div_cfg_mode_get(NRF_802154_SL_ANT_DIV_OP_TX) ==
                          NRF_802154_SL_ANT_DIV_MODE_MANUAL;

    if (result && is_manual_mode)
    {
        nrf_802154_request_antenna_update();
    }

    return result;
}

nrf_802154_sl_ant_div_antenna_t nrf_802154_antenna_diversity_tx_antenna_get(void)
{
    return nrf_802154_sl_ant_div_cfg_antenna_get(NRF_802154_SL_ANT_DIV_OP_TX);
}

nrf_802154_sl_ant_div_antenna_t nrf_802154_antenna_diversity_last_rx_best_antenna_get(void)
{
    return nrf_802154_sl_ant_div_last_rx_best_antenna_get();
}

void nrf_802154_antenna_diversity_config_set(const nrf_802154_sl_ant_div_cfg_t * p_cfg)
{
#if defined(RADIO_INTENSET_SYNC_Msk)
    nrf_802154_sl_ant_div_cfg_set(p_cfg);
#endif
}

bool nrf_802154_antenna_diversity_config_get(nrf_802154_sl_ant_div_cfg_t * p_cfg)
{
    return nrf_802154_sl_ant_div_cfg_get(p_cfg);
}

bool nrf_802154_antenna_diversity_init(void)
{
    return nrf_802154_sl_ant_div_init();
}

void nrf_802154_antenna_diversity_timer_irq_handler(void)
{
#if defined(RADIO_INTENSET_SYNC_Msk)
    nrf_802154_sl_ant_div_timer_irq_handle();
#endif
}

nrf_802154_state_t nrf_802154_state_get(void)
{
    switch (nrf_802154_core_state_get())
    {
        case RADIO_STATE_SLEEP:
        case RADIO_STATE_FALLING_ASLEEP:
            return NRF_802154_STATE_SLEEP;

        case RADIO_STATE_RX:
        case RADIO_STATE_TX_ACK:
            return NRF_802154_STATE_RECEIVE;

        case RADIO_STATE_CCA_TX:
        case RADIO_STATE_TX:
        case RADIO_STATE_RX_ACK:
            return NRF_802154_STATE_TRANSMIT;

        case RADIO_STATE_ED:
            return NRF_802154_STATE_ENERGY_DETECTION;

        case RADIO_STATE_CCA:
            return NRF_802154_STATE_CCA;

#if NRF_802154_CARRIER_FUNCTIONS_ENABLED

        case RADIO_STATE_CONTINUOUS_CARRIER:
            return NRF_802154_STATE_CONTINUOUS_CARRIER;

        case RADIO_STATE_MODULATED_CARRIER:
            return NRF_802154_STATE_MODULATED_CARRIER;
#endif // NRF_802154_CARRIER_FUNCTIONS_ENABLED

    }

    return NRF_802154_STATE_INVALID;
}

bool nrf_802154_sleep(void)
{
    bool result;

    nrf_802154_log_function_enter(NRF_802154_LOG_VERBOSITY_LOW);

    result = nrf_802154_request_sleep(NRF_802154_TERM_802154);

    nrf_802154_log_function_exit(NRF_802154_LOG_VERBOSITY_LOW);

    return result;
}

nrf_802154_sleep_error_t nrf_802154_sleep_if_idle(void)
{
    nrf_802154_sleep_error_t result;

    nrf_802154_log_function_enter(NRF_802154_LOG_VERBOSITY_LOW);

    result =
        nrf_802154_request_sleep(NRF_802154_TERM_NONE) ? NRF_802154_SLEEP_ERROR_NONE :
        NRF_802154_SLEEP_ERROR_BUSY;

    nrf_802154_log_function_exit(NRF_802154_LOG_VERBOSITY_LOW);

    return result;
}

bool nrf_802154_receive(void)
{
    bool result;

    nrf_802154_log_function_enter(NRF_802154_LOG_VERBOSITY_LOW);

    result = nrf_802154_request_receive(NRF_802154_TERM_802154,
                                        REQ_ORIG_HIGHER_LAYER,
                                        NULL,
                                        true,
                                        NRF_802154_RESERVED_IMM_RX_WINDOW_ID);

    nrf_802154_log_function_exit(NRF_802154_LOG_VERBOSITY_LOW);
    return result;
}

#if NRF_802154_USE_RAW_API
bool nrf_802154_transmit_raw(uint8_t                              * p_data,
                             const nrf_802154_transmit_metadata_t * p_metadata)
{
    bool result;

    nrf_802154_log_function_enter(NRF_802154_LOG_VERBOSITY_LOW);

    if (p_metadata == NULL)
    {
        static const nrf_802154_transmit_metadata_t metadata_default =
        {
            .frame_props = NRF_802154_TRANSMITTED_FRAME_PROPS_DEFAULT_INIT,
            .cca         = true,
            .tx_power    = {.use_metadata_value = false}
        };

        p_metadata = &metadata_default;
    }

    nrf_802154_transmit_params_t params =
    {
        .frame_props = p_metadata->frame_props,
        .tx_power    = {0},
        .cca         = p_metadata->cca,
        .immediate   = false
    };

    (void)nrf_802154_tx_power_convert_metadata_to_tx_power_split(nrf_802154_pib_channel_get(),
                                                                 p_metadata->tx_power,
                                                                 &params.tx_power);

    result = are_frame_properties_valid(&params.frame_props);
    if (result)
    {
        result = nrf_802154_request_transmit(NRF_802154_TERM_NONE,
                                             REQ_ORIG_HIGHER_LAYER,
                                             p_data,
                                             &params,
                                             NULL);
    }

    nrf_802154_log_function_exit(NRF_802154_LOG_VERBOSITY_LOW);
    return result;
}

#else // NRF_802154_USE_RAW_API

bool nrf_802154_transmit(const uint8_t                        * p_data,
                         uint8_t                                length,
                         const nrf_802154_transmit_metadata_t * p_metadata)
{
    bool result;

    nrf_802154_log_function_enter(NRF_802154_LOG_VERBOSITY_LOW);

    if (p_metadata == NULL)
    {
        static const nrf_802154_transmit_metadata_t metadata_default =
        {
            .frame_props = NRF_802154_TRANSMITTED_FRAME_PROPS_DEFAULT_INIT,
            .cca         = true,
            .tx_power    = {.use_metadata_value = false}
        };

        p_metadata = &metadata_default;
    }

    nrf_802154_transmit_params_t params =
    {
        .frame_props = p_metadata->frame_props,
        .tx_power    = {0},
        .cca         = p_metadata->cca,
        .immediate   = false
    };

    (void)nrf_802154_tx_power_convert_metadata_to_tx_power_split(nrf_802154_pib_channel_get(),
                                                                 p_metadata->tx_power,
                                                                 &params.tx_power);

    result = are_frame_properties_valid(&params.frame_props);
    if (result)
    {
        tx_buffer_fill(p_data, length);
        result = nrf_802154_request_transmit(NRF_802154_TERM_NONE,
                                             REQ_ORIG_HIGHER_LAYER,
                                             m_tx_buffer,
                                             &params,
                                             NULL);
    }

    nrf_802154_log_function_exit(NRF_802154_LOG_VERBOSITY_LOW);
    return result;
}

#endif // NRF_802154_USE_RAW_API

#if NRF_802154_DELAYED_TRX_ENABLED
bool nrf_802154_transmit_raw_at(uint8_t                                 * p_data,
                                uint64_t                                  tx_time,
                                const nrf_802154_transmit_at_metadata_t * p_metadata)
{
    bool                              result;
    nrf_802154_transmit_at_metadata_t metadata_default =
    {
        .frame_props = NRF_802154_TRANSMITTED_FRAME_PROPS_DEFAULT_INIT,
        .cca         = true,
        .tx_power    = {.use_metadata_value = false}
    };

    nrf_802154_log_function_enter(NRF_802154_LOG_VERBOSITY_LOW);

    if (p_metadata == NULL)
    {
        metadata_default.channel = nrf_802154_channel_get();
        p_metadata               = &metadata_default;
    }

    result = are_frame_properties_valid(&p_metadata->frame_props);
    if (result)
    {
        result = nrf_802154_request_transmit_raw_at(p_data, tx_time, p_metadata);
    }

    nrf_802154_log_function_exit(NRF_802154_LOG_VERBOSITY_LOW);
    return result;
}

bool nrf_802154_transmit_at_cancel(void)
{
    bool result;

    nrf_802154_log_function_enter(NRF_802154_LOG_VERBOSITY_LOW);

    result = nrf_802154_request_transmit_at_cancel();

    nrf_802154_log_function_exit(NRF_802154_LOG_VERBOSITY_LOW);
    return result;
}

bool nrf_802154_receive_at(uint64_t rx_time,
                           uint32_t timeout,
                           uint8_t  channel,
                           uint32_t id)
{
    bool result;

    nrf_802154_log_function_enter(NRF_802154_LOG_VERBOSITY_LOW);

    result = nrf_802154_request_receive_at(rx_time, timeout, channel, id);

    nrf_802154_log_function_exit(NRF_802154_LOG_VERBOSITY_LOW);
    return result;
}

bool nrf_802154_receive_at_cancel(uint32_t id)
{
    bool result;

    nrf_802154_log_function_enter(NRF_802154_LOG_VERBOSITY_LOW);

    result = nrf_802154_request_receive_at_cancel(id);

    nrf_802154_log_function_exit(NRF_802154_LOG_VERBOSITY_LOW);
    return result;
}

#endif // NRF_802154_DELAYED_TRX_ENABLED

bool nrf_802154_energy_detection(uint32_t time_us)
{
    bool result;

    nrf_802154_log_function_enter(NRF_802154_LOG_VERBOSITY_LOW);

    result = nrf_802154_request_energy_detection(NRF_802154_TERM_NONE, time_us);

    nrf_802154_log_function_exit(NRF_802154_LOG_VERBOSITY_LOW);
    return result;
}

bool nrf_802154_cca(void)
{
    bool result;

    nrf_802154_log_function_enter(NRF_802154_LOG_VERBOSITY_LOW);

    result = nrf_802154_request_cca(NRF_802154_TERM_NONE);

    nrf_802154_log_function_exit(NRF_802154_LOG_VERBOSITY_LOW);
    return result;
}

#if NRF_802154_CARRIER_FUNCTIONS_ENABLED

bool nrf_802154_continuous_carrier(void)
{
    bool result;

    nrf_802154_log_function_enter(NRF_802154_LOG_VERBOSITY_LOW);

    result = nrf_802154_request_continuous_carrier(NRF_802154_TERM_NONE);

    nrf_802154_log_function_exit(NRF_802154_LOG_VERBOSITY_LOW);
    return result;
}

bool nrf_802154_modulated_carrier(const uint8_t * p_data)
{
    bool result;

    nrf_802154_log_function_enter(NRF_802154_LOG_VERBOSITY_LOW);

    tx_buffer_fill_for_modulated_carrier(p_data);

    result = nrf_802154_request_modulated_carrier(NRF_802154_TERM_NONE, m_tx_buffer);

    nrf_802154_log_function_exit(NRF_802154_LOG_VERBOSITY_LOW);
    return result;
}

#endif // NRF_802154_CARRIER_FUNCTIONS_ENABLED

#if NRF_802154_USE_RAW_API

void nrf_802154_buffer_free_raw(uint8_t * p_data)
{
    nrf_802154_log_function_enter(NRF_802154_LOG_VERBOSITY_LOW);

    bool          result;
    rx_buffer_t * p_buffer = (rx_buffer_t *)p_data;

    assert(p_buffer->free == false);
    (void)p_buffer;

    result = nrf_802154_request_buffer_free(p_data);
    assert(result);
    (void)result;

    nrf_802154_log_function_exit(NRF_802154_LOG_VERBOSITY_LOW);
}

bool nrf_802154_buffer_free_immediately_raw(uint8_t * p_data)
{
    nrf_802154_log_function_enter(NRF_802154_LOG_VERBOSITY_LOW);

    bool          result;
    rx_buffer_t * p_buffer = (rx_buffer_t *)p_data;

    assert(p_buffer->free == false);
    (void)p_buffer;

    result = nrf_802154_request_buffer_free(p_data);

    nrf_802154_log_function_exit(NRF_802154_LOG_VERBOSITY_LOW);
    return result;
}

#else // NRF_802154_USE_RAW_API

void nrf_802154_buffer_free(uint8_t * p_data)
{
    nrf_802154_log_function_enter(NRF_802154_LOG_VERBOSITY_LOW);

    bool          result;
    rx_buffer_t * p_buffer = (rx_buffer_t *)(p_data - RAW_PAYLOAD_OFFSET);

    assert(p_buffer->free == false);
    (void)p_buffer;

    result = nrf_802154_request_buffer_free(p_data - RAW_PAYLOAD_OFFSET);
    assert(result);
    (void)result;

    nrf_802154_log_function_exit(NRF_802154_LOG_VERBOSITY_LOW);
}

bool nrf_802154_buffer_free_immediately(uint8_t * p_data)
{
    nrf_802154_log_function_enter(NRF_802154_LOG_VERBOSITY_LOW);

    bool          result;
    rx_buffer_t * p_buffer = (rx_buffer_t *)(p_data - RAW_PAYLOAD_OFFSET);

    assert(p_buffer->free == false);
    (void)p_buffer;

    result = nrf_802154_request_buffer_free(p_data - RAW_PAYLOAD_OFFSET);

    nrf_802154_log_function_exit(NRF_802154_LOG_VERBOSITY_LOW);
    return result;
}

#endif // NRF_802154_USE_RAW_API

bool nrf_802154_rssi_measure_begin(void)
{
    return nrf_802154_request_rssi_measure();
}

int8_t nrf_802154_rssi_last_get(void)
{
    int8_t result = 0;

    if (!nrf_802154_request_rssi_measurement_get(&result))
    {
        result = NRF_802154_RSSI_INVALID;
    }

    return result;
}

bool nrf_802154_promiscuous_get(void)
{
    return nrf_802154_pib_promiscuous_get();
}

void nrf_802154_promiscuous_set(bool enabled)
{
    nrf_802154_pib_promiscuous_set(enabled);
}

void nrf_802154_auto_ack_set(bool enabled)
{
    nrf_802154_pib_auto_ack_set(enabled);
}

bool nrf_802154_auto_ack_get(void)
{
    return nrf_802154_pib_auto_ack_get();
}

bool nrf_802154_pan_coord_get(void)
{
    return nrf_802154_pib_pan_coord_get();
}

void nrf_802154_pan_coord_set(bool enabled)
{
    nrf_802154_pib_pan_coord_set(enabled);
}

void nrf_802154_src_addr_matching_method_set(nrf_802154_src_addr_match_t match_method)
{
    nrf_802154_ack_data_src_addr_matching_method_set(match_method);
}

bool nrf_802154_ack_data_set(const uint8_t       * p_addr,
                             bool                  extended,
                             const void          * p_data,
                             uint16_t              length,
                             nrf_802154_ack_data_t data_type)
{
    return nrf_802154_ack_data_for_addr_set(p_addr, extended, data_type, p_data, length);
}

bool nrf_802154_ack_data_clear(const uint8_t       * p_addr,
                               bool                  extended,
                               nrf_802154_ack_data_t data_type)
{
    return nrf_802154_ack_data_for_addr_clear(p_addr, extended, data_type);
}

void nrf_802154_auto_pending_bit_set(bool enabled)
{
    nrf_802154_ack_data_enable(enabled);
}

bool nrf_802154_pending_bit_for_addr_set(const uint8_t * p_addr, bool extended)
{
    return nrf_802154_ack_data_for_addr_set(p_addr,
                                            extended,
                                            NRF_802154_ACK_DATA_PENDING_BIT,
                                            NULL,
                                            0);
}

bool nrf_802154_pending_bit_for_addr_clear(const uint8_t * p_addr, bool extended)
{
    return nrf_802154_ack_data_for_addr_clear(p_addr, extended, NRF_802154_ACK_DATA_PENDING_BIT);
}

void nrf_802154_pending_bit_for_addr_reset(bool extended)
{
    nrf_802154_ack_data_reset(extended, NRF_802154_ACK_DATA_PENDING_BIT);
}

void nrf_802154_cca_cfg_set(const nrf_802154_cca_cfg_t * p_cca_cfg)
{
    nrf_802154_pib_cca_cfg_set(p_cca_cfg);

    nrf_802154_request_cca_cfg_update();
}

void nrf_802154_cca_cfg_get(nrf_802154_cca_cfg_t * p_cca_cfg)
{
    nrf_802154_pib_cca_cfg_get(p_cca_cfg);
}

#if NRF_802154_CSMA_CA_ENABLED
#if NRF_802154_USE_RAW_API

bool nrf_802154_transmit_csma_ca_raw(uint8_t                                      * p_data,
                                     const nrf_802154_transmit_csma_ca_metadata_t * p_metadata)
{
    bool result;

    nrf_802154_log_function_enter(NRF_802154_LOG_VERBOSITY_LOW);

    if (p_metadata == NULL)
    {
        static const nrf_802154_transmit_csma_ca_metadata_t metadata_default =
        {
            .frame_props = NRF_802154_TRANSMITTED_FRAME_PROPS_DEFAULT_INIT,
            .tx_power    = {.use_metadata_value = false}
        };

        p_metadata = &metadata_default;
    }

    result = are_frame_properties_valid(&p_metadata->frame_props);
    if (result)
    {
        nrf_802154_request_csma_ca_start(p_data, p_metadata);
    }

    nrf_802154_log_function_exit(NRF_802154_LOG_VERBOSITY_LOW);
    return result;
}

#else // NRF_802154_USE_RAW_API

bool nrf_802154_transmit_csma_ca(const uint8_t                                * p_data,
                                 uint8_t                                        length,
                                 const nrf_802154_transmit_csma_ca_metadata_t * p_metadata)
{
    bool result;

    nrf_802154_log_function_enter(NRF_802154_LOG_VERBOSITY_LOW);

    if (p_metadata == NULL)
    {
        static const nrf_802154_transmit_csma_ca_metadata_t metadata_default =
        {
            .frame_props = NRF_802154_TRANSMITTED_FRAME_PROPS_DEFAULT_INIT,
            .tx_power    = {.use_metadata_value = false}
        };

        p_metadata = &metadata_default;
    }

    result = are_frame_properties_valid(&p_metadata->frame_props);
    if (result)
    {
        tx_buffer_fill(p_data, length);
        nrf_802154_request_csma_ca_start(m_tx_buffer, p_metadata);
    }

    nrf_802154_log_function_exit(NRF_802154_LOG_VERBOSITY_LOW);
    return result;
}

#endif // NRF_802154_USE_RAW_API

bool nrf_802154_csma_ca_min_be_set(uint8_t min_be)
{
    return nrf_802154_pib_csmaca_min_be_set(min_be);
}

uint8_t nrf_802154_csma_ca_min_be_get(void)
{
    return nrf_802154_pib_csmaca_min_be_get();
}

bool nrf_802154_csma_ca_max_be_set(uint8_t max_be)
{
    return nrf_802154_pib_csmaca_max_be_set(max_be);
}

uint8_t nrf_802154_csma_ca_max_be_get(void)
{
    return nrf_802154_pib_csmaca_max_be_get();
}

void nrf_802154_csma_ca_max_backoffs_set(uint8_t max_backoffs)
{
    nrf_802154_pib_csmaca_max_backoffs_set(max_backoffs);
}

uint8_t nrf_802154_csma_ca_max_backoffs_get(void)
{
    return nrf_802154_pib_csmaca_max_backoffs_get();
}

#endif // NRF_802154_CSMA_CA_ENABLED

#if NRF_802154_ACK_TIMEOUT_ENABLED

void nrf_802154_ack_timeout_set(uint32_t time)
{
    nrf_802154_ack_timeout_time_set(time);
}

#endif // NRF_802154_ACK_TIMEOUT_ENABLED

#if NRF_802154_IFS_ENABLED

nrf_802154_ifs_mode_t nrf_802154_ifs_mode_get(void)
{
    return nrf_802154_pib_ifs_mode_get();
}

bool nrf_802154_ifs_mode_set(nrf_802154_ifs_mode_t mode)
{
    return nrf_802154_pib_ifs_mode_set(mode);
}

uint16_t nrf_802154_ifs_min_sifs_period_get(void)
{
    return nrf_802154_pib_ifs_min_sifs_period_get();
}

void nrf_802154_ifs_min_sifs_period_set(uint16_t period)
{
    nrf_802154_pib_ifs_min_sifs_period_set(period);
}

uint16_t nrf_802154_ifs_min_lifs_period_get(void)
{
    return nrf_802154_pib_ifs_min_lifs_period_get();
}

void nrf_802154_ifs_min_lifs_period_set(uint16_t period)
{
    nrf_802154_pib_ifs_min_lifs_period_set(period);
}

#endif // NRF_802154_IFS_ENABLED

nrf_802154_capabilities_t nrf_802154_capabilities_get(void)
{
    nrf_802154_capabilities_t    caps_drv = 0UL;
    nrf_802154_sl_capabilities_t caps_sl  = nrf_802154_sl_capabilities_get();

    /* Capabilities of the Service Layer depend on the version of it linked in,
     * hence require run-time probing. */
    caps_drv |= (NRF_802154_SL_CAPABILITY_CSMA & caps_sl) ?
                NRF_802154_CAPABILITY_CSMA : 0UL;
    caps_drv |= (NRF_802154_SL_CAPABILITY_DELAYED_TX & caps_sl) ?
                NRF_802154_CAPABILITY_DELAYED_TX : 0UL;
    caps_drv |= (NRF_802154_SL_CAPABILITY_DELAYED_RX & caps_sl) ?
                NRF_802154_CAPABILITY_DELAYED_RX : 0UL;
    caps_drv |= (NRF_802154_SL_CAPABILITY_ANT_DIVERSITY & caps_sl) ?
                NRF_802154_CAPABILITY_ANT_DIVERSITY : 0UL;
    caps_drv |= (NRF_802154_SL_CAPABILITY_TIMESTAMP & caps_sl) ?
                NRF_802154_CAPABILITY_TIMESTAMP : 0UL;

    /* Some Radio Driver capabilities are configured at compile time. */
    caps_drv |= (NRF_802154_ACK_TIMEOUT_ENABLED ?
                 NRF_802154_CAPABILITY_ACK_TIMEOUT : 0UL);

    caps_drv |= ((NRF_802154_SECURITY_WRITER_ENABLED && NRF_802154_ENCRYPTION_ENABLED) ?
                 NRF_802154_CAPABILITY_SECURITY : 0UL);

    /* Both IFS and ACK Timeout features require SL timer, however
     * using them both at the same time requires that SL is able to schedule
     * several timers simultaneously.
     *
     * ACK Timeout capability takes precedence over IFS if only one timer
     * can be scheduled because there is no known usecase for IFS without ACK Timeout,
     * and this configuration would require additional testing. If such usecase emerges,
     * this logic should be updated.
     */
    if (NRF_802154_SL_CAPABILITY_MULTITIMER & caps_sl)
    {
        caps_drv |= (NRF_802154_IFS_ENABLED ?
                     NRF_802154_CAPABILITY_IFS : 0UL);
    }

    return caps_drv;
}

uint64_t nrf_802154_time_get(void)
{
    return nrf_802154_sl_timer_current_time_get();
}

void nrf_802154_security_global_frame_counter_set(uint32_t frame_counter)
{
    nrf_802154_security_pib_global_frame_counter_set(frame_counter);
}

void nrf_802154_security_global_frame_counter_set_if_larger(uint32_t frame_counter)
{
    nrf_802154_security_pib_global_frame_counter_set_if_larger(frame_counter);
}

nrf_802154_security_error_t nrf_802154_security_key_store(nrf_802154_key_t * p_key)
{
    return nrf_802154_security_pib_key_store(p_key);
}

nrf_802154_security_error_t nrf_802154_security_key_remove(nrf_802154_key_id_t * p_id)
{
    return nrf_802154_security_pib_key_remove(p_id);
}

#if NRF_802154_DELAYED_TRX_ENABLED && NRF_802154_IE_WRITER_ENABLED

void nrf_802154_csl_writer_period_set(uint16_t period)
{
    nrf_802154_ie_writer_csl_period_set(period);
}

void nrf_802154_csl_writer_anchor_time_set(uint64_t anchor_time)
{
    nrf_802154_ie_writer_csl_anchor_time_set(anchor_time);
}

#endif

__WEAK void nrf_802154_custom_part_of_radio_init(void)
{
    // Intentionally empty
}

__WEAK void nrf_802154_tx_ack_started(const uint8_t * p_data)
{
    (void)p_data;
}

#if NRF_802154_USE_RAW_API
__WEAK void nrf_802154_received_raw(uint8_t * p_data, int8_t power, uint8_t lqi)
{
    uint64_t timestamp;

    nrf_802154_stat_timestamp_read(&timestamp, last_rx_end_timestamp);

    nrf_802154_received_timestamp_raw(p_data,
                                      power,
                                      lqi,
                                      timestamp);
}

__WEAK void nrf_802154_received_timestamp_raw(uint8_t * p_data,
                                              int8_t    power,
                                              uint8_t   lqi,
                                              uint64_t  time)
{
    (void)power;
    (void)lqi;
    (void)time;

    nrf_802154_buffer_free_raw(p_data);
}

#else // NRF_802154_USE_RAW_API

__WEAK void nrf_802154_received(uint8_t * p_data, uint8_t length, int8_t power, uint8_t lqi)
{
    nrf_802154_received_timestamp(p_data, length, power, lqi, last_rx_frame_timestamp_get());
}

__WEAK void nrf_802154_received_timestamp(uint8_t * p_data,
                                          uint8_t   length,
                                          int8_t    power,
                                          uint8_t   lqi,
                                          uint32_t  time)
{
    (void)length;
    (void)power;
    (void)lqi;
    (void)time;

    nrf_802154_buffer_free(p_data);
}

#endif // !NRF_802154_USE_RAW_API

__WEAK void nrf_802154_receive_failed(nrf_802154_rx_error_t error, uint32_t id)
{
    (void)error;
    (void)id;
}

__WEAK void nrf_802154_tx_started(const uint8_t * p_frame)
{
    (void)p_frame;
}

#if NRF_802154_USE_RAW_API
__WEAK void nrf_802154_transmitted_raw(uint8_t                                   * p_frame,
                                       const nrf_802154_transmit_done_metadata_t * p_metadata)
{
    (void)p_frame;

    uint8_t * p_ack = p_metadata->data.transmitted.p_ack;

    if (p_ack != NULL)
    {
        nrf_802154_buffer_free_raw(p_ack);
    }
}

#else // NRF_802154_USE_RAW_API

__WEAK void nrf_802154_transmitted(uint8_t                                   * p_frame,
                                   const nrf_802154_transmit_done_metadata_t * p_metadata)

{
    (void)p_frame;

    uint8_t * p_ack = p_metadata->data.transmitted.p_ack;

    if (p_ack != NULL)
    {
        nrf_802154_buffer_free(p_ack);
    }
}

#endif // NRF_802154_USE_RAW_API

__WEAK void nrf_802154_transmit_failed(uint8_t                                   * p_frame,
                                       nrf_802154_tx_error_t                       error,
                                       const nrf_802154_transmit_done_metadata_t * p_metadata)
{
    (void)p_frame;
    (void)error;
    (void)p_metadata;
}

__WEAK void nrf_802154_energy_detected(uint8_t result)
{
    (void)result;
}

__WEAK void nrf_802154_energy_detection_failed(nrf_802154_ed_error_t error)
{
    (void)error;
}

__WEAK void nrf_802154_cca_done(bool channel_free)
{
    (void)channel_free;
}

__WEAK void nrf_802154_cca_failed(nrf_802154_cca_error_t error)
{
    (void)error;
}

#if NRF_802154_TEST_MODES_ENABLED

nrf_802154_test_mode_csmaca_backoff_t nrf_802154_test_mode_csmaca_backoff_get(void)
{
    return nrf_802154_pib_test_mode_csmaca_backoff_get();
}

void nrf_802154_test_mode_csmaca_backoff_set(nrf_802154_test_mode_csmaca_backoff_t value)
{
    nrf_802154_pib_test_mode_csmaca_backoff_set(value);
}

#endif // NRF_802154_TEST_MODES_ENABLED