/** * * \section COPYRIGHT * * Copyright 2013-2015 The srsLTE Developers. See the * COPYRIGHT file at the top-level directory of this distribution. * * \section LICENSE * * This file is part of the srsLTE library. * * srsLTE is free software: you can redistribute it and/or modify * it under the terms of the GNU Affero General Public License as * published by the Free Software Foundation, either version 3 of * the License, or (at your option) any later version. * * srsLTE 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 Affero General Public License for more details. * * A copy of the GNU Affero General Public License can be found in * the LICENSE file in the top-level directory of this distribution * and at http://www.gnu.org/licenses/. * */ #include #include #include #include #include #include #include #include #include "srslte/phch/pusch.h" #include "srslte/phch/pusch_cfg.h" #include "srslte/phch/uci.h" #include "srslte/common/phy_common.h" #include "srslte/utils/bit.h" #include "srslte/utils/debug.h" #include "srslte/utils/vector.h" #include "srslte/dft/dft_precoding.h" #define MAX_PUSCH_RE(cp) (2 * SRSLTE_CP_NSYMB(cp) * 12) const static srslte_mod_t modulations[4] = { SRSLTE_MOD_BPSK, SRSLTE_MOD_QPSK, SRSLTE_MOD_16QAM, SRSLTE_MOD_64QAM }; static int f_hop_sum(srslte_pusch_t *q, uint32_t i) { uint32_t sum = 0; for (uint32_t k=i*10+1;kseq_type2_fo.c[k]<<(k-(i*10+1))); } return sum; } static int f_hop(srslte_pusch_t *q, srslte_pusch_hopping_cfg_t *hopping, int i) { if (i == -1) { return 0; } else { if (hopping->n_sb == 1) { return 0; } else if (hopping->n_sb == 2) { return (f_hop(q, hopping, i-1) + f_hop_sum(q, i))%2; } else { return (f_hop(q, hopping, i-1) + f_hop_sum(q, i)%(hopping->n_sb-1)+1)%hopping->n_sb; } } } static int f_m(srslte_pusch_t *q, srslte_pusch_hopping_cfg_t *hopping, uint32_t i) { if (hopping->n_sb == 1) { if (hopping->hop_mode == SRSLTE_PUSCH_HOP_MODE_INTER_SF) { return hopping->current_tx_nb%2; } else { return i%2; } } else { return q->seq_type2_fo.c[i*10]; } } int pusch_cp(srslte_pusch_t *q, srslte_ra_ul_grant_t *grant, uint32_t sf_idx, cf_t *input, cf_t *output, bool advance_input) { cf_t *in_ptr = input; cf_t *out_ptr = output; srslte_pusch_hopping_cfg_t *hopping = &q->hopping_cfg; uint32_t L_ref = 3; if (SRSLTE_CP_ISEXT(q->cell.cp)) { L_ref = 2; } INFO("PUSCH Freq hopping: %d\n", grant->freq_hopping); for (uint32_t slot=0;slot<2;slot++) { uint32_t n_prb_tilde = grant->n_prb[slot]; if (grant->freq_hopping == 1) { if (hopping->hop_mode == SRSLTE_PUSCH_HOP_MODE_INTER_SF) { n_prb_tilde = grant->n_prb[hopping->current_tx_nb%2]; } else { n_prb_tilde = grant->n_prb[slot]; } } if (grant->freq_hopping == 2) { /* Freq hopping type 2 as defined in 5.3.4 of 36.211 */ uint32_t n_vrb_tilde = grant->n_prb[0]; if (hopping->n_sb > 1) { n_vrb_tilde -= (hopping->hopping_offset-1)/2+1; } int i=0; if (hopping->hop_mode == SRSLTE_PUSCH_HOP_MODE_INTER_SF) { i = sf_idx; } else { i = 2*sf_idx+slot; } uint32_t n_rb_sb = q->cell.nof_prb; if (hopping->n_sb > 1) { n_rb_sb = (n_rb_sb-hopping->hopping_offset-hopping->hopping_offset%2)/hopping->n_sb; } n_prb_tilde = (n_vrb_tilde+f_hop(q, hopping, i)*n_rb_sb+ (n_rb_sb-1)-2*(n_vrb_tilde%n_rb_sb)*f_m(q, hopping, i))%(n_rb_sb*hopping->n_sb); INFO("n_prb_tilde: %d, n_vrb_tilde: %d, n_rb_sb: %d, n_sb: %d\n", n_prb_tilde, n_vrb_tilde, n_rb_sb, hopping->n_sb); if (hopping->n_sb > 1) { n_prb_tilde += (hopping->hopping_offset-1)/2+1; } } grant->n_prb_tilde[slot] = n_prb_tilde; INFO("Allocating PUSCH %d PRB to index %d at slot %d\n",grant->L_prb, n_prb_tilde,slot); for (uint32_t l=0;lcell.cp);l++) { if (l != L_ref) { uint32_t idx = SRSLTE_RE_IDX(q->cell.nof_prb, l+slot*SRSLTE_CP_NSYMB(q->cell.cp), n_prb_tilde*SRSLTE_NRE); if (advance_input) { out_ptr = &output[idx]; } else { in_ptr = &input[idx]; } memcpy(out_ptr, in_ptr, grant->L_prb * SRSLTE_NRE * sizeof(cf_t)); if (advance_input) { in_ptr += grant->L_prb*SRSLTE_NRE; } else { out_ptr += grant->L_prb*SRSLTE_NRE; } } } } return SRSLTE_NRE*grant->L_prb; } int pusch_put(srslte_pusch_t *q, srslte_ra_ul_grant_t *grant, uint32_t sf_idx, cf_t *input, cf_t *output) { return pusch_cp(q, grant, sf_idx, input, output, true); } int pusch_get(srslte_pusch_t *q, srslte_ra_ul_grant_t *grant, uint32_t sf_idx, cf_t *input, cf_t *output) { return pusch_cp(q, grant, sf_idx, input, output, false); } /** Initializes the PDCCH transmitter and receiver */ int srslte_pusch_init(srslte_pusch_t *q, srslte_cell_t cell) { int ret = SRSLTE_ERROR_INVALID_INPUTS; int i; if (q != NULL && srslte_cell_isvalid(&cell)) { bzero(q, sizeof(srslte_pusch_t)); ret = SRSLTE_ERROR; q->cell = cell; q->max_re = q->cell.nof_prb * MAX_PUSCH_RE(q->cell.cp); INFO("Init PUSCH: %d ports %d PRBs, max_symbols: %d\n", q->cell.nof_ports, q->cell.nof_prb, q->max_re); for (i = 0; i < 4; i++) { if (srslte_modem_table_lte(&q->mod[i], modulations[i], true)) { goto clean; } } /* Precompute sequence for type2 frequency hopping */ if (srslte_sequence_LTE_pr(&q->seq_type2_fo, 210, q->cell.id)) { fprintf(stderr, "Error initiating type2 frequency hopping sequence\n"); goto clean; } srslte_demod_soft_init(&q->demod, q->max_re); srslte_demod_soft_alg_set(&q->demod, SRSLTE_DEMOD_SOFT_ALG_APPROX); srslte_sch_init(&q->dl_sch); if (srslte_dft_precoding_init(&q->dft_precoding, cell.nof_prb)) { fprintf(stderr, "Error initiating DFT transform precoding\n"); goto clean; } /* This is for equalization at receiver */ if (srslte_precoding_init(&q->equalizer, SRSLTE_SF_LEN_RE(cell.nof_prb, cell.cp))) { fprintf(stderr, "Error initializing precoding\n"); goto clean; } q->rnti_is_set = false; // Allocate floats for reception (LLRs). Buffer casted to uint8_t for transmission q->q = srslte_vec_malloc(sizeof(float) * q->max_re * srslte_mod_bits_x_symbol(SRSLTE_MOD_64QAM)); if (!q->q) { goto clean; } // Allocate floats for reception (LLRs). Buffer casted to uint8_t for transmission q->g = srslte_vec_malloc(sizeof(float) * q->max_re * srslte_mod_bits_x_symbol(SRSLTE_MOD_64QAM)); if (!q->g) { goto clean; } q->d = srslte_vec_malloc(sizeof(cf_t) * q->max_re); if (!q->d) { goto clean; } q->ce = srslte_vec_malloc(sizeof(cf_t) * q->max_re); if (!q->ce) { goto clean; } q->z = srslte_vec_malloc(sizeof(cf_t) * q->max_re); if (!q->z) { goto clean; } ret = SRSLTE_SUCCESS; } clean: if (ret == SRSLTE_ERROR) { srslte_pusch_free(q); } return ret; } void srslte_pusch_free(srslte_pusch_t *q) { int i; if (q->q) { free(q->q); } if (q->d) { free(q->d); } if (q->g) { free(q->g); } if (q->ce) { free(q->ce); } if (q->z) { free(q->z); } srslte_dft_precoding_free(&q->dft_precoding); srslte_precoding_free(&q->equalizer); for (i = 0; i < SRSLTE_NSUBFRAMES_X_FRAME; i++) { srslte_sequence_free(&q->seq[i]); } for (i = 0; i < 4; i++) { srslte_modem_table_free(&q->mod[i]); } srslte_demod_soft_free(&q->demod); srslte_sch_free(&q->dl_sch); bzero(q, sizeof(srslte_pusch_t)); } void srslte_pusch_set_hopping_cfg(srslte_pusch_t *q, srslte_pusch_hopping_cfg_t *cfg) { if (cfg) { memcpy(&q->hopping_cfg, cfg, sizeof(srslte_pusch_hopping_cfg_t)); } } /* Configures the structure srslte_pusch_cfg_t from the UL DCI allocation dci_msg. * If dci_msg is NULL, the grant is assumed to be already stored in cfg->grant */ int srslte_pusch_cfg(srslte_pusch_cfg_t *cfg, srslte_cell_t cell, srslte_dci_msg_t *dci_msg, uint32_t n_rb_ho, uint32_t N_srs, uint32_t sf_idx, uint32_t rvidx) { if (dci_msg) { srslte_ra_ul_dci_t ul_dci; if (srslte_dci_msg_to_ul_grant(dci_msg, cell.nof_prb, n_rb_ho, &ul_dci, &cfg->grant)) { fprintf(stderr, "Error unpacking UL grant from DCI message\n"); return SRSLTE_ERROR; } } if (srslte_cbsegm(&cfg->cb_segm, cfg->grant.mcs.tbs)) { fprintf(stderr, "Error computing Codeblock segmentation for TBS=%d\n", cfg->grant.mcs.tbs); return SRSLTE_ERROR; } srslte_ra_ul_grant_to_nbits(&cfg->grant, cell.cp, N_srs, &cfg->nbits); cfg->sf_idx = sf_idx; cfg->rv = rvidx; cfg->cp = cell.cp; return SRSLTE_SUCCESS; } /* Precalculate the PUSCH scramble sequences for a given RNTI. This function takes a while * to execute, so shall be called once the final C-RNTI has been allocated for the session. * For the connection procedure, use srslte_pusch_encode_rnti() or srslte_pusch_decode_rnti() functions */ int srslte_pusch_set_rnti(srslte_pusch_t *q, uint16_t rnti) { uint32_t i; for (i = 0; i < SRSLTE_NSUBFRAMES_X_FRAME; i++) { if (srslte_sequence_pusch(&q->seq[i], rnti, 2 * i, q->cell.id, q->max_re * srslte_mod_bits_x_symbol(SRSLTE_MOD_64QAM))) { return SRSLTE_ERROR; } } q->rnti_is_set = true; q->rnti = rnti; return SRSLTE_SUCCESS; } /** Decodes the PUSCH from the received symbols */ int srslte_pusch_decode(srslte_pusch_t *q, srslte_pusch_cfg_t *cfg, srslte_softbuffer_rx_t *softbuffer, cf_t *sf_symbols, cf_t *ce, float noise_estimate, uint8_t *data) { uint32_t n; if (q != NULL && sf_symbols != NULL && data != NULL && cfg != NULL) { if (q->rnti_is_set) { INFO("Decoding PUSCH SF: %d, Mod %s, NofBits: %d, NofRE: %d, NofSymbols=%d, NofBitsE: %d, rv_idx: %d\n", cfg->sf_idx, srslte_mod_string(cfg->grant.mcs.mod), cfg->grant.mcs.tbs, cfg->nbits.nof_re, cfg->nbits.nof_symb, cfg->nbits.nof_bits, cfg->rv); /* extract symbols */ n = pusch_get(q, &cfg->grant, cfg->sf_idx, sf_symbols, q->d); if (n != cfg->nbits.nof_re) { fprintf(stderr, "Error expecting %d symbols but got %d\n", cfg->nbits.nof_re, n); return SRSLTE_ERROR; } /* extract channel estimates */ n = pusch_get(q, &cfg->grant, cfg->sf_idx, ce, q->ce); if (n != cfg->nbits.nof_re) { fprintf(stderr, "Error expecting %d symbols but got %d\n", cfg->nbits.nof_re, n); return SRSLTE_ERROR; } srslte_predecoding_single(&q->equalizer, q->d, q->ce, q->z, cfg->nbits.nof_re, noise_estimate); srslte_dft_predecoding(&q->dft_precoding, q->z, q->d, cfg->grant.L_prb, cfg->nbits.nof_symb); /* demodulate symbols * The MAX-log-MAP algorithm used in turbo decoding is unsensitive to SNR estimation, * thus we don't need tot set it in the LLRs normalization */ srslte_demod_soft_sigma_set(&q->demod, sqrt(0.5)); srslte_demod_soft_table_set(&q->demod, &q->mod[cfg->grant.mcs.mod]); srslte_demod_soft_demodulate(&q->demod, q->d, q->q, cfg->nbits.nof_re); /* descramble */ srslte_scrambling_f_offset(&q->seq[cfg->sf_idx], q->q, 0, cfg->nbits.nof_bits); return srslte_ulsch_decode(&q->dl_sch, cfg, softbuffer, q->q, data); } else { fprintf(stderr, "Must call srslte_pusch_set_rnti() before calling srslte_pusch_decode()\n"); return SRSLTE_ERROR; } } else { return SRSLTE_ERROR_INVALID_INPUTS; } } int srslte_pusch_encode_rnti(srslte_pusch_t *q, srslte_pusch_cfg_t *cfg, srslte_softbuffer_tx_t *softbuffer, uint8_t *data, uint16_t rnti, cf_t *sf_symbols) { srslte_uci_data_t uci_data; bzero(&uci_data, sizeof(srslte_uci_data_t)); return srslte_pusch_uci_encode_rnti(q, cfg, softbuffer, data, uci_data, rnti, sf_symbols); } int srslte_pusch_encode(srslte_pusch_t *q, srslte_pusch_cfg_t *cfg, srslte_softbuffer_tx_t *softbuffer, uint8_t *data, cf_t *sf_symbols) { if (q->rnti_is_set) { srslte_uci_data_t uci_data; bzero(&uci_data, sizeof(srslte_uci_data_t)); return srslte_pusch_uci_encode_rnti(q, cfg, softbuffer, data, uci_data, q->rnti, sf_symbols); } else { fprintf(stderr, "Must call srslte_pusch_set_rnti() to set the encoder/decoder RNTI\n"); return SRSLTE_ERROR; } } int srslte_pusch_uci_encode(srslte_pusch_t *q, srslte_pusch_cfg_t *cfg, srslte_softbuffer_tx_t *softbuffer, uint8_t *data, srslte_uci_data_t uci_data, cf_t *sf_symbols) { if (q->rnti_is_set) { return srslte_pusch_uci_encode_rnti(q, cfg, softbuffer, data, uci_data, q->rnti, sf_symbols); } else { fprintf(stderr, "Must call srslte_pusch_set_rnti() to set the encoder/decoder RNTI\n"); return SRSLTE_ERROR; } } /** Converts the PUSCH data bits to symbols mapped to the slot ready for transmission */ int srslte_pusch_uci_encode_rnti(srslte_pusch_t *q, srslte_pusch_cfg_t *cfg, srslte_softbuffer_tx_t *softbuffer, uint8_t *data, srslte_uci_data_t uci_data, uint16_t rnti, cf_t *sf_symbols) { int ret = SRSLTE_ERROR_INVALID_INPUTS; if (q != NULL && cfg != NULL) { if (cfg->grant.mcs.tbs > cfg->nbits.nof_bits) { fprintf(stderr, "Invalid code rate %.2f\n", (float) cfg->grant.mcs.tbs / cfg->nbits.nof_bits); return SRSLTE_ERROR_INVALID_INPUTS; } if (cfg->nbits.nof_re > q->max_re) { fprintf(stderr, "Error too many RE per subframe (%d). PUSCH configured for %d RE (%d PRB)\n", cfg->nbits.nof_re, q->max_re, q->cell.nof_prb); return SRSLTE_ERROR_INVALID_INPUTS; } INFO("Encoding PUSCH SF: %d, Mod %s, RNTI: %d, TBS: %d, NofRE: %d, NofSymbols=%d, NofBitsE: %d, rv_idx: %d\n", cfg->sf_idx, srslte_mod_string(cfg->grant.mcs.mod), rnti, cfg->grant.mcs.tbs, cfg->nbits.nof_re, cfg->nbits.nof_symb, cfg->nbits.nof_bits, cfg->rv); bzero(q->q, cfg->nbits.nof_bits); if (srslte_ulsch_uci_encode(&q->dl_sch, cfg, softbuffer, data, uci_data, q->g, q->q)) { fprintf(stderr, "Error encoding TB\n"); return SRSLTE_ERROR; } if (rnti != q->rnti) { srslte_sequence_t seq; if (srslte_sequence_pusch(&seq, rnti, 2 * cfg->sf_idx, q->cell.id, cfg->nbits.nof_bits)) { return SRSLTE_ERROR; } srslte_scrambling_b_offset_pusch(&seq, (uint8_t*) q->q, 0, cfg->nbits.nof_bits); srslte_sequence_free(&seq); } else { srslte_scrambling_b_offset_pusch(&q->seq[cfg->sf_idx], (uint8_t*) q->q, 0, cfg->nbits.nof_bits); } srslte_mod_modulate(&q->mod[cfg->grant.mcs.mod], (uint8_t*) q->q, q->d, cfg->nbits.nof_bits); srslte_dft_precoding(&q->dft_precoding, q->d, q->z, cfg->grant.L_prb, cfg->nbits.nof_symb); /* mapping to resource elements */ pusch_put(q, &cfg->grant, cfg->sf_idx, q->z, sf_symbols); ret = SRSLTE_SUCCESS; } return ret; }