nrf_802154_frame.h

Go to the documentation of this file.

/*
 * Copyright (c) 2025, 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.
 *
 */
 
#ifndef NRF_802154_FRAME_H
#define NRF_802154_FRAME_H
 
#include "nrfx.h"
#include "nrf_802154_const.h"
#include "nrf_802154_utils_byteorder.h"
#include <stdbool.h>
#include <stdint.h>
#include <stddef.h>
 
#ifdef __STATIC_INLINE__
#undef __STATIC_INLINE__
#endif
 
#ifdef NRF_802154_FRAME_DECLARE_ONLY
#define __STATIC_INLINE__
#else
#define __STATIC_INLINE__               __STATIC_INLINE
#endif
 
#define NRF_802154_FRAME_INVALID_OFFSET 0xff
 
typedef enum
{
    PARSE_LEVEL_NONE,
 
    PARSE_LEVEL_FCF_OFFSETS,
 
    PARSE_LEVEL_DST_ADDRESSING_END,
 
    PARSE_LEVEL_ADDRESSING_END,
 
    PARSE_LEVEL_SEC_CTRL_OFFSETS,
 
    PARSE_LEVEL_AUX_SEC_HDR_END,
 
    PARSE_LEVEL_FULL,
 
    PARSE_LEVEL_MAX = PARSE_LEVEL_FULL
} nrf_802154_frame_parser_level_t;
 
typedef struct
{
    uint8_t                       * p_frame;        
    nrf_802154_frame_parser_level_t parse_level;    
    uint8_t                         valid_data_len; 
 
    struct
    {
        struct
        {
            uint8_t panid_offset; 
            uint8_t addr_offset;  
        } dst;
 
        struct
        {
            uint8_t panid_offset; 
            uint8_t addr_offset;  
        } src;
 
        struct
        {
            uint8_t sec_ctrl_offset;      
            uint8_t frame_counter_offset; 
            uint8_t key_id_offset;        
            uint8_t key_src_offset;       
            uint8_t key_idx_offset;       
        }       aux_sec_hdr;
 
        uint8_t header_ie_offset;         
    } mhr;
 
    struct
    {
        uint8_t mac_payload_offset; 
    } mac_payload;
 
    struct
    {
        uint8_t dst_addr_size;             
        uint8_t src_addr_size;             
        uint8_t dst_addressing_end_offset; 
        uint8_t addressing_end_offset;     
        uint8_t aux_sec_hdr_end_offset;    
        uint8_t key_src_size;              
        uint8_t mic_size;                  
    } helper;
} nrf_802154_frame_t;
 
__STATIC_INLINE__ nrf_802154_frame_parser_level_t nrf_802154_frame_parse_level_get(
    const nrf_802154_frame_t * p_parser_data);
 
__STATIC_INLINE__ uint8_t nrf_802154_frame_length_get(
    const nrf_802154_frame_t * p_parser_data);
 
__STATIC_INLINE__ uint8_t nrf_802154_frame_psdu_offset_get(
    const nrf_802154_frame_t * p_parser_data);
 
__STATIC_INLINE__ const uint8_t * nrf_802154_frame_psdu_get(
    const nrf_802154_frame_t * p_parser_data);
 
__STATIC_INLINE__ uint8_t nrf_802154_frame_version_get(
    const nrf_802154_frame_t * p_parser_data);
 
__STATIC_INLINE__ bool nrf_802154_frame_dsn_suppress_bit_is_set(
    const nrf_802154_frame_t * p_parser_data);
 
__STATIC_INLINE__ uint8_t nrf_802154_frame_dst_addr_type_get(
    const nrf_802154_frame_t * p_parser_data);
 
__STATIC_INLINE__ bool nrf_802154_frame_dst_addr_is_extended(
    const nrf_802154_frame_t * p_parser_data);
 
__STATIC_INLINE__ uint8_t nrf_802154_frame_src_addr_type_get(
    const nrf_802154_frame_t * p_parser_data);
 
__STATIC_INLINE__ bool nrf_802154_frame_src_addr_is_extended(
    const nrf_802154_frame_t * p_parser_data);
 
__STATIC_INLINE__ bool nrf_802154_frame_src_addr_is_short(
    const nrf_802154_frame_t * p_parser_data);
 
__STATIC_INLINE__ bool nrf_802154_frame_security_enabled_bit_is_set(
    const nrf_802154_frame_t * p_parser_data);
 
__STATIC_INLINE__ bool nrf_802154_frame_ie_present_bit_is_set(
    const nrf_802154_frame_t * p_parser_data);
 
