net_mgmt.h

Go to the documentation of this file.

/*
 * Copyright (c) 2016 Intel Corporation.
 *
 * SPDX-License-Identifier: Apache-2.0
 */
 
#ifndef ZEPHYR_INCLUDE_NET_NET_MGMT_H_
#define ZEPHYR_INCLUDE_NET_NET_MGMT_H_
 
#include <zephyr/sys/__assert.h>
#include <zephyr/net/net_core.h>
#include <zephyr/net/net_event.h>
#include <zephyr/sys/iterable_sections.h>
 
#ifdef __cplusplus
extern "C" {
#endif
 
struct net_if;
 
#define NET_MGMT_EVENT_MASK             0x80000000
#define NET_MGMT_ON_IFACE_MASK          0x40000000
#define NET_MGMT_LAYER_MASK             0x30000000
#define NET_MGMT_SYNC_EVENT_MASK        0x08000000
#define NET_MGMT_LAYER_CODE_MASK        0x07FF0000
#define NET_MGMT_COMMAND_MASK           0x0000FFFF
 
#define NET_MGMT_EVENT_BIT              BIT(31)
#define NET_MGMT_IFACE_BIT              BIT(30)
#define NET_MGMT_SYNC_EVENT_BIT         BIT(27)
 
#define NET_MGMT_LAYER(_layer)          (_layer << 28)
#define NET_MGMT_LAYER_CODE(_code)      (_code << 16)
 
#define NET_MGMT_EVENT(mgmt_request)            \
        (mgmt_request & NET_MGMT_EVENT_MASK)
 
#define NET_MGMT_ON_IFACE(mgmt_request)         \
        (mgmt_request & NET_MGMT_ON_IFACE_MASK)
 
#define NET_MGMT_EVENT_SYNCHRONOUS(mgmt_request)        \
        (mgmt_request & NET_MGMT_SYNC_EVENT_MASK)
 
#define NET_MGMT_GET_LAYER(mgmt_request)        \
        ((mgmt_request & NET_MGMT_LAYER_MASK) >> 28)
 
#define NET_MGMT_GET_LAYER_CODE(mgmt_request)   \
        ((mgmt_request & NET_MGMT_LAYER_CODE_MASK) >> 16)
 
#define NET_MGMT_GET_COMMAND(mgmt_request)      \
        (mgmt_request & NET_MGMT_COMMAND_MASK)
 
 
/* Useful generic definitions */
#define NET_MGMT_LAYER_L2               1
#define NET_MGMT_LAYER_L3               2
#define NET_MGMT_LAYER_L4               3
 
enum net_mgmt_layer_code {
        NET_MGMT_LAYER_CODE_UNKNOWN    = 0x00, 
        NET_MGMT_LAYER_CODE_IFACE      = 0x01, 
        NET_MGMT_LAYER_CODE_CONN       = 0x02, 
        NET_MGMT_LAYER_CODE_IPV4       = 0x03, 
        NET_MGMT_LAYER_CODE_IPV6       = 0x04, 
        NET_MGMT_LAYER_CODE_L4         = 0x05, 
        NET_MGMT_LAYER_CODE_COAP       = 0x06, 
        NET_MGMT_LAYER_CODE_STATS      = 0x07, 
        NET_MGMT_LAYER_CODE_HOSTAP     = 0x08, 
        NET_MGMT_LAYER_CODE_ETHERNET   = 0x09, 
        NET_MGMT_LAYER_CODE_IEEE802514 = 0x0A, 
        NET_MGMT_LAYER_CODE_PPP        = 0x0B, 
        NET_MGMT_LAYER_CODE_VIRTUAL    = 0x0C, 
        NET_MGMT_LAYER_CODE_WIFI       = 0x0D, 
        /* Out of tree code can use the following userX layer codes */
        NET_MGMT_LAYER_CODE_USER3      = 0x7C, 
        NET_MGMT_LAYER_CODE_USER2      = 0x7D, 
        NET_MGMT_LAYER_CODE_USER1      = 0x7E, 
        /* Reserved layer code for future use */
        NET_MGMT_LAYER_CODE_RESERVED   = 0x7F  
};
 
typedef int (*net_mgmt_request_handler_t)(uint32_t mgmt_request,
                                          struct net_if *iface,
                                          void *data, size_t len);
 
#define net_mgmt(_mgmt_request, _iface, _data, _len)                    \
        net_mgmt_##_mgmt_request(_mgmt_request, _iface, _data, _len)
 
#define NET_MGMT_DEFINE_REQUEST_HANDLER(_mgmt_request)                  \
        extern int net_mgmt_##_mgmt_request(uint32_t mgmt_request,      \
                                            struct net_if *iface,       \
                                            void *data, size_t len)
 
