/******************************************************************************* OpenAirInterface Copyright(c) 1999 - 2016 Eurecom OpenAirInterface is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. OpenAirInterface is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with OpenAirInterface.The full GNU General Public License is included in this distribution in the file called "COPYING". If not, see . Contact Information OpenAirInterface Admin: openair_admin@eurecom.fr OpenAirInterface Tech : openair_tech@eurecom.fr OpenAirInterface Dev : openair4g-devel@lists.eurecom.fr Address : Eurecom, Compus SophiaTech 450, route des chappes, 06451 Biot, France. *******************************************************************************/ /*! \file enb_agent_net_comm.h * \brief enb agent network interface abstraction * \autho Xenofon Foukas * \date 2016 * \version 0.1 */ #ifndef ENB_AGENT_NET_COMM_H_ #define ENB_AGENT_NET_COMM_H_ #include "enb_agent_defs.h" #include "tree.h" /*Channel related information used for Tx/Rx of protocol messages*/ typedef struct enb_agent_channel_s { RB_ENTRY(enb_agent_channel_s) entry; int channel_id; void *channel_info; /*Callbacks for channel message Tx and Rx*/ int (*msg_send)(void *data, int size, int priority, void *channel_info); int (*msg_recv)(void **data, int *size, int *priority, void *channel_info); void (*release)(struct enb_agent_channel_s *channel); } enb_agent_channel_t; typedef struct enb_agent_channel_instance_s{ RB_HEAD(enb_agent_channel_map, enb_agent_channel_s) enb_agent_head; } enb_agent_channel_instance_t; /*Send and receive messages using the channel registered for a specific agent*/ int enb_agent_msg_send(mid_t mod_id, agent_id_t agent_id, void *data, int size, int priority); int enb_agent_msg_recv(mid_t mod_id, agent_id_t agent_id, void **data, int *size, int *priority); /*Register a channel to an agent. Use ENB_AGENT_MAX to register the *same channel to all agents*/ int enb_agent_register_channel(mid_t mod_id, enb_agent_channel_t *channel, agent_id_t agent_id); /*Unregister the current channel of an agent. Use ENB_AGENT_MAX to unregister all channels*/ void enb_agent_unregister_channel(mid_t mod_id, agent_id_t agent_id); /*Create a new channel. Returns the id of the new channel or negative number otherwise*/ int enb_agent_create_channel(void *channel_info, int (*msg_send)(void *data, int size, int priority, void *channel_info), int (*msg_recv)(void **data, int *size, int *priority, void *channel_info), void (*release)(enb_agent_channel_t *channel)); /*Unregister a channel from all agents and destroy it. Returns 0 in case of success*/ int enb_agent_destroy_channel(int channel_id); /*Return an agent communication channel based on its id*/ enb_agent_channel_t * get_channel(int channel_id); /*Should be called before performing any channel operations*/ err_code_t enb_agent_init_channel_container(void); int enb_agent_compare_channel(struct enb_agent_channel_s *a, struct enb_agent_channel_s *b); /* RB_PROTOTYPE is for .h files */ RB_PROTOTYPE(enb_agent_channel_map, enb_agent_channel_s, entry, enb_agent_compare_channel); #endif /*ENB_AGENT_COMM_H_*/