__STATIC_INLINE__ bool nrf_802154_frame_pending_bit_is_set(
    const nrf_802154_frame_t * p_parser_data);
 
__STATIC_INLINE__ uint8_t nrf_802154_frame_type_get(
    const nrf_802154_frame_t * p_parser_data);
 
__STATIC_INLINE__ bool nrf_802154_frame_panid_compression_is_set(
    const nrf_802154_frame_t * p_parser_data);
 
__STATIC_INLINE__ bool nrf_802154_frame_ar_bit_is_set(
    const nrf_802154_frame_t * p_parser_data);
 
__STATIC_INLINE__ const uint8_t * nrf_802154_frame_dsn_get(
    const nrf_802154_frame_t * p_parser_data);
 
__STATIC_INLINE__ uint8_t nrf_802154_frame_dst_panid_offset_get(
    const nrf_802154_frame_t * p_parser_data);
 
__STATIC_INLINE__ const uint8_t * nrf_802154_frame_dst_panid_get(
    const nrf_802154_frame_t * p_parser_data);
 
__STATIC_INLINE__ uint8_t nrf_802154_frame_dst_addr_offset_get(
    const nrf_802154_frame_t * p_parser_data);
 
__STATIC_INLINE__ const uint8_t * nrf_802154_frame_dst_addr_get(
    const nrf_802154_frame_t * p_parser_data);
 
__STATIC_INLINE__ uint8_t nrf_802154_frame_src_panid_offset_get(
    const nrf_802154_frame_t * p_parser_data);
 
__STATIC_INLINE__ const uint8_t * nrf_802154_frame_src_panid_get(
    const nrf_802154_frame_t * p_parser_data);
 
__STATIC_INLINE__ uint8_t nrf_802154_frame_src_addr_offset_get(
    const nrf_802154_frame_t * p_parser_data);
 
__STATIC_INLINE__ const uint8_t * nrf_802154_frame_src_addr_get(
    const nrf_802154_frame_t * p_parser_data);
 
__STATIC_INLINE__ uint8_t nrf_802154_frame_src_addr_size_get(
    const nrf_802154_frame_t * p_parser_data);
 
__STATIC_INLINE__ uint8_t nrf_802154_frame_dst_addr_size_get(
    const nrf_802154_frame_t * p_parser_data);
 
__STATIC_INLINE__ uint8_t nrf_802154_frame_sec_ctrl_offset_get(
    const nrf_802154_frame_t * p_parser_data);
 
__STATIC_INLINE__ uint8_t nrf_802154_frame_sec_ctrl_sec_lvl_get(
    const nrf_802154_frame_t * p_parser_data);
 
__STATIC_INLINE__ bool nrf_802154_frame_sec_ctrl_fc_suppress_bit_is_set(
    const nrf_802154_frame_t * p_parser_data);
 
__STATIC_INLINE__ uint8_t nrf_802154_frame_sec_ctrl_key_id_mode_get(
    const nrf_802154_frame_t * p_parser_data);
 
__STATIC_INLINE__ bool nrf_802154_frame_sec_ctrl_asn_in_nonce_bit_is_set(
    const nrf_802154_frame_t * p_parser_data);
 
__STATIC_INLINE__ const uint8_t * nrf_802154_frame_sec_ctrl_get(
    const nrf_802154_frame_t * p_parser_data);
 
__STATIC_INLINE__ uint8_t nrf_802154_frame_counter_offset_get(
    const nrf_802154_frame_t * p_parser_data);
 
__STATIC_INLINE__ const uint8_t * nrf_802154_frame_counter_get(
    const nrf_802154_frame_t * p_parser_data);
 
__STATIC_INLINE__ uint8_t nrf_802154_frame_key_id_offset_get(
    const nrf_802154_frame_t * p_parser_data);
 
__STATIC_INLINE__ const uint8_t * nrf_802154_frame_key_id_get(
    const nrf_802154_frame_t * p_parser_data);
 
__STATIC_INLINE__ uint8_t nrf_802154_frame_key_source_offset_get(
    const nrf_802154_frame_t * p_parser_data);
 
__STATIC_INLINE__ const uint8_t * nrf_802154_frame_key_source_get(
    const nrf_802154_frame_t * p_parser_data);
 
__STATIC_INLINE__ uint8_t nrf_802154_frame_key_source_length_get(
    const nrf_802154_frame_t * p_parser_data);
 
