blob: d581fe9d926a87d2ab4d463e37cb63ceaf6a71c8 [file] [log] [blame]
Holger Hans Peter Freyther6ca0a902013-10-19 18:50:22 +02001/* encoding.cpp
2 *
3 * Copyright (C) 2012 Ivan Klyuchnikov
4 * Copyright (C) 2012 Andreas Eversberg <jolly@eversberg.eu>
5 * Copyright (C) 2013 by Holger Hans Peter Freyther
6 *
7 * This program is free software; you can redistribute it and/or
8 * modify it under the terms of the GNU General Public License
9 * as published by the Free Software Foundation; either version 2
10 * of the License, or (at your option) any later version.
11 *
12 * This program is distributed in the hope that it will be useful,
13 * but WITHOUT ANY WARRANTY; without even the implied warranty of
14 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
15 * GNU General Public License for more details.
16 *
17 * You should have received a copy of the GNU General Public License
18 * along with this program; if not, write to the Free Software
19 * Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
20 */
21
Holger Hans Peter Freyther63f29d62013-10-19 19:04:03 +020022#include <encoding.h>
Holger Hans Peter Freyther6ca0a902013-10-19 18:50:22 +020023#include <gprs_rlcmac.h>
Holger Hans Peter Freyther34bd8bd2013-10-19 21:10:38 +020024#include <bts.h>
Holger Hans Peter Freyther6ca0a902013-10-19 18:50:22 +020025#include <tbf.h>
Pau Espin Pedrol9d1cdb12019-09-25 17:47:02 +020026#include <tbf_ul.h>
Holger Hans Peter Freyther6ca0a902013-10-19 18:50:22 +020027#include <gprs_debug.h>
sivasankari8adfcd02017-01-16 15:41:21 +053028#include <egprs_rlc_compression.h>
Holger Hans Peter Freyther6ca0a902013-10-19 18:50:22 +020029
Tom Tsoudf698092016-07-11 17:05:19 -070030extern "C" {
31#include <osmocom/gprs/protocol/gsm_04_60.h>
Maxd5720542016-07-14 15:41:17 +020032#include <osmocom/gsm/protocol/gsm_04_08.h>
Neels Hofmeyr59fc0bd2020-08-21 16:21:23 +020033#include <osmocom/gsm/gsm48.h>
Max0c55bf12019-02-19 18:08:27 +010034}
Maxd5720542016-07-14 15:41:17 +020035
36#include <stdbool.h>
Jacob Erlbeckf0e40392016-01-08 10:07:53 +010037#include <errno.h>
38#include <string.h>
39
Max23c0e012019-02-19 17:49:27 +010040#define CHECK(rc) { if (rc < 0) return rc; }
41#define SET_X(bv, x) { if (bitvec_set_bit(bv, x) < 0) return -EOWNERDEAD; }
42#define SET_0(bv) SET_X(bv, ZERO)
43#define SET_1(bv) SET_X(bv, ONE)
44#define SET_L(bv) SET_X(bv, L)
45#define SET_H(bv) SET_X(bv, H)
46
47/* 3GPP TS 44.018 § 10.5.2.16:
48 { 0 | 1 < ALPHA : bit (4) > }
49 < GAMMA : bit (5) >
50*/
51static int write_alpha_gamma(bitvec *dest, uint8_t alpha, uint8_t gamma)
52{
53 int rc;
54
55 if (alpha) {
56 SET_1(dest);
57 rc = bitvec_set_u64(dest, alpha, 4, false);
58 CHECK(rc);
59 } else
60 SET_0(dest);
61
62 rc = bitvec_set_u64(dest, gamma, 5, false);
63 CHECK(rc);
64
65 return 0;
66}
67
68/* TBF_STARTING_TIME -- same as 3GPP TS 44.018 §10.5.2.38 Starting Time without tag: */
69static int write_tbf_start_time(bitvec *dest, uint32_t fn)
70{
71 int rc;
72
73 /* Set values according to 3GPP TS 44.018 Table 10.5.2.38.1 */
74
75 /* T1' */
76 rc = bitvec_set_u64(dest, (fn / (26 * 51)) % 32, 5, false);
77 CHECK(rc);
78
79 /* T3 */
80 rc = bitvec_set_u64(dest, fn % 51, 6, false);
81 CHECK(rc);
82
83 /* T2 */
84 rc = bitvec_set_u64(dest, fn % 26, 5, false);
85 CHECK(rc);
86
87 return rc;
88}
89
Max2a47c732019-02-19 18:25:13 +010090/* 3GPP TS 44.018 §10.5.2.16:
91 < TFI_ASSIGNMENT : bit (5) >
92 < POLLING : bit >
93 0 -- The value '1' was allocated in an earlier version of the protocol and shall not be used.
94 < USF: bit (3) >
95 < USF_GRANULARITY : bit >
96 { 0 | 1 < P0 : bit (4) > < PR_MODE : bit (1) > }
97*/
98static int write_tfi_usf(bitvec *dest, const gprs_rlcmac_ul_tbf *tbf, uint8_t usf)
99{
Alexander Couzensb3b0c492019-10-04 03:40:26 +0200100 int rc = bitvec_set_u64(dest, tbf->tfi(), 5, false); /* TFI_ASSIGNMENT */
101 CHECK(rc);
Max2a47c732019-02-19 18:25:13 +0100102
Alexander Couzensb3b0c492019-10-04 03:40:26 +0200103 SET_0(dest); /* POLLING -- no action is required from MS */
Max2a47c732019-02-19 18:25:13 +0100104
Alexander Couzensb3b0c492019-10-04 03:40:26 +0200105 SET_0(dest);
Max2a47c732019-02-19 18:25:13 +0100106
Alexander Couzensb3b0c492019-10-04 03:40:26 +0200107 rc = bitvec_set_u64(dest, usf, 3, false); /* USF */
108 CHECK(rc);
Max2a47c732019-02-19 18:25:13 +0100109
Alexander Couzensb3b0c492019-10-04 03:40:26 +0200110 SET_0(dest); /* USF_GRANULARITY -- the mobile station shall transmit one RLC/MAC block */
Max2a47c732019-02-19 18:25:13 +0100111
Alexander Couzensb3b0c492019-10-04 03:40:26 +0200112 SET_0(dest); /* No P0 nor PR_MODE */
Max2a47c732019-02-19 18:25:13 +0100113
Alexander Couzensb3b0c492019-10-04 03:40:26 +0200114 return 0;
Max2a47c732019-02-19 18:25:13 +0100115}
116
Maxae483812016-07-28 12:03:08 +0200117/* { 0 | 1 < TIMING_ADVANCE_INDEX : bit (4) > } */
Max23c0e012019-02-19 17:49:27 +0100118static int write_ta_index(bitvec *dest, int8_t tai)
119{
120 int rc;
121
Max02fbfc12019-03-13 15:55:54 +0100122 if (tai < 0) { /* No TIMING_ADVANCE_INDEX: */
Max23c0e012019-02-19 17:49:27 +0100123 SET_0(dest);
Max02fbfc12019-03-13 15:55:54 +0100124 } else { /* TIMING_ADVANCE_INDEX: */
125 SET_1(dest);
126 rc = bitvec_set_u64(dest, tai, 4, false);
127 CHECK(rc);
128 }
Max23c0e012019-02-19 17:49:27 +0100129
130 return 0;
131}
132
Maxae483812016-07-28 12:03:08 +0200133static inline bool write_tai(bitvec *dest, unsigned& wp, int8_t tai)
134{
135 if (tai < 0) { /* No TIMING_ADVANCE_INDEX: */
Alexander Couzensccde5c92017-02-04 03:10:08 +0100136 bitvec_write_field(dest, &wp, 0, 1);
Maxae483812016-07-28 12:03:08 +0200137 return false;
138 }
139 /* TIMING_ADVANCE_INDEX: */
Alexander Couzensccde5c92017-02-04 03:10:08 +0100140 bitvec_write_field(dest, &wp, 1, 1);
141 bitvec_write_field(dest, &wp, tai, 4);
Maxae483812016-07-28 12:03:08 +0200142 return true;
143}
144
145/* { 0 | 1 < TIMING_ADVANCE_VALUE : bit (6) > } */
Pau Espin Pedrol732373d2020-07-07 17:20:59 +0200146static inline void write_ta(bitvec *dest, unsigned& wp, uint8_t ta)
Maxae483812016-07-28 12:03:08 +0200147{
Vadim Yanitskiy7a1fdfd2020-08-20 17:26:31 +0700148 if (ta > 63) /* No TIMING_ADVANCE_VALUE: */
Alexander Couzensccde5c92017-02-04 03:10:08 +0100149 bitvec_write_field(dest, &wp, 0, 1);
Maxae483812016-07-28 12:03:08 +0200150 else { /* TIMING_ADVANCE_VALUE: */
Alexander Couzensccde5c92017-02-04 03:10:08 +0100151 bitvec_write_field(dest, &wp, 1, 1);
152 bitvec_write_field(dest, &wp, ta, 6);
Maxae483812016-07-28 12:03:08 +0200153 }
154}
155
Maxa4f570f2017-12-15 11:21:57 +0100156/* 3GPP TS 44.060 Table 12.5.2.1 */
157static inline uint16_t enc_ws(uint16_t ws)
158{
159 return (ws - 64) / 32;
160}
161
162static inline void write_ws(bitvec *dest, unsigned int *write_index, uint16_t ws)
163{
164 dest->cur_bit = *write_index;
165
Vadim Yanitskiy9a530a22020-02-09 03:59:52 +0700166 int rc = bitvec_set_u64(dest, enc_ws(ws), 5, false);
167 OSMO_ASSERT(rc == 0);
Maxa4f570f2017-12-15 11:21:57 +0100168
169 *write_index += 5;
170}
171
Maxae483812016-07-28 12:03:08 +0200172/* 3GPP TS 44.060 § 12.12:
173 { 0 | 1 < TIMING_ADVANCE_VALUE : bit (6) > }
174 { 0 | 1 < TIMING_ADVANCE_INDEX : bit (4) >
175 < TIMING_ADVANCE_TIMESLOT_NUMBER : bit (3) > }
176 */
177static inline void write_ta_ie(bitvec *dest, unsigned& wp,
Pau Espin Pedrol732373d2020-07-07 17:20:59 +0200178 uint8_t ta, int8_t tai, uint8_t ts)
Maxae483812016-07-28 12:03:08 +0200179{
180 write_ta(dest, wp, ta);
181 if (write_tai(dest, wp, tai)) /* TIMING_ADVANCE_TIMESLOT_NUMBER: */
Alexander Couzensccde5c92017-02-04 03:10:08 +0100182 bitvec_write_field(dest, &wp, ts, 3);
Maxae483812016-07-28 12:03:08 +0200183}
184
Max0160a292019-02-19 15:37:03 +0100185static int write_ia_rest_downlink(const gprs_rlcmac_dl_tbf *tbf, bitvec * dest, bool polling, bool ta_valid,
Max23c0e012019-02-19 17:49:27 +0100186 uint32_t fn, uint8_t alpha, uint8_t gamma, int8_t ta_idx)
Jacob Erlbeck18831c32016-02-01 15:23:35 +0100187{
Max0160a292019-02-19 15:37:03 +0100188 int rc = 0;
189
Max23c0e012019-02-19 17:49:27 +0100190 SET_H(dest); SET_H(dest);
191 SET_0(dest); SET_1(dest); /* 00 Packet Downlink Assignment */
192
193 rc = bitvec_set_u64(dest, tbf->tlli(), 32, false); /* TLLI */
194 CHECK(rc);
195
196 SET_1(dest);
197 rc = bitvec_set_u64(dest, tbf->tfi(), 5, false); /* TFI_ASSIGNMENT */
198 CHECK(rc);
199
200 /* RLC acknowledged mode */
Vadim Yanitskiy3f2022e2020-05-23 19:23:56 +0700201 rc = bitvec_set_bit(dest, (bit_value) RLC_MODE_ACKNOWLEDGED);
202 CHECK(rc);
Max23c0e012019-02-19 17:49:27 +0100203
204 rc = write_alpha_gamma(dest, alpha, gamma);
205 CHECK(rc);
206
Alexander Couzensb3b0c492019-10-04 03:40:26 +0200207 rc = bitvec_set_bit(dest, (bit_value) polling); /* POLLING */
Max23c0e012019-02-19 17:49:27 +0100208 CHECK(rc);
209
210 /* N. B: NOT related to TAI! */
Alexander Couzensb3b0c492019-10-04 03:40:26 +0200211 rc = bitvec_set_bit(dest, (bit_value) ta_valid); /* TA_VALID */
Max23c0e012019-02-19 17:49:27 +0100212 CHECK(rc);
213
214 rc = write_ta_index(dest, ta_idx);
215 CHECK(rc);
216
Jacob Erlbeck18831c32016-02-01 15:23:35 +0100217 if (polling) {
Max23c0e012019-02-19 17:49:27 +0100218 SET_1(dest);
219 rc = write_tbf_start_time(dest, fn);
220 CHECK(rc);
Alexander Couzensb3b0c492019-10-04 03:40:26 +0200221 } else
Max23c0e012019-02-19 17:49:27 +0100222 SET_0(dest);
223
224 SET_0(dest); /* No P0 nor PR_MODE */
225
Jacob Erlbeckbe80c362016-02-01 16:39:52 +0100226 if (tbf->is_egprs_enabled()) {
Max23c0e012019-02-19 17:49:27 +0100227 SET_H(dest);
228 rc = bitvec_set_u64(dest, enc_ws(tbf->window_size()), 5, false); /* EGPRS Window Size */
229 CHECK(rc);
230
Alexander Couzensb3b0c492019-10-04 03:40:26 +0200231 /* The mobile station shall not report measurements: (see 3GPP TS 44.060 Table 11.2.7.1) */
Max23c0e012019-02-19 17:49:27 +0100232 SET_0(dest); SET_0(dest); /* LINK_QUALITY_MEASUREMENT_MODE */
233 SET_1(dest); /* No BEP_PERIOD2 */
234 } else
235 SET_L(dest); /* No Additions for Rel-6 */
Jacob Erlbeck2647a332016-02-01 16:13:38 +0100236
Max0160a292019-02-19 15:37:03 +0100237 return rc;
Jacob Erlbeck18831c32016-02-01 15:23:35 +0100238}
239
Max3eb47362019-02-19 18:41:22 +0100240/* 3GPP TS 44.018 Table 10.5.2.16.1 < Packet Uplink Assignment > -- Single Block Allocation */
241static int write_ia_rest_uplink_sba(bitvec *dest, uint32_t fn, uint8_t alpha, uint8_t gamma)
Jacob Erlbeck18831c32016-02-01 15:23:35 +0100242{
Max0160a292019-02-19 15:37:03 +0100243 int rc = 0;
Jacob Erlbeckbe80c362016-02-01 16:39:52 +0100244
Max3eb47362019-02-19 18:41:22 +0100245 SET_0(dest); /* Single Block Allocation */
246 rc = write_alpha_gamma(dest, alpha, gamma);
247 CHECK(rc);
Max0160a292019-02-19 15:37:03 +0100248
Max3eb47362019-02-19 18:41:22 +0100249 /* A 'Timing Advance index' shall not be allocated at a Single Block allocation.
250 A 'TBF Starting Time' shall be allocated at a Single Block allocation. */
251 SET_0(dest);
252 SET_1(dest);
Max0160a292019-02-19 15:37:03 +0100253
Max3eb47362019-02-19 18:41:22 +0100254 rc = write_tbf_start_time(dest, fn);
255 CHECK(rc);
256
257 /* No P0 nor PR_MODE */
258 SET_L(dest);
259
260 /* No Additions for R99 */
261 SET_L(dest);
262
263 /* No Additions for Rel-6 */
264 SET_L(dest);
Max0160a292019-02-19 15:37:03 +0100265
266 return rc;
Jacob Erlbeck18831c32016-02-01 15:23:35 +0100267}
268
Max0160a292019-02-19 15:37:03 +0100269static int write_ia_rest_uplink_mba(const gprs_rlcmac_ul_tbf *tbf, bitvec *dest, uint8_t usf,
Maxe742cc02019-03-12 18:42:09 +0100270 uint8_t alpha, uint8_t gamma, int8_t ta_idx)
Jacob Erlbeckbe80c362016-02-01 16:39:52 +0100271{
Max0160a292019-02-19 15:37:03 +0100272 int rc = 0;
bhargava465f5bb2016-09-02 16:50:43 +0530273
Max0367ddd2019-03-12 18:31:54 +0100274 SET_1(dest); /* Multi Block Allocation */
bhargava465f5bb2016-09-02 16:50:43 +0530275
Max0367ddd2019-03-12 18:31:54 +0100276 rc = write_tfi_usf(dest, tbf, usf);
277 CHECK(rc);
bhargava465f5bb2016-09-02 16:50:43 +0530278
Max0367ddd2019-03-12 18:31:54 +0100279 /* 3GPP TS 44.060 Table 11.2.28.2 Channel Coding Indicator */
280 rc = bitvec_set_u64(dest, mcs_chan_code(tbf->current_cs()), 2, false); /* CHANNEL_CODING_COMMAND */
281 CHECK(rc);
282
283 /* TLLI_BLOCK_CHANNEL_CODING */
284 SET_1(dest); /* use coding scheme as specified by the corresponding CHANNEL CODING COMMAND */
285
286 rc = write_alpha_gamma(dest, alpha, gamma);
287 CHECK(rc);
288
Maxe742cc02019-03-12 18:42:09 +0100289 rc = write_ta_index(dest, ta_idx);
290 CHECK(rc);
Max0367ddd2019-03-12 18:31:54 +0100291
292 /* No TBF_STARTING_TIME */
293 SET_0(dest);
bhargava465f5bb2016-09-02 16:50:43 +0530294
Max0160a292019-02-19 15:37:03 +0100295 return rc;
296}
bhargava465f5bb2016-09-02 16:50:43 +0530297
Maxbd5647e2019-02-19 18:10:12 +0100298static int write_ia_rest_egprs_uplink_mba(bitvec * dest, uint32_t fn, uint8_t alpha, uint8_t gamma)
Max0160a292019-02-19 15:37:03 +0100299{
300 int rc = 0;
bhargava465f5bb2016-09-02 16:50:43 +0530301
Maxbd5647e2019-02-19 18:10:12 +0100302 SET_0(dest); /* Multi Block Allocation */
bhargava465f5bb2016-09-02 16:50:43 +0530303
Maxbd5647e2019-02-19 18:10:12 +0100304 rc = write_alpha_gamma(dest, alpha, gamma);
305 CHECK(rc);
bhargava465f5bb2016-09-02 16:50:43 +0530306
Maxbd5647e2019-02-19 18:10:12 +0100307 rc = write_tbf_start_time(dest, fn);
308 CHECK(rc);
Max0160a292019-02-19 15:37:03 +0100309
Maxbd5647e2019-02-19 18:10:12 +0100310 SET_0(dest); /* NUMBER OF RADIO BLOCKS ALLOCATED: */
311 SET_0(dest); /* 1 radio block reserved for uplink transmission */
312 SET_0(dest); /* No P0 */
Max0160a292019-02-19 15:37:03 +0100313
314 return rc;
315}
316
317static int write_ia_rest_egprs_uplink_sba(const gprs_rlcmac_ul_tbf *tbf, bitvec * dest, uint8_t usf,
Maxe742cc02019-03-12 18:42:09 +0100318 uint8_t alpha, uint8_t gamma, int8_t ta_idx)
Max0160a292019-02-19 15:37:03 +0100319{
320 int rc = 0;
321
Max2a47c732019-02-19 18:25:13 +0100322 SET_1(dest); /* Single Block Allocation */
Max0160a292019-02-19 15:37:03 +0100323
Max2a47c732019-02-19 18:25:13 +0100324 rc = write_tfi_usf(dest, tbf, usf);
325 CHECK(rc);
Max0160a292019-02-19 15:37:03 +0100326
Max2a47c732019-02-19 18:25:13 +0100327 /* 3GPP TS 44.060 §12.10d EGPRS Modulation and coding Scheme description: */
Max6e96dd42019-03-06 18:17:32 +0100328 rc = bitvec_set_u64(dest, mcs_chan_code(tbf->current_cs()), 4, false); /* EGPRS CHANNEL_CODING_COMMAND */
Max2a47c732019-02-19 18:25:13 +0100329 CHECK(rc);
Max0160a292019-02-19 15:37:03 +0100330
Max2a47c732019-02-19 18:25:13 +0100331 /* TLLI_BLOCK_CHANNEL_CODING */
332 rc = bitvec_set_bit(dest, (bit_value)tbf->tlli());
Vadim Yanitskiy4c593c82020-05-24 02:01:28 +0700333 CHECK(rc);
Max0160a292019-02-19 15:37:03 +0100334
Max2a47c732019-02-19 18:25:13 +0100335 /* No BEP_PERIOD2 */
336 SET_0(dest);
337
338 /* Retransmitted RLC data blocks shall not be re-segmented: (see 3GPP TS 44.060 §12.10e) */
339 SET_0(dest); /* RESEGMENT */
340
341 rc = bitvec_set_u64(dest, enc_ws(tbf->window_size()), 5, false); /* EGPRS Window Size */
342 CHECK(rc);
343
344 rc = write_alpha_gamma(dest, alpha, gamma);
345 CHECK(rc);
346
Maxe742cc02019-03-12 18:42:09 +0100347 rc = write_ta_index(dest, ta_idx);
348 CHECK(rc);
Max2a47c732019-02-19 18:25:13 +0100349
350 /* No TBF_STARTING_TIME */
351 SET_0(dest);
352
353 /* No Additions for Rel-7 */
354 SET_0(dest);
Max0160a292019-02-19 15:37:03 +0100355
356 return rc;
Jacob Erlbeckbe80c362016-02-01 16:39:52 +0100357}
358
Jacob Erlbeck18831c32016-02-01 15:23:35 +0100359/*
aravind sirsikarc0c3afd2016-11-09 16:27:00 +0530360 * Immediate assignment reject, sent on the CCCH/AGCH
361 * see GSM 44.018, 9.1.20 + 10.5.2.30
362 */
363int Encoding::write_immediate_assignment_reject(
364 bitvec *dest, uint16_t ra,
365 uint32_t ref_fn,
366 enum ph_burst_type burst_type)
367{
368 unsigned wp = 0;
369 int plen;
370 int i;
371
Alexander Couzensccde5c92017-02-04 03:10:08 +0100372 bitvec_write_field(dest, &wp, 0x0, 4); // Skip Indicator
373 bitvec_write_field(dest, &wp, 0x6, 4); // Protocol Discriminator
374 bitvec_write_field(dest, &wp, 0x3A, 8); // Immediate Assign Message Type
aravind sirsikarc0c3afd2016-11-09 16:27:00 +0530375
376 // feature indicator
Alexander Couzensccde5c92017-02-04 03:10:08 +0100377 bitvec_write_field(dest, &wp, 0x0, 1); // spare
378 bitvec_write_field(dest, &wp, 0x0, 1); // spare
379 bitvec_write_field(dest, &wp, 0x0, 1); // no cs
380 bitvec_write_field(dest, &wp, 0x1, 1); // implicit detach for PS
aravind sirsikarc0c3afd2016-11-09 16:27:00 +0530381
Alexander Couzensccde5c92017-02-04 03:10:08 +0100382 bitvec_write_field(dest, &wp, 0x0, 4); // Page Mode
aravind sirsikarc0c3afd2016-11-09 16:27:00 +0530383 /*
384 * 9.1.20.2 of 44.018 version 11.7.0 Release 11
385 * Filling of the message
386 * If necessary the request reference information element and the
387 * wait indication information element should be duplicated to
388 * fill the message.
389 * TODO: group rejection for multiple MS
390 */
391 for (i = 0; i < 4; i++) {
392 //10.5.2.30 Request Reference
393 if (((burst_type == GSM_L1_BURST_TYPE_ACCESS_1) ||
394 (burst_type == GSM_L1_BURST_TYPE_ACCESS_2))) {
395 //9.1.20.2a of 44.018 version 11.7.0 Release 11
Alexander Couzensccde5c92017-02-04 03:10:08 +0100396 bitvec_write_field(dest, &wp, 0x7f, 8); /* RACH value */
aravind sirsikarc0c3afd2016-11-09 16:27:00 +0530397 } else {
Alexander Couzensccde5c92017-02-04 03:10:08 +0100398 bitvec_write_field(dest, &wp, ra, 8); /* RACH value */
aravind sirsikarc0c3afd2016-11-09 16:27:00 +0530399 }
400
Alexander Couzensccde5c92017-02-04 03:10:08 +0100401 bitvec_write_field(dest, &wp,
aravind sirsikarc0c3afd2016-11-09 16:27:00 +0530402 (ref_fn / (26 * 51)) % 32, 5); // T1'
Alexander Couzensccde5c92017-02-04 03:10:08 +0100403 bitvec_write_field(dest, &wp, ref_fn % 51, 6); // T3
404 bitvec_write_field(dest, &wp, ref_fn % 26, 5); // T2
aravind sirsikarc0c3afd2016-11-09 16:27:00 +0530405
406 /* TODO: Make it configurable */
Alexander Couzensccde5c92017-02-04 03:10:08 +0100407 bitvec_write_field(dest, &wp, 20, 8); //Wait Indication 1
aravind sirsikarc0c3afd2016-11-09 16:27:00 +0530408 }
409
410 plen = wp / 8;
411
412 if ((wp % 8)) {
413 LOGP(DRLCMACUL, LOGL_ERROR, "Length of IMM.ASS.Rej without"
414 "rest octets is not multiple of 8 bits, PLEASE FIX!\n");
415 return -1;
416 }
417
418 // Extended RA
419 else if (((burst_type == GSM_L1_BURST_TYPE_ACCESS_1) ||
420 (burst_type == GSM_L1_BURST_TYPE_ACCESS_2))) {
421 //9.1.20.2a of 44.018 version 11.7.0 Release 11
422 uint8_t extended_ra = 0;
423
424 extended_ra = (ra & 0x1F);
Alexander Couzensccde5c92017-02-04 03:10:08 +0100425 bitvec_write_field(dest, &wp, 0x1, 1);
426 bitvec_write_field(dest, &wp, extended_ra, 5); /* Extended RA */
aravind sirsikarc0c3afd2016-11-09 16:27:00 +0530427 } else {
Alexander Couzensccde5c92017-02-04 03:10:08 +0100428 bitvec_write_field(dest, &wp, 0x0, 1);
aravind sirsikarc0c3afd2016-11-09 16:27:00 +0530429 }
Alexander Couzensccde5c92017-02-04 03:10:08 +0100430 bitvec_write_field(dest, &wp, 0x0, 1);
431 bitvec_write_field(dest, &wp, 0x0, 1);
432 bitvec_write_field(dest, &wp, 0x0, 1);
aravind sirsikarc0c3afd2016-11-09 16:27:00 +0530433
434 return plen;
435}
436
437/*
Jacob Erlbeck18831c32016-02-01 15:23:35 +0100438 * Immediate assignment, sent on the CCCH/AGCH
439 * see GSM 04.08, 9.1.18 and GSM 44.018, 9.1.18 + 10.5.2.16
440 */
Holger Hans Peter Freyther63f29d62013-10-19 19:04:03 +0200441int Encoding::write_immediate_assignment(
Vadim Yanitskiy11567762020-07-18 23:34:17 +0700442 const struct gprs_rlcmac_pdch *pdch,
Jacob Erlbeck2647a332016-02-01 16:13:38 +0100443 struct gprs_rlcmac_tbf *tbf,
Maxfc8afc22019-02-18 18:52:38 +0100444 bitvec * dest, bool downlink, uint16_t ra,
Vadim Yanitskiy11567762020-07-18 23:34:17 +0700445 uint32_t ref_fn, uint8_t ta,
Maxfc8afc22019-02-18 18:52:38 +0100446 uint8_t usf, bool polling, uint32_t fn, uint8_t alpha,
447 uint8_t gamma, int8_t ta_idx, enum ph_burst_type burst_type)
Holger Hans Peter Freyther6ca0a902013-10-19 18:50:22 +0200448{
449 unsigned wp = 0;
Jacob Erlbeck2647a332016-02-01 16:13:38 +0100450 int plen;
451 int rc;
Holger Hans Peter Freyther6ca0a902013-10-19 18:50:22 +0200452
Alexander Couzensccde5c92017-02-04 03:10:08 +0100453 bitvec_write_field(dest, &wp,0x0,4); // Skip Indicator
454 bitvec_write_field(dest, &wp,0x6,4); // Protocol Discriminator
455 bitvec_write_field(dest, &wp,0x3F,8); // Immediate Assignment Message Type
Holger Hans Peter Freyther6ca0a902013-10-19 18:50:22 +0200456
457 // 10.5.2.25b Dedicated mode or TBF
Alexander Couzensccde5c92017-02-04 03:10:08 +0100458 bitvec_write_field(dest, &wp,0x0,1); // spare
459 bitvec_write_field(dest, &wp,0x0,1); // TMA : Two-message assignment: No meaning
460 bitvec_write_field(dest, &wp,downlink,1); // Downlink : Downlink assignment to mobile in packet idle mode
461 bitvec_write_field(dest, &wp,0x1,1); // T/D : TBF or dedicated mode: this message assigns a Temporary Block Flow (TBF).
Holger Hans Peter Freyther6ca0a902013-10-19 18:50:22 +0200462
Alexander Couzensccde5c92017-02-04 03:10:08 +0100463 bitvec_write_field(dest, &wp,0x0,4); // Page Mode
Holger Hans Peter Freyther6ca0a902013-10-19 18:50:22 +0200464
465 // GSM 04.08 10.5.2.25a Packet Channel Description
Vadim Yanitskiy11567762020-07-18 23:34:17 +0700466 bitvec_write_field(dest, &wp, 0x01, 5); // Channel type
467 bitvec_write_field(dest, &wp, pdch->ts_no, 3); // TN
468 bitvec_write_field(dest, &wp, pdch->tsc, 3); // TSC
469
Vadim Yanitskiy542e3882020-07-19 00:47:20 +0700470 /* RF channel configuraion: hopping or non-hopping */
471 if (pdch->fh.enabled) {
472 bitvec_write_field(dest, &wp, 0x01, 1); /* direct encoding */
473 bitvec_write_field(dest, &wp, pdch->fh.maio, 6);
474 bitvec_write_field(dest, &wp, pdch->fh.hsn, 6);
475 } else {
476 bitvec_write_field(dest, &wp, 0x00, 3);
477 bitvec_write_field(dest, &wp, pdch->trx->arfcn, 10);
478 }
Holger Hans Peter Freyther6ca0a902013-10-19 18:50:22 +0200479
480 //10.5.2.30 Request Reference
bhargava465f5bb2016-09-02 16:50:43 +0530481 if (((burst_type == GSM_L1_BURST_TYPE_ACCESS_1) ||
482 (burst_type == GSM_L1_BURST_TYPE_ACCESS_2))) {
Alexander Couzensccde5c92017-02-04 03:10:08 +0100483 bitvec_write_field(dest, &wp, 0x7f, 8); /* RACH value */
bhargava465f5bb2016-09-02 16:50:43 +0530484 } else {
Alexander Couzensccde5c92017-02-04 03:10:08 +0100485 bitvec_write_field(dest, &wp, ra, 8); /* RACH value */
bhargava465f5bb2016-09-02 16:50:43 +0530486 }
487
Alexander Couzensccde5c92017-02-04 03:10:08 +0100488 bitvec_write_field(dest, &wp,(ref_fn / (26 * 51)) % 32,5); // T1'
489 bitvec_write_field(dest, &wp,ref_fn % 51,6); // T3
490 bitvec_write_field(dest, &wp,ref_fn % 26,5); // T2
Holger Hans Peter Freyther6ca0a902013-10-19 18:50:22 +0200491
492 // 10.5.2.40 Timing Advance
Alexander Couzensccde5c92017-02-04 03:10:08 +0100493 bitvec_write_field(dest, &wp,0x0,2); // spare
494 bitvec_write_field(dest, &wp,ta,6); // Timing Advance value
Holger Hans Peter Freyther6ca0a902013-10-19 18:50:22 +0200495
Vadim Yanitskiy542e3882020-07-19 00:47:20 +0700496 /* 10.5.2.21 Mobile Allocation */
497 if (pdch->fh.enabled) {
498 bitvec_write_field(dest, &wp, pdch->fh.ma_oct_len, 8);
499 for (int i = 0; i < pdch->fh.ma_oct_len; i++)
500 bitvec_write_field(dest, &wp, pdch->fh.ma[i], 8);
501 } else {
502 // No mobile allocation in non-hopping systems.
503 // A zero-length LV. Just write L=0.
504 bitvec_write_field(dest, &wp, 0x00, 8);
505 }
Holger Hans Peter Freyther6ca0a902013-10-19 18:50:22 +0200506
Vadim Yanitskiy8f628ab2020-07-18 20:47:47 +0700507 OSMO_ASSERT(wp % 8 == 0);
Max0a8fae82017-03-08 18:53:30 +0100508
Holger Hans Peter Freyther6ca0a902013-10-19 18:50:22 +0200509 plen = wp / 8;
510
Max0160a292019-02-19 15:37:03 +0100511 /* 3GPP TS 44.018 §10.5.2.16 IA Rest Octets */
Max3fa235f2019-03-13 19:08:02 +0100512 dest->cur_bit = wp;
Max0160a292019-02-19 15:37:03 +0100513 if (downlink) {
Vadim Yanitskiy9d5a1152020-07-18 20:54:22 +0700514 OSMO_ASSERT(as_dl_tbf(tbf) != NULL);
Max23c0e012019-02-19 17:49:27 +0100515
Max0160a292019-02-19 15:37:03 +0100516 rc = write_ia_rest_downlink(as_dl_tbf(tbf), dest, polling, gsm48_ta_is_valid(ta), fn, alpha, gamma,
Max23c0e012019-02-19 17:49:27 +0100517 ta_idx);
Max0160a292019-02-19 15:37:03 +0100518 } else if (((burst_type == GSM_L1_BURST_TYPE_ACCESS_1) || (burst_type == GSM_L1_BURST_TYPE_ACCESS_2))) {
Max3fa235f2019-03-13 19:08:02 +0100519 SET_L(dest); SET_H(dest); // "LH"
520 SET_0(dest); SET_0(dest); // "00" < EGPRS Packet Uplink Assignment >
521 rc = bitvec_set_u64(dest, ra & 0x1F, 5, false); // < Extended RA >
522 CHECK(rc);
Max0160a292019-02-19 15:37:03 +0100523
Max3fa235f2019-03-13 19:08:02 +0100524 SET_0(dest); // No < Access Technologies Request struct >
525
526 if (as_ul_tbf(tbf) != NULL)
Maxe742cc02019-03-12 18:42:09 +0100527 rc = write_ia_rest_egprs_uplink_sba(as_ul_tbf(tbf), dest, usf, alpha, gamma, ta_idx);
Max3fa235f2019-03-13 19:08:02 +0100528 else
Maxbd5647e2019-02-19 18:10:12 +0100529 rc = write_ia_rest_egprs_uplink_mba(dest, fn, alpha, gamma);
Max0160a292019-02-19 15:37:03 +0100530 } else {
531 OSMO_ASSERT(!tbf || !tbf->is_egprs_enabled());
532
Max3fa235f2019-03-13 19:08:02 +0100533 SET_H(dest); SET_H(dest); // "HH"
534 SET_0(dest); SET_0(dest); // "00" < Packet Uplink Assignment >
Max0160a292019-02-19 15:37:03 +0100535
Max3fa235f2019-03-13 19:08:02 +0100536 if (as_ul_tbf(tbf) != NULL)
Maxe742cc02019-03-12 18:42:09 +0100537 rc = write_ia_rest_uplink_mba(as_ul_tbf(tbf), dest, usf, alpha, gamma, ta_idx);
Max3fa235f2019-03-13 19:08:02 +0100538 else
Max3eb47362019-02-19 18:41:22 +0100539 rc = write_ia_rest_uplink_sba(dest, fn, alpha, gamma);
Max0160a292019-02-19 15:37:03 +0100540 }
Holger Hans Peter Freyther6ca0a902013-10-19 18:50:22 +0200541
Jacob Erlbeck2647a332016-02-01 16:13:38 +0100542 if (rc < 0) {
543 LOGP(DRLCMAC, LOGL_ERROR,
Thorsten Alteholz8bb79042018-10-06 10:42:58 +0200544 "Failed to create IMMEDIATE ASSIGNMENT (%s) for %s\n",
Jacob Erlbeck2647a332016-02-01 16:13:38 +0100545 downlink ? "downlink" : "uplink",
546 tbf ? tbf->name() : "single block allocation");
547 return rc;
548 }
549
Holger Hans Peter Freyther6ca0a902013-10-19 18:50:22 +0200550 return plen;
551}
552
Vadim Yanitskiy542e3882020-07-19 00:47:20 +0700553/* Prepare to be encoded Frequency Parameters IE (see Table 12.8.1) */
554static void gen_freq_params(Frequency_Parameters_t *freq_params,
555 const struct gprs_rlcmac_tbf *tbf)
556{
557 const struct gprs_rlcmac_pdch *pdch;
558 Direct_encoding_1_t fh_params;
559
560 /* Check one PDCH, if it's hopping then all other should too */
561 pdch = tbf->pdch[tbf->first_ts];
562 OSMO_ASSERT(pdch != NULL);
563
564 /* Training Sequence Code */
565 freq_params->TSC = pdch->tsc;
566
567 /* If frequency hopping is not in use, encode a single ARFCN */
Vadim Yanitskiy2597cf12020-09-10 18:20:32 +0700568 if (!pdch->fh.enabled) {
Vadim Yanitskiy542e3882020-07-19 00:47:20 +0700569 freq_params->UnionType = 0x00;
570 freq_params->u.ARFCN = tbf->trx->arfcn;
571 return;
572 }
573
574 /* Direct encoding 1 (see Table 12.8.1) */
575 freq_params->UnionType = 0x2;
576
577 /* HSN / MAIO */
578 fh_params.MAIO = pdch->fh.maio;
579 fh_params.GPRS_Mobile_Allocation.HSN = pdch->fh.hsn;
580 fh_params.GPRS_Mobile_Allocation.ElementsOf_RFL_NUMBER = 0;
581
582 /* Mobile Allocation bitmap */
583 fh_params.GPRS_Mobile_Allocation.UnionType = 0; /* MA bitmap */
584 fh_params.GPRS_Mobile_Allocation.u.MA.MA_LENGTH = pdch->fh.ma_oct_len; /* in bytes */
585 fh_params.GPRS_Mobile_Allocation.u.MA.MA_BitLength = pdch->fh.ma_bit_len; /* in bits */
586 memcpy(fh_params.GPRS_Mobile_Allocation.u.MA.MA_BITMAP, pdch->fh.ma, pdch->fh.ma_oct_len);
587
588 freq_params->u.Direct_encoding_1 = fh_params;
589}
590
Vadim Yanitskiydb56a352020-08-22 02:05:28 +0700591/* Generate Packet Uplink Assignment as per 3GPP TS 44.060, section 11.2.29.
592 * NOTE: 'block' is expected to be zero-initialized by the caller. */
Holger Hans Peter Freyther63f29d62013-10-19 19:04:03 +0200593void Encoding::write_packet_uplink_assignment(
Vadim Yanitskiydb56a352020-08-22 02:05:28 +0700594 RlcMacDownlink_t * block, uint8_t old_tfi,
Holger Hans Peter Freyther6ca0a902013-10-19 18:50:22 +0200595 uint8_t old_downlink, uint32_t tlli, uint8_t use_tlli,
Vadim Yanitskiyc0ddaa92020-08-20 16:49:34 +0700596 const struct gprs_rlcmac_ul_tbf *tbf, uint8_t poll, uint8_t rrbp, uint8_t alpha,
Vadim Yanitskiya76cdac2020-08-22 00:12:30 +0700597 uint8_t gamma, int8_t ta_idx, bool use_egprs)
Holger Hans Peter Freyther6ca0a902013-10-19 18:50:22 +0200598{
Vadim Yanitskiydb56a352020-08-22 02:05:28 +0700599 Packet_Uplink_Assignment_t *pua;
600 Packet_Timing_Advance_t *pta;
601 Frequency_Parameters_t *fp;
602 Dynamic_Allocation_t *da;
Holger Hans Peter Freyther6ca0a902013-10-19 18:50:22 +0200603
Vadim Yanitskiydb56a352020-08-22 02:05:28 +0700604 /* RLC/MAC control block without the optional RLC/MAC control header */
605 block->PAYLOAD_TYPE = 0x01; // Payload Type
606 block->RRBP = rrbp; // RRBP (e.g. N+13)
607 block->SP = poll; // RRBP field is valid
608 block->USF = 0x00; // Uplink state flag
Holger Hans Peter Freyther6ca0a902013-10-19 18:50:22 +0200609
Vadim Yanitskiydb56a352020-08-22 02:05:28 +0700610 /* See 3GPP TS 44.060, section 11.2.29 */
611 pua = &block->u.Packet_Uplink_Assignment;
612 pua->MESSAGE_TYPE = 0x0a; // Packet Uplink Assignment
613 pua->PAGE_MODE = 0x00; // Normal Paging
Holger Hans Peter Freyther6ca0a902013-10-19 18:50:22 +0200614
Vadim Yanitskiydb56a352020-08-22 02:05:28 +0700615 /* TLLI or Global (UL/DL) TFI */
Holger Hans Peter Freyther6ca0a902013-10-19 18:50:22 +0200616 if (use_tlli) {
Vadim Yanitskiydb56a352020-08-22 02:05:28 +0700617 pua->ID.UnionType = 0x01;
618 pua->ID.u.TLLI = tlli;
Holger Hans Peter Freyther6ca0a902013-10-19 18:50:22 +0200619 } else {
Vadim Yanitskiydb56a352020-08-22 02:05:28 +0700620 pua->ID.UnionType = 0x00;
621 pua->ID.u.Global_TFI.UnionType = old_downlink;
622 pua->ID.u.Global_TFI.u.UPLINK_TFI = old_tfi;
Holger Hans Peter Freyther6ca0a902013-10-19 18:50:22 +0200623 }
624
Vadim Yanitskiydb56a352020-08-22 02:05:28 +0700625 /* GPRS/EGPRS specific parameters */
626 pua->UnionType = use_egprs ? 0x01 : 0x00;
Jacob Erlbeck76d767c2015-09-28 18:54:32 +0200627 if (!use_egprs) {
Vadim Yanitskiydb56a352020-08-22 02:05:28 +0700628 PUA_GPRS_t *gprs = &pua->u.PUA_GPRS_Struct;
629
630 /* Use the commanded CS/MSC value during the content resolution */
631 gprs->CHANNEL_CODING_COMMAND = mcs_chan_code(tbf->current_cs());
632 gprs->TLLI_BLOCK_CHANNEL_CODING = 0x01; // ^^^
633
634 /* Dynamic allocation */
635 gprs->UnionType = 0x01;
636 /* Frequency Parameters IE is present */
637 gprs->Exist_Frequency_Parameters = 0x01;
638
639 /* Common parameters to be set below */
640 pta = &gprs->Packet_Timing_Advance;
641 fp = &gprs->Frequency_Parameters;
642 da = &gprs->u.Dynamic_Allocation;
643 } else {
644 PUA_EGPRS_00_t *egprs = &pua->u.PUA_EGPRS_Struct.u.PUA_EGPRS_00;
645 pua->u.PUA_EGPRS_Struct.UnionType = 0x00; // 'Normal' EGPRS, not EGPRS2
646
647 /* Use the commanded CS/MSC value during the content resolution */
648 egprs->EGPRS_CHANNEL_CODING_COMMAND = mcs_chan_code(tbf->current_cs());
649 egprs->TLLI_BLOCK_CHANNEL_CODING = 0x01; // ^^^
650 egprs->RESEGMENT = 0x01; // Enable segmentation
651 egprs->EGPRS_WindowSize = tbf->window_size();
652
653 /* Dynamic allocation */
654 egprs->UnionType = 0x01;
655 /* Frequency Parameters IE is present */
656 egprs->Exist_Frequency_Parameters = 0x01;
657
658 /* Common parameters to be set below */
659 pta = &egprs->Packet_Timing_Advance;
660 fp = &egprs->Frequency_Parameters;
661 da = &egprs->u.Dynamic_Allocation;
Holger Hans Peter Freyther6ca0a902013-10-19 18:50:22 +0200662 }
663
Vadim Yanitskiydb56a352020-08-22 02:05:28 +0700664 /* Packet Timing Advance (if known) */
665 if (tbf->ta() <= 63) { /* { 0 | 1 < TIMING_ADVANCE_VALUE : bit (6) > } */
666 pta->Exist_TIMING_ADVANCE_VALUE = 0x01; // Present
667 pta->TIMING_ADVANCE_VALUE = tbf->ta();
Holger Hans Peter Freyther6ca0a902013-10-19 18:50:22 +0200668 }
Vadim Yanitskiydb56a352020-08-22 02:05:28 +0700669
670 /* Continuous Timing Advance Control */
671 if (ta_idx >= 0 && ta_idx < 16) {
672 pta->Exist_IndexAndtimeSlot = 0x01; // Present
673 pta->TIMING_ADVANCE_TIMESLOT_NUMBER = 0; // FIXME!
674 pta->TIMING_ADVANCE_INDEX = ta_idx;
675 }
676
677 /* Frequency Parameters IE */
Vadim Yanitskiy542e3882020-07-19 00:47:20 +0700678 gen_freq_params(fp, tbf);
Vadim Yanitskiydb56a352020-08-22 02:05:28 +0700679
680 /* Dynamic allocation parameters */
681 da->USF_GRANULARITY = 0x00;
682
683 /* Assign an Uplink TFI */
684 da->Exist_UPLINK_TFI_ASSIGNMENT = 0x01;
685 da->UPLINK_TFI_ASSIGNMENT = tbf->tfi();
686
687 /* Timeslot Allocation with or without Power Control */
688 da->UnionType = (alpha || gamma) ? 0x01 : 0x00;
689 if (da->UnionType == 0x01)
690 da->u.Timeslot_Allocation_Power_Ctrl_Param.ALPHA = alpha;
691
692 for (unsigned int tn = 0; tn < 8; tn++) {
693 if (tbf->pdch[tn] == NULL)
694 continue;
695
696 if (da->UnionType == 0x01) {
697 Timeslot_Allocation_Power_Ctrl_Param_t *params = \
698 &da->u.Timeslot_Allocation_Power_Ctrl_Param;
699 params->Slot[tn].Exist = 0x01; // Enable this timeslot
700 params->Slot[tn].USF_TN = tbf->m_usf[tn]; // USF_TN(i)
701 params->Slot[tn].GAMMA_TN = gamma;
702 } else {
703 Timeslot_Allocation_t *slot = &da->u.Timeslot_Allocation[tn];
704 slot->Exist = 0x01; // Enable this timeslot
705 slot->USF_TN = tbf->m_usf[tn]; // USF_TN(i)
706 }
707 }
Holger Hans Peter Freyther6ca0a902013-10-19 18:50:22 +0200708}
709
710
Vadim Yanitskiy962d7172020-09-08 02:46:05 +0700711/* Generate Packet Downlink Assignment as per 3GPP TS 44.060, section 11.2.7.
712 * NOTE: 'block' is expected to be zero-initialized by the caller. */
Jacob Erlbeck166c9fc2016-01-07 16:04:29 +0100713void Encoding::write_packet_downlink_assignment(RlcMacDownlink_t * block,
Jacob Erlbeck6b356a52016-01-29 16:39:21 +0100714 bool old_tfi_is_valid, uint8_t old_tfi, uint8_t old_downlink,
Vadim Yanitskiyc0ddaa92020-08-20 16:49:34 +0700715 const struct gprs_rlcmac_dl_tbf *tbf, uint8_t poll, uint8_t rrbp,
Jacob Erlbeck6b356a52016-01-29 16:39:21 +0100716 uint8_t alpha, uint8_t gamma, int8_t ta_idx,
Jacob Erlbeckf2694b72016-01-26 21:46:26 +0100717 uint8_t ta_ts, bool use_egprs)
Holger Hans Peter Freyther6ca0a902013-10-19 18:50:22 +0200718{
Jacob Erlbeck166c9fc2016-01-07 16:04:29 +0100719 PDA_AdditionsR99_t *pda_r99;
720
Holger Hans Peter Freyther6ca0a902013-10-19 18:50:22 +0200721 uint8_t tn;
722
723 block->PAYLOAD_TYPE = 0x1; // RLC/MAC control block that does not include the optional octets of the RLC/MAC control header
Jacob Erlbeckf2694b72016-01-26 21:46:26 +0100724 block->RRBP = rrbp; // 0: N+13
Holger Hans Peter Freyther6ca0a902013-10-19 18:50:22 +0200725 block->SP = poll; // RRBP field is valid
726 block->USF = 0x0; // Uplink state flag
727
728 block->u.Packet_Downlink_Assignment.MESSAGE_TYPE = 0x2; // Packet Downlink Assignment
729 block->u.Packet_Downlink_Assignment.PAGE_MODE = 0x0; // Normal Paging
730
731 block->u.Packet_Downlink_Assignment.Exist_PERSISTENCE_LEVEL = 0x0; // PERSISTENCE_LEVEL: off
732
Jacob Erlbeck6b356a52016-01-29 16:39:21 +0100733 if (old_tfi_is_valid) {
734 block->u.Packet_Downlink_Assignment.ID.UnionType = 0x0; // TFI = on
735 block->u.Packet_Downlink_Assignment.ID.u.Global_TFI.UnionType = old_downlink; // 0=UPLINK TFI, 1=DL TFI
736 block->u.Packet_Downlink_Assignment.ID.u.Global_TFI.u.UPLINK_TFI = old_tfi; // TFI
737 } else {
738 block->u.Packet_Downlink_Assignment.ID.UnionType = 0x1; // TLLI
739 block->u.Packet_Downlink_Assignment.ID.u.TLLI = tbf->tlli();
740 }
Holger Hans Peter Freyther6ca0a902013-10-19 18:50:22 +0200741
742 block->u.Packet_Downlink_Assignment.MAC_MODE = 0x0; // Dynamic Allocation
Vadim Yanitskiy3f2022e2020-05-23 19:23:56 +0700743 block->u.Packet_Downlink_Assignment.RLC_MODE = RLC_MODE_ACKNOWLEDGED;
Daniel Willmann73191a42014-05-30 17:58:00 +0200744 block->u.Packet_Downlink_Assignment.CONTROL_ACK = tbf->was_releasing; // NW establishes no new DL TBF for the MS with running timer T3192
Holger Hans Peter Freyther6ca0a902013-10-19 18:50:22 +0200745 block->u.Packet_Downlink_Assignment.TIMESLOT_ALLOCATION = 0; // timeslot(s)
746 for (tn = 0; tn < 8; tn++) {
747 if (tbf->pdch[tn])
748 block->u.Packet_Downlink_Assignment.TIMESLOT_ALLOCATION |= 0x80 >> tn; // timeslot(s)
749 }
750
Vadim Yanitskiy7a1fdfd2020-08-20 17:26:31 +0700751 if (tbf->ta() > 63) { /* { 0 | 1 < TIMING_ADVANCE_VALUE : bit (6) > } */
752 block->u.Packet_Downlink_Assignment.Packet_Timing_Advance.Exist_TIMING_ADVANCE_VALUE = 0x0; // TIMING_ADVANCE_VALUE = off
753 } else {
754 block->u.Packet_Downlink_Assignment.Packet_Timing_Advance.Exist_TIMING_ADVANCE_VALUE = 0x1; // TIMING_ADVANCE_VALUE = on
755 block->u.Packet_Downlink_Assignment.Packet_Timing_Advance.TIMING_ADVANCE_VALUE = tbf->ta(); // TIMING_ADVANCE_VALUE
756 }
757
Holger Hans Peter Freyther6ca0a902013-10-19 18:50:22 +0200758 if (ta_idx < 0) {
759 block->u.Packet_Downlink_Assignment.Packet_Timing_Advance.Exist_IndexAndtimeSlot = 0x0; // TIMING_ADVANCE_INDEX = off
760 } else {
761 block->u.Packet_Downlink_Assignment.Packet_Timing_Advance.Exist_IndexAndtimeSlot = 0x1; // TIMING_ADVANCE_INDEX = on
762 block->u.Packet_Downlink_Assignment.Packet_Timing_Advance.TIMING_ADVANCE_INDEX = ta_idx; // TIMING_ADVANCE_INDEX
763 block->u.Packet_Downlink_Assignment.Packet_Timing_Advance.TIMING_ADVANCE_TIMESLOT_NUMBER = ta_ts; // TIMING_ADVANCE_TS
764 }
765
766 block->u.Packet_Downlink_Assignment.Exist_P0_and_BTS_PWR_CTRL_MODE = 0x0; // POWER CONTROL = off
767
768 block->u.Packet_Downlink_Assignment.Exist_Frequency_Parameters = 0x1; // Frequency Parameters = on
Vadim Yanitskiy542e3882020-07-19 00:47:20 +0700769 gen_freq_params(&block->u.Packet_Downlink_Assignment.Frequency_Parameters, tbf);
Holger Hans Peter Freyther6ca0a902013-10-19 18:50:22 +0200770
771 block->u.Packet_Downlink_Assignment.Exist_DOWNLINK_TFI_ASSIGNMENT = 0x1; // DOWNLINK TFI ASSIGNMENT = on
Holger Hans Peter Freyther34f6e5e2013-10-27 20:31:47 +0100772 block->u.Packet_Downlink_Assignment.DOWNLINK_TFI_ASSIGNMENT = tbf->tfi(); // TFI
Holger Hans Peter Freyther6ca0a902013-10-19 18:50:22 +0200773
774 block->u.Packet_Downlink_Assignment.Exist_Power_Control_Parameters = 0x1; // Power Control Parameters = on
775 block->u.Packet_Downlink_Assignment.Power_Control_Parameters.ALPHA = alpha; // ALPHA
776
777 for (tn = 0; tn < 8; tn++)
778 {
779 if (tbf->pdch[tn])
780 {
781 block->u.Packet_Downlink_Assignment.Power_Control_Parameters.Slot[tn].Exist = 0x1; // Slot[i] = on
782 block->u.Packet_Downlink_Assignment.Power_Control_Parameters.Slot[tn].GAMMA_TN = gamma; // GAMMA_TN
783 }
784 else
785 {
786 block->u.Packet_Downlink_Assignment.Power_Control_Parameters.Slot[tn].Exist = 0x0; // Slot[i] = off
787 }
788 }
789
790 block->u.Packet_Downlink_Assignment.Exist_TBF_Starting_Time = 0x0; // TBF Starting TIME = off
791 block->u.Packet_Downlink_Assignment.Exist_Measurement_Mapping = 0x0; // Measurement_Mapping = off
Jacob Erlbeck166c9fc2016-01-07 16:04:29 +0100792 if (!use_egprs) {
793 block->u.Packet_Downlink_Assignment.Exist_AdditionsR99 = 0x0; // AdditionsR99 = off
794 return;
795 }
Jacob Erlbeck36df7742016-01-19 15:53:30 +0100796
Jacob Erlbeck166c9fc2016-01-07 16:04:29 +0100797 block->u.Packet_Downlink_Assignment.Exist_AdditionsR99 = 0x1; // AdditionsR99 = on
798 pda_r99 = &block->u.Packet_Downlink_Assignment.AdditionsR99;
799 pda_r99->Exist_EGPRS_Params = 1;
Maxa4f570f2017-12-15 11:21:57 +0100800 pda_r99->EGPRS_WindowSize = enc_ws(tbf->window_size()); /* see TS 44.060, table 12.5.2.1 */
Jacob Erlbeck166c9fc2016-01-07 16:04:29 +0100801 pda_r99->LINK_QUALITY_MEASUREMENT_MODE = 0x0; /* no meas, see TS 44.060, table 11.2.7.2 */
802 pda_r99->Exist_BEP_PERIOD2 = 0; /* No extra EGPRS BEP PERIOD */
803 pda_r99->Exist_Packet_Extended_Timing_Advance = 0;
804 pda_r99->Exist_COMPACT_ReducedMA = 0;
Holger Hans Peter Freyther6ca0a902013-10-19 18:50:22 +0200805}
806
Stefan Sperling513c9bc2018-05-02 14:53:16 +0200807/* Generate paging request. See 44.018, sections 10 and 9.1.22 */
Neels Hofmeyr59fc0bd2020-08-21 16:21:23 +0200808int Encoding::write_paging_request(bitvec * dest, const struct osmo_mobile_identity *mi)
Holger Hans Peter Freyther6ca0a902013-10-19 18:50:22 +0200809{
Neels Hofmeyr59fc0bd2020-08-21 16:21:23 +0200810 uint8_t mi_buf[GSM48_MID_MAX_SIZE];
811 int mi_len;
Holger Hans Peter Freyther6ca0a902013-10-19 18:50:22 +0200812 unsigned wp = 0;
813 int plen;
814
Alexander Couzensccde5c92017-02-04 03:10:08 +0100815 bitvec_write_field(dest, &wp,0x0,4); // Skip Indicator
816 bitvec_write_field(dest, &wp,0x6,4); // Protocol Discriminator
Stefan Sperling513c9bc2018-05-02 14:53:16 +0200817 bitvec_write_field(dest, &wp,0x21,8); // Paging Request Message Type 1
Holger Hans Peter Freyther6ca0a902013-10-19 18:50:22 +0200818
Alexander Couzensccde5c92017-02-04 03:10:08 +0100819 bitvec_write_field(dest, &wp,0x0,4); // Page Mode
820 bitvec_write_field(dest, &wp,0x0,4); // Channel Needed
Holger Hans Peter Freyther6ca0a902013-10-19 18:50:22 +0200821
Neels Hofmeyr59fc0bd2020-08-21 16:21:23 +0200822 mi_len = osmo_mobile_identity_encode_buf(mi_buf, sizeof(mi_buf), mi, true);
823 if (mi_len <= 0)
824 return mi_len;
Pau Espin Pedrol5530f122019-12-10 19:26:27 +0100825 bitvec_write_field(dest, &wp, mi_len, 8); // Mobile Identity length
Neels Hofmeyr59fc0bd2020-08-21 16:21:23 +0200826 bitvec_set_bytes(dest, mi_buf, mi_len); // Mobile Identity
Pau Espin Pedrol5530f122019-12-10 19:26:27 +0100827 wp += mi_len * 8;
Max0a8fae82017-03-08 18:53:30 +0100828
Vadim Yanitskiy8f628ab2020-07-18 20:47:47 +0700829 OSMO_ASSERT(wp % 8 == 0);
Max0a8fae82017-03-08 18:53:30 +0100830
Holger Hans Peter Freyther6ca0a902013-10-19 18:50:22 +0200831 plen = wp / 8;
Stefan Sperling513c9bc2018-05-02 14:53:16 +0200832 bitvec_write_field(dest, &wp,0x0,1); // "L" Notification List Number; NLN(PCH) = off
Alexander Couzensccde5c92017-02-04 03:10:08 +0100833 bitvec_write_field(dest, &wp,0x0,1); // "L" Priority1 = off
834 bitvec_write_field(dest, &wp,0x1,1); // "L" Priority2 = off
835 bitvec_write_field(dest, &wp,0x0,1); // "L" Group Call information = off
836 bitvec_write_field(dest, &wp,0x0,1); // "H" Packet Page Indication 1 = packet paging procedure
837 bitvec_write_field(dest, &wp,0x1,1); // "H" Packet Page Indication 2 = packet paging procedure
Holger Hans Peter Freyther6ca0a902013-10-19 18:50:22 +0200838
839 return plen;
840}
841
Daniel Willmann5241c1a2013-12-11 14:35:29 +0100842/**
843 * The index of the array show_rbb is the bit position inside the rbb
844 * (show_rbb[63] relates to BSN ssn-1)
845 */
846void Encoding::encode_rbb(const char *show_rbb, uint8_t *rbb)
847{
848 uint8_t rbb_byte = 0;
849
850 // RECEIVE_BLOCK_BITMAP
851 for (int i = 0; i < 64; i++) {
852 /* Set bit at the appropriate position (see 3GPP TS 04.60 9.1.8.1) */
853 if (show_rbb[i] == 'R')
854 rbb_byte |= 1<< (7-(i%8));
855
856 if((i%8) == 7) {
857 rbb[i/8] = rbb_byte;
858 rbb_byte = 0;
859 }
860 }
861}
862
Jacob Erlbeck37005a12015-12-22 14:58:34 +0100863static void write_packet_ack_nack_desc_gprs(
Alexander Couzens3a499f32019-06-16 15:25:30 +0200864 bitvec * dest, unsigned& wp,
Jacob Erlbeck37005a12015-12-22 14:58:34 +0100865 gprs_rlc_ul_window *window, bool is_final)
866{
867 char rbb[65];
868
869 window->update_rbb(rbb);
870
871 rbb[64] = 0;
872 LOGP(DRLCMACUL, LOGL_DEBUG, "- V(N): \"%s\" R=Received "
873 "I=Invalid\n", rbb);
874
Alexander Couzensccde5c92017-02-04 03:10:08 +0100875 bitvec_write_field(dest, &wp, is_final, 1); // FINAL_ACK_INDICATION
876 bitvec_write_field(dest, &wp, window->ssn(), 7); // STARTING_SEQUENCE_NUMBER
Jacob Erlbeck37005a12015-12-22 14:58:34 +0100877
878 for (int i = 0; i < 64; i++) {
879 /* Set bit at the appropriate position (see 3GPP TS 04.60 9.1.8.1) */
880 bool is_ack = (rbb[i] == 'R');
Alexander Couzensccde5c92017-02-04 03:10:08 +0100881 bitvec_write_field(dest, &wp, is_ack, 1);
Jacob Erlbeck37005a12015-12-22 14:58:34 +0100882 }
883}
884
885static void write_packet_uplink_ack_gprs(
Alexander Couzens3a499f32019-06-16 15:25:30 +0200886 bitvec * dest, unsigned& wp,
Jacob Erlbeck37005a12015-12-22 14:58:34 +0100887 struct gprs_rlcmac_ul_tbf *tbf, bool is_final)
888{
889
Max6e96dd42019-03-06 18:17:32 +0100890 bitvec_write_field(dest, &wp, mcs_chan_code(tbf->current_cs()), 2); // CHANNEL_CODING_COMMAND
Alexander Couzens3a499f32019-06-16 15:25:30 +0200891 write_packet_ack_nack_desc_gprs(dest, wp, tbf->window(), is_final);
Jacob Erlbeck37005a12015-12-22 14:58:34 +0100892
Alexander Couzensccde5c92017-02-04 03:10:08 +0100893 bitvec_write_field(dest, &wp, 1, 1); // 1: have CONTENTION_RESOLUTION_TLLI
894 bitvec_write_field(dest, &wp, tbf->tlli(), 32); // CONTENTION_RESOLUTION_TLLI
Jacob Erlbeck37005a12015-12-22 14:58:34 +0100895
Alexander Couzensccde5c92017-02-04 03:10:08 +0100896 bitvec_write_field(dest, &wp, 0, 1); // 0: don't have Packet Timing Advance
897 bitvec_write_field(dest, &wp, 0, 1); // 0: don't have Power Control Parameters
898 bitvec_write_field(dest, &wp, 0, 1); // 0: don't have Extension Bits
899 bitvec_write_field(dest, &wp, 0, 1); // fixed 0
900 bitvec_write_field(dest, &wp, 1, 1); // 1: have Additions R99
901 bitvec_write_field(dest, &wp, 0, 1); // 0: don't have Packet Extended Timing Advance
902 bitvec_write_field(dest, &wp, 1, 1); // TBF_EST (enabled)
903 bitvec_write_field(dest, &wp, 0, 1); // 0: don't have REL 5
Jacob Erlbeck37005a12015-12-22 14:58:34 +0100904};
905
Alexander Couzens210ccf42019-06-16 17:05:40 +0200906/* Encode the Ack/Nack for EGPRS. 44.060
907 * The PCU encodes to receive block bitmap to the following rules:
908 * - always encode the lenght field
909 * - use compressed receive block bitmap if it's smaller than uncompressed
910 * receive block bitmap
911 * - use the remaining bits for an uncompressed receive block bitmap if needed
912 *
913 * Note: The spec also defines an Ack/Nack without length field, but the PCU's
914 * doesn't support this in UL. It would require a lot more code complexity
915 * and only saves 7 bit in lossy sitations.
916 */
Jacob Erlbeck37005a12015-12-22 14:58:34 +0100917static void write_packet_ack_nack_desc_egprs(
Alexander Couzens3a499f32019-06-16 15:25:30 +0200918 bitvec * dest, unsigned& wp,
Alexander Couzens243a2042019-06-16 21:53:03 +0200919 gprs_rlc_ul_window *window, bool is_final, unsigned rest_bits)
Jacob Erlbeck37005a12015-12-22 14:58:34 +0100920{
sivasankari8adfcd02017-01-16 15:41:21 +0530921 unsigned int urbb_len = 0;
922 uint8_t crbb_len = 0;
923 uint8_t len;
Jacob Erlbeck37005a12015-12-22 14:58:34 +0100924 bool bow = true;
925 bool eow = true;
Alexander Couzense4e70d02019-06-16 16:20:10 +0200926 uint16_t ssn = window->mod_sns(window->v_q() + 1);
sivasankari8adfcd02017-01-16 15:41:21 +0530927 unsigned int num_blocks = window->mod_sns(window->v_r() - window->v_q());
Alexander Couzense4e70d02019-06-16 16:20:10 +0200928 uint16_t esn_crbb = window->mod_sns(ssn - 1);
sivasankari8adfcd02017-01-16 15:41:21 +0530929 static uint8_t rbb[RLC_EGPRS_MAX_WS] = {'\0'};
930 uint8_t iter = 0;
Pravin Kumarvel06bdb352016-10-24 12:21:21 +0530931 int is_compressed = 0;
sivasankari8adfcd02017-01-16 15:41:21 +0530932 bool try_compression = false;
Alexander Couzense4e70d02019-06-16 16:20:10 +0200933 uint16_t ucmp_bmplen;
sivasankari8adfcd02017-01-16 15:41:21 +0530934 uint8_t crbb_bitmap[23] = {'\0'};
935 bitvec ucmp_vec;
936 bitvec crbb_vec;
937 uint8_t uclen_crbb = 0;
sivasankari8adfcd02017-01-16 15:41:21 +0530938 uint8_t crbb_start_clr_code;
Pravin Kumarvel06bdb352016-10-24 12:21:21 +0530939 uint8_t i;
Alexander Couzensb7439f22019-06-16 15:16:30 +0200940
941 /* static size of 16 bits
Alexander Couzens210ccf42019-06-16 17:05:40 +0200942 ..1. .... = ACKNACK: (Union)
943 0 0000 000 Length
Alexander Couzensb3b0c492019-10-04 03:40:26 +0200944 Desc
Pau Espin Pedrol585cfb22019-12-10 17:09:51 +0100945
Alexander Couzensb3b0c492019-10-04 03:40:26 +0200946 ...0 .... = FINAL_ACK_INDICATION: False
Pau Espin Pedrol585cfb22019-12-10 17:09:51 +0100947
Alexander Couzensb3b0c492019-10-04 03:40:26 +0200948 .... 1... = BEGINNING_OF_WINDOW: 1
Pau Espin Pedrol585cfb22019-12-10 17:09:51 +0100949
Alexander Couzensb3b0c492019-10-04 03:40:26 +0200950 .... .1.. = END_OF_WINDOW: 1
Pau Espin Pedrol585cfb22019-12-10 17:09:51 +0100951
Alexander Couzensb3b0c492019-10-04 03:40:26 +0200952 .... ..10 0101 0001 1... .... = STARTING_SEQUENCE_NUMBER: 1187
Pau Espin Pedrol585cfb22019-12-10 17:09:51 +0100953
Alexander Couzens210ccf42019-06-16 17:05:40 +0200954 .0.. .... = CRBB Exist: 0
955 minimal size is 24 rest_bits */
956 rest_bits -= 24;
Jacob Erlbeck37005a12015-12-22 14:58:34 +0100957
958 if (num_blocks > 0)
959 /* V(Q) is NACK and omitted -> SSN = V(Q) + 1 */
960 num_blocks -= 1;
961
962 if (num_blocks > window->ws())
963 num_blocks = window->ws();
sivasankari8adfcd02017-01-16 15:41:21 +0530964 /* Try Compression as number of blocks does not fit */
965 if (num_blocks > rest_bits) {
966 try_compression = true;
967 }
968 if (try_compression == true) {
969 ucmp_bmplen = window->update_egprs_rbb(rbb);
970 ucmp_vec.data = rbb;
971 ucmp_vec.cur_bit = ucmp_bmplen;
972 ucmp_vec.data_len = 127;
973 crbb_vec.data = crbb_bitmap;
974 crbb_vec.cur_bit = 0;
975 crbb_vec.data_len = 127;
976 LOGP(DRLCMACUL, LOGL_DEBUG,
977 "rest_bits=%d uncompressed len %d and uncompressed bitmap = %s\n",
978 rest_bits, ucmp_bmplen,
979 osmo_hexdump(ucmp_vec.data, (ucmp_bmplen+7)/8));
Jacob Erlbeck37005a12015-12-22 14:58:34 +0100980
sivasankari8adfcd02017-01-16 15:41:21 +0530981 is_compressed = egprs_compress::compress_rbb(&ucmp_vec, /* Uncompressed bitmap*/
982 &crbb_vec, /*Compressed bitmap vector */
983 &uclen_crbb,
984 (rest_bits - 16));/* CRBBlength:7 colourcode:1 dissector length:8*/
985 LOGP(DRLCMACUL, LOGL_DEBUG,
986 "the ucmp len=%d uclen_crbb=%d num_blocks=%d crbb length %d, "
987 "and the CRBB bitmap = %s\n",
988 ucmp_bmplen, uclen_crbb, num_blocks, crbb_vec.cur_bit,
989 osmo_hexdump(crbb_bitmap, (crbb_vec.cur_bit+7)/8));
990 crbb_len = crbb_vec.cur_bit;
991 }
992
sivasankari8adfcd02017-01-16 15:41:21 +0530993
Alexander Couzens210ccf42019-06-16 17:05:40 +0200994 if (is_compressed) {
995 /* 8 = 7 (CRBBlength) + 1 (CRBB starting color code) */
996 rest_bits -= 8;
Pravin Kumarvel06bdb352016-10-24 12:21:21 +0530997 } else {
Alexander Couzens210ccf42019-06-16 17:05:40 +0200998 uclen_crbb = 0;
999 crbb_len = 0;
1000 }
1001
1002 if (num_blocks > uclen_crbb + rest_bits) {
1003 eow = false;
1004 urbb_len = rest_bits - crbb_len;
1005 } else
1006 urbb_len = num_blocks - uclen_crbb;
1007
1008 if (is_compressed)
sivasankari8adfcd02017-01-16 15:41:21 +05301009 len = urbb_len + crbb_len + 23;
Alexander Couzens210ccf42019-06-16 17:05:40 +02001010 else
1011 len = urbb_len + 15;
Jacob Erlbeck37005a12015-12-22 14:58:34 +01001012
Alexander Couzens210ccf42019-06-16 17:05:40 +02001013
1014 /* EGPRS Ack/Nack Description IE
1015 * do not support Ack/Nack without length */
1016 bitvec_write_field(dest, &wp, 1, 1); // 1: have length
1017 bitvec_write_field(dest, &wp, len, 8); // length
Jacob Erlbeck37005a12015-12-22 14:58:34 +01001018
Alexander Couzensccde5c92017-02-04 03:10:08 +01001019 bitvec_write_field(dest, &wp, is_final, 1); // FINAL_ACK_INDICATION
1020 bitvec_write_field(dest, &wp, bow, 1); // BEGINNING_OF_WINDOW
1021 bitvec_write_field(dest, &wp, eow, 1); // END_OF_WINDOW
1022 bitvec_write_field(dest, &wp, ssn, 11); // STARTING_SEQUENCE_NUMBER
Pravin Kumarvel06bdb352016-10-24 12:21:21 +05301023 if (is_compressed) {
Alexander Couzensccde5c92017-02-04 03:10:08 +01001024 bitvec_write_field(dest, &wp, 1, 1); // CRBB_Exist
1025 bitvec_write_field(dest, &wp, crbb_len, 7); // CRBB_LENGTH
sivasankari8adfcd02017-01-16 15:41:21 +05301026 crbb_start_clr_code = (0x80 & ucmp_vec.data[0])>>7;
Alexander Couzensccde5c92017-02-04 03:10:08 +01001027 bitvec_write_field(dest, &wp, crbb_start_clr_code, 1); // CRBB_clr_code
sivasankari8adfcd02017-01-16 15:41:21 +05301028 LOGP(DRLCMACUL, LOGL_DEBUG,
1029 "EGPRS CRBB, crbb_len = %d, crbb_start_clr_code = %d\n",
1030 crbb_len, crbb_start_clr_code);
1031 while (crbb_len != 0) {
1032 if (crbb_len > 8) {
Alexander Couzensccde5c92017-02-04 03:10:08 +01001033 bitvec_write_field(dest, &wp, crbb_bitmap[iter], 8);
sivasankari8adfcd02017-01-16 15:41:21 +05301034 crbb_len = crbb_len - 8;
1035 iter++;
1036 } else {
Alexander Couzens3f640772019-05-31 17:19:53 +02001037 bitvec_write_field(dest, &wp, crbb_bitmap[iter] >> (8 - crbb_len), crbb_len);
sivasankari8adfcd02017-01-16 15:41:21 +05301038 crbb_len = 0;
1039 }
1040 }
1041 esn_crbb = window->mod_sns(esn_crbb + uclen_crbb);
1042 } else {
Alexander Couzensccde5c92017-02-04 03:10:08 +01001043 bitvec_write_field(dest, &wp, 0, 1); // CRBB_Exist
sivasankari8adfcd02017-01-16 15:41:21 +05301044 }
Jacob Erlbeck37005a12015-12-22 14:58:34 +01001045 LOGP(DRLCMACUL, LOGL_DEBUG,
Alexander Couzense4e70d02019-06-16 16:20:10 +02001046 "EGPRS URBB, urbb len = %d, SSN = %u, ESN_CRBB = %u, "
Alexander Couzens210ccf42019-06-16 17:05:40 +02001047 "desc len = %d, "
Jacob Erlbeck37005a12015-12-22 14:58:34 +01001048 "SNS = %d, WS = %d, V(Q) = %d, V(R) = %d%s%s\n",
Alexander Couzens210ccf42019-06-16 17:05:40 +02001049 urbb_len, ssn, esn_crbb, len,
Jacob Erlbeck37005a12015-12-22 14:58:34 +01001050 window->sns(), window->ws(), window->v_q(), window->v_r(),
1051 bow ? ", BOW" : "", eow ? ", EOW" : "");
Pravin Kumarvel06bdb352016-10-24 12:21:21 +05301052
1053 for (i = urbb_len; i > 0; i--) {
Jacob Erlbeck37005a12015-12-22 14:58:34 +01001054 /* Set bit at the appropriate position (see 3GPP TS 04.60 12.3.1) */
1055 bool is_ack = window->m_v_n.is_received(esn_crbb + i);
Alexander Couzensccde5c92017-02-04 03:10:08 +01001056 bitvec_write_field(dest, &wp, is_ack, 1);
Jacob Erlbeck37005a12015-12-22 14:58:34 +01001057 }
1058}
1059
1060static void write_packet_uplink_ack_egprs(
Alexander Couzens3a499f32019-06-16 15:25:30 +02001061 bitvec * dest, unsigned& wp,
Jacob Erlbeck37005a12015-12-22 14:58:34 +01001062 struct gprs_rlcmac_ul_tbf *tbf, bool is_final)
1063{
Alexander Couzensccde5c92017-02-04 03:10:08 +01001064 bitvec_write_field(dest, &wp, 0, 2); // fixed 00
Aravind Sirsikar99ab0a82016-06-15 17:46:41 +05301065 /* CHANNEL_CODING_COMMAND */
Alexander Couzensccde5c92017-02-04 03:10:08 +01001066 bitvec_write_field(dest, &wp,
Max6e96dd42019-03-06 18:17:32 +01001067 mcs_chan_code(tbf->current_cs()), 4);
Aravind Sirsikar505a86d2016-07-26 18:26:21 +05301068 /* 0: no RESEGMENT, 1: Segmentation*/
Alexander Couzensccde5c92017-02-04 03:10:08 +01001069 bitvec_write_field(dest, &wp, 1, 1);
1070 bitvec_write_field(dest, &wp, 1, 1); // PRE_EMPTIVE_TRANSMISSION, TODO: This resembles GPRS, change it?
1071 bitvec_write_field(dest, &wp, 0, 1); // 0: no PRR_RETRANSMISSION_REQUEST, TODO: clarify
1072 bitvec_write_field(dest, &wp, 0, 1); // 0: no ARAC_RETRANSMISSION_REQUEST, TODO: clarify
1073 bitvec_write_field(dest, &wp, 1, 1); // 1: have CONTENTION_RESOLUTION_TLLI
1074 bitvec_write_field(dest, &wp, tbf->tlli(), 32); // CONTENTION_RESOLUTION_TLLI
1075 bitvec_write_field(dest, &wp, 1, 1); // TBF_EST (enabled)
1076 bitvec_write_field(dest, &wp, 0, 1); // 0: don't have Packet Timing Advance
1077 bitvec_write_field(dest, &wp, 0, 1); // 0: don't have Packet Extended Timing Advance
1078 bitvec_write_field(dest, &wp, 0, 1); // 0: don't have Power Control Parameters
1079 bitvec_write_field(dest, &wp, 0, 1); // 0: don't have Extension Bits
Jacob Erlbeck37005a12015-12-22 14:58:34 +01001080
sivasankari8adfcd02017-01-16 15:41:21 +05301081 /* -2 for last bit 0 mandatory and REL5 not supported */
1082 unsigned bits_ack_nack = dest->data_len * 8 - wp - 2;
Alexander Couzens3a499f32019-06-16 15:25:30 +02001083 write_packet_ack_nack_desc_egprs(dest, wp, tbf->window(), is_final, bits_ack_nack);
Jacob Erlbeck37005a12015-12-22 14:58:34 +01001084
Alexander Couzensccde5c92017-02-04 03:10:08 +01001085 bitvec_write_field(dest, &wp, 0, 1); // fixed 0
1086 bitvec_write_field(dest, &wp, 0, 1); // 0: don't have REL 5
Jacob Erlbeck37005a12015-12-22 14:58:34 +01001087};
1088
1089void Encoding::write_packet_uplink_ack(
Alexander Couzens3a499f32019-06-16 15:25:30 +02001090 bitvec * dest, struct gprs_rlcmac_ul_tbf *tbf, bool is_final,
Jacob Erlbeckf2694b72016-01-26 21:46:26 +01001091 uint8_t rrbp)
Jacob Erlbeck37005a12015-12-22 14:58:34 +01001092{
1093 unsigned wp = 0;
1094
1095 LOGP(DRLCMACUL, LOGL_DEBUG, "Encoding Ack/Nack for %s "
1096 "(final=%d)\n", tbf_name(tbf), is_final);
1097
Alexander Couzensccde5c92017-02-04 03:10:08 +01001098 bitvec_write_field(dest, &wp, 0x1, 2); // Payload Type
1099 bitvec_write_field(dest, &wp, rrbp, 2); // Uplink block with TDMA framenumber
1100 bitvec_write_field(dest, &wp, is_final, 1); // Suppl/Polling Bit
1101 bitvec_write_field(dest, &wp, 0x0, 3); // Uplink state flag
1102 bitvec_write_field(dest, &wp, 0x9, 6); // MESSAGE TYPE Uplink Ack/Nack
1103 bitvec_write_field(dest, &wp, 0x0, 2); // Page Mode
Jacob Erlbeck37005a12015-12-22 14:58:34 +01001104
Alexander Couzensccde5c92017-02-04 03:10:08 +01001105 bitvec_write_field(dest, &wp, 0x0, 2); // fixed 00
1106 bitvec_write_field(dest, &wp, tbf->tfi(), 5); // Uplink TFI
Jacob Erlbeck37005a12015-12-22 14:58:34 +01001107
1108 if (tbf->is_egprs_enabled()) {
1109 /* PU_AckNack_EGPRS = on */
Alexander Couzensccde5c92017-02-04 03:10:08 +01001110 bitvec_write_field(dest, &wp, 1, 1); // 1: EGPRS
Alexander Couzens3a499f32019-06-16 15:25:30 +02001111 write_packet_uplink_ack_egprs(dest, wp, tbf, is_final);
Jacob Erlbeck37005a12015-12-22 14:58:34 +01001112 } else {
1113 /* PU_AckNack_GPRS = on */
Alexander Couzensccde5c92017-02-04 03:10:08 +01001114 bitvec_write_field(dest, &wp, 0, 1); // 0: GPRS
Alexander Couzens3a499f32019-06-16 15:25:30 +02001115 write_packet_uplink_ack_gprs(dest, wp, tbf, is_final);
Jacob Erlbeck37005a12015-12-22 14:58:34 +01001116 }
1117
1118 LOGP(DRLCMACUL, LOGL_DEBUG,
1119 "Uplink Ack/Nack bit count %d, max %d, message = %s\n",
1120 wp, dest->data_len * 8,
1121 osmo_hexdump(dest->data, dest->data_len));
1122}
1123
Holger Hans Peter Freyther63f29d62013-10-19 19:04:03 +02001124unsigned Encoding::write_packet_paging_request(bitvec * dest)
Holger Hans Peter Freyther6ca0a902013-10-19 18:50:22 +02001125{
1126 unsigned wp = 0;
1127
Alexander Couzensb3b0c492019-10-04 03:40:26 +02001128 bitvec_write_field(dest, &wp, 0x1, 2); // Payload Type
1129 bitvec_write_field(dest, &wp, 0x0, 3); // No polling
1130 bitvec_write_field(dest, &wp, 0x0, 3); // Uplink state flag
1131 bitvec_write_field(dest, &wp, 0x22, 6); // MESSAGE TYPE
Holger Hans Peter Freyther6ca0a902013-10-19 18:50:22 +02001132
Alexander Couzensb3b0c492019-10-04 03:40:26 +02001133 bitvec_write_field(dest, &wp, 0x0, 2); // Page Mode
Holger Hans Peter Freyther6ca0a902013-10-19 18:50:22 +02001134
Alexander Couzensb3b0c492019-10-04 03:40:26 +02001135 bitvec_write_field(dest, &wp, 0x0, 1); // No PERSISTENCE_LEVEL
1136 bitvec_write_field(dest, &wp, 0x0, 1); // No NLN
Holger Hans Peter Freyther6ca0a902013-10-19 18:50:22 +02001137
1138 return wp;
1139}
1140
JF Dionne1beed382016-07-26 15:16:08 -04001141/* 3GPP TS 44.060 § 11.2.10:
1142 < Repeated Page info struct > ::=
1143 { 0 -- Page request for TBF establishment
1144 { 0 < PTMSI : bit (32) >
1145 | 1 < Length of Mobile Identity contents : bit (4) >
1146 < Mobile Identity : octet (val (Length of Mobile Identity contents)) > }
1147 | 1 -- Page request for RR conn. establishment
1148 { 0 < TMSI : bit (32) >
1149 | 1 < Length of Mobile Identity contents : bit (4) >
1150 < Mobile Identity : octet (val (Length of Mobile Identity contents)) > }
1151 < CHANNEL_NEEDED : bit (2) >
1152 { 0 | 1 < eMLPP_PRIORITY : bit (3) > }
1153 }
1154 */
Holger Hans Peter Freyther63f29d62013-10-19 19:04:03 +02001155unsigned Encoding::write_repeated_page_info(bitvec * dest, unsigned& wp, uint8_t len,
Holger Hans Peter Freyther6ca0a902013-10-19 18:50:22 +02001156 uint8_t *identity, uint8_t chan_needed)
1157{
Alexander Couzensccde5c92017-02-04 03:10:08 +01001158 bitvec_write_field(dest, &wp,0x1,1); // Repeated Page info exists
Holger Hans Peter Freyther6ca0a902013-10-19 18:50:22 +02001159
Alexander Couzensccde5c92017-02-04 03:10:08 +01001160 bitvec_write_field(dest, &wp,0x1,1); // RR connection paging
Holger Hans Peter Freyther6ca0a902013-10-19 18:50:22 +02001161
1162 if ((identity[0] & 0x07) == 4) {
Alexander Couzensccde5c92017-02-04 03:10:08 +01001163 bitvec_write_field(dest, &wp,0x0,1); // TMSI
Holger Hans Peter Freyther6ca0a902013-10-19 18:50:22 +02001164 identity++;
1165 len--;
1166 } else {
JF Dionne1beed382016-07-26 15:16:08 -04001167 bitvec_write_field(dest, &wp,0x1,1); // MI
Alexander Couzensccde5c92017-02-04 03:10:08 +01001168 bitvec_write_field(dest, &wp,len,4); // MI len
Holger Hans Peter Freyther6ca0a902013-10-19 18:50:22 +02001169 }
1170 while (len) {
Alexander Couzensccde5c92017-02-04 03:10:08 +01001171 bitvec_write_field(dest, &wp,*identity++,8); // MI data
Holger Hans Peter Freyther6ca0a902013-10-19 18:50:22 +02001172 len--;
1173 }
Alexander Couzensccde5c92017-02-04 03:10:08 +01001174 bitvec_write_field(dest, &wp,chan_needed,2); // CHANNEL_NEEDED
1175 bitvec_write_field(dest, &wp,0x0,1); // No eMLPP_PRIORITY
Holger Hans Peter Freyther6ca0a902013-10-19 18:50:22 +02001176
1177 return wp;
1178}
1179
Jacob Erlbeckf0e40392016-01-08 10:07:53 +01001180int Encoding::rlc_write_dl_data_header(const struct gprs_rlc_data_info *rlc,
1181 uint8_t *data)
1182{
Jacob Erlbeck9e859392016-02-02 11:48:37 +01001183 struct gprs_rlc_dl_header_egprs_1 *egprs1;
1184 struct gprs_rlc_dl_header_egprs_2 *egprs2;
Jacob Erlbeckf0e40392016-01-08 10:07:53 +01001185 struct gprs_rlc_dl_header_egprs_3 *egprs3;
1186 struct rlc_dl_header *gprs;
1187 unsigned int e_fbi_header;
Pau Espin Pedrol2ae83372020-05-18 11:35:35 +02001188 enum CodingScheme cs = rlc->cs;
Jacob Erlbeck9e859392016-02-02 11:48:37 +01001189 unsigned int offs;
1190 unsigned int bsn_delta;
Jacob Erlbeckf0e40392016-01-08 10:07:53 +01001191
Pau Espin Pedrol2ae83372020-05-18 11:35:35 +02001192 switch(mcs_header_type(cs)) {
Max51754b62019-03-13 17:14:13 +01001193 case HEADER_GPRS_DATA:
Jacob Erlbeckf0e40392016-01-08 10:07:53 +01001194 gprs = static_cast<struct rlc_dl_header *>
1195 ((void *)data);
1196
1197 gprs->usf = rlc->usf;
1198 gprs->s_p = rlc->es_p != 0 ? 1 : 0;
1199 gprs->rrbp = rlc->rrbp;
1200 gprs->pt = 0;
1201 gprs->tfi = rlc->tfi;
1202 gprs->pr = rlc->pr;
1203
1204 gprs->fbi = rlc->block_info[0].cv == 0;
1205 gprs->e = rlc->block_info[0].e;
1206 gprs->bsn = rlc->block_info[0].bsn;
1207 break;
1208
Max51754b62019-03-13 17:14:13 +01001209 case HEADER_EGPRS_DATA_TYPE_1:
Jacob Erlbeck9e859392016-02-02 11:48:37 +01001210 egprs1 = static_cast<struct gprs_rlc_dl_header_egprs_1 *>
1211 ((void *)data);
1212
1213 egprs1->usf = rlc->usf;
1214 egprs1->es_p = rlc->es_p;
1215 egprs1->rrbp = rlc->rrbp;
Tom Tsoudf698092016-07-11 17:05:19 -07001216 egprs1->tfi_hi = rlc->tfi >> 0; /* 1 bit LSB */
1217 egprs1->tfi_lo = rlc->tfi >> 1; /* 4 bits */
Jacob Erlbeck9e859392016-02-02 11:48:37 +01001218 egprs1->pr = rlc->pr;
1219 egprs1->cps = rlc->cps;
1220
Tom Tsoudf698092016-07-11 17:05:19 -07001221 egprs1->bsn1_hi = rlc->block_info[0].bsn >> 0; /* 2 bits LSB */
1222 egprs1->bsn1_mid = rlc->block_info[0].bsn >> 2; /* 8 bits */
1223 egprs1->bsn1_lo = rlc->block_info[0].bsn >> 10; /* 1 bit */
Jacob Erlbeck9e859392016-02-02 11:48:37 +01001224
1225 bsn_delta = (rlc->block_info[1].bsn - rlc->block_info[0].bsn) &
1226 (RLC_EGPRS_SNS - 1);
1227
Tom Tsoudf698092016-07-11 17:05:19 -07001228 egprs1->bsn2_hi = bsn_delta >> 0; /* 7 bits LSB */
1229 egprs1->bsn2_lo = bsn_delta >> 7; /* 3 bits */
Jacob Erlbeck9e859392016-02-02 11:48:37 +01001230
1231 /* first FBI/E header */
1232 e_fbi_header = rlc->block_info[0].e ? 0x01 : 0;
1233 e_fbi_header |= rlc->block_info[0].cv == 0 ? 0x02 : 0; /* FBI */
Jacob Erlbeck0f5c6952016-02-03 18:35:27 +01001234 offs = rlc->data_offs_bits[0] / 8;
1235 OSMO_ASSERT(rlc->data_offs_bits[0] % 8 == 2);
Jacob Erlbeck9e859392016-02-02 11:48:37 +01001236 e_fbi_header <<= 0;
Jacob Erlbeck0f5c6952016-02-03 18:35:27 +01001237 data[offs] = (data[offs] & 0b11111100) | e_fbi_header;
Jacob Erlbeck9e859392016-02-02 11:48:37 +01001238
1239 /* second FBI/E header */
1240 e_fbi_header = rlc->block_info[1].e ? 0x01 : 0;
1241 e_fbi_header |= rlc->block_info[1].cv == 0 ? 0x02 : 0; /* FBI */
1242 offs = rlc->data_offs_bits[1] / 8;
1243 OSMO_ASSERT(rlc->data_offs_bits[1] % 8 == 4);
1244 e_fbi_header <<= 2;
1245 data[offs] = (data[offs] & 0b11110011) | e_fbi_header;
1246 break;
1247
Max51754b62019-03-13 17:14:13 +01001248 case HEADER_EGPRS_DATA_TYPE_2:
Jacob Erlbeck9e859392016-02-02 11:48:37 +01001249 egprs2 = static_cast<struct gprs_rlc_dl_header_egprs_2 *>
1250 ((void *)data);
1251
1252 egprs2->usf = rlc->usf;
1253 egprs2->es_p = rlc->es_p;
1254 egprs2->rrbp = rlc->rrbp;
Tom Tsoudf698092016-07-11 17:05:19 -07001255 egprs2->tfi_hi = rlc->tfi >> 0; /* 1 bit LSB */
1256 egprs2->tfi_lo = rlc->tfi >> 1; /* 4 bits */
Jacob Erlbeck9e859392016-02-02 11:48:37 +01001257 egprs2->pr = rlc->pr;
1258 egprs2->cps = rlc->cps;
1259
Tom Tsoudf698092016-07-11 17:05:19 -07001260 egprs2->bsn1_hi = rlc->block_info[0].bsn >> 0; /* 2 bits LSB */
1261 egprs2->bsn1_mid = rlc->block_info[0].bsn >> 2; /* 8 bits */
1262 egprs2->bsn1_lo = rlc->block_info[0].bsn >> 10; /* 1 bit */
Jacob Erlbeck9e859392016-02-02 11:48:37 +01001263
1264 e_fbi_header = rlc->block_info[0].e ? 0x01 : 0;
1265 e_fbi_header |= rlc->block_info[0].cv == 0 ? 0x02 : 0; /* FBI */
Jacob Erlbeck0f5c6952016-02-03 18:35:27 +01001266 offs = rlc->data_offs_bits[0] / 8;
1267 OSMO_ASSERT(rlc->data_offs_bits[0] % 8 == 6);
Jacob Erlbeck9e859392016-02-02 11:48:37 +01001268 e_fbi_header <<= 4;
Jacob Erlbeck0f5c6952016-02-03 18:35:27 +01001269 data[offs] = (data[offs] & 0b11001111) | e_fbi_header;
Jacob Erlbeck9e859392016-02-02 11:48:37 +01001270 break;
1271
Max51754b62019-03-13 17:14:13 +01001272 case HEADER_EGPRS_DATA_TYPE_3:
Jacob Erlbeckf0e40392016-01-08 10:07:53 +01001273 egprs3 = static_cast<struct gprs_rlc_dl_header_egprs_3 *>
1274 ((void *)data);
1275
1276 egprs3->usf = rlc->usf;
1277 egprs3->es_p = rlc->es_p;
1278 egprs3->rrbp = rlc->rrbp;
Tom Tsoudf698092016-07-11 17:05:19 -07001279 egprs3->tfi_hi = rlc->tfi >> 0; /* 1 bit LSB */
1280 egprs3->tfi_lo = rlc->tfi >> 1; /* 4 bits */
Jacob Erlbeckf0e40392016-01-08 10:07:53 +01001281 egprs3->pr = rlc->pr;
1282 egprs3->cps = rlc->cps;
1283
Tom Tsoudf698092016-07-11 17:05:19 -07001284 egprs3->bsn1_hi = rlc->block_info[0].bsn >> 0; /* 2 bits LSB */
1285 egprs3->bsn1_mid = rlc->block_info[0].bsn >> 2; /* 8 bits */
1286 egprs3->bsn1_lo = rlc->block_info[0].bsn >> 10; /* 1 bit */
Jacob Erlbeckf0e40392016-01-08 10:07:53 +01001287
1288 egprs3->spb = rlc->block_info[0].spb;
1289
1290 e_fbi_header = rlc->block_info[0].e ? 0x01 : 0;
1291 e_fbi_header |= rlc->block_info[0].cv == 0 ? 0x02 : 0; /* FBI */
Jacob Erlbeck0f5c6952016-02-03 18:35:27 +01001292 offs = rlc->data_offs_bits[0] / 8;
1293 OSMO_ASSERT(rlc->data_offs_bits[0] % 8 == 1);
Jacob Erlbeckf0e40392016-01-08 10:07:53 +01001294 e_fbi_header <<= 7;
Jacob Erlbeck0f5c6952016-02-03 18:35:27 +01001295 data[offs-1] = (data[offs-1] & 0b01111111) | (e_fbi_header >> 0);
1296 data[offs] = (data[offs] & 0b11111110) | (e_fbi_header >> 8);
Jacob Erlbeckf0e40392016-01-08 10:07:53 +01001297 break;
1298
Jacob Erlbeckf0e40392016-01-08 10:07:53 +01001299 default:
1300 LOGP(DRLCMACDL, LOGL_ERROR,
1301 "Encoding of uplink %s data blocks not yet supported.\n",
Max136ebcc2019-03-05 14:59:03 +01001302 mcs_name(cs));
Jacob Erlbeckf0e40392016-01-08 10:07:53 +01001303 return -ENOTSUP;
1304 };
1305
1306 return 0;
1307}
1308
1309/**
1310 * \brief Copy LSB bitstream RLC data block from byte aligned buffer.
1311 *
1312 * Note that the bitstream is encoded in LSB first order, so the two octets
1313 * 654321xx xxxxxx87 contain the octet 87654321 starting at bit position 3
1314 * (LSB has bit position 1). This is a different order than the one used by
1315 * CSN.1.
1316 *
1317 * \param data_block_idx The block index, 0..1 for header type 1, 0 otherwise
1318 * \param src A pointer to the start of the RLC block (incl. the header)
1319 * \param buffer A data area of a least the size of the RLC block
1320 * \returns the number of bytes copied
1321 */
1322unsigned int Encoding::rlc_copy_from_aligned_buffer(
1323 const struct gprs_rlc_data_info *rlc,
1324 unsigned int data_block_idx,
1325 uint8_t *dst, const uint8_t *buffer)
1326{
1327 unsigned int hdr_bytes;
1328 unsigned int extra_bits;
1329 unsigned int i;
1330
1331 uint8_t c, last_c;
1332 const uint8_t *src;
1333 const struct gprs_rlc_data_block_info *rdbi;
1334
1335 OSMO_ASSERT(data_block_idx < rlc->num_data_blocks);
1336 rdbi = &rlc->block_info[data_block_idx];
1337
1338 hdr_bytes = rlc->data_offs_bits[data_block_idx] / 8;
1339 extra_bits = (rlc->data_offs_bits[data_block_idx] % 8);
1340
1341 if (extra_bits == 0) {
1342 /* It is aligned already */
1343 memmove(dst + hdr_bytes, buffer, rdbi->data_len);
1344 return rdbi->data_len;
1345 }
1346
1347 src = buffer;
1348 dst = dst + hdr_bytes;
1349 last_c = *dst << (8 - extra_bits);
1350
1351 for (i = 0; i < rdbi->data_len; i++) {
1352 c = src[i];
1353 *(dst++) = (last_c >> (8 - extra_bits)) | (c << extra_bits);
1354 last_c = c;
1355 }
1356
1357 /* overwrite the lower extra_bits */
1358 *dst = (*dst & (0xff << extra_bits)) | (last_c >> (8 - extra_bits));
1359
1360 return rdbi->data_len;
1361}
Jacob Erlbeck14bb0942016-01-12 11:58:13 +01001362
Alexander Couzenscb846ec2016-05-30 19:10:48 +02001363/*!
1364 * \brief (GPRS) put llc pdu into an rlc/mac block. fragment the llc pdu if needed
1365 * \param rdbi rlc/mac block info
1366 * \param llc llc pdu
1367 * \param offset given offset within the rlc/mac block
1368 * \param num_chunks count the chunks (llc pdu data) within rlc/mac
1369 * \param data_block buffer holds rlc/mac data
1370 * \param is_final if this is the last rlc/mac within a TBF
Alexander Couzens6f0dc962016-05-30 19:30:21 +02001371 * \param count_payload if not NULL save the written size of payload in bytes into it
Alexander Couzenscb846ec2016-05-30 19:10:48 +02001372 * \return the state of the rlc/mac like if there is more space for another chunk
1373 */
Jacob Erlbeck5058bd62016-01-13 10:51:25 +01001374static Encoding::AppendResult rlc_data_to_dl_append_gprs(
Jacob Erlbeck14bb0942016-01-12 11:58:13 +01001375 struct gprs_rlc_data_block_info *rdbi,
1376 gprs_llc *llc, int *offset, int *num_chunks,
Alexander Couzens6f0dc962016-05-30 19:30:21 +02001377 uint8_t *data_block, bool is_final, int *count_payload)
Jacob Erlbeck14bb0942016-01-12 11:58:13 +01001378{
1379 int chunk;
1380 int space;
1381 struct rlc_li_field *li;
1382 uint8_t *delimiter, *data, *e_pointer;
1383
1384 data = data_block + *offset;
1385 delimiter = data_block + *num_chunks;
1386 e_pointer = (*num_chunks ? delimiter - 1 : NULL);
1387
1388 chunk = llc->chunk_size();
1389 space = rdbi->data_len - *offset;
1390
1391 /* if chunk will exceed block limit */
1392 if (chunk > space) {
1393 LOGP(DRLCMACDL, LOGL_DEBUG, "-- Chunk with length %d "
1394 "larger than space (%d) left in block: copy "
1395 "only remaining space, and we are done\n",
1396 chunk, space);
1397 /* block is filled, so there is no extension */
1398 if (e_pointer)
1399 *e_pointer |= 0x01;
1400 /* fill only space */
1401 llc->consume(data, space);
Alexander Couzens6f0dc962016-05-30 19:30:21 +02001402 if (count_payload)
1403 *count_payload = space;
Jacob Erlbeck14bb0942016-01-12 11:58:13 +01001404 /* return data block as message */
1405 *offset = rdbi->data_len;
1406 (*num_chunks)++;
Jacob Erlbeck5058bd62016-01-13 10:51:25 +01001407 return Encoding::AR_NEED_MORE_BLOCKS;
Jacob Erlbeck14bb0942016-01-12 11:58:13 +01001408 }
1409 /* if FINAL chunk would fit precisely in space left */
1410 if (chunk == space && is_final)
1411 {
1412 LOGP(DRLCMACDL, LOGL_DEBUG, "-- Chunk with length %d "
1413 "would exactly fit into space (%d): because "
1414 "this is a final block, we don't add length "
1415 "header, and we are done\n", chunk, space);
1416 /* block is filled, so there is no extension */
1417 if (e_pointer)
1418 *e_pointer |= 0x01;
1419 /* fill space */
1420 llc->consume(data, space);
Alexander Couzens6f0dc962016-05-30 19:30:21 +02001421 if (count_payload)
1422 *count_payload = space;
Jacob Erlbeck14bb0942016-01-12 11:58:13 +01001423 *offset = rdbi->data_len;
1424 (*num_chunks)++;
1425 rdbi->cv = 0;
Jacob Erlbeck5058bd62016-01-13 10:51:25 +01001426 return Encoding::AR_COMPLETED_BLOCK_FILLED;
Jacob Erlbeck14bb0942016-01-12 11:58:13 +01001427 }
1428 /* if chunk would fit exactly in space left */
1429 if (chunk == space) {
1430 LOGP(DRLCMACDL, LOGL_DEBUG, "-- Chunk with length %d "
1431 "would exactly fit into space (%d): add length "
1432 "header with LI=0, to make frame extend to "
1433 "next block, and we are done\n", chunk, space);
1434 /* make space for delimiter */
1435 if (delimiter != data)
1436 memmove(delimiter + 1, delimiter,
1437 data - delimiter);
1438 data++;
1439 (*offset)++;
1440 space--;
1441 /* add LI with 0 length */
1442 li = (struct rlc_li_field *)delimiter;
1443 li->e = 1; /* not more extension */
1444 li->m = 0; /* shall be set to 0, in case of li = 0 */
1445 li->li = 0; /* chunk fills the complete space */
1446 rdbi->e = 0; /* 0: extensions present */
1447 // no need to set e_pointer nor increase delimiter
1448 /* fill only space, which is 1 octet less than chunk */
1449 llc->consume(data, space);
Alexander Couzens6f0dc962016-05-30 19:30:21 +02001450 if (count_payload)
1451 *count_payload = space;
Jacob Erlbeck14bb0942016-01-12 11:58:13 +01001452 /* return data block as message */
1453 *offset = rdbi->data_len;
1454 (*num_chunks)++;
Jacob Erlbeck5058bd62016-01-13 10:51:25 +01001455 return Encoding::AR_NEED_MORE_BLOCKS;
Jacob Erlbeck14bb0942016-01-12 11:58:13 +01001456 }
1457
1458 LOGP(DRLCMACDL, LOGL_DEBUG, "-- Chunk with length %d is less "
1459 "than remaining space (%d): add length header to "
1460 "to delimit LLC frame\n", chunk, space);
1461 /* the LLC frame chunk ends in this block */
1462 /* make space for delimiter */
1463 if (delimiter != data)
1464 memmove(delimiter + 1, delimiter, data - delimiter);
1465 data++;
1466 (*offset)++;
1467 space--;
1468 /* add LI to delimit frame */
1469 li = (struct rlc_li_field *)delimiter;
1470 li->e = 0; /* Extension bit, maybe set later */
1471 li->m = 0; /* will be set later, if there is more LLC data */
1472 li->li = chunk; /* length of chunk */
1473 rdbi->e = 0; /* 0: extensions present */
1474 (*num_chunks)++;
1475 /* copy (rest of) LLC frame to space and reset later */
1476 llc->consume(data, chunk);
Alexander Couzens6f0dc962016-05-30 19:30:21 +02001477 if (count_payload)
1478 *count_payload = chunk;
Jacob Erlbeck14bb0942016-01-12 11:58:13 +01001479 data += chunk;
1480 space -= chunk;
1481 (*offset) += chunk;
1482 /* if we have more data and we have space left */
1483 if (space > 0 && !is_final) {
1484 li->m = 1; /* we indicate more frames to follow */
Jacob Erlbeck5058bd62016-01-13 10:51:25 +01001485 return Encoding::AR_COMPLETED_SPACE_LEFT;
Jacob Erlbeck14bb0942016-01-12 11:58:13 +01001486 }
1487 /* if we don't have more LLC frames */
1488 if (is_final) {
1489 LOGP(DRLCMACDL, LOGL_DEBUG, "-- Final block, so we "
1490 "done.\n");
1491 li->e = 1; /* we cannot extend */
1492 rdbi->cv = 0;
Jacob Erlbeck5058bd62016-01-13 10:51:25 +01001493 return Encoding::AR_COMPLETED_BLOCK_FILLED;
Jacob Erlbeck14bb0942016-01-12 11:58:13 +01001494 }
1495 /* we have no space left */
1496 LOGP(DRLCMACDL, LOGL_DEBUG, "-- No space left, so we are "
1497 "done.\n");
1498 li->e = 1; /* we cannot extend */
Jacob Erlbeck5058bd62016-01-13 10:51:25 +01001499 return Encoding::AR_COMPLETED_BLOCK_FILLED;
1500}
1501
Alexander Couzenscb846ec2016-05-30 19:10:48 +02001502/*!
1503 * \brief (EGPRS) put llc pdu into an rlc/mac block. fragment the llc pdu if needed
1504 * \param rdbi rlc/mac block info
1505 * \param llc llc pdu
1506 * \param offset given offset within the rlc/mac block
1507 * \param num_chunks count the chunks (llc pdu data) within rlc/mac
1508 * \param data_block buffer holds rlc/mac data
1509 * \param is_final if this is the last rlc/mac within a TBF
Alexander Couzens6f0dc962016-05-30 19:30:21 +02001510 * \param count_payload if not NULL save the written size of payload in bytes into it
Alexander Couzenscb846ec2016-05-30 19:10:48 +02001511 * \return the state of the rlc/mac like if there is more space for another chunk
1512 */
Jacob Erlbecka88d0652016-01-13 11:28:10 +01001513static Encoding::AppendResult rlc_data_to_dl_append_egprs(
1514 struct gprs_rlc_data_block_info *rdbi,
1515 gprs_llc *llc, int *offset, int *num_chunks,
1516 uint8_t *data_block,
Alexander Couzens6f0dc962016-05-30 19:30:21 +02001517 bool is_final, int *count_payload)
Jacob Erlbecka88d0652016-01-13 11:28:10 +01001518{
1519 int chunk;
1520 int space;
1521 struct rlc_li_field_egprs *li;
1522 struct rlc_li_field_egprs *prev_li;
1523 uint8_t *delimiter, *data;
1524
1525 data = data_block + *offset;
1526 delimiter = data_block + *num_chunks;
1527 prev_li = (struct rlc_li_field_egprs *)
1528 (*num_chunks ? delimiter - 1 : NULL);
1529
1530 chunk = llc->chunk_size();
1531 space = rdbi->data_len - *offset;
1532
1533 /* if chunk will exceed block limit */
1534 if (chunk > space) {
1535 LOGP(DRLCMACDL, LOGL_DEBUG, "-- Chunk with length %d "
1536 "larger than space (%d) left in block: copy "
1537 "only remaining space, and we are done\n",
1538 chunk, space);
1539 /* fill only space */
1540 llc->consume(data, space);
Alexander Couzens6f0dc962016-05-30 19:30:21 +02001541 if (count_payload)
1542 *count_payload = space;
Jacob Erlbecka88d0652016-01-13 11:28:10 +01001543 /* return data block as message */
1544 *offset = rdbi->data_len;
1545 (*num_chunks)++;
1546 return Encoding::AR_NEED_MORE_BLOCKS;
1547 }
1548 /* if FINAL chunk would fit precisely in space left */
1549 if (chunk == space && is_final)
1550 {
1551 LOGP(DRLCMACDL, LOGL_DEBUG, "-- Chunk with length %d "
1552 "would exactly fit into space (%d): because "
1553 "this is a final block, we don't add length "
1554 "header, and we are done\n", chunk, space);
1555 /* fill space */
1556 llc->consume(data, space);
Alexander Couzens6f0dc962016-05-30 19:30:21 +02001557 if (count_payload)
1558 *count_payload = space;
Jacob Erlbecka88d0652016-01-13 11:28:10 +01001559 *offset = rdbi->data_len;
1560 (*num_chunks)++;
1561 rdbi->cv = 0;
1562 return Encoding::AR_COMPLETED_BLOCK_FILLED;
1563 }
1564 /* if chunk would fit exactly in space left */
1565 if (chunk == space) {
1566 LOGP(DRLCMACDL, LOGL_DEBUG, "-- Chunk with length %d "
1567 "would exactly fit into space (%d): just copy "
1568 "it, and we are done. The next block will have "
1569 "to start with an empty chunk\n",
1570 chunk, space);
1571 /* fill space */
1572 llc->consume(data, space);
Alexander Couzens6f0dc962016-05-30 19:30:21 +02001573 if (count_payload)
1574 *count_payload = space;
Jacob Erlbecka88d0652016-01-13 11:28:10 +01001575 *offset = rdbi->data_len;
1576 (*num_chunks)++;
1577 return Encoding::AR_NEED_MORE_BLOCKS;
1578 }
1579
1580 LOGP(DRLCMACDL, LOGL_DEBUG, "-- Chunk with length %d is less "
1581 "than remaining space (%d): add length header to "
1582 "to delimit LLC frame\n", chunk, space);
1583 /* the LLC frame chunk ends in this block */
1584 /* make space for delimiter */
1585
1586 if (delimiter != data)
1587 memmove(delimiter + 1, delimiter, data - delimiter);
1588
1589 data += 1;
1590 (*offset) += 1;
1591 space -= 1;
1592 /* add LI to delimit frame */
1593 li = (struct rlc_li_field_egprs *)delimiter;
1594 li->e = 1; /* Extension bit, maybe set later */
1595 li->li = chunk; /* length of chunk */
1596 /* tell previous extension header about the new one */
1597 if (prev_li)
1598 prev_li->e = 0;
1599 rdbi->e = 0; /* 0: extensions present */
1600 delimiter++;
1601 prev_li = li;
1602 (*num_chunks)++;
1603 /* copy (rest of) LLC frame to space and reset later */
1604 llc->consume(data, chunk);
Alexander Couzens6f0dc962016-05-30 19:30:21 +02001605 if (count_payload)
1606 *count_payload = chunk;
Jacob Erlbecka88d0652016-01-13 11:28:10 +01001607 data += chunk;
1608 space -= chunk;
1609 (*offset) += chunk;
1610 /* if we have more data and we have space left */
1611 if (space > 0) {
1612 if (!is_final)
1613 return Encoding::AR_COMPLETED_SPACE_LEFT;
1614
1615 /* we don't have more LLC frames */
1616 /* We will have to add another chunk with filling octets */
1617 LOGP(DRLCMACDL, LOGL_DEBUG,
1618 "-- There is remaining space (%d): add filling byte chunk\n",
1619 space);
1620
1621 if (delimiter != data)
1622 memmove(delimiter + 1, delimiter, data - delimiter);
1623
1624 data += 1;
1625 (*offset) += 1;
1626 space -= 1;
1627
1628 /* set filling bytes extension */
1629 li = (struct rlc_li_field_egprs *)delimiter;
1630 li->e = 1;
1631 li->li = 127;
1632
1633 /* tell previous extension header about the new one */
1634 if (prev_li)
1635 prev_li->e = 0;
1636
1637 delimiter++;
1638 (*num_chunks)++;
1639
1640 rdbi->cv = 0;
1641
1642 LOGP(DRLCMACDL, LOGL_DEBUG, "-- Final block, so we "
1643 "are done.\n");
1644
1645 *offset = rdbi->data_len;
1646 return Encoding::AR_COMPLETED_BLOCK_FILLED;
1647 }
1648
1649 if (is_final) {
1650 /* we don't have more LLC frames */
1651 LOGP(DRLCMACDL, LOGL_DEBUG, "-- Final block, so we "
1652 "are done.\n");
1653 rdbi->cv = 0;
1654 return Encoding::AR_COMPLETED_BLOCK_FILLED;
1655 }
1656
1657 /* we have no space left */
1658 LOGP(DRLCMACDL, LOGL_DEBUG, "-- No space left, so we are "
1659 "done.\n");
1660 return Encoding::AR_COMPLETED_BLOCK_FILLED;
1661}
1662
Alexander Couzenscb846ec2016-05-30 19:10:48 +02001663/*!
1664 * \brief Encoding::rlc_data_to_dl_append
1665 * \param rdbi rlc/mac block info
1666 * \param cs the coding scheme to use
1667 * \param llc llc pdu
1668 * \param offset given offset within the rlc/mac block
1669 * \param num_chunks count the chunks (llc pdu data) within rlc/mac
1670 * \param data_block buffer holds rlc/mac data
1671 * \param is_final if this is the last rlc/mac within a TBF
Alexander Couzens6f0dc962016-05-30 19:30:21 +02001672 * \param count_payload if not NULL save the written size of payload in bytes into it
Alexander Couzenscb846ec2016-05-30 19:10:48 +02001673 * \return the state of the rlc/mac like if there is more space for another chunk
1674 */
Jacob Erlbeck5058bd62016-01-13 10:51:25 +01001675Encoding::AppendResult Encoding::rlc_data_to_dl_append(
Pau Espin Pedrol2ae83372020-05-18 11:35:35 +02001676 struct gprs_rlc_data_block_info *rdbi, enum CodingScheme cs,
Jacob Erlbeck5058bd62016-01-13 10:51:25 +01001677 gprs_llc *llc, int *offset, int *num_chunks,
Alexander Couzens6f0dc962016-05-30 19:30:21 +02001678 uint8_t *data_block, bool is_final, int *count_payload)
Jacob Erlbeck5058bd62016-01-13 10:51:25 +01001679{
Max8a8e0fb2019-03-25 16:32:50 +01001680 if (mcs_is_gprs(cs))
Jacob Erlbeck5058bd62016-01-13 10:51:25 +01001681 return rlc_data_to_dl_append_gprs(rdbi,
Alexander Couzens6f0dc962016-05-30 19:30:21 +02001682 llc, offset, num_chunks, data_block, is_final,
1683 count_payload);
Jacob Erlbeck5058bd62016-01-13 10:51:25 +01001684
Max8a8e0fb2019-03-25 16:32:50 +01001685 if (mcs_is_edge(cs))
Jacob Erlbecka88d0652016-01-13 11:28:10 +01001686 return rlc_data_to_dl_append_egprs(rdbi,
Alexander Couzens6f0dc962016-05-30 19:30:21 +02001687 llc, offset, num_chunks, data_block, is_final,
1688 count_payload);
Jacob Erlbecka88d0652016-01-13 11:28:10 +01001689
Jacob Erlbeck5058bd62016-01-13 10:51:25 +01001690 LOGP(DRLCMACDL, LOGL_ERROR, "%s data block encoding not implemented\n",
Max136ebcc2019-03-05 14:59:03 +01001691 mcs_name(cs));
Jacob Erlbeck5058bd62016-01-13 10:51:25 +01001692
1693 return AR_NEED_MORE_BLOCKS;
Jacob Erlbeck14bb0942016-01-12 11:58:13 +01001694}
aravind sirsikared3413e2016-11-11 17:15:10 +05301695
1696/*
1697 * Refer 44.060 version 7.27.0 Release 7
1698 * section 7.1.3.2.1 On receipt of a PACKET RESOURCE REQUEST message
1699 * 8.1.2.5 Establishment of uplink TBF
1700 */
1701void Encoding::write_packet_access_reject(
1702 bitvec * dest, uint32_t tlli)
1703{
1704 unsigned wp = 0;
1705
Alexander Couzensccde5c92017-02-04 03:10:08 +01001706 bitvec_write_field(dest, &wp, 0x1, 2); // Payload Type
1707 bitvec_write_field(dest, &wp, 0x0, 2); // Uplink block with TDMA FN
1708 bitvec_write_field(dest, &wp, 0, 1); // No Polling Bit
1709 bitvec_write_field(dest, &wp, 0x0, 3); // Uplink state flag
1710 bitvec_write_field(dest, &wp,
aravind sirsikared3413e2016-11-11 17:15:10 +05301711 MT_PACKET_ACCESS_REJECT, 6); // MESSAGE TYPE
Alexander Couzensccde5c92017-02-04 03:10:08 +01001712 bitvec_write_field(dest, &wp, 0, 2); // fixed 00
1713 bitvec_write_field(dest, &wp, 0x0, 1); // TLLI / G-RNTI : bit (32)
1714 bitvec_write_field(dest, &wp, tlli, 32); // CONTENTION_RESOLUTION_TLLI
1715 bitvec_write_field(dest, &wp, 1, 1); // WAIT_INDICATION size in seconds
aravind sirsikared3413e2016-11-11 17:15:10 +05301716 /* TODO: make it configurable */
Alexander Couzensccde5c92017-02-04 03:10:08 +01001717 bitvec_write_field(dest, &wp, 5, 8); // WAIT_INDICATION value
1718 bitvec_write_field(dest, &wp, 0, 1); // WAIT_INDICATION size in seconds
aravind sirsikared3413e2016-11-11 17:15:10 +05301719}