src/lte/model/lte-enb-phy.h
author mmiozzo
Tue, 29 Mar 2011 17:20:57 +0200
changeset 7910 d7083e401e59
parent 7887 78911c978517
child 7914 301cd877dee5
permissions -rw-r--r--
PUSCH based UL-CQI generation at eNB PHY side
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
6705
422c67049471 LTE module form GSoC project
Giuseppe Piro <g.piro@poliba.it>
parents:
diff changeset
     1
/* -*-  Mode: C++; c-file-style: "gnu"; indent-tabs-mode:nil; -*- */
422c67049471 LTE module form GSoC project
Giuseppe Piro <g.piro@poliba.it>
parents:
diff changeset
     2
/*
422c67049471 LTE module form GSoC project
Giuseppe Piro <g.piro@poliba.it>
parents:
diff changeset
     3
 * Copyright (c) 2010 TELEMATICS LAB, DEE - Politecnico di Bari
422c67049471 LTE module form GSoC project
Giuseppe Piro <g.piro@poliba.it>
parents:
diff changeset
     4
 *
422c67049471 LTE module form GSoC project
Giuseppe Piro <g.piro@poliba.it>
parents:
diff changeset
     5
 * This program is free software; you can redistribute it and/or modify
422c67049471 LTE module form GSoC project
Giuseppe Piro <g.piro@poliba.it>
parents:
diff changeset
     6
 * it under the terms of the GNU General Public License version 2 as
422c67049471 LTE module form GSoC project
Giuseppe Piro <g.piro@poliba.it>
parents:
diff changeset
     7
 * published by the Free Software Foundation;
422c67049471 LTE module form GSoC project
Giuseppe Piro <g.piro@poliba.it>
parents:
diff changeset
     8
 *
422c67049471 LTE module form GSoC project
Giuseppe Piro <g.piro@poliba.it>
parents:
diff changeset
     9
 * This program is distributed in the hope that it will be useful,
422c67049471 LTE module form GSoC project
Giuseppe Piro <g.piro@poliba.it>
parents:
diff changeset
    10
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
422c67049471 LTE module form GSoC project
Giuseppe Piro <g.piro@poliba.it>
parents:
diff changeset
    11
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
422c67049471 LTE module form GSoC project
Giuseppe Piro <g.piro@poliba.it>
parents:
diff changeset
    12
 * GNU General Public License for more details.
422c67049471 LTE module form GSoC project
Giuseppe Piro <g.piro@poliba.it>
parents:
diff changeset
    13
 *
422c67049471 LTE module form GSoC project
Giuseppe Piro <g.piro@poliba.it>
parents:
diff changeset
    14
 * You should have received a copy of the GNU General Public License
422c67049471 LTE module form GSoC project
Giuseppe Piro <g.piro@poliba.it>
parents:
diff changeset
    15
 * along with this program; if not, write to the Free Software
422c67049471 LTE module form GSoC project
Giuseppe Piro <g.piro@poliba.it>
parents:
diff changeset
    16
 * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
422c67049471 LTE module form GSoC project
Giuseppe Piro <g.piro@poliba.it>
parents:
diff changeset
    17
 *
422c67049471 LTE module form GSoC project
Giuseppe Piro <g.piro@poliba.it>
parents:
diff changeset
    18
 * Author: Giuseppe Piro  <g.piro@poliba.it>
7886
b65c16d4da83 LENA project first public release
CTTC
parents: 6852
diff changeset
    19
 * Author: Marco Miozzo <marco.miozzo@cttc.es>
6705
422c67049471 LTE module form GSoC project
Giuseppe Piro <g.piro@poliba.it>
parents:
diff changeset
    20
 */
422c67049471 LTE module form GSoC project
Giuseppe Piro <g.piro@poliba.it>
parents:
diff changeset
    21
422c67049471 LTE module form GSoC project
Giuseppe Piro <g.piro@poliba.it>
parents:
diff changeset
    22
