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 | |
Max | d71e8b3 | 2016-09-19 16:17:06 +0200 | [diff] [blame] | 37 | static inline uint8_t qta2ta(int16_t qta) |
| 38 | { |
| 39 | if (qta < 0) |
| 40 | return 0; |
| 41 | if (qta > 252) |
| 42 | qta = 252; |
| 43 | return qta >> 2; |
| 44 | } |
| 45 | |
Minh-Quang Nguyen | 1bcfa9a | 2017-11-01 14:41:37 -0400 | [diff] [blame] | 46 | static inline int8_t sign_qta2ta(int16_t qta) |
| 47 | { |
| 48 | int8_t ta_adj = 0; |
| 49 | |
| 50 | if (qta < -252) |
| 51 | qta = -252; |
| 52 | |
| 53 | if (qta > 252) |
| 54 | qta = 252; |
| 55 | |
| 56 | /* 1-bit TA adjustment if TA error reported by L1 is outside +/- 2 qbits */ |
| 57 | if (qta > 2) |
| 58 | ta_adj = 1; |
| 59 | if (qta < -2) |
| 60 | ta_adj = -1; |
| 61 | |
| 62 | return (qta >> 2) + ta_adj; |
| 63 | } |
| 64 | |
| 65 | static inline uint8_t ta_limit(int16_t ta) |
| 66 | { |
| 67 | if (ta < 0) |
| 68 | ta = 0; |
| 69 | if (ta > 63) |
| 70 | ta = 63; |
| 71 | return ta; |
| 72 | } |
| 73 | |
Jacob Erlbeck | 20f6fd1 | 2015-06-08 11:05:45 +0200 | [diff] [blame] | 74 | /* |
| 75 | * L1 Measurement values |
| 76 | */ |
| 77 | |
Jacob Erlbeck | 51b1151 | 2015-06-11 16:54:50 +0200 | [diff] [blame] | 78 | struct pcu_l1_meas_ts { |
| 79 | unsigned have_ms_i_level:1; |
| 80 | |
| 81 | int16_t ms_i_level; /* I_LEVEL in dB */ |
Jacob Erlbeck | 51b1151 | 2015-06-11 16:54:50 +0200 | [diff] [blame] | 82 | }; |
| 83 | |
Pau Espin Pedrol | da971ee | 2020-12-16 15:59:45 +0100 | [diff] [blame] | 84 | static inline void pcu_l1_meas_ts_set_ms_i_level(struct pcu_l1_meas_ts* ts, int16_t v) { |
| 85 | ts->ms_i_level = v; |
| 86 | ts->have_ms_i_level = 1; |
| 87 | } |
| 88 | |
Jacob Erlbeck | 20f6fd1 | 2015-06-08 11:05:45 +0200 | [diff] [blame] | 89 | struct pcu_l1_meas { |
| 90 | unsigned have_rssi:1; |
| 91 | unsigned have_ber:1; |
| 92 | unsigned have_bto:1; |
| 93 | unsigned have_link_qual:1; |
Jacob Erlbeck | 51b1151 | 2015-06-11 16:54:50 +0200 | [diff] [blame] | 94 | unsigned have_ms_rx_qual:1; |
| 95 | unsigned have_ms_c_value:1; |
| 96 | unsigned have_ms_sign_var:1; |
| 97 | unsigned have_ms_i_level:1; |
Jacob Erlbeck | 20f6fd1 | 2015-06-08 11:05:45 +0200 | [diff] [blame] | 98 | |
| 99 | int8_t rssi; /* RSSI in dBm */ |
| 100 | uint8_t ber; /* Bit error rate in % */ |
| 101 | int16_t bto; /* Burst timing offset in quarter bits */ |
Jacob Erlbeck | 51b1151 | 2015-06-11 16:54:50 +0200 | [diff] [blame] | 102 | int16_t link_qual; /* Link quality in dB */ |
| 103 | int16_t ms_rx_qual; /* MS RXQUAL value in % */ |
| 104 | int16_t ms_c_value; /* C value in dB */ |
| 105 | int16_t ms_sign_var; /* SIGN_VAR in dB */ |
| 106 | |
| 107 | struct pcu_l1_meas_ts ts[8]; |
Jacob Erlbeck | 20f6fd1 | 2015-06-08 11:05:45 +0200 | [diff] [blame] | 108 | }; |
| 109 | |
Pau Espin Pedrol | da971ee | 2020-12-16 15:59:45 +0100 | [diff] [blame] | 110 | static inline void pcu_l1_meas_set_rssi(struct pcu_l1_meas *m, int8_t v) { |
| 111 | m->rssi = v; |
| 112 | m->have_rssi = 1; |
| 113 | } |
| 114 | static inline void pcu_l1_meas_set_ber(struct pcu_l1_meas *m, uint8_t v) { |
| 115 | m->ber = v; |
| 116 | m->have_ber = 1; |
| 117 | } |
| 118 | static inline void pcu_l1_meas_set_bto(struct pcu_l1_meas *m, int16_t v) { |
| 119 | m->bto = v; |
| 120 | m->have_bto = 1; |
| 121 | } |
| 122 | static inline void pcu_l1_meas_set_link_qual(struct pcu_l1_meas *m, int16_t v) { |
| 123 | m->link_qual = v; |
| 124 | m->have_link_qual = 1; |
| 125 | } |
| 126 | static inline void pcu_l1_meas_set_ms_rx_qual(struct pcu_l1_meas *m, int16_t v) { |
| 127 | m->ms_rx_qual = v; |
| 128 | m->have_ms_rx_qual = 1; |
| 129 | } |
| 130 | static inline void pcu_l1_meas_set_ms_c_value(struct pcu_l1_meas *m, int16_t v) { |
| 131 | m->ms_c_value = v; |
| 132 | m->have_ms_c_value = 1; |
| 133 | } |
| 134 | static inline void pcu_l1_meas_set_ms_sign_var(struct pcu_l1_meas *m, int16_t v) { |
| 135 | m->ms_sign_var = v; |
| 136 | m->have_ms_sign_var = 1; |
| 137 | } |
| 138 | static inline void pcu_l1_meas_set_ms_i_level(struct pcu_l1_meas *m, size_t idx, int16_t v) { |
| 139 | pcu_l1_meas_ts_set_ms_i_level(&m->ts[idx], v); |
| 140 | m->have_ms_i_level = 1; |
| 141 | } |
| 142 | |
Jacob Erlbeck | 20f6fd1 | 2015-06-08 11:05:45 +0200 | [diff] [blame] | 143 | #ifdef __cplusplus |
Pau Espin Pedrol | d1049dc | 2021-01-18 17:14:14 +0100 | [diff] [blame] | 144 | struct gprs_rlcmac_bts; |
| 145 | void pcu_l1if_tx_pdtch(msgb *msg, struct gprs_rlcmac_bts *bts, uint8_t trx, uint8_t ts, |
| 146 | uint16_t arfcn, uint32_t fn, uint8_t block_nr); |
Pau Espin Pedrol | ac3fd12 | 2021-01-13 18:54:38 +0100 | [diff] [blame] | 147 | void pcu_l1if_tx_ptcch(struct gprs_rlcmac_bts *bts, |
| 148 | uint8_t trx, uint8_t ts, uint16_t arfcn, |
Vadim Yanitskiy | 78f5861 | 2019-10-05 22:22:08 +0700 | [diff] [blame] | 149 | uint32_t fn, uint8_t block_nr, |
| 150 | uint8_t *data, size_t data_len); |
Pau Espin Pedrol | d1049dc | 2021-01-18 17:14:14 +0100 | [diff] [blame] | 151 | 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] | 152 | |
Pau Espin Pedrol | d1049dc | 2021-01-18 17:14:14 +0100 | [diff] [blame] | 153 | 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] | 154 | #endif |
| 155 | |
| 156 | #ifdef __cplusplus |
Jacob Erlbeck | af75ce8 | 2015-08-26 13:22:28 +0200 | [diff] [blame] | 157 | extern "C" { |
Andreas Eversberg | a23c7ee | 2012-12-18 10:47:28 +0100 | [diff] [blame] | 158 | #endif |
Pau Espin Pedrol | d1049dc | 2021-01-18 17:14:14 +0100 | [diff] [blame] | 159 | struct gprs_rlcmac_bts; |
| 160 | |
Pau Espin Pedrol | e91c4c7 | 2021-01-18 17:54:30 +0100 | [diff] [blame] | 161 | int pcu_rx(uint8_t msg_type, struct gsm_pcu_if *pcu_prim); |
| 162 | int pcu_l1if_open(void); |
| 163 | void pcu_l1if_close(void); |
| 164 | int pcu_sock_send(struct msgb *msg); |
| 165 | |
| 166 | int pcu_tx_txt_ind(enum gsm_pcu_if_text_type t, const char *fmt, ...); |
| 167 | |
Pau Espin Pedrol | d1049dc | 2021-01-18 17:14:14 +0100 | [diff] [blame] | 168 | 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] | 169 | uint32_t fn, uint8_t block_nr); |
Pau Espin Pedrol | d1049dc | 2021-01-18 17:14:14 +0100 | [diff] [blame] | 170 | 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] | 171 | uint32_t fn, uint8_t block_nr); |
Andreas Eversberg | a23c7ee | 2012-12-18 10:47:28 +0100 | [diff] [blame] | 172 | |
Pau Espin Pedrol | d1049dc | 2021-01-18 17:14:14 +0100 | [diff] [blame] | 173 | 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); |
| 174 | int pcu_rx_data_ind_pdtch(struct gprs_rlcmac_bts *bts, uint8_t trx, uint8_t ts, uint8_t *data, |
Jacob Erlbeck | 20f6fd1 | 2015-06-08 11:05:45 +0200 | [diff] [blame] | 175 | uint8_t len, uint32_t fn, struct pcu_l1_meas *meas); |
Andreas Eversberg | a23c7ee | 2012-12-18 10:47:28 +0100 | [diff] [blame] | 176 | |
Pau Espin Pedrol | d1049dc | 2021-01-18 17:14:14 +0100 | [diff] [blame] | 177 | void pcu_rx_block_time(struct gprs_rlcmac_bts *bts, uint16_t arfcn, uint32_t fn, uint8_t ts_no); |
| 178 | void pcu_rx_ra_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] | 179 | uint16_t imsi2paging_group(const char* imsi); |
Jacob Erlbeck | af75ce8 | 2015-08-26 13:22:28 +0200 | [diff] [blame] | 180 | #ifdef __cplusplus |
| 181 | } |
| 182 | #endif |
Ivan Kluchnikov | 8ee6051 | 2012-03-05 19:24:57 +0400 | [diff] [blame] | 183 | #endif // PCU_L1_IF_H |