libosmogsm  1.0.1.85-9f28
Osmocom GSM library
gsm0808_utils.h
Go to the documentation of this file.
1 
4 /*
5  * (C) 2016 by sysmocom - s.f.m.c. GmbH, Author: Philipp Maier
6  * All Rights Reserved
7  *
8  * SPDX-License-Identifier: GPL-2.0+
9  *
10  * This program is free software; you can redistribute it and/or modify
11  * it under the terms of the GNU General Public License as published by
12  * the Free Software Foundation; either version 2 of the License, or
13  * (at your option) any later version.
14  *
15  * This program is distributed in the hope that it will be useful,
16  * but WITHOUT ANY WARRANTY; without even the implied warranty of
17  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
18  * GNU General Public License for more details.
19  *
20  * You should have received a copy of the GNU General Public License
21  * along with this program. If not, see <http://www.gnu.org/licenses/>.
22  *
23  */
24 #pragma once
25 
26 struct sockaddr_storage;
27 
30 #include <osmocom/gsm/gsm29205.h>
31 #include <osmocom/gsm/gsm23003.h>
32 #include <osmocom/gsm/gsm_utils.h>
33 #include <osmocom/gsm/tlv.h>
34 
36 #define GSM0808_CELL_ID_LIST2_MAXLEN 127
37 
44  uint16_t ci;
46  uint16_t lac;
47 };
48 
51  enum CELL_IDENT id_discr;
53 };
54 
57  enum CELL_IDENT id_discr;
59  unsigned int id_list_len;
60 };
61 
63 struct osmo_lcls {
65  enum gsm0808_lcls_control control;
66  struct osmo_gcr_parsed gcr;
68  bool corr_needed;
69 };
70 
71 char *osmo_lcls_dump(const struct osmo_lcls *lcls);
72 char *osmo_gcr_dump(const struct osmo_lcls *lcls);
73 
74 extern const struct value_string gsm0808_cell_id_discr_names[];
75 static inline const char *gsm0808_cell_id_discr_name(enum CELL_IDENT id_discr)
76 { return get_value_string(gsm0808_cell_id_discr_names, id_discr); }
77 
78 const char *gsm0808_cell_id_name(const struct gsm0808_cell_id *cid);
79 const char *gsm0808_cell_id_name2(const struct gsm0808_cell_id *cid);
80 const char *gsm0808_cell_id_list_name(const struct gsm0808_cell_id_list2 *cil);
81 int gsm0808_cell_id_list_name_buf(char *buf, size_t buflen, const struct gsm0808_cell_id_list2 *cil);
82 int gsm0808_cell_id_u_name(char *buf, size_t buflen,
83  enum CELL_IDENT id_discr, const union gsm0808_cell_id_u *u);
84 bool gsm0808_cell_ids_match(const struct gsm0808_cell_id *id1, const struct gsm0808_cell_id *id2, bool exact_match);
85 int gsm0808_cell_id_matches_list(const struct gsm0808_cell_id *id, const struct gsm0808_cell_id_list2 *list,
86  unsigned int match_nr, bool exact_match);
87 void gsm0808_cell_id_from_cgi(struct gsm0808_cell_id *cid, enum CELL_IDENT id_discr,
88  const struct osmo_cell_global_id *cgi);
89 int gsm0808_cell_id_to_cgi(struct osmo_cell_global_id *cgi, const struct gsm0808_cell_id *cid);
90 
91 uint8_t gsm0808_enc_cause(struct msgb *msg, uint16_t cause);
92 uint8_t gsm0808_enc_aoip_trasp_addr(struct msgb *msg,
93  const struct sockaddr_storage *ss);
94 int gsm0808_dec_aoip_trasp_addr(struct sockaddr_storage *ss,
95  const uint8_t *elem, uint8_t len);
96 
97 uint8_t gsm0808_enc_lcls(struct msgb *msg, const struct osmo_lcls *lcls);
98 int gsm0808_dec_lcls(struct osmo_lcls *lcls, const struct tlv_parsed *tp);
99 
100 uint8_t gsm0808_enc_speech_codec(struct msgb *msg,
101  const struct gsm0808_speech_codec *sc);
103  const uint8_t *elem, uint8_t len);
104 uint8_t gsm0808_enc_speech_codec_list(struct msgb *msg,
105  const struct gsm0808_speech_codec_list
106  *scl);
108  const uint8_t *elem, uint8_t len);
109 uint8_t gsm0808_enc_channel_type(struct msgb *msg,
110  const struct gsm0808_channel_type *ct);
112  const uint8_t *elem, uint8_t len);
113 uint8_t gsm0808_enc_encrypt_info(struct msgb *msg,
114  const struct gsm0808_encrypt_info *ei);
116  const uint8_t *elem, uint8_t len);
117 uint8_t gsm0808_enc_cell_id_list2(struct msgb *msg, const struct gsm0808_cell_id_list2 *cil);
118 uint8_t gsm0808_enc_cell_id_list(struct msgb *msg,
119  const struct gsm0808_cell_id_list *cil)
120  OSMO_DEPRECATED("use gsm0808_enc_cell_id_list2 instead");
121 int gsm0808_dec_cell_id_list2(struct gsm0808_cell_id_list2 *cil, const uint8_t *elem, uint8_t len);
123  const uint8_t *elem, uint8_t len)
124  OSMO_DEPRECATED("use gsm0808_dec_cell_id_list2 instead");
125 int gsm0808_cell_id_list_add(struct gsm0808_cell_id_list2 *dst, const struct gsm0808_cell_id_list2 *src);
126 void gsm0808_cell_id_to_list(struct gsm0808_cell_id_list2 *dst, const struct gsm0808_cell_id *src);
127 uint8_t gsm0808_enc_cell_id(struct msgb *msg, const struct gsm0808_cell_id *ci);
128 int gsm0808_dec_cell_id(struct gsm0808_cell_id *ci, const uint8_t *elem, uint8_t len);
129 int gsm0808_chan_type_to_speech_codec(uint8_t perm_spch);
131  uint8_t perm_spch);
132 uint16_t gsm0808_sc_cfg_from_gsm48_mr_cfg(const struct gsm48_multi_rate_conf *cfg, bool fr);
133 int gsm48_mr_cfg_from_gsm0808_sc_cfg(struct gsm48_multi_rate_conf *cfg, uint16_t s15_s0);
134 
137 {
138  return (cause << 1) >> 4;
139 }
140 
142 static inline bool gsm0808_cause_ext(enum gsm0808_cause cause)
143 {
144  /* check that cause looks like 1XXX0000 where XXX represent class */
145  return (cause & 0x80) && !(cause & 0x0F);
146 }
147 
148 int gsm0808_get_cipher_reject_cause(const struct tlv_parsed *tp);
149 
151 static inline uint8_t gsm0808_current_channel_type_1(enum gsm_chan_t type)
152 {
153  switch (type) {
154  default:
155  return 0;
156  case GSM_LCHAN_SDCCH:
157  return 0x01;
158  case GSM_LCHAN_TCH_F:
159  return 0x18;
160  case GSM_LCHAN_TCH_H:
161  return 0x19;
162  }
163 }
164 
168  enum gsm48_chan_mode mode)
169 {
170  switch (mode) {
172  switch (type) {
173  case GSM_LCHAN_TCH_F:
174  return GSM0808_PERM_FR1;
175  case GSM_LCHAN_TCH_H:
176  return GSM0808_PERM_HR1;
177  default:
178  return 0;
179  }
181  switch (type) {
182  case GSM_LCHAN_TCH_F:
183  return GSM0808_PERM_FR2;
184  case GSM_LCHAN_TCH_H:
185  return GSM0808_PERM_HR2;
186  default:
187  return 0;
188  }
190  switch (type) {
191  case GSM_LCHAN_TCH_F:
192  return GSM0808_PERM_FR3;
193  case GSM_LCHAN_TCH_H:
194  return GSM0808_PERM_HR3;
195  default:
196  return 0;
197  }
198  default:
199  return 0;
200  }
201 }
202 
204 static inline uint8_t gsm0808_chosen_channel(enum gsm_chan_t type, enum gsm48_chan_mode mode)
205 {
206  uint8_t channel_mode = 0, channel = 0;
207 
208  switch (mode) {
212  channel_mode = 0x9;
213  break;
214  case GSM48_CMODE_SIGN:
215  channel_mode = 0x8;
216  break;
218  channel_mode = 0xe;
219  break;
221  channel_mode = 0xb;
222  break;
224  channel_mode = 0xc;
225  break;
227  channel_mode = 0xd;
228  break;
229  default:
230  return 0;
231  }
232 
233  switch (type) {
234  case GSM_LCHAN_NONE:
235  channel = 0x0;
236  break;
237  case GSM_LCHAN_SDCCH:
238  channel = 0x1;
239  break;
240  case GSM_LCHAN_TCH_F:
241  channel = 0x8;
242  break;
243  case GSM_LCHAN_TCH_H:
244  channel = 0x9;
245  break;
246  default:
247  return 0;
248  }
249 
250  return channel_mode << 4 | channel;
251 }
252 
253 const char *gsm0808_channel_type_name(const struct gsm0808_channel_type *ct);
254 
uint8_t gsm0808_enc_speech_codec_list(struct msgb *msg, const struct gsm0808_speech_codec_list *scl)
Encode TS 08.08 Speech Codec list.
Definition: gsm0808_utils.c:366
Definition: gsm_04_08.h:810
uint16_t lac
Definition: gsm0808_utils.h:46
uint8_t type
Definition: gsm_08_08.h:469
unsigned int id_list_len
Definition: gsm0808_utils.h:59
uint8_t gsm0808_enc_cell_id_list2(struct msgb *msg, const struct gsm0808_cell_id_list2 *cil)
Encode TS 08.08 Cell Identifier List IE.
Definition: gsm0808_utils.c:715
#define OSMO_DEPRECATED(text)
static enum gsm0808_permitted_speech gsm0808_permitted_speech(enum gsm_chan_t type, enum gsm48_chan_mode mode)
Return 3GPP TS 48.008 3.2.2.51 Speech Version aka permitted speech version indication in 3...
Definition: gsm0808_utils.h:167
gsm48_chan_mode
Definition: gsm_04_08.h:808
Definition: gsm_04_08.h:816
const char * get_value_string(const struct value_string *vs, uint32_t val)
Parsed representation of a Cell Identifier List IE (3GPP TS 48.008 3.2.2.27).
Definition: gsm0808_utils.h:56
uint8_t gsm0808_enc_encrypt_info(struct msgb *msg, const struct gsm0808_encrypt_info *ei)
Encode TS 08.08 Encryption Information IE.
Definition: gsm0808_utils.c:638
Definition: gsm_04_08.h:809
char * osmo_lcls_dump(const struct osmo_lcls *lcls)
Dump LCLS parameters (GCR excluded) into string for printing.
Definition: gsm0808_utils.c:600
GSM FR.
Definition: gsm_08_08.h:457
gsm0808_cause_class
Definition: gsm_08_08.h:398
Definition: gsm_04_08.h:814
(deprecated)
Definition: gsm_08_08.h:463
write Write running configuration to or terminal n Write configuration to the copy running config startup config
LCLS-related parameters from 3GPP TS 48.008.
Definition: gsm0808_utils.h:63
HR AMR.
Definition: gsm_08_08.h:464
GSM EFR.
Definition: gsm_08_08.h:458
struct osmo_location_area_id lai_and_lac
Definition: gsm0808_utils.h:45
static const char * gsm0808_cell_id_discr_name(enum CELL_IDENT id_discr)
Definition: gsm0808_utils.h:75
gsm0808_lcls_control
Definition: gsm_08_08.h:621
#define GSM0808_CELL_ID_LIST2_MAXLEN
(225-1)/2 is the maximum number of elements in a cell identifier list.
Definition: gsm0808_utils.h:36
int gsm0808_cell_id_list_add(struct gsm0808_cell_id_list2 *dst, const struct gsm0808_cell_id_list2 *src)
Append entries from one Cell Identifier List to another.
Definition: gsm0808_utils.c:1097
int gsm0808_dec_cell_id_list(struct gsm0808_cell_id_list *cil, const uint8_t *elem, uint8_t len) OSMO_DEPRECATED("use gsm0808_dec_cell_id_list2 instead")
DEPRECATED: Use gsm0808_dec_cell_id_list2 instead.
Definition: gsm0808_utils.c:1010
Definition: gsm_utils.h:222
int gsm0808_get_cipher_reject_cause(const struct tlv_parsed *tp)
Definition: gsm0808_utils.c:1449
Instead of this, use either struct gsm0808_cell_id or gsm0808_cell_id_list2.
Definition: gsm0808_utils.h:41
int gsm0808_dec_lcls(struct osmo_lcls *lcls, const struct tlv_parsed *tp)
Decode LCLS parameters to a given msgb, 3GPP TS 48.008 §3.2.2.115 - 3.2.2.120.
Definition: gsm0808_utils.c:583
uint8_t cause
Definition: gsm_04_08.h:823
struct osmo_lac_and_ci_id lac_and_ci
Definition: gsm0808_utils.h:43
uint16_t gsm0808_sc_cfg_from_gsm48_mr_cfg(const struct gsm48_multi_rate_conf *cfg, bool fr)
Determine a set of AMR speech codec configuration bits (S0-S15) from a given GSM 04.08 AMR configuration struct.
Definition: gsm0808_utils.c:1308
uint8_t gsm0808_enc_lcls(struct msgb *msg, const struct osmo_lcls *lcls)
Add LCLS parameters to a given msgb, 3GPP TS 48.008 §3.2.2.115 - 3.2.2.120.
Definition: gsm0808_utils.c:550
const char * gsm0808_cell_id_name(const struct gsm0808_cell_id *cid)
Return a human readable representation of a Cell Identifier, like "LAC:123" or "CGI:001-01-42-23".
Definition: gsm0808_utils.c:1772
char * osmo_gcr_dump(const struct osmo_lcls *lcls)
Dump GCR struct into string for printing.
Definition: gsm0808_utils.c:618
int gsm0808_cell_id_to_cgi(struct osmo_cell_global_id *cgi, const struct gsm0808_cell_id *cid)
Overwrite parts of cgi with values from a Cell Identifier.
Definition: gsm0808_utils.c:1695
int gsm0808_dec_encrypt_info(struct gsm0808_encrypt_info *ei, const uint8_t *elem, uint8_t len)
Decode TS 08.08 Encryption Information IE.
Definition: gsm0808_utils.c:677
int gsm0808_dec_cell_id(struct gsm0808_cell_id *ci, const uint8_t *elem, uint8_t len)
Decode Cell Identifier IE (3GPP TS 48.008 3.2.2.17).
Definition: gsm0808_utils.c:1193
Definition: gsm23003.h:44
static enum gsm0808_cause_class gsm0808_cause_class(enum gsm0808_cause cause)
Definition: gsm0808_utils.h:136
void gsm0808_cell_id_to_list(struct gsm0808_cell_id_list2 *dst, const struct gsm0808_cell_id *src)
Convert a single Cell Identifier to a Cell Identifier List with one entry.
Definition: gsm0808_utils.c:1134
Definition: gsm_04_08.h:815
uint8_t gsm0808_enc_cause(struct msgb *msg, uint16_t cause)
Definition: gsm_utils.h:223
GSM TS 04.08 definitions.
GSM HR.
Definition: gsm_08_08.h:462
Definition: gsm_08_08.h:572
gsm0808_permitted_speech
GSM 08.08 3.2.2.11 Channel Type (see also 3GPP TS 48.008, section 3.2.2.11)
Definition: gsm_08_08.h:456
uint8_t gsm0808_enc_aoip_trasp_addr(struct msgb *msg, const struct sockaddr_storage *ss)
const char * gsm0808_cell_id_name2(const struct gsm0808_cell_id *cid)
Like gsm0808_cell_id_name() but uses a different static buffer.
Definition: gsm0808_utils.c:1782
uint8_t gsm0808_enc_cell_id(struct msgb *msg, const struct gsm0808_cell_id *ci)
Encode Cell Identifier IE (3GPP TS 48.008 3.2.2.17).
Definition: gsm0808_utils.c:1165
Definition: gsm_utils.h:221
void gsm0808_cell_id_from_cgi(struct gsm0808_cell_id *cid, enum CELL_IDENT id_discr, const struct osmo_cell_global_id *cgi)
Copy information from a CGI to form a Cell Identifier of the specified kind.
Definition: gsm0808_utils.c:1647
static bool gsm0808_cause_ext(enum gsm0808_cause cause)
Definition: gsm0808_utils.h:142
struct osmo_cell_global_id global
Definition: gsm0808_utils.h:42
static uint8_t gsm0808_current_channel_type_1(enum gsm_chan_t type)
Definition: gsm0808_utils.h:151
gsm0808_cause
Definition: gsm_08_08.h:331
const struct value_string gsm0808_cell_id_discr_names[]
value_string[] for enum CELL_IDENT.
Definition: gsm0808_utils.c:1730
Definition: gsm23003.h:28
FR AMR.
Definition: gsm_08_08.h:459
int gsm48_mr_cfg_from_gsm0808_sc_cfg(struct gsm48_multi_rate_conf *cfg, uint16_t s15_s0)
Determine a GSM 04.08 AMR configuration struct from a set of speech codec configuration bits (S0-S15)...
Definition: gsm0808_utils.c:1361
Parsed representation of Global Call Reference, 3GPP TS 29.205 Table B 2.1.9.1.
Definition: gsm29205.h:33
uint8_t gsm0808_enc_cell_id_list(struct msgb *msg, const struct gsm0808_cell_id_list *cil) OSMO_DEPRECATED("use gsm0808_enc_cell_id_list2 instead")
DEPRECATED: Use gsm0808_enc_cell_id_list2 instead.
Definition: gsm0808_utils.c:784
int gsm0808_dec_aoip_trasp_addr(struct sockaddr_storage *ss, const uint8_t *elem, uint8_t len)
int gsm0808_speech_codec_from_chan_type(struct gsm0808_speech_codec *sc, uint8_t perm_spch)
Extrapolate a speech codec field from a given permitted speech parameter (channel type)...
Definition: gsm0808_utils.c:1255
Definition: gsm23003.h:16
uint8_t len
Definition: gsm_04_11.h:465
bool gcr_available
Definition: gsm0808_utils.h:67
int gsm0808_cell_id_list_name_buf(char *buf, size_t buflen, const struct gsm0808_cell_id_list2 *cil)
Return a human readable representation of the Cell Identifier List, like "LAC[2]:{123, 456}".
Definition: gsm0808_utils.c:1800
uint8_t gsm0808_enc_channel_type(struct msgb *msg, const struct gsm0808_channel_type *ct)
Encode TS 08.08 Channel Type IE.
Definition: gsm0808_utils.c:436
static uint8_t gsm0808_chosen_channel(enum gsm_chan_t type, enum gsm48_chan_mode mode)
Return 3GPP TS 48.008 3.2.2.33 Chosen Channel.
Definition: gsm0808_utils.h:204
uint8_t mode
Definition: gsm_04_08.h:749
Definition: gsm_04_08.h:813
Definition: gsm_08_08.h:579
Definition: gsm_04_08.h:812
Definition: gsm_utils.h:220
result of the TLV parser
Definition: tlv.h:442
CELL_IDENT
Definition: gsm_08_08.h:16
gsm_chan_t
Definition: gsm_utils.h:219
Definition: gsm_08_08.h:589
Definition: gsm_04_08.h:662
int gsm0808_dec_speech_codec(struct gsm0808_speech_codec *sc, const uint8_t *elem, uint8_t len)
Decode TS 08.08 Speech Codec IE.
Definition: gsm0808_utils.c:286
Parsed representation of Cell Identifier IE (3GPP TS 48.008 3.2.2.17)
Definition: gsm0808_utils.h:50
const char * gsm0808_cell_id_list_name(const struct gsm0808_cell_id_list2 *cil)
Return a human-readable representation of cil in a static buffer.
Definition: gsm0808_utils.c:1831
int gsm0808_dec_speech_codec_list(struct gsm0808_speech_codec_list *scl, const uint8_t *elem, uint8_t len)
Decode TS 08.08 Speech Codec list IE.
Definition: gsm0808_utils.c:399
int gsm0808_dec_cell_id_list2(struct gsm0808_cell_id_list2 *cil, const uint8_t *elem, uint8_t len)
Decode Cell Identifier List IE.
Definition: gsm0808_utils.c:948
int gsm0808_dec_channel_type(struct gsm0808_channel_type *ct, const uint8_t *elem, uint8_t len)
Decode TS 08.08 Channel Type IE.
Definition: gsm0808_utils.c:479
exact_match
bool gsm0808_cell_ids_match(const struct gsm0808_cell_id *id1, const struct gsm0808_cell_id *id2, bool exact_match)
Return true if the common information between the two Cell Identifiers match.
Definition: gsm0808_utils.c:1610
uint8_t gsm0808_enc_speech_codec(struct msgb *msg, const struct gsm0808_speech_codec *sc)
Encode TS 08.08 Speech Codec IE.
Definition: gsm0808_utils.c:261
gsm0808_lcls_config
Definition: gsm_08_08.h:610
int gsm0808_cell_id_matches_list(const struct gsm0808_cell_id *id, const struct gsm0808_cell_id_list2 *list, unsigned int match_nr, bool exact_match)
Find an index in a Cell Identifier list that matches a given single Cell Identifer.
Definition: gsm0808_utils.c:1627
const char * gsm0808_channel_type_name(const struct gsm0808_channel_type *ct)
Definition: gsm0808_utils.c:1841
Definition: gsm_04_08.h:811
uint16_t ci
Definition: gsm0808_utils.h:44
int gsm0808_cell_id_u_name(char *buf, size_t buflen, enum CELL_IDENT id_discr, const union gsm0808_cell_id_u *u)
Print a human readable name of the cell identifier to the char buffer.
Definition: gsm0808_utils.c:1475
GSM utility functions, e.g.
int gsm0808_chan_type_to_speech_codec(uint8_t perm_spch)
Convert the representation of the permitted speech codec identifier that is used in struct gsm0808_ch...
Definition: gsm0808_utils.c:1217
bool corr_needed
§3.2.2.118 Correlation-Not-Needed.
Definition: gsm0808_utils.h:68
DEPRECATED: This definition of the cell identifier list is insufficient.
Definition: gsm_08_08.h:603
Definition: gsm_08_08.h:512