#ifndef ENB_LTE_PHY_H
422c67049471 LTE module form GSoC project
Giuseppe Piro <g.piro@poliba.it>
parents:
diff changeset
    23
#define ENB_LTE_PHY_H
422c67049471 LTE module form GSoC project
Giuseppe Piro <g.piro@poliba.it>
parents:
diff changeset
    24
422c67049471 LTE module form GSoC project
Giuseppe Piro <g.piro@poliba.it>
parents:
diff changeset
    25
422c67049471 LTE module form GSoC project
Giuseppe Piro <g.piro@poliba.it>
parents:
diff changeset
    26
#include "lte-phy.h"
7886
b65c16d4da83 LENA project first public release
CTTC
parents: 6852
diff changeset
    27
#include <ns3/lte-enb-phy-sap.h>
b65c16d4da83 LENA project first public release
CTTC
parents: 6852
diff changeset
    28
#include <map>
7887
78911c978517 renamed several LTE files and classes
CTTC
parents: 7886
diff changeset
    29
#include <ns3/lte-ue-phy.h>
6705
422c67049471 LTE module form GSoC project
Giuseppe Piro <g.piro@poliba.it>
parents:
diff changeset
    30
422c67049471 LTE module form GSoC project
Giuseppe Piro <g.piro@poliba.it>
parents:
diff changeset
    31
