libosmogsm 0.9.6-23.20170220git32ee5af8.fc42
Osmocom GSM library
Loading...
Searching...
No Matches
LAPDm implementation according to GSM TS 04.06

Files

file  lapdm.h
 
file  lapdm.c
 

Data Structures

struct  lapdm_msg_ctx
 LAPDm message context. More...
 
struct  lapdm_datalink
 LAPDm datalink like TS 04.06 / Section 3.5.2. More...
 
struct  lapdm_entity
 a LAPDm Entity More...
 
struct  lapdm_channel
 the two lapdm_entities that form a GSM logical channel (ACCH + DCCH) More...
 

Macros

#define LAPDM_ENT_F_EMPTY_FRAME   0x0001
 
#define LAPDM_ENT_F_POLLING_ONLY   0x0002
 
#define LAPDm_LPD_NORMAL   0
 
#define LAPDm_LPD_SMSCB   1
 
#define LAPDm_SAPI_NORMAL   0
 
#define LAPDm_SAPI_SMS   3
 
#define LAPDm_ADDR(lpd, sapi, cr)
 
#define LAPDm_ADDR_LPD(addr)
 
#define LAPDm_ADDR_SAPI(addr)
 
#define LAPDm_ADDR_CR(addr)
 
#define LAPDm_ADDR_EA(addr)
 
#define LAPDm_CTRL_I(nr, ns, p)
 
#define LAPDm_CTRL_S(nr, s, p)
 
#define LAPDm_CTRL_U(u, p)
 
#define LAPDm_CTRL_is_I(ctrl)
 
#define LAPDm_CTRL_is_S(ctrl)
 
#define LAPDm_CTRL_is_U(ctrl)
 
#define LAPDm_CTRL_U_BITS(ctrl)
 
#define LAPDm_CTRL_PF_BIT(ctrl)
 
#define LAPDm_CTRL_S_BITS(ctrl)
 
#define LAPDm_CTRL_I_Ns(ctrl)
 
#define LAPDm_CTRL_Nr(ctrl)
 
#define LAPDm_LEN(len)
 
#define LAPDm_MORE   0x2
 
#define LAPDm_EL   0x1
 
#define LAPDm_U_UI   0x0
 
#define N201_AB_SACCH   18
 
#define N201_AB_SDCCH   20
 
#define N201_AB_FACCH   20
 
#define N201_Bbis   23
 
#define N201_Bter_SACCH   21
 
#define N201_Bter_SDCCH   23
 
#define N201_Bter_FACCH   23
 
#define N201_B4   19
 
#define N200_EST_REL   5
 
#define N200_TR_SACCH   5
 
#define N200_TR_SDCCH   23
 
#define N200_TR_FACCH_FR   34
 
#define N200_TR_EFACCH_FR   48
 
#define N200_TR_FACCH_HR   29
 
#define N200   N200_TR_SDCCH
 

Typedefs

typedef int(* lapdm_cb_t) (struct msgb *msg, struct lapdm_entity *le, void *ctx)
 

Enumerations

enum  lapdm_mode { LAPDM_MODE_MS , LAPDM_MODE_BTS }
 LAPDm mode/role. More...
 
enum  lapdm_dl_sapi { DL_SAPI0 = 0 , DL_SAPI3 = 1 , _NR_DL_SAPI }
 LAPDm datalink SAPIs. More...
 
enum  lapdm_format {
  LAPDm_FMT_A , LAPDm_FMT_B , LAPDm_FMT_Bbis , LAPDm_FMT_Bter ,
  LAPDm_FMT_B4
}
 

Functions

const char * get_rsl_name (int value)
 
struct lapdm_datalinklapdm_datalink_for_sapi (struct lapdm_entity *le, uint8_t sapi)
 
void lapdm_entity_init (struct lapdm_entity *le, enum lapdm_mode mode, int t200)
 initialize a LAPDm entity and all datalinks inside
 
void lapdm_channel_init (struct lapdm_channel *lc, enum lapdm_mode mode)
 initialize a LAPDm channel and all its channels
 
void lapdm_entity_exit (struct lapdm_entity *le)
 flush and release all resoures in LAPDm entity
 
void lapdm_channel_exit (struct lapdm_channel *lc)
 
int lapdm_phsap_up (struct osmo_prim_hdr *oph, struct lapdm_entity *le)
 Receive a PH-SAP primitive from L1.
 
int lapdm_rslms_recvmsg (struct msgb *msg, struct lapdm_channel *lc)
 Receive a RSLms msgb from Layer 3.
 
void lapdm_channel_set_l3 (struct lapdm_channel *lc, lapdm_cb_t cb, void *ctx)
 Set the L3 callback and context of a LAPDm channel.
 