__STATIC_INLINE__ uint8_t nrf_802154_frame_key_index_offset_get(
    const nrf_802154_frame_t * p_parser_data);
 
__STATIC_INLINE__ uint8_t nrf_802154_frame_key_index_get(
    const nrf_802154_frame_t * p_parser_data);
 
__STATIC_INLINE__ uint8_t nrf_802154_frame_ie_header_offset_get(
    const nrf_802154_frame_t * p_parser_data);
 
__STATIC_INLINE__ const uint8_t * nrf_802154_frame_ie_header_get(
    const nrf_802154_frame_t * p_parser_data);
 
__STATIC_INLINE__ uint8_t nrf_802154_frame_mac_payload_offset_get(
    const nrf_802154_frame_t * p_parser_data);
 
__STATIC_INLINE__ const uint8_t * nrf_802154_frame_mac_payload_get(
    const nrf_802154_frame_t * p_parser_data);
 
__STATIC_INLINE__ uint8_t nrf_802154_frame_mac_command_id_offset_get(
    const nrf_802154_frame_t * p_parser_data);
 
__STATIC_INLINE__ const uint8_t * nrf_802154_frame_mac_command_id_get(
    const nrf_802154_frame_t * p_parser_data);
 
__STATIC_INLINE__ uint8_t nrf_802154_frame_mfr_offset_get(
    const nrf_802154_frame_t * p_parser_data);
 
__STATIC_INLINE__ const uint8_t * nrf_802154_frame_mfr_get(
    const nrf_802154_frame_t * p_parser_data);
 
__STATIC_INLINE__ uint8_t nrf_802154_frame_mic_size_get(
    const nrf_802154_frame_t * p_parser_data);
 
__STATIC_INLINE__ uint8_t nrf_802154_frame_mac_payload_length_get(
    const nrf_802154_frame_t * p_parser_data);
 
__STATIC_INLINE__ uint8_t nrf_802154_frame_mac_header_length_get(
    const nrf_802154_frame_t * p_parser_data);
 
__STATIC_INLINE__ uint8_t nrf_802154_frame_dst_addressing_end_offset_get(
    const nrf_802154_frame_t * p_parser_data);
 
__STATIC_INLINE__ const uint8_t * nrf_802154_frame_dst_addressing_end_get(
    const nrf_802154_frame_t * p_parser_data);
 
__STATIC_INLINE__ uint8_t nrf_802154_frame_addressing_end_offset_get(
    const nrf_802154_frame_t * p_parser_data);
 
__STATIC_INLINE__ const uint8_t * nrf_802154_frame_addressing_end_get(
    const nrf_802154_frame_t * p_parser_data);
 
__STATIC_INLINE__ uint8_t nrf_802154_frame_aux_sec_hdr_end_offset_get(
    const nrf_802154_frame_t * p_parser_data);
 
__STATIC_INLINE__ const uint8_t * nrf_802154_frame_header_ie_iterator_begin(
    const uint8_t * p_ie_header);
 
__STATIC_INLINE__ const uint8_t * nrf_802154_frame_ie_content_address_get(
    const uint8_t * p_ie_iterator);
 
__STATIC_INLINE__ uint8_t nrf_802154_frame_ie_length_get(const uint8_t * p_ie_iterator);
 
__STATIC_INLINE__ const uint8_t * nrf_802154_frame_ie_iterator_next(
    const uint8_t * p_ie_iterator);
 
__STATIC_INLINE__ uint8_t nrf_802154_frame_ie_id_get(const uint8_t * p_ie_iterator);
 
__STATIC_INLINE__ bool nrf_802154_frame_ie_iterator_end(const uint8_t * p_ie_iterator,
                                                        const uint8_t * p_end_addr);
 
__STATIC_INLINE__ uint32_t nrf_802154_frame_ie_vendor_oui_get(const uint8_t * p_ie_iterator);
 
__STATIC_INLINE__ uint8_t nrf_802154_frame_ie_vendor_thread_subtype_get(
    const uint8_t * p_ie_iterator);
 
__STATIC_INLINE__ const uint8_t * nrf_802154_frame_ie_vendor_thread_data_addr_get(
    const uint8_t * p_ie_iterator);
 
#ifndef NRF_802154_FRAME_DECLARE_ONLY
 
__STATIC_INLINE__ nrf_802154_frame_parser_level_t nrf_802154_frame_parse_level_get(
    const nrf_802154_frame_t * p_parser_data)
{
    return p_parser_data->parse_level;
}
 
