Ivan Kluchnikov | 8ee6051 | 2012-03-05 19:24:57 +0400 | [diff] [blame] | 1 | /* gprs_rlcmac.h |
| 2 | * |
| 3 | * Copyright (C) 2012 Ivan Klyuchnikov |
Holger Hans Peter Freyther | d6bd91e | 2013-08-24 21:16:55 +0200 | [diff] [blame] | 4 | * Copyright (C) 2013 by Holger Hans Peter Freyther |
Ivan Kluchnikov | 8ee6051 | 2012-03-05 19:24:57 +0400 | [diff] [blame] | 5 | * |
| 6 | * This program is free software; you can redistribute it and/or |
| 7 | * modify it under the terms of the GNU General Public License |
| 8 | * as published by the Free Software Foundation; either version 2 |
| 9 | * of the License, or (at your option) any later version. |
| 10 | * |
| 11 | * This program is distributed in the hope that it will be useful, |
| 12 | * but WITHOUT ANY WARRANTY; without even the implied warranty of |
| 13 | * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the |
| 14 | * GNU General Public License for more details. |
| 15 | * |
| 16 | * You should have received a copy of the GNU General Public License |
| 17 | * along with this program; if not, write to the Free Software |
| 18 | * Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA. |
| 19 | */ |
| 20 | |
| 21 | #ifndef GPRS_RLCMAC_H |
| 22 | #define GPRS_RLCMAC_H |
| 23 | |
Andreas Eversberg | 8b761a3 | 2012-07-20 21:50:31 +0200 | [diff] [blame] | 24 | #ifdef __cplusplus |
Ivan Kluchnikov | 835f91e | 2012-04-30 18:00:36 +0400 | [diff] [blame] | 25 | #include <bitvector.h> |
Ivan Kluchnikov | 8ee6051 | 2012-03-05 19:24:57 +0400 | [diff] [blame] | 26 | #include <gsm_rlcmac.h> |
Ivan Kluchnikov | 61a33f7 | 2012-04-12 15:22:06 +0400 | [diff] [blame] | 27 | #include <gsm_timer.h> |
Ivan Kluchnikov | 8ee6051 | 2012-03-05 19:24:57 +0400 | [diff] [blame] | 28 | |
| 29 | extern "C" { |
| 30 | #include <osmocom/core/linuxlist.h> |
Ivan Kluchnikov | 61a33f7 | 2012-04-12 15:22:06 +0400 | [diff] [blame] | 31 | #include <osmocom/core/timer.h> |
Ivan Kluchnikov | 8ee6051 | 2012-03-05 19:24:57 +0400 | [diff] [blame] | 32 | } |
Andreas Eversberg | 8b761a3 | 2012-07-20 21:50:31 +0200 | [diff] [blame] | 33 | #endif |
Ivan Kluchnikov | 8ee6051 | 2012-03-05 19:24:57 +0400 | [diff] [blame] | 34 | |
Andreas Eversberg | b83e2a7 | 2012-10-07 15:26:00 +0200 | [diff] [blame] | 35 | /* generate a diagram for debugging timing issues */ |
| 36 | //#define DEBUG_DIAGRAM |
| 37 | |
Andreas Eversberg | e6228b3 | 2012-07-03 13:36:03 +0200 | [diff] [blame] | 38 | /* This special feature will delay assignment of downlink TBF by one second, |
| 39 | * in case there is already a TBF. |
| 40 | * This is usefull to debug downlink establishment during packet idle mode. |
| 41 | */ |
| 42 | //#define DEBUG_DL_ASS_IDLE |
Ivan Kluchnikov | c5d8c27 | 2012-06-04 21:55:02 +0400 | [diff] [blame] | 43 | |
Andreas Eversberg | 5dac2f0 | 2012-06-27 15:52:04 +0200 | [diff] [blame] | 44 | |
| 45 | struct gprs_rlcmac_tbf; |
Holger Hans Peter Freyther | b6acfda | 2013-10-17 19:41:11 +0200 | [diff] [blame] | 46 | struct gprs_rlcmac_bts; |
Holger Hans Peter Freyther | 34bd8bd | 2013-10-19 21:10:38 +0200 | [diff] [blame] | 47 | struct BTS; |
Andreas Eversberg | 5dac2f0 | 2012-06-27 15:52:04 +0200 | [diff] [blame] | 48 | |
Andreas Eversberg | 8b761a3 | 2012-07-20 21:50:31 +0200 | [diff] [blame] | 49 | #ifdef __cplusplus |
Andreas Eversberg | 5dac2f0 | 2012-06-27 15:52:04 +0200 | [diff] [blame] | 50 | /* |
Andreas Eversberg | 2b91464 | 2012-07-19 13:06:26 +0200 | [diff] [blame] | 51 | * paging entry |
| 52 | */ |
| 53 | struct gprs_rlcmac_paging { |
| 54 | struct llist_head list; |
| 55 | uint8_t chan_needed; |
| 56 | uint8_t identity_lv[9]; |
| 57 | }; |
Ivan Kluchnikov | 8ee6051 | 2012-03-05 19:24:57 +0400 | [diff] [blame] | 58 | |
Andreas Eversberg | 07e97cf | 2012-08-07 16:00:56 +0200 | [diff] [blame] | 59 | /* |
Andreas Eversberg | 3b1332c | 2012-10-03 14:20:53 +0200 | [diff] [blame] | 60 | * coding scheme info |
| 61 | */ |
| 62 | struct gprs_rlcmac_cs { |
| 63 | uint8_t block_length; |
| 64 | uint8_t block_data; |
| 65 | uint8_t block_payload; |
| 66 | }; |
Ivan Kluchnikov | 8ee6051 | 2012-03-05 19:24:57 +0400 | [diff] [blame] | 67 | |
Andreas Eversberg | b83e2a7 | 2012-10-07 15:26:00 +0200 | [diff] [blame] | 68 | #ifdef DEBUG_DIAGRAM |
Holger Hans Peter Freyther | 34bd8bd | 2013-10-19 21:10:38 +0200 | [diff] [blame] | 69 | void debug_diagram(BTS *bts, int diag, const char *format, ...); |
Andreas Eversberg | b83e2a7 | 2012-10-07 15:26:00 +0200 | [diff] [blame] | 70 | #else |
Holger Hans Peter Freyther | 34bd8bd | 2013-10-19 21:10:38 +0200 | [diff] [blame] | 71 | #define debug_diagram(a, b, c, args...) ; |
Andreas Eversberg | b83e2a7 | 2012-10-07 15:26:00 +0200 | [diff] [blame] | 72 | #endif |
| 73 | |
Andreas Eversberg | 050ace2 | 2013-03-16 16:22:02 +0100 | [diff] [blame] | 74 | int gprs_rlcmac_received_lost(struct gprs_rlcmac_tbf *tbf, uint16_t received, |
| 75 | uint16_t lost); |
| 76 | |
| 77 | int gprs_rlcmac_lost_rep(struct gprs_rlcmac_tbf *tbf); |
| 78 | |
| 79 | int gprs_rlcmac_meas_rep(Packet_Measurement_Report_t *pmr); |
| 80 | |
| 81 | int gprs_rlcmac_rssi(struct gprs_rlcmac_tbf *tbf, int8_t rssi); |
| 82 | |
| 83 | int gprs_rlcmac_rssi_rep(struct gprs_rlcmac_tbf *tbf); |
| 84 | |
| 85 | int gprs_rlcmac_dl_bw(struct gprs_rlcmac_tbf *tbf, uint16_t octets); |
| 86 | |
Ivan Kluchnikov | 8ee6051 | 2012-03-05 19:24:57 +0400 | [diff] [blame] | 87 | /* TS 44.060 Section 10.4.7 Table 10.4.7.1: Payload Type field */ |
| 88 | enum gprs_rlcmac_block_type { |
| 89 | GPRS_RLCMAC_DATA_BLOCK = 0x0, |
| 90 | GPRS_RLCMAC_CONTROL_BLOCK = 0x1, |
| 91 | GPRS_RLCMAC_CONTROL_BLOCK_OPT = 0x2, |
| 92 | GPRS_RLCMAC_RESERVED = 0x3 |
| 93 | }; |
| 94 | |
Andreas Eversberg | 3e372d5 | 2012-07-06 09:28:15 +0200 | [diff] [blame] | 95 | int gprs_rlcmac_tx_ul_ud(gprs_rlcmac_tbf *tbf); |
Ivan Kluchnikov | a9e6dc5 | 2012-06-17 08:30:06 +0400 | [diff] [blame] | 96 | |
Holger Hans Peter Freyther | b0250eb | 2013-10-17 13:46:19 +0200 | [diff] [blame] | 97 | int gprs_rlcmac_rcv_rach(struct gprs_rlcmac_bts *bts, uint8_t ra, uint32_t Fn, int16_t qta); |
Ivan Kluchnikov | 5310d45 | 2012-04-17 22:00:31 +0400 | [diff] [blame] | 98 | |
Andreas Eversberg | e6228b3 | 2012-07-03 13:36:03 +0200 | [diff] [blame] | 99 | struct msgb *gprs_rlcmac_send_packet_uplink_assignment( |
| 100 | struct gprs_rlcmac_tbf *tbf, uint32_t fn); |
Ivan Kluchnikov | 8ee6051 | 2012-03-05 19:24:57 +0400 | [diff] [blame] | 101 | |
Andreas Eversberg | e6228b3 | 2012-07-03 13:36:03 +0200 | [diff] [blame] | 102 | struct msgb *gprs_rlcmac_send_packet_downlink_assignment( |
| 103 | struct gprs_rlcmac_tbf *tbf, uint32_t fn); |
Ivan Kluchnikov | c320d86 | 2012-03-18 15:04:48 +0400 | [diff] [blame] | 104 | |
Holger Hans Peter Freyther | b65e08a | 2013-10-20 17:10:25 +0200 | [diff] [blame] | 105 | void gprs_rlcmac_trigger_downlink_assignment( |
Holger Hans Peter Freyther | 344ff48 | 2013-10-17 12:01:04 +0200 | [diff] [blame] | 106 | struct gprs_rlcmac_tbf *tbf, |
Holger Hans Peter Freyther | 52c911b | 2013-08-24 18:30:54 +0200 | [diff] [blame] | 107 | struct gprs_rlcmac_tbf *old_tbf, const char *imsi); |
Ivan Kluchnikov | c7e7f68 | 2012-06-29 22:53:15 +0400 | [diff] [blame] | 108 | |
Holger Hans Peter Freyther | b65e08a | 2013-10-20 17:10:25 +0200 | [diff] [blame] | 109 | int gprs_rlcmac_downlink_ack( |
Holger Hans Peter Freyther | 344ff48 | 2013-10-17 12:01:04 +0200 | [diff] [blame] | 110 | struct gprs_rlcmac_tbf *tbf, uint8_t final, |
Andreas Eversberg | e6228b3 | 2012-07-03 13:36:03 +0200 | [diff] [blame] | 111 | uint8_t ssn, uint8_t *rbb); |
Andreas Eversberg | 5dac2f0 | 2012-06-27 15:52:04 +0200 | [diff] [blame] | 112 | |
Andreas Eversberg | 8c3680d | 2012-10-08 12:30:56 +0200 | [diff] [blame] | 113 | int gprs_rlcmac_paging_request(uint8_t *ptmsi, uint16_t ptmsi_len, |
| 114 | const char *imsi); |
| 115 | |
Andreas Eversberg | e6228b3 | 2012-07-03 13:36:03 +0200 | [diff] [blame] | 116 | struct msgb *gprs_rlcmac_send_data_block_acknowledged( |
Andreas Eversberg | 592e04a | 2012-07-15 06:25:37 +0200 | [diff] [blame] | 117 | struct gprs_rlcmac_tbf *tbf, uint32_t fn, uint8_t ts); |
Andreas Eversberg | e6228b3 | 2012-07-03 13:36:03 +0200 | [diff] [blame] | 118 | |
Holger Hans Peter Freyther | b65e08a | 2013-10-20 17:10:25 +0200 | [diff] [blame] | 119 | struct msgb *gprs_rlcmac_send_uplink_ack( |
Holger Hans Peter Freyther | ae947fc | 2013-10-17 13:29:03 +0200 | [diff] [blame] | 120 | struct gprs_rlcmac_tbf *tbf, |
Andreas Eversberg | 5dac2f0 | 2012-06-27 15:52:04 +0200 | [diff] [blame] | 121 | uint32_t fn); |
Ivan Kluchnikov | 9c795ab | 2012-05-24 23:12:59 +0400 | [diff] [blame] | 122 | |
Holger Hans Peter Freyther | b19d726 | 2013-10-17 18:12:18 +0200 | [diff] [blame] | 123 | int gprs_rlcmac_rcv_rts_block(struct gprs_rlcmac_bts *bts, |
| 124 | uint8_t trx, uint8_t ts, uint16_t arfcn, |
Andreas Eversberg | e6228b3 | 2012-07-03 13:36:03 +0200 | [diff] [blame] | 125 | uint32_t fn, uint8_t block_nr); |
| 126 | |
Andreas Eversberg | a1503fa | 2012-07-22 08:58:09 +0200 | [diff] [blame] | 127 | extern "C" { |
| 128 | #endif |
Holger Hans Peter Freyther | b67a8a3 | 2013-07-28 18:55:14 +0200 | [diff] [blame] | 129 | int alloc_algorithm_a(struct gprs_rlcmac_bts *bts, |
| 130 | struct gprs_rlcmac_tbf *old_tbf, |
Andreas Eversberg | f01929b | 2012-10-08 12:40:49 +0200 | [diff] [blame] | 131 | struct gprs_rlcmac_tbf *tbf, uint32_t cust, uint8_t single); |
Andreas Eversberg | a1503fa | 2012-07-22 08:58:09 +0200 | [diff] [blame] | 132 | |
Holger Hans Peter Freyther | b67a8a3 | 2013-07-28 18:55:14 +0200 | [diff] [blame] | 133 | int alloc_algorithm_b(struct gprs_rlcmac_bts *bts, |
| 134 | struct gprs_rlcmac_tbf *old_tbf, |
Andreas Eversberg | f01929b | 2012-10-08 12:40:49 +0200 | [diff] [blame] | 135 | struct gprs_rlcmac_tbf *tbf, uint32_t cust, uint8_t single); |
Andreas Eversberg | a1503fa | 2012-07-22 08:58:09 +0200 | [diff] [blame] | 136 | #ifdef __cplusplus |
| 137 | } |
Andreas Eversberg | 8b761a3 | 2012-07-20 21:50:31 +0200 | [diff] [blame] | 138 | #endif |
Andreas Eversberg | 2b91464 | 2012-07-19 13:06:26 +0200 | [diff] [blame] | 139 | |
Ivan Kluchnikov | 8ee6051 | 2012-03-05 19:24:57 +0400 | [diff] [blame] | 140 | #endif // GPRS_RLCMAC_H |