libosmogsm  1.9.0.158-3938d.202402282026
Osmocom GSM library
rsl.h
Go to the documentation of this file.
1 #pragma once
2 
3 #include <stdint.h>
4 #include <osmocom/core/utils.h>
5 #include <osmocom/core/msgb.h>
7 
12 void rsl_init_rll_hdr(struct abis_rsl_rll_hdr *dh, uint8_t msg_type);
13 
14 void rsl_init_cchan_hdr(struct abis_rsl_cchan_hdr *ch, uint8_t msg_type);
15 
16 extern const struct tlv_definition rsl_att_tlvdef;
17 
19 #define rsl_tlv_parse(dec, buf, len) \
20  tlv_parse(dec, &rsl_att_tlvdef, buf, len, 0, 0)
21 
22 extern const struct tlv_definition rsl_ipac_eie_tlvdef;
23 
25 #define rsl_ipac_eie_tlv_parse(dec, buf, len) \
26  tlv_parse(dec, &rsl_ipac_eie_tlvdef, buf, len, 0, 0)
27 
28 /* encode channel number as per Section 9.3.1 */
29 uint8_t rsl_enc_chan_nr(uint8_t type, uint8_t subch, uint8_t timeslot);
30 /* decode channel number as per Section 9.3.1 */
31 int rsl_dec_chan_nr(uint8_t chan_nr, uint8_t *type, uint8_t *subch, uint8_t *timeslot);
32 /* Turns channel number into a string */
33 char *rsl_chan_nr_str_buf(char *buf, size_t buf_len, uint8_t chan_nr);
34 const char *rsl_chan_nr_str(uint8_t chan_nr);
35 char *rsl_chan_nr_str_c(const void *ctx, uint8_t chan_nr);
36 
37 
38 const char *rsl_err_name(uint8_t err);
39 const char *rsl_rlm_cause_name(uint8_t err);
40 const char *rsl_msg_name(uint8_t err);
41 const char *rsl_ipac_msg_name(uint8_t msg_type);
42 const char *rsl_or_ipac_msg_name(uint8_t msg_type);
43 
44 /* Section 3.3.2.3 TS 05.02. I think this looks like a table */
45 int rsl_ccch_conf_to_bs_cc_chans(int ccch_conf);
46 
47 /* Push a RSL RLL header */
48 void rsl_rll_push_hdr(struct msgb *msg, uint8_t msg_type, uint8_t chan_nr,
49  uint8_t link_id, int transparent);
50 
51 /* Push a RSL RLL header with L3_INFO IE */
52 void rsl_rll_push_l3(struct msgb *msg, uint8_t msg_type, uint8_t chan_nr,
53  uint8_t link_id, int transparent);
54 
55 /* Allocate msgb and fill with simple RSL RLL header */
56 struct msgb *rsl_rll_simple(uint8_t msg_type, uint8_t chan_nr,
57  uint8_t link_id, int transparent);
58 
59 extern const struct value_string rsl_act_type_names[];
60 
62 static inline const char *rsl_act_type_name(uint8_t act_type)
63 {
64  return get_value_string(rsl_act_type_names, act_type);
65 }
66 
const char * rsl_ipac_msg_name(uint8_t msg_type)
Get human-readable name of ip.access RSL msg type.
Definition: rsl.c:442
void rsl_rll_push_l3(struct msgb *msg, uint8_t msg_type, uint8_t chan_nr, uint8_t link_id, int transparent)
Wrap msgb in L3 Info IE and push a RSL RLL header.
Definition: rsl.c:548
char * rsl_chan_nr_str_buf(char *buf, size_t buf_len, uint8_t chan_nr)
Get human-readable string for RSL channel number, in caller-provided buffer.
Definition: rsl.c:230
const struct tlv_definition rsl_ipac_eie_tlvdef
TLV parser definitions for IPA embedded IEs.
Definition: rsl.c:596
uint8_t rsl_enc_chan_nr(uint8_t type, uint8_t subch, uint8_t timeslot)
Encode channel number as per Section 9.3.1.
Definition: rsl.c:155
const char * rsl_rlm_cause_name(uint8_t err)
Get human-readable string for RLM cause.
Definition: rsl.c:477
const struct tlv_definition rsl_att_tlvdef
Definition: rsl.c:63
void rsl_init_rll_hdr(struct abis_rsl_rll_hdr *dh, uint8_t msg_type)
Initialize a RSL RLL header.
Definition: rsl.c:44
const char * rsl_chan_nr_str(uint8_t chan_nr)
Get human-readable string for RSL channel number, in static buffer.
Definition: rsl.c:269
void rsl_rll_push_hdr(struct msgb *msg, uint8_t msg_type, uint8_t chan_nr, uint8_t link_id, int transparent)
Push a RSL RLL header onto an existing msgb.
Definition: rsl.c:526
static const char * rsl_act_type_name(uint8_t act_type)
Return a human readable name for GSM 08.58 RSL_ACT_* constants.
Definition: rsl.h:62
char * rsl_chan_nr_str_c(const void *ctx, uint8_t chan_nr)
Get human-readable string for RSL channel number, in dynamically-allocated buffer.
Definition: rsl.c:280
const char * rsl_msg_name(uint8_t err)
Get human-readable string for RSL Message Type.
Definition: rsl.c:405
const char * rsl_err_name(uint8_t err)
Get human-readable name for RSL Error.
Definition: rsl.c:327
void rsl_init_cchan_hdr(struct abis_rsl_cchan_hdr *ch, uint8_t msg_type)
Initialize a RSL Common Channel header.
Definition: rsl.c:55
struct msgb * rsl_rll_simple(uint8_t msg_type, uint8_t chan_nr, uint8_t link_id, int transparent)
Create msgb with RSL RLL header.
Definition: rsl.c:569
int rsl_dec_chan_nr(uint8_t chan_nr, uint8_t *type, uint8_t *subch, uint8_t *timeslot)
Decode RSL channel number.
Definition: rsl.c:188
const struct value_string rsl_act_type_names[]
String names of RSL Channel Activation Types.
Definition: rsl.c:632
const char * rsl_or_ipac_msg_name(uint8_t msg_type)
Get human-readable name of standard or ip.access RSL msg type.
Definition: rsl.c:450
int rsl_ccch_conf_to_bs_cc_chans(int ccch_conf)
Definition: rsl.c:483
const char * get_value_string(const struct value_string *vs, uint32_t val)
uint8_t chan_nr
Definition: gsm_04_08.h:0
uint8_t msg_type
Definition: gsm_04_08.h:2
uint8_t type
Definition: gsm_04_08_gprs.h:7
uint8_t msg[0]
Definition: gsm_08_08.h:8
uint8_t link_id
Definition: gsm_08_08.h:2
GSM Radio Signalling Link messages on the A-bis interface.
uint8_t timeslot
E1 timeslot.
Definition: gsm_12_21.h:2
Definition: gsm_08_58.h:113
Definition: gsm_08_58.h:86
Definition of All 256 IE / TLV.
Definition: tlv.h:527