__STATIC_INLINE__ uint8_t nrf_802154_frame_length_get(
    const nrf_802154_frame_t * p_parser_data)
{
    return p_parser_data->p_frame[PHR_OFFSET];
}
 
__STATIC_INLINE__ uint8_t nrf_802154_frame_psdu_offset_get(
    const nrf_802154_frame_t * p_parser_data)
{
    return PSDU_OFFSET;
}
 
__STATIC_INLINE__ const uint8_t * nrf_802154_frame_psdu_get(
    const nrf_802154_frame_t * p_parser_data)
{
    return &p_parser_data->p_frame[PSDU_OFFSET];
}
 
__STATIC_INLINE__ uint8_t nrf_802154_frame_version_get(
    const nrf_802154_frame_t * p_parser_data)
{
    return p_parser_data->p_frame[FRAME_VERSION_OFFSET] & FRAME_VERSION_MASK;
}
 
__STATIC_INLINE__ bool nrf_802154_frame_dsn_suppress_bit_is_set(
    const nrf_802154_frame_t * p_parser_data)
{
    return (p_parser_data->p_frame[DSN_SUPPRESS_OFFSET] & DSN_SUPPRESS_BIT) ? true : false;
}
 
__STATIC_INLINE__ uint8_t nrf_802154_frame_dst_addr_type_get(
    const nrf_802154_frame_t * p_parser_data)
{
    return p_parser_data->p_frame[DEST_ADDR_TYPE_OFFSET] & DEST_ADDR_TYPE_MASK;
}
 
__STATIC_INLINE__ bool nrf_802154_frame_dst_addr_is_extended(
    const nrf_802154_frame_t * p_parser_data)
{
    return (p_parser_data->p_frame[DEST_ADDR_TYPE_OFFSET] & DEST_ADDR_TYPE_MASK) ==
           DEST_ADDR_TYPE_EXTENDED;
}
 
__STATIC_INLINE__ uint8_t nrf_802154_frame_src_addr_type_get(
    const nrf_802154_frame_t * p_parser_data)
{
    return p_parser_data->p_frame[SRC_ADDR_TYPE_OFFSET] & SRC_ADDR_TYPE_MASK;
}
 
__STATIC_INLINE__ bool nrf_802154_frame_src_addr_is_extended(
    const nrf_802154_frame_t * p_parser_data)
{
    return (p_parser_data->p_frame[SRC_ADDR_TYPE_OFFSET] & SRC_ADDR_TYPE_MASK) ==
           SRC_ADDR_TYPE_EXTENDED;
}
 
__STATIC_INLINE__ bool nrf_802154_frame_src_addr_is_short(
    const nrf_802154_frame_t * p_parser_data)
{
    return (p_parser_data->p_frame[SRC_ADDR_TYPE_OFFSET] & SRC_ADDR_TYPE_MASK) ==
           SRC_ADDR_TYPE_SHORT;
}
 
__STATIC_INLINE__ bool nrf_802154_frame_security_enabled_bit_is_set(
    const nrf_802154_frame_t * p_parser_data)
{
    return (p_parser_data->p_frame[SECURITY_ENABLED_OFFSET] & SECURITY_ENABLED_BIT) ? true : false;
}
 
__STATIC_INLINE__ bool nrf_802154_frame_ie_present_bit_is_set(
    const nrf_802154_frame_t * p_parser_data)
{
    return (p_parser_data->p_frame[IE_PRESENT_OFFSET] & IE_PRESENT_BIT) ? true : false;
}
 
__STATIC_INLINE__ bool nrf_802154_frame_pending_bit_is_set(
    const nrf_802154_frame_t * p_parser_data)
{
    return (p_parser_data->p_frame[FRAME_PENDING_OFFSET] & FRAME_PENDING_BIT) != 0;
}
 
__STATIC_INLINE__ uint8_t nrf_802154_frame_type_get(
    const nrf_802154_frame_t * p_parser_data)
{
    return p_parser_data->p_frame[FRAME_TYPE_OFFSET] & FRAME_TYPE_MASK;
}
 
__STATIC_INLINE__ bool nrf_802154_frame_panid_compression_is_set(
    const nrf_802154_frame_t * p_parser_data)
{
    return (p_parser_data->p_frame[PAN_ID_COMPR_OFFSET] & PAN_ID_COMPR_MASK) ? true : false;
}
 