namespace ns3 {
422c67049471 LTE module form GSoC project
Giuseppe Piro <g.piro@poliba.it>
parents:
diff changeset
    32
422c67049471 LTE module form GSoC project
Giuseppe Piro <g.piro@poliba.it>
parents:
diff changeset
    33
class PacketBurst;
422c67049471 LTE module form GSoC project
Giuseppe Piro <g.piro@poliba.it>
parents:
diff changeset
    34
class LteNetDevice;
422c67049471 LTE module form GSoC project
Giuseppe Piro <g.piro@poliba.it>
parents:
diff changeset
    35
422c67049471 LTE module form GSoC project
Giuseppe Piro <g.piro@poliba.it>
parents:
diff changeset
    36
/**
7887
78911c978517 renamed several LTE files and classes
CTTC
parents: 7886
diff changeset
    37
 * LteEnbPhy models the physical layer for the eNodeB
6705
422c67049471 LTE module form GSoC project
Giuseppe Piro <g.piro@poliba.it>
parents:
diff changeset
    38
 */
7887
78911c978517 renamed several LTE files and classes
CTTC
parents: 7886
diff changeset
    39
class LteEnbPhy : public LtePhy
6705
422c67049471 LTE module form GSoC project
Giuseppe Piro <g.piro@poliba.it>
parents:
diff changeset
    40
{
422c67049471 LTE module form GSoC project
Giuseppe Piro <g.piro@poliba.it>
parents:
diff changeset
    41
7886
b65c16d4da83 LENA project first public release
CTTC
parents: 6852
diff changeset
    42
  friend class EnbMemberLteEnbPhySapProvider;
b65c16d4da83 LENA project first public release
CTTC
parents: 6852
diff changeset
    43
6705
422c67049471 LTE module form GSoC project
Giuseppe Piro <g.piro@poliba.it>
parents:
diff changeset
    44
public:
7887
78911c978517 renamed several LTE files and classes
CTTC
parents: 7886
diff changeset
    45
  LteEnbPhy ();
6705
422c67049471 LTE module form GSoC project
Giuseppe Piro <g.piro@poliba.it>
parents:
diff changeset
    46
422c67049471 LTE module form GSoC project
Giuseppe Piro <g.piro@poliba.it>
parents:
diff changeset
    47
  /**
422c67049471 LTE module form GSoC project
Giuseppe Piro <g.piro@poliba.it>
parents:
diff changeset
    48
   * \brief Create the eNB phy layer
422c67049471 LTE module form GSoC project
Giuseppe Piro <g.piro@poliba.it>
parents:
diff changeset
    49
   * \param d the device where the phy layer is attached
422c67049471 LTE module form GSoC project
Giuseppe Piro <g.piro@poliba.it>
parents:
diff changeset
    50
   */
7887
78911c978517 renamed several LTE files and classes
CTTC
parents: 7886
diff changeset
    51
  LteEnbPhy (Ptr<LteNetDevice> d);
78911c978517 renamed several LTE files and classes
CTTC
parents: 7886
diff changeset
    52
  virtual ~LteEnbPhy ();
6705
422c67049471 LTE module form GSoC project
Giuseppe Piro <g.piro@poliba.it>
parents:
diff changeset
    53
422c67049471 LTE module form GSoC project
Giuseppe Piro <g.piro@poliba.it>
parents:
diff changeset
    54
  static TypeId GetTypeId (void);
422c67049471 LTE module form GSoC project
Giuseppe Piro <g.piro@poliba.it>
parents:
diff changeset
    55
7886
b65c16d4da83 LENA project first public release
CTTC
parents: 6852
diff changeset
    56
6705
422c67049471 LTE module form GSoC project
Giuseppe Piro <g.piro@poliba.it>
parents:
diff changeset
    57
  /**
7886
b65c16d4da83 LENA project first public release
CTTC
parents: 6852
diff changeset
    58
  * \brief Get the PHY SAP provider
b65c16d4da83 LENA project first public release
CTTC
parents: 6852
diff changeset
    59
  * \return a pointer to the SAP Provider of the PHY
b65c16d4da83 LENA project first public release
CTTC
parents: 6852
diff changeset
    60
  */
b65c16d4da83 LENA project first public release
CTTC
parents: 6852
diff changeset
    61
  LteEnbPhySapProvider* GetLteEnbPhySapProvider ();
b65c16d4da83 LENA project first public release
CTTC
parents: 6852
diff changeset
    62
b65c16d4da83 LENA project first public release
CTTC
parents: 6852
diff changeset
    63
  /**
b65c16d4da83 LENA project first public release
CTTC
parents: 6852
diff changeset
    64
  * \brief Set the PHY SAP User
b65c16d4da83 LENA project first public release
CTTC
parents: 6852
diff changeset
    65
  * \param s a pointer to the PHY SAP user
b65c16d4da83 LENA project first public release
CTTC
parents: 6852
diff changeset
    66
  */
b65c16d4da83 LENA project first public release
CTTC
parents: 6852
diff changeset
    67
  void SetLteEnbPhySapUser (LteEnbPhySapUser* s);
b65c16d4da83 LENA project first public release
CTTC
parents: 6852
diff changeset
    68
b65c16d4da83 LENA project first public release
CTTC
parents: 6852
diff changeset
    69
b65c16d4da83 LENA project first public release
CTTC
parents: 6852
diff changeset
    70
  /**
b65c16d4da83 LENA project first public release
CTTC
parents: 6852
diff changeset
    71
  * \brief Queue the MAC PDU to be sent
b65c16d4da83 LENA project first public release
CTTC
parents: 6852
diff changeset
    72
  * \param p the MAC PDU to sent
b65c16d4da83 LENA project first public release
CTTC
parents: 6852
diff changeset
    73
  */
b65c16d4da83 LENA project first public release
CTTC
parents: 6852
diff changeset
    74
  virtual void DoSendMacPdu (Ptr<Packet> p);
b65c16d4da83 LENA project first public release
CTTC
parents: 6852
diff changeset
    75
b65c16d4da83 LENA project first public release
CTTC
parents: 6852
diff changeset
    76
6705
422c67049471 LTE module form GSoC project
Giuseppe Piro <g.piro@poliba.it>
parents:
diff changeset
    77
  void DoSetDownlinkSubChannels ();
422c67049471 LTE module form GSoC project
Giuseppe Piro <g.piro@poliba.it>
parents:
diff changeset
    78
422c67049471 LTE module form GSoC project
Giuseppe Piro <g.piro@poliba.it>
parents:
diff changeset
    79
  /**
422c67049471 LTE module form GSoC project
Giuseppe Piro <g.piro@poliba.it>
parents:
diff changeset
    80
   * \brief Create the PSD for TX
422c67049471 LTE module form GSoC project
Giuseppe Piro <g.piro@poliba.it>
parents:
diff changeset
    81
   */
422c67049471 LTE module form GSoC project
Giuseppe Piro <g.piro@poliba.it>
parents:
diff changeset
    82
  virtual Ptr<SpectrumValue> CreateTxPowerSpectralDensity ();
422c67049471 LTE module form GSoC project
Giuseppe Piro <g.piro@poliba.it>
parents:
diff changeset
    83
422c67049471 LTE module form GSoC project
Giuseppe Piro <g.piro@poliba.it>
parents:
diff changeset
    84
  /**
422c67049471 LTE module form GSoC project
Giuseppe Piro <g.piro@poliba.it>
parents:
diff changeset
    85
   * \brief Calculate the channel quality for a given UE
422c67049471 LTE module form GSoC project
Giuseppe Piro <g.piro@poliba.it>
parents:
diff changeset
    86
   * \param sinr a list of computed SINR
422c67049471 LTE module form GSoC project
Giuseppe Piro <g.piro@poliba.it>
parents:
diff changeset
    87
   * \param ue the UE
422c67049471 LTE module form GSoC project
Giuseppe Piro <g.piro@poliba.it>
parents:
diff changeset
    88
   */
422c67049471 LTE module form GSoC project
Giuseppe Piro <g.piro@poliba.it>
parents:
diff changeset
    89
  void CalcChannelQualityForUe (std::vector <double> sinr, Ptr<LteSpectrumPhy> ue);
422c67049471 LTE module form GSoC project
Giuseppe Piro <g.piro@poliba.it>
parents:
diff changeset
    90
422c67049471 LTE module form GSoC project
Giuseppe Piro <g.piro@poliba.it>
parents:
diff changeset
    91
  /**
422c67049471 LTE module form GSoC project
Giuseppe Piro <g.piro@poliba.it>
parents:
diff changeset
    92
   * \brief Send the control message
422c67049471 LTE module form GSoC project
Giuseppe Piro <g.piro@poliba.it>
parents:
diff changeset
    93
   * \param msg the message to send
422c67049471 LTE module form GSoC project
Giuseppe Piro <g.piro@poliba.it>
parents:
diff changeset
    94
   */
7886
b65c16d4da83 LENA project first public release
CTTC
parents: 6852
diff changeset
    95
  // virtual void SendIdealControlMessage (Ptr<IdealControlMessage> msg);  // legacy
6705
422c67049471 LTE module form GSoC project
Giuseppe Piro <g.piro@poliba.it>
parents:
diff changeset
    96
  /**
422c67049471 LTE module form GSoC project
Giuseppe Piro <g.piro@poliba.it>
parents:
diff changeset
    97
   * \brief Receive the control message
422c67049471 LTE module form GSoC project
Giuseppe Piro <g.piro@poliba.it>
parents:
diff changeset
    98
   * \param msg the received message
422c67049471 LTE module form GSoC project
Giuseppe Piro <g.piro@poliba.it>
parents:
diff changeset
    99
   */
6710
3cd651349cb6 lte examples now passing valgrind tests
Nicola Baldo <nbaldo@cttc.es>
parents: 6705
diff changeset
   100
  virtual void ReceiveIdealControlMessage (Ptr<IdealControlMessage> msg);
7910
d7083e401e59 PUSCH based UL-CQI generation at eNB PHY side
mmiozzo
parents: 7887
diff changeset
   101
  
d7083e401e59 PUSCH based UL-CQI generation at eNB PHY side
mmiozzo
parents: 7887
diff changeset
   102
  /**
d7083e401e59 PUSCH based UL-CQI generation at eNB PHY side
mmiozzo
parents: 7887
diff changeset
   103
  * \brief Create the UL CQI feedback from SINR values perceived at
d7083e401e59 PUSCH based UL-CQI generation at eNB PHY side
mmiozzo
parents: 7887
diff changeset
   104
  * the physical layer with the signal received from eNB
d7083e401e59 PUSCH based UL-CQI generation at eNB PHY side
mmiozzo
parents: 7887
diff changeset
   105
  * \param sinr SINR values vector
d7083e401e59 PUSCH based UL-CQI generation at eNB PHY side
mmiozzo
parents: 7887
diff changeset
   106
  */
d7083e401e59 PUSCH based UL-CQI generation at eNB PHY side
mmiozzo
parents: 7887
diff changeset
   107
  Ptr<UlCqiIdealControlMessage> CreateUlCqiFeedbackMessage (const SpectrumValue& sinr);
6705
422c67049471 LTE module form GSoC project
Giuseppe Piro <g.piro@poliba.it>
parents:
diff changeset
   108
422c67049471 LTE module form GSoC project
Giuseppe Piro <g.piro@poliba.it>
parents:
diff changeset
   109
7886
b65c16d4da83 LENA project first public release
CTTC
parents: 6852
diff changeset
   110
  void DoSendIdealControlMessage (Ptr<IdealControlMessage> msg);
b65c16d4da83 LENA project first public release
CTTC
parents: 6852
diff changeset
   111
7887
78911c978517 renamed several LTE files and classes
CTTC
parents: 7886
diff changeset
   112
  bool AddUePhy (uint8_t rnti, Ptr<LteUePhy> phy);
7886
b65c16d4da83 LENA project first public release
CTTC
parents: 6852
diff changeset
   113
b65c16d4da83 LENA project first public release
CTTC
parents: 6852
diff changeset
   114
  bool DeleteUePhy (uint8_t rnti);
b65c16d4da83 LENA project first public release
CTTC
parents: 6852
diff changeset
   115
b65c16d4da83 LENA project first public release
CTTC
parents: 6852
diff changeset
   116
6705
422c67049471 LTE module form GSoC project
Giuseppe Piro <g.piro@poliba.it>
parents:
diff changeset
   117
  /**
422c67049471 LTE module form GSoC project
Giuseppe Piro <g.piro@poliba.it>
parents:
diff changeset
   118
   * \brief Start a LTE frame
422c67049471 LTE module form GSoC project
Giuseppe Piro <g.piro@poliba.it>
parents:
diff changeset
   119
   */
422c67049471 LTE module form GSoC project
Giuseppe Piro <g.piro@poliba.it>
parents:
diff changeset
   120
  void StartFrame (void);
422c67049471 LTE module form GSoC project
Giuseppe Piro <g.piro@poliba.it>
parents:
diff changeset
   121
  /**
422c67049471 LTE module form GSoC project
Giuseppe Piro <g.piro@poliba.it>
parents:
diff changeset
   122
   * \brief Start a LTE sub frame
422c67049471 LTE module form GSoC project
Giuseppe Piro <g.piro@poliba.it>
parents:
diff changeset
   123
   */
422c67049471 LTE module form GSoC project
Giuseppe Piro <g.piro@poliba.it>
parents:
diff changeset
   124
  void StartSubFrame (void);
422c67049471 LTE module form GSoC project
Giuseppe Piro <g.piro@poliba.it>
parents:
diff changeset
   125
  /**
422c67049471 LTE module form GSoC project
Giuseppe Piro <g.piro@poliba.it>
parents:
diff changeset
   126
   * \brief End a LTE sub frame
422c67049471 LTE module form GSoC project
Giuseppe Piro <g.piro@poliba.it>
parents:
diff changeset
   127
   */
422c67049471 LTE module form GSoC project
Giuseppe Piro <g.piro@poliba.it>
parents:
diff changeset
   128
  void EndSubFrame (void);
422c67049471 LTE module form GSoC project
Giuseppe Piro <g.piro@poliba.it>
parents:
diff changeset
   129
  /**
422c67049471 LTE module form GSoC project
Giuseppe Piro <g.piro@poliba.it>
parents:
diff changeset
   130
   * \brief End a LTE frame
422c67049471 LTE module form GSoC project
Giuseppe Piro <g.piro@poliba.it>
parents:
diff changeset
   131
   */
422c67049471 LTE module form GSoC project
Giuseppe Piro <g.piro@poliba.it>
parents:
diff changeset
   132
  void EndFrame (void);
422c67049471 LTE module form GSoC project
Giuseppe Piro <g.piro@poliba.it>
parents:
diff changeset
   133
7886
b65c16d4da83 LENA project first public release
CTTC
parents: 6852
diff changeset
   134
  /**
b65c16d4da83 LENA project first public release
CTTC
parents: 6852
diff changeset
   135
   * \brief PhySpectrum received a new PHY-PDU
b65c16d4da83 LENA project first public release
CTTC
parents: 6852
diff changeset
   136
   */
b65c16d4da83 LENA project first public release
CTTC
parents: 6852
diff changeset
   137
  void PhyPduReceived (Ptr<Packet> p);
b65c16d4da83 LENA project first public release
CTTC
parents: 6852
diff changeset
   138
  
b65c16d4da83 LENA project first public release
CTTC
parents: 6852
diff changeset
   139
  // inherited from LtePhy
b65c16d4da83 LENA project first public release
CTTC
parents: 6852
diff changeset
   140
  virtual void GenerateCqiFeedback (const SpectrumValue& sinr);
b65c16d4da83 LENA project first public release
CTTC
parents: 6852
diff changeset
   141
  
6705
422c67049471 LTE module form GSoC project
Giuseppe Piro <g.piro@poliba.it>
parents:
diff changeset
   142
422c67049471 LTE module form GSoC project
Giuseppe Piro <g.piro@poliba.it>
parents:
diff changeset
   143
private:
7887
78911c978517 renamed several LTE files and classes
CTTC
parents: 7886
diff changeset
   144
  std::map <uint8_t, Ptr<LteUePhy> > m_ueAttached;
7886
b65c16d4da83 LENA project first public release
CTTC
parents: 6852
diff changeset
   145
b65c16d4da83 LENA project first public release
CTTC
parents: 6852
diff changeset
   146
  LteEnbPhySapProvider* m_enbPhySapProvider;
b65c16d4da83 LENA project first public release
CTTC
parents: 6852
diff changeset
   147
  LteEnbPhySapUser* m_enbPhySapUser;
b65c16d4da83 LENA project first public release
CTTC
parents: 6852
diff changeset
   148
b65c16d4da83 LENA project first public release
CTTC
parents: 6852
diff changeset
   149
  uint32_t m_nrFrames;
b65c16d4da83 LENA project first public release
CTTC
parents: 6852
diff changeset
   150
  uint32_t m_nrSubFrames;
6705
422c67049471 LTE module form GSoC project
Giuseppe Piro <g.piro@poliba.it>
parents:
diff changeset
   151
};
422c67049471 LTE module form GSoC project
Giuseppe Piro <g.piro@poliba.it>
parents:
diff changeset
   152
422c67049471 LTE module form GSoC project
Giuseppe Piro <g.piro@poliba.it>
parents:
diff changeset
   153
422c67049471 LTE module form GSoC project
Giuseppe Piro <g.piro@poliba.it>
parents:
diff changeset
   154
}
422c67049471 LTE module form GSoC project
Giuseppe Piro <g.piro@poliba.it>
parents:
diff changeset
   155
7887
78911c978517 renamed several LTE files and classes
CTTC
parents: 7886
diff changeset
   156
#endif /* LTE_ENB_PHY_H */