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 | |
Jacob Erlbeck | 20f6fd1 | 2015-06-08 11:05:45 +0200 | [diff] [blame] | 46 | /* |
| 47 | * L1 Measurement values |
| 48 | */ |
| 49 | |
Jacob Erlbeck | 51b1151 | 2015-06-11 16:54:50 +0200 | [diff] [blame] | 50 | struct pcu_l1_meas_ts { |
| 51 | unsigned have_ms_i_level:1; |
| 52 | |
| 53 | int16_t ms_i_level; /* I_LEVEL in dB */ |
| 54 | |
| 55 | #ifdef __cplusplus |
| 56 | pcu_l1_meas_ts& set_ms_i_level(int16_t v) { |
| 57 | ms_i_level = v; have_ms_i_level = 1; return *this; |
| 58 | } |
| 59 | |
| 60 | pcu_l1_meas_ts() : |
Harald Welte | 1f2bb6e | 2016-11-26 15:22:08 +0100 | [diff] [blame] | 61 | have_ms_i_level(0), |
| 62 | ms_i_level(0) |
Jacob Erlbeck | 51b1151 | 2015-06-11 16:54:50 +0200 | [diff] [blame] | 63 | {} |
| 64 | #endif |
| 65 | }; |
| 66 | |
Jacob Erlbeck | 20f6fd1 | 2015-06-08 11:05:45 +0200 | [diff] [blame] | 67 | struct pcu_l1_meas { |
| 68 | unsigned have_rssi:1; |
| 69 | unsigned have_ber:1; |
| 70 | unsigned have_bto:1; |
| 71 | unsigned have_link_qual:1; |
Jacob Erlbeck | 51b1151 | 2015-06-11 16:54:50 +0200 | [diff] [blame] | 72 | unsigned have_ms_rx_qual:1; |
| 73 | unsigned have_ms_c_value:1; |
| 74 | unsigned have_ms_sign_var:1; |
| 75 | unsigned have_ms_i_level:1; |
Jacob Erlbeck | 20f6fd1 | 2015-06-08 11:05:45 +0200 | [diff] [blame] | 76 | |
| 77 | int8_t rssi; /* RSSI in dBm */ |
| 78 | uint8_t ber; /* Bit error rate in % */ |
| 79 | int16_t bto; /* Burst timing offset in quarter bits */ |
Jacob Erlbeck | 51b1151 | 2015-06-11 16:54:50 +0200 | [diff] [blame] | 80 | int16_t link_qual; /* Link quality in dB */ |
| 81 | int16_t ms_rx_qual; /* MS RXQUAL value in % */ |
| 82 | int16_t ms_c_value; /* C value in dB */ |
| 83 | int16_t ms_sign_var; /* SIGN_VAR in dB */ |
| 84 | |
| 85 | struct pcu_l1_meas_ts ts[8]; |
| 86 | |
Jacob Erlbeck | 20f6fd1 | 2015-06-08 11:05:45 +0200 | [diff] [blame] | 87 | #ifdef __cplusplus |
| 88 | pcu_l1_meas& set_rssi(int8_t v) { rssi = v; have_rssi = 1; return *this;} |
| 89 | pcu_l1_meas& set_ber(uint8_t v) { ber = v; have_ber = 1; return *this;} |
| 90 | pcu_l1_meas& set_bto(int16_t v) { bto = v; have_bto = 1; return *this;} |
| 91 | pcu_l1_meas& set_link_qual(int16_t v) { |
| 92 | link_qual = v; have_link_qual = 1; return *this; |
| 93 | } |
Jacob Erlbeck | 51b1151 | 2015-06-11 16:54:50 +0200 | [diff] [blame] | 94 | pcu_l1_meas& set_ms_rx_qual(int16_t v) { |
| 95 | ms_rx_qual = v; have_ms_rx_qual = 1; return *this; |
| 96 | } |
| 97 | pcu_l1_meas& set_ms_c_value(int16_t v) { |
| 98 | ms_c_value = v; have_ms_c_value = 1; return *this; |
| 99 | } |
| 100 | pcu_l1_meas& set_ms_sign_var(int16_t v) { |
| 101 | ms_sign_var = v; have_ms_sign_var = 1; return *this; |
| 102 | } |
| 103 | pcu_l1_meas& set_ms_i_level(size_t idx, int16_t v) { |
| 104 | ts[idx].set_ms_i_level(v); have_ms_i_level = 1; return *this; |
| 105 | } |
Jacob Erlbeck | 20f6fd1 | 2015-06-08 11:05:45 +0200 | [diff] [blame] | 106 | pcu_l1_meas() : |
| 107 | have_rssi(0), |
| 108 | have_ber(0), |
| 109 | have_bto(0), |
Jacob Erlbeck | 51b1151 | 2015-06-11 16:54:50 +0200 | [diff] [blame] | 110 | have_link_qual(0), |
| 111 | have_ms_rx_qual(0), |
| 112 | have_ms_c_value(0), |
| 113 | have_ms_sign_var(0), |
Harald Welte | 963cdaf | 2016-11-26 15:24:06 +0100 | [diff] [blame] | 114 | have_ms_i_level(0), |
| 115 | rssi(0), |
| 116 | ber(0), |
| 117 | bto(0), |
| 118 | link_qual(0), |
| 119 | ms_rx_qual(0), |
| 120 | ms_c_value(0), |
| 121 | ms_sign_var(0) |
Jacob Erlbeck | 20f6fd1 | 2015-06-08 11:05:45 +0200 | [diff] [blame] | 122 | {} |
| 123 | #endif |
| 124 | }; |
| 125 | |
| 126 | #ifdef __cplusplus |
Andreas Eversberg | 0aed654 | 2012-06-23 10:33:16 +0200 | [diff] [blame] | 127 | void pcu_l1if_tx_pdtch(msgb *msg, uint8_t trx, uint8_t ts, uint16_t arfcn, |
| 128 | uint32_t fn, uint8_t block_nr); |
| 129 | void pcu_l1if_tx_ptcch(msgb *msg, uint8_t trx, uint8_t ts, uint16_t arfcn, |
| 130 | uint32_t fn, uint8_t block_nr); |
| 131 | void pcu_l1if_tx_agch(bitvec * block, int len); |
Ivan Kluchnikov | ef7f28c | 2012-07-12 14:49:15 +0400 | [diff] [blame] | 132 | |
Holger Hans Peter Freyther | 52c911b | 2013-08-24 18:30:54 +0200 | [diff] [blame] | 133 | void pcu_l1if_tx_pch(bitvec * block, int plen, const char *imsi); |
Ivan Kluchnikov | 8ee6051 | 2012-03-05 19:24:57 +0400 | [diff] [blame] | 134 | |
Max | 0a8fae8 | 2017-03-08 18:53:30 +0100 | [diff] [blame] | 135 | int pcu_tx_txt_ind(enum gsm_pcu_if_text_type t, const char *fmt, ...); |
| 136 | |
Andreas Eversberg | 0aed654 | 2012-06-23 10:33:16 +0200 | [diff] [blame] | 137 | int pcu_l1if_open(void); |
| 138 | void pcu_l1if_close(void); |
Ivan Kluchnikov | 8ee6051 | 2012-03-05 19:24:57 +0400 | [diff] [blame] | 139 | |
Ivan Kluchnikov | ef7f28c | 2012-07-12 14:49:15 +0400 | [diff] [blame] | 140 | int pcu_rx(uint8_t msg_type, struct gsm_pcu_if *pcu_prim); |
| 141 | int pcu_sock_send(struct msgb *msg); |
Andreas Eversberg | a23c7ee | 2012-12-18 10:47:28 +0100 | [diff] [blame] | 142 | #endif |
| 143 | |
| 144 | #ifdef __cplusplus |
Jacob Erlbeck | af75ce8 | 2015-08-26 13:22:28 +0200 | [diff] [blame] | 145 | extern "C" { |
Andreas Eversberg | a23c7ee | 2012-12-18 10:47:28 +0100 | [diff] [blame] | 146 | #endif |
Max | 878bd1f | 2016-07-20 13:05:05 +0200 | [diff] [blame] | 147 | int pcu_rx_rts_req_pdtch(uint8_t trx, uint8_t ts, |
Andreas Eversberg | a23c7ee | 2012-12-18 10:47:28 +0100 | [diff] [blame] | 148 | uint32_t fn, uint8_t block_nr); |
| 149 | |
Andreas Eversberg | a23c7ee | 2012-12-18 10:47:28 +0100 | [diff] [blame] | 150 | int pcu_rx_data_ind_pdtch(uint8_t trx, uint8_t ts, uint8_t *data, |
Jacob Erlbeck | 20f6fd1 | 2015-06-08 11:05:45 +0200 | [diff] [blame] | 151 | uint8_t len, uint32_t fn, struct pcu_l1_meas *meas); |
Andreas Eversberg | a23c7ee | 2012-12-18 10:47:28 +0100 | [diff] [blame] | 152 | |
Jacob Erlbeck | af75ce8 | 2015-08-26 13:22:28 +0200 | [diff] [blame] | 153 | void pcu_rx_block_time(uint16_t arfcn, uint32_t fn, uint8_t ts_no); |
| 154 | void pcu_rx_ra_time(uint16_t arfcn, uint32_t fn, uint8_t ts_no); |
| 155 | |
| 156 | #ifdef __cplusplus |
| 157 | } |
| 158 | #endif |
Ivan Kluchnikov | 8ee6051 | 2012-03-05 19:24:57 +0400 | [diff] [blame] | 159 | #endif // PCU_L1_IF_H |