blob: e3e1245eba4bb51956b76ccd1b6916c7eb07e689 [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>
26#include <gprs_debug.h>
27
Jacob Erlbeckf0e40392016-01-08 10:07:53 +010028#include <errno.h>
29#include <string.h>
30
Jacob Erlbeck2647a332016-02-01 16:13:38 +010031static int write_ia_rest_downlink(
32 gprs_rlcmac_dl_tbf *tbf,
Jacob Erlbeck18831c32016-02-01 15:23:35 +010033 bitvec * dest, unsigned& wp,
Jacob Erlbeck2647a332016-02-01 16:13:38 +010034 uint8_t polling, uint32_t fn,
35 uint8_t alpha, uint8_t gamma, int8_t ta_idx)
Jacob Erlbeck18831c32016-02-01 15:23:35 +010036{
Jacob Erlbeck2647a332016-02-01 16:13:38 +010037 if (!tbf) {
38 LOGP(DRLCMACDL, LOGL_ERROR,
39 "Cannot encode DL IMMEDIATE ASSIGNMENT without TBF\n");
40 return -EINVAL;
41 }
Jacob Erlbeck18831c32016-02-01 15:23:35 +010042 // GSM 04.08 10.5.2.16 IA Rest Octets
43 bitvec_write_field_lh(dest, wp, 3, 2); // "HH"
44 bitvec_write_field(dest, wp, 1, 2); // "01" Packet Downlink Assignment
Jacob Erlbeck2647a332016-02-01 16:13:38 +010045 bitvec_write_field(dest, wp,tbf->tlli(),32); // TLLI
Jacob Erlbeck18831c32016-02-01 15:23:35 +010046 bitvec_write_field(dest, wp,0x1,1); // switch TFI : on
Jacob Erlbeck2647a332016-02-01 16:13:38 +010047 bitvec_write_field(dest, wp,tbf->tfi(),5); // TFI
Jacob Erlbeck18831c32016-02-01 15:23:35 +010048 bitvec_write_field(dest, wp,0x0,1); // RLC acknowledged mode
49 if (alpha) {
50 bitvec_write_field(dest, wp,0x1,1); // ALPHA = present
51 bitvec_write_field(dest, wp,alpha,4); // ALPHA
52 } else {
53 bitvec_write_field(dest, wp,0x0,1); // ALPHA = not present
54 }
55 bitvec_write_field(dest, wp,gamma,5); // GAMMA power control parameter
56 bitvec_write_field(dest, wp,polling,1); // Polling Bit
57 bitvec_write_field(dest, wp,!polling,1); // TA_VALID ???
58 if (ta_idx < 0) {
59 bitvec_write_field(dest, wp,0x0,1); // switch TIMING_ADVANCE_INDEX = off
60 } else {
61 bitvec_write_field(dest, wp,0x1,1); // switch TIMING_ADVANCE_INDEX = on
62 bitvec_write_field(dest, wp,ta_idx,4); // TIMING_ADVANCE_INDEX
63 }
64 if (polling) {
65 bitvec_write_field(dest, wp,0x1,1); // TBF Starting TIME present
66 bitvec_write_field(dest, wp,(fn / (26 * 51)) % 32,5); // T1'
67 bitvec_write_field(dest, wp,fn % 51,6); // T3
68 bitvec_write_field(dest, wp,fn % 26,5); // T2
69 } else {
70 bitvec_write_field(dest, wp,0x0,1); // TBF Starting TIME present
71 }
72 bitvec_write_field(dest, wp,0x0,1); // P0 not present
73 // bitvec_write_field(dest, wp,0x1,1); // P0 not present
74 // bitvec_write_field(dest, wp,0xb,4);
Jacob Erlbeckbe80c362016-02-01 16:39:52 +010075 if (tbf->is_egprs_enabled()) {
76 /* see GMS 44.018, 10.5.2.16 */
77 unsigned int ws_enc = (tbf->m_window.ws() - 64) / 32;
78 bitvec_write_field_lh(dest, wp, 1, 1); // "H"
79 bitvec_write_field(dest, wp, ws_enc,5); // EGPRS Window Size
80 bitvec_write_field(dest, wp, 0x0,2); // LINK_QUALITY_MEASUREMENT_MODE
81 bitvec_write_field(dest, wp, 0,1); // BEP_PERIOD2 not present
82 }
Jacob Erlbeck2647a332016-02-01 16:13:38 +010083
84 return 0;
Jacob Erlbeck18831c32016-02-01 15:23:35 +010085}
86
Jacob Erlbeck2647a332016-02-01 16:13:38 +010087static int write_ia_rest_uplink(
88 gprs_rlcmac_ul_tbf *tbf,
89 bitvec * dest, unsigned& wp,
90 uint8_t usf, uint32_t fn,
Jacob Erlbeck18831c32016-02-01 15:23:35 +010091 uint8_t alpha, uint8_t gamma, int8_t ta_idx)
92{
Jacob Erlbeckbe80c362016-02-01 16:39:52 +010093 OSMO_ASSERT(!tbf || !tbf->is_egprs_enabled());
94
Jacob Erlbeck18831c32016-02-01 15:23:35 +010095 // GMS 04.08 10.5.2.37b 10.5.2.16
96 bitvec_write_field_lh(dest, wp, 3, 2); // "HH"
97 bitvec_write_field(dest, wp, 0, 2); // "0" Packet Uplink Assignment
Jacob Erlbeck2647a332016-02-01 16:13:38 +010098 if (tbf == NULL) {
Jacob Erlbeck18831c32016-02-01 15:23:35 +010099 bitvec_write_field(dest, wp, 0, 1); // Block Allocation : Single Block Allocation
100 if (alpha) {
101 bitvec_write_field(dest, wp,0x1,1); // ALPHA = present
102 bitvec_write_field(dest, wp,alpha,4); // ALPHA = present
103 } else
104 bitvec_write_field(dest, wp,0x0,1); // ALPHA = not present
105 bitvec_write_field(dest, wp,gamma,5); // GAMMA power control parameter
106 if (ta_idx < 0) {
107 bitvec_write_field(dest, wp,0x0,1); // switch TIMING_ADVANCE_INDEX = off
108 } else {
109 bitvec_write_field(dest, wp,0x1,1); // switch TIMING_ADVANCE_INDEX = on
110 bitvec_write_field(dest, wp,ta_idx,4); // TIMING_ADVANCE_INDEX
111 }
112 bitvec_write_field(dest, wp, 1, 1); // TBF_STARTING_TIME_FLAG
113 bitvec_write_field(dest, wp,(fn / (26 * 51)) % 32,5); // T1'
114 bitvec_write_field(dest, wp,fn % 51,6); // T3
115 bitvec_write_field(dest, wp,fn % 26,5); // T2
116 } else {
117 bitvec_write_field(dest, wp, 1, 1); // Block Allocation : Not Single Block Allocation
Jacob Erlbeck2647a332016-02-01 16:13:38 +0100118 bitvec_write_field(dest, wp, tbf->tfi(), 5); // TFI_ASSIGNMENT Temporary Flow Identity
Jacob Erlbeck18831c32016-02-01 15:23:35 +0100119 bitvec_write_field(dest, wp, 0, 1); // POLLING
120 bitvec_write_field(dest, wp, 0, 1); // ALLOCATION_TYPE: dynamic
121 bitvec_write_field(dest, wp, usf, 3); // USF
122 bitvec_write_field(dest, wp, 0, 1); // USF_GRANULARITY
123 bitvec_write_field(dest, wp, 0, 1); // "0" power control: Not Present
Jacob Erlbeck2647a332016-02-01 16:13:38 +0100124 bitvec_write_field(dest, wp, tbf->current_cs().to_num()-1, 2); // CHANNEL_CODING_COMMAND
Jacob Erlbeck18831c32016-02-01 15:23:35 +0100125 bitvec_write_field(dest, wp, 1, 1); // TLLI_BLOCK_CHANNEL_CODING
126 if (alpha) {
127 bitvec_write_field(dest, wp,0x1,1); // ALPHA = present
128 bitvec_write_field(dest, wp,alpha,4); // ALPHA
129 } else
130 bitvec_write_field(dest, wp,0x0,1); // ALPHA = not present
131 bitvec_write_field(dest, wp,gamma,5); // GAMMA power control parameter
132 /* note: there is no choise for TAI and no starting time */
133 bitvec_write_field(dest, wp, 0, 1); // switch TIMING_ADVANCE_INDEX = off
134 bitvec_write_field(dest, wp, 0, 1); // TBF_STARTING_TIME_FLAG
135 }
Jacob Erlbeck2647a332016-02-01 16:13:38 +0100136 return 0;
Jacob Erlbeck18831c32016-02-01 15:23:35 +0100137}
138
Jacob Erlbeckbe80c362016-02-01 16:39:52 +0100139static int write_ia_rest_egprs_uplink(
140 gprs_rlcmac_ul_tbf *tbf,
141 bitvec * dest, unsigned& wp,
142 uint8_t usf, uint32_t fn,
143 uint8_t alpha, uint8_t gamma, int8_t ta_idx)
144{
145 LOGP(DRLCMACUL, LOGL_ERROR,
146 "EGPRS Packet Uplink Assignment is not yet implemented\n");
147 return -EINVAL;
148}
149
Jacob Erlbeck18831c32016-02-01 15:23:35 +0100150/*
151 * Immediate assignment, sent on the CCCH/AGCH
152 * see GSM 04.08, 9.1.18 and GSM 44.018, 9.1.18 + 10.5.2.16
153 */
Holger Hans Peter Freyther63f29d62013-10-19 19:04:03 +0200154int Encoding::write_immediate_assignment(
Jacob Erlbeck2647a332016-02-01 16:13:38 +0100155 struct gprs_rlcmac_tbf *tbf,
Holger Hans Peter Freyther6ca0a902013-10-19 18:50:22 +0200156 bitvec * dest, uint8_t downlink, uint8_t ra,
157 uint32_t ref_fn, uint8_t ta, uint16_t arfcn, uint8_t ts, uint8_t tsc,
Jacob Erlbeck2647a332016-02-01 16:13:38 +0100158 uint8_t usf, uint8_t polling, uint32_t fn, uint8_t alpha,
Holger Hans Peter Freyther6ca0a902013-10-19 18:50:22 +0200159 uint8_t gamma, int8_t ta_idx)
160{
161 unsigned wp = 0;
Jacob Erlbeck2647a332016-02-01 16:13:38 +0100162 int plen;
163 int rc;
Holger Hans Peter Freyther6ca0a902013-10-19 18:50:22 +0200164
165 bitvec_write_field(dest, wp,0x0,4); // Skip Indicator
166 bitvec_write_field(dest, wp,0x6,4); // Protocol Discriminator
167 bitvec_write_field(dest, wp,0x3F,8); // Immediate Assignment Message Type
168
169 // 10.5.2.25b Dedicated mode or TBF
170 bitvec_write_field(dest, wp,0x0,1); // spare
171 bitvec_write_field(dest, wp,0x0,1); // TMA : Two-message assignment: No meaning
172 bitvec_write_field(dest, wp,downlink,1); // Downlink : Downlink assignment to mobile in packet idle mode
173 bitvec_write_field(dest, wp,0x1,1); // T/D : TBF or dedicated mode: this message assigns a Temporary Block Flow (TBF).
174
175 bitvec_write_field(dest, wp,0x0,4); // Page Mode
176
177 // GSM 04.08 10.5.2.25a Packet Channel Description
178 bitvec_write_field(dest, wp,0x1,5); // Channel type
179 bitvec_write_field(dest, wp,ts,3); // TN
180 bitvec_write_field(dest, wp,tsc,3); // TSC
181 bitvec_write_field(dest, wp,0x0,3); // non-hopping RF channel configuraion
182 bitvec_write_field(dest, wp,arfcn,10); // ARFCN
183
184 //10.5.2.30 Request Reference
185 bitvec_write_field(dest, wp,ra,8); // RA
186 bitvec_write_field(dest, wp,(ref_fn / (26 * 51)) % 32,5); // T1'
187 bitvec_write_field(dest, wp,ref_fn % 51,6); // T3
188 bitvec_write_field(dest, wp,ref_fn % 26,5); // T2
189
190 // 10.5.2.40 Timing Advance
191 bitvec_write_field(dest, wp,0x0,2); // spare
192 bitvec_write_field(dest, wp,ta,6); // Timing Advance value
193
194 // No mobile allocation in non-hopping systems.
195 // A zero-length LV. Just write L=0.
196 bitvec_write_field(dest, wp,0,8);
197
198 if ((wp % 8)) {
199 LOGP(DRLCMACUL, LOGL_ERROR, "Length of IMM.ASS without rest "
200 "octets is not multiple of 8 bits, PLEASE FIX!\n");
201 exit (0);
202 }
203 plen = wp / 8;
204
205 if (downlink)
Jacob Erlbeck2647a332016-02-01 16:13:38 +0100206 rc = write_ia_rest_downlink(as_dl_tbf(tbf), dest, wp,
207 polling, fn,
Jacob Erlbeck18831c32016-02-01 15:23:35 +0100208 alpha, gamma, ta_idx);
Jacob Erlbeckbe80c362016-02-01 16:39:52 +0100209 else if (as_ul_tbf(tbf) && as_ul_tbf(tbf)->is_egprs_enabled())
210 rc = write_ia_rest_egprs_uplink(as_ul_tbf(tbf), dest, wp,
211 usf, fn,
212 alpha, gamma, ta_idx);
Holger Hans Peter Freyther6ca0a902013-10-19 18:50:22 +0200213 else
Jacob Erlbeck2647a332016-02-01 16:13:38 +0100214 rc = write_ia_rest_uplink(as_ul_tbf(tbf), dest, wp,
215 usf, fn,
Jacob Erlbeck18831c32016-02-01 15:23:35 +0100216 alpha, gamma, ta_idx);
Holger Hans Peter Freyther6ca0a902013-10-19 18:50:22 +0200217
Jacob Erlbeck2647a332016-02-01 16:13:38 +0100218 if (rc < 0) {
219 LOGP(DRLCMAC, LOGL_ERROR,
220 "Failed to create IMMEDIATE ASSIGMENT (%s) for %s\n",
221 downlink ? "downlink" : "uplink",
222 tbf ? tbf->name() : "single block allocation");
223 return rc;
224 }
225
Holger Hans Peter Freyther6ca0a902013-10-19 18:50:22 +0200226 return plen;
227}
228
229/* generate uplink assignment */
Holger Hans Peter Freyther63f29d62013-10-19 19:04:03 +0200230void Encoding::write_packet_uplink_assignment(
Holger Hans Peter Freyther6ca0a902013-10-19 18:50:22 +0200231 struct gprs_rlcmac_bts *bts,
232 bitvec * dest, uint8_t old_tfi,
233 uint8_t old_downlink, uint32_t tlli, uint8_t use_tlli,
Jacob Erlbeckf2694b72016-01-26 21:46:26 +0100234 struct gprs_rlcmac_ul_tbf *tbf, uint8_t poll, uint8_t rrbp, uint8_t alpha,
Jacob Erlbeck76d767c2015-09-28 18:54:32 +0200235 uint8_t gamma, int8_t ta_idx, int8_t use_egprs)
Holger Hans Peter Freyther6ca0a902013-10-19 18:50:22 +0200236{
237 // TODO We should use our implementation of encode RLC/MAC Control messages.
238 unsigned wp = 0;
239 uint8_t ts;
240
241 bitvec_write_field(dest, wp,0x1,2); // Payload Type
242 bitvec_write_field(dest, wp,0x0,2); // Uplink block with TDMA framenumber (N+13)
243 bitvec_write_field(dest, wp,poll,1); // Suppl/Polling Bit
244 bitvec_write_field(dest, wp,0x0,3); // Uplink state flag
245 bitvec_write_field(dest, wp,0xa,6); // MESSAGE TYPE
246
247 bitvec_write_field(dest, wp,0x0,2); // Page Mode
248
249 bitvec_write_field(dest, wp,0x0,1); // switch PERSIST_LEVEL: off
250 if (use_tlli) {
251 bitvec_write_field(dest, wp,0x2,2); // switch TLLI : on
252 bitvec_write_field(dest, wp,tlli,32); // TLLI
253 } else {
254 bitvec_write_field(dest, wp,0x0,1); // switch TFI : on
255 bitvec_write_field(dest, wp,old_downlink,1); // 0=UPLINK TFI, 1=DL TFI
256 bitvec_write_field(dest, wp,old_tfi,5); // TFI
257 }
258
Jacob Erlbeck76d767c2015-09-28 18:54:32 +0200259 if (!use_egprs) {
260 bitvec_write_field(dest, wp,0x0,1); // Message escape
Jacob Erlbeckcb728902016-01-05 15:33:03 +0100261 bitvec_write_field(dest, wp,tbf->current_cs().to_num()-1, 2); // CHANNEL_CODING_COMMAND
Jacob Erlbeck76d767c2015-09-28 18:54:32 +0200262 bitvec_write_field(dest, wp,0x1,1); // TLLI_BLOCK_CHANNEL_CODING
263 bitvec_write_field(dest, wp,0x1,1); // switch TIMING_ADVANCE_VALUE = on
264 bitvec_write_field(dest, wp,tbf->ta(),6); // TIMING_ADVANCE_VALUE
265 if (ta_idx < 0) {
266 bitvec_write_field(dest, wp,0x0,1); // switch TIMING_ADVANCE_INDEX = off
267 } else {
268 bitvec_write_field(dest, wp,0x1,1); // switch TIMING_ADVANCE_INDEX = on
269 bitvec_write_field(dest, wp,ta_idx,4); // TIMING_ADVANCE_INDEX
270 }
271
272 } else { /* EPGRS */
Jacob Erlbeck36df7742016-01-19 15:53:30 +0100273 unsigned int ws_enc = (tbf->m_window.ws() - 64) / 32;
Jacob Erlbeck76d767c2015-09-28 18:54:32 +0200274 bitvec_write_field(dest, wp,0x1,1); // Message escape
275 bitvec_write_field(dest, wp,0x0,2); // EGPRS message contents
276 bitvec_write_field(dest, wp,0x0,1); // No CONTENTION_RESOLUTION_TLLI
277 bitvec_write_field(dest, wp,0x0,1); // No COMPACT reduced MA
Jacob Erlbeckcb728902016-01-05 15:33:03 +0100278 bitvec_write_field(dest, wp,tbf->current_cs().to_num()-1, 4); // EGPRS Modulation and Coding IE
Jacob Erlbeck76d767c2015-09-28 18:54:32 +0200279 bitvec_write_field(dest, wp,0x0,1); // No RESEGMENT
Jacob Erlbeck36df7742016-01-19 15:53:30 +0100280 bitvec_write_field(dest, wp,ws_enc,5); // EGPRS Window Size
Jacob Erlbeck76d767c2015-09-28 18:54:32 +0200281 bitvec_write_field(dest, wp,0x0,1); // No Access Technologies Request
282 bitvec_write_field(dest, wp,0x0,1); // No ARAC RETRANSMISSION REQUEST
283 bitvec_write_field(dest, wp,0x1,1); // TLLI_BLOCK_CHANNEL_CODING
284 bitvec_write_field(dest, wp,0x0,1); // No BEP_PERIOD2
285
286 bitvec_write_field(dest, wp,0x1,1); // switch TIMING_ADVANCE_VALUE = on
287 bitvec_write_field(dest, wp,tbf->ta(),6); // TIMING_ADVANCE_VALUE
288 if (ta_idx < 0) {
289 bitvec_write_field(dest, wp,0x0,1); // switch TIMING_ADVANCE_INDEX = off
290 } else {
291 bitvec_write_field(dest, wp,0x1,1); // switch TIMING_ADVANCE_INDEX = on
292 bitvec_write_field(dest, wp,ta_idx,4); // TIMING_ADVANCE_INDEX
293 }
294
295 bitvec_write_field(dest, wp,0x0,1); // No Packet Extended Timing Advance
Holger Hans Peter Freyther6ca0a902013-10-19 18:50:22 +0200296 }
297
298#if 1
299 bitvec_write_field(dest, wp,0x1,1); // Frequency Parameters information elements = present
Holger Hans Peter Freyther8f399de2013-12-25 20:22:35 +0100300 bitvec_write_field(dest, wp,tbf->tsc(),3); // Training Sequence Code (TSC)
Holger Hans Peter Freyther6ca0a902013-10-19 18:50:22 +0200301 bitvec_write_field(dest, wp,0x0,2); // ARFCN = present
Holger Hans Peter Freytherfc498c92013-10-27 13:38:54 +0100302 bitvec_write_field(dest, wp,tbf->trx->arfcn,10); // ARFCN
Holger Hans Peter Freyther6ca0a902013-10-19 18:50:22 +0200303#else
304 bitvec_write_field(dest, wp,0x0,1); // Frequency Parameters = off
305#endif
306
307 bitvec_write_field(dest, wp,0x1,2); // Dynamic Allocation
Jacob Erlbeckedfd7e32015-11-17 16:30:58 +0100308
Holger Hans Peter Freyther6ca0a902013-10-19 18:50:22 +0200309 bitvec_write_field(dest, wp,0x0,1); // Extended Dynamic Allocation = off
310 bitvec_write_field(dest, wp,0x0,1); // P0 = off
Jacob Erlbeckedfd7e32015-11-17 16:30:58 +0100311
Holger Hans Peter Freyther6ca0a902013-10-19 18:50:22 +0200312 bitvec_write_field(dest, wp,0x0,1); // USF_GRANULARITY
313 bitvec_write_field(dest, wp,0x1,1); // switch TFI : on
Holger Hans Peter Freyther34f6e5e2013-10-27 20:31:47 +0100314 bitvec_write_field(dest, wp,tbf->tfi(),5);// TFI
Holger Hans Peter Freyther6ca0a902013-10-19 18:50:22 +0200315
316 bitvec_write_field(dest, wp,0x0,1); //
317 bitvec_write_field(dest, wp,0x0,1); // TBF Starting Time = off
318 if (alpha || gamma) {
319 bitvec_write_field(dest, wp,0x1,1); // Timeslot Allocation with Power Control
320 bitvec_write_field(dest, wp,alpha,4); // ALPHA
321 } else
322 bitvec_write_field(dest, wp,0x0,1); // Timeslot Allocation
Jacob Erlbeckedfd7e32015-11-17 16:30:58 +0100323
Holger Hans Peter Freyther6ca0a902013-10-19 18:50:22 +0200324 for (ts = 0; ts < 8; ts++) {
325 if (tbf->pdch[ts]) {
326 bitvec_write_field(dest, wp,0x1,1); // USF_TN(i): on
Daniel Willmann7e994e32014-08-07 15:49:21 +0200327 bitvec_write_field(dest, wp,tbf->m_usf[ts],3); // USF_TN(i)
Holger Hans Peter Freyther6ca0a902013-10-19 18:50:22 +0200328 if (alpha || gamma)
329 bitvec_write_field(dest, wp,gamma,5); // GAMMA power control parameter
330 } else
331 bitvec_write_field(dest, wp,0x0,1); // USF_TN(i): off
332 }
Jacob Erlbeckedfd7e32015-11-17 16:30:58 +0100333 // bitvec_write_field(dest, wp,0x0,1); // Measurement Mapping struct not present
Holger Hans Peter Freyther6ca0a902013-10-19 18:50:22 +0200334}
335
336
337/* generate downlink assignment */
Jacob Erlbeck166c9fc2016-01-07 16:04:29 +0100338void Encoding::write_packet_downlink_assignment(RlcMacDownlink_t * block,
Jacob Erlbeck6b356a52016-01-29 16:39:21 +0100339 bool old_tfi_is_valid, uint8_t old_tfi, uint8_t old_downlink,
340 struct gprs_rlcmac_tbf *tbf, uint8_t poll, uint8_t rrbp,
341 uint8_t alpha, uint8_t gamma, int8_t ta_idx,
Jacob Erlbeckf2694b72016-01-26 21:46:26 +0100342 uint8_t ta_ts, bool use_egprs)
Holger Hans Peter Freyther6ca0a902013-10-19 18:50:22 +0200343{
344 // Packet downlink assignment TS 44.060 11.2.7
345
Jacob Erlbeck166c9fc2016-01-07 16:04:29 +0100346 PDA_AdditionsR99_t *pda_r99;
347
Holger Hans Peter Freyther6ca0a902013-10-19 18:50:22 +0200348 uint8_t tn;
Jacob Erlbeck36df7742016-01-19 15:53:30 +0100349 unsigned int ws_enc;
Holger Hans Peter Freyther6ca0a902013-10-19 18:50:22 +0200350
351 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 +0100352 block->RRBP = rrbp; // 0: N+13
Holger Hans Peter Freyther6ca0a902013-10-19 18:50:22 +0200353 block->SP = poll; // RRBP field is valid
354 block->USF = 0x0; // Uplink state flag
355
356 block->u.Packet_Downlink_Assignment.MESSAGE_TYPE = 0x2; // Packet Downlink Assignment
357 block->u.Packet_Downlink_Assignment.PAGE_MODE = 0x0; // Normal Paging
358
359 block->u.Packet_Downlink_Assignment.Exist_PERSISTENCE_LEVEL = 0x0; // PERSISTENCE_LEVEL: off
360
Jacob Erlbeck6b356a52016-01-29 16:39:21 +0100361 if (old_tfi_is_valid) {
362 block->u.Packet_Downlink_Assignment.ID.UnionType = 0x0; // TFI = on
363 block->u.Packet_Downlink_Assignment.ID.u.Global_TFI.UnionType = old_downlink; // 0=UPLINK TFI, 1=DL TFI
364 block->u.Packet_Downlink_Assignment.ID.u.Global_TFI.u.UPLINK_TFI = old_tfi; // TFI
365 } else {
366 block->u.Packet_Downlink_Assignment.ID.UnionType = 0x1; // TLLI
367 block->u.Packet_Downlink_Assignment.ID.u.TLLI = tbf->tlli();
368 }
Holger Hans Peter Freyther6ca0a902013-10-19 18:50:22 +0200369
370 block->u.Packet_Downlink_Assignment.MAC_MODE = 0x0; // Dynamic Allocation
371 block->u.Packet_Downlink_Assignment.RLC_MODE = 0x0; // RLC acknowledged mode
Daniel Willmann73191a42014-05-30 17:58:00 +0200372 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 +0200373 block->u.Packet_Downlink_Assignment.TIMESLOT_ALLOCATION = 0; // timeslot(s)
374 for (tn = 0; tn < 8; tn++) {
375 if (tbf->pdch[tn])
376 block->u.Packet_Downlink_Assignment.TIMESLOT_ALLOCATION |= 0x80 >> tn; // timeslot(s)
377 }
378
379 block->u.Packet_Downlink_Assignment.Packet_Timing_Advance.Exist_TIMING_ADVANCE_VALUE = 0x1; // TIMING_ADVANCE_VALUE = on
Jacob Erlbeck9200ce62015-05-22 17:48:04 +0200380 block->u.Packet_Downlink_Assignment.Packet_Timing_Advance.TIMING_ADVANCE_VALUE = tbf->ta(); // TIMING_ADVANCE_VALUE
Holger Hans Peter Freyther6ca0a902013-10-19 18:50:22 +0200381 if (ta_idx < 0) {
382 block->u.Packet_Downlink_Assignment.Packet_Timing_Advance.Exist_IndexAndtimeSlot = 0x0; // TIMING_ADVANCE_INDEX = off
383 } else {
384 block->u.Packet_Downlink_Assignment.Packet_Timing_Advance.Exist_IndexAndtimeSlot = 0x1; // TIMING_ADVANCE_INDEX = on
385 block->u.Packet_Downlink_Assignment.Packet_Timing_Advance.TIMING_ADVANCE_INDEX = ta_idx; // TIMING_ADVANCE_INDEX
386 block->u.Packet_Downlink_Assignment.Packet_Timing_Advance.TIMING_ADVANCE_TIMESLOT_NUMBER = ta_ts; // TIMING_ADVANCE_TS
387 }
388
389 block->u.Packet_Downlink_Assignment.Exist_P0_and_BTS_PWR_CTRL_MODE = 0x0; // POWER CONTROL = off
390
391 block->u.Packet_Downlink_Assignment.Exist_Frequency_Parameters = 0x1; // Frequency Parameters = on
Holger Hans Peter Freyther8f399de2013-12-25 20:22:35 +0100392 block->u.Packet_Downlink_Assignment.Frequency_Parameters.TSC = tbf->tsc(); // Training Sequence Code (TSC)
Holger Hans Peter Freyther6ca0a902013-10-19 18:50:22 +0200393 block->u.Packet_Downlink_Assignment.Frequency_Parameters.UnionType = 0x0; // ARFCN = on
Holger Hans Peter Freytherfc498c92013-10-27 13:38:54 +0100394 block->u.Packet_Downlink_Assignment.Frequency_Parameters.u.ARFCN = tbf->trx->arfcn; // ARFCN
Holger Hans Peter Freyther6ca0a902013-10-19 18:50:22 +0200395
396 block->u.Packet_Downlink_Assignment.Exist_DOWNLINK_TFI_ASSIGNMENT = 0x1; // DOWNLINK TFI ASSIGNMENT = on
Holger Hans Peter Freyther34f6e5e2013-10-27 20:31:47 +0100397 block->u.Packet_Downlink_Assignment.DOWNLINK_TFI_ASSIGNMENT = tbf->tfi(); // TFI
Holger Hans Peter Freyther6ca0a902013-10-19 18:50:22 +0200398
399 block->u.Packet_Downlink_Assignment.Exist_Power_Control_Parameters = 0x1; // Power Control Parameters = on
400 block->u.Packet_Downlink_Assignment.Power_Control_Parameters.ALPHA = alpha; // ALPHA
401
402 for (tn = 0; tn < 8; tn++)
403 {
404 if (tbf->pdch[tn])
405 {
406 block->u.Packet_Downlink_Assignment.Power_Control_Parameters.Slot[tn].Exist = 0x1; // Slot[i] = on
407 block->u.Packet_Downlink_Assignment.Power_Control_Parameters.Slot[tn].GAMMA_TN = gamma; // GAMMA_TN
408 }
409 else
410 {
411 block->u.Packet_Downlink_Assignment.Power_Control_Parameters.Slot[tn].Exist = 0x0; // Slot[i] = off
412 }
413 }
414
415 block->u.Packet_Downlink_Assignment.Exist_TBF_Starting_Time = 0x0; // TBF Starting TIME = off
416 block->u.Packet_Downlink_Assignment.Exist_Measurement_Mapping = 0x0; // Measurement_Mapping = off
Jacob Erlbeck166c9fc2016-01-07 16:04:29 +0100417 if (!use_egprs) {
418 block->u.Packet_Downlink_Assignment.Exist_AdditionsR99 = 0x0; // AdditionsR99 = off
419 return;
420 }
Jacob Erlbeck36df7742016-01-19 15:53:30 +0100421
422 ws_enc = (tbf->window()->ws() - 64) / 32;
423
Jacob Erlbeck166c9fc2016-01-07 16:04:29 +0100424 block->u.Packet_Downlink_Assignment.Exist_AdditionsR99 = 0x1; // AdditionsR99 = on
425 pda_r99 = &block->u.Packet_Downlink_Assignment.AdditionsR99;
426 pda_r99->Exist_EGPRS_Params = 1;
Jacob Erlbeck36df7742016-01-19 15:53:30 +0100427 pda_r99->EGPRS_WindowSize = ws_enc; /* see TS 44.060, table 12.5.2.1 */
Jacob Erlbeck166c9fc2016-01-07 16:04:29 +0100428 pda_r99->LINK_QUALITY_MEASUREMENT_MODE = 0x0; /* no meas, see TS 44.060, table 11.2.7.2 */
429 pda_r99->Exist_BEP_PERIOD2 = 0; /* No extra EGPRS BEP PERIOD */
430 pda_r99->Exist_Packet_Extended_Timing_Advance = 0;
431 pda_r99->Exist_COMPACT_ReducedMA = 0;
Holger Hans Peter Freyther6ca0a902013-10-19 18:50:22 +0200432}
433
434/* generate paging request */
Holger Hans Peter Freyther63f29d62013-10-19 19:04:03 +0200435int Encoding::write_paging_request(bitvec * dest, uint8_t *ptmsi, uint16_t ptmsi_len)
Holger Hans Peter Freyther6ca0a902013-10-19 18:50:22 +0200436{
437 unsigned wp = 0;
438 int plen;
439
440 bitvec_write_field(dest, wp,0x0,4); // Skip Indicator
441 bitvec_write_field(dest, wp,0x6,4); // Protocol Discriminator
442 bitvec_write_field(dest, wp,0x21,8); // Paging Request Message Type
443
444 bitvec_write_field(dest, wp,0x0,4); // Page Mode
445 bitvec_write_field(dest, wp,0x0,4); // Channel Needed
446
447 // Mobile Identity
448 bitvec_write_field(dest, wp,ptmsi_len+1,8); // Mobile Identity length
449 bitvec_write_field(dest, wp,0xf,4); // unused
450 bitvec_write_field(dest, wp,0x4,4); // PTMSI type
451 for (int i = 0; i < ptmsi_len; i++)
452 {
453 bitvec_write_field(dest, wp,ptmsi[i],8); // PTMSI
454 }
455 if ((wp % 8)) {
456 LOGP(DRLCMACUL, LOGL_ERROR, "Length of PAG.REQ without rest "
457 "octets is not multiple of 8 bits, PLEASE FIX!\n");
458 exit (0);
459 }
460 plen = wp / 8;
461 bitvec_write_field(dest, wp,0x0,1); // "L" NLN(PCH) = off
462 bitvec_write_field(dest, wp,0x0,1); // "L" Priority1 = off
463 bitvec_write_field(dest, wp,0x1,1); // "L" Priority2 = off
464 bitvec_write_field(dest, wp,0x0,1); // "L" Group Call information = off
465 bitvec_write_field(dest, wp,0x0,1); // "H" Packet Page Indication 1 = packet paging procedure
466 bitvec_write_field(dest, wp,0x1,1); // "H" Packet Page Indication 2 = packet paging procedure
467
468 return plen;
469}
470
Daniel Willmann5241c1a2013-12-11 14:35:29 +0100471/**
472 * The index of the array show_rbb is the bit position inside the rbb
473 * (show_rbb[63] relates to BSN ssn-1)
474 */
475void Encoding::encode_rbb(const char *show_rbb, uint8_t *rbb)
476{
477 uint8_t rbb_byte = 0;
478
479 // RECEIVE_BLOCK_BITMAP
480 for (int i = 0; i < 64; i++) {
481 /* Set bit at the appropriate position (see 3GPP TS 04.60 9.1.8.1) */
482 if (show_rbb[i] == 'R')
483 rbb_byte |= 1<< (7-(i%8));
484
485 if((i%8) == 7) {
486 rbb[i/8] = rbb_byte;
487 rbb_byte = 0;
488 }
489 }
490}
491
Jacob Erlbeck37005a12015-12-22 14:58:34 +0100492static void write_packet_ack_nack_desc_gprs(
493 struct gprs_rlcmac_bts *bts, bitvec * dest, unsigned& wp,
494 gprs_rlc_ul_window *window, bool is_final)
495{
496 char rbb[65];
497
498 window->update_rbb(rbb);
499
500 rbb[64] = 0;
501 LOGP(DRLCMACUL, LOGL_DEBUG, "- V(N): \"%s\" R=Received "
502 "I=Invalid\n", rbb);
503
504 bitvec_write_field(dest, wp, is_final, 1); // FINAL_ACK_INDICATION
505 bitvec_write_field(dest, wp, window->ssn(), 7); // STARTING_SEQUENCE_NUMBER
506
507 for (int i = 0; i < 64; i++) {
508 /* Set bit at the appropriate position (see 3GPP TS 04.60 9.1.8.1) */
509 bool is_ack = (rbb[i] == 'R');
510 bitvec_write_field(dest, wp, is_ack, 1);
511 }
512}
513
514static void write_packet_uplink_ack_gprs(
515 struct gprs_rlcmac_bts *bts, bitvec * dest, unsigned& wp,
516 struct gprs_rlcmac_ul_tbf *tbf, bool is_final)
517{
518
Jacob Erlbeckcb728902016-01-05 15:33:03 +0100519 bitvec_write_field(dest, wp, tbf->current_cs().to_num() - 1, 2); // CHANNEL_CODING_COMMAND
Jacob Erlbeck37005a12015-12-22 14:58:34 +0100520 write_packet_ack_nack_desc_gprs(bts, dest, wp, &tbf->m_window, is_final);
521
522 bitvec_write_field(dest, wp, 1, 1); // 1: have CONTENTION_RESOLUTION_TLLI
523 bitvec_write_field(dest, wp, tbf->tlli(), 32); // CONTENTION_RESOLUTION_TLLI
524
525 bitvec_write_field(dest, wp, 0, 1); // 0: don't have Packet Timing Advance
526 bitvec_write_field(dest, wp, 0, 1); // 0: don't have Power Control Parameters
527 bitvec_write_field(dest, wp, 0, 1); // 0: don't have Extension Bits
528 bitvec_write_field(dest, wp, 0, 1); // fixed 0
529 bitvec_write_field(dest, wp, 1, 1); // 1: have Additions R99
530 bitvec_write_field(dest, wp, 0, 1); // 0: don't have Packet Extended Timing Advance
531 bitvec_write_field(dest, wp, 1, 1); // TBF_EST (enabled)
532 bitvec_write_field(dest, wp, 0, 1); // 0: don't have REL 5
533};
534
535static void write_packet_ack_nack_desc_egprs(
536 struct gprs_rlcmac_bts *bts, bitvec * dest, unsigned& wp,
537 gprs_rlc_ul_window *window, bool is_final)
538{
539 int urbb_len = 0;
540 int crbb_len = 0;
541 int len;
542 bool bow = true;
543 bool eow = true;
544 int ssn = window->mod_sns(window->v_q() + 1);
545 int num_blocks = window->mod_sns(window->v_r() - window->v_q());
546 int esn_crbb = window->mod_sns(ssn - 1);
547 int rest_bits = dest->data_len * 8 - wp;
548
549 if (num_blocks > 0)
550 /* V(Q) is NACK and omitted -> SSN = V(Q) + 1 */
551 num_blocks -= 1;
552
553 if (num_blocks > window->ws())
554 num_blocks = window->ws();
555
556 if (num_blocks > rest_bits) {
557 eow = false;
558 urbb_len = rest_bits;
559 /* TODO: use compression, start encoding bits and stop when the
560 * space is exhausted. Use the first combination that encodes
561 * all bits. If there is none, use the combination that encodes
562 * the largest number of bits (e.g. by setting num_blocks to the
563 * max and repeating the construction).
564 */
565 } else if (num_blocks > rest_bits - 9) {
566 /* union bit and length field take 9 bits */
567 eow = false;
568 urbb_len = rest_bits - 9;
569 /* TODO: use compression (see above) */
570 }
571
572 if (urbb_len + crbb_len == rest_bits)
573 len = -1;
574 else if (crbb_len == 0)
575 len = urbb_len + 15;
576 else
577 len = urbb_len + crbb_len + 23;
578
579 /* EGPRS Ack/Nack Description IE */
580 if (len < 0) {
581 bitvec_write_field(dest, wp, 0, 1); // 0: don't have length
582 } else {
583 bitvec_write_field(dest, wp, 1, 1); // 1: have length
584 bitvec_write_field(dest, wp, len, 8); // length
585 }
586
587 bitvec_write_field(dest, wp, is_final, 1); // FINAL_ACK_INDICATION
588 bitvec_write_field(dest, wp, bow, 1); // BEGINNING_OF_WINDOW
589 bitvec_write_field(dest, wp, eow, 1); // END_OF_WINDOW
590 bitvec_write_field(dest, wp, ssn, 11); // STARTING_SEQUENCE_NUMBER
591 bitvec_write_field(dest, wp, 0, 1); // 0: don't have CRBB
592
593 /* TODO: Add CRBB support */
594
595 LOGP(DRLCMACUL, LOGL_DEBUG,
596 " - EGPRS URBB, len = %d, SSN = %d, ESN_CRBB = %d, "
597 "SNS = %d, WS = %d, V(Q) = %d, V(R) = %d%s%s\n",
598 urbb_len, ssn, esn_crbb,
599 window->sns(), window->ws(), window->v_q(), window->v_r(),
600 bow ? ", BOW" : "", eow ? ", EOW" : "");
601 for (int i = urbb_len; i > 0; i--) {
602 /* Set bit at the appropriate position (see 3GPP TS 04.60 12.3.1) */
603 bool is_ack = window->m_v_n.is_received(esn_crbb + i);
604 bitvec_write_field(dest, wp, is_ack, 1);
605 }
606}
607
608static void write_packet_uplink_ack_egprs(
609 struct gprs_rlcmac_bts *bts, bitvec * dest, unsigned& wp,
610 struct gprs_rlcmac_ul_tbf *tbf, bool is_final)
611{
612 bitvec_write_field(dest, wp, 0, 2); // fixed 00
613 bitvec_write_field(dest, wp, 2, 4); // CHANNEL_CODING_COMMAND: MCS-3
614 // bitvec_write_field(dest, wp, tbf->current_cs() - 1, 4); // CHANNEL_CODING_COMMAND
615 bitvec_write_field(dest, wp, 0, 1); // 0: no RESEGMENT (nyi)
616 bitvec_write_field(dest, wp, 1, 1); // PRE_EMPTIVE_TRANSMISSION, TODO: This resembles GPRS, change it?
617 bitvec_write_field(dest, wp, 0, 1); // 0: no PRR_RETRANSMISSION_REQUEST, TODO: clarify
618 bitvec_write_field(dest, wp, 0, 1); // 0: no ARAC_RETRANSMISSION_REQUEST, TODO: clarify
619 bitvec_write_field(dest, wp, 1, 1); // 1: have CONTENTION_RESOLUTION_TLLI
620 bitvec_write_field(dest, wp, tbf->tlli(), 32); // CONTENTION_RESOLUTION_TLLI
621 bitvec_write_field(dest, wp, 1, 1); // TBF_EST (enabled)
622 bitvec_write_field(dest, wp, 0, 1); // 0: don't have Packet Timing Advance
623 bitvec_write_field(dest, wp, 0, 1); // 0: don't have Packet Extended Timing Advance
624 bitvec_write_field(dest, wp, 0, 1); // 0: don't have Power Control Parameters
625 bitvec_write_field(dest, wp, 0, 1); // 0: don't have Extension Bits
626
627 write_packet_ack_nack_desc_egprs(bts, dest, wp, &tbf->m_window, is_final);
628
629 bitvec_write_field(dest, wp, 0, 1); // fixed 0
630 bitvec_write_field(dest, wp, 0, 1); // 0: don't have REL 5
631};
632
633void Encoding::write_packet_uplink_ack(
634 struct gprs_rlcmac_bts *bts, bitvec * dest,
Jacob Erlbeckf2694b72016-01-26 21:46:26 +0100635 struct gprs_rlcmac_ul_tbf *tbf, bool is_final,
636 uint8_t rrbp)
Jacob Erlbeck37005a12015-12-22 14:58:34 +0100637{
638 unsigned wp = 0;
639
640 LOGP(DRLCMACUL, LOGL_DEBUG, "Encoding Ack/Nack for %s "
641 "(final=%d)\n", tbf_name(tbf), is_final);
642
643 bitvec_write_field(dest, wp, 0x1, 2); // Payload Type
Jacob Erlbeckf2694b72016-01-26 21:46:26 +0100644 bitvec_write_field(dest, wp, rrbp, 2); // Uplink block with TDMA framenumber
Jacob Erlbeck37005a12015-12-22 14:58:34 +0100645 bitvec_write_field(dest, wp, is_final, 1); // Suppl/Polling Bit
646 bitvec_write_field(dest, wp, 0x0, 3); // Uplink state flag
647 bitvec_write_field(dest, wp, 0x9, 6); // MESSAGE TYPE Uplink Ack/Nack
648 bitvec_write_field(dest, wp, 0x0, 2); // Page Mode
649
650 bitvec_write_field(dest, wp, 0x0, 2); // fixed 00
651 bitvec_write_field(dest, wp, tbf->tfi(), 5); // Uplink TFI
652
653 if (tbf->is_egprs_enabled()) {
654 /* PU_AckNack_EGPRS = on */
655 bitvec_write_field(dest, wp, 1, 1); // 1: EGPRS
656 write_packet_uplink_ack_egprs(bts, dest, wp, tbf, is_final);
657 } else {
658 /* PU_AckNack_GPRS = on */
659 bitvec_write_field(dest, wp, 0, 1); // 0: GPRS
660 write_packet_uplink_ack_gprs(bts, dest, wp, tbf, is_final);
661 }
662
663 LOGP(DRLCMACUL, LOGL_DEBUG,
664 "Uplink Ack/Nack bit count %d, max %d, message = %s\n",
665 wp, dest->data_len * 8,
666 osmo_hexdump(dest->data, dest->data_len));
667}
668
Holger Hans Peter Freyther63f29d62013-10-19 19:04:03 +0200669unsigned Encoding::write_packet_paging_request(bitvec * dest)
Holger Hans Peter Freyther6ca0a902013-10-19 18:50:22 +0200670{
671 unsigned wp = 0;
672
673 bitvec_write_field(dest, wp,0x1,2); // Payload Type
674 bitvec_write_field(dest, wp,0x0,3); // No polling
675 bitvec_write_field(dest, wp,0x0,3); // Uplink state flag
676 bitvec_write_field(dest, wp,0x22,6); // MESSAGE TYPE
677
678 bitvec_write_field(dest, wp,0x0,2); // Page Mode
679
680 bitvec_write_field(dest, wp,0x0,1); // No PERSISTENCE_LEVEL
681 bitvec_write_field(dest, wp,0x0,1); // No NLN
682
683 return wp;
684}
685
Holger Hans Peter Freyther63f29d62013-10-19 19:04:03 +0200686unsigned Encoding::write_repeated_page_info(bitvec * dest, unsigned& wp, uint8_t len,
Holger Hans Peter Freyther6ca0a902013-10-19 18:50:22 +0200687 uint8_t *identity, uint8_t chan_needed)
688{
689 bitvec_write_field(dest, wp,0x1,1); // Repeated Page info exists
690
691 bitvec_write_field(dest, wp,0x1,1); // RR connection paging
692
693 if ((identity[0] & 0x07) == 4) {
694 bitvec_write_field(dest, wp,0x0,1); // TMSI
695 identity++;
696 len--;
697 } else {
698 bitvec_write_field(dest, wp,0x0,1); // MI
699 bitvec_write_field(dest, wp,len,4); // MI len
700 }
701 while (len) {
702 bitvec_write_field(dest, wp,*identity++,8); // MI data
703 len--;
704 }
705 bitvec_write_field(dest, wp,chan_needed,2); // CHANNEL_NEEDED
706 bitvec_write_field(dest, wp,0x0,1); // No eMLPP_PRIORITY
707
708 return wp;
709}
710
Jacob Erlbeckf0e40392016-01-08 10:07:53 +0100711int Encoding::rlc_write_dl_data_header(const struct gprs_rlc_data_info *rlc,
712 uint8_t *data)
713{
714 struct gprs_rlc_dl_header_egprs_3 *egprs3;
715 struct rlc_dl_header *gprs;
716 unsigned int e_fbi_header;
717 GprsCodingScheme cs = rlc->cs;
718
719 switch(cs.headerTypeData()) {
720 case GprsCodingScheme::HEADER_GPRS_DATA:
721 gprs = static_cast<struct rlc_dl_header *>
722 ((void *)data);
723
724 gprs->usf = rlc->usf;
725 gprs->s_p = rlc->es_p != 0 ? 1 : 0;
726 gprs->rrbp = rlc->rrbp;
727 gprs->pt = 0;
728 gprs->tfi = rlc->tfi;
729 gprs->pr = rlc->pr;
730
731 gprs->fbi = rlc->block_info[0].cv == 0;
732 gprs->e = rlc->block_info[0].e;
733 gprs->bsn = rlc->block_info[0].bsn;
734 break;
735
736 case GprsCodingScheme::HEADER_EGPRS_DATA_TYPE_3:
737 egprs3 = static_cast<struct gprs_rlc_dl_header_egprs_3 *>
738 ((void *)data);
739
740 egprs3->usf = rlc->usf;
741 egprs3->es_p = rlc->es_p;
742 egprs3->rrbp = rlc->rrbp;
743 egprs3->tfi_a = rlc->tfi >> 0; /* 1 bit LSB */
744 egprs3->tfi_b = rlc->tfi >> 1; /* 4 bits */
745 egprs3->pr = rlc->pr;
746 egprs3->cps = rlc->cps;
747
748 egprs3->bsn1_a = rlc->block_info[0].bsn >> 0; /* 2 bits LSB */
749 egprs3->bsn1_b = rlc->block_info[0].bsn >> 2; /* 8 bits */
750 egprs3->bsn1_c = rlc->block_info[0].bsn >> 10; /* 1 bit */
751
752 egprs3->spb = rlc->block_info[0].spb;
753
754 e_fbi_header = rlc->block_info[0].e ? 0x01 : 0;
755 e_fbi_header |= rlc->block_info[0].cv == 0 ? 0x02 : 0; /* FBI */
756 e_fbi_header <<= 7;
757 data[3] = (data[3] & 0b01111111) | (e_fbi_header >> 0);
758 data[4] = (data[4] & 0b11111110) | (e_fbi_header >> 8);
759 break;
760
761 case GprsCodingScheme::HEADER_EGPRS_DATA_TYPE_1:
762 case GprsCodingScheme::HEADER_EGPRS_DATA_TYPE_2:
763 /* TODO: Support both header types */
764 /* fall through */
765 default:
766 LOGP(DRLCMACDL, LOGL_ERROR,
767 "Encoding of uplink %s data blocks not yet supported.\n",
768 cs.name());
769 return -ENOTSUP;
770 };
771
772 return 0;
773}
774
775/**
776 * \brief Copy LSB bitstream RLC data block from byte aligned buffer.
777 *
778 * Note that the bitstream is encoded in LSB first order, so the two octets
779 * 654321xx xxxxxx87 contain the octet 87654321 starting at bit position 3
780 * (LSB has bit position 1). This is a different order than the one used by
781 * CSN.1.
782 *
783 * \param data_block_idx The block index, 0..1 for header type 1, 0 otherwise
784 * \param src A pointer to the start of the RLC block (incl. the header)
785 * \param buffer A data area of a least the size of the RLC block
786 * \returns the number of bytes copied
787 */
788unsigned int Encoding::rlc_copy_from_aligned_buffer(
789 const struct gprs_rlc_data_info *rlc,
790 unsigned int data_block_idx,
791 uint8_t *dst, const uint8_t *buffer)
792{
793 unsigned int hdr_bytes;
794 unsigned int extra_bits;
795 unsigned int i;
796
797 uint8_t c, last_c;
798 const uint8_t *src;
799 const struct gprs_rlc_data_block_info *rdbi;
800
801 OSMO_ASSERT(data_block_idx < rlc->num_data_blocks);
802 rdbi = &rlc->block_info[data_block_idx];
803
804 hdr_bytes = rlc->data_offs_bits[data_block_idx] / 8;
805 extra_bits = (rlc->data_offs_bits[data_block_idx] % 8);
806
807 if (extra_bits == 0) {
808 /* It is aligned already */
809 memmove(dst + hdr_bytes, buffer, rdbi->data_len);
810 return rdbi->data_len;
811 }
812
813 src = buffer;
814 dst = dst + hdr_bytes;
815 last_c = *dst << (8 - extra_bits);
816
817 for (i = 0; i < rdbi->data_len; i++) {
818 c = src[i];
819 *(dst++) = (last_c >> (8 - extra_bits)) | (c << extra_bits);
820 last_c = c;
821 }
822
823 /* overwrite the lower extra_bits */
824 *dst = (*dst & (0xff << extra_bits)) | (last_c >> (8 - extra_bits));
825
826 return rdbi->data_len;
827}
Jacob Erlbeck14bb0942016-01-12 11:58:13 +0100828
Jacob Erlbeck5058bd62016-01-13 10:51:25 +0100829static Encoding::AppendResult rlc_data_to_dl_append_gprs(
Jacob Erlbeck14bb0942016-01-12 11:58:13 +0100830 struct gprs_rlc_data_block_info *rdbi,
831 gprs_llc *llc, int *offset, int *num_chunks,
832 uint8_t *data_block,
833 bool is_final)
834{
835 int chunk;
836 int space;
837 struct rlc_li_field *li;
838 uint8_t *delimiter, *data, *e_pointer;
839
840 data = data_block + *offset;
841 delimiter = data_block + *num_chunks;
842 e_pointer = (*num_chunks ? delimiter - 1 : NULL);
843
844 chunk = llc->chunk_size();
845 space = rdbi->data_len - *offset;
846
847 /* if chunk will exceed block limit */
848 if (chunk > space) {
849 LOGP(DRLCMACDL, LOGL_DEBUG, "-- Chunk with length %d "
850 "larger than space (%d) left in block: copy "
851 "only remaining space, and we are done\n",
852 chunk, space);
853 /* block is filled, so there is no extension */
854 if (e_pointer)
855 *e_pointer |= 0x01;
856 /* fill only space */
857 llc->consume(data, space);
858 /* return data block as message */
859 *offset = rdbi->data_len;
860 (*num_chunks)++;
Jacob Erlbeck5058bd62016-01-13 10:51:25 +0100861 return Encoding::AR_NEED_MORE_BLOCKS;
Jacob Erlbeck14bb0942016-01-12 11:58:13 +0100862 }
863 /* if FINAL chunk would fit precisely in space left */
864 if (chunk == space && is_final)
865 {
866 LOGP(DRLCMACDL, LOGL_DEBUG, "-- Chunk with length %d "
867 "would exactly fit into space (%d): because "
868 "this is a final block, we don't add length "
869 "header, and we are done\n", chunk, space);
870 /* block is filled, so there is no extension */
871 if (e_pointer)
872 *e_pointer |= 0x01;
873 /* fill space */
874 llc->consume(data, space);
875 *offset = rdbi->data_len;
876 (*num_chunks)++;
877 rdbi->cv = 0;
Jacob Erlbeck5058bd62016-01-13 10:51:25 +0100878 return Encoding::AR_COMPLETED_BLOCK_FILLED;
Jacob Erlbeck14bb0942016-01-12 11:58:13 +0100879 }
880 /* if chunk would fit exactly in space left */
881 if (chunk == space) {
882 LOGP(DRLCMACDL, LOGL_DEBUG, "-- Chunk with length %d "
883 "would exactly fit into space (%d): add length "
884 "header with LI=0, to make frame extend to "
885 "next block, and we are done\n", chunk, space);
886 /* make space for delimiter */
887 if (delimiter != data)
888 memmove(delimiter + 1, delimiter,
889 data - delimiter);
890 data++;
891 (*offset)++;
892 space--;
893 /* add LI with 0 length */
894 li = (struct rlc_li_field *)delimiter;
895 li->e = 1; /* not more extension */
896 li->m = 0; /* shall be set to 0, in case of li = 0 */
897 li->li = 0; /* chunk fills the complete space */
898 rdbi->e = 0; /* 0: extensions present */
899 // no need to set e_pointer nor increase delimiter
900 /* fill only space, which is 1 octet less than chunk */
901 llc->consume(data, space);
902 /* return data block as message */
903 *offset = rdbi->data_len;
904 (*num_chunks)++;
Jacob Erlbeck5058bd62016-01-13 10:51:25 +0100905 return Encoding::AR_NEED_MORE_BLOCKS;
Jacob Erlbeck14bb0942016-01-12 11:58:13 +0100906 }
907
908 LOGP(DRLCMACDL, LOGL_DEBUG, "-- Chunk with length %d is less "
909 "than remaining space (%d): add length header to "
910 "to delimit LLC frame\n", chunk, space);
911 /* the LLC frame chunk ends in this block */
912 /* make space for delimiter */
913 if (delimiter != data)
914 memmove(delimiter + 1, delimiter, data - delimiter);
915 data++;
916 (*offset)++;
917 space--;
918 /* add LI to delimit frame */
919 li = (struct rlc_li_field *)delimiter;
920 li->e = 0; /* Extension bit, maybe set later */
921 li->m = 0; /* will be set later, if there is more LLC data */
922 li->li = chunk; /* length of chunk */
923 rdbi->e = 0; /* 0: extensions present */
924 (*num_chunks)++;
925 /* copy (rest of) LLC frame to space and reset later */
926 llc->consume(data, chunk);
927 data += chunk;
928 space -= chunk;
929 (*offset) += chunk;
930 /* if we have more data and we have space left */
931 if (space > 0 && !is_final) {
932 li->m = 1; /* we indicate more frames to follow */
Jacob Erlbeck5058bd62016-01-13 10:51:25 +0100933 return Encoding::AR_COMPLETED_SPACE_LEFT;
Jacob Erlbeck14bb0942016-01-12 11:58:13 +0100934 }
935 /* if we don't have more LLC frames */
936 if (is_final) {
937 LOGP(DRLCMACDL, LOGL_DEBUG, "-- Final block, so we "
938 "done.\n");
939 li->e = 1; /* we cannot extend */
940 rdbi->cv = 0;
Jacob Erlbeck5058bd62016-01-13 10:51:25 +0100941 return Encoding::AR_COMPLETED_BLOCK_FILLED;
Jacob Erlbeck14bb0942016-01-12 11:58:13 +0100942 }
943 /* we have no space left */
944 LOGP(DRLCMACDL, LOGL_DEBUG, "-- No space left, so we are "
945 "done.\n");
946 li->e = 1; /* we cannot extend */
Jacob Erlbeck5058bd62016-01-13 10:51:25 +0100947 return Encoding::AR_COMPLETED_BLOCK_FILLED;
948}
949
Jacob Erlbecka88d0652016-01-13 11:28:10 +0100950static Encoding::AppendResult rlc_data_to_dl_append_egprs(
951 struct gprs_rlc_data_block_info *rdbi,
952 gprs_llc *llc, int *offset, int *num_chunks,
953 uint8_t *data_block,
954 bool is_final)
955{
956 int chunk;
957 int space;
958 struct rlc_li_field_egprs *li;
959 struct rlc_li_field_egprs *prev_li;
960 uint8_t *delimiter, *data;
961
962 data = data_block + *offset;
963 delimiter = data_block + *num_chunks;
964 prev_li = (struct rlc_li_field_egprs *)
965 (*num_chunks ? delimiter - 1 : NULL);
966
967 chunk = llc->chunk_size();
968 space = rdbi->data_len - *offset;
969
970 /* if chunk will exceed block limit */
971 if (chunk > space) {
972 LOGP(DRLCMACDL, LOGL_DEBUG, "-- Chunk with length %d "
973 "larger than space (%d) left in block: copy "
974 "only remaining space, and we are done\n",
975 chunk, space);
976 /* fill only space */
977 llc->consume(data, space);
978 /* return data block as message */
979 *offset = rdbi->data_len;
980 (*num_chunks)++;
981 return Encoding::AR_NEED_MORE_BLOCKS;
982 }
983 /* if FINAL chunk would fit precisely in space left */
984 if (chunk == space && is_final)
985 {
986 LOGP(DRLCMACDL, LOGL_DEBUG, "-- Chunk with length %d "
987 "would exactly fit into space (%d): because "
988 "this is a final block, we don't add length "
989 "header, and we are done\n", chunk, space);
990 /* fill space */
991 llc->consume(data, space);
992 *offset = rdbi->data_len;
993 (*num_chunks)++;
994 rdbi->cv = 0;
995 return Encoding::AR_COMPLETED_BLOCK_FILLED;
996 }
997 /* if chunk would fit exactly in space left */
998 if (chunk == space) {
999 LOGP(DRLCMACDL, LOGL_DEBUG, "-- Chunk with length %d "
1000 "would exactly fit into space (%d): just copy "
1001 "it, and we are done. The next block will have "
1002 "to start with an empty chunk\n",
1003 chunk, space);
1004 /* fill space */
1005 llc->consume(data, space);
1006 *offset = rdbi->data_len;
1007 (*num_chunks)++;
1008 return Encoding::AR_NEED_MORE_BLOCKS;
1009 }
1010
1011 LOGP(DRLCMACDL, LOGL_DEBUG, "-- Chunk with length %d is less "
1012 "than remaining space (%d): add length header to "
1013 "to delimit LLC frame\n", chunk, space);
1014 /* the LLC frame chunk ends in this block */
1015 /* make space for delimiter */
1016
1017 if (delimiter != data)
1018 memmove(delimiter + 1, delimiter, data - delimiter);
1019
1020 data += 1;
1021 (*offset) += 1;
1022 space -= 1;
1023 /* add LI to delimit frame */
1024 li = (struct rlc_li_field_egprs *)delimiter;
1025 li->e = 1; /* Extension bit, maybe set later */
1026 li->li = chunk; /* length of chunk */
1027 /* tell previous extension header about the new one */
1028 if (prev_li)
1029 prev_li->e = 0;
1030 rdbi->e = 0; /* 0: extensions present */
1031 delimiter++;
1032 prev_li = li;
1033 (*num_chunks)++;
1034 /* copy (rest of) LLC frame to space and reset later */
1035 llc->consume(data, chunk);
1036 data += chunk;
1037 space -= chunk;
1038 (*offset) += chunk;
1039 /* if we have more data and we have space left */
1040 if (space > 0) {
1041 if (!is_final)
1042 return Encoding::AR_COMPLETED_SPACE_LEFT;
1043
1044 /* we don't have more LLC frames */
1045 /* We will have to add another chunk with filling octets */
1046 LOGP(DRLCMACDL, LOGL_DEBUG,
1047 "-- There is remaining space (%d): add filling byte chunk\n",
1048 space);
1049
1050 if (delimiter != data)
1051 memmove(delimiter + 1, delimiter, data - delimiter);
1052
1053 data += 1;
1054 (*offset) += 1;
1055 space -= 1;
1056
1057 /* set filling bytes extension */
1058 li = (struct rlc_li_field_egprs *)delimiter;
1059 li->e = 1;
1060 li->li = 127;
1061
1062 /* tell previous extension header about the new one */
1063 if (prev_li)
1064 prev_li->e = 0;
1065
1066 delimiter++;
1067 (*num_chunks)++;
1068
1069 rdbi->cv = 0;
1070
1071 LOGP(DRLCMACDL, LOGL_DEBUG, "-- Final block, so we "
1072 "are done.\n");
1073
1074 *offset = rdbi->data_len;
1075 return Encoding::AR_COMPLETED_BLOCK_FILLED;
1076 }
1077
1078 if (is_final) {
1079 /* we don't have more LLC frames */
1080 LOGP(DRLCMACDL, LOGL_DEBUG, "-- Final block, so we "
1081 "are done.\n");
1082 rdbi->cv = 0;
1083 return Encoding::AR_COMPLETED_BLOCK_FILLED;
1084 }
1085
1086 /* we have no space left */
1087 LOGP(DRLCMACDL, LOGL_DEBUG, "-- No space left, so we are "
1088 "done.\n");
1089 return Encoding::AR_COMPLETED_BLOCK_FILLED;
1090}
1091
Jacob Erlbeck5058bd62016-01-13 10:51:25 +01001092Encoding::AppendResult Encoding::rlc_data_to_dl_append(
1093 struct gprs_rlc_data_block_info *rdbi, GprsCodingScheme cs,
1094 gprs_llc *llc, int *offset, int *num_chunks,
1095 uint8_t *data_block,
1096 bool is_final)
1097{
1098 if (cs.isGprs())
1099 return rlc_data_to_dl_append_gprs(rdbi,
1100 llc, offset, num_chunks, data_block, is_final);
1101
Jacob Erlbecka88d0652016-01-13 11:28:10 +01001102 if (cs.isEgprs())
1103 return rlc_data_to_dl_append_egprs(rdbi,
1104 llc, offset, num_chunks, data_block, is_final);
1105
Jacob Erlbeck5058bd62016-01-13 10:51:25 +01001106 LOGP(DRLCMACDL, LOGL_ERROR, "%s data block encoding not implemented\n",
1107 cs.name());
1108
1109 return AR_NEED_MORE_BLOCKS;
Jacob Erlbeck14bb0942016-01-12 11:58:13 +01001110}