__STATIC_INLINE__ bool nrf_802154_frame_ar_bit_is_set(
    const nrf_802154_frame_t * p_parser_data)
{
    if ((p_parser_data->p_frame[FRAME_TYPE_OFFSET] & FRAME_TYPE_MASK) == FRAME_TYPE_MULTIPURPOSE)
    {
        return false;
    }
    else
    {
        return (p_parser_data->p_frame[ACK_REQUEST_OFFSET] & ACK_REQUEST_BIT) ? true : false;
    }
}
 
__STATIC_INLINE__ const uint8_t * nrf_802154_frame_dsn_get(
    const nrf_802154_frame_t * p_parser_data)
{
    if (nrf_802154_frame_dsn_suppress_bit_is_set(p_parser_data))
    {
        return NULL;
    }
 
    return &p_parser_data->p_frame[DSN_OFFSET];
}
 
__STATIC_INLINE__ uint8_t nrf_802154_frame_dst_panid_offset_get(
    const nrf_802154_frame_t * p_parser_data)
{
    return p_parser_data->mhr.dst.panid_offset;
}
 
__STATIC_INLINE__ const uint8_t * nrf_802154_frame_dst_panid_get(
    const nrf_802154_frame_t * p_parser_data)
{
    uint8_t offset = nrf_802154_frame_dst_panid_offset_get(p_parser_data);
 
    if (offset == NRF_802154_FRAME_INVALID_OFFSET)
    {
        return NULL;
    }
 
    return &p_parser_data->p_frame[offset];
}
 
__STATIC_INLINE__ uint8_t nrf_802154_frame_dst_addr_offset_get(
    const nrf_802154_frame_t * p_parser_data)
{
    return p_parser_data->mhr.dst.addr_offset;
}
 
__STATIC_INLINE__ const uint8_t * nrf_802154_frame_dst_addr_get(
    const nrf_802154_frame_t * p_parser_data)
{
    uint8_t offset = nrf_802154_frame_dst_addr_offset_get(p_parser_data);
 
    if (offset == NRF_802154_FRAME_INVALID_OFFSET)
    {
        return NULL;
    }
 
    return &p_parser_data->p_frame[offset];
}
 
__STATIC_INLINE__ uint8_t nrf_802154_frame_src_panid_offset_get(
    const nrf_802154_frame_t * p_parser_data)
{
    return p_parser_data->mhr.src.panid_offset;
}
 
__STATIC_INLINE__ const uint8_t * nrf_802154_frame_src_panid_get(
    const nrf_802154_frame_t * p_parser_data)
{
    uint8_t offset = nrf_802154_frame_src_panid_offset_get(p_parser_data);
 
    if (offset == NRF_802154_FRAME_INVALID_OFFSET)
    {
        return NULL;
    }
 
    return &p_parser_data->p_frame[offset];
}
 
__STATIC_INLINE__ uint8_t nrf_802154_frame_src_addr_offset_get(
    const nrf_802154_frame_t * p_parser_data)
{
    return p_parser_data->mhr.src.addr_offset;
}
 
__STATIC_INLINE__ const uint8_t * nrf_802154_frame_src_addr_get(
    const nrf_802154_frame_t * p_parser_data)
{
    uint8_t offset = nrf_802154_frame_src_addr_offset_get(p_parser_data);
 
    if (offset == NRF_802154_FRAME_INVALID_OFFSET)
    {
        return NULL;
    }
 
    return &p_parser_data->p_frame[offset];
}
 
__STATIC_INLINE__ uint8_t nrf_802154_frame_src_addr_size_get(
    const nrf_802154_frame_t * p_parser_data)
{
    return p_parser_data->helper.src_addr_size;
}
 
__STATIC_INLINE__ uint8_t nrf_802154_frame_dst_addr_size_get(
    const nrf_802154_frame_t * p_parser_data)
{
    return p_parser_data->helper.dst_addr_size;
}
 
__STATIC_INLINE__ uint8_t nrf_802154_frame_sec_ctrl_offset_get(
    const nrf_802154_frame_t * p_parser_data)
{
    return p_parser_data->mhr.aux_sec_hdr.sec_ctrl_offset;
}
 
__STATIC_INLINE__ uint8_t nrf_802154_frame_sec_ctrl_sec_lvl_get(
    const nrf_802154_frame_t * p_parser_data)
{
    uint8_t offset = nrf_802154_frame_sec_ctrl_offset_get(p_parser_data);
 
    if (offset == NRF_802154_FRAME_INVALID_OFFSET)
    {
        return 0;
    }
 
    return p_parser_data->p_frame[offset] & SECURITY_LEVEL_MASK;
}
 
