enb_agent_mac_defs.h 2.98 KB
Newer Older
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41
/*******************************************************************************
    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 <http://www.gnu.org/licenses/>.

  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_mac_defs.h
 * \brief enb agent - mac interface primitives
 * \author Xenofon Foukas
 * \date 2016
 * \version 0.1
 * \mail x.foukas@sms.ed.ac.uk
 */

#ifndef __ENB_AGENT_MAC_PRIMITIVES_H__
#define __ENB_AGENT_MAC_PRIMITIVES_H__

#include "enb_agent_defs.h"
42 43
#include "progran.pb-c.h"
#include "header.pb-c.h"
44

45 46
#define RINGBUFFER_SIZE 100

47 48
/* ENB AGENT-MAC Interface */
typedef struct {
49
  //msg_context_t *agent_ctxt;
50 51

  /// Inform the controller about the scheduling requests received during the subframe
52
  void (*enb_agent_send_sr_info)(mid_t mod_id);
53 54
  
  /// Inform the controller about the current UL/DL subframe
55
  void (*enb_agent_send_sf_trigger)(mid_t mod_id);
56

57 58 59
  /// Send to the controller all the mac stat updates that occured during this subframe
  /// based on the stats request configuration
  void (*enb_agent_send_update_mac_stats)(mid_t mod_id);
60

61 62 63 64
  /// Provide to the scheduler a pending dl_mac_config message
  void (*enb_agent_get_pending_dl_mac_config)(mid_t mod_id,
					      Protocol__ProgranMessage **msg);
  
65 66 67 68
  /// Run the UE DL scheduler and fill the Protocol__ProgranMessage. Assumes that
  /// dl_info is already initialized as prp_dl_mac_config and fills the
  /// prp_dl_data part of it
  void (*enb_agent_schedule_ue_spec)(mid_t mod_id, uint32_t frame, uint32_t subframe,
69
				     int *mbsfn_flag, Protocol__ProgranMessage **dl_info);
70

71 72 73 74 75 76

  /// Notify the controller for a state change of a particular UE, by sending the proper
  /// UE state change message (ACTIVATION, DEACTIVATION, HANDOVER)
  void (*enb_agent_notify_ue_state_change)(mid_t mod_id, uint32_t rnti,
					   uint32_t state_change);
  
77 78 79 80 81
  /*TODO: Fill in with the rest of the MAC layer technology specific callbacks (UL/DL scheduling, RACH info etc)*/

} AGENT_MAC_xface;

#endif