libosmocore  0.12.0
Osmocom core library
gsmtap_util.h
Go to the documentation of this file.
1 #pragma once
2 
3 #include <stdint.h>
5 #include <osmocom/core/select.h>
6 
11 uint8_t chantype_rsl2gsmtap(uint8_t rsl_chantype, uint8_t rsl_link_id);
12 void chantype_gsmtap2rsl(uint8_t gsmtap_chantype, uint8_t *rsl_chantype, uint8_t *link_id);
13 
14 struct msgb *gsmtap_makemsg_ex(uint8_t type, uint16_t arfcn, uint8_t ts, uint8_t chan_type,
15  uint8_t ss, uint32_t fn, int8_t signal_dbm,
16  uint8_t snr, const uint8_t *data, unsigned int len);
17 
18 struct msgb *gsmtap_makemsg(uint16_t arfcn, uint8_t ts, uint8_t chan_type,
19  uint8_t ss, uint32_t fn, int8_t signal_dbm,
20  uint8_t snr, const uint8_t *data, unsigned int len);
21 
23 struct gsmtap_inst {
25  struct osmo_wqueue wq;
26  struct osmo_fd sink_ofd;
27 };
28 
32 static inline int gsmtap_inst_fd(struct gsmtap_inst *gti)
33 {
34  return gti->wq.bfd.fd;
35 }
36 
37 int gsmtap_source_init_fd(const char *host, uint16_t port);
38 
39 int gsmtap_source_add_sink_fd(int gsmtap_fd);
40 
41 struct gsmtap_inst *gsmtap_source_init(const char *host, uint16_t port,
42  int ofd_wq_mode);
43 
44 int gsmtap_source_add_sink(struct gsmtap_inst *gti);
45 
46 int gsmtap_sendmsg(struct gsmtap_inst *gti, struct msgb *msg);
47 
48 int gsmtap_send_ex(struct gsmtap_inst *gti, uint8_t type, uint16_t arfcn, uint8_t ts,
49  uint8_t chan_type, uint8_t ss, uint32_t fn,
50  int8_t signal_dbm, uint8_t snr, const uint8_t *data,
51  unsigned int len);
52 
53 int gsmtap_send(struct gsmtap_inst *gti, uint16_t arfcn, uint8_t ts,
54  uint8_t chan_type, uint8_t ss, uint32_t fn,
55  int8_t signal_dbm, uint8_t snr, const uint8_t *data,
56  unsigned int len);
57 
58 extern const struct value_string gsmtap_gsm_channel_names[];
59 extern const struct value_string gsmtap_type_names[];
60 
gsmtap_inst::ofd_wq_mode
int ofd_wq_mode
wait queue mode?
Definition: gsmtap_util.h:24
gsmtap_send_ex
int gsmtap_send_ex(struct gsmtap_inst *gti, uint8_t type, uint16_t arfcn, uint8_t ts, uint8_t chan_type, uint8_t ss, uint32_t fn, int8_t signal_dbm, uint8_t snr, const uint8_t *data, unsigned int len)
send an arbitrary type through GSMTAP.
Definition: gsmtap_util.c:300
ts
struct @5 ts
write_queue.h
msgb::data
unsigned char * data
start of message in buffer
Definition: msgb.h:59
gsmtap_source_init_fd
int gsmtap_source_init_fd(const char *host, uint16_t port)
Create a new (sending) GSMTAP source socket.
Definition: gsmtap_util.c:222
gsmtap_source_add_sink_fd
int gsmtap_source_add_sink_fd(int gsmtap_fd)
Add a local sink to an existing GSMTAP source and return fd.
Definition: gsmtap_util.c:245
gsmtap_source_init
struct gsmtap_inst * gsmtap_source_init(const char *host, uint16_t port, int ofd_wq_mode)
Open GSMTAP source socket, connect and register osmo_fd.
Definition: gsmtap_util.c:420
chantype_rsl2gsmtap
uint8_t chantype_rsl2gsmtap(uint8_t rsl_chantype, uint8_t rsl_link_id)
convert RSL channel number to GSMTAP channel type
Definition: gsmtap_util.c:59
signal_dbm
int8_t signal_dbm
signal level in dBm
Definition: gsmtap.h:6
gsmtap_inst::sink_ofd
struct osmo_fd sink_ofd
file descriptor
Definition: gsmtap_util.h:26
msgb::len
uint16_t len
length of bytes used in msgb
Definition: msgb.h:55
gsmtap_type_names
const struct value_string gsmtap_type_names[]
Definition: gsmtap_util.c:477
msgb
Osmocom message buffer.
Definition: msgb.h:35
gsmtap_inst
one gsmtap instance
Definition: gsmtap_util.h:23
gsmtap_send
int gsmtap_send(struct gsmtap_inst *gti, uint16_t arfcn, uint8_t ts, uint8_t chan_type, uint8_t ss, uint32_t fn, int8_t signal_dbm, uint8_t snr, const uint8_t *data, unsigned int len)
send a message from L1/L2 through GSMTAP.
Definition: gsmtap_util.c:325
osmo_wqueue
write queue instance
Definition: write_queue.h:34
gsmtap_source_add_sink
int gsmtap_source_add_sink(struct gsmtap_inst *gti)
Add a local sink to an existing GSMTAP source and return fd.
Definition: gsmtap_util.c:383
gsmtap_makemsg_ex
struct msgb * gsmtap_makemsg_ex(uint8_t type, uint16_t arfcn, uint8_t ts, uint8_t chan_type, uint8_t ss, uint32_t fn, int8_t signal_dbm, uint8_t snr, const uint8_t *data, unsigned int len)
create an arbitrary type GSMTAP message
Definition: gsmtap_util.c:152
gsmtap_sendmsg
int gsmtap_sendmsg(struct gsmtap_inst *gti, struct msgb *msg)
Send a Message buffers through a GSMTAP source.
Definition: gsmtap_util.c:273
gsmtap_inst::wq
struct osmo_wqueue wq
the wait queue
Definition: gsmtap_util.h:25
chantype_gsmtap2rsl
void chantype_gsmtap2rsl(uint8_t gsmtap_chantype, uint8_t *rsl_chantype, uint8_t *link_id)
convert GSMTAP channel type to RSL channel number + Link ID
Definition: gsmtap_util.c:102
value_string
A mapping between human-readable string and numeric value.
Definition: utils.h:38
type
uint8_t type
see GSMTAP_TYPE_*
Definition: gsmtap.h:2
osmo_wqueue::bfd
struct osmo_fd bfd
osmocom file descriptor
Definition: write_queue.h:36
gsmtap_gsm_channel_names
const struct value_string gsmtap_gsm_channel_names[]
Definition: gsmtap_util.c:451
select.h
osmo_fd
Structure representing a file dsecriptor.
Definition: select.h:23
gsmtap_inst_fd
static int gsmtap_inst_fd(struct gsmtap_inst *gti)
obtain the file descriptor associated with a gsmtap instance
Definition: gsmtap_util.h:32
arfcn
uint16_t arfcn
ARFCN (frequency)
Definition: gsmtap.h:5
gsmtap_makemsg
struct msgb * gsmtap_makemsg(uint16_t arfcn, uint8_t ts, uint8_t chan_type, uint8_t ss, uint32_t fn, int8_t signal_dbm, uint8_t snr, const uint8_t *data, unsigned int len)
create L1/L2 data and put it into GSMTAP
Definition: gsmtap_util.c:199
osmo_fd::fd
int fd
actual operating-system level file decriptor
Definition: select.h:27