__STATIC_INLINE__ bool nrf_802154_frame_sec_ctrl_fc_suppress_bit_is_set(
    const nrf_802154_frame_t * p_parser_data)
{
    uint8_t offset = nrf_802154_frame_sec_ctrl_offset_get(p_parser_data);
 
    if (offset == NRF_802154_FRAME_INVALID_OFFSET)
    {
        return false;
    }
 
    return p_parser_data->p_frame[offset] & FRAME_COUNTER_SUPPRESS_BIT;
}
 
__STATIC_INLINE__ uint8_t nrf_802154_frame_sec_ctrl_key_id_mode_get(
    const nrf_802154_frame_t * p_parser_data)
{
    uint8_t offset = nrf_802154_frame_sec_ctrl_offset_get(p_parser_data);
 
    if (offset == NRF_802154_FRAME_INVALID_OFFSET)
    {
        return 0;
    }
 
    return (p_parser_data->p_frame[offset] & KEY_ID_MODE_MASK) >> KEY_ID_MODE_BIT_OFFSET;
}
 
__STATIC_INLINE__ bool nrf_802154_frame_sec_ctrl_asn_in_nonce_bit_is_set(
    const nrf_802154_frame_t * p_parser_data)
{
    uint8_t offset = nrf_802154_frame_sec_ctrl_offset_get(p_parser_data);
 
    if (offset == NRF_802154_FRAME_INVALID_OFFSET)
    {
        return false;
    }
 
    return p_parser_data->p_frame[offset] & ASN_IN_NONCE_BIT;
}
 
__STATIC_INLINE__ const uint8_t * nrf_802154_frame_sec_ctrl_get(
    const nrf_802154_frame_t * p_parser_data)
{
    uint8_t offset = nrf_802154_frame_sec_ctrl_offset_get(p_parser_data);
 
    if (offset == NRF_802154_FRAME_INVALID_OFFSET)
    {
        return NULL;
    }
 
    return &p_parser_data->p_frame[offset];
}
 
__STATIC_INLINE__ uint8_t nrf_802154_frame_counter_offset_get(
    const nrf_802154_frame_t * p_parser_data)
{
    return p_parser_data->mhr.aux_sec_hdr.frame_counter_offset;
}
 
__STATIC_INLINE__ const uint8_t * nrf_802154_frame_counter_get(
    const nrf_802154_frame_t * p_parser_data)
{
    uint8_t offset = nrf_802154_frame_counter_offset_get(p_parser_data);
 
    if (offset == NRF_802154_FRAME_INVALID_OFFSET)
    {
        return NULL;
    }
 
    return &p_parser_data->p_frame[offset];
}
 
__STATIC_INLINE__ uint8_t nrf_802154_frame_key_id_offset_get(
    const nrf_802154_frame_t * p_parser_data)
{
    return p_parser_data->mhr.aux_sec_hdr.key_id_offset;
}
 
__STATIC_INLINE__ const uint8_t * nrf_802154_frame_key_id_get(
    const nrf_802154_frame_t * p_parser_data)
{
    uint8_t offset = nrf_802154_frame_key_id_offset_get(p_parser_data);
 
    if (offset == NRF_802154_FRAME_INVALID_OFFSET)
    {
        return NULL;
    }
 
    return &p_parser_data->p_frame[offset];
}
 
__STATIC_INLINE__ uint8_t nrf_802154_frame_key_source_offset_get(
    const nrf_802154_frame_t * p_parser_data)
{
    return p_parser_data->mhr.aux_sec_hdr.key_src_offset;
}
 
__STATIC_INLINE__ const uint8_t * nrf_802154_frame_key_source_get(
    const nrf_802154_frame_t * p_parser_data)
{
    uint8_t offset = nrf_802154_frame_key_source_offset_get(p_parser_data);
 
    if (offset == NRF_802154_FRAME_INVALID_OFFSET)
    {
        return NULL;
    }
 
    return &p_parser_data->p_frame[offset];
}
 
__STATIC_INLINE__ uint8_t nrf_802154_frame_key_source_length_get(
    const nrf_802154_frame_t * p_parser_data)
{
    return p_parser_data->helper.key_src_size;
}
 
__STATIC_INLINE__ uint8_t nrf_802154_frame_key_index_offset_get(
    const nrf_802154_frame_t * p_parser_data)
{
    return p_parser_data->mhr.aux_sec_hdr.key_idx_offset;
}
 
