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