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