__STATIC_INLINE__ uint8_t nrf_802154_frame_key_index_get(
    const nrf_802154_frame_t * p_parser_data)
{
    uint8_t offset = nrf_802154_frame_key_index_offset_get(p_parser_data);
 
    if (offset == NRF_802154_FRAME_INVALID_OFFSET)
    {
        return 0;
    }
 
    return p_parser_data->p_frame[offset];
}
 
__STATIC_INLINE__ uint8_t nrf_802154_frame_ie_header_offset_get(
    const nrf_802154_frame_t * p_parser_data)
{
    return p_parser_data->mhr.header_ie_offset;
}
 
__STATIC_INLINE__ const uint8_t * nrf_802154_frame_ie_header_get(
    const nrf_802154_frame_t * p_parser_data)
{
    uint8_t offset = nrf_802154_frame_ie_header_offset_get(p_parser_data);
 
    if (offset == NRF_802154_FRAME_INVALID_OFFSET)
    {
        return NULL;
    }
 
    return &p_parser_data->p_frame[offset];
}
 
__STATIC_INLINE__ uint8_t nrf_802154_frame_mac_payload_offset_get(
    const nrf_802154_frame_t * p_parser_data)
{
    return p_parser_data->mac_payload.mac_payload_offset;
}
 
__STATIC_INLINE__ const uint8_t * nrf_802154_frame_mac_payload_get(
    const nrf_802154_frame_t * p_parser_data)
{
    uint8_t offset = nrf_802154_frame_mac_payload_offset_get(p_parser_data);
 
    if (offset == NRF_802154_FRAME_INVALID_OFFSET)
    {
        return NULL;
    }
 
    return &p_parser_data->p_frame[offset];
}
 
__STATIC_INLINE__ uint8_t nrf_802154_frame_mac_command_id_offset_get(
    const nrf_802154_frame_t * p_parser_data)
{
    if (nrf_802154_frame_type_get(p_parser_data) != FRAME_TYPE_COMMAND)
    {
        return NRF_802154_FRAME_INVALID_OFFSET;
    }
 
    // MAC command frames containing Payload Information Elements are not supported.
    return nrf_802154_frame_mac_payload_offset_get(p_parser_data);
}
 
__STATIC_INLINE__ const uint8_t * nrf_802154_frame_mac_command_id_get(
    const nrf_802154_frame_t * p_parser_data)
{
    uint8_t offset = nrf_802154_frame_mac_command_id_offset_get(p_parser_data);
 
    if (offset == NRF_802154_FRAME_INVALID_OFFSET)
    {
        return NULL;
    }
 
    return &p_parser_data->p_frame[offset];
}
 
__STATIC_INLINE__ uint8_t nrf_802154_frame_mfr_offset_get(
    const nrf_802154_frame_t * p_parser_data)
{
    return nrf_802154_frame_length_get(p_parser_data) - FCS_SIZE + PHR_SIZE;
}
 
__STATIC_INLINE__ const uint8_t * nrf_802154_frame_mfr_get(
    const nrf_802154_frame_t * p_parser_data)
{
    uint8_t offset = nrf_802154_frame_mfr_offset_get(p_parser_data);
 
    if (offset == NRF_802154_FRAME_INVALID_OFFSET)
    {
        return NULL;
    }
 
    return &p_parser_data->p_frame[offset];
}
 
__STATIC_INLINE__ uint8_t nrf_802154_frame_mic_size_get(
    const nrf_802154_frame_t * p_parser_data)
{
    return p_parser_data->helper.mic_size;
}
 
__STATIC_INLINE__ uint8_t nrf_802154_frame_mac_payload_length_get(
    const nrf_802154_frame_t * p_parser_data)
{
    uint8_t mic_len       = nrf_802154_frame_mic_size_get(p_parser_data);
    uint8_t payload_start = nrf_802154_frame_mac_payload_offset_get(p_parser_data);
    uint8_t payload_end   = nrf_802154_frame_mfr_offset_get(p_parser_data) - mic_len;
 
    return payload_end - payload_start;
}
 
__STATIC_INLINE__ uint8_t nrf_802154_frame_mac_header_length_get(
    const nrf_802154_frame_t * p_parser_data)
{
    uint8_t mhr_start = nrf_802154_frame_psdu_offset_get(p_parser_data);
    uint8_t mhr_end   = nrf_802154_frame_mac_payload_offset_get(p_parser_data);
 
    if (mhr_end == NRF_802154_FRAME_INVALID_OFFSET)
    {
        mhr_end = nrf_802154_frame_mfr_offset_get(p_parser_data);
    }
 
    return mhr_end - mhr_start;
}
 
