Ivan Kluchnikov | 8ee6051 | 2012-03-05 19:24:57 +0400 | [diff] [blame] | 1 | /* pcu_l1_if.h |
Ivan Kluchnikov | 5c2f9fb | 2012-02-05 02:27:17 +0400 | [diff] [blame] | 2 | * |
Ivan Kluchnikov | 8ee6051 | 2012-03-05 19:24:57 +0400 | [diff] [blame] | 3 | * Copyright (C) 2012 Ivan Klyuchnikov |
Ivan Kluchnikov | 5c2f9fb | 2012-02-05 02:27:17 +0400 | [diff] [blame] | 4 | * |
| 5 | * This program is free software; you can redistribute it and/or |
| 6 | * modify it under the terms of the GNU General Public License |
| 7 | * as published by the Free Software Foundation; either version 2 |
| 8 | * of the License, or (at your option) any later version. |
| 9 | * |
| 10 | * This program is distributed in the hope that it will be useful, |
| 11 | * but WITHOUT ANY WARRANTY; without even the implied warranty of |
| 12 | * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the |
| 13 | * GNU General Public License for more details. |
| 14 | * |
| 15 | * You should have received a copy of the GNU General Public License |
| 16 | * along with this program; if not, write to the Free Software |
| 17 | * Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA. |
| 18 | */ |
| 19 | |
Ivan Kluchnikov | 8ee6051 | 2012-03-05 19:24:57 +0400 | [diff] [blame] | 20 | #ifndef PCU_L1_IF_H |
| 21 | #define PCU_L1_IF_H |
Ivan Kluchnikov | 5c2f9fb | 2012-02-05 02:27:17 +0400 | [diff] [blame] | 22 | |
Andreas Eversberg | 0aed654 | 2012-06-23 10:33:16 +0200 | [diff] [blame] | 23 | #include <stdint.h> |
Andreas Eversberg | a23c7ee | 2012-12-18 10:47:28 +0100 | [diff] [blame] | 24 | #ifdef __cplusplus |
Ivan Kluchnikov | e3a0596 | 2012-03-18 15:48:51 +0400 | [diff] [blame] | 25 | extern "C" { |
Andreas Eversberg | a23c7ee | 2012-12-18 10:47:28 +0100 | [diff] [blame] | 26 | #endif |
Ivan Kluchnikov | e3a0596 | 2012-03-18 15:48:51 +0400 | [diff] [blame] | 27 | #include <osmocom/core/write_queue.h> |
| 28 | #include <osmocom/core/socket.h> |
| 29 | #include <osmocom/core/timer.h> |
Andreas Eversberg | 0aed654 | 2012-06-23 10:33:16 +0200 | [diff] [blame] | 30 | #include <osmocom/core/bitvec.h> |
Ivan Kluchnikov | e3a0596 | 2012-03-18 15:48:51 +0400 | [diff] [blame] | 31 | #include <osmocom/gsm/gsm_utils.h> |
Max | 0a8fae8 | 2017-03-08 18:53:30 +0100 | [diff] [blame] | 32 | #include <osmocom/pcu/pcuif_proto.h> |
Andreas Eversberg | a23c7ee | 2012-12-18 10:47:28 +0100 | [diff] [blame] | 33 | #ifdef __cplusplus |
Ivan Kluchnikov | e3a0596 | 2012-03-18 15:48:51 +0400 | [diff] [blame] | 34 | } |
Jacob Erlbeck | 20f6fd1 | 2015-06-08 11:05:45 +0200 | [diff] [blame] | 35 | #endif |
Ivan Kluchnikov | e3a0596 | 2012-03-18 15:48:51 +0400 | [diff] [blame] | 36 | |
Pau Espin Pedrol | c1f31c4 | 2021-03-09 14:50:14 +0100 | [diff] [blame] | 37 | #include "pdch.h" |
| 38 | |
Max | d71e8b3 | 2016-09-19 16:17:06 +0200 | [diff] [blame] | 39 | static inline uint8_t qta2ta(int16_t qta) |
| 40 | { |
| 41 | if (qta < 0) |
| 42 | return 0; |
| 43 | if (qta > 252) |
| 44 | qta = 252; |
| 45 | return qta >> 2; |
| 46 | } |
| 47 | |
Minh-Quang Nguyen | 1bcfa9a | 2017-11-01 14:41:37 -0400 | [diff] [blame] | 48 | static inline int8_t sign_qta2ta(int16_t qta) |
| 49 | { |
| 50 | int8_t ta_adj = 0; |
| 51 | |
| 52 | if (qta < -252) |
| 53 | qta = -252; |
| 54 | |
| 55 | if (qta > 252) |
| 56 | qta = 252; |
| 57 | |
| 58 | /* 1-bit TA adjustment if TA error reported by L1 is outside +/- 2 qbits */ |
| 59 | if (qta > 2) |
| 60 | ta_adj = 1; |
| 61 | if (qta < -2) |
| 62 | ta_adj = -1; |
| 63 | |
| 64 | return (qta >> 2) + ta_adj; |
| 65 | } |
| 66 | |
| 67 | static inline uint8_t ta_limit(int16_t ta) |
| 68 | { |
| 69 | if (ta < 0) |
| 70 | ta = 0; |
| 71 | if (ta > 63) |
| 72 | ta = 63; |
| 73 | return ta; |
| 74 | } |
| 75 | |
Jacob Erlbeck | 20f6fd1 | 2015-06-08 11:05:45 +0200 | [diff] [blame] | 76 | /* |
| 77 | * L1 Measurement values |
| 78 | */ |
| 79 | |
Jacob Erlbeck | 51b1151 | 2015-06-11 16:54:50 +0200 | [diff] [blame] | 80 | struct pcu_l1_meas_ts { |
| 81 | unsigned have_ms_i_level:1; |
| 82 | |
| 83 | int16_t ms_i_level; /* I_LEVEL in dB */ |
Jacob Erlbeck | 51b1151 | 2015-06-11 16:54:50 +0200 | [diff] [blame] | 84 | }; |
| 85 | |
Pau Espin Pedrol | da971ee | 2020-12-16 15:59:45 +0100 | [diff] [blame] | 86 | static inline void pcu_l1_meas_ts_set_ms_i_level(struct pcu_l1_meas_ts* ts, int16_t v) { |
| 87 | ts->ms_i_level = v; |
| 88 | ts->have_ms_i_level = 1; |
| 89 | } |
| 90 | |
Jacob Erlbeck | 20f6fd1 | 2015-06-08 11:05:45 +0200 | [diff] [blame] | 91 | struct pcu_l1_meas { |
| 92 | unsigned have_rssi:1; |
| 93 | unsigned have_ber:1; |
| 94 | unsigned have_bto:1; |
| 95 | unsigned have_link_qual:1; |
Jacob Erlbeck | 51b1151 | 2015-06-11 16:54:50 +0200 | [diff] [blame] | 96 | unsigned have_ms_rx_qual:1; |
| 97 | unsigned have_ms_c_value:1; |
| 98 | unsigned have_ms_sign_var:1; |
| 99 | unsigned have_ms_i_level:1; |
Jacob Erlbeck | 20f6fd1 | 2015-06-08 11:05:45 +0200 | [diff] [blame] | 100 | |
| 101 | int8_t rssi; /* RSSI in dBm */ |
| 102 | uint8_t ber; /* Bit error rate in % */ |
| 103 | int16_t bto; /* Burst timing offset in quarter bits */ |
Jacob Erlbeck | 51b1151 | 2015-06-11 16:54:50 +0200 | [diff] [blame] | 104 | int16_t link_qual; /* Link quality in dB */ |
| 105 | int16_t ms_rx_qual; /* MS RXQUAL value in % */ |
| 106 | int16_t ms_c_value; /* C value in dB */ |
| 107 | int16_t ms_sign_var; /* SIGN_VAR in dB */ |
| 108 | |
| 109 | struct pcu_l1_meas_ts ts[8]; |
Jacob Erlbeck | 20f6fd1 | 2015-06-08 11:05:45 +0200 | [diff] [blame] | 110 | }; |
| 111 | |
Pau Espin Pedrol | da971ee | 2020-12-16 15:59:45 +0100 | [diff] [blame] | 112 | static inline void pcu_l1_meas_set_rssi(struct pcu_l1_meas *m, int8_t v) { |
| 113 | m->rssi = v; |
| 114 | m->have_rssi = 1; |
| 115 | } |
| 116 | static inline void pcu_l1_meas_set_ber(struct pcu_l1_meas *m, uint8_t v) { |
| 117 | m->ber = v; |
| 118 | m->have_ber = 1; |
| 119 | } |
| 120 | static inline void pcu_l1_meas_set_bto(struct pcu_l1_meas *m, int16_t v) { |
| 121 | m->bto = v; |
| 122 | m->have_bto = 1; |
| 123 | } |
| 124 | static inline void pcu_l1_meas_set_link_qual(struct pcu_l1_meas *m, int16_t v) { |
| 125 | m->link_qual = v; |
| 126 | m->have_link_qual = 1; |
| 127 | } |
| 128 | static inline void pcu_l1_meas_set_ms_rx_qual(struct pcu_l1_meas *m, int16_t v) { |
| 129 | m->ms_rx_qual = v; |
| 130 | m->have_ms_rx_qual = 1; |
| 131 | } |
| 132 | static inline void pcu_l1_meas_set_ms_c_value(struct pcu_l1_meas *m, int16_t v) { |
| 133 | m->ms_c_value = v; |
| 134 | m->have_ms_c_value = 1; |
| 135 | } |
| 136 | static inline void pcu_l1_meas_set_ms_sign_var(struct pcu_l1_meas *m, int16_t v) { |
| 137 | m->ms_sign_var = v; |
| 138 | m->have_ms_sign_var = 1; |
| 139 | } |
| 140 | static inline void pcu_l1_meas_set_ms_i_level(struct pcu_l1_meas *m, size_t idx, int16_t v) { |
| 141 | pcu_l1_meas_ts_set_ms_i_level(&m->ts[idx], v); |
| 142 | m->have_ms_i_level = 1; |
| 143 | } |
| 144 | |
Jacob Erlbeck | 20f6fd1 | 2015-06-08 11:05:45 +0200 | [diff] [blame] | 145 | #ifdef __cplusplus |
Pau Espin Pedrol | d1049dc | 2021-01-18 17:14:14 +0100 | [diff] [blame] | 146 | struct gprs_rlcmac_bts; |
| 147 | void pcu_l1if_tx_pdtch(msgb *msg, struct gprs_rlcmac_bts *bts, uint8_t trx, uint8_t ts, |
| 148 | uint16_t arfcn, uint32_t fn, uint8_t block_nr); |
Pau Espin Pedrol | ac3fd12 | 2021-01-13 18:54:38 +0100 | [diff] [blame] | 149 | void pcu_l1if_tx_ptcch(struct gprs_rlcmac_bts *bts, |
| 150 | uint8_t trx, uint8_t ts, uint16_t arfcn, |
Vadim Yanitskiy | 78f5861 | 2019-10-05 22:22:08 +0700 | [diff] [blame] | 151 | uint32_t fn, uint8_t block_nr, |
| 152 | uint8_t *data, size_t data_len); |
Pau Espin Pedrol | d1049dc | 2021-01-18 17:14:14 +0100 | [diff] [blame] | 153 | void pcu_l1if_tx_agch(struct gprs_rlcmac_bts *bts, bitvec * block, int len); |
Ivan Kluchnikov | ef7f28c | 2012-07-12 14:49:15 +0400 | [diff] [blame] | 154 | |
Pau Espin Pedrol | d1049dc | 2021-01-18 17:14:14 +0100 | [diff] [blame] | 155 | void pcu_l1if_tx_pch(struct gprs_rlcmac_bts *bts, bitvec * block, int plen, uint16_t pgroup); |
Andreas Eversberg | a23c7ee | 2012-12-18 10:47:28 +0100 | [diff] [blame] | 156 | #endif |
| 157 | |
| 158 | #ifdef __cplusplus |
Jacob Erlbeck | af75ce8 | 2015-08-26 13:22:28 +0200 | [diff] [blame] | 159 | extern "C" { |
Andreas Eversberg | a23c7ee | 2012-12-18 10:47:28 +0100 | [diff] [blame] | 160 | #endif |
Pau Espin Pedrol | d1049dc | 2021-01-18 17:14:14 +0100 | [diff] [blame] | 161 | struct gprs_rlcmac_bts; |
| 162 | |
Pau Espin Pedrol | 1989a19 | 2021-06-23 19:46:07 +0200 | [diff] [blame] | 163 | int pcu_rx(struct gsm_pcu_if *pcu_prim, size_t pcu_prim_length); |
Pau Espin Pedrol | e91c4c7 | 2021-01-18 17:54:30 +0100 | [diff] [blame] | 164 | int pcu_l1if_open(void); |
| 165 | void pcu_l1if_close(void); |
| 166 | int pcu_sock_send(struct msgb *msg); |
| 167 | |
| 168 | int pcu_tx_txt_ind(enum gsm_pcu_if_text_type t, const char *fmt, ...); |
| 169 | |
Pau Espin Pedrol | d1049dc | 2021-01-18 17:14:14 +0100 | [diff] [blame] | 170 | int pcu_rx_rts_req_pdtch(struct gprs_rlcmac_bts *bts, uint8_t trx, uint8_t ts, |
Andreas Eversberg | a23c7ee | 2012-12-18 10:47:28 +0100 | [diff] [blame] | 171 | uint32_t fn, uint8_t block_nr); |
Pau Espin Pedrol | d1049dc | 2021-01-18 17:14:14 +0100 | [diff] [blame] | 172 | int pcu_rx_rts_req_ptcch(struct gprs_rlcmac_bts *bts, uint8_t trx, uint8_t ts, |
Vadim Yanitskiy | 78f5861 | 2019-10-05 22:22:08 +0700 | [diff] [blame] | 173 | uint32_t fn, uint8_t block_nr); |
Andreas Eversberg | a23c7ee | 2012-12-18 10:47:28 +0100 | [diff] [blame] | 174 | |
Pau Espin Pedrol | d1049dc | 2021-01-18 17:14:14 +0100 | [diff] [blame] | 175 | int pcu_rx_rach_ind_ptcch(struct gprs_rlcmac_bts *bts, uint8_t trx_nr, uint8_t ts_nr, uint32_t fn, int16_t qta); |
Pau Espin Pedrol | c1f31c4 | 2021-03-09 14:50:14 +0100 | [diff] [blame] | 176 | int pcu_rx_data_ind_pdtch(struct gprs_rlcmac_bts *bts, struct gprs_rlcmac_pdch *pdch, uint8_t *data, |
Jacob Erlbeck | 20f6fd1 | 2015-06-08 11:05:45 +0200 | [diff] [blame] | 177 | uint8_t len, uint32_t fn, struct pcu_l1_meas *meas); |
Andreas Eversberg | a23c7ee | 2012-12-18 10:47:28 +0100 | [diff] [blame] | 178 | |
Pau Espin Pedrol | d1049dc | 2021-01-18 17:14:14 +0100 | [diff] [blame] | 179 | void pcu_rx_block_time(struct gprs_rlcmac_bts *bts, uint16_t arfcn, uint32_t fn, uint8_t ts_no); |
Pau Espin Pedrol | d7c3265 | 2019-12-23 12:41:34 +0100 | [diff] [blame] | 180 | uint16_t imsi2paging_group(const char* imsi); |
Pau Espin Pedrol | 1989a19 | 2021-06-23 19:46:07 +0200 | [diff] [blame] | 181 | |
| 182 | #define PCUIF_HDR_SIZE ( sizeof(struct gsm_pcu_if) - sizeof(((struct gsm_pcu_if *)0)->u) ) |
| 183 | |
Jacob Erlbeck | af75ce8 | 2015-08-26 13:22:28 +0200 | [diff] [blame] | 184 | #ifdef __cplusplus |
| 185 | } |
| 186 | #endif |
Ivan Kluchnikov | 8ee6051 | 2012-03-05 19:24:57 +0400 | [diff] [blame] | 187 | #endif // PCU_L1_IF_H |