ieee802154.h

Go to the documentation of this file.

/*
 * Copyright (c) 2016 Intel Corporation.
 *
 * SPDX-License-Identifier: Apache-2.0
 */
 
#ifndef ZEPHYR_INCLUDE_NET_IEEE802154_H_
#define ZEPHYR_INCLUDE_NET_IEEE802154_H_
 
#include <limits.h>
#include <zephyr/net/net_l2.h>
#include <zephyr/net/net_mgmt.h>
#include <zephyr/crypto/cipher.h>
 
#ifdef __cplusplus
extern "C" {
#endif
 
/* See IEEE 802.15.4-2006, sections 5.5.3.2, 6.4.1 and 7.2.1.9 */
#define IEEE802154_MAX_PHY_PACKET_SIZE  127
#define IEEE802154_FCS_LENGTH           2
#define IEEE802154_MTU                  (IEEE802154_MAX_PHY_PACKET_SIZE - IEEE802154_FCS_LENGTH)
/* TODO: Support flexible MTU for IEEE 802.15.4-2015 */
 
#define IEEE802154_SHORT_ADDR_LENGTH    2
#define IEEE802154_EXT_ADDR_LENGTH      8
#define IEEE802154_MAX_ADDR_LENGTH      IEEE802154_EXT_ADDR_LENGTH
 
#define IEEE802154_NO_CHANNEL           USHRT_MAX
 
/* See IEEE 802.15.4-2006, section 7.2.1.4 */
#define IEEE802154_BROADCAST_ADDRESS 0xFFFF
#define IEEE802154_BROADCAST_PAN_ID  0xFFFF
 
struct ieee802154_security_ctx {
        uint32_t frame_counter;
        struct cipher_ctx enc;
        struct cipher_ctx dec;
        uint8_t key[16];
        uint8_t key_len;
        uint8_t level   : 3;
        uint8_t key_mode        : 2;
        uint8_t _unused : 3;
};
 
/* This not meant to be used by any code but 802.15.4 L2 stack */
struct ieee802154_context {
        enum net_l2_flags flags;
        uint16_t pan_id;
        uint16_t channel;
        struct k_sem ack_lock;
        uint16_t short_addr;
        uint8_t ext_addr[IEEE802154_MAX_ADDR_LENGTH];
#ifdef CONFIG_NET_L2_IEEE802154_MGMT
        struct ieee802154_req_params *scan_ctx;
        union {
                struct k_sem res_lock;
                struct k_sem req_lock;
        };
        union {
                uint8_t ext_addr[IEEE802154_MAX_ADDR_LENGTH];
                uint16_t short_addr;
        } coord;
        uint8_t coord_addr_len;
#endif
#ifdef CONFIG_NET_L2_IEEE802154_SECURITY
        struct ieee802154_security_ctx sec_ctx;
#endif
        int16_t tx_power;
        uint8_t sequence;
        uint8_t ack_seq;
        uint8_t ack_received    : 1;
        uint8_t ack_requested   : 1;
        uint8_t associated              : 1;
        uint8_t _unused         : 5;
};
 
#define IEEE802154_L2_CTX_TYPE  struct ieee802154_context
 
#ifdef __cplusplus
}
#endif
 
#endif /* ZEPHYR_INCLUDE_NET_IEEE802154_H_ */