144 lines
3.0 KiB
C
144 lines
3.0 KiB
C
/*
|
|
* Copyright (c) 2016 Intel Corporation.
|
|
*
|
|
* SPDX-License-Identifier: Apache-2.0
|
|
*/
|
|
|
|
/**
|
|
* @file
|
|
* @brief Public API for network link address
|
|
*/
|
|
|
|
#ifndef __NET_LINKADDR_H__
|
|
#define __NET_LINKADDR_H__
|
|
|
|
#include <zephyr/types.h>
|
|
#include <stdbool.h>
|
|
#include <errno.h>
|
|
|
|
#ifdef __cplusplus
|
|
extern "C" {
|
|
#endif
|
|
|
|
/**
|
|
* @brief Network link address library
|
|
* @defgroup net_linkaddr Network Link Address Library
|
|
* @ingroup networking
|
|
* @{
|
|
*/
|
|
|
|
#ifdef CONFIG_NET_L2_IEEE802154
|
|
#define NET_LINK_ADDR_MAX_LENGTH 8
|
|
#else
|
|
#define NET_LINK_ADDR_MAX_LENGTH 6
|
|
#endif
|
|
|
|
/**
|
|
* Type of the link address. This indicates the network technology that this
|
|
* address is used in. Note that in order to save space we store the value
|
|
* into a u8_t variable, so please do not introduce any values > 255 in
|
|
* this enum.
|
|
*/
|
|
enum net_link_type {
|
|
NET_LINK_UNKNOWN = 0,
|
|
NET_LINK_IEEE802154,
|
|
NET_LINK_BLUETOOTH,
|
|
NET_LINK_ETHERNET,
|
|
NET_LINK_DUMMY,
|
|
};
|
|
|
|
/**
|
|
* @brief Hardware link address structure
|
|
*
|
|
* Used to hold the link address information
|
|
*/
|
|
struct net_linkaddr {
|
|
/** The array of byte representing the address */
|
|
u8_t *addr;
|
|
|
|
/** Length of that address array */
|
|
u8_t len;
|
|
|
|
/** What kind of address is this for */
|
|
u8_t type;
|
|
};
|
|
|
|
/**
|
|
* @brief Hardware link address structure
|
|
*
|
|
* Used to hold the link address information. This variant is needed
|
|
* when we have to store the link layer address.
|
|
*
|
|
* Note that you cannot cast this to net_linkaddr as u8_t * is
|
|
* handled differently than u8_t addr[] and the fields are purposely
|
|
* in a different order.
|
|
*/
|
|
struct net_linkaddr_storage {
|
|
/** What kind of address is this for */
|
|
u8_t type;
|
|
|
|
/** The real length of the ll address. */
|
|
u8_t len;
|
|
|
|
/** The array of bytes representing the address */
|
|
u8_t addr[NET_LINK_ADDR_MAX_LENGTH];
|
|
};
|
|
|
|
/**
|
|
* @brief Compare two link layer addresses.
|
|
*
|
|
* @param lladdr1 Pointer to a link layer address
|
|
* @param lladdr2 Pointer to a link layer address
|
|
*
|
|
* @return True if the addresses are the same, false otherwise.
|
|
*/
|
|
static inline bool net_linkaddr_cmp(struct net_linkaddr *lladdr1,
|
|
struct net_linkaddr *lladdr2)
|
|
{
|
|
if (!lladdr1 || !lladdr2) {
|
|
return false;
|
|
}
|
|
|
|
if (lladdr1->len != lladdr2->len) {
|
|
return false;
|
|
}
|
|
|
|
return !memcmp(lladdr1->addr, lladdr2->addr, lladdr1->len);
|
|
}
|
|
|
|
/**
|
|
*
|
|
* @brief Set the member data of a link layer address storage structure.
|
|
*
|
|
* @param lladdr_store The link address storage structure to change.
|
|
* @param new_addr Array of bytes containing the link address.
|
|
* @param new_len Length of the link address array.
|
|
* This value should always be <= NET_LINK_ADDR_MAX_LENGTH.
|
|
*/
|
|
static inline int net_linkaddr_set(struct net_linkaddr_storage *lladdr_store,
|
|
u8_t *new_addr, u8_t new_len)
|
|
{
|
|
if (!lladdr_store || !new_addr) {
|
|
return -EINVAL;
|
|
}
|
|
|
|
if (new_len > NET_LINK_ADDR_MAX_LENGTH) {
|
|
return -EMSGSIZE;
|
|
}
|
|
|
|
lladdr_store->len = new_len;
|
|
memcpy(lladdr_store->addr, new_addr, new_len);
|
|
|
|
return 0;
|
|
}
|
|
|
|
/**
|
|
* @}
|
|
*/
|
|
|
|
#ifdef __cplusplus
|
|
}
|
|
#endif
|
|
|
|
#endif /* __NET_LINKADDR_H__ */
|