lapdm.h

Go to the documentation of this file.

#pragma once
 
#include <osmocom/gsm/l1sap.h>
#include <osmocom/gsm/gsm_utils.h>
#include <osmocom/gsm/lapd_core.h>
 
enum lapdm_mode {
        LAPDM_MODE_MS,          
        LAPDM_MODE_BTS,         
};
 
struct lapdm_entity;
 
struct lapdm_msg_ctx {
        struct lapdm_datalink *dl;
        int lapdm_fmt;
        uint8_t chan_nr;
        uint8_t link_id;
        uint8_t ta_ind;         /* TA indicated by network */
        uint8_t tx_power_ind;   /* MS power indicated by network */
        uint32_t fn;
};
 
struct lapdm_datalink {
        struct lapd_datalink dl; /* common LAPD */
        struct lapdm_msg_ctx mctx; 
        struct lapdm_entity *entity; 
        struct llist_head tx_ui_queue; 
        uint32_t t200_fn;       
        uint32_t t200_timeout;  
};
 
enum lapdm_dl_sapi {
        DL_SAPI0        = 0,    
        DL_SAPI3        = 1,    
        _NR_DL_SAPI
};
 
typedef int (*lapdm_cb_t)(struct msgb *msg, struct lapdm_entity *le, void *ctx);
 
#define LAPDM_ENT_F_EMPTY_FRAME         0x0001
#define LAPDM_ENT_F_POLLING_ONLY        0x0002
#define LAPDM_ENT_F_DROP_2ND_REJ        0x0004
#define LAPDM_ENT_F_RTS                 0x0008
 
struct lapdm_entity {
        struct lapdm_datalink datalink[_NR_DL_SAPI];
        int last_tx_dequeue; 
        int tx_pending; 
        enum lapdm_mode mode; 
        unsigned int flags;
 
        void *l1_ctx;   
        void *l3_ctx;   
        osmo_prim_cb l1_prim_cb;
        lapdm_cb_t l3_cb;       
        struct lapdm_channel *lapdm_ch;
 
        uint8_t ta;             /* TA used and indicated to network */
        uint8_t tx_power;       /* MS power used and indicated to network */
};
 
struct lapdm_channel {
        struct llist_head list;         
        char *name;                     
        struct lapdm_entity lapdm_acch; 
        struct lapdm_entity lapdm_dcch; 
};
 
const char *get_rsl_name(int value);
extern const char *lapdm_state_names[];
 
struct lapdm_datalink *lapdm_datalink_for_sapi(struct lapdm_entity *le, uint8_t sapi);
 
/* initialize a LAPDm entity */
void lapdm_entity_init(struct lapdm_entity *le, enum lapdm_mode mode, int t200)
        OSMO_DEPRECATED("Use lapdm_entity_init3() instead");
void lapdm_entity_init2(struct lapdm_entity *le, enum lapdm_mode mode,
                        const int *t200_ms, int n200)
        OSMO_DEPRECATED("Use lapdm_entity_init3() instead");
void lapdm_entity_init3(struct lapdm_entity *le, enum lapdm_mode mode,
                        const int *t200_ms, int n200, const char *name_pfx);
void lapdm_channel_init(struct lapdm_channel *lc, enum lapdm_mode mode)
        OSMO_DEPRECATED_OUTSIDE("Use lapdm_channel_init3() instead");
int lapdm_channel_init2(struct lapdm_channel *lc, enum lapdm_mode mode,
                        const int *t200_ms_dcch, const int *t200_ms_acch, enum gsm_chan_t chan_t);
int lapdm_channel_init3(struct lapdm_channel *lc, enum lapdm_mode mode,
                        const int *t200_ms_dcch, const int *t200_ms_acch, enum gsm_chan_t chan_t,
                        const char *name_pfx);
/* deinitialize a LAPDm entity */
void lapdm_entity_exit(struct lapdm_entity *le);
void lapdm_channel_exit(struct lapdm_channel *lc);
 
/* input into layer2 (from layer 1) */
int lapdm_phsap_up(struct osmo_prim_hdr *oph, struct lapdm_entity *le);
 
/* input into layer2 (from layer 3) */
int lapdm_rslms_recvmsg(struct msgb *msg, struct lapdm_channel *lc);
 
void lapdm_channel_set_l3(struct lapdm_channel *lc, lapdm_cb_t cb, void *ctx);
void lapdm_channel_set_l1(struct lapdm_channel *lc, osmo_prim_cb cb, void *ctx);
 
int lapdm_entity_set_mode(struct lapdm_entity *le, enum lapdm_mode mode);
int lapdm_channel_set_mode(struct lapdm_channel *lc, enum lapdm_mode mode);
 
void lapdm_entity_reset(struct lapdm_entity *le);
void lapdm_channel_reset(struct lapdm_channel *lc);
 
void lapdm_entity_set_flags(struct lapdm_entity *le, unsigned int flags);
void lapdm_channel_set_flags(struct lapdm_channel *lc, unsigned int flags);
 
void lapdm_entity_set_t200_fn(struct lapdm_entity *le, const uint32_t *t200_fn);
void lapdm_channel_set_t200_fn(struct lapdm_channel *lc, const uint32_t *t200_fn_dcch, const uint32_t *t200_fn_acch);
 
int lapdm_phsap_dequeue_prim(struct lapdm_entity *le, struct osmo_phsap_prim *pp);
int lapdm_phsap_dequeue_prim_fn(struct lapdm_entity *le, struct osmo_phsap_prim *pp, uint32_t fn);
void lapdm_t200_fn(struct lapdm_entity *le, uint32_t fn);