void lapdm_channel_set_l1 (struct lapdm_channel *lc, osmo_prim_cb cb, void *ctx)
 Set the L1 callback and context of a LAPDm channel.
 
int lapdm_entity_set_mode (struct lapdm_entity *le, enum lapdm_mode mode)
 Set the lapdm_mode of a LAPDm entity.
 
int lapdm_channel_set_mode (struct lapdm_channel *lc, enum lapdm_mode mode)
 Set the lapdm_mode of a LAPDm channel.
 
void lapdm_entity_reset (struct lapdm_entity *le)
 Reset an entire LAPDm entity and all its datalinks.
 
void lapdm_channel_reset (struct lapdm_channel *lc)
 Reset a LAPDm channel with all its entities.
 
void lapdm_entity_set_flags (struct lapdm_entity *le, unsigned int flags)
 Set the flags of a LAPDm entity.
 
void lapdm_channel_set_flags (struct lapdm_channel *lc, unsigned int flags)
 Set the flags of all LAPDm entities in a LAPDm channel.
 
int lapdm_phsap_dequeue_prim (struct lapdm_entity *le, struct osmo_phsap_prim *pp)
 dequeue a msg that's pending transmission via L1 and wrap it into a osmo_phsap_prim
 
static int lapdm_send_ph_data_req (struct lapd_msg_ctx *lctx, struct msgb *msg)
 
static int send_rslms_dlsap (struct osmo_dlsap_prim *dp, struct lapd_msg_ctx *lctx)
 
static int update_pending_frames (struct lapd_msg_ctx *lctx)
 
static void lapdm_dl_init (struct lapdm_datalink *dl, struct lapdm_entity *entity, int t200)
 
static void lapdm_pad_msgb (struct msgb *msg, uint8_t n201)
 
static int rslms_sendmsg (struct msgb *msg, struct lapdm_entity *le)
 
static int tx_ph_data_enqueue (struct lapdm_datalink *dl, struct msgb *msg, uint8_t chan_nr, uint8_t link_id, uint8_t pad)
 
static struct msgb * tx_dequeue_msgb (struct lapdm_entity *le)
 
static int l2_ph_data_conf (struct msgb *msg, struct lapdm_entity *le)
 
static int send_rslms_rll_l3 (uint8_t msg_type, struct lapdm_msg_ctx *mctx, struct msgb *msg)
 
static int send_rslms_rll_l3_ui (struct lapdm_msg_ctx *mctx, struct msgb *msg)
 
static int send_rll_simple (uint8_t msg_type, struct lapdm_msg_ctx *mctx)
 
static int rsl_rll_error (uint8_t cause, struct lapdm_msg_ctx *mctx)
 
static int l2_ph_data_ind (struct msgb *msg, struct lapdm_entity *le, uint8_t chan_nr, uint8_t link_id)
 
static int l2_ph_rach_ind (struct lapdm_entity *le, uint8_t ra, uint32_t fn, uint8_t acc_delay)
 
static int l2_ph_chan_conf (struct msgb *msg, struct lapdm_entity *le, uint32_t frame_nr)
 
static int set_lapdm_context (struct lapdm_datalink *dl, uint8_t chan_nr, uint8_t link_id, int n201, uint8_t sapi)
 
static int rslms_rx_rll_est_req (struct msgb *msg, struct lapdm_datalink *dl)
 
static int rslms_rx_rll_udata_req (struct msgb *msg, struct lapdm_datalink *dl)
 
static int rslms_rx_rll_data_req (struct msgb *msg, struct lapdm_datalink *dl)
 
static int rslms_rx_rll_susp_req (struct msgb *msg, struct lapdm_datalink *dl)
 
static int rslms_rx_rll_res_req (struct msgb *msg, struct lapdm_datalink *dl)
 
static int rslms_rx_rll_rel_req (struct msgb *msg, struct lapdm_datalink *dl)
 
static int rslms_rx_chan_rqd (struct lapdm_channel *lc, struct msgb *msg)
 
static int rslms_rx_rll (struct msgb *msg, struct lapdm_channel *lc)
 
static int rslms_rx_com_chan (struct msgb *msg, struct lapdm_channel *lc)
 

Variables

const char * lapdm_state_names []
 
const struct value_string osmo_ph_prim_names []
 

Detailed Description

Macro Definition Documentation

◆ LAPDm_ADDR

#define LAPDm_ADDR ( lpd,
sapi,
cr )
Value:
((((lpd) & 0x3) << 5) | (((sapi) & 0x7) << 2) | (((cr) & 0x1) << 1) | 0x1)

◆ LAPDm_ADDR_CR

#define LAPDm_ADDR_CR ( addr)
Value:
(((addr) >> 1) & 0x1)

