libosmogsm  1.1.0
Osmocom GSM library
gsm48_ie.h
Go to the documentation of this file.
1 
3 #pragma once
4 
5 #include <stdint.h>
6 #include <string.h>
7 #include <errno.h>
8 
9 #include <osmocom/core/msgb.h>
10 #include <osmocom/gsm/tlv.h>
11 #include <osmocom/gsm/mncc.h>
13 
14 /* decode a 'called/calling/connect party BCD number' as in 10.5.4.7 */
15 int gsm48_decode_bcd_number(char *output, int output_len,
16  const uint8_t *bcd_lv, int h_len)
17  OSMO_DEPRECATED("Use gsm48_decode_bcd_number2() for improved bounds checking");
18 int gsm48_decode_bcd_number2(char *output, size_t output_len,
19  const uint8_t *bcd_lv, size_t input_len,
20  size_t h_len);
21 
22 /* convert a ASCII phone number to 'called/calling/connect party BCD number' */
23 int gsm48_encode_bcd_number(uint8_t *bcd_lv, uint8_t max_len,
24  int h_len, const char *input);
25 /* decode 'bearer capability' */
27  const uint8_t *lv);
28 /* encode 'bearer capability' */
29 int gsm48_encode_bearer_cap(struct msgb *msg, int lv_only,
30  const struct gsm_mncc_bearer_cap *bcap);
31 /* decode 'call control cap' */
32 int gsm48_decode_cccap(struct gsm_mncc_cccap *ccap, const uint8_t *lv);
33 /* encode 'call control cap' */
34 int gsm48_encode_cccap(struct msgb *msg,
35  const struct gsm_mncc_cccap *ccap);
36 /* decode 'called party BCD number' */
37 int gsm48_decode_called(struct gsm_mncc_number *called,
38  const uint8_t *lv);
39 /* encode 'called party BCD number' */
40 int gsm48_encode_called(struct msgb *msg,
41  const struct gsm_mncc_number *called);
42 /* decode callerid of various IEs */
43 int gsm48_decode_callerid(struct gsm_mncc_number *callerid,
44  const uint8_t *lv);
45 /* encode callerid of various IEs */
46 int gsm48_encode_callerid(struct msgb *msg, int ie, int max_len,
47  const struct gsm_mncc_number *callerid);
48 /* decode 'cause' */
50  const uint8_t *lv);
51 /* encode 'cause' */
52 int gsm48_encode_cause(struct msgb *msg, int lv_only,
53  const struct gsm_mncc_cause *cause);
54 /* decode 'calling number' */
55 int gsm48_decode_calling(struct gsm_mncc_number *calling,
56  const uint8_t *lv);
57 /* encode 'calling number' */
58 int gsm48_encode_calling(struct msgb *msg,
59  const struct gsm_mncc_number *calling);
60 /* decode 'connected number' */
61 int gsm48_decode_connected(struct gsm_mncc_number *connected,
62  const uint8_t *lv);
63 /* encode 'connected number' */
64 int gsm48_encode_connected(struct msgb *msg,
65  const struct gsm_mncc_number *connected);
66 /* decode 'redirecting number' */
67 int gsm48_decode_redirecting(struct gsm_mncc_number *redirecting,
68  const uint8_t *lv);
69 /* encode 'redirecting number' */
70 int gsm48_encode_redirecting(struct msgb *msg,
71  const struct gsm_mncc_number *redirecting);
72 /* decode 'facility' */
73 int gsm48_decode_facility(struct gsm_mncc_facility *facility,
74  const uint8_t *lv);
75 /* encode 'facility' */
76 int gsm48_encode_facility(struct msgb *msg, int lv_only,
77  const struct gsm_mncc_facility *facility);
78 /* decode 'notify' */
79 int gsm48_decode_notify(int *notify, const uint8_t *v);
80 /* encode 'notify' */
81 int gsm48_encode_notify(struct msgb *msg, int notify);
82 /* decode 'signal' */
83 int gsm48_decode_signal(int *signal, const uint8_t *v);
84 /* encode 'signal' */
85 int gsm48_encode_signal(struct msgb *msg, int signal);
86 /* decode 'keypad' */
87 int gsm48_decode_keypad(int *keypad, const uint8_t *lv);
88 /* encode 'keypad' */
89 int gsm48_encode_keypad(struct msgb *msg, int keypad);
90 /* decode 'progress' */
91 int gsm48_decode_progress(struct gsm_mncc_progress *progress,
92  const uint8_t *lv);
93 /* encode 'progress' */
94 int gsm48_encode_progress(struct msgb *msg, int lv_only,
95  const struct gsm_mncc_progress *p);
96 /* decode 'user-user' */
98  const uint8_t *lv);
99 /* encode 'useruser' */
100 int gsm48_encode_useruser(struct msgb *msg, int lv_only,
101  const struct gsm_mncc_useruser *uu);
102 /* decode 'ss version' */
104  const uint8_t *lv);
105 /* encode 'ss version' */
106 int gsm48_encode_ssversion(struct msgb *msg,
107  const struct gsm_mncc_ssversion *ssv);
108 /* decode 'more data' does not require a function, because it has no value */
109 /* encode 'more data' */
110 int gsm48_encode_more(struct msgb *msg);
111 
112 /* structure of one frequency */
114  /* if the frequency included in the sysinfo */
115  uint8_t mask;
116 };
117 
118 /* decode "Cell Channel Description" (10.5.2.1b) and other frequency lists */
119 int gsm48_decode_freq_list(struct gsm_sysinfo_freq *f, uint8_t *cd,
120  uint8_t len, uint8_t mask, uint8_t frqt);
int gsm48_decode_redirecting(struct gsm_mncc_number *redirecting, const uint8_t *lv)
Decode TS 04.08 Redirecting Number IE (10.5.4.21b)
Definition: gsm48_ie.c:600
#define OSMO_DEPRECATED(text)
Definition: mncc.h:67
Definition: mncc.h:56
int gsm48_encode_facility(struct msgb *msg, int lv_only, const struct gsm_mncc_facility *facility)
Encode TS 04.08 Facility IE (10.5.4.15)
Definition: gsm48_ie.c:632
int gsm48_encode_keypad(struct msgb *msg, int keypad)
Encode TS 04.08 Keypad IE (10.5.4.17)
Definition: gsm48_ie.c:696
Definition: mncc.h:41
uint8_t cause
Definition: gsm_04_08.h:825
int gsm48_decode_connected(struct gsm_mncc_number *connected, const uint8_t *lv)
Decode TS 04.08 Connected Number IE (10.5.4.13)
Definition: gsm48_ie.c:586
int gsm48_encode_signal(struct msgb *msg, int signal)
Encode TS 04.08 Signal IE (10.5.4.23)
Definition: gsm48_ie.c:675
int gsm48_decode_notify(int *notify, const uint8_t *v)
Decode TS 04.08 Notify IE (10.5.4.20)
Definition: gsm48_ie.c:651
int gsm48_encode_notify(struct msgb *msg, int notify)
Encode TS 04.08 Notify IE (10.5.4.20)
Definition: gsm48_ie.c:659
int gsm48_encode_useruser(struct msgb *msg, int lv_only, const struct gsm_mncc_useruser *uu)
Encode TS 04.08 User-User IE (10.5.4.25)
Definition: gsm48_ie.c:763
int gsm48_encode_more(struct msgb *msg)
Encode TS 04.08 More Data IE (10.5.4.19)
Definition: gsm48_ie.c:816
int gsm48_decode_ssversion(struct gsm_mncc_ssversion *ssv, const uint8_t *lv)
Decode TS 04.08 SS Version IE (10.5.4.24)
Definition: gsm48_ie.c:783
int gsm48_encode_cccap(struct msgb *msg, const struct gsm_mncc_cccap *ccap)
Encodoe TS 04.08 Call Control Capabilities (10.5.4.5a)
Definition: gsm48_ie.c:351
int gsm48_encode_connected(struct msgb *msg, const struct gsm_mncc_number *connected)
Encode TS 04.08 Connected Number IE (10.5.4.13)
Definition: gsm48_ie.c:593
GSM TS 04.08 definitions.
int gsm48_encode_bcd_number(uint8_t *bcd_lv, uint8_t max_len, int h_len, const char *input)
convert a ASCII phone number to &#39;called/calling/connect party BCD number&#39;
Definition: gsm48_ie.c:126
int gsm48_encode_called(struct msgb *msg, const struct gsm_mncc_number *called)
Encode TS 04.08 Called Party IE (10.5.4.7)
Definition: gsm48_ie.c:394
int gsm48_encode_cause(struct msgb *msg, int lv_only, const struct gsm_mncc_cause *cause)
Encode TS 04.08 Cause IE (10.5.4.11)
Definition: gsm48_ie.c:532
int gsm48_decode_calling(struct gsm_mncc_number *calling, const uint8_t *lv)
Decode TS 04.08 Calling Number IE (10.5.4.9)
Definition: gsm48_ie.c:572
Definition: mncc.h:72
int gsm48_decode_bcd_number2(char *output, size_t output_len, const uint8_t *bcd_lv, size_t input_len, size_t h_len)
Decode a &#39;called/calling/connect party BCD number&#39; as in 10.5.4.7.
Definition: gsm48_ie.c:73
int gsm48_encode_bearer_cap(struct msgb *msg, int lv_only, const struct gsm_mncc_bearer_cap *bcap)
Encode TS 04.08 Bearer Capability IE (10.5.4.5)
Definition: gsm48_ie.c:275
Definition: mncc.h:33
int gsm48_decode_keypad(int *keypad, const uint8_t *lv)
Decode TS 04.08 Keypad IE (10.5.4.17)
Definition: gsm48_ie.c:683
uint8_t mask
Definition: gsm48_ie.h:115
uint8_t len
Definition: gsm_04_11.h:465
Definition: mncc.h:51
int gsm48_encode_calling(struct msgb *msg, const struct gsm_mncc_number *calling)
Encode TS 04.08 Calling Number IE (10.5.4.9)
Definition: gsm48_ie.c:579
int gsm48_encode_progress(struct msgb *msg, int lv_only, const struct gsm_mncc_progress *p)
Encode TS 04.08 Progress IE (10.5.4.21)
Definition: gsm48_ie.c:720
int gsm48_decode_bcd_number(char *output, int output_len, const uint8_t *bcd_lv, int h_len) OSMO_DEPRECATED("Use gsm48_decode_bcd_number2() for improved bounds checking")
Like gsm48_decode_bcd_number2() but with less airtight bounds checking.
Definition: gsm48_ie.c:54
int gsm48_encode_redirecting(struct msgb *msg, const struct gsm_mncc_number *redirecting)
Encode TS 04.08 Redirecting Number IE (10.5.4.21b)
Definition: gsm48_ie.c:607
int gsm48_decode_cause(struct gsm_mncc_cause *cause, const uint8_t *lv)
Decode TS 04.08 Cause IE (10.5.4.11)
Definition: gsm48_ie.c:485
Definition: mncc.h:12
int gsm48_decode_signal(int *signal, const uint8_t *v)
Decode TS 04.08 Signal IE (10.5.4.23)
Definition: gsm48_ie.c:667
int gsm48_encode_callerid(struct msgb *msg, int ie, int max_len, const struct gsm_mncc_number *callerid)
Encode TS 04.08 Caller ID IE.
Definition: gsm48_ie.c:451
int gsm48_decode_useruser(struct gsm_mncc_useruser *uu, const uint8_t *lv)
Decode TS 04.08 User-User IE (10.5.4.25)
Definition: gsm48_ie.c:737
int gsm48_decode_progress(struct gsm_mncc_progress *progress, const uint8_t *lv)
Decode TS 04.08 Progress IE (10.5.4.21)
Definition: gsm48_ie.c:704
int gsm48_decode_bearer_cap(struct gsm_mncc_bearer_cap *bcap, const uint8_t *lv)
Decode TS 04.08 Bearer Capability IE (10.5.4.5)
Definition: gsm48_ie.c:162
int gsm48_decode_called(struct gsm_mncc_number *called, const uint8_t *lv)
Decode TS 04.08 Called Party BCD Number IE (10.5.4.7)
Definition: gsm48_ie.c:372
int gsm48_decode_cccap(struct gsm_mncc_cccap *ccap, const uint8_t *lv)
Decode TS 04.08 Call Control Capabilities IE (10.5.4.5a)
Definition: gsm48_ie.c:333
Definition: gsm48_ie.h:113
int gsm48_decode_facility(struct gsm_mncc_facility *facility, const uint8_t *lv)
Decode TS 04.08 Facility IE (10.5.4.15)
Definition: gsm48_ie.c:614
int gsm48_decode_freq_list(struct gsm_sysinfo_freq *f, uint8_t *cd, uint8_t len, uint8_t mask, uint8_t frqt)
Decode TS 04.08 Cell Channel Description IE (10.5.2.1b) and other frequency lists.
Definition: gsm48_ie.c:843
int gsm48_decode_callerid(struct gsm_mncc_number *callerid, const uint8_t *lv)
Decode TS 04.08 Caller ID.
Definition: gsm48_ie.c:419
Definition: mncc.h:62
int gsm48_encode_ssversion(struct msgb *msg, const struct gsm_mncc_ssversion *ssv)
Encode TS 04.08 SS Version IE (10.5.4.24)
Definition: gsm48_ie.c:798