blob: 23e1460d3cc94cac1b560fc8a138fd0e71787ffb [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
Pau Espin Pedrol16705a42020-10-27 10:24:57 +0100856 if ((i%8) == 7) {
Daniel Willmann5241c1a2013-12-11 14:35:29 +0100857 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{
Pau Espin Pedrolb3f23972020-10-23 21:00:23 +0200889 gprs_rlc_ul_window *window = static_cast<gprs_rlc_ul_window *>(tbf->window());
Jacob Erlbeck37005a12015-12-22 14:58:34 +0100890
Max6e96dd42019-03-06 18:17:32 +0100891 bitvec_write_field(dest, &wp, mcs_chan_code(tbf->current_cs()), 2); // CHANNEL_CODING_COMMAND
Pau Espin Pedrolb3f23972020-10-23 21:00:23 +0200892 write_packet_ack_nack_desc_gprs(dest, wp, window, is_final);
Jacob Erlbeck37005a12015-12-22 14:58:34 +0100893
Alexander Couzensccde5c92017-02-04 03:10:08 +0100894 bitvec_write_field(dest, &wp, 1, 1); // 1: have CONTENTION_RESOLUTION_TLLI
895 bitvec_write_field(dest, &wp, tbf->tlli(), 32); // CONTENTION_RESOLUTION_TLLI
Jacob Erlbeck37005a12015-12-22 14:58:34 +0100896
Alexander Couzensccde5c92017-02-04 03:10:08 +0100897 bitvec_write_field(dest, &wp, 0, 1); // 0: don't have Packet Timing Advance
898 bitvec_write_field(dest, &wp, 0, 1); // 0: don't have Power Control Parameters
899 bitvec_write_field(dest, &wp, 0, 1); // 0: don't have Extension Bits
900 bitvec_write_field(dest, &wp, 0, 1); // fixed 0
901 bitvec_write_field(dest, &wp, 1, 1); // 1: have Additions R99
902 bitvec_write_field(dest, &wp, 0, 1); // 0: don't have Packet Extended Timing Advance
903 bitvec_write_field(dest, &wp, 1, 1); // TBF_EST (enabled)
904 bitvec_write_field(dest, &wp, 0, 1); // 0: don't have REL 5
Jacob Erlbeck37005a12015-12-22 14:58:34 +0100905};
906
Alexander Couzens210ccf42019-06-16 17:05:40 +0200907/* Encode the Ack/Nack for EGPRS. 44.060
908 * The PCU encodes to receive block bitmap to the following rules:
909 * - always encode the lenght field
910 * - use compressed receive block bitmap if it's smaller than uncompressed
911 * receive block bitmap
912 * - use the remaining bits for an uncompressed receive block bitmap if needed
913 *
914 * Note: The spec also defines an Ack/Nack without length field, but the PCU's
915 * doesn't support this in UL. It would require a lot more code complexity
916 * and only saves 7 bit in lossy sitations.
917 */
Jacob Erlbeck37005a12015-12-22 14:58:34 +0100918static void write_packet_ack_nack_desc_egprs(
Alexander Couzens3a499f32019-06-16 15:25:30 +0200919 bitvec * dest, unsigned& wp,
Alexander Couzens243a2042019-06-16 21:53:03 +0200920 gprs_rlc_ul_window *window, bool is_final, unsigned rest_bits)
Jacob Erlbeck37005a12015-12-22 14:58:34 +0100921{
sivasankari8adfcd02017-01-16 15:41:21 +0530922 unsigned int urbb_len = 0;
923 uint8_t crbb_len = 0;
924 uint8_t len;
Jacob Erlbeck37005a12015-12-22 14:58:34 +0100925 bool bow = true;
926 bool eow = true;
Alexander Couzense4e70d02019-06-16 16:20:10 +0200927 uint16_t ssn = window->mod_sns(window->v_q() + 1);
sivasankari8adfcd02017-01-16 15:41:21 +0530928 unsigned int num_blocks = window->mod_sns(window->v_r() - window->v_q());
Alexander Couzense4e70d02019-06-16 16:20:10 +0200929 uint16_t esn_crbb = window->mod_sns(ssn - 1);
sivasankari8adfcd02017-01-16 15:41:21 +0530930 static uint8_t rbb[RLC_EGPRS_MAX_WS] = {'\0'};
931 uint8_t iter = 0;
Pravin Kumarvel06bdb352016-10-24 12:21:21 +0530932 int is_compressed = 0;
sivasankari8adfcd02017-01-16 15:41:21 +0530933 bool try_compression = false;
Alexander Couzense4e70d02019-06-16 16:20:10 +0200934 uint16_t ucmp_bmplen;
sivasankari8adfcd02017-01-16 15:41:21 +0530935 uint8_t crbb_bitmap[23] = {'\0'};
936 bitvec ucmp_vec;
937 bitvec crbb_vec;
938 uint8_t uclen_crbb = 0;
sivasankari8adfcd02017-01-16 15:41:21 +0530939 uint8_t crbb_start_clr_code;
Pravin Kumarvel06bdb352016-10-24 12:21:21 +0530940 uint8_t i;
Alexander Couzensb7439f22019-06-16 15:16:30 +0200941
942 /* static size of 16 bits
Alexander Couzens210ccf42019-06-16 17:05:40 +0200943 ..1. .... = ACKNACK: (Union)
944 0 0000 000 Length
Alexander Couzensb3b0c492019-10-04 03:40:26 +0200945 Desc
Pau Espin Pedrol585cfb22019-12-10 17:09:51 +0100946
Alexander Couzensb3b0c492019-10-04 03:40:26 +0200947 ...0 .... = FINAL_ACK_INDICATION: False
Pau Espin Pedrol585cfb22019-12-10 17:09:51 +0100948
Alexander Couzensb3b0c492019-10-04 03:40:26 +0200949 .... 1... = BEGINNING_OF_WINDOW: 1
Pau Espin Pedrol585cfb22019-12-10 17:09:51 +0100950
Alexander Couzensb3b0c492019-10-04 03:40:26 +0200951 .... .1.. = END_OF_WINDOW: 1
Pau Espin Pedrol585cfb22019-12-10 17:09:51 +0100952
Alexander Couzensb3b0c492019-10-04 03:40:26 +0200953 .... ..10 0101 0001 1... .... = STARTING_SEQUENCE_NUMBER: 1187
Pau Espin Pedrol585cfb22019-12-10 17:09:51 +0100954
Alexander Couzens210ccf42019-06-16 17:05:40 +0200955 .0.. .... = CRBB Exist: 0
956 minimal size is 24 rest_bits */
957 rest_bits -= 24;
Jacob Erlbeck37005a12015-12-22 14:58:34 +0100958
959 if (num_blocks > 0)
960 /* V(Q) is NACK and omitted -> SSN = V(Q) + 1 */
961 num_blocks -= 1;
962
963 if (num_blocks > window->ws())
964 num_blocks = window->ws();
sivasankari8adfcd02017-01-16 15:41:21 +0530965 /* Try Compression as number of blocks does not fit */
966 if (num_blocks > rest_bits) {
967 try_compression = true;
968 }
969 if (try_compression == true) {
970 ucmp_bmplen = window->update_egprs_rbb(rbb);
971 ucmp_vec.data = rbb;
972 ucmp_vec.cur_bit = ucmp_bmplen;
973 ucmp_vec.data_len = 127;
974 crbb_vec.data = crbb_bitmap;
975 crbb_vec.cur_bit = 0;
976 crbb_vec.data_len = 127;
977 LOGP(DRLCMACUL, LOGL_DEBUG,
978 "rest_bits=%d uncompressed len %d and uncompressed bitmap = %s\n",
979 rest_bits, ucmp_bmplen,
980 osmo_hexdump(ucmp_vec.data, (ucmp_bmplen+7)/8));
Jacob Erlbeck37005a12015-12-22 14:58:34 +0100981
sivasankari8adfcd02017-01-16 15:41:21 +0530982 is_compressed = egprs_compress::compress_rbb(&ucmp_vec, /* Uncompressed bitmap*/
983 &crbb_vec, /*Compressed bitmap vector */
984 &uclen_crbb,
985 (rest_bits - 16));/* CRBBlength:7 colourcode:1 dissector length:8*/
986 LOGP(DRLCMACUL, LOGL_DEBUG,
987 "the ucmp len=%d uclen_crbb=%d num_blocks=%d crbb length %d, "
988 "and the CRBB bitmap = %s\n",
989 ucmp_bmplen, uclen_crbb, num_blocks, crbb_vec.cur_bit,
990 osmo_hexdump(crbb_bitmap, (crbb_vec.cur_bit+7)/8));
991 crbb_len = crbb_vec.cur_bit;
992 }
993
sivasankari8adfcd02017-01-16 15:41:21 +0530994
Alexander Couzens210ccf42019-06-16 17:05:40 +0200995 if (is_compressed) {
996 /* 8 = 7 (CRBBlength) + 1 (CRBB starting color code) */
997 rest_bits -= 8;
Pravin Kumarvel06bdb352016-10-24 12:21:21 +0530998 } else {
Alexander Couzens210ccf42019-06-16 17:05:40 +0200999 uclen_crbb = 0;
1000 crbb_len = 0;
1001 }
1002
1003 if (num_blocks > uclen_crbb + rest_bits) {
1004 eow = false;
1005 urbb_len = rest_bits - crbb_len;
1006 } else
1007 urbb_len = num_blocks - uclen_crbb;
1008
1009 if (is_compressed)
sivasankari8adfcd02017-01-16 15:41:21 +05301010 len = urbb_len + crbb_len + 23;
Alexander Couzens210ccf42019-06-16 17:05:40 +02001011 else
1012 len = urbb_len + 15;
Jacob Erlbeck37005a12015-12-22 14:58:34 +01001013
Alexander Couzens210ccf42019-06-16 17:05:40 +02001014
1015 /* EGPRS Ack/Nack Description IE
1016 * do not support Ack/Nack without length */
1017 bitvec_write_field(dest, &wp, 1, 1); // 1: have length
1018 bitvec_write_field(dest, &wp, len, 8); // length
Jacob Erlbeck37005a12015-12-22 14:58:34 +01001019
Alexander Couzensccde5c92017-02-04 03:10:08 +01001020 bitvec_write_field(dest, &wp, is_final, 1); // FINAL_ACK_INDICATION
1021 bitvec_write_field(dest, &wp, bow, 1); // BEGINNING_OF_WINDOW
1022 bitvec_write_field(dest, &wp, eow, 1); // END_OF_WINDOW
1023 bitvec_write_field(dest, &wp, ssn, 11); // STARTING_SEQUENCE_NUMBER
Pravin Kumarvel06bdb352016-10-24 12:21:21 +05301024 if (is_compressed) {
Alexander Couzensccde5c92017-02-04 03:10:08 +01001025 bitvec_write_field(dest, &wp, 1, 1); // CRBB_Exist
1026 bitvec_write_field(dest, &wp, crbb_len, 7); // CRBB_LENGTH
sivasankari8adfcd02017-01-16 15:41:21 +05301027 crbb_start_clr_code = (0x80 & ucmp_vec.data[0])>>7;
Alexander Couzensccde5c92017-02-04 03:10:08 +01001028 bitvec_write_field(dest, &wp, crbb_start_clr_code, 1); // CRBB_clr_code
sivasankari8adfcd02017-01-16 15:41:21 +05301029 LOGP(DRLCMACUL, LOGL_DEBUG,
1030 "EGPRS CRBB, crbb_len = %d, crbb_start_clr_code = %d\n",
1031 crbb_len, crbb_start_clr_code);
1032 while (crbb_len != 0) {
1033 if (crbb_len > 8) {
Alexander Couzensccde5c92017-02-04 03:10:08 +01001034 bitvec_write_field(dest, &wp, crbb_bitmap[iter], 8);
sivasankari8adfcd02017-01-16 15:41:21 +05301035 crbb_len = crbb_len - 8;
1036 iter++;
1037 } else {
Alexander Couzens3f640772019-05-31 17:19:53 +02001038 bitvec_write_field(dest, &wp, crbb_bitmap[iter] >> (8 - crbb_len), crbb_len);
sivasankari8adfcd02017-01-16 15:41:21 +05301039 crbb_len = 0;
1040 }
1041 }
1042 esn_crbb = window->mod_sns(esn_crbb + uclen_crbb);
1043 } else {
Alexander Couzensccde5c92017-02-04 03:10:08 +01001044 bitvec_write_field(dest, &wp, 0, 1); // CRBB_Exist
sivasankari8adfcd02017-01-16 15:41:21 +05301045 }
Jacob Erlbeck37005a12015-12-22 14:58:34 +01001046 LOGP(DRLCMACUL, LOGL_DEBUG,
Alexander Couzense4e70d02019-06-16 16:20:10 +02001047 "EGPRS URBB, urbb len = %d, SSN = %u, ESN_CRBB = %u, "
Alexander Couzens210ccf42019-06-16 17:05:40 +02001048 "desc len = %d, "
Jacob Erlbeck37005a12015-12-22 14:58:34 +01001049 "SNS = %d, WS = %d, V(Q) = %d, V(R) = %d%s%s\n",
Alexander Couzens210ccf42019-06-16 17:05:40 +02001050 urbb_len, ssn, esn_crbb, len,
Jacob Erlbeck37005a12015-12-22 14:58:34 +01001051 window->sns(), window->ws(), window->v_q(), window->v_r(),
1052 bow ? ", BOW" : "", eow ? ", EOW" : "");
Pravin Kumarvel06bdb352016-10-24 12:21:21 +05301053
1054 for (i = urbb_len; i > 0; i--) {
Jacob Erlbeck37005a12015-12-22 14:58:34 +01001055 /* Set bit at the appropriate position (see 3GPP TS 04.60 12.3.1) */
1056 bool is_ack = window->m_v_n.is_received(esn_crbb + i);
Alexander Couzensccde5c92017-02-04 03:10:08 +01001057 bitvec_write_field(dest, &wp, is_ack, 1);
Jacob Erlbeck37005a12015-12-22 14:58:34 +01001058 }
1059}
1060
1061static void write_packet_uplink_ack_egprs(
Alexander Couzens3a499f32019-06-16 15:25:30 +02001062 bitvec * dest, unsigned& wp,
Jacob Erlbeck37005a12015-12-22 14:58:34 +01001063 struct gprs_rlcmac_ul_tbf *tbf, bool is_final)
1064{
Pau Espin Pedrolb3f23972020-10-23 21:00:23 +02001065 gprs_rlc_ul_window *window = static_cast<gprs_rlc_ul_window *>(tbf->window());
1066
Alexander Couzensccde5c92017-02-04 03:10:08 +01001067 bitvec_write_field(dest, &wp, 0, 2); // fixed 00
Aravind Sirsikar99ab0a82016-06-15 17:46:41 +05301068 /* CHANNEL_CODING_COMMAND */
Alexander Couzensccde5c92017-02-04 03:10:08 +01001069 bitvec_write_field(dest, &wp,
Max6e96dd42019-03-06 18:17:32 +01001070 mcs_chan_code(tbf->current_cs()), 4);
Aravind Sirsikar505a86d2016-07-26 18:26:21 +05301071 /* 0: no RESEGMENT, 1: Segmentation*/
Alexander Couzensccde5c92017-02-04 03:10:08 +01001072 bitvec_write_field(dest, &wp, 1, 1);
1073 bitvec_write_field(dest, &wp, 1, 1); // PRE_EMPTIVE_TRANSMISSION, TODO: This resembles GPRS, change it?
1074 bitvec_write_field(dest, &wp, 0, 1); // 0: no PRR_RETRANSMISSION_REQUEST, TODO: clarify
1075 bitvec_write_field(dest, &wp, 0, 1); // 0: no ARAC_RETRANSMISSION_REQUEST, TODO: clarify
1076 bitvec_write_field(dest, &wp, 1, 1); // 1: have CONTENTION_RESOLUTION_TLLI
1077 bitvec_write_field(dest, &wp, tbf->tlli(), 32); // CONTENTION_RESOLUTION_TLLI
1078 bitvec_write_field(dest, &wp, 1, 1); // TBF_EST (enabled)
1079 bitvec_write_field(dest, &wp, 0, 1); // 0: don't have Packet Timing Advance
1080 bitvec_write_field(dest, &wp, 0, 1); // 0: don't have Packet Extended Timing Advance
1081 bitvec_write_field(dest, &wp, 0, 1); // 0: don't have Power Control Parameters
1082 bitvec_write_field(dest, &wp, 0, 1); // 0: don't have Extension Bits
Jacob Erlbeck37005a12015-12-22 14:58:34 +01001083
sivasankari8adfcd02017-01-16 15:41:21 +05301084 /* -2 for last bit 0 mandatory and REL5 not supported */
1085 unsigned bits_ack_nack = dest->data_len * 8 - wp - 2;
Pau Espin Pedrolb3f23972020-10-23 21:00:23 +02001086 write_packet_ack_nack_desc_egprs(dest, wp, window, is_final, bits_ack_nack);
Jacob Erlbeck37005a12015-12-22 14:58:34 +01001087
Alexander Couzensccde5c92017-02-04 03:10:08 +01001088 bitvec_write_field(dest, &wp, 0, 1); // fixed 0
1089 bitvec_write_field(dest, &wp, 0, 1); // 0: don't have REL 5
Jacob Erlbeck37005a12015-12-22 14:58:34 +01001090};
1091
1092void Encoding::write_packet_uplink_ack(
Alexander Couzens3a499f32019-06-16 15:25:30 +02001093 bitvec * dest, struct gprs_rlcmac_ul_tbf *tbf, bool is_final,
Jacob Erlbeckf2694b72016-01-26 21:46:26 +01001094 uint8_t rrbp)
Jacob Erlbeck37005a12015-12-22 14:58:34 +01001095{
1096 unsigned wp = 0;
1097
1098 LOGP(DRLCMACUL, LOGL_DEBUG, "Encoding Ack/Nack for %s "
1099 "(final=%d)\n", tbf_name(tbf), is_final);
1100
Alexander Couzensccde5c92017-02-04 03:10:08 +01001101 bitvec_write_field(dest, &wp, 0x1, 2); // Payload Type
1102 bitvec_write_field(dest, &wp, rrbp, 2); // Uplink block with TDMA framenumber
1103 bitvec_write_field(dest, &wp, is_final, 1); // Suppl/Polling Bit
1104 bitvec_write_field(dest, &wp, 0x0, 3); // Uplink state flag
1105 bitvec_write_field(dest, &wp, 0x9, 6); // MESSAGE TYPE Uplink Ack/Nack
1106 bitvec_write_field(dest, &wp, 0x0, 2); // Page Mode
Jacob Erlbeck37005a12015-12-22 14:58:34 +01001107
Alexander Couzensccde5c92017-02-04 03:10:08 +01001108 bitvec_write_field(dest, &wp, 0x0, 2); // fixed 00
1109 bitvec_write_field(dest, &wp, tbf->tfi(), 5); // Uplink TFI
Jacob Erlbeck37005a12015-12-22 14:58:34 +01001110
1111 if (tbf->is_egprs_enabled()) {
1112 /* PU_AckNack_EGPRS = on */
Alexander Couzensccde5c92017-02-04 03:10:08 +01001113 bitvec_write_field(dest, &wp, 1, 1); // 1: EGPRS
Alexander Couzens3a499f32019-06-16 15:25:30 +02001114 write_packet_uplink_ack_egprs(dest, wp, tbf, is_final);
Jacob Erlbeck37005a12015-12-22 14:58:34 +01001115 } else {
1116 /* PU_AckNack_GPRS = on */
Alexander Couzensccde5c92017-02-04 03:10:08 +01001117 bitvec_write_field(dest, &wp, 0, 1); // 0: GPRS
Alexander Couzens3a499f32019-06-16 15:25:30 +02001118 write_packet_uplink_ack_gprs(dest, wp, tbf, is_final);
Jacob Erlbeck37005a12015-12-22 14:58:34 +01001119 }
1120
1121 LOGP(DRLCMACUL, LOGL_DEBUG,
1122 "Uplink Ack/Nack bit count %d, max %d, message = %s\n",
1123 wp, dest->data_len * 8,
1124 osmo_hexdump(dest->data, dest->data_len));
1125}
1126
Holger Hans Peter Freyther63f29d62013-10-19 19:04:03 +02001127unsigned Encoding::write_packet_paging_request(bitvec * dest)
Holger Hans Peter Freyther6ca0a902013-10-19 18:50:22 +02001128{
1129 unsigned wp = 0;
1130
Alexander Couzensb3b0c492019-10-04 03:40:26 +02001131 bitvec_write_field(dest, &wp, 0x1, 2); // Payload Type
1132 bitvec_write_field(dest, &wp, 0x0, 3); // No polling
1133 bitvec_write_field(dest, &wp, 0x0, 3); // Uplink state flag
1134 bitvec_write_field(dest, &wp, 0x22, 6); // MESSAGE TYPE
Holger Hans Peter Freyther6ca0a902013-10-19 18:50:22 +02001135
Alexander Couzensb3b0c492019-10-04 03:40:26 +02001136 bitvec_write_field(dest, &wp, 0x0, 2); // Page Mode
Holger Hans Peter Freyther6ca0a902013-10-19 18:50:22 +02001137
Alexander Couzensb3b0c492019-10-04 03:40:26 +02001138 bitvec_write_field(dest, &wp, 0x0, 1); // No PERSISTENCE_LEVEL
1139 bitvec_write_field(dest, &wp, 0x0, 1); // No NLN
Holger Hans Peter Freyther6ca0a902013-10-19 18:50:22 +02001140
1141 return wp;
1142}
1143
JF Dionne1beed382016-07-26 15:16:08 -04001144/* 3GPP TS 44.060 § 11.2.10:
1145 < Repeated Page info struct > ::=
1146 { 0 -- Page request for TBF establishment
1147 { 0 < PTMSI : bit (32) >
1148 | 1 < Length of Mobile Identity contents : bit (4) >
1149 < Mobile Identity : octet (val (Length of Mobile Identity contents)) > }
1150 | 1 -- Page request for RR conn. establishment
1151 { 0 < TMSI : bit (32) >
1152 | 1 < Length of Mobile Identity contents : bit (4) >
1153 < Mobile Identity : octet (val (Length of Mobile Identity contents)) > }
1154 < CHANNEL_NEEDED : bit (2) >
1155 { 0 | 1 < eMLPP_PRIORITY : bit (3) > }
1156 }
1157 */
Holger Hans Peter Freyther63f29d62013-10-19 19:04:03 +02001158unsigned Encoding::write_repeated_page_info(bitvec * dest, unsigned& wp, uint8_t len,
Holger Hans Peter Freyther6ca0a902013-10-19 18:50:22 +02001159 uint8_t *identity, uint8_t chan_needed)
1160{
Alexander Couzensccde5c92017-02-04 03:10:08 +01001161 bitvec_write_field(dest, &wp,0x1,1); // Repeated Page info exists
Holger Hans Peter Freyther6ca0a902013-10-19 18:50:22 +02001162
Alexander Couzensccde5c92017-02-04 03:10:08 +01001163 bitvec_write_field(dest, &wp,0x1,1); // RR connection paging
Holger Hans Peter Freyther6ca0a902013-10-19 18:50:22 +02001164
1165 if ((identity[0] & 0x07) == 4) {
Alexander Couzensccde5c92017-02-04 03:10:08 +01001166 bitvec_write_field(dest, &wp,0x0,1); // TMSI
Holger Hans Peter Freyther6ca0a902013-10-19 18:50:22 +02001167 identity++;
1168 len--;
1169 } else {
JF Dionne1beed382016-07-26 15:16:08 -04001170 bitvec_write_field(dest, &wp,0x1,1); // MI
Alexander Couzensccde5c92017-02-04 03:10:08 +01001171 bitvec_write_field(dest, &wp,len,4); // MI len
Holger Hans Peter Freyther6ca0a902013-10-19 18:50:22 +02001172 }
1173 while (len) {
Alexander Couzensccde5c92017-02-04 03:10:08 +01001174 bitvec_write_field(dest, &wp,*identity++,8); // MI data
Holger Hans Peter Freyther6ca0a902013-10-19 18:50:22 +02001175 len--;
1176 }
Alexander Couzensccde5c92017-02-04 03:10:08 +01001177 bitvec_write_field(dest, &wp,chan_needed,2); // CHANNEL_NEEDED
1178 bitvec_write_field(dest, &wp,0x0,1); // No eMLPP_PRIORITY
Holger Hans Peter Freyther6ca0a902013-10-19 18:50:22 +02001179
1180 return wp;
1181}
1182
Jacob Erlbeckf0e40392016-01-08 10:07:53 +01001183int Encoding::rlc_write_dl_data_header(const struct gprs_rlc_data_info *rlc,
1184 uint8_t *data)
1185{
Jacob Erlbeck9e859392016-02-02 11:48:37 +01001186 struct gprs_rlc_dl_header_egprs_1 *egprs1;
1187 struct gprs_rlc_dl_header_egprs_2 *egprs2;
Jacob Erlbeckf0e40392016-01-08 10:07:53 +01001188 struct gprs_rlc_dl_header_egprs_3 *egprs3;
1189 struct rlc_dl_header *gprs;
1190 unsigned int e_fbi_header;
Pau Espin Pedrol2ae83372020-05-18 11:35:35 +02001191 enum CodingScheme cs = rlc->cs;
Jacob Erlbeck9e859392016-02-02 11:48:37 +01001192 unsigned int offs;
1193 unsigned int bsn_delta;
Jacob Erlbeckf0e40392016-01-08 10:07:53 +01001194
Pau Espin Pedrol2ae83372020-05-18 11:35:35 +02001195 switch(mcs_header_type(cs)) {
Max51754b62019-03-13 17:14:13 +01001196 case HEADER_GPRS_DATA:
Jacob Erlbeckf0e40392016-01-08 10:07:53 +01001197 gprs = static_cast<struct rlc_dl_header *>
1198 ((void *)data);
1199
1200 gprs->usf = rlc->usf;
1201 gprs->s_p = rlc->es_p != 0 ? 1 : 0;
1202 gprs->rrbp = rlc->rrbp;
1203 gprs->pt = 0;
1204 gprs->tfi = rlc->tfi;
1205 gprs->pr = rlc->pr;
1206
1207 gprs->fbi = rlc->block_info[0].cv == 0;
1208 gprs->e = rlc->block_info[0].e;
1209 gprs->bsn = rlc->block_info[0].bsn;
1210 break;
1211
Max51754b62019-03-13 17:14:13 +01001212 case HEADER_EGPRS_DATA_TYPE_1:
Jacob Erlbeck9e859392016-02-02 11:48:37 +01001213 egprs1 = static_cast<struct gprs_rlc_dl_header_egprs_1 *>
1214 ((void *)data);
1215
1216 egprs1->usf = rlc->usf;
1217 egprs1->es_p = rlc->es_p;
1218 egprs1->rrbp = rlc->rrbp;
Tom Tsoudf698092016-07-11 17:05:19 -07001219 egprs1->tfi_hi = rlc->tfi >> 0; /* 1 bit LSB */
1220 egprs1->tfi_lo = rlc->tfi >> 1; /* 4 bits */
Jacob Erlbeck9e859392016-02-02 11:48:37 +01001221 egprs1->pr = rlc->pr;
1222 egprs1->cps = rlc->cps;
1223
Tom Tsoudf698092016-07-11 17:05:19 -07001224 egprs1->bsn1_hi = rlc->block_info[0].bsn >> 0; /* 2 bits LSB */
1225 egprs1->bsn1_mid = rlc->block_info[0].bsn >> 2; /* 8 bits */
1226 egprs1->bsn1_lo = rlc->block_info[0].bsn >> 10; /* 1 bit */
Jacob Erlbeck9e859392016-02-02 11:48:37 +01001227
1228 bsn_delta = (rlc->block_info[1].bsn - rlc->block_info[0].bsn) &
1229 (RLC_EGPRS_SNS - 1);
1230
Tom Tsoudf698092016-07-11 17:05:19 -07001231 egprs1->bsn2_hi = bsn_delta >> 0; /* 7 bits LSB */
1232 egprs1->bsn2_lo = bsn_delta >> 7; /* 3 bits */
Jacob Erlbeck9e859392016-02-02 11:48:37 +01001233
1234 /* first FBI/E header */
1235 e_fbi_header = rlc->block_info[0].e ? 0x01 : 0;
1236 e_fbi_header |= rlc->block_info[0].cv == 0 ? 0x02 : 0; /* FBI */
Jacob Erlbeck0f5c6952016-02-03 18:35:27 +01001237 offs = rlc->data_offs_bits[0] / 8;
1238 OSMO_ASSERT(rlc->data_offs_bits[0] % 8 == 2);
Jacob Erlbeck9e859392016-02-02 11:48:37 +01001239 e_fbi_header <<= 0;
Jacob Erlbeck0f5c6952016-02-03 18:35:27 +01001240 data[offs] = (data[offs] & 0b11111100) | e_fbi_header;
Jacob Erlbeck9e859392016-02-02 11:48:37 +01001241
1242 /* second FBI/E header */
1243 e_fbi_header = rlc->block_info[1].e ? 0x01 : 0;
1244 e_fbi_header |= rlc->block_info[1].cv == 0 ? 0x02 : 0; /* FBI */
1245 offs = rlc->data_offs_bits[1] / 8;
1246 OSMO_ASSERT(rlc->data_offs_bits[1] % 8 == 4);
1247 e_fbi_header <<= 2;
1248 data[offs] = (data[offs] & 0b11110011) | e_fbi_header;
1249 break;
1250
Max51754b62019-03-13 17:14:13 +01001251 case HEADER_EGPRS_DATA_TYPE_2:
Jacob Erlbeck9e859392016-02-02 11:48:37 +01001252 egprs2 = static_cast<struct gprs_rlc_dl_header_egprs_2 *>
1253 ((void *)data);
1254
1255 egprs2->usf = rlc->usf;
1256 egprs2->es_p = rlc->es_p;
1257 egprs2->rrbp = rlc->rrbp;
Tom Tsoudf698092016-07-11 17:05:19 -07001258 egprs2->tfi_hi = rlc->tfi >> 0; /* 1 bit LSB */
1259 egprs2->tfi_lo = rlc->tfi >> 1; /* 4 bits */
Jacob Erlbeck9e859392016-02-02 11:48:37 +01001260 egprs2->pr = rlc->pr;
1261 egprs2->cps = rlc->cps;
1262
Tom Tsoudf698092016-07-11 17:05:19 -07001263 egprs2->bsn1_hi = rlc->block_info[0].bsn >> 0; /* 2 bits LSB */
1264 egprs2->bsn1_mid = rlc->block_info[0].bsn >> 2; /* 8 bits */
1265 egprs2->bsn1_lo = rlc->block_info[0].bsn >> 10; /* 1 bit */
Jacob Erlbeck9e859392016-02-02 11:48:37 +01001266
1267 e_fbi_header = rlc->block_info[0].e ? 0x01 : 0;
1268 e_fbi_header |= rlc->block_info[0].cv == 0 ? 0x02 : 0; /* FBI */
Jacob Erlbeck0f5c6952016-02-03 18:35:27 +01001269 offs = rlc->data_offs_bits[0] / 8;
1270 OSMO_ASSERT(rlc->data_offs_bits[0] % 8 == 6);
Jacob Erlbeck9e859392016-02-02 11:48:37 +01001271 e_fbi_header <<= 4;
Jacob Erlbeck0f5c6952016-02-03 18:35:27 +01001272 data[offs] = (data[offs] & 0b11001111) | e_fbi_header;
Jacob Erlbeck9e859392016-02-02 11:48:37 +01001273 break;
1274
Max51754b62019-03-13 17:14:13 +01001275 case HEADER_EGPRS_DATA_TYPE_3:
Jacob Erlbeckf0e40392016-01-08 10:07:53 +01001276 egprs3 = static_cast<struct gprs_rlc_dl_header_egprs_3 *>
1277 ((void *)data);
1278
1279 egprs3->usf = rlc->usf;
1280 egprs3->es_p = rlc->es_p;
1281 egprs3->rrbp = rlc->rrbp;
Tom Tsoudf698092016-07-11 17:05:19 -07001282 egprs3->tfi_hi = rlc->tfi >> 0; /* 1 bit LSB */
1283 egprs3->tfi_lo = rlc->tfi >> 1; /* 4 bits */
Jacob Erlbeckf0e40392016-01-08 10:07:53 +01001284 egprs3->pr = rlc->pr;
1285 egprs3->cps = rlc->cps;
1286
Tom Tsoudf698092016-07-11 17:05:19 -07001287 egprs3->bsn1_hi = rlc->block_info[0].bsn >> 0; /* 2 bits LSB */
1288 egprs3->bsn1_mid = rlc->block_info[0].bsn >> 2; /* 8 bits */
1289 egprs3->bsn1_lo = rlc->block_info[0].bsn >> 10; /* 1 bit */
Jacob Erlbeckf0e40392016-01-08 10:07:53 +01001290
1291 egprs3->spb = rlc->block_info[0].spb;
1292
1293 e_fbi_header = rlc->block_info[0].e ? 0x01 : 0;
1294 e_fbi_header |= rlc->block_info[0].cv == 0 ? 0x02 : 0; /* FBI */
Jacob Erlbeck0f5c6952016-02-03 18:35:27 +01001295 offs = rlc->data_offs_bits[0] / 8;
1296 OSMO_ASSERT(rlc->data_offs_bits[0] % 8 == 1);
Jacob Erlbeckf0e40392016-01-08 10:07:53 +01001297 e_fbi_header <<= 7;
Jacob Erlbeck0f5c6952016-02-03 18:35:27 +01001298 data[offs-1] = (data[offs-1] & 0b01111111) | (e_fbi_header >> 0);
1299 data[offs] = (data[offs] & 0b11111110) | (e_fbi_header >> 8);
Jacob Erlbeckf0e40392016-01-08 10:07:53 +01001300 break;
1301
Jacob Erlbeckf0e40392016-01-08 10:07:53 +01001302 default:
1303 LOGP(DRLCMACDL, LOGL_ERROR,
1304 "Encoding of uplink %s data blocks not yet supported.\n",
Max136ebcc2019-03-05 14:59:03 +01001305 mcs_name(cs));
Jacob Erlbeckf0e40392016-01-08 10:07:53 +01001306 return -ENOTSUP;
1307 };
1308
1309 return 0;
1310}
1311
1312/**
1313 * \brief Copy LSB bitstream RLC data block from byte aligned buffer.
1314 *
1315 * Note that the bitstream is encoded in LSB first order, so the two octets
1316 * 654321xx xxxxxx87 contain the octet 87654321 starting at bit position 3
1317 * (LSB has bit position 1). This is a different order than the one used by
1318 * CSN.1.
1319 *
1320 * \param data_block_idx The block index, 0..1 for header type 1, 0 otherwise
1321 * \param src A pointer to the start of the RLC block (incl. the header)
1322 * \param buffer A data area of a least the size of the RLC block
1323 * \returns the number of bytes copied
1324 */
1325unsigned int Encoding::rlc_copy_from_aligned_buffer(
1326 const struct gprs_rlc_data_info *rlc,
1327 unsigned int data_block_idx,
1328 uint8_t *dst, const uint8_t *buffer)
1329{
1330 unsigned int hdr_bytes;
1331 unsigned int extra_bits;
1332 unsigned int i;
1333
1334 uint8_t c, last_c;
1335 const uint8_t *src;
1336 const struct gprs_rlc_data_block_info *rdbi;
1337
1338 OSMO_ASSERT(data_block_idx < rlc->num_data_blocks);
1339 rdbi = &rlc->block_info[data_block_idx];
1340
1341 hdr_bytes = rlc->data_offs_bits[data_block_idx] / 8;
1342 extra_bits = (rlc->data_offs_bits[data_block_idx] % 8);
1343
1344 if (extra_bits == 0) {
1345 /* It is aligned already */
1346 memmove(dst + hdr_bytes, buffer, rdbi->data_len);
1347 return rdbi->data_len;
1348 }
1349
1350 src = buffer;
1351 dst = dst + hdr_bytes;
1352 last_c = *dst << (8 - extra_bits);
1353
1354 for (i = 0; i < rdbi->data_len; i++) {
1355 c = src[i];
1356 *(dst++) = (last_c >> (8 - extra_bits)) | (c << extra_bits);
1357 last_c = c;
1358 }
1359
1360 /* overwrite the lower extra_bits */
1361 *dst = (*dst & (0xff << extra_bits)) | (last_c >> (8 - extra_bits));
1362
1363 return rdbi->data_len;
1364}
Jacob Erlbeck14bb0942016-01-12 11:58:13 +01001365
Alexander Couzenscb846ec2016-05-30 19:10:48 +02001366/*!
1367 * \brief (GPRS) put llc pdu into an rlc/mac block. fragment the llc pdu if needed
1368 * \param rdbi rlc/mac block info
1369 * \param llc llc pdu
1370 * \param offset given offset within the rlc/mac block
1371 * \param num_chunks count the chunks (llc pdu data) within rlc/mac
1372 * \param data_block buffer holds rlc/mac data
1373 * \param is_final if this is the last rlc/mac within a TBF
Alexander Couzens6f0dc962016-05-30 19:30:21 +02001374 * \param count_payload if not NULL save the written size of payload in bytes into it
Alexander Couzenscb846ec2016-05-30 19:10:48 +02001375 * \return the state of the rlc/mac like if there is more space for another chunk
1376 */
Jacob Erlbeck5058bd62016-01-13 10:51:25 +01001377static Encoding::AppendResult rlc_data_to_dl_append_gprs(
Jacob Erlbeck14bb0942016-01-12 11:58:13 +01001378 struct gprs_rlc_data_block_info *rdbi,
1379 gprs_llc *llc, int *offset, int *num_chunks,
Alexander Couzens6f0dc962016-05-30 19:30:21 +02001380 uint8_t *data_block, bool is_final, int *count_payload)
Jacob Erlbeck14bb0942016-01-12 11:58:13 +01001381{
1382 int chunk;
1383 int space;
1384 struct rlc_li_field *li;
1385 uint8_t *delimiter, *data, *e_pointer;
1386
1387 data = data_block + *offset;
1388 delimiter = data_block + *num_chunks;
1389 e_pointer = (*num_chunks ? delimiter - 1 : NULL);
1390
1391 chunk = llc->chunk_size();
1392 space = rdbi->data_len - *offset;
1393
1394 /* if chunk will exceed block limit */
1395 if (chunk > space) {
1396 LOGP(DRLCMACDL, LOGL_DEBUG, "-- Chunk with length %d "
1397 "larger than space (%d) left in block: copy "
1398 "only remaining space, and we are done\n",
1399 chunk, space);
1400 /* block is filled, so there is no extension */
1401 if (e_pointer)
1402 *e_pointer |= 0x01;
1403 /* fill only space */
1404 llc->consume(data, space);
Alexander Couzens6f0dc962016-05-30 19:30:21 +02001405 if (count_payload)
1406 *count_payload = space;
Jacob Erlbeck14bb0942016-01-12 11:58:13 +01001407 /* return data block as message */
1408 *offset = rdbi->data_len;
1409 (*num_chunks)++;
Jacob Erlbeck5058bd62016-01-13 10:51:25 +01001410 return Encoding::AR_NEED_MORE_BLOCKS;
Jacob Erlbeck14bb0942016-01-12 11:58:13 +01001411 }
1412 /* if FINAL chunk would fit precisely in space left */
1413 if (chunk == space && is_final)
1414 {
1415 LOGP(DRLCMACDL, LOGL_DEBUG, "-- Chunk with length %d "
1416 "would exactly fit into space (%d): because "
1417 "this is a final block, we don't add length "
1418 "header, and we are done\n", chunk, space);
1419 /* block is filled, so there is no extension */
1420 if (e_pointer)
1421 *e_pointer |= 0x01;
1422 /* fill space */
1423 llc->consume(data, space);
Alexander Couzens6f0dc962016-05-30 19:30:21 +02001424 if (count_payload)
1425 *count_payload = space;
Jacob Erlbeck14bb0942016-01-12 11:58:13 +01001426 *offset = rdbi->data_len;
1427 (*num_chunks)++;
1428 rdbi->cv = 0;
Jacob Erlbeck5058bd62016-01-13 10:51:25 +01001429 return Encoding::AR_COMPLETED_BLOCK_FILLED;
Jacob Erlbeck14bb0942016-01-12 11:58:13 +01001430 }
1431 /* if chunk would fit exactly in space left */
1432 if (chunk == space) {
1433 LOGP(DRLCMACDL, LOGL_DEBUG, "-- Chunk with length %d "
1434 "would exactly fit into space (%d): add length "
1435 "header with LI=0, to make frame extend to "
1436 "next block, and we are done\n", chunk, space);
1437 /* make space for delimiter */
1438 if (delimiter != data)
1439 memmove(delimiter + 1, delimiter,
1440 data - delimiter);
1441 data++;
1442 (*offset)++;
1443 space--;
1444 /* add LI with 0 length */
1445 li = (struct rlc_li_field *)delimiter;
1446 li->e = 1; /* not more extension */
1447 li->m = 0; /* shall be set to 0, in case of li = 0 */
1448 li->li = 0; /* chunk fills the complete space */
1449 rdbi->e = 0; /* 0: extensions present */
1450 // no need to set e_pointer nor increase delimiter
1451 /* fill only space, which is 1 octet less than chunk */
1452 llc->consume(data, space);
Alexander Couzens6f0dc962016-05-30 19:30:21 +02001453 if (count_payload)
1454 *count_payload = space;
Jacob Erlbeck14bb0942016-01-12 11:58:13 +01001455 /* return data block as message */
1456 *offset = rdbi->data_len;
1457 (*num_chunks)++;
Jacob Erlbeck5058bd62016-01-13 10:51:25 +01001458 return Encoding::AR_NEED_MORE_BLOCKS;
Jacob Erlbeck14bb0942016-01-12 11:58:13 +01001459 }
1460
1461 LOGP(DRLCMACDL, LOGL_DEBUG, "-- Chunk with length %d is less "
1462 "than remaining space (%d): add length header to "
Pau Espin Pedrol49efd9b2020-11-13 13:46:27 +01001463 "delimit LLC frame\n", chunk, space);
Jacob Erlbeck14bb0942016-01-12 11:58:13 +01001464 /* the LLC frame chunk ends in this block */
1465 /* make space for delimiter */
1466 if (delimiter != data)
1467 memmove(delimiter + 1, delimiter, data - delimiter);
1468 data++;
1469 (*offset)++;
1470 space--;
1471 /* add LI to delimit frame */
1472 li = (struct rlc_li_field *)delimiter;
1473 li->e = 0; /* Extension bit, maybe set later */
1474 li->m = 0; /* will be set later, if there is more LLC data */
1475 li->li = chunk; /* length of chunk */
1476 rdbi->e = 0; /* 0: extensions present */
1477 (*num_chunks)++;
1478 /* copy (rest of) LLC frame to space and reset later */
1479 llc->consume(data, chunk);
Alexander Couzens6f0dc962016-05-30 19:30:21 +02001480 if (count_payload)
1481 *count_payload = chunk;
Jacob Erlbeck14bb0942016-01-12 11:58:13 +01001482 data += chunk;
1483 space -= chunk;
1484 (*offset) += chunk;
1485 /* if we have more data and we have space left */
1486 if (space > 0 && !is_final) {
1487 li->m = 1; /* we indicate more frames to follow */
Jacob Erlbeck5058bd62016-01-13 10:51:25 +01001488 return Encoding::AR_COMPLETED_SPACE_LEFT;
Jacob Erlbeck14bb0942016-01-12 11:58:13 +01001489 }
1490 /* if we don't have more LLC frames */
1491 if (is_final) {
1492 LOGP(DRLCMACDL, LOGL_DEBUG, "-- Final block, so we "
1493 "done.\n");
1494 li->e = 1; /* we cannot extend */
1495 rdbi->cv = 0;
Jacob Erlbeck5058bd62016-01-13 10:51:25 +01001496 return Encoding::AR_COMPLETED_BLOCK_FILLED;
Jacob Erlbeck14bb0942016-01-12 11:58:13 +01001497 }
1498 /* we have no space left */
1499 LOGP(DRLCMACDL, LOGL_DEBUG, "-- No space left, so we are "
1500 "done.\n");
1501 li->e = 1; /* we cannot extend */
Jacob Erlbeck5058bd62016-01-13 10:51:25 +01001502 return Encoding::AR_COMPLETED_BLOCK_FILLED;
1503}
1504
Alexander Couzenscb846ec2016-05-30 19:10:48 +02001505/*!
1506 * \brief (EGPRS) put llc pdu into an rlc/mac block. fragment the llc pdu if needed
1507 * \param rdbi rlc/mac block info
1508 * \param llc llc pdu
1509 * \param offset given offset within the rlc/mac block
1510 * \param num_chunks count the chunks (llc pdu data) within rlc/mac
1511 * \param data_block buffer holds rlc/mac data
1512 * \param is_final if this is the last rlc/mac within a TBF
Alexander Couzens6f0dc962016-05-30 19:30:21 +02001513 * \param count_payload if not NULL save the written size of payload in bytes into it
Alexander Couzenscb846ec2016-05-30 19:10:48 +02001514 * \return the state of the rlc/mac like if there is more space for another chunk
1515 */
Jacob Erlbecka88d0652016-01-13 11:28:10 +01001516static Encoding::AppendResult rlc_data_to_dl_append_egprs(
1517 struct gprs_rlc_data_block_info *rdbi,
1518 gprs_llc *llc, int *offset, int *num_chunks,
1519 uint8_t *data_block,
Alexander Couzens6f0dc962016-05-30 19:30:21 +02001520 bool is_final, int *count_payload)
Jacob Erlbecka88d0652016-01-13 11:28:10 +01001521{
1522 int chunk;
1523 int space;
1524 struct rlc_li_field_egprs *li;
1525 struct rlc_li_field_egprs *prev_li;
1526 uint8_t *delimiter, *data;
1527
1528 data = data_block + *offset;
1529 delimiter = data_block + *num_chunks;
1530 prev_li = (struct rlc_li_field_egprs *)
1531 (*num_chunks ? delimiter - 1 : NULL);
1532
1533 chunk = llc->chunk_size();
1534 space = rdbi->data_len - *offset;
1535
1536 /* if chunk will exceed block limit */
1537 if (chunk > space) {
1538 LOGP(DRLCMACDL, LOGL_DEBUG, "-- Chunk with length %d "
1539 "larger than space (%d) left in block: copy "
1540 "only remaining space, and we are done\n",
1541 chunk, space);
1542 /* fill only space */
1543 llc->consume(data, space);
Alexander Couzens6f0dc962016-05-30 19:30:21 +02001544 if (count_payload)
1545 *count_payload = space;
Jacob Erlbecka88d0652016-01-13 11:28:10 +01001546 /* return data block as message */
1547 *offset = rdbi->data_len;
1548 (*num_chunks)++;
1549 return Encoding::AR_NEED_MORE_BLOCKS;
1550 }
1551 /* if FINAL chunk would fit precisely in space left */
1552 if (chunk == space && is_final)
1553 {
1554 LOGP(DRLCMACDL, LOGL_DEBUG, "-- Chunk with length %d "
1555 "would exactly fit into space (%d): because "
1556 "this is a final block, we don't add length "
1557 "header, and we are done\n", chunk, space);
1558 /* fill space */
1559 llc->consume(data, space);
Alexander Couzens6f0dc962016-05-30 19:30:21 +02001560 if (count_payload)
1561 *count_payload = space;
Jacob Erlbecka88d0652016-01-13 11:28:10 +01001562 *offset = rdbi->data_len;
1563 (*num_chunks)++;
1564 rdbi->cv = 0;
1565 return Encoding::AR_COMPLETED_BLOCK_FILLED;
1566 }
1567 /* if chunk would fit exactly in space left */
1568 if (chunk == space) {
1569 LOGP(DRLCMACDL, LOGL_DEBUG, "-- Chunk with length %d "
1570 "would exactly fit into space (%d): just copy "
1571 "it, and we are done. The next block will have "
1572 "to start with an empty chunk\n",
1573 chunk, space);
1574 /* fill space */
1575 llc->consume(data, space);
Alexander Couzens6f0dc962016-05-30 19:30:21 +02001576 if (count_payload)
1577 *count_payload = space;
Jacob Erlbecka88d0652016-01-13 11:28:10 +01001578 *offset = rdbi->data_len;
1579 (*num_chunks)++;
1580 return Encoding::AR_NEED_MORE_BLOCKS;
1581 }
1582
1583 LOGP(DRLCMACDL, LOGL_DEBUG, "-- Chunk with length %d is less "
1584 "than remaining space (%d): add length header to "
1585 "to delimit LLC frame\n", chunk, space);
1586 /* the LLC frame chunk ends in this block */
1587 /* make space for delimiter */
1588
1589 if (delimiter != data)
1590 memmove(delimiter + 1, delimiter, data - delimiter);
1591
1592 data += 1;
1593 (*offset) += 1;
1594 space -= 1;
1595 /* add LI to delimit frame */
1596 li = (struct rlc_li_field_egprs *)delimiter;
1597 li->e = 1; /* Extension bit, maybe set later */
1598 li->li = chunk; /* length of chunk */
1599 /* tell previous extension header about the new one */
1600 if (prev_li)
1601 prev_li->e = 0;
1602 rdbi->e = 0; /* 0: extensions present */
1603 delimiter++;
1604 prev_li = li;
1605 (*num_chunks)++;
1606 /* copy (rest of) LLC frame to space and reset later */
1607 llc->consume(data, chunk);
Alexander Couzens6f0dc962016-05-30 19:30:21 +02001608 if (count_payload)
1609 *count_payload = chunk;
Jacob Erlbecka88d0652016-01-13 11:28:10 +01001610 data += chunk;
1611 space -= chunk;
1612 (*offset) += chunk;
1613 /* if we have more data and we have space left */
1614 if (space > 0) {
1615 if (!is_final)
1616 return Encoding::AR_COMPLETED_SPACE_LEFT;
1617
1618 /* we don't have more LLC frames */
1619 /* We will have to add another chunk with filling octets */
1620 LOGP(DRLCMACDL, LOGL_DEBUG,
1621 "-- There is remaining space (%d): add filling byte chunk\n",
1622 space);
1623
1624 if (delimiter != data)
1625 memmove(delimiter + 1, delimiter, data - delimiter);
1626
1627 data += 1;
1628 (*offset) += 1;
1629 space -= 1;
1630
1631 /* set filling bytes extension */
1632 li = (struct rlc_li_field_egprs *)delimiter;
1633 li->e = 1;
1634 li->li = 127;
1635
1636 /* tell previous extension header about the new one */
1637 if (prev_li)
1638 prev_li->e = 0;
1639
1640 delimiter++;
1641 (*num_chunks)++;
1642
1643 rdbi->cv = 0;
1644
1645 LOGP(DRLCMACDL, LOGL_DEBUG, "-- Final block, so we "
1646 "are done.\n");
1647
1648 *offset = rdbi->data_len;
1649 return Encoding::AR_COMPLETED_BLOCK_FILLED;
1650 }
1651
1652 if (is_final) {
1653 /* we don't have more LLC frames */
1654 LOGP(DRLCMACDL, LOGL_DEBUG, "-- Final block, so we "
1655 "are done.\n");
1656 rdbi->cv = 0;
1657 return Encoding::AR_COMPLETED_BLOCK_FILLED;
1658 }
1659
1660 /* we have no space left */
1661 LOGP(DRLCMACDL, LOGL_DEBUG, "-- No space left, so we are "
1662 "done.\n");
1663 return Encoding::AR_COMPLETED_BLOCK_FILLED;
1664}
1665
Alexander Couzenscb846ec2016-05-30 19:10:48 +02001666/*!
1667 * \brief Encoding::rlc_data_to_dl_append
1668 * \param rdbi rlc/mac block info
1669 * \param cs the coding scheme to use
1670 * \param llc llc pdu
1671 * \param offset given offset within the rlc/mac block
1672 * \param num_chunks count the chunks (llc pdu data) within rlc/mac
1673 * \param data_block buffer holds rlc/mac data
1674 * \param is_final if this is the last rlc/mac within a TBF
Alexander Couzens6f0dc962016-05-30 19:30:21 +02001675 * \param count_payload if not NULL save the written size of payload in bytes into it
Alexander Couzenscb846ec2016-05-30 19:10:48 +02001676 * \return the state of the rlc/mac like if there is more space for another chunk
1677 */
Jacob Erlbeck5058bd62016-01-13 10:51:25 +01001678Encoding::AppendResult Encoding::rlc_data_to_dl_append(
Pau Espin Pedrol2ae83372020-05-18 11:35:35 +02001679 struct gprs_rlc_data_block_info *rdbi, enum CodingScheme cs,
Jacob Erlbeck5058bd62016-01-13 10:51:25 +01001680 gprs_llc *llc, int *offset, int *num_chunks,
Alexander Couzens6f0dc962016-05-30 19:30:21 +02001681 uint8_t *data_block, bool is_final, int *count_payload)
Jacob Erlbeck5058bd62016-01-13 10:51:25 +01001682{
Max8a8e0fb2019-03-25 16:32:50 +01001683 if (mcs_is_gprs(cs))
Jacob Erlbeck5058bd62016-01-13 10:51:25 +01001684 return rlc_data_to_dl_append_gprs(rdbi,
Alexander Couzens6f0dc962016-05-30 19:30:21 +02001685 llc, offset, num_chunks, data_block, is_final,
1686 count_payload);
Jacob Erlbeck5058bd62016-01-13 10:51:25 +01001687
Max8a8e0fb2019-03-25 16:32:50 +01001688 if (mcs_is_edge(cs))
Jacob Erlbecka88d0652016-01-13 11:28:10 +01001689 return rlc_data_to_dl_append_egprs(rdbi,
Alexander Couzens6f0dc962016-05-30 19:30:21 +02001690 llc, offset, num_chunks, data_block, is_final,
1691 count_payload);
Jacob Erlbecka88d0652016-01-13 11:28:10 +01001692
Jacob Erlbeck5058bd62016-01-13 10:51:25 +01001693 LOGP(DRLCMACDL, LOGL_ERROR, "%s data block encoding not implemented\n",
Max136ebcc2019-03-05 14:59:03 +01001694 mcs_name(cs));
Pau Espin Pedrolf1159c52020-11-04 17:53:07 +01001695 OSMO_ASSERT(mcs_is_valid(cs));
Jacob Erlbeck5058bd62016-01-13 10:51:25 +01001696
1697 return AR_NEED_MORE_BLOCKS;
Jacob Erlbeck14bb0942016-01-12 11:58:13 +01001698}
aravind sirsikared3413e2016-11-11 17:15:10 +05301699
1700/*
1701 * Refer 44.060 version 7.27.0 Release 7
1702 * section 7.1.3.2.1 On receipt of a PACKET RESOURCE REQUEST message
1703 * 8.1.2.5 Establishment of uplink TBF
1704 */
1705void Encoding::write_packet_access_reject(
1706 bitvec * dest, uint32_t tlli)
1707{
1708 unsigned wp = 0;
1709
Alexander Couzensccde5c92017-02-04 03:10:08 +01001710 bitvec_write_field(dest, &wp, 0x1, 2); // Payload Type
1711 bitvec_write_field(dest, &wp, 0x0, 2); // Uplink block with TDMA FN
1712 bitvec_write_field(dest, &wp, 0, 1); // No Polling Bit
1713 bitvec_write_field(dest, &wp, 0x0, 3); // Uplink state flag
1714 bitvec_write_field(dest, &wp,
aravind sirsikared3413e2016-11-11 17:15:10 +05301715 MT_PACKET_ACCESS_REJECT, 6); // MESSAGE TYPE
Alexander Couzensccde5c92017-02-04 03:10:08 +01001716 bitvec_write_field(dest, &wp, 0, 2); // fixed 00
1717 bitvec_write_field(dest, &wp, 0x0, 1); // TLLI / G-RNTI : bit (32)
1718 bitvec_write_field(dest, &wp, tlli, 32); // CONTENTION_RESOLUTION_TLLI
1719 bitvec_write_field(dest, &wp, 1, 1); // WAIT_INDICATION size in seconds
aravind sirsikared3413e2016-11-11 17:15:10 +05301720 /* TODO: make it configurable */
Alexander Couzensccde5c92017-02-04 03:10:08 +01001721 bitvec_write_field(dest, &wp, 5, 8); // WAIT_INDICATION value
1722 bitvec_write_field(dest, &wp, 0, 1); // WAIT_INDICATION size in seconds
aravind sirsikared3413e2016-11-11 17:15:10 +05301723}