/usr/include/ns3.27/ns3/lte-harq-phy.h is in libns3-dev 3.27+dfsg-1.
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 | /* -*- Mode: C++; c-file-style: "gnu"; indent-tabs-mode:nil; -*- */
/*
* Copyright (c) 2012 Centre Tecnologic de Telecomunicacions de Catalunya (CTTC)
*
* 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: Marco Miozzo <marco.miozzo@cttc.es>
*/
#ifndef LTE_HARQ_PHY_MODULE_H
#define LTE_HARQ_PHY_MODULE_H
#include <ns3/log.h>
#include <ns3/assert.h>
#include <math.h>
#include <vector>
#include <map>
#include <ns3/simple-ref-count.h>
namespace ns3 {
/// HarqProcessInfoElement_t structure
struct HarqProcessInfoElement_t
{
double m_mi; ///< MI
uint8_t m_rv; ///< RV
uint16_t m_infoBits; ///< info bits
uint16_t m_codeBits; ///< code bits
};
typedef std::vector <HarqProcessInfoElement_t> HarqProcessInfoList_t; ///< HarqProcessInfoList_t typedef
/**
* \ingroup lte
* \brief The LteHarqPhy class implements the HARQ functionalities related to PHY layer
*(i.e., decodification buffers for incremental redundancy management)
*
*/
class LteHarqPhy : public SimpleRefCount<LteHarqPhy>
{
public:
LteHarqPhy ();
~LteHarqPhy ();
/**
* \brief Subframe Indication function
* \param frameNo the frame number
* \param subframeNo the subframe number
*/
void SubframeIndication (uint32_t frameNo, uint32_t subframeNo);
/**
* \brief Return the cumulated MI of the HARQ procId in case of retransmissions
* for DL (asynchronous)
* \param harqProcId the HARQ proc id
* \param layer layer no. (for MIMO spatial multiplexing)
* \return the MI accumulated
*/
double GetAccumulatedMiDl (uint8_t harqProcId, uint8_t layer);
/**
* \brief Return the info of the HARQ procId in case of retransmissions
* for DL (asynchronous)
* \param harqProcId the HARQ proc id
* \param layer layer no. (for MIMO spatial multiplexing)
* \return the vector of the info related to HARQ proc Id
*/
HarqProcessInfoList_t GetHarqProcessInfoDl (uint8_t harqProcId, uint8_t layer);
/**
* \brief Return the cumulated MI of the HARQ procId in case of retransmissions
* for UL (synchronous)
* \param rnti the RNTI of the transmitter
* \return the MI accumulated
*/
double GetAccumulatedMiUl (uint16_t rnti);
/**
* \brief Return the info of the HARQ procId in case of retransmissions
* for UL (asynchronous)
* \param rnti the RNTI of the transmitter
* \param harqProcId the HARQ proc id
* \return the vector of the info related to HARQ proc Id
*/
HarqProcessInfoList_t GetHarqProcessInfoUl (uint16_t rnti, uint8_t harqProcId);
/**
* \brief Update the Info associated to the decodification of an HARQ process
* for DL (asynchronous)
* \param id the HARQ proc id
* \param layer layer no. (for MIMO spatial multiplexing)
* \param mi the new MI
* \param infoBytes the no. of bytes of info
* \param codeBytes the total no. of bytes txed
*/
void UpdateDlHarqProcessStatus (uint8_t id, uint8_t layer, double mi, uint16_t infoBytes, uint16_t codeBytes);
/**
* \brief Reset the info associated to the decodification of an HARQ process
* for DL (asynchronous)
* \param id the HARQ proc id
*/
void ResetDlHarqProcessStatus(uint8_t id);
/**
* \brief Update the MI value associated to the decodification of an HARQ process
* for DL (asynchronous)
* \param rnti the RNTI of the transmitter
* \param mi the new MI
* \param infoBytes the no. of bytes of info
* \param codeBytes the total no. of bytes txed
*/
void UpdateUlHarqProcessStatus (uint16_t rnti, double mi, uint16_t infoBytes, uint16_t codeBytes);
/**
* \brief Reset the info associated to the decodification of an HARQ process
* for DL (asynchronous)
* \param rnti the RNTI of the transmitter
* \param id the HARQ proc id
*/
void ResetUlHarqProcessStatus(uint16_t rnti, uint8_t id);
private:
std::vector <std::vector <HarqProcessInfoList_t> > m_miDlHarqProcessesInfoMap; ///< MI DL HARQ processes info map
std::map <uint16_t, std::vector <HarqProcessInfoList_t> > m_miUlHarqProcessesInfoMap; ///< MI UL HARQ processes info map
};
}
#endif /* LTE_HARQ_PHY_MODULE_H */
|