libosmogsm 1.13.1.1-afb4 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>
6#include <osmocom/gsm/protocol/gsm_08_58.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 */
29uint8_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
rsl_ipac_msg_name
const char * rsl_ipac_msg_name(uint8_t msg_type)
Get human-readable name of ip.access RSL msg type.
Definition: rsl.c:444
rsl_rll_push_l3
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:550
rsl_chan_nr_str_buf
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:232
rsl_ipac_eie_tlvdef
const struct tlv_definition rsl_ipac_eie_tlvdef
TLV parser definitions for IPA embedded IEs.
Definition: rsl.c:598
rsl_enc_chan_nr
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:157
rsl_rlm_cause_name
const char * rsl_rlm_cause_name(uint8_t err)
Get human-readable string for RLM cause.
Definition: rsl.c:479
rsl_att_tlvdef
const struct tlv_definition rsl_att_tlvdef
Definition: rsl.c:63
rsl_init_rll_hdr
void rsl_init_rll_hdr(struct abis_rsl_rll_hdr *dh, uint8_t msg_type)
Initialize a RSL RLL header.
Definition: rsl.c:44
rsl_chan_nr_str
const char * rsl_chan_nr_str(uint8_t chan_nr)
Get human-readable string for RSL channel number, in static buffer.
Definition: rsl.c:271
rsl_rll_push_hdr
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:528
rsl_chan_nr_str_c
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:282
rsl_msg_name
const char * rsl_msg_name(uint8_t err)
Get human-readable string for RSL Message Type.
Definition: rsl.c:407
rsl_err_name
const char * rsl_err_name(uint8_t err)
Get human-readable name for RSL Error.
Definition: rsl.c:329
rsl_init_cchan_hdr
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
rsl_rll_simple
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:571
rsl_dec_chan_nr
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:190
rsl_act_type_names
const struct value_string rsl_act_type_names[]
String names of RSL Channel Activation Types.
Definition: rsl.c:634
rsl_or_ipac_msg_name
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:452
rsl_act_type_name
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
rsl_ccch_conf_to_bs_cc_chans
int rsl_ccch_conf_to_bs_cc_chans(int ccch_conf)
Definition: rsl.c:485
get_value_string
const char * get_value_string(const struct value_string *vs, uint32_t val)
chan_nr
uint8_t chan_nr
Definition: gsm_04_08.h:0
msg_type
uint8_t msg_type
Definition: gsm_04_08.h:2
type
uint8_t type
Definition: gsm_04_08_gprs.h:7
msg
uint8_t msg[0]
Definition: gsm_08_08.h:8
link_id
uint8_t link_id
Definition: gsm_08_08.h:2
gsm_08_58.h
GSM Radio Signalling Link messages on the A-bis interface.
timeslot
uint8_t timeslot
E1 timeslot.
Definition: gsm_12_21.h:2
msgb.h
abis_rsl_cchan_hdr
Definition: gsm_08_58.h:113
abis_rsl_rll_hdr
Definition: gsm_08_58.h:86
msgb
tlv_definition
Definition of All 256 IE / TLV.
Definition: tlv.h:527
value_string
utils.h