/** * * \section COPYRIGHT * * Copyright 2013-2015 Software Radio Systems Limited * * \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 "srslte/phch/dci.h" #include "srslte/phch/regs.h" #include "srslte/phch/pdcch.h" #include "srslte/common/phy_common.h" #include "srslte/utils/bit.h" #include "srslte/utils/vector.h" #include "srslte/utils/debug.h" #define PDCCH_NOF_FORMATS 4 #define PDCCH_FORMAT_NOF_CCE(i) (1< 0 && cfi < 4) { q->nof_regs = (srslte_regs_pdcch_nregs(q->regs, cfi) / 9) * 9; q->nof_cce = q->nof_regs / 9; } } void srslte_pdcch_set_cfi(srslte_pdcch_t *q, uint32_t cfi) { set_cfi(q, cfi); } float srslte_pdcch_coderate(uint32_t nof_bits, uint32_t l) { return (float) (nof_bits+16)/(4*PDCCH_FORMAT_NOF_REGS(l)); } /** Initializes the PDCCH transmitter and receiver */ int srslte_pdcch_init(srslte_pdcch_t *q, srslte_regs_t *regs, srslte_cell_t cell) { return srslte_pdcch_init_multi(q, regs, cell, 1); } int srslte_pdcch_init_multi(srslte_pdcch_t *q, srslte_regs_t *regs, srslte_cell_t cell, uint32_t nof_rx_antennas) { int ret = SRSLTE_ERROR_INVALID_INPUTS; if (q != NULL && regs != NULL && srslte_cell_isvalid(&cell)) { ret = SRSLTE_ERROR; bzero(q, sizeof(srslte_pdcch_t)); q->cell = cell; q->regs = regs; q->nof_rx_antennas = nof_rx_antennas; /* Allocate memory for the maximum number of PDCCH bits (CFI=3) */ q->max_bits = (srslte_regs_pdcch_nregs(q->regs, 3) / 9) * 72; INFO("Init PDCCH: Max bits: %d, %d ports.\n", q->max_bits, q->cell.nof_ports); if (srslte_modem_table_lte(&q->mod, SRSLTE_MOD_QPSK)) { goto clean; } if (srslte_crc_init(&q->crc, SRSLTE_LTE_CRC16, 16)) { goto clean; } for (int i = 0; i < SRSLTE_NSUBFRAMES_X_FRAME; i++) { // we need to pregenerate the sequence for the maximum number of bits, which is 8 times // the maximum number of REGs (for CFI=3) if (srslte_sequence_pdcch(&q->seq[i], 2 * i, q->cell.id, 8*srslte_regs_pdcch_nregs(q->regs, 3))) { goto clean; } } int poly[3] = { 0x6D, 0x4F, 0x57 }; if (srslte_viterbi_init(&q->decoder, SRSLTE_VITERBI_37, poly, SRSLTE_DCI_MAX_BITS + 16, true)) { goto clean; } q->e = srslte_vec_malloc(sizeof(uint8_t) * q->max_bits); if (!q->e) { goto clean; } q->llr = srslte_vec_malloc(sizeof(float) * q->max_bits); if (!q->llr) { goto clean; } bzero(q->llr, sizeof(float) * q->max_bits); q->d = srslte_vec_malloc(sizeof(cf_t) * q->max_bits / 2); if (!q->d) { goto clean; } for (int i = 0; i < SRSLTE_MAX_PORTS; i++) { for (int j=0;jnof_rx_antennas;j++) { q->ce[i][j] = srslte_vec_malloc(sizeof(cf_t) * q->max_bits / 2); if (!q->ce[i][j]) { goto clean; } } q->x[i] = srslte_vec_malloc(sizeof(cf_t) * q->max_bits / 2); if (!q->x[i]) { goto clean; } } for (int j=0;jnof_rx_antennas;j++) { q->symbols[j] = srslte_vec_malloc(sizeof(cf_t) * q->max_bits / 2); if (!q->symbols[j]) { goto clean; } } ret = SRSLTE_SUCCESS; } clean: if (ret == SRSLTE_ERROR) { srslte_pdcch_free(q); } return ret; } void srslte_pdcch_free(srslte_pdcch_t *q) { if (q->e) { free(q->e); } if (q->llr) { free(q->llr); } if (q->d) { free(q->d); } for (int i = 0; i < SRSLTE_MAX_PORTS; i++) { for (int j=0;jnof_rx_antennas;j++) { if (q->ce[i][j]) { free(q->ce[i][j]); } } if (q->x[i]) { free(q->x[i]); } } for (int j=0;jnof_rx_antennas;j++) { if (q->symbols[j]) { free(q->symbols[j]); } } for (int i = 0; i < SRSLTE_NSUBFRAMES_X_FRAME; i++) { srslte_sequence_free(&q->seq[i]); } srslte_modem_table_free(&q->mod); srslte_viterbi_free(&q->decoder); bzero(q, sizeof(srslte_pdcch_t)); } uint32_t srslte_pdcch_ue_locations(srslte_pdcch_t *q, srslte_dci_location_t *c, uint32_t max_candidates, uint32_t nsubframe, uint32_t cfi, uint16_t rnti) { set_cfi(q, cfi); return srslte_pdcch_ue_locations_ncce(q->nof_cce, c, max_candidates, nsubframe, rnti); } /** 36.213 v9.1.1 * Computes up to max_candidates UE-specific candidates for DCI messages and saves them * in the structure pointed by c. * Returns the number of candidates saved in the array c. */ uint32_t srslte_pdcch_ue_locations_ncce(uint32_t nof_cce, srslte_dci_location_t *c, uint32_t max_candidates, uint32_t nsubframe, uint16_t rnti) { int l; // this must be int because of the for(;;--) loop uint32_t i, k, L, m; uint32_t Yk, ncce; const int S[4] = { 6, 12, 8, 16 }; // Compute Yk for this subframe Yk = rnti; for (m = 0; m < nsubframe+1; m++) { Yk = (39827 * Yk) % 65537; } k = 0; // All aggregation levels from 8 to 1 for (l = 3; l >= 0; l--) { L = (1 << l); // For all possible ncce offset for (i = 0; i < SRSLTE_MIN(nof_cce / L, S[l]/PDCCH_FORMAT_NOF_CCE(l)); i++) { if (nof_cce >= L) { ncce = L * ((Yk + i) % (nof_cce / L)); if (k < max_candidates && ncce + L <= nof_cce) { c[k].L = l; c[k].ncce = ncce; DEBUG("UE-specific SS Candidate %d: nCCE: %d, L: %d\n", k, c[k].ncce, c[k].L); k++; } } } } DEBUG("Initiated %d candidate(s) in the UE-specific search space for C-RNTI: 0x%x, nsubframe=%d, nof_cce=%d\n", k, rnti, nsubframe, nof_cce); return k; } /** * 36.213 9.1.1 * Computes up to max_candidates candidates in the common search space * for DCI messages and saves them in the structure pointed by c. * Returns the number of candidates saved in the array c. */ uint32_t srslte_pdcch_common_locations(srslte_pdcch_t *q, srslte_dci_location_t *c, uint32_t max_candidates, uint32_t cfi) { set_cfi(q, cfi); return srslte_pdcch_common_locations_ncce(q->nof_cce, c, max_candidates); } uint32_t srslte_pdcch_common_locations_ncce(uint32_t nof_cce, srslte_dci_location_t *c, uint32_t max_candidates) { uint32_t i, l, L, k; k = 0; for (l = 3; l > 1; l--) { L = (1 << l); for (i = 0; i < SRSLTE_MIN(nof_cce, 16) / (L); i++) { if (k < max_candidates) { c[k].L = l; c[k].ncce = (L) * (i % (nof_cce / (L))); DEBUG("Common SS Candidate %d: nCCE: %d, L: %d\n", k, c[k].ncce, c[k].L); k++; } } } INFO("Initiated %d candidate(s) in the Common search space\n", k); return k; } /** 36.212 5.3.3.2 to 5.3.3.4 * * Returns XOR between parity and remainder bits * * TODO: UE transmit antenna selection CRC mask */ int srslte_pdcch_dci_decode(srslte_pdcch_t *q, float *e, uint8_t *data, uint32_t E, uint32_t nof_bits, uint16_t *crc) { uint16_t p_bits, crc_res; uint8_t *x; if (q != NULL) { if (data != NULL && E <= q->max_bits && nof_bits <= SRSLTE_DCI_MAX_BITS) { bzero(q->rm_f, sizeof(float)*3 * (SRSLTE_DCI_MAX_BITS + 16)); uint32_t coded_len = 3 * (nof_bits + 16); /* unrate matching */ srslte_rm_conv_rx(e, E, q->rm_f, coded_len); /* viterbi decoder */ srslte_viterbi_decode_f(&q->decoder, q->rm_f, data, nof_bits + 16); x = &data[nof_bits]; p_bits = (uint16_t) srslte_bit_pack(&x, 16); crc_res = ((uint16_t) srslte_crc_checksum(&q->crc, data, nof_bits) & 0xffff); if (crc) { *crc = p_bits ^ crc_res; } return SRSLTE_SUCCESS; } else { fprintf(stderr, "Invalid parameters: E: %d, max_bits: %d, nof_bits: %d\n", E, q->max_bits, nof_bits); return SRSLTE_ERROR_INVALID_INPUTS; } } else { return SRSLTE_ERROR_INVALID_INPUTS; } } /** Tries to decode a DCI message from the LLRs stored in the srslte_pdcch_t structure by the function * srslte_pdcch_extract_llr(). This function can be called multiple times. * The decoded message is stored in msg and the CRC remainder in crc_rem pointer * */ int srslte_pdcch_decode_msg(srslte_pdcch_t *q, srslte_dci_msg_t *msg, srslte_dci_location_t *location, srslte_dci_format_t format, uint16_t *crc_rem) { int ret = SRSLTE_ERROR_INVALID_INPUTS; if (q != NULL && msg != NULL && srslte_dci_location_isvalid(location)) { if (location->ncce * 72 + PDCCH_FORMAT_NOF_BITS(location->L) > q->nof_cce*72) { fprintf(stderr, "Invalid location: nCCE: %d, L: %d, NofCCE: %d\n", location->ncce, location->L, q->nof_cce); } else { ret = SRSLTE_SUCCESS; uint32_t nof_bits = srslte_dci_format_sizeof(format, q->cell.nof_prb, q->cell.nof_ports); uint32_t e_bits = PDCCH_FORMAT_NOF_BITS(location->L); double mean = 0; for (int i=0;illr[location->ncce * 72 + i]); } mean /= e_bits; if (mean > 0.5) { ret = srslte_pdcch_dci_decode(q, &q->llr[location->ncce * 72], msg->data, e_bits, nof_bits, crc_rem); if (ret == SRSLTE_SUCCESS) { msg->nof_bits = nof_bits; // Check format differentiation if (format == SRSLTE_DCI_FORMAT0 || format == SRSLTE_DCI_FORMAT1A) { msg->format = (msg->data[0] == 0)?SRSLTE_DCI_FORMAT0:SRSLTE_DCI_FORMAT1A; } else { msg->format = format; } } else { fprintf(stderr, "Error calling pdcch_dci_decode\n"); } if (crc_rem) { DEBUG("Decoded DCI: nCCE=%d, L=%d, format=%s, msg_len=%d, mean=%f, crc_rem=0x%x\n", location->ncce, location->L, srslte_dci_format_string(format), nof_bits, mean, *crc_rem); } } else { DEBUG("Skipping DCI: nCCE=%d, L=%d, msg_len=%d, mean=%f\n", location->ncce, location->L, nof_bits, mean); } } } else { fprintf(stderr, "Invalid parameters, location=%d,%d\n", location->ncce, location->L); } return ret; } int cnt=0; int srslte_pdcch_extract_llr(srslte_pdcch_t *q, cf_t *sf_symbols, cf_t *ce[SRSLTE_MAX_PORTS], float noise_estimate, uint32_t nsubframe, uint32_t cfi) { cf_t *_sf_symbols[SRSLTE_MAX_PORTS]; cf_t *_ce[SRSLTE_MAX_PORTS][SRSLTE_MAX_PORTS]; _sf_symbols[0] = sf_symbols; for (int i=0;icell.nof_ports;i++) { _ce[i][0] = ce[i]; } return srslte_pdcch_extract_llr_multi(q, _sf_symbols, _ce, noise_estimate, nsubframe, cfi); } /** Extracts the LLRs from srslte_dci_location_t location of the subframe and stores them in the srslte_pdcch_t structure. * DCI messages can be extracted from this location calling the function srslte_pdcch_decode_msg(). * Every time this function is called (with a different location), the last demodulated symbols are overwritten and * new messages from other locations can be decoded */ int srslte_pdcch_extract_llr_multi(srslte_pdcch_t *q, cf_t *sf_symbols[SRSLTE_MAX_PORTS], cf_t *ce[SRSLTE_MAX_PORTS][SRSLTE_MAX_PORTS], float noise_estimate, uint32_t nsubframe, uint32_t cfi) { int ret = SRSLTE_ERROR_INVALID_INPUTS; /* Set pointers for layermapping & precoding */ uint32_t i, nof_symbols; cf_t *x[SRSLTE_MAX_LAYERS]; if (q != NULL && nsubframe < 10 && cfi > 0 && cfi < 4) { set_cfi(q, cfi); uint32_t e_bits = 72*q->nof_cce; nof_symbols = e_bits/2; ret = SRSLTE_ERROR; bzero(q->llr, sizeof(float) * q->max_bits); DEBUG("Extracting LLRs: E: %d, SF: %d, CFI: %d\n", e_bits, nsubframe, cfi); /* number of layers equals number of ports */ for (i = 0; i < q->cell.nof_ports; i++) { x[i] = q->x[i]; } memset(&x[q->cell.nof_ports], 0, sizeof(cf_t*) * (SRSLTE_MAX_LAYERS - q->cell.nof_ports)); /* extract symbols */ for (int j=0;jnof_rx_antennas;j++) { int n = srslte_regs_pdcch_get(q->regs, sf_symbols[j], q->symbols[j]); if (nof_symbols != n) { fprintf(stderr, "Expected %d PDCCH symbols but got %d symbols\n", nof_symbols, n); return ret; } /* extract channel estimates */ for (i = 0; i < q->cell.nof_ports; i++) { n = srslte_regs_pdcch_get(q->regs, ce[i][j], q->ce[i][j]); if (nof_symbols != n) { fprintf(stderr, "Expected %d PDCCH symbols but got %d symbols\n", nof_symbols, n); return ret; } } } /* in control channels, only diversity is supported */ if (q->cell.nof_ports == 1) { /* no need for layer demapping */ srslte_predecoding_single_multi(q->symbols, q->ce[0], q->d, q->nof_rx_antennas, nof_symbols, noise_estimate/2); } else { srslte_predecoding_diversity_multi(q->symbols, q->ce, x, q->nof_rx_antennas, q->cell.nof_ports, nof_symbols); srslte_layerdemap_diversity(x, q->d, q->cell.nof_ports, nof_symbols / q->cell.nof_ports); } /* demodulate symbols */ srslte_demod_soft_demodulate(SRSLTE_MOD_QPSK, q->d, q->llr, nof_symbols); /* descramble */ srslte_scrambling_f_offset(&q->seq[nsubframe], q->llr, 0, e_bits); ret = SRSLTE_SUCCESS; } return ret; } static void crc_set_mask_rnti(uint8_t *crc, uint16_t rnti) { uint32_t i; uint8_t mask[16]; uint8_t *r = mask; DEBUG("Mask CRC with RNTI 0x%x\n", rnti); srslte_bit_unpack(rnti, &r, 16); for (i = 0; i < 16; i++) { crc[i] = (crc[i] + mask[i]) % 2; } } void srslte_pdcch_dci_encode_conv(srslte_pdcch_t *q, uint8_t *data, uint32_t nof_bits, uint8_t *coded_data, uint16_t rnti) { srslte_convcoder_t encoder; int poly[3] = { 0x6D, 0x4F, 0x57 }; encoder.K = 7; encoder.R = 3; encoder.tail_biting = true; memcpy(encoder.poly, poly, 3 * sizeof(int)); srslte_crc_attach(&q->crc, data, nof_bits); crc_set_mask_rnti(&data[nof_bits], rnti); srslte_convcoder_encode(&encoder, data, coded_data, nof_bits + 16); } /** 36.212 5.3.3.2 to 5.3.3.4 * TODO: UE transmit antenna selection CRC mask */ int srslte_pdcch_dci_encode(srslte_pdcch_t *q, uint8_t *data, uint8_t *e, uint32_t nof_bits, uint32_t E, uint16_t rnti) { uint8_t tmp[3 * (SRSLTE_DCI_MAX_BITS + 16)]; if (q != NULL && data != NULL && e != NULL && nof_bits < SRSLTE_DCI_MAX_BITS && E < q->max_bits) { srslte_pdcch_dci_encode_conv(q, data, nof_bits, tmp, rnti); DEBUG("CConv output: ", 0); if (SRSLTE_VERBOSE_ISDEBUG()) { srslte_vec_fprint_b(stdout, tmp, 3 * (nof_bits + 16)); } srslte_rm_conv_tx(tmp, 3 * (nof_bits + 16), e, E); return SRSLTE_SUCCESS; } else { return SRSLTE_ERROR_INVALID_INPUTS; } } /** Encodes ONE DCI message and allocates the encoded bits to the srslte_dci_location_t indicated by * the parameter location. The CRC is scrambled with the RNTI parameter. * This function can be called multiple times and encoded DCI messages will be allocated to the * sf_symbols buffer ready for transmission. * If the same location is provided in multiple messages, the encoded bits will be overwritten. * * @TODO: Use a bitmask and CFI to ensure message locations are valid and old messages are not overwritten. */ int srslte_pdcch_encode(srslte_pdcch_t *q, srslte_dci_msg_t *msg, srslte_dci_location_t location, uint16_t rnti, cf_t *sf_symbols[SRSLTE_MAX_PORTS], uint32_t nsubframe, uint32_t cfi) { int ret = SRSLTE_ERROR_INVALID_INPUTS; uint32_t i; cf_t *x[SRSLTE_MAX_LAYERS]; uint32_t nof_symbols; if (q != NULL && sf_symbols != NULL && nsubframe < 10 && cfi > 0 && cfi < 4 && srslte_dci_location_isvalid(&location)) { set_cfi(q, cfi); uint32_t e_bits = PDCCH_FORMAT_NOF_BITS(location.L); nof_symbols = e_bits/2; ret = SRSLTE_ERROR; if (location.ncce + PDCCH_FORMAT_NOF_CCE(location.L) <= q->nof_cce && msg->nof_bits < SRSLTE_DCI_MAX_BITS - 16) { DEBUG("Encoding DCI: Nbits: %d, E: %d, nCCE: %d, L: %d, RNTI: 0x%x\n", msg->nof_bits, e_bits, location.ncce, location.L, rnti); srslte_pdcch_dci_encode(q, msg->data, q->e, msg->nof_bits, e_bits, rnti); /* number of layers equals number of ports */ for (i = 0; i < q->cell.nof_ports; i++) { x[i] = q->x[i]; } memset(&x[q->cell.nof_ports], 0, sizeof(cf_t*) * (SRSLTE_MAX_LAYERS - q->cell.nof_ports)); srslte_scrambling_b_offset(&q->seq[nsubframe], q->e, 72 * location.ncce, e_bits); DEBUG("Scrambling output: ", 0); if (SRSLTE_VERBOSE_ISDEBUG()) { srslte_vec_fprint_b(stdout, q->e, e_bits); } srslte_mod_modulate(&q->mod, q->e, q->d, e_bits); /* layer mapping & precoding */ if (q->cell.nof_ports > 1) { srslte_layermap_diversity(q->d, x, q->cell.nof_ports, nof_symbols); srslte_precoding_diversity(x, q->symbols, q->cell.nof_ports, nof_symbols / q->cell.nof_ports); } else { memcpy(q->symbols[0], q->d, nof_symbols * sizeof(cf_t)); } /* mapping to resource elements */ for (i = 0; i < q->cell.nof_ports; i++) { srslte_regs_pdcch_put_offset(q->regs, q->symbols[i], sf_symbols[i], location.ncce * 9, PDCCH_FORMAT_NOF_REGS(location.L)); } ret = SRSLTE_SUCCESS; } else { fprintf(stderr, "Illegal DCI message nCCE: %d, L: %d, nof_cce: %d, nof_bits=%d\n", location.ncce, location.L, q->nof_cce, msg->nof_bits); } } else { fprintf(stderr, "Invalid parameters: cfi=%d, L=%d, nCCE=%d\n", cfi, location.L, location.ncce); } return ret; }