Ivan Kluchnikov | 8ee6051 | 2012-03-05 19:24:57 +0400 | [diff] [blame] | 1 | /* gprs_rlcmac.h |
| 2 | * |
| 3 | * Copyright (C) 2012 Ivan Klyuchnikov |
| 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 | |
| 20 | #ifndef GPRS_RLCMAC_H |
| 21 | #define GPRS_RLCMAC_H |
| 22 | |
Andreas Eversberg | 8b761a3 | 2012-07-20 21:50:31 +0200 | [diff] [blame] | 23 | #ifdef __cplusplus |
Ivan Kluchnikov | 835f91e | 2012-04-30 18:00:36 +0400 | [diff] [blame] | 24 | #include <bitvector.h> |
Ivan Kluchnikov | 8ee6051 | 2012-03-05 19:24:57 +0400 | [diff] [blame] | 25 | #include <gsm_rlcmac.h> |
Ivan Kluchnikov | 61a33f7 | 2012-04-12 15:22:06 +0400 | [diff] [blame] | 26 | #include <gsm_timer.h> |
Ivan Kluchnikov | 8ee6051 | 2012-03-05 19:24:57 +0400 | [diff] [blame] | 27 | |
| 28 | extern "C" { |
| 29 | #include <osmocom/core/linuxlist.h> |
Ivan Kluchnikov | 61a33f7 | 2012-04-12 15:22:06 +0400 | [diff] [blame] | 30 | #include <osmocom/core/timer.h> |
Ivan Kluchnikov | 8ee6051 | 2012-03-05 19:24:57 +0400 | [diff] [blame] | 31 | } |
Andreas Eversberg | 8b761a3 | 2012-07-20 21:50:31 +0200 | [diff] [blame] | 32 | #endif |
Ivan Kluchnikov | 8ee6051 | 2012-03-05 19:24:57 +0400 | [diff] [blame] | 33 | |
Andreas Eversberg | b83e2a7 | 2012-10-07 15:26:00 +0200 | [diff] [blame] | 34 | /* generate a diagram for debugging timing issues */ |
| 35 | //#define DEBUG_DIAGRAM |
| 36 | |
Andreas Eversberg | e6228b3 | 2012-07-03 13:36:03 +0200 | [diff] [blame] | 37 | /* This special feature will delay assignment of downlink TBF by one second, |
| 38 | * in case there is already a TBF. |
| 39 | * This is usefull to debug downlink establishment during packet idle mode. |
| 40 | */ |
| 41 | //#define DEBUG_DL_ASS_IDLE |
Ivan Kluchnikov | c5d8c27 | 2012-06-04 21:55:02 +0400 | [diff] [blame] | 42 | |
Andreas Eversberg | 5dac2f0 | 2012-06-27 15:52:04 +0200 | [diff] [blame] | 43 | /* |
| 44 | * PDCH instanc |
| 45 | */ |
| 46 | |
| 47 | struct gprs_rlcmac_tbf; |
| 48 | |
| 49 | struct gprs_rlcmac_pdch { |
| 50 | uint8_t enable; /* TS is enabled */ |
| 51 | uint8_t tsc; /* TSC of this slot */ |
| 52 | uint8_t next_ul_tfi; /* next uplink TBF/TFI to schedule (0..31) */ |
| 53 | uint8_t next_dl_tfi; /* next downlink TBF/TFI to schedule (0..31) */ |
Andreas Eversberg | b0c7ea7 | 2012-07-13 14:46:03 +0200 | [diff] [blame] | 54 | struct gprs_rlcmac_tbf *ul_tbf[32]; /* array of UL TBF, by UL TFI */ |
| 55 | struct gprs_rlcmac_tbf *dl_tbf[32]; /* array of DL TBF, by DL TFI */ |
Andreas Eversberg | 2b91464 | 2012-07-19 13:06:26 +0200 | [diff] [blame] | 56 | struct llist_head paging_list; /* list of paging messages */ |
Andreas Eversberg | e6228b3 | 2012-07-03 13:36:03 +0200 | [diff] [blame] | 57 | uint32_t last_rts_fn; /* store last frame number of RTS */ |
Ivan Kluchnikov | a9e6dc5 | 2012-06-17 08:30:06 +0400 | [diff] [blame] | 58 | }; |
| 59 | |
Andreas Eversberg | 5dac2f0 | 2012-06-27 15:52:04 +0200 | [diff] [blame] | 60 | struct gprs_rlcmac_trx { |
Andreas Eversberg | a23c7ee | 2012-12-18 10:47:28 +0100 | [diff] [blame] | 61 | void *fl1h; |
Andreas Eversberg | 5dac2f0 | 2012-06-27 15:52:04 +0200 | [diff] [blame] | 62 | uint16_t arfcn; |
| 63 | struct gprs_rlcmac_pdch pdch[8]; |
Andreas Eversberg | adb2f18 | 2012-08-07 17:06:08 +0200 | [diff] [blame] | 64 | struct gprs_rlcmac_tbf *ul_tbf[32]; /* array of UL TBF, by UL TFI */ |
| 65 | struct gprs_rlcmac_tbf *dl_tbf[32]; /* array of DL TBF, by DL TFI */ |
Andreas Eversberg | 5dac2f0 | 2012-06-27 15:52:04 +0200 | [diff] [blame] | 66 | }; |
| 67 | |
| 68 | struct gprs_rlcmac_bts { |
Andreas Eversberg | a23c7ee | 2012-12-18 10:47:28 +0100 | [diff] [blame] | 69 | uint8_t bsic; |
Andreas Eversberg | cd8a83a | 2012-09-23 06:41:21 +0200 | [diff] [blame] | 70 | uint8_t fc_interval; |
Andreas Eversberg | b3c6f6c | 2012-07-06 07:40:08 +0200 | [diff] [blame] | 71 | uint8_t cs1; |
| 72 | uint8_t cs2; |
| 73 | uint8_t cs3; |
| 74 | uint8_t cs4; |
Andreas Eversberg | 499ff41 | 2012-10-03 14:21:36 +0200 | [diff] [blame] | 75 | uint8_t initial_cs_dl, initial_cs_ul; |
Andreas Eversberg | 8b761a3 | 2012-07-20 21:50:31 +0200 | [diff] [blame] | 76 | uint8_t force_cs; /* 0=use from BTS 1=use from VTY */ |
Andreas Eversberg | 24131bf | 2012-07-21 11:09:58 +0200 | [diff] [blame] | 77 | uint16_t force_llc_lifetime; /* overrides lifetime from SGSN */ |
Andreas Eversberg | b3c6f6c | 2012-07-06 07:40:08 +0200 | [diff] [blame] | 78 | uint8_t t3142; |
| 79 | uint8_t t3169; |
| 80 | uint8_t t3191; |
| 81 | uint16_t t3193_msec; |
| 82 | uint8_t t3195; |
| 83 | uint8_t n3101; |
| 84 | uint8_t n3103; |
| 85 | uint8_t n3105; |
Andreas Eversberg | 5dac2f0 | 2012-06-27 15:52:04 +0200 | [diff] [blame] | 86 | struct gprs_rlcmac_trx trx[8]; |
Andreas Eversberg | 592e04a | 2012-07-15 06:25:37 +0200 | [diff] [blame] | 87 | int (*alloc_algorithm)(struct gprs_rlcmac_tbf *old_tbf, |
Andreas Eversberg | f01929b | 2012-10-08 12:40:49 +0200 | [diff] [blame] | 88 | struct gprs_rlcmac_tbf *tbf, uint32_t cust, uint8_t single); |
Andreas Eversberg | 592e04a | 2012-07-15 06:25:37 +0200 | [diff] [blame] | 89 | uint32_t alloc_algorithm_curst; /* options to customize algorithm */ |
Andreas Eversberg | 07e97cf | 2012-08-07 16:00:56 +0200 | [diff] [blame] | 90 | uint8_t force_two_phase; |
Andreas Eversberg | aafcbbb | 2012-09-27 09:20:45 +0200 | [diff] [blame] | 91 | uint8_t alpha, gamma; |
Andreas Eversberg | 5dac2f0 | 2012-06-27 15:52:04 +0200 | [diff] [blame] | 92 | }; |
| 93 | |
| 94 | extern struct gprs_rlcmac_bts *gprs_rlcmac_bts; |
| 95 | |
Andreas Eversberg | 8b761a3 | 2012-07-20 21:50:31 +0200 | [diff] [blame] | 96 | #ifdef __cplusplus |
Andreas Eversberg | 5dac2f0 | 2012-06-27 15:52:04 +0200 | [diff] [blame] | 97 | /* |
| 98 | * TBF instance |
| 99 | */ |
| 100 | |
Ivan Kluchnikov | 8ee6051 | 2012-03-05 19:24:57 +0400 | [diff] [blame] | 101 | #define LLC_MAX_LEN 1543 |
Andreas Eversberg | 5dac2f0 | 2012-06-27 15:52:04 +0200 | [diff] [blame] | 102 | #define RLC_MAX_SNS 128 /* GPRS, must be power of 2 */ |
| 103 | #define RLC_MAX_WS 64 /* max window size */ |
Andreas Eversberg | e6228b3 | 2012-07-03 13:36:03 +0200 | [diff] [blame] | 104 | #define RLC_MAX_LEN 54 /* CS-4 including spare bits */ |
Ivan Kluchnikov | 8ee6051 | 2012-03-05 19:24:57 +0400 | [diff] [blame] | 105 | |
Andreas Eversberg | a9be154 | 2012-09-27 09:23:24 +0200 | [diff] [blame] | 106 | #define Tassign_agch 0,200000 /* waiting after IMM.ASS confirm */ |
Andreas Eversberg | cbcd124 | 2012-08-07 15:48:21 +0200 | [diff] [blame] | 107 | #define Tassign_pacch 2,0 /* timeout for pacch assigment */ |
Andreas Eversberg | 5dac2f0 | 2012-06-27 15:52:04 +0200 | [diff] [blame] | 108 | |
Ivan Kluchnikov | 8ee6051 | 2012-03-05 19:24:57 +0400 | [diff] [blame] | 109 | enum gprs_rlcmac_tbf_state { |
Andreas Eversberg | e6228b3 | 2012-07-03 13:36:03 +0200 | [diff] [blame] | 110 | GPRS_RLCMAC_NULL = 0, /* new created TBF */ |
| 111 | GPRS_RLCMAC_ASSIGN, /* wait for downlink assignment */ |
Holger Hans Peter Freyther | 1115f59 | 2012-07-23 10:27:30 +0200 | [diff] [blame] | 112 | GPRS_RLCMAC_FLOW, /* RLC/MAC flow, resource needed */ |
Andreas Eversberg | 5dac2f0 | 2012-06-27 15:52:04 +0200 | [diff] [blame] | 113 | GPRS_RLCMAC_FINISHED, /* flow finished, wait for release */ |
Andreas Eversberg | e6228b3 | 2012-07-03 13:36:03 +0200 | [diff] [blame] | 114 | GPRS_RLCMAC_WAIT_RELEASE,/* wait for release or restart of DL TBF */ |
Andreas Eversberg | 5dac2f0 | 2012-06-27 15:52:04 +0200 | [diff] [blame] | 115 | GPRS_RLCMAC_RELEASING, /* releasing, wait to free TBI/USF */ |
| 116 | }; |
| 117 | |
| 118 | enum gprs_rlcmac_tbf_poll_state { |
| 119 | GPRS_RLCMAC_POLL_NONE = 0, |
| 120 | GPRS_RLCMAC_POLL_SCHED, /* a polling was scheduled */ |
| 121 | }; |
| 122 | |
Andreas Eversberg | e6228b3 | 2012-07-03 13:36:03 +0200 | [diff] [blame] | 123 | enum gprs_rlcmac_tbf_dl_ass_state { |
| 124 | GPRS_RLCMAC_DL_ASS_NONE = 0, |
| 125 | GPRS_RLCMAC_DL_ASS_SEND_ASS, /* send downlink assignment on next RTS */ |
| 126 | GPRS_RLCMAC_DL_ASS_WAIT_ACK, /* wait for PACKET CONTROL ACK */ |
| 127 | }; |
| 128 | |
| 129 | enum gprs_rlcmac_tbf_ul_ass_state { |
| 130 | GPRS_RLCMAC_UL_ASS_NONE = 0, |
| 131 | GPRS_RLCMAC_UL_ASS_SEND_ASS, /* send uplink assignment on next RTS */ |
| 132 | GPRS_RLCMAC_UL_ASS_WAIT_ACK, /* wait for PACKET CONTROL ACK */ |
| 133 | }; |
| 134 | |
| 135 | enum gprs_rlcmac_tbf_ul_ack_state { |
| 136 | GPRS_RLCMAC_UL_ACK_NONE = 0, |
| 137 | GPRS_RLCMAC_UL_ACK_SEND_ACK, /* send acknowledge on next RTS */ |
| 138 | GPRS_RLCMAC_UL_ACK_WAIT_ACK, /* wait for PACKET CONTROL ACK */ |
Ivan Kluchnikov | 8ee6051 | 2012-03-05 19:24:57 +0400 | [diff] [blame] | 139 | }; |
| 140 | |
| 141 | enum gprs_rlcmac_tbf_direction { |
| 142 | GPRS_RLCMAC_DL_TBF, |
| 143 | GPRS_RLCMAC_UL_TBF |
| 144 | }; |
| 145 | |
Andreas Eversberg | 14db19e | 2012-08-06 15:03:03 +0200 | [diff] [blame] | 146 | #define GPRS_RLCMAC_FLAG_CCCH 0 /* assignment on CCCH */ |
| 147 | #define GPRS_RLCMAC_FLAG_PACCH 1 /* assignment on PACCH */ |
| 148 | #define GPRS_RLCMAC_FLAG_UL_DATA 2 /* uplink data received */ |
| 149 | #define GPRS_RLCMAC_FLAG_DL_ACK 3 /* downlink acknowledge received */ |
| 150 | #define GPRS_RLCMAC_FLAG_TO_UL_ACK 4 |
| 151 | #define GPRS_RLCMAC_FLAG_TO_DL_ACK 5 |
| 152 | #define GPRS_RLCMAC_FLAG_TO_UL_ASS 6 |
| 153 | #define GPRS_RLCMAC_FLAG_TO_DL_ASS 7 |
Andreas Eversberg | a9be154 | 2012-09-27 09:23:24 +0200 | [diff] [blame] | 154 | #define GPRS_RLCMAC_FLAG_TO_MASK 0xf0 /* timeout bits */ |
Andreas Eversberg | 14db19e | 2012-08-06 15:03:03 +0200 | [diff] [blame] | 155 | |
Ivan Kluchnikov | 8ee6051 | 2012-03-05 19:24:57 +0400 | [diff] [blame] | 156 | struct gprs_rlcmac_tbf { |
| 157 | struct llist_head list; |
| 158 | enum gprs_rlcmac_tbf_state state; |
Andreas Eversberg | 14db19e | 2012-08-06 15:03:03 +0200 | [diff] [blame] | 159 | uint32_t state_flags; |
Ivan Kluchnikov | 8ee6051 | 2012-03-05 19:24:57 +0400 | [diff] [blame] | 160 | enum gprs_rlcmac_tbf_direction direction; |
| 161 | uint8_t tfi; |
| 162 | uint32_t tlli; |
Andreas Eversberg | 5dac2f0 | 2012-06-27 15:52:04 +0200 | [diff] [blame] | 163 | uint8_t tlli_valid; |
Andreas Eversberg | b0c7ea7 | 2012-07-13 14:46:03 +0200 | [diff] [blame] | 164 | uint8_t trx; |
| 165 | uint16_t arfcn; |
| 166 | uint8_t tsc; |
Andreas Eversberg | 592e04a | 2012-07-15 06:25:37 +0200 | [diff] [blame] | 167 | uint8_t first_ts; /* first TS used by TBF */ |
| 168 | uint8_t first_common_ts; /* first TS that the phone can send and |
| 169 | reveive simultaniously */ |
| 170 | uint8_t control_ts; /* timeslot control messages and polling */ |
Andreas Eversberg | f298fa8 | 2012-07-13 14:50:57 +0200 | [diff] [blame] | 171 | uint8_t ms_class; |
Andreas Eversberg | b0c7ea7 | 2012-07-13 14:46:03 +0200 | [diff] [blame] | 172 | struct gprs_rlcmac_pdch *pdch[8]; /* list of PDCHs allocated to TBF */ |
| 173 | uint16_t ta; |
Andreas Eversberg | e6228b3 | 2012-07-03 13:36:03 +0200 | [diff] [blame] | 174 | uint8_t llc_frame[LLC_MAX_LEN]; /* current DL or UL frame */ |
| 175 | uint16_t llc_index; /* current write/read position of frame */ |
| 176 | uint16_t llc_length; /* len of current DL LLC_frame, 0 == no frame */ |
Andreas Eversberg | 8b761a3 | 2012-07-20 21:50:31 +0200 | [diff] [blame] | 177 | struct llist_head llc_queue; /* queued LLC DL data */ |
Andreas Eversberg | e6228b3 | 2012-07-03 13:36:03 +0200 | [diff] [blame] | 178 | |
| 179 | enum gprs_rlcmac_tbf_dl_ass_state dl_ass_state; |
| 180 | enum gprs_rlcmac_tbf_ul_ass_state ul_ass_state; |
| 181 | enum gprs_rlcmac_tbf_ul_ack_state ul_ack_state; |
Andreas Eversberg | 5dac2f0 | 2012-06-27 15:52:04 +0200 | [diff] [blame] | 182 | |
| 183 | enum gprs_rlcmac_tbf_poll_state poll_state; |
Andreas Eversberg | b0c7ea7 | 2012-07-13 14:46:03 +0200 | [diff] [blame] | 184 | uint32_t poll_fn; /* frame number to poll */ |
Andreas Eversberg | 5dac2f0 | 2012-06-27 15:52:04 +0200 | [diff] [blame] | 185 | |
Andreas Eversberg | 5dac2f0 | 2012-06-27 15:52:04 +0200 | [diff] [blame] | 186 | uint16_t ws; /* window size */ |
| 187 | uint16_t sns; /* sequence number space */ |
Andreas Eversberg | e6228b3 | 2012-07-03 13:36:03 +0200 | [diff] [blame] | 188 | |
| 189 | /* Please note that all variables here will be reset when changing |
| 190 | * from WAIT RELEASE back to FLOW state (re-use of TBF). |
| 191 | * All states that need reset must be in this struct, so this is why |
| 192 | * variables are in both (dl and ul) structs and not outside union. |
| 193 | */ |
Andreas Eversberg | 5dac2f0 | 2012-06-27 15:52:04 +0200 | [diff] [blame] | 194 | union { |
| 195 | struct { |
Andreas Eversberg | e6228b3 | 2012-07-03 13:36:03 +0200 | [diff] [blame] | 196 | uint16_t bsn; /* block sequence number */ |
Andreas Eversberg | 5dac2f0 | 2012-06-27 15:52:04 +0200 | [diff] [blame] | 197 | uint16_t v_s; /* send state */ |
| 198 | uint16_t v_a; /* ack state */ |
| 199 | char v_b[RLC_MAX_SNS/2]; /* acknowledge state array */ |
Andreas Eversberg | e6228b3 | 2012-07-03 13:36:03 +0200 | [diff] [blame] | 200 | int32_t tx_counter; /* count all transmitted blocks */ |
Andreas Eversberg | a9be154 | 2012-09-27 09:23:24 +0200 | [diff] [blame] | 201 | char imsi[16]; /* store IMSI for PCH retransmission */ |
| 202 | uint8_t wait_confirm; /* wait for CCCH IMM.ASS cnf */ |
Andreas Eversberg | 5dac2f0 | 2012-06-27 15:52:04 +0200 | [diff] [blame] | 203 | } dl; |
| 204 | struct { |
Andreas Eversberg | e6228b3 | 2012-07-03 13:36:03 +0200 | [diff] [blame] | 205 | uint16_t bsn; /* block sequence number */ |
Andreas Eversberg | 5dac2f0 | 2012-06-27 15:52:04 +0200 | [diff] [blame] | 206 | uint16_t v_r; /* receive state */ |
| 207 | uint16_t v_q; /* receive window state */ |
| 208 | char v_n[RLC_MAX_SNS/2]; /* receive state array */ |
| 209 | int32_t rx_counter; /* count all received blocks */ |
Andreas Eversberg | 5dac2f0 | 2012-06-27 15:52:04 +0200 | [diff] [blame] | 210 | uint8_t n3103; /* N3103 counter */ |
Andreas Eversberg | b0c7ea7 | 2012-07-13 14:46:03 +0200 | [diff] [blame] | 211 | uint8_t usf[8]; /* list USFs per PDCH (timeslot) */ |
Andreas Eversberg | 08e93cd | 2012-07-26 08:13:06 +0200 | [diff] [blame] | 212 | uint8_t contention_resolution_done; /* set after done */ |
| 213 | uint8_t final_ack_sent; /* set if we sent final ack */ |
Andreas Eversberg | 5dac2f0 | 2012-06-27 15:52:04 +0200 | [diff] [blame] | 214 | } ul; |
| 215 | } dir; |
| 216 | uint8_t rlc_block[RLC_MAX_SNS/2][RLC_MAX_LEN]; /* block history */ |
| 217 | uint8_t rlc_block_len[RLC_MAX_SNS/2]; /* block len of history */ |
Ivan Kluchnikov | 61a33f7 | 2012-04-12 15:22:06 +0400 | [diff] [blame] | 218 | |
Andreas Eversberg | 802bb6e | 2012-08-06 11:15:05 +0200 | [diff] [blame] | 219 | uint8_t n3105; /* N3105 counter */ |
| 220 | |
Ivan Kluchnikov | 61a33f7 | 2012-04-12 15:22:06 +0400 | [diff] [blame] | 221 | struct osmo_timer_list timer; |
| 222 | unsigned int T; /* Txxxx number */ |
| 223 | unsigned int num_T_exp; /* number of consecutive T expirations */ |
| 224 | |
| 225 | struct osmo_gsm_timer_list gsm_timer; |
| 226 | unsigned int fT; /* fTxxxx number */ |
| 227 | unsigned int num_fT_exp; /* number of consecutive fT expirations */ |
Andreas Eversberg | b3ded4c | 2012-07-24 10:47:24 +0200 | [diff] [blame] | 228 | |
| 229 | struct timeval bw_tv; /* timestamp for bandwidth calculation */ |
| 230 | uint32_t bw_octets; /* number of octets transmitted since bw_tv */ |
Andreas Eversberg | 3b1332c | 2012-10-03 14:20:53 +0200 | [diff] [blame] | 231 | |
| 232 | uint8_t cs; /* current coding scheme */ |
Andreas Eversberg | b83e2a7 | 2012-10-07 15:26:00 +0200 | [diff] [blame] | 233 | |
| 234 | #ifdef DEBUG_DIAGRAM |
| 235 | int diag; /* number where TBF is presented in diagram */ |
| 236 | int diag_new; /* used to format output of new TBF */ |
| 237 | #endif |
Ivan Kluchnikov | 8ee6051 | 2012-03-05 19:24:57 +0400 | [diff] [blame] | 238 | }; |
| 239 | |
Andreas Eversberg | b0c7ea7 | 2012-07-13 14:46:03 +0200 | [diff] [blame] | 240 | extern struct llist_head gprs_rlcmac_ul_tbfs; /* list of uplink TBFs */ |
| 241 | extern struct llist_head gprs_rlcmac_dl_tbfs; /* list of downlink TBFs */ |
Andreas Eversberg | 07e97cf | 2012-08-07 16:00:56 +0200 | [diff] [blame] | 242 | extern struct llist_head gprs_rlcmac_sbas; /* list of single block allocs */ |
Ivan Kluchnikov | 8ee6051 | 2012-03-05 19:24:57 +0400 | [diff] [blame] | 243 | |
Andreas Eversberg | 2b91464 | 2012-07-19 13:06:26 +0200 | [diff] [blame] | 244 | /* |
| 245 | * paging entry |
| 246 | */ |
| 247 | struct gprs_rlcmac_paging { |
| 248 | struct llist_head list; |
| 249 | uint8_t chan_needed; |
| 250 | uint8_t identity_lv[9]; |
| 251 | }; |
Ivan Kluchnikov | 8ee6051 | 2012-03-05 19:24:57 +0400 | [diff] [blame] | 252 | |
Andreas Eversberg | 07e97cf | 2012-08-07 16:00:56 +0200 | [diff] [blame] | 253 | /* |
| 254 | * single block allocation entry |
| 255 | */ |
| 256 | struct gprs_rlcmac_sba { |
| 257 | struct llist_head list; |
| 258 | uint8_t trx; |
| 259 | uint8_t ts; |
| 260 | uint32_t fn; |
| 261 | uint8_t ta; |
| 262 | }; |
Ivan Kluchnikov | 8ee6051 | 2012-03-05 19:24:57 +0400 | [diff] [blame] | 263 | |
Andreas Eversberg | 3b1332c | 2012-10-03 14:20:53 +0200 | [diff] [blame] | 264 | /* |
| 265 | * coding scheme info |
| 266 | */ |
| 267 | struct gprs_rlcmac_cs { |
| 268 | uint8_t block_length; |
| 269 | uint8_t block_data; |
| 270 | uint8_t block_payload; |
| 271 | }; |
Ivan Kluchnikov | 8ee6051 | 2012-03-05 19:24:57 +0400 | [diff] [blame] | 272 | |
Andreas Eversberg | 3b1332c | 2012-10-03 14:20:53 +0200 | [diff] [blame] | 273 | extern struct gprs_rlcmac_cs gprs_rlcmac_cs[]; |
Andreas Eversberg | e6228b3 | 2012-07-03 13:36:03 +0200 | [diff] [blame] | 274 | |
Andreas Eversberg | b83e2a7 | 2012-10-07 15:26:00 +0200 | [diff] [blame] | 275 | #ifdef DEBUG_DIAGRAM |
| 276 | void debug_diagram(int diag, const char *format, ...); |
| 277 | #else |
| 278 | #define debug_diagram(a, b, args...) ; |
| 279 | #endif |
| 280 | |
Andreas Eversberg | 07e97cf | 2012-08-07 16:00:56 +0200 | [diff] [blame] | 281 | int sba_alloc(uint8_t *_trx, uint8_t *_ts, uint32_t *_fn, uint8_t ta); |
Andreas Eversberg | e6228b3 | 2012-07-03 13:36:03 +0200 | [diff] [blame] | 282 | |
Andreas Eversberg | 07e97cf | 2012-08-07 16:00:56 +0200 | [diff] [blame] | 283 | struct gprs_rlcmac_sba *sba_find(uint8_t trx, uint8_t ts, uint32_t fn); |
| 284 | |
Andreas Eversberg | 02d7cd2 | 2013-01-15 08:59:34 +0100 | [diff] [blame] | 285 | int tfi_alloc(enum gprs_rlcmac_tbf_direction dir, uint8_t *_trx, |
| 286 | int8_t use_trx); |
Ivan Kluchnikov | 8ee6051 | 2012-03-05 19:24:57 +0400 | [diff] [blame] | 287 | |
Andreas Eversberg | 592e04a | 2012-07-15 06:25:37 +0200 | [diff] [blame] | 288 | struct gprs_rlcmac_tbf *tbf_alloc(struct gprs_rlcmac_tbf *old_tbf, |
| 289 | enum gprs_rlcmac_tbf_direction dir, uint8_t tfi, uint8_t trx, |
Andreas Eversberg | 02d7cd2 | 2013-01-15 08:59:34 +0100 | [diff] [blame] | 290 | uint8_t ms_class, uint8_t single_slot); |
Andreas Eversberg | f298fa8 | 2012-07-13 14:50:57 +0200 | [diff] [blame] | 291 | |
Andreas Eversberg | adb2f18 | 2012-08-07 17:06:08 +0200 | [diff] [blame] | 292 | struct gprs_rlcmac_tbf *tbf_by_tfi(uint8_t tfi, uint8_t trx, |
Andreas Eversberg | b0c7ea7 | 2012-07-13 14:46:03 +0200 | [diff] [blame] | 293 | enum gprs_rlcmac_tbf_direction dir); |
Ivan Kluchnikov | 8ee6051 | 2012-03-05 19:24:57 +0400 | [diff] [blame] | 294 | |
Andreas Eversberg | b0c7ea7 | 2012-07-13 14:46:03 +0200 | [diff] [blame] | 295 | struct gprs_rlcmac_tbf *tbf_by_tlli(uint32_t tlli, |
| 296 | enum gprs_rlcmac_tbf_direction dir); |
Andreas Eversberg | e6228b3 | 2012-07-03 13:36:03 +0200 | [diff] [blame] | 297 | |
Andreas Eversberg | b0c7ea7 | 2012-07-13 14:46:03 +0200 | [diff] [blame] | 298 | struct gprs_rlcmac_tbf *tbf_by_poll_fn(uint32_t fn, uint8_t trx, uint8_t ts); |
Ivan Kluchnikov | 8ee6051 | 2012-03-05 19:24:57 +0400 | [diff] [blame] | 299 | |
Andreas Eversberg | 0aed654 | 2012-06-23 10:33:16 +0200 | [diff] [blame] | 300 | void tbf_free(struct gprs_rlcmac_tbf *tbf); |
Ivan Kluchnikov | 8ee6051 | 2012-03-05 19:24:57 +0400 | [diff] [blame] | 301 | |
Andreas Eversberg | 592e04a | 2012-07-15 06:25:37 +0200 | [diff] [blame] | 302 | int tbf_update(struct gprs_rlcmac_tbf *tbf); |
| 303 | |
| 304 | int tbf_assign_control_ts(struct gprs_rlcmac_tbf *tbf); |
| 305 | |
Andreas Eversberg | e6228b3 | 2012-07-03 13:36:03 +0200 | [diff] [blame] | 306 | void tbf_new_state(struct gprs_rlcmac_tbf *tbf, |
| 307 | enum gprs_rlcmac_tbf_state state); |
| 308 | |
Andreas Eversberg | 5dac2f0 | 2012-06-27 15:52:04 +0200 | [diff] [blame] | 309 | void tbf_timer_start(struct gprs_rlcmac_tbf *tbf, unsigned int T, |
Andreas Eversberg | e6228b3 | 2012-07-03 13:36:03 +0200 | [diff] [blame] | 310 | unsigned int seconds, unsigned int microseconds); |
Andreas Eversberg | 5dac2f0 | 2012-06-27 15:52:04 +0200 | [diff] [blame] | 311 | |
| 312 | void tbf_timer_stop(struct gprs_rlcmac_tbf *tbf); |
| 313 | |
Ivan Kluchnikov | 8ee6051 | 2012-03-05 19:24:57 +0400 | [diff] [blame] | 314 | /* TS 44.060 Section 10.4.7 Table 10.4.7.1: Payload Type field */ |
| 315 | enum gprs_rlcmac_block_type { |
| 316 | GPRS_RLCMAC_DATA_BLOCK = 0x0, |
| 317 | GPRS_RLCMAC_CONTROL_BLOCK = 0x1, |
| 318 | GPRS_RLCMAC_CONTROL_BLOCK_OPT = 0x2, |
| 319 | GPRS_RLCMAC_RESERVED = 0x3 |
| 320 | }; |
| 321 | |
Andreas Eversberg | b0c7ea7 | 2012-07-13 14:46:03 +0200 | [diff] [blame] | 322 | int gprs_rlcmac_rcv_block(uint8_t trx, uint8_t ts, uint8_t *data, uint8_t len, |
| 323 | uint32_t fn); |
Ivan Kluchnikov | a9e6dc5 | 2012-06-17 08:30:06 +0400 | [diff] [blame] | 324 | |
Andreas Eversberg | e6228b3 | 2012-07-03 13:36:03 +0200 | [diff] [blame] | 325 | int write_immediate_assignment(bitvec * dest, uint8_t downlink, uint8_t ra, |
Andreas Eversberg | 07e97cf | 2012-08-07 16:00:56 +0200 | [diff] [blame] | 326 | uint32_t ref_fn, uint8_t ta, uint16_t arfcn, uint8_t ts, uint8_t tsc, |
Andreas Eversberg | e6228b3 | 2012-07-03 13:36:03 +0200 | [diff] [blame] | 327 | uint8_t tfi, uint8_t usf, uint32_t tlli, uint8_t polling, |
Andreas Eversberg | afdd9e1 | 2012-10-07 17:08:55 +0200 | [diff] [blame] | 328 | uint32_t fn, uint8_t single_block, uint8_t alpha, uint8_t gamma, |
| 329 | int8_t ta_idx); |
Ivan Kluchnikov | cf7b3a5 | 2012-06-26 16:54:22 +0400 | [diff] [blame] | 330 | |
Andreas Eversberg | e6228b3 | 2012-07-03 13:36:03 +0200 | [diff] [blame] | 331 | void write_packet_uplink_assignment(bitvec * dest, uint8_t old_tfi, |
Andreas Eversberg | b0c7ea7 | 2012-07-13 14:46:03 +0200 | [diff] [blame] | 332 | uint8_t old_downlink, uint32_t tlli, uint8_t use_tlli, |
Andreas Eversberg | aafcbbb | 2012-09-27 09:20:45 +0200 | [diff] [blame] | 333 | struct gprs_rlcmac_tbf *tbf, uint8_t poll, uint8_t alpha, |
Andreas Eversberg | afdd9e1 | 2012-10-07 17:08:55 +0200 | [diff] [blame] | 334 | uint8_t gamma, int8_t ta_idx); |
Ivan Kluchnikov | a9e6dc5 | 2012-06-17 08:30:06 +0400 | [diff] [blame] | 335 | |
Ivan Kluchnikov | ef7f28c | 2012-07-12 14:49:15 +0400 | [diff] [blame] | 336 | void write_packet_downlink_assignment(RlcMacDownlink_t * block, uint8_t old_tfi, |
Andreas Eversberg | aafcbbb | 2012-09-27 09:20:45 +0200 | [diff] [blame] | 337 | uint8_t old_downlink, struct gprs_rlcmac_tbf *tbf, uint8_t poll, |
Andreas Eversberg | afdd9e1 | 2012-10-07 17:08:55 +0200 | [diff] [blame] | 338 | uint8_t alpha, uint8_t gamma, int8_t ta_idx, uint8_t ta_ts); |
Andreas Eversberg | b0c7ea7 | 2012-07-13 14:46:03 +0200 | [diff] [blame] | 339 | |
| 340 | |
Ivan Kluchnikov | a9e6dc5 | 2012-06-17 08:30:06 +0400 | [diff] [blame] | 341 | |
Ivan Kluchnikov | ef7f28c | 2012-07-12 14:49:15 +0400 | [diff] [blame] | 342 | void write_packet_uplink_ack(RlcMacDownlink_t * block, struct gprs_rlcmac_tbf *tbf, |
Andreas Eversberg | e6228b3 | 2012-07-03 13:36:03 +0200 | [diff] [blame] | 343 | uint8_t final); |
Ivan Kluchnikov | a9e6dc5 | 2012-06-17 08:30:06 +0400 | [diff] [blame] | 344 | |
Andreas Eversberg | 3e372d5 | 2012-07-06 09:28:15 +0200 | [diff] [blame] | 345 | int gprs_rlcmac_tx_ul_ud(gprs_rlcmac_tbf *tbf); |
Ivan Kluchnikov | a9e6dc5 | 2012-06-17 08:30:06 +0400 | [diff] [blame] | 346 | |
Andreas Eversberg | e6228b3 | 2012-07-03 13:36:03 +0200 | [diff] [blame] | 347 | void tbf_timer_cb(void *_tbf); |
Ivan Kluchnikov | a9e6dc5 | 2012-06-17 08:30:06 +0400 | [diff] [blame] | 348 | |
Andreas Eversberg | e6228b3 | 2012-07-03 13:36:03 +0200 | [diff] [blame] | 349 | int gprs_rlcmac_poll_timeout(struct gprs_rlcmac_tbf *tbf); |
Andreas Eversberg | 0aed654 | 2012-06-23 10:33:16 +0200 | [diff] [blame] | 350 | |
| 351 | int gprs_rlcmac_rcv_rach(uint8_t ra, uint32_t Fn, int16_t qta); |
Ivan Kluchnikov | 5310d45 | 2012-04-17 22:00:31 +0400 | [diff] [blame] | 352 | |
Andreas Eversberg | b0c7ea7 | 2012-07-13 14:46:03 +0200 | [diff] [blame] | 353 | int gprs_rlcmac_rcv_control_block(bitvec *rlc_block, uint8_t trx, uint8_t ts, |
| 354 | uint32_t fn); |
Ivan Kluchnikov | 8ee6051 | 2012-03-05 19:24:57 +0400 | [diff] [blame] | 355 | |
Andreas Eversberg | e6228b3 | 2012-07-03 13:36:03 +0200 | [diff] [blame] | 356 | struct msgb *gprs_rlcmac_send_packet_uplink_assignment( |
| 357 | struct gprs_rlcmac_tbf *tbf, uint32_t fn); |
Ivan Kluchnikov | 8ee6051 | 2012-03-05 19:24:57 +0400 | [diff] [blame] | 358 | |
Andreas Eversberg | e6228b3 | 2012-07-03 13:36:03 +0200 | [diff] [blame] | 359 | struct msgb *gprs_rlcmac_send_packet_downlink_assignment( |
| 360 | struct gprs_rlcmac_tbf *tbf, uint32_t fn); |
Ivan Kluchnikov | c320d86 | 2012-03-18 15:04:48 +0400 | [diff] [blame] | 361 | |
Andreas Eversberg | 7f5352c | 2012-07-23 18:20:36 +0200 | [diff] [blame] | 362 | void gprs_rlcmac_trigger_downlink_assignment(struct gprs_rlcmac_tbf *tbf, |
| 363 | struct gprs_rlcmac_tbf *old_tbf, char *imsi); |
Ivan Kluchnikov | c7e7f68 | 2012-06-29 22:53:15 +0400 | [diff] [blame] | 364 | |
Andreas Eversberg | e6228b3 | 2012-07-03 13:36:03 +0200 | [diff] [blame] | 365 | int gprs_rlcmac_downlink_ack(struct gprs_rlcmac_tbf *tbf, uint8_t final, |
| 366 | uint8_t ssn, uint8_t *rbb); |
Andreas Eversberg | 5dac2f0 | 2012-06-27 15:52:04 +0200 | [diff] [blame] | 367 | |
Andreas Eversberg | 8c3680d | 2012-10-08 12:30:56 +0200 | [diff] [blame] | 368 | int gprs_rlcmac_paging_request(uint8_t *ptmsi, uint16_t ptmsi_len, |
| 369 | const char *imsi); |
| 370 | |
Andreas Eversberg | 2b91464 | 2012-07-19 13:06:26 +0200 | [diff] [blame] | 371 | unsigned write_packet_paging_request(bitvec * dest); |
| 372 | |
| 373 | unsigned write_repeated_page_info(bitvec * dest, unsigned& wp, uint8_t len, |
| 374 | uint8_t *identity, uint8_t chan_needed); |
| 375 | |
Andreas Eversberg | b0c7ea7 | 2012-07-13 14:46:03 +0200 | [diff] [blame] | 376 | int gprs_rlcmac_rcv_data_block_acknowledged(uint8_t trx, uint8_t ts, |
| 377 | uint8_t *data, uint8_t len); |
Andreas Eversberg | 5dac2f0 | 2012-06-27 15:52:04 +0200 | [diff] [blame] | 378 | |
Andreas Eversberg | e6228b3 | 2012-07-03 13:36:03 +0200 | [diff] [blame] | 379 | struct msgb *gprs_rlcmac_send_data_block_acknowledged( |
Andreas Eversberg | 592e04a | 2012-07-15 06:25:37 +0200 | [diff] [blame] | 380 | struct gprs_rlcmac_tbf *tbf, uint32_t fn, uint8_t ts); |
Andreas Eversberg | e6228b3 | 2012-07-03 13:36:03 +0200 | [diff] [blame] | 381 | |
Andreas Eversberg | 5dac2f0 | 2012-06-27 15:52:04 +0200 | [diff] [blame] | 382 | struct msgb *gprs_rlcmac_send_uplink_ack(struct gprs_rlcmac_tbf *tbf, |
| 383 | uint32_t fn); |
Ivan Kluchnikov | 9c795ab | 2012-05-24 23:12:59 +0400 | [diff] [blame] | 384 | |
Andreas Eversberg | e6228b3 | 2012-07-03 13:36:03 +0200 | [diff] [blame] | 385 | int gprs_rlcmac_rcv_rts_block(uint8_t trx, uint8_t ts, uint16_t arfcn, |
| 386 | uint32_t fn, uint8_t block_nr); |
| 387 | |
Andreas Eversberg | a9be154 | 2012-09-27 09:23:24 +0200 | [diff] [blame] | 388 | int gprs_rlcmac_imm_ass_cnf(uint8_t *data, uint32_t fn); |
| 389 | |
Andreas Eversberg | 2b91464 | 2012-07-19 13:06:26 +0200 | [diff] [blame] | 390 | int gprs_rlcmac_add_paging(uint8_t chan_needed, uint8_t *identity_lv); |
| 391 | |
| 392 | struct gprs_rlcmac_paging *gprs_rlcmac_dequeue_paging( |
| 393 | struct gprs_rlcmac_pdch *pdch); |
| 394 | |
| 395 | struct msgb *gprs_rlcmac_send_packet_paging_request( |
| 396 | struct gprs_rlcmac_pdch *pdch); |
Andreas Eversberg | a1503fa | 2012-07-22 08:58:09 +0200 | [diff] [blame] | 397 | |
| 398 | extern "C" { |
| 399 | #endif |
| 400 | int alloc_algorithm_a(struct gprs_rlcmac_tbf *old_tbf, |
Andreas Eversberg | f01929b | 2012-10-08 12:40:49 +0200 | [diff] [blame] | 401 | struct gprs_rlcmac_tbf *tbf, uint32_t cust, uint8_t single); |
Andreas Eversberg | a1503fa | 2012-07-22 08:58:09 +0200 | [diff] [blame] | 402 | |
| 403 | int alloc_algorithm_b(struct gprs_rlcmac_tbf *old_tbf, |
Andreas Eversberg | f01929b | 2012-10-08 12:40:49 +0200 | [diff] [blame] | 404 | struct gprs_rlcmac_tbf *tbf, uint32_t cust, uint8_t single); |
Andreas Eversberg | a1503fa | 2012-07-22 08:58:09 +0200 | [diff] [blame] | 405 | #ifdef __cplusplus |
| 406 | } |
Andreas Eversberg | 8b761a3 | 2012-07-20 21:50:31 +0200 | [diff] [blame] | 407 | #endif |
Andreas Eversberg | 2b91464 | 2012-07-19 13:06:26 +0200 | [diff] [blame] | 408 | |
Ivan Kluchnikov | 8ee6051 | 2012-03-05 19:24:57 +0400 | [diff] [blame] | 409 | #endif // GPRS_RLCMAC_H |