srsLTE/srslte/lib/phch/src/dci.c

921 lines
27 KiB
C
Raw Normal View History

2014-04-17 03:28:21 -07:00
/**
*
* \section COPYRIGHT
*
2015-05-08 08:05:40 -07:00
* Copyright 2013-2015 The srsLTE Developers. See the
2014-04-17 03:28:21 -07:00
* COPYRIGHT file at the top-level directory of this distribution.
*
* \section LICENSE
*
* This file is part of the srsLTE library.
2014-04-17 03:28:21 -07:00
*
* srsLTE is free software: you can redistribute it and/or modify
2015-05-08 08:05:40 -07:00
* it under the terms of the GNU Affero General Public License as
2014-04-17 03:28:21 -07:00
* 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,
2014-04-17 03:28:21 -07:00
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
2015-05-08 08:05:40 -07:00
* GNU Affero General Public License for more details.
2014-04-17 03:28:21 -07:00
*
2015-05-08 08:05:40 -07:00
* A copy of the GNU Affero General Public License can be found in
2014-04-17 03:28:21 -07:00
* the LICENSE file in the top-level directory of this distribution
* and at http://www.gnu.org/licenses/.
*
*/
#include <stdint.h>
#include <stdio.h>
#include <string.h>
#include <strings.h>
#include <stdlib.h>
#include <stdbool.h>
#include <assert.h>
#include <math.h>
#include "srslte/phch/dci.h"
#include "srslte/common/phy_common.h"
#include "srslte/utils/bit.h"
#include "srslte/utils/vector.h"
#include "srslte/utils/debug.h"
2014-04-17 03:28:21 -07:00
#include "dci_sz_table.h"
2014-04-17 03:28:21 -07:00
/* Unpacks a DCI message and configures the DL grant object
*/
int srslte_dci_msg_to_dl_grant(srslte_dci_msg_t *msg, uint16_t msg_rnti,
uint32_t nof_prb,
srslte_ra_dl_dci_t *dl_dci,
srslte_ra_dl_grant_t *grant)
{
int ret = SRSLTE_ERROR_INVALID_INPUTS;
if (msg != NULL &&
grant != NULL)
{
ret = SRSLTE_ERROR;
2015-03-18 11:14:24 -07:00
srslte_dci_msg_type_t type;
if (srslte_dci_msg_get_type(msg, &type, nof_prb, msg_rnti)) {
fprintf(stderr, "Can't get DCI message type\n");
return ret;
}
2015-03-18 11:14:24 -07:00
if (SRSLTE_VERBOSE_ISINFO()) {
INFO("",0);
2015-03-18 11:14:24 -07:00
srslte_dci_msg_type_fprint(stdout, type);
}
2015-03-18 11:14:24 -07:00
if (type.type == SRSLTE_DCI_MSG_TYPE_PDSCH_SCHED) {
bzero(dl_dci, sizeof(srslte_ra_dl_dci_t));
bzero(grant, sizeof(srslte_ra_dl_grant_t));
bool crc_is_crnti = false;
2015-03-18 05:59:29 -07:00
if (msg_rnti >= SRSLTE_CRNTI_START && msg_rnti <= SRSLTE_CRNTI_END) {
crc_is_crnti = true;
}
if (srslte_dci_msg_unpack_pdsch(msg, dl_dci, nof_prb, crc_is_crnti)) {
2015-05-08 01:35:39 -07:00
fprintf(stderr, "Can't unpack DCI message\n");
return ret;
}
srslte_ra_dl_dci_to_grant(dl_dci, nof_prb, crc_is_crnti, grant);
2015-03-18 11:14:24 -07:00
if (SRSLTE_VERBOSE_ISINFO()) {
srslte_ra_pdsch_fprint(stdout, dl_dci, nof_prb);
srslte_ra_dl_grant_fprint(stdout, grant);
}
ret = SRSLTE_SUCCESS;
} else {
if (SRSLTE_VERBOSE_ISINFO()) {
fprintf(stderr, "Unsupported message type: ");
srslte_dci_msg_type_fprint(stderr, type);
}
}
}
return ret;
}
/* Creates the UL PUSCH resource allocation grant from the random access respone message
*/
int srslte_dci_rar_to_ul_grant(srslte_dci_rar_grant_t *rar, uint32_t nof_prb,
uint32_t n_rb_ho,
srslte_ra_ul_dci_t *ul_dci,
srslte_ra_ul_grant_t *grant)
{
bzero(ul_dci, sizeof(srslte_ra_ul_dci_t));
if (!rar->hopping_flag) {
ul_dci->freq_hop_fl = SRSLTE_RA_PUSCH_HOP_DISABLED;
} else {
fprintf(stderr, "FIXME: Frequency hopping in RAR not implemented\n");
ul_dci->freq_hop_fl = 1;
}
uint32_t riv = rar->rba;
// Truncate resource block assignment
uint32_t b = 0;
if (nof_prb <= 44) {
b = (uint32_t) (ceilf(log2((float) nof_prb*(nof_prb+1)/2)));
riv = riv & ((1<<(b+1))-1);
}
ul_dci->type2_alloc.riv = riv;
ul_dci->mcs_idx = rar->trunc_mcs;
srslte_ra_type2_from_riv(riv, &ul_dci->type2_alloc.L_crb, &ul_dci->type2_alloc.RB_start,
nof_prb, nof_prb);
if (srslte_ra_ul_dci_to_grant(ul_dci, nof_prb, n_rb_ho, grant)) {
fprintf(stderr, "Error computing resource allocation\n");
return SRSLTE_ERROR;
}
if (SRSLTE_VERBOSE_ISINFO()) {
srslte_ra_pusch_fprint(stdout, ul_dci, nof_prb);
srslte_ra_ul_grant_fprint(stdout, grant);
}
return SRSLTE_SUCCESS;
}
2015-05-08 01:35:39 -07:00
/* Unpack RAR UL grant as defined in Section 6.2 of 36.213 */
void srslte_dci_rar_grant_unpack(srslte_dci_rar_grant_t *rar, uint8_t grant[SRSLTE_RAR_GRANT_LEN])
{
uint8_t *grant_ptr = grant;
2015-09-14 01:20:12 -07:00
rar->hopping_flag = srslte_bit_pack(&grant_ptr, 1)?true:false;
rar->rba = srslte_bit_pack(&grant_ptr, 10);
rar->trunc_mcs = srslte_bit_pack(&grant_ptr, 4);
rar->tpc_pusch = srslte_bit_pack(&grant_ptr, 3);
rar->ul_delay = srslte_bit_pack(&grant_ptr, 1)?true:false;
rar->cqi_request = srslte_bit_pack(&grant_ptr, 1)?true:false;
2015-05-08 01:35:39 -07:00
}
2015-05-13 02:44:01 -07:00
void srslte_dci_rar_grant_fprint(FILE *stream, srslte_dci_rar_grant_t *rar) {
fprintf(stream, "RBA: %d, MCS: %d, TPC: %d, Hopping=%s, UL-Delay=%s, CQI=%s\n",
rar->rba, rar->trunc_mcs, rar->tpc_pusch,
rar->hopping_flag?"yes":"no",
rar->ul_delay?"yes":"no",
rar->cqi_request?"yes":"no"
);
}
/* Creates the UL PUSCH resource allocation grant from a DCI format 0 message
*/
int srslte_dci_msg_to_ul_grant(srslte_dci_msg_t *msg, uint32_t nof_prb,
uint32_t n_rb_ho,
srslte_ra_ul_dci_t *ul_dci,
srslte_ra_ul_grant_t *grant)
{
int ret = SRSLTE_ERROR_INVALID_INPUTS;
if (msg != NULL &&
2015-07-27 08:53:23 -07:00
ul_dci != NULL &&
grant != NULL)
{
ret = SRSLTE_ERROR;
bzero(ul_dci, sizeof(srslte_ra_ul_dci_t));
bzero(grant, sizeof(srslte_ra_ul_dci_t));
if (srslte_dci_msg_unpack_pusch(msg, ul_dci, nof_prb)) {
return ret;
}
if (srslte_ra_ul_dci_to_grant(ul_dci, nof_prb, n_rb_ho, grant)) {
fprintf(stderr, "Error computing resource allocation\n");
return ret;
}
if (SRSLTE_VERBOSE_ISINFO()) {
srslte_ra_pusch_fprint(stdout, ul_dci, nof_prb);
2015-07-27 08:53:23 -07:00
srslte_ra_ul_grant_fprint(stdout, grant);
}
ret = SRSLTE_SUCCESS;
}
return ret;
}
2015-03-18 11:14:24 -07:00
int srslte_dci_location_set(srslte_dci_location_t *c, uint32_t L, uint32_t nCCE) {
if (L <= 3) {
c->L = L;
2014-06-17 02:11:41 -07:00
} else {
fprintf(stderr, "Invalid L %d\n", L);
return SRSLTE_ERROR;
2014-06-17 02:11:41 -07:00
}
if (nCCE <= 87) {
c->ncce = nCCE;
2014-06-17 02:11:41 -07:00
} else {
fprintf(stderr, "Invalid nCCE %d\n", nCCE);
return SRSLTE_ERROR;
2014-06-17 02:11:41 -07:00
}
return SRSLTE_SUCCESS;
2014-04-17 03:28:21 -07:00
}
2015-03-18 11:14:24 -07:00
bool srslte_dci_location_isvalid(srslte_dci_location_t *c) {
if (c->L <= 3 && c->ncce <= 87) {
return true;
} else {
return false;
}
}
uint32_t riv_nbits(uint32_t nof_prb) {
return (uint32_t) ceilf(log2f((float) nof_prb * ((float) nof_prb + 1) / 2));
}
const uint32_t ambiguous_sizes[10] = { 12, 14, 16, 20, 24, 26, 32, 40, 44, 56 };
bool is_ambiguous_size(uint32_t size) {
2014-06-17 02:11:41 -07:00
int i;
2014-06-17 07:32:19 -07:00
for (i = 0; i < 10; i++) {
2014-06-17 02:11:41 -07:00
if (size == ambiguous_sizes[i]) {
return true;
}
}
return false;
}
/**********************************
* PAYLOAD sizeof functions
* ********************************/
uint32_t dci_format0_sizeof_(uint32_t nof_prb) {
2014-06-17 07:32:19 -07:00
return 1 + 1 + riv_nbits(nof_prb) + 5 + 1 + 2 + 3 + 1;
}
uint32_t dci_format1A_sizeof(uint32_t nof_prb) {
uint32_t n;
2014-06-17 07:32:19 -07:00
n = 1 + 1 + riv_nbits(nof_prb) + 5 + 3 + 1 + 2 + 2;
while (n < dci_format0_sizeof_(nof_prb)) {
2014-06-17 02:11:41 -07:00
n++;
}
if (is_ambiguous_size(n)) {
n++;
}
return n;
}
uint32_t dci_format0_sizeof(uint32_t nof_prb) {
uint32_t n = dci_format0_sizeof_(nof_prb);
2014-06-17 02:11:41 -07:00
while (n < dci_format1A_sizeof(nof_prb)) {
n++;
}
return n;
}
uint32_t dci_format1_sizeof(uint32_t nof_prb) {
2015-03-18 11:14:24 -07:00
uint32_t n = (uint32_t) ceilf((float) nof_prb / srslte_ra_type0_P(nof_prb)) + 5 + 3 + 1 + 2
2014-06-17 07:32:19 -07:00
+ 2;
2014-06-17 02:11:41 -07:00
if (nof_prb > 10) {
n++;
}
2014-06-17 07:32:19 -07:00
while (n == dci_format0_sizeof(nof_prb) || n == dci_format1A_sizeof(nof_prb)
2014-06-17 02:11:41 -07:00
|| is_ambiguous_size(n)) {
n++;
}
return n;
}
uint32_t dci_format1C_sizeof(uint32_t nof_prb) {
2015-03-18 11:14:24 -07:00
uint32_t n_vrb_dl_gap1 = srslte_ra_type2_n_vrb_dl(nof_prb, true);
uint32_t n_step = srslte_ra_type2_n_rb_step(nof_prb);
uint32_t n = riv_nbits((uint32_t) n_vrb_dl_gap1 / n_step) + 5;
2014-06-17 02:11:41 -07:00
if (nof_prb >= 50) {
n++;
}
return n;
}
2015-03-18 11:14:24 -07:00
uint32_t srslte_dci_format_sizeof(srslte_dci_format_t format, uint32_t nof_prb) {
2014-06-17 07:32:19 -07:00
switch (format) {
2015-03-18 11:14:24 -07:00
case SRSLTE_DCI_FORMAT0:
2014-06-17 02:11:41 -07:00
return dci_format0_sizeof(nof_prb);
2015-03-18 11:14:24 -07:00
case SRSLTE_DCI_FORMAT1:
2014-06-17 02:11:41 -07:00
return dci_format1_sizeof(nof_prb);
2015-03-18 11:14:24 -07:00
case SRSLTE_DCI_FORMAT1A:
2014-06-17 02:11:41 -07:00
return dci_format1A_sizeof(nof_prb);
2015-03-18 11:14:24 -07:00
case SRSLTE_DCI_FORMAT1C:
2014-06-17 02:11:41 -07:00
return dci_format1C_sizeof(nof_prb);
default:
return SRSLTE_ERROR;
2014-06-17 02:11:41 -07:00
}
}
uint32_t srslte_dci_format_sizeof_lut(srslte_dci_format_t format, uint32_t nof_prb) {
if (nof_prb <= 100 && format < 4) {
return dci_sz_table[nof_prb][format];
} else {
return 0;
}
}
/**********************************
* DCI Resource Allocation functions
* ********************************/
/* Packs DCI format 0 data to a sequence of bits and store them in msg according
* to 36.212 5.3.3.1.1
*
* TODO: TPC and cyclic shift for DM RS not implemented
*/
int dci_format0_pack(srslte_ra_ul_dci_t *data, srslte_dci_msg_t *msg, uint32_t nof_prb) {
2014-06-17 02:11:41 -07:00
/* pack bits */
2014-10-17 11:44:01 -07:00
uint8_t *y = msg->data;
uint32_t n_ul_hop;
2014-06-17 02:11:41 -07:00
*y++ = 0; // format differentiation
2015-03-18 11:14:24 -07:00
if (data->freq_hop_fl == SRSLTE_RA_PUSCH_HOP_DISABLED) { // frequency hopping
2014-06-17 02:11:41 -07:00
*y++ = 0;
n_ul_hop = 0;
} else {
*y++ = 1;
if (nof_prb < 50) {
n_ul_hop = 1; // Table 8.4-1 of 36.213
*y++ = data->freq_hop_fl & 1;
} else {
n_ul_hop = 2; // Table 8.4-1 of 36.213
*y++ = (data->freq_hop_fl & 2) >> 1;
*y++ = data->freq_hop_fl & 1;
}
}
/* pack RIV according to 8.1 of 36.213 */
uint32_t riv;
2014-06-17 02:11:41 -07:00
if (data->type2_alloc.L_crb) {
2015-03-18 11:14:24 -07:00
riv = srslte_ra_type2_to_riv(data->type2_alloc.L_crb, data->type2_alloc.RB_start,
2014-06-17 07:32:19 -07:00
nof_prb);
2014-06-17 02:11:41 -07:00
} else {
riv = data->type2_alloc.riv;
}
2015-09-14 01:20:12 -07:00
srslte_bit_unpack(riv, &y, riv_nbits(nof_prb) - n_ul_hop);
2014-06-17 02:11:41 -07:00
/* pack MCS according to 8.6.1 of 36.213 */
2015-09-14 01:20:12 -07:00
srslte_bit_unpack(data->mcs_idx, &y, 5);
2014-06-17 02:11:41 -07:00
*y++ = data->ndi;
// TCP commands not implemented
*y++ = 0;
*y++ = 0;
// DM RS not implemented
*y++ = 0;
*y++ = 0;
*y++ = 0;
// CQI request
*y++ = data->cqi_request;
// Padding with zeros
uint32_t n = srslte_dci_format_sizeof_lut(SRSLTE_DCI_FORMAT0, nof_prb);
2014-06-17 07:32:19 -07:00
while (y - msg->data < n) {
2014-06-17 02:11:41 -07:00
*y++ = 0;
}
msg->nof_bits = (y - msg->data);
return SRSLTE_SUCCESS;
2014-04-17 03:28:21 -07:00
}
/* Unpacks DCI format 0 data and store result in msg according
* to 36.212 5.3.3.1.1
*
* TODO: TPC and cyclic shift for DM RS not implemented
*/
int dci_format0_unpack(srslte_dci_msg_t *msg, srslte_ra_ul_dci_t *data, uint32_t nof_prb) {
2014-04-17 03:28:21 -07:00
2014-06-17 02:11:41 -07:00
/* pack bits */
2014-10-17 11:44:01 -07:00
uint8_t *y = msg->data;
uint32_t n_ul_hop;
2014-06-17 02:11:41 -07:00
2015-03-18 11:14:24 -07:00
/* Make sure it's a SRSLTE_DCI_FORMAT0 message */
if (msg->nof_bits != srslte_dci_format_sizeof_lut(SRSLTE_DCI_FORMAT0, nof_prb)) {
2014-06-17 02:11:41 -07:00
fprintf(stderr, "Invalid message length for format 0\n");
return SRSLTE_ERROR;
2014-06-17 02:11:41 -07:00
}
if (*y++ != 0) {
2015-05-13 02:44:01 -07:00
INFO("DCI message is Format1A\n", 0);
return SRSLTE_ERROR;
2014-06-17 02:11:41 -07:00
}
if (*y++ == 0) {
2015-03-18 11:14:24 -07:00
data->freq_hop_fl = SRSLTE_RA_PUSCH_HOP_DISABLED;
2014-06-17 02:11:41 -07:00
n_ul_hop = 0;
} else {
if (nof_prb < 50) {
n_ul_hop = 1; // Table 8.4-1 of 36.213
data->freq_hop_fl = *y++;
} else {
n_ul_hop = 2; // Table 8.4-1 of 36.213
2014-06-17 07:32:19 -07:00
data->freq_hop_fl = y[0] << 1 | y[1];
2014-06-17 02:11:41 -07:00
y += 2;
}
}
/* unpack RIV according to 8.1 of 36.213 */
2015-09-14 01:20:12 -07:00
uint32_t riv = srslte_bit_pack(&y, riv_nbits(nof_prb) - n_ul_hop);
2015-03-18 11:14:24 -07:00
srslte_ra_type2_from_riv(riv, &data->type2_alloc.L_crb, &data->type2_alloc.RB_start,
2014-06-17 07:32:19 -07:00
nof_prb, nof_prb);
2014-06-17 02:11:41 -07:00
data->type2_alloc.riv = riv;
/* unpack MCS according to 8.6 of 36.213 */
2015-09-14 01:20:12 -07:00
data->mcs_idx = srslte_bit_pack(&y, 5);
2014-06-17 02:11:41 -07:00
2014-06-17 07:32:19 -07:00
data->ndi = *y++ ? true : false;
2014-06-17 02:11:41 -07:00
// TPC command for scheduled PUSCH
2015-09-14 01:20:12 -07:00
data->tpc_pusch = srslte_bit_pack(&y, 2);
// Cyclic shift for DMRS
2015-09-14 01:20:12 -07:00
data->n_dmrs = srslte_bit_pack(&y, 3);
2014-06-17 02:11:41 -07:00
// CQI request
2014-06-17 07:32:19 -07:00
data->cqi_request = *y++ ? true : false;
2014-06-17 02:11:41 -07:00
return SRSLTE_SUCCESS;
}
/* Packs DCI format 1 data to a sequence of bits and store them in msg according
* to 36.212 5.3.3.1.2
*
* TODO: TPC commands
*/
int dci_format1_pack(srslte_ra_dl_dci_t *data, srslte_dci_msg_t *msg, uint32_t nof_prb) {
2014-06-17 02:11:41 -07:00
/* pack bits */
2014-10-17 11:44:01 -07:00
uint8_t *y = msg->data;
2014-06-17 02:11:41 -07:00
if (nof_prb > 10) {
*y++ = data->alloc_type;
}
/* Resource allocation: type0 or type 1 */
2015-03-18 11:14:24 -07:00
uint32_t P = srslte_ra_type0_P(nof_prb);
uint32_t alloc_size = (uint32_t) ceilf((float) nof_prb / P);
2014-06-17 07:32:19 -07:00
switch (data->alloc_type) {
2015-03-18 11:14:24 -07:00
case SRSLTE_RA_ALLOC_TYPE0:
2015-09-14 01:20:12 -07:00
srslte_bit_unpack((uint32_t) data->type0_alloc.rbg_bitmask, &y, alloc_size);
2014-06-17 02:11:41 -07:00
break;
2015-03-18 11:14:24 -07:00
case SRSLTE_RA_ALLOC_TYPE1:
2015-09-14 01:20:12 -07:00
srslte_bit_unpack((uint32_t) data->type1_alloc.rbg_subset, &y, (int) ceilf(log2f(P)));
2014-06-17 07:32:19 -07:00
*y++ = data->type1_alloc.shift ? 1 : 0;
2015-09-14 01:20:12 -07:00
srslte_bit_unpack((uint32_t) data->type1_alloc.vrb_bitmask, &y,
2014-06-17 07:32:19 -07:00
alloc_size - (int) ceilf(log2f(P)) - 1);
2014-06-17 02:11:41 -07:00
break;
default:
2014-06-17 07:32:19 -07:00
fprintf(stderr,
"Format 1 accepts type0 or type1 resource allocation only\n");
return SRSLTE_ERROR;
2014-06-17 02:11:41 -07:00
}
/* pack MCS */
2015-09-14 01:20:12 -07:00
srslte_bit_unpack(data->mcs_idx, &y, 5);
2014-06-17 02:11:41 -07:00
/* harq process number */
2015-09-14 01:20:12 -07:00
srslte_bit_unpack(data->harq_process, &y, 3);
2014-06-17 02:11:41 -07:00
*y++ = data->ndi;
// rv version
2015-09-14 01:20:12 -07:00
srslte_bit_unpack(data->rv_idx, &y, 2);
2014-06-17 02:11:41 -07:00
// TPC not implemented
*y++ = 0;
*y++ = 0;
// Padding with zeros
uint32_t n = srslte_dci_format_sizeof_lut(SRSLTE_DCI_FORMAT1, nof_prb);
2014-06-17 07:32:19 -07:00
while (y - msg->data < n) {
2014-06-17 02:11:41 -07:00
*y++ = 0;
}
msg->nof_bits = (y - msg->data);
2014-06-17 02:11:41 -07:00
return SRSLTE_SUCCESS;
}
int dci_format1_unpack(srslte_dci_msg_t *msg, srslte_ra_dl_dci_t *data, uint32_t nof_prb) {
2014-06-17 02:11:41 -07:00
/* pack bits */
2014-10-17 11:44:01 -07:00
uint8_t *y = msg->data;
2014-06-17 02:11:41 -07:00
2015-03-18 11:14:24 -07:00
/* Make sure it's a SRSLTE_DCI_FORMAT1 message */
if (msg->nof_bits != srslte_dci_format_sizeof_lut(SRSLTE_DCI_FORMAT1, nof_prb)) {
2014-06-17 02:11:41 -07:00
fprintf(stderr, "Invalid message length for format 1\n");
return SRSLTE_ERROR;
2014-06-17 02:11:41 -07:00
}
if (nof_prb > 10) {
data->alloc_type = *y++;
} else {
2015-03-18 11:14:24 -07:00
data->alloc_type = SRSLTE_RA_ALLOC_TYPE0;
2014-06-17 02:11:41 -07:00
}
/* Resource allocation: type0 or type 1 */
2015-03-18 11:14:24 -07:00
uint32_t P = srslte_ra_type0_P(nof_prb);
uint32_t alloc_size = (uint32_t) ceilf((float) nof_prb / P);
2014-06-17 07:32:19 -07:00
switch (data->alloc_type) {
2015-03-18 11:14:24 -07:00
case SRSLTE_RA_ALLOC_TYPE0:
2015-09-14 01:20:12 -07:00
data->type0_alloc.rbg_bitmask = srslte_bit_pack(&y, alloc_size);
2014-06-17 02:11:41 -07:00
break;
2015-03-18 11:14:24 -07:00
case SRSLTE_RA_ALLOC_TYPE1:
2015-09-14 01:20:12 -07:00
data->type1_alloc.rbg_subset = srslte_bit_pack(&y, (int) ceilf(log2f(P)));
2014-06-17 07:32:19 -07:00
data->type1_alloc.shift = *y++ ? true : false;
2015-09-14 01:20:12 -07:00
data->type1_alloc.vrb_bitmask = srslte_bit_pack(&y,
2014-06-17 07:32:19 -07:00
alloc_size - (int) ceilf(log2f(P)) - 1);
2014-06-17 02:11:41 -07:00
break;
default:
fprintf(stderr, "Format 1 accepts type0 or type1 resource allocation only\n");
return SRSLTE_ERROR;
2014-06-17 02:11:41 -07:00
}
/* unpack MCS according to 7.1.7 of 36.213 */
2015-09-14 01:20:12 -07:00
data->mcs_idx = srslte_bit_pack(&y, 5);
2014-06-17 02:11:41 -07:00
/* harq process number */
2015-09-14 01:20:12 -07:00
data->harq_process = srslte_bit_pack(&y, 3);
2014-06-17 02:11:41 -07:00
2014-06-17 07:32:19 -07:00
data->ndi = *y++ ? true : false;
2014-06-17 02:11:41 -07:00
// rv version
2015-09-14 01:20:12 -07:00
data->rv_idx = srslte_bit_pack(&y, 2);
2014-06-17 02:11:41 -07:00
// TPC not implemented
data->dci_format = SRSLTE_RA_DCI_FORMAT1;
2014-06-17 02:11:41 -07:00
return SRSLTE_SUCCESS;
2014-04-17 03:28:21 -07:00
}
/* Packs DCI format 1A for compact scheduling of PDSCH words according to 36.212 5.3.3.1.3
*
* TODO: RA procedure initiated by PDCCH, TPC commands
*/
int dci_format1As_pack(srslte_ra_dl_dci_t *data, srslte_dci_msg_t *msg, uint32_t nof_prb,
bool crc_is_crnti) {
2014-06-17 02:11:41 -07:00
/* pack bits */
2014-10-17 11:44:01 -07:00
uint8_t *y = msg->data;
2014-06-17 02:11:41 -07:00
*y++ = 1; // format differentiation
2015-03-18 11:14:24 -07:00
if (data->alloc_type != SRSLTE_RA_ALLOC_TYPE2) {
2014-06-17 02:11:41 -07:00
fprintf(stderr, "Format 1A accepts type2 resource allocation only\n");
return SRSLTE_ERROR;
2014-06-17 02:11:41 -07:00
}
*y++ = data->type2_alloc.mode; // localized or distributed VRB assignment
2015-03-18 11:14:24 -07:00
if (data->type2_alloc.mode == SRSLTE_RA_TYPE2_LOC) {
2014-06-17 02:11:41 -07:00
if (data->type2_alloc.L_crb > nof_prb) {
2014-06-17 07:32:19 -07:00
fprintf(stderr, "L_CRB=%d can not exceed system BW for localized type2\n",
data->type2_alloc.L_crb);
return SRSLTE_ERROR;
2014-06-17 02:11:41 -07:00
}
} else {
uint32_t n_vrb_dl;
if (crc_is_crnti && nof_prb > 50) {
2014-06-17 02:11:41 -07:00
n_vrb_dl = 16;
} else {
2015-03-18 11:14:24 -07:00
n_vrb_dl = srslte_ra_type2_n_vrb_dl(nof_prb, data->type2_alloc.n_gap == SRSLTE_RA_TYPE2_NG1);
2014-06-17 02:11:41 -07:00
}
if (data->type2_alloc.L_crb > n_vrb_dl) {
2014-06-17 07:32:19 -07:00
fprintf(stderr,
"L_CRB=%d can not exceed N_vrb_dl=%d for distributed type2\n",
data->type2_alloc.L_crb, n_vrb_dl);
return SRSLTE_ERROR;
2014-06-17 02:11:41 -07:00
}
}
/* pack RIV according to 7.1.6.3 of 36.213 */
uint32_t riv;
2014-06-17 02:11:41 -07:00
if (data->type2_alloc.L_crb) {
2015-03-18 11:14:24 -07:00
riv = srslte_ra_type2_to_riv(data->type2_alloc.L_crb, data->type2_alloc.RB_start,
2014-06-17 07:32:19 -07:00
nof_prb);
2014-06-17 02:11:41 -07:00
} else {
riv = data->type2_alloc.riv;
}
uint32_t nb_gap = 0;
if (crc_is_crnti && data->type2_alloc.mode == SRSLTE_RA_TYPE2_DIST && nof_prb >= 50) {
2014-06-17 02:11:41 -07:00
nb_gap = 1;
*y++ = data->type2_alloc.n_gap;
}
2015-09-14 01:20:12 -07:00
srslte_bit_unpack(riv, &y, riv_nbits(nof_prb) - nb_gap);
2014-06-17 02:11:41 -07:00
// in format1A, MCS = TBS according to 7.1.7.2 of 36.213
2015-09-14 01:20:12 -07:00
srslte_bit_unpack(data->mcs_idx, &y, 5);
2014-06-17 02:11:41 -07:00
2015-09-14 01:20:12 -07:00
srslte_bit_unpack(data->harq_process, &y, 3);
2014-06-17 02:11:41 -07:00
if (!crc_is_crnti && nof_prb >= 50 && data->type2_alloc.mode == SRSLTE_RA_TYPE2_DIST) {
2014-06-17 02:11:41 -07:00
*y++ = data->type2_alloc.n_gap;
} else {
y++; // bit reserved
}
// rv version
2015-09-14 01:20:12 -07:00
srslte_bit_unpack(data->rv_idx, &y, 2);
2014-06-17 02:11:41 -07:00
if (crc_is_crnti) {
2014-06-17 02:11:41 -07:00
// TPC not implemented
*y++ = 0;
*y++ = 0;
} else {
y++; // MSB of TPC is reserved
*y++ = data->type2_alloc.n_prb1a; // LSB indicates N_prb_1a for TBS
}
// Padding with zeros
uint32_t n = srslte_dci_format_sizeof_lut(SRSLTE_DCI_FORMAT1A, nof_prb);
2014-06-17 07:32:19 -07:00
while (y - msg->data < n) {
2014-06-17 02:11:41 -07:00
*y++ = 0;
}
msg->nof_bits = (y - msg->data);
2014-06-17 02:11:41 -07:00
return SRSLTE_SUCCESS;
2014-04-17 03:28:21 -07:00
}
/* Unpacks DCI format 1A for compact scheduling of PDSCH words according to 36.212 5.3.3.1.3
*
*/
int dci_format1As_unpack(srslte_dci_msg_t *msg, srslte_ra_dl_dci_t *data, uint32_t nof_prb,
bool crc_is_crnti) {
2014-06-17 02:11:41 -07:00
/* pack bits */
2014-10-17 11:44:01 -07:00
uint8_t *y = msg->data;
2014-06-17 02:11:41 -07:00
2015-03-18 11:14:24 -07:00
/* Make sure it's a SRSLTE_DCI_FORMAT0 message */
if (msg->nof_bits != srslte_dci_format_sizeof_lut(SRSLTE_DCI_FORMAT1A, nof_prb)) {
2014-06-17 02:11:41 -07:00
fprintf(stderr, "Invalid message length for format 1A\n");
return SRSLTE_ERROR;
2014-06-17 02:11:41 -07:00
}
2014-06-17 07:32:19 -07:00
2014-06-17 02:11:41 -07:00
if (*y++ != 1) {
2015-05-13 02:44:01 -07:00
INFO("DCI message is Format0\n", 0);
return SRSLTE_ERROR;
2014-06-17 02:11:41 -07:00
}
2015-03-18 11:14:24 -07:00
data->alloc_type = SRSLTE_RA_ALLOC_TYPE2;
2014-06-17 02:11:41 -07:00
data->type2_alloc.mode = *y++;
// by default, set N_gap to 1
2015-03-18 11:14:24 -07:00
data->type2_alloc.n_gap = SRSLTE_RA_TYPE2_NG1;
2014-06-17 02:11:41 -07:00
/* unpack RIV according to 7.1.6.3 of 36.213 */
uint32_t nb_gap = 0;
if (crc_is_crnti && data->type2_alloc.mode == SRSLTE_RA_TYPE2_DIST && nof_prb >= 50) {
2014-06-17 02:11:41 -07:00
nb_gap = 1;
data->type2_alloc.n_gap = *y++;
}
uint32_t nof_vrb;
2015-03-18 11:14:24 -07:00
if (data->type2_alloc.mode == SRSLTE_RA_TYPE2_LOC) {
2014-06-17 02:11:41 -07:00
nof_vrb = nof_prb;
} else {
2015-03-18 11:14:24 -07:00
nof_vrb = srslte_ra_type2_n_vrb_dl(nof_prb, data->type2_alloc.n_gap == SRSLTE_RA_TYPE2_NG1);
2014-06-17 02:11:41 -07:00
}
2015-09-14 01:20:12 -07:00
uint32_t riv = srslte_bit_pack(&y, riv_nbits(nof_prb) - nb_gap);
2015-03-18 11:14:24 -07:00
srslte_ra_type2_from_riv(riv, &data->type2_alloc.L_crb, &data->type2_alloc.RB_start,
2014-06-17 07:32:19 -07:00
nof_prb, nof_vrb);
2014-06-17 02:11:41 -07:00
data->type2_alloc.riv = riv;
// unpack MCS
2015-09-14 01:20:12 -07:00
data->mcs_idx = srslte_bit_pack(&y, 5);
2014-06-17 02:11:41 -07:00
2015-09-14 01:20:12 -07:00
data->harq_process = srslte_bit_pack(&y, 3);
2014-06-17 02:11:41 -07:00
if (!crc_is_crnti) {
if (nof_prb >= 50 && data->type2_alloc.mode == SRSLTE_RA_TYPE2_DIST) {
data->type2_alloc.n_gap = *y++;
} else {
y++; // NDI reserved
}
2014-06-17 02:11:41 -07:00
} else {
data->ndi = *y++ ? true : false;
2014-06-17 02:11:41 -07:00
}
// rv version
2015-09-14 01:20:12 -07:00
data->rv_idx = srslte_bit_pack(&y, 2);
if (crc_is_crnti) {
2014-06-17 02:11:41 -07:00
// TPC not implemented
y++;
y++;
} else {
y++; // MSB of TPC is reserved
2014-06-17 07:32:19 -07:00
data->type2_alloc.n_prb1a = *y++; // LSB indicates N_prb_1a for TBS
2014-06-17 02:11:41 -07:00
}
data->dci_format = SRSLTE_RA_DCI_FORMAT1A;
2014-06-17 02:11:41 -07:00
return SRSLTE_SUCCESS;
2014-04-17 03:28:21 -07:00
}
/* Format 1C for compact scheduling of PDSCH words
*
*/
int dci_format1Cs_pack(srslte_ra_dl_dci_t *data, srslte_dci_msg_t *msg, uint32_t nof_prb) {
2014-06-17 02:11:41 -07:00
/* pack bits */
2014-10-17 11:44:01 -07:00
uint8_t *y = msg->data;
2014-06-17 02:11:41 -07:00
2015-03-18 11:14:24 -07:00
if (data->alloc_type != SRSLTE_RA_ALLOC_TYPE2 || data->type2_alloc.mode != SRSLTE_RA_TYPE2_DIST) {
2014-06-17 07:32:19 -07:00
fprintf(stderr,
"Format 1C accepts distributed type2 resource allocation only\n");
return SRSLTE_ERROR;
2014-06-17 02:11:41 -07:00
}
if (nof_prb >= 50) {
*y++ = data->type2_alloc.n_gap;
}
2015-03-18 11:14:24 -07:00
uint32_t n_step = srslte_ra_type2_n_rb_step(nof_prb);
uint32_t n_vrb_dl = srslte_ra_type2_n_vrb_dl(nof_prb, data->type2_alloc.n_gap == SRSLTE_RA_TYPE2_NG1);
2014-06-17 02:11:41 -07:00
if (data->type2_alloc.L_crb > ((uint32_t) n_vrb_dl / n_step) * n_step) {
fprintf(stderr, "L_CRB=%d can not exceed N_vrb_dl=%d for distributed type2\n",
data->type2_alloc.L_crb, ((uint32_t) n_vrb_dl / n_step) * n_step);
return SRSLTE_ERROR;
2014-06-17 02:11:41 -07:00
}
if (data->type2_alloc.L_crb % n_step) {
fprintf(stderr, "L_crb must be multiple of n_step\n");
return SRSLTE_ERROR;
2014-06-17 02:11:41 -07:00
}
if (data->type2_alloc.RB_start % n_step) {
fprintf(stderr, "RB_start must be multiple of n_step\n");
return SRSLTE_ERROR;
2014-06-17 02:11:41 -07:00
}
uint32_t L_p = data->type2_alloc.L_crb / n_step;
uint32_t RB_p = data->type2_alloc.RB_start / n_step;
uint32_t n_vrb_p = (int) n_vrb_dl / n_step;
2014-06-17 02:11:41 -07:00
uint32_t riv;
2014-06-17 02:11:41 -07:00
if (data->type2_alloc.L_crb) {
2015-03-18 11:14:24 -07:00
riv = srslte_ra_type2_to_riv(L_p, RB_p, n_vrb_p);
2014-06-17 02:11:41 -07:00
} else {
riv = data->type2_alloc.riv;
}
2015-09-14 01:20:12 -07:00
srslte_bit_unpack(riv, &y, riv_nbits((int) n_vrb_dl / n_step));
2014-06-17 02:11:41 -07:00
// in format1C, MCS = TBS according to 7.1.7.2 of 36.213
2015-09-14 01:20:12 -07:00
srslte_bit_unpack(data->mcs_idx, &y, 5);
2014-06-17 02:11:41 -07:00
msg->nof_bits = (y - msg->data);
2014-06-17 02:11:41 -07:00
return SRSLTE_SUCCESS;
}
int dci_format1Cs_unpack(srslte_dci_msg_t *msg, srslte_ra_dl_dci_t *data, uint32_t nof_prb) {
uint32_t L_p, RB_p;
2014-06-17 02:11:41 -07:00
/* pack bits */
2014-10-17 11:44:01 -07:00
uint8_t *y = msg->data;
2014-06-17 02:11:41 -07:00
if (msg->nof_bits != srslte_dci_format_sizeof_lut(SRSLTE_DCI_FORMAT1C, nof_prb)) {
2014-06-17 02:11:41 -07:00
fprintf(stderr, "Invalid message length for format 1C\n");
return SRSLTE_ERROR;
2014-06-17 02:11:41 -07:00
}
2015-03-18 11:14:24 -07:00
data->alloc_type = SRSLTE_RA_ALLOC_TYPE2;
data->type2_alloc.mode = SRSLTE_RA_TYPE2_DIST;
2014-06-17 02:11:41 -07:00
if (nof_prb >= 50) {
data->type2_alloc.n_gap = *y++;
}
2015-03-18 11:14:24 -07:00
uint32_t n_step = srslte_ra_type2_n_rb_step(nof_prb);
uint32_t n_vrb_dl = srslte_ra_type2_n_vrb_dl(nof_prb, data->type2_alloc.n_gap == SRSLTE_RA_TYPE2_NG1);
2014-06-17 02:11:41 -07:00
2015-09-14 01:20:12 -07:00
uint32_t riv = srslte_bit_pack(&y, riv_nbits((int) n_vrb_dl / n_step));
uint32_t n_vrb_p = (uint32_t) n_vrb_dl / n_step;
2014-06-17 02:11:41 -07:00
2015-03-18 11:14:24 -07:00
srslte_ra_type2_from_riv(riv, &L_p, &RB_p, n_vrb_p, n_vrb_p);
2014-06-17 02:11:41 -07:00
data->type2_alloc.L_crb = L_p * n_step;
data->type2_alloc.RB_start = RB_p * n_step;
data->type2_alloc.riv = riv;
2015-09-14 01:20:12 -07:00
data->mcs_idx = srslte_bit_pack(&y, 5);
data->dci_format = SRSLTE_RA_DCI_FORMAT1C;
msg->nof_bits = (y - msg->data);
2014-06-17 02:11:41 -07:00
return SRSLTE_SUCCESS;
}
int srslte_dci_msg_pack_pdsch(srslte_ra_dl_dci_t *data, srslte_dci_msg_t *msg, srslte_dci_format_t format,
uint32_t nof_prb, bool crc_is_crnti) {
2014-06-17 07:32:19 -07:00
switch (format) {
2015-03-18 11:14:24 -07:00
case SRSLTE_DCI_FORMAT1:
2014-06-17 02:11:41 -07:00
return dci_format1_pack(data, msg, nof_prb);
2015-03-18 11:14:24 -07:00
case SRSLTE_DCI_FORMAT1A:
return dci_format1As_pack(data, msg, nof_prb, crc_is_crnti);
2015-03-18 11:14:24 -07:00
case SRSLTE_DCI_FORMAT1C:
2014-06-17 02:11:41 -07:00
return dci_format1Cs_pack(data, msg, nof_prb);
default:
2014-06-17 07:32:19 -07:00
fprintf(stderr, "Invalid DCI format %s for PDSCH resource allocation\n",
2015-03-18 11:14:24 -07:00
srslte_dci_format_string(format));
return SRSLTE_ERROR;
2014-06-17 02:11:41 -07:00
}
}
int srslte_dci_msg_unpack_pdsch(srslte_dci_msg_t *msg, srslte_ra_dl_dci_t *data, uint32_t nof_prb,
bool crc_is_crnti) {
if (msg->nof_bits == srslte_dci_format_sizeof_lut(SRSLTE_DCI_FORMAT1, nof_prb)) {
2014-06-17 02:11:41 -07:00
return dci_format1_unpack(msg, data, nof_prb);
} else if (msg->nof_bits == srslte_dci_format_sizeof_lut(SRSLTE_DCI_FORMAT1A, nof_prb)) {
return dci_format1As_unpack(msg, data, nof_prb, crc_is_crnti);
} else if (msg->nof_bits == srslte_dci_format_sizeof_lut(SRSLTE_DCI_FORMAT1C, nof_prb)) {
2014-06-17 02:11:41 -07:00
return dci_format1Cs_unpack(msg, data, nof_prb);
} else {
return SRSLTE_ERROR;
2014-06-17 02:11:41 -07:00
}
2014-04-17 03:28:21 -07:00
}
int srslte_dci_msg_pack_pusch(srslte_ra_ul_dci_t *data, srslte_dci_msg_t *msg, uint32_t nof_prb) {
2014-06-17 02:11:41 -07:00
return dci_format0_pack(data, msg, nof_prb);
}
int srslte_dci_msg_unpack_pusch(srslte_dci_msg_t *msg, srslte_ra_ul_dci_t *data, uint32_t nof_prb) {
2014-06-17 02:11:41 -07:00
return dci_format0_unpack(msg, data, nof_prb);
}
2015-03-18 11:14:24 -07:00
srslte_dci_format_t srslte_dci_format_from_string(char *str) {
if (!strcmp(str, "Format0")) {
2015-03-18 11:14:24 -07:00
return SRSLTE_DCI_FORMAT0;
} else if (!strcmp(str, "Format1")) {
2015-03-18 11:14:24 -07:00
return SRSLTE_DCI_FORMAT1;
} else if (!strcmp(str, "Format1A")) {
2015-03-18 11:14:24 -07:00
return SRSLTE_DCI_FORMAT1A;
} else if (!strcmp(str, "Format1C")) {
2015-03-18 11:14:24 -07:00
return SRSLTE_DCI_FORMAT1C;
} else {
2015-03-18 11:14:24 -07:00
return SRSLTE_DCI_FORMAT_ERROR;
}
}
2015-03-18 11:14:24 -07:00
char* srslte_dci_format_string(srslte_dci_format_t format) {
2014-06-17 07:32:19 -07:00
switch (format) {
2015-03-18 11:14:24 -07:00
case SRSLTE_DCI_FORMAT0:
return "Format0";
2015-03-18 11:14:24 -07:00
case SRSLTE_DCI_FORMAT1:
return "Format1";
2015-03-18 11:14:24 -07:00
case SRSLTE_DCI_FORMAT1A:
return "Format1A";
2015-03-18 11:14:24 -07:00
case SRSLTE_DCI_FORMAT1C:
return "Format1C";
2014-06-17 02:11:41 -07:00
default:
return "N/A"; // fatal error
}
}
2015-03-18 11:14:24 -07:00
void srslte_dci_msg_type_fprint(FILE *f, srslte_dci_msg_type_t type) {
2014-06-17 07:32:19 -07:00
switch (type.type) {
2015-03-18 11:14:24 -07:00
case SRSLTE_DCI_MSG_TYPE_PUSCH_SCHED:
fprintf(f, "%s PUSCH Scheduling\n", srslte_dci_format_string(type.format));
2014-06-17 02:11:41 -07:00
break;
2015-03-18 11:14:24 -07:00
case SRSLTE_DCI_MSG_TYPE_PDSCH_SCHED:
fprintf(f, "%s PDSCH Scheduling\n", srslte_dci_format_string(type.format));
2014-06-17 02:11:41 -07:00
break;
2015-03-18 11:14:24 -07:00
case SRSLTE_DCI_MSG_TYPE_RA_PROC_PDCCH:
2014-06-17 07:32:19 -07:00
fprintf(f, "%s Random access initiated by PDCCH\n",
2015-03-18 11:14:24 -07:00
srslte_dci_format_string(type.format));
2014-06-17 02:11:41 -07:00
break;
2015-03-18 11:14:24 -07:00
case SRSLTE_DCI_MSG_TYPE_MCCH_CHANGE:
fprintf(f, "%s MCCH change notification\n", srslte_dci_format_string(type.format));
2014-06-17 02:11:41 -07:00
break;
2015-03-18 11:14:24 -07:00
case SRSLTE_DCI_MSG_TYPE_TPC_COMMAND:
fprintf(f, "%s TPC command\n", srslte_dci_format_string(type.format));
2014-06-17 02:11:41 -07:00
break;
}
}
2015-03-18 11:14:24 -07:00
int srslte_dci_msg_get_type(srslte_dci_msg_t *msg, srslte_dci_msg_type_t *type, uint32_t nof_prb,
uint16_t msg_rnti)
{
DEBUG("Get message type: nof_bits=%d, msg_rnti=0x%x\n", msg->nof_bits, msg_rnti);
if (msg->nof_bits == srslte_dci_format_sizeof_lut(SRSLTE_DCI_FORMAT0, nof_prb)
2014-06-17 02:11:41 -07:00
&& !msg->data[0]) {
2015-03-18 11:14:24 -07:00
type->type = SRSLTE_DCI_MSG_TYPE_PUSCH_SCHED;
type->format = SRSLTE_DCI_FORMAT0;
return SRSLTE_SUCCESS;
} else if (msg->nof_bits == srslte_dci_format_sizeof_lut(SRSLTE_DCI_FORMAT1, nof_prb)) {
2015-03-18 11:14:24 -07:00
type->type = SRSLTE_DCI_MSG_TYPE_PDSCH_SCHED; // only these 2 types supported
type->format = SRSLTE_DCI_FORMAT1;
return SRSLTE_SUCCESS;
} else if (msg->nof_bits == srslte_dci_format_sizeof_lut(SRSLTE_DCI_FORMAT1A, nof_prb)) {
2015-03-17 10:26:23 -07:00
/* The RNTI is not the only condition. Also some fields in the packet.
2015-03-18 05:59:29 -07:00
* if (msg_rnti >= SRSLTE_CRNTI_START && msg_rnti <= SRSLTE_CRNTI_END) {
2015-03-18 11:14:24 -07:00
type->type = SRSLTE_DCI_MSG_TYPE_RA_PROC_PDCCH;
type->format = SRSLTE_DCI_FORMAT1A;
2014-06-17 02:11:41 -07:00
} else {
2015-03-17 10:26:23 -07:00
*/
2015-03-18 11:14:24 -07:00
type->type = SRSLTE_DCI_MSG_TYPE_PDSCH_SCHED; // only these 2 types supported
type->format = SRSLTE_DCI_FORMAT1A;
2015-03-17 10:26:23 -07:00
//}
return SRSLTE_SUCCESS;
} else if (msg->nof_bits == srslte_dci_format_sizeof_lut(SRSLTE_DCI_FORMAT1C, nof_prb)) {
2015-03-18 05:59:29 -07:00
if (msg_rnti == SRSLTE_MRNTI) {
2015-03-18 11:14:24 -07:00
type->type = SRSLTE_DCI_MSG_TYPE_MCCH_CHANGE;
type->format = SRSLTE_DCI_FORMAT1C;
2014-06-17 02:11:41 -07:00
} else {
2015-03-18 11:14:24 -07:00
type->type = SRSLTE_DCI_MSG_TYPE_PDSCH_SCHED; // only these 2 types supported
type->format = SRSLTE_DCI_FORMAT1C;
2014-06-17 02:11:41 -07:00
}
return SRSLTE_SUCCESS;
2014-06-17 02:11:41 -07:00
}
return SRSLTE_ERROR;
}