__STATIC_INLINE__ uint8_t nrf_802154_frame_dst_addressing_end_offset_get(
    const nrf_802154_frame_t * p_parser_data)
{
    return p_parser_data->helper.dst_addressing_end_offset;
}
 
__STATIC_INLINE__ const uint8_t * nrf_802154_frame_dst_addressing_end_get(
    const nrf_802154_frame_t * p_parser_data)
{
    uint8_t offset = nrf_802154_frame_dst_addressing_end_offset_get(p_parser_data);
 
    if (offset == NRF_802154_FRAME_INVALID_OFFSET)
    {
        return NULL;
    }
 
    return &p_parser_data->p_frame[offset];
}
 
__STATIC_INLINE__ uint8_t nrf_802154_frame_addressing_end_offset_get(
    const nrf_802154_frame_t * p_parser_data)
{
    return p_parser_data->helper.addressing_end_offset;
}
 
__STATIC_INLINE__ const uint8_t * nrf_802154_frame_addressing_end_get(
    const nrf_802154_frame_t * p_parser_data)
{
    uint8_t offset = nrf_802154_frame_addressing_end_offset_get(p_parser_data);
 
    if (offset == NRF_802154_FRAME_INVALID_OFFSET)
    {
        return NULL;
    }
 
    return &p_parser_data->p_frame[offset];
}
 
__STATIC_INLINE__ uint8_t nrf_802154_frame_aux_sec_hdr_end_offset_get(
    const nrf_802154_frame_t * p_parser_data)
{
    return p_parser_data->helper.aux_sec_hdr_end_offset;
}
 
__STATIC_INLINE__ const uint8_t * nrf_802154_frame_header_ie_iterator_begin(
    const uint8_t * p_ie_header)
{
    return p_ie_header;
}
 
__STATIC_INLINE__ const uint8_t * nrf_802154_frame_ie_content_address_get(
    const uint8_t * p_ie_iterator)
{
    return p_ie_iterator + IE_DATA_OFFSET;
}
 
__STATIC_INLINE__ uint8_t nrf_802154_frame_ie_length_get(const uint8_t * p_ie_iterator)
{
    return p_ie_iterator[IE_LENGTH_OFFSET] & IE_LENGTH_MASK;
}
 
__STATIC_INLINE__ const uint8_t * nrf_802154_frame_ie_iterator_next(
    const uint8_t * p_ie_iterator)
{
    return nrf_802154_frame_ie_content_address_get(p_ie_iterator)
           + nrf_802154_frame_ie_length_get(p_ie_iterator);
}
 
__STATIC_INLINE__ uint8_t nrf_802154_frame_ie_id_get(const uint8_t * p_ie_iterator)
{
    return (p_ie_iterator[IE_ID_OFFSET_0] >> 7) | (p_ie_iterator[IE_ID_OFFSET_1] << 1);
}
 
__STATIC_INLINE__ bool nrf_802154_frame_ie_iterator_end(const uint8_t * p_ie_iterator,
                                                        const uint8_t * p_end_addr)
{
    uint8_t ie_id = nrf_802154_frame_ie_id_get(p_ie_iterator);
 
    return ((nrf_802154_frame_ie_length_get(p_ie_iterator) == 0) &&
            ((ie_id == IE_HT1) || (ie_id == IE_HT2)))
           || (p_ie_iterator >= p_end_addr);
}
 
__STATIC_INLINE__ uint32_t nrf_802154_frame_ie_vendor_oui_get(const uint8_t * p_ie_iterator)
{
    return little_24_to_host((uint8_t *)&p_ie_iterator[IE_DATA_OFFSET + IE_VENDOR_OUI_OFFSET]);
}
 
__STATIC_INLINE__ uint8_t nrf_802154_frame_ie_vendor_thread_subtype_get(
    const uint8_t * p_ie_iterator)
{
    return p_ie_iterator[IE_DATA_OFFSET + IE_VENDOR_THREAD_SUBTYPE_OFFSET];
}
 
__STATIC_INLINE__ const uint8_t * nrf_802154_frame_ie_vendor_thread_data_addr_get(
    const uint8_t * p_ie_iterator)
{
    return nrf_802154_frame_ie_content_address_get(p_ie_iterator) +
           IE_VENDOR_THREAD_DATA_OFFSET;
}
 
#endif /* NRF_802154_FRAME_DECLARE_ONLY */
 
#endif // NRF_802154_FRAME_H