◆ LAPDm_ADDR_EA

#define LAPDm_ADDR_EA ( addr)
Value:
((addr) & 0x1)

◆ LAPDm_ADDR_LPD

#define LAPDm_ADDR_LPD ( addr)
Value:
(((addr) >> 5) & 0x3)

◆ LAPDm_ADDR_SAPI

#define LAPDm_ADDR_SAPI ( addr)
Value:
(((addr) >> 2) & 0x7)

◆ LAPDm_CTRL_I

#define LAPDm_CTRL_I ( nr,
ns,
p )
Value:
((((nr) & 0x7) << 5) | (((p) & 0x1) << 4) | (((ns) & 0x7) << 1))

◆ LAPDm_CTRL_I_Ns

#define LAPDm_CTRL_I_Ns ( ctrl)
Value:
(((ctrl) & 0xE) >> 1)

◆ LAPDm_CTRL_is_I

#define LAPDm_CTRL_is_I ( ctrl)
Value:
(((ctrl) & 0x1) == 0)

◆ LAPDm_CTRL_is_S

#define LAPDm_CTRL_is_S ( ctrl)
Value:
(((ctrl) & 0x3) == 1)

◆ LAPDm_CTRL_is_U

#define LAPDm_CTRL_is_U ( ctrl)
Value:
(((ctrl) & 0x3) == 3)

◆ LAPDm_CTRL_Nr

#define LAPDm_CTRL_Nr ( ctrl)
Value:
(((ctrl) & 0xE0) >> 5)

◆ LAPDm_CTRL_PF_BIT

#define LAPDm_CTRL_PF_BIT ( ctrl)
Value:
(((ctrl) >> 4) & 0x1)

◆ LAPDm_CTRL_S

#define LAPDm_CTRL_S ( nr,
s,
p )
Value:
((((nr) & 0x7) << 5) | (((p) & 0x1) << 4) | (((s) & 0x3) << 2) | 0x1)

◆ LAPDm_CTRL_S_BITS

#define LAPDm_CTRL_S_BITS ( ctrl)
Value:
(((ctrl) & 0xC) >> 2)

◆ LAPDm_CTRL_U

#define LAPDm_CTRL_U ( u,
p )
Value:
((((u) & 0x1c) << (5-2)) | (((p) & 0x1) << 4) | (((u) & 0x3) << 2) | 0x3)

◆ LAPDm_CTRL_U_BITS

#define LAPDm_CTRL_U_BITS ( ctrl)
Value:
((((ctrl) & 0xC) >> 2) | ((ctrl) & 0xE0) >> 3)

◆ LAPDm_LEN

#define LAPDm_LEN ( len)
Value:
((len << 2) | 0x1)

Enumeration Type Documentation

◆ lapdm_dl_sapi

LAPDm datalink SAPIs.

Enumerator
DL_SAPI0 

SAPI 0.

DL_SAPI3 

SAPI 1.

◆ lapdm_mode

enum lapdm_mode

LAPDm mode/role.

Enumerator
LAPDM_MODE_MS 

behave like a MS (mobile phone)

LAPDM_MODE_BTS 

behave like a BTS (network)

Function Documentation

◆ lapdm_channel_init()

void lapdm_channel_init ( struct lapdm_channel * lc,
enum lapdm_mode mode )

initialize a LAPDm channel and all its channels

Parameters
[in]lclapdm_channel to be initialized
[in]modelapdm_mode (BTS/MS)

This really is a convenience wrapper around calling lapdm_entity_init twice.

References lapdm_channel::lapdm_acch, lapdm_channel::lapdm_dcch, and lapdm_entity_init().

◆ lapdm_entity_init()

void lapdm_entity_init ( struct lapdm_entity * le,
enum lapdm_mode mode,
int t200 )

initialize a LAPDm entity and all datalinks inside

Parameters
[in]leLAPDm entity
[in]modelapdm_mode (BTS/MS)

References lapdm_entity::datalink, and lapdm_entity_set_mode().

Referenced by lapdm_channel_init().

Variable Documentation

◆ osmo_ph_prim_names

const struct value_string osmo_ph_prim_names[]
Initial value:
= {
{ PRIM_PH_DATA, "PH-DATA" },
{ PRIM_PH_RACH, "PH-RANDOM_ACCESS" },
{ PRIM_PH_CONN, "PH-CONNECT" },
{ PRIM_PH_EMPTY_FRAME, "PH-EMPTY_FRAME" },
{ PRIM_PH_RTS, "PH-RTS" },
{ PRIM_MPH_INFO, "MPH-INFO" },
{ PRIM_TCH, "TCH" },
{ PRIM_TCH_RTS, "TCH-RTS" },
{ 0, NULL }
}