zephyr/subsys/net/l2/ieee802154/ieee802154_security.h

63 lines
2.1 KiB
C

/*
* Copyright (c) 2017 Intel Corporation.
*
* SPDX-License-Identifier: Apache-2.0
*/
/**
* @file
* @brief 802.15.4 6LoWPAN authentication and encryption
*
* This is not to be included by the application.
*/
#ifdef CONFIG_NET_L2_IEEE802154_SECURITY
#include <zephyr/net/ieee802154.h>
int ieee802154_security_setup_session(struct ieee802154_security_ctx *sec_ctx, uint8_t level,
uint8_t key_mode, uint8_t *key, uint8_t key_len);
void ieee802154_security_teardown_session(struct ieee802154_security_ctx *sec_ctx);
/**
* @brief Decrypt an authenticated payload.
*
* @param sec_ctx Pointer to an IEEE 802.15.4 security context.
* @param frame Pointer to the frame data in original (little endian) byte order.
* @param ll_hdr_len Length of the MHR.
* @param payload_len Length of the MAC payload.
* @param authtag_len Length of the authentication tag.
* @param src_ext_addr Pointer to the extended source address of the frame (in little endian byte
* order).
* @param frame_counter Frame counter in CPU byte order.
*/
bool ieee802154_decrypt_auth(struct ieee802154_security_ctx *sec_ctx, uint8_t *frame,
uint8_t ll_hdr_len, uint8_t payload_len, uint8_t authtag_len,
uint8_t *src_ext_addr, uint32_t frame_counter);
/**
* @brief Encrypt an authenticated payload.
*
* @param sec_ctx Pointer to an IEEE 802.15.4 security context.
* @param frame Pointer to the frame data in original (little endian) byte order.
* @param ll_hdr_len Length of the MHR.
* @param payload_len Length of the MAC payload.
* @param authtag_len Length of the authentication tag.
* @param src_ext_addr Pointer to the extended source address of the frame (in little endian byte
* order).
*/
bool ieee802154_encrypt_auth(struct ieee802154_security_ctx *sec_ctx, uint8_t *frame,
uint8_t ll_hdr_len, uint8_t payload_len,
uint8_t authtag_len, uint8_t *src_ext_addr);
int ieee802154_security_init(struct ieee802154_security_ctx *sec_ctx);
#else
#define ieee802154_decrypt_auth(...) true
#define ieee802154_encrypt_auth(...) true
#define ieee802154_security_init(...) 0
#endif /* CONFIG_NET_L2_IEEE802154_SECURITY */