239 lines
9.4 KiB
C
239 lines
9.4 KiB
C
/*
|
|
* Copyright (c) 2008, Swedish Institute of Computer Science
|
|
* All rights reserved.
|
|
*
|
|
* Additional fixes for AVR contributed by:
|
|
* Colin O'Flynn coflynn@newae.com
|
|
* Eric Gnoske egnoske@gmail.com
|
|
* Blake Leverett bleverett@gmail.com
|
|
* Mike Vidales mavida404@gmail.com
|
|
* Kevin Brown kbrown3@uccs.edu
|
|
* Nate Bohlmann nate@elfwerks.com
|
|
*
|
|
* Additional fixes for MSP430 contributed by:
|
|
* Joakim Eriksson
|
|
* Niclas Finne
|
|
* Nicolas Tsiftes
|
|
*
|
|
* All rights reserved.
|
|
*
|
|
* Redistribution and use in source and binary forms, with or without
|
|
* modification, are permitted provided that the following conditions are met:
|
|
*
|
|
* * Redistributions of source code must retain the above copyright
|
|
* notice, this list of conditions and the following disclaimer.
|
|
* * 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.
|
|
* * Neither the name of the copyright holders nor the names of
|
|
* 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 OWNER 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.
|
|
*/
|
|
|
|
/**
|
|
* \addtogroup link-layer
|
|
* @{
|
|
*/
|
|
|
|
/**
|
|
* \defgroup frame802154 802.15.4 frame creation and parsing
|
|
* @{
|
|
*/
|
|
/**
|
|
* \file
|
|
* \brief 802.15.4 frame creation and parsing functions
|
|
*
|
|
* This file converts to and from a structure to a packed 802.15.4
|
|
* frame.
|
|
*
|
|
*/
|
|
|
|
/* Includes */
|
|
#ifndef FRAME_802154_H
|
|
#define FRAME_802154_H
|
|
|
|
#include "contiki.h"
|
|
#include "net/linkaddr.h"
|
|
|
|
#ifdef IEEE802154_CONF_PANID
|
|
#define IEEE802154_PANID IEEE802154_CONF_PANID
|
|
#else /* IEEE802154_CONF_PANID */
|
|
#define IEEE802154_PANID 0xABCD
|
|
#endif /* IEEE802154_CONF_PANID */
|
|
|
|
#ifdef FRAME802154_CONF_VERSION
|
|
#define FRAME802154_VERSION FRAME802154_CONF_VERSION
|
|
#else /* FRAME802154_CONF_VERSION */
|
|
/* Use frame v2 if TSCH is used, otherwise stick to v1 (more
|
|
frame-filtering-friendly on some platforms) */
|
|
#if MAC_CONF_WITH_TSCH
|
|
#define FRAME802154_VERSION FRAME802154_IEEE802154_2015
|
|
#else /* MAC_CONF_WITH_TSCH */
|
|
#define FRAME802154_VERSION FRAME802154_IEEE802154_2006
|
|
#endif /* MAC_CONF_WITH_TSCH */
|
|
#endif /* FRAME802154_CONF_VERSION */
|
|
|
|
#ifdef FRAME802154_CONF_SUPPR_SEQNO
|
|
#define FRAME802154_SUPPR_SEQNO FRAME802154_CONF_SUPPR_SEQNO
|
|
#else /* FRAME802154_CONF_SUPPR_SEQNO */
|
|
#define FRAME802154_SUPPR_SEQNO 0
|
|
#endif /* FRAME802154_CONF_SUPPR_SEQNO */
|
|
|
|
/* Macros & Defines */
|
|
|
|
/** \brief These are some definitions of values used in the FCF. See the 802.15.4 spec for details.
|
|
* \name FCF element values definitions
|
|
* @{
|
|
*/
|
|
#define FRAME802154_BEACONFRAME (0x00)
|
|
#define FRAME802154_DATAFRAME (0x01)
|
|
#define FRAME802154_ACKFRAME (0x02)
|
|
#define FRAME802154_CMDFRAME (0x03)
|
|
|
|
#define FRAME802154_BEACONREQ (0x07)
|
|
|
|
#define FRAME802154_IEEERESERVED (0x00)
|
|
#define FRAME802154_NOADDR (0x00) /**< Only valid for ACK or Beacon frames. */
|
|
#define FRAME802154_SHORTADDRMODE (0x02)
|
|
#define FRAME802154_LONGADDRMODE (0x03)
|
|
|
|
#define FRAME802154_NOBEACONS (0x0F)
|
|
|
|
#define FRAME802154_BROADCASTADDR (0xFFFF)
|
|
#define FRAME802154_BROADCASTPANDID (0xFFFF)
|
|
|
|
#define FRAME802154_IEEE802154_2003 (0x00)
|
|
#define FRAME802154_IEEE802154_2006 (0x01)
|
|
#define FRAME802154_IEEE802154_2015 (0x02)
|
|
|
|
#define FRAME802154_SECURITY_LEVEL_NONE (0)
|
|
#define FRAME802154_SECURITY_LEVEL_MIC_32 (1)
|
|
#define FRAME802154_SECURITY_LEVEL_MIC_64 (2)
|
|
#define FRAME802154_SECURITY_LEVEL_MIC_128 (3)
|
|
#define FRAME802154_SECURITY_LEVEL_ENC (4)
|
|
#define FRAME802154_SECURITY_LEVEL_ENC_MIC_32 (5)
|
|
#define FRAME802154_SECURITY_LEVEL_ENC_MIC_64 (6)
|
|
#define FRAME802154_SECURITY_LEVEL_ENC_MIC_128 (7)
|
|
|
|
#define FRAME802154_IMPLICIT_KEY (0)
|
|
#define FRAME802154_1_BYTE_KEY_ID_MODE (1)
|
|
#define FRAME802154_5_BYTE_KEY_ID_MODE (2)
|
|
#define FRAME802154_9_BYTE_KEY_ID_MODE (3)
|
|
|
|
/**
|
|
* @brief The IEEE 802.15.4 frame has a number of constant/fixed fields that
|
|
* can be counted to make frame construction and max payload
|
|
* calculations easier.
|
|
*
|
|
* These include:
|
|
* 1. FCF - 2 bytes - Fixed
|
|
* 2. Sequence number - 1 byte - Fixed
|
|
* 3. Addressing fields - 4 - 20 bytes - Variable
|
|
* 4. Aux security header - 0 - 14 bytes - Variable
|
|
* 5. CRC - 2 bytes - Fixed
|
|
*/
|
|
|
|
/**
|
|
* \brief Defines the bitfields of the frame control field (FCF).
|
|
*/
|
|
typedef struct {
|
|
uint8_t frame_type; /**< 3 bit. Frame type field, see 802.15.4 */
|
|
uint8_t security_enabled; /**< 1 bit. True if security is used in this frame */
|
|
uint8_t frame_pending; /**< 1 bit. True if sender has more data to send */
|
|
uint8_t ack_required; /**< 1 bit. Is an ack frame required? */
|
|
uint8_t panid_compression; /**< 1 bit. Is this a compressed header? */
|
|
/* uint8_t reserved; */ /**< 1 bit. Unused bit */
|
|
uint8_t sequence_number_suppression; /**< 1 bit. Does the header omit sequence number?, see 802.15.4e */
|
|
uint8_t ie_list_present; /**< 1 bit. Does the header contain Information Elements?, see 802.15.4e */
|
|
uint8_t dest_addr_mode; /**< 2 bit. Destination address mode, see 802.15.4 */
|
|
uint8_t frame_version; /**< 2 bit. 802.15.4 frame version */
|
|
uint8_t src_addr_mode; /**< 2 bit. Source address mode, see 802.15.4 */
|
|
} frame802154_fcf_t;
|
|
|
|
/** \brief 802.15.4 security control bitfield. See section 7.6.2.2.1 in 802.15.4 specification */
|
|
typedef struct {
|
|
uint8_t security_level; /**< 3 bit. security level */
|
|
uint8_t key_id_mode; /**< 2 bit. Key identifier mode */
|
|
uint8_t frame_counter_suppression; /**< 1 bit. Frame counter suppression */
|
|
uint8_t frame_counter_size; /**< 1 bit. Frame counter size (0: 4 bytes, 1: 5 bytes) */
|
|
uint8_t reserved; /**< 3 bit. Reserved bits */
|
|
} frame802154_scf_t;
|
|
|
|
typedef union {
|
|
uint32_t u32;
|
|
uint16_t u16[2];
|
|
uint8_t u8[4];
|
|
} frame802154_frame_counter_t;
|
|
|
|
typedef union {
|
|
uint16_t u16[4];
|
|
uint8_t u8[8];
|
|
} frame802154_key_source_t;
|
|
|
|
/** \brief 802.15.4 Aux security header */
|
|
typedef struct {
|
|
frame802154_scf_t security_control; /**< Security control bitfield */
|
|
frame802154_frame_counter_t frame_counter; /**< Frame counter, used for security */
|
|
frame802154_key_source_t key_source; /**< Key Source subfield */
|
|
uint8_t key_index; /**< Key Index subfield */
|
|
} frame802154_aux_hdr_t;
|
|
|
|
/** \brief Parameters used by the frame802154_create() function. These
|
|
* parameters are used in the 802.15.4 frame header. See the 802.15.4
|
|
* specification for details.
|
|
*/
|
|
typedef struct {
|
|
/* The fields dest_addr and src_addr must come first to ensure they are aligned to the
|
|
* CPU word size. Needed as they are accessed directly as linkaddr_t*. Note we cannot use
|
|
* the type linkaddr_t directly here, as we always need 8 bytes, not LINKADDR_SIZE bytes. */
|
|
uint8_t dest_addr[8]; /**< Destination address */
|
|
uint8_t src_addr[8]; /**< Source address */
|
|
frame802154_fcf_t fcf; /**< Frame control field */
|
|
uint8_t seq; /**< Sequence number */
|
|
uint16_t dest_pid; /**< Destination PAN ID */
|
|
uint16_t src_pid; /**< Source PAN ID */
|
|
frame802154_aux_hdr_t aux_hdr; /**< Aux security header */
|
|
uint8_t *payload; /**< Pointer to 802.15.4 payload */
|
|
int payload_len; /**< Length of payload field */
|
|
} frame802154_t;
|
|
|
|
/* Prototypes */
|
|
|
|
int frame802154_hdrlen(frame802154_t *p);
|
|
void frame802154_create_fcf(frame802154_fcf_t *fcf, uint8_t *buf);
|
|
int frame802154_create(frame802154_t *p, uint8_t *buf);
|
|
int frame802154_parse(uint8_t *data, int length, frame802154_t *pf);
|
|
void frame802154_parse_fcf(uint8_t *data, frame802154_fcf_t *pfcf);
|
|
|
|
/* Get current PAN ID */
|
|
uint16_t frame802154_get_pan_id(void);
|
|
/* Set current PAN ID */
|
|
void frame802154_set_pan_id(uint16_t pan_id);
|
|
/* Tells whether a given Frame Control Field indicates a frame with
|
|
* source PANID and/or destination PANID */
|
|
void frame802154_has_panid(frame802154_fcf_t *fcf, int *has_src_pan_id, int *has_dest_pan_id);
|
|
/* Check if the destination PAN ID, if any, matches ours */
|
|
int frame802154_check_dest_panid(frame802154_t *frame);
|
|
/* Check is the address is a broadcast address, whatever its size */
|
|
int frame802154_is_broadcast_addr(uint8_t mode, uint8_t *addr);
|
|
/* Check and extract source and destination linkaddr from frame */
|
|
int frame802154_extract_linkaddr(frame802154_t *frame, linkaddr_t *source_address, linkaddr_t *dest_address);
|
|
|
|
/** @} */
|
|
#endif /* FRAME_802154_H */
|
|
/** @} */
|
|
/** @} */
|