/usr/include/ns3.17/ns3/lte-ue-phy.h is in libns3-dev 3.17+dfsg-1build1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
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 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222 223 224 225 226 227 228 229 230 231 232 233 234 235 236 237 238 239 240 241 242 243 244 245 246 247 248 249 250 251 252 253 254 255 256 257 258 259 260 261 262 263 264 265 266 267 268 269 270 271 272 273 274 275 276 277 278 279 280 281 282 283 284 285 286 287 288 289 290 291 292 293 294 295 296 297 298 299 300 301 302 303 304 305 306 307 | /* -*- Mode:C++; c-file-style:"gnu"; indent-tabs-mode:nil; -*- */
/*
* Copyright (c) 2010 TELEMATICS LAB, DEE - Politecnico di Bari
*
* This program is free software; you can redistribute it and/or modify
* it under the terms of the GNU General Public License version 2 as
* published by the Free Software Foundation;
*
* This program 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 this program; if not, write to the Free Software
* Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
*
* Author: Giuseppe Piro <g.piro@poliba.it>
* Author: Marco Miozzo <mmiozzo@cttc.es>
*/
#ifndef LTE_UE_PHY_H
#define LTE_UE_PHY_H
#include <ns3/lte-phy.h>
#include <ns3/ff-mac-common.h>
#include <ns3/lte-control-messages.h>
#include <ns3/lte-amc.h>
#include <ns3/lte-ue-phy-sap.h>
#include <ns3/lte-ue-cphy-sap.h>
#include <ns3/ptr.h>
#include <ns3/lte-amc.h>
namespace ns3 {
class PacketBurst;
class LteEnbPhy;
class LteHarqPhy;
/**
* \ingroup lte
*
* The LteSpectrumPhy models the physical layer of LTE
*/
class LteUePhy : public LtePhy
{
friend class UeMemberLteUePhySapProvider;
friend class MemberLteUeCphySapProvider<LteUePhy>;
public:
/**
* @warning the default constructor should not be used
*/
LteUePhy ();
/**
*
* \param dlPhy the downlink LteSpectrumPhy instance
* \param ulPhy the uplink LteSpectrumPhy instance
*/
LteUePhy (Ptr<LteSpectrumPhy> dlPhy, Ptr<LteSpectrumPhy> ulPhy);
virtual ~LteUePhy ();
// inherited from Object
static TypeId GetTypeId (void);
virtual void DoInitialize (void);
virtual void DoDispose (void);
/**
* \brief Get the PHY SAP provider
* \return a pointer to the SAP Provider
*/
LteUePhySapProvider* GetLteUePhySapProvider ();
/**
* \brief Set the PHY SAP User
* \param s a pointer to the SAP user
*/
void SetLteUePhySapUser (LteUePhySapUser* s);
/**
* \brief Get the CPHY SAP provider
* \return a pointer to the SAP Provider
*/
LteUeCphySapProvider* GetLteUeCphySapProvider ();
/**
* \brief Set the CPHY SAP User
* \param s a pointer to the SAP user
*/
void SetLteUeCphySapUser (LteUeCphySapUser* s);
/**
* \param pw the transmission power in dBm
*/
void SetTxPower (double pow);
/**
* \return the transmission power in dBm
*/
double GetTxPower () const;
/**
* \param pw the noise figure in dB
*/
void SetNoiseFigure (double pow);
/**
* \return the noise figure in dB
*/
double GetNoiseFigure () const;
/**
* \returns the TTI delay between MAC and channel
*/
uint8_t GetMacChDelay (void) const;
/**
* \return a pointer to the LteSpectrumPhy instance relative to the downlink
*/
Ptr<LteSpectrumPhy> GetDlSpectrumPhy () const;
/**
* \return a pointer to the LteSpectrumPhy instance relative to the uplink
*/
Ptr<LteSpectrumPhy> GetUlSpectrumPhy () const;
/**
* \brief Create the PSD for the TX
* \return the pointer to the PSD
*/
virtual Ptr<SpectrumValue> CreateTxPowerSpectralDensity ();
/**
* \brief Set a list of sub channels to use in TX
* \param mask a list of sub channels
*/
void SetSubChannelsForTransmission (std::vector <int> mask);
/**
* \brief Get a list of sub channels to use in RX
* \return a list of sub channels
*/
std::vector <int> GetSubChannelsForTransmission (void);
/**
* \brief Get a list of sub channels to use in RX
* \param mask list of sub channels
*/
void SetSubChannelsForReception (std::vector <int> mask);
/**
* \brief Get a list of sub channels to use in RX
* \return a list of sub channels
*/
std::vector <int> GetSubChannelsForReception (void);
/**
* \brief Create the DL CQI feedback from SINR values perceived at
* the physical layer with the signal received from eNB
* \param sinr SINR values vector
*/
Ptr<DlCqiLteControlMessage> CreateDlCqiFeedbackMessage (const SpectrumValue& sinr);
// inherited from LtePhy
virtual void GenerateCtrlCqiReport (const SpectrumValue& sinr);
virtual void GenerateDataCqiReport (const SpectrumValue& sinr);
virtual void ReportInterference (const SpectrumValue& interf);
virtual void ReportRsReceivedPower (const SpectrumValue& power);
virtual void ReceiveLteControlMessageList (std::list<Ptr<LteControlMessage> >);
/**
* \brief PhySpectrum received a new PHY-PDU
*/
void PhyPduReceived (Ptr<Packet> p);
/**
* \brief trigger from eNB the start from a new frame
*
* \param frameNo frame number
* \param subframeNo subframe number
*/
void SubframeIndication (uint32_t frameNo, uint32_t subframeNo);
/**
* \brief Send the SRS signal in the last symbols of the frame
*/
void SendSrs ();
/**
* \brief PhySpectrum generated a new DL HARQ feedback
*/
virtual void ReceiveLteDlHarqFeedback (DlInfoListElement_s mes);
/**
* \brief Set the HARQ PHY module
*/
void SetHarqPhyModule (Ptr<LteHarqPhy> harq);
private:
void SetTxMode1Gain (double gain);
void SetTxMode2Gain (double gain);
void SetTxMode3Gain (double gain);
void SetTxMode4Gain (double gain);
void SetTxMode5Gain (double gain);
void SetTxMode6Gain (double gain);
void SetTxMode7Gain (double gain);
void SetTxModeGain (uint8_t txMode, double gain);
void QueueSubChannelsForTransmission (std::vector <int> rbMap);
// UE CPHY SAP methods
void DoReset ();
void DoSyncronizeWithEnb (uint16_t cellId, uint16_t dlEarfcn);
void DoSetDlBandwidth (uint8_t ulBandwidth);
void DoConfigureUplink (uint16_t ulEarfcn, uint8_t ulBandwidth);
void DoSetRnti (uint16_t rnti);
void DoSetTransmissionMode (uint8_t txMode);
void DoSetSrsConfigurationIndex (uint16_t srcCi);
// UE PHY SAP methods
virtual void DoSendMacPdu (Ptr<Packet> p);
virtual void DoSendLteControlMessage (Ptr<LteControlMessage> msg);
virtual void DoSendRachPreamble (uint32_t prachId, uint32_t raRnti);
std::vector <int> m_subChannelsForTransmission;
std::vector <int> m_subChannelsForReception;
std::vector< std::vector <int> > m_subChannelsForTransmissionQueue;
Ptr<LteAmc> m_amc;
Time m_p10CqiPeriocity; /**< Wideband Periodic CQI: 2, 5, 10, 16, 20, 32, 40, 64, 80 or 160 ms */
Time m_p10CqiLast;
/**< SubBand Aperiodic CQI: activated by DCI format 0 or Random Access Response Grant */
// NOTE defines a periodicity for academic studies
Time m_a30CqiPeriocity;
Time m_a30CqiLast;
LteUePhySapProvider* m_uePhySapProvider;
LteUePhySapUser* m_uePhySapUser;
LteUeCphySapProvider* m_ueCphySapProvider;
LteUeCphySapUser* m_ueCphySapUser;
uint16_t m_rnti;
uint8_t m_transmissionMode;
std::vector <double> m_txModeGain;
uint16_t m_srsPeriodicity;
uint16_t m_srsSubframeOffset;
uint16_t m_srsConfigured;
Time m_srsStartTime;
bool m_dlConfigured;
bool m_ulConfigured;
bool m_rsReceivedPowerUpdated;
SpectrumValue m_rsReceivedPower;
Ptr<LteHarqPhy> m_harqPhyModule;
uint32_t m_raPreambleId;
uint32_t m_raRnti;
/**
* Trace information regarding RSRP and average SINR (see TS 36.214)
* uint16_t cellId, uint16_t rnti, double rsrp, double sinr
*/
TracedCallback<uint16_t, uint16_t, double, double> m_reportCurrentCellRsrpSinrTrace;
uint16_t m_rsrpSinrSamplePeriod;
uint16_t m_rsrpSinrSampleCounter;
EventId m_sendSrsEvent;
/**
* Trace information regarding PHY stats from DL Tx perspective
* PhyTrasmissionStatParameters see lte-common.h
*/
TracedCallback<PhyTransmissionStatParameters> m_ulPhyTransmission;
};
}
#endif /* LTE_UE_PHY_H */
|