#define NET_MGMT_REGISTER_REQUEST_HANDLER(_mgmt_request, _func) \
        FUNC_ALIAS(_func, net_mgmt_##_mgmt_request, int)
 
struct net_mgmt_event_callback;
 
typedef void (*net_mgmt_event_handler_t)(struct net_mgmt_event_callback *cb,
                                         uint32_t mgmt_event,
                                         struct net_if *iface);
 
struct net_mgmt_event_callback {
        sys_snode_t node;
 
        union {
                net_mgmt_event_handler_t handler;
                struct k_sem *sync_call;
        };
 
#ifdef CONFIG_NET_MGMT_EVENT_INFO
        const void *info;
        size_t info_length;
#endif
 
        union {
                uint32_t event_mask;
                uint32_t raised_event;
        };
};
 
typedef void (*net_mgmt_event_static_handler_t)(uint32_t mgmt_event,
                                                struct net_if *iface,
                                                void *info, size_t info_length,
                                                void *user_data);
 
/* Structure for event handler registered at compile time */
struct net_mgmt_event_static_handler {
        uint32_t event_mask;
        net_mgmt_event_static_handler_t handler;
        void *user_data;
};
 
#define NET_MGMT_REGISTER_EVENT_HANDLER(_name, _event_mask, _func, _user_data)  \
        const STRUCT_SECTION_ITERABLE(net_mgmt_event_static_handler, _name) = { \
                .event_mask = _event_mask,                                      \
                .handler = _func,                                               \
                .user_data = (void *)_user_data,                                \
        }
 
#ifdef CONFIG_NET_MGMT_EVENT
static inline
void net_mgmt_init_event_callback(struct net_mgmt_event_callback *cb,
                                  net_mgmt_event_handler_t handler,
                                  uint32_t mgmt_event_mask)
{
        __ASSERT(cb, "Callback pointer should not be NULL");
        __ASSERT(handler, "Handler pointer should not be NULL");
 
        cb->handler = handler;
        cb->event_mask = mgmt_event_mask;
};
#else
#define net_mgmt_init_event_callback(...)
#endif
 
#ifdef CONFIG_NET_MGMT_EVENT
void net_mgmt_add_event_callback(struct net_mgmt_event_callback *cb);
#else
#define net_mgmt_add_event_callback(...)
#endif
 
#ifdef CONFIG_NET_MGMT_EVENT
void net_mgmt_del_event_callback(struct net_mgmt_event_callback *cb);
#else
#define net_mgmt_del_event_callback(...)
#endif
 
#if defined(CONFIG_NET_MGMT_EVENT)
void net_mgmt_event_notify_with_info(uint32_t mgmt_event, struct net_if *iface,
                                     const void *info, size_t length);
#else
#define net_mgmt_event_notify_with_info(...)
#endif
 
#if defined(CONFIG_NET_MGMT_EVENT)
static inline void net_mgmt_event_notify(uint32_t mgmt_event,
                                         struct net_if *iface)
{
        net_mgmt_event_notify_with_info(mgmt_event, iface, NULL, 0);
}
#else
#define net_mgmt_event_notify(...)
#endif
 
#ifdef CONFIG_NET_MGMT_EVENT
int net_mgmt_event_wait(uint32_t mgmt_event_mask,
                        uint32_t *raised_event,
                        struct net_if **iface,
                        const void **info,
                        size_t *info_length,
                        k_timeout_t timeout);
#else
static inline int net_mgmt_event_wait(uint32_t mgmt_event_mask,
                                      uint32_t *raised_event,
                                      struct net_if **iface,
                                      const void **info,
                                      size_t *info_length,
                                      k_timeout_t timeout)
{
        ARG_UNUSED(mgmt_event_mask);
        ARG_UNUSED(raised_event);
        ARG_UNUSED(iface);
        ARG_UNUSED(info);
        ARG_UNUSED(info_length);
        ARG_UNUSED(timeout);
        return 0;
}
#endif
 
#ifdef CONFIG_NET_MGMT_EVENT
int net_mgmt_event_wait_on_iface(struct net_if *iface,
                                 uint32_t mgmt_event_mask,
                                 uint32_t *raised_event,
                                 const void **info,
                                 size_t *info_length,
                                 k_timeout_t timeout);
#else
static inline int net_mgmt_event_wait_on_iface(struct net_if *iface,
                                               uint32_t mgmt_event_mask,
                                               uint32_t *raised_event,
                                               const void **info,
                                               size_t *info_length,
                                               k_timeout_t timeout)
{
        ARG_UNUSED(iface);
        ARG_UNUSED(mgmt_event_mask);
        ARG_UNUSED(raised_event);
        ARG_UNUSED(info);
        ARG_UNUSED(info_length);
        ARG_UNUSED(timeout);
        return 0;
}
#endif
 
#ifdef CONFIG_NET_MGMT_EVENT
void net_mgmt_event_init(void);
#else
#define net_mgmt_event_init(...)
#endif /* CONFIG_NET_MGMT_EVENT */
 
#ifdef __cplusplus
}
#endif
 
#endif /* ZEPHYR_INCLUDE_NET_NET_MGMT_H_ */