You cannot select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

112 lines
3.2 KiB
C

/**
* Copyright 2013-2023 Software Radio Systems Limited
*
* This file is part of srsRAN.
*
* srsRAN 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.
*
* srsRAN 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/.
*
*/
#ifndef SRSRAN_SCI_H
#define SRSRAN_SCI_H
#include <stdbool.h>
#include <stdint.h>
#include "srsran/config.h"
#include "srsran/phy/common/phy_common_sl.h"
#define SRSRAN_SCI_MSG_MAX_LEN 80
#define SRSRAN_SCI_CRC_LEN (16)
#define SRSRAN_SCI_MAX_LEN (45)
#define SRSRAN_SCI_TM34_LEN (32)
typedef enum { SRSRAN_SCI_FORMAT0 = 0, SRSRAN_SCI_FORMAT1 } srsran_sci_format_t;
/**
* Sidelink Control Information - Sidelink (SCI0 and SCI1).
*
* \brief SCI0/1 packing/unpacking functions to convert between bit streams
*
* Reference: 3GPP TS 36.212 version 15.6.0 Release 15 Section 5.4.3
*/
typedef struct SRSRAN_API {
srsran_sl_tm_t tm;
uint32_t sci_len;
uint32_t nof_prb;
srsran_sci_format_t format;
// sizeSubChannel
uint32_t size_sub_channel;
// numSubChannel
uint32_t num_sub_channel;
///< SCI Format 0: Resource block assignment and hopping resource allocation
///< SCI Format 1: Frequency resource location (0,3,6,7,8 bits)
uint32_t riv;
// Modulation and coding scheme (bits);
uint32_t mcs_idx;
///< SCI Format 0
// Frequency hopping flag (1 bit)
bool freq_hopping_flag;
uint32_t hopping_bits;
// TRP - Time resource pattern (7bits)
uint32_t trp_idx;
// Timing advance indication (11 bits)
uint32_t timing_advance;
// Group ID (8 bits)
uint32_t N_sa_id;
///< SCI Format 1
// Priority (3bits)
uint32_t priority;
// Resource reservation (4 bits)
uint32_t resource_reserv;
// Time gap (4 bits)
uint32_t time_gap;
// Retransmission index (1 bit)
bool retransmission;
// Transmission format (1 bit)
// 1 means transmission format including rate-matching and TBS scaling
// 0 means transmission format including puncturing and no TBS-scaling
uint32_t transmission_format;
} srsran_sci_t;
SRSRAN_API int srsran_sci_init(srsran_sci_t* q,
const srsran_cell_sl_t* cell,
const srsran_sl_comm_resource_pool_t* sl_comm_resource_pool);
SRSRAN_API int srsran_sci_format0_pack(srsran_sci_t* q, uint8_t* output);
SRSRAN_API int srsran_sci_format1_pack(srsran_sci_t* q, uint8_t* output);
SRSRAN_API int srsran_sci_format0_unpack(srsran_sci_t* q, uint8_t* input);
SRSRAN_API int srsran_sci_format1_unpack(srsran_sci_t* q, uint8_t* input);
SRSRAN_API void srsran_sci_info(const srsran_sci_t* sci, char* str, uint32_t len);
SRSRAN_API void srsran_sci_free(srsran_sci_t* q);
#endif // SRSRAN_SCI_H