#ifndef _GSM_DATA_H #define _GSM_DATA_H #include #include #include #define ARRAY_SIZE(x) (sizeof(x) / sizeof((x)[0])) #define GSM_MAX_BTS 8 #define BTS_MAX_TRX 8 #define TRX_NR_TS 8 #define TS_MAX_LCHAN 8 #define HARDCODED_ARFCN 123 enum gsm_hooks { GSM_HOOK_NM_SWLOAD, }; struct msgb; typedef int gsm_cbfn(unsigned int hooknum, unsigned int event, struct msgb *msg, void *data, void *param); /* * Use the channel. As side effect the lchannel recycle timer * will be started. */ #define LCHAN_RELEASE_TIMEOUT 4, 0 #define use_lchan(lchan) \ do { lchan->use_count++; \ schedule_timer(&lchan->release_timer, LCHAN_RELEASE_TIMEOUT); } while(0); #define put_lchan(lchan) \ do { lchan->use_count--; } while(0); /* communications link with a BTS */ struct gsm_bts_link { struct gsm_bts *bts; }; enum gsm_call_type { GSM_CT_NONE, GSM_CT_MO, GSM_CT_MT, }; enum gsm_call_state { GSM_CSTATE_NULL, GSM_CSTATE_INITIATED, GSM_CSTATE_ACTIVE, GSM_CSTATE_RELEASE_REQ, }; /* One end of a call */ struct gsm_call { enum gsm_call_type type; enum gsm_call_state state; u_int8_t transaction_id; /* 10.3.2 */ /* the 'local' subscriber */ struct gsm_subscriber *subscr; }; enum gsm_phys_chan_config { GSM_PCHAN_NONE, GSM_PCHAN_CCCH, GSM_PCHAN_CCCH_SDCCH4, GSM_PCHAN_TCH_F, GSM_PCHAN_TCH_H, GSM_PCHAN_SDCCH8_SACCH8C, GSM_PCHAN_UNKNOWN, }; enum gsm_chan_t { GSM_LCHAN_NONE, GSM_LCHAN_SDCCH, GSM_LCHAN_TCH_F, GSM_LCHAN_TCH_H, GSM_LCHAN_UNKNOWN, }; /* Channel Request reason */ enum gsm_chreq_reason_t { GSM_CHREQ_REASON_EMERG, GSM_CHREQ_REASON_PAG, GSM_CHREQ_REASON_CALL, GSM_CHREQ_REASON_LOCATION_UPD, GSM_CHREQ_REASON_OTHER, }; /* * LOCATION UPDATING REQUEST state * * Our current operation is: * - Get imei/tmsi * - Accept/Reject according to global policy */ struct gsm_loc_updating_operation { struct timer_list updating_timer; int waiting_for_imsi : 1; int waiting_for_imei : 1; }; struct gsm_lchan { /* The TS that we're part of */ struct gsm_bts_trx_ts *ts; /* The logical subslot number in the TS */ u_int8_t nr; /* The lotical channel type */ enum gsm_chan_t type; /* To whom we are allocated at the moment */ struct gsm_subscriber *subscr; /* Timer started to release the channel */ struct timer_list release_timer; /* local end of a call, if any */ struct gsm_call call; /* temporary user data, to be removed... and merged into gsm_call */ void *user_data; /* * Operations that have a state and might be pending */ struct gsm_loc_updating_operation *loc_operation; /* use count. how many users use this channel */ unsigned int use_count; }; struct gsm_e1_subslot { /* Number of E1 link */ u_int8_t e1_nr; /* Number of E1 TS inside E1 link */ u_int8_t e1_ts; /* Sub-slot within the E1 TS, 0xff if full TS */ u_int8_t e1_ts_ss; }; #define BTS_TRX_F_ACTIVATED 0x0001 /* One Timeslot in a TRX */ struct gsm_bts_trx_ts { struct gsm_bts_trx *trx; /* number of this timeslot at the TRX */ u_int8_t nr; enum gsm_phys_chan_config pchan; unsigned int flags; /* To which E1 subslot are we connected */ struct gsm_e1_subslot e1_link; struct gsm_lchan lchan[TS_MAX_LCHAN]; }; /* One TRX in a BTS */ struct gsm_bts_trx { struct gsm_bts *bts; /* number of this TRX in the BTS */ u_int8_t nr; /* how do we talk RSL with this TRX? */ struct e1inp_sign_link *rsl_link; u_int16_t arfcn; struct gsm_bts_trx_ts ts[TRX_NR_TS]; }; enum gsm_bts_type { GSM_BTS_TYPE_UNKNOWN, GSM_BTS_TYPE_BS11, }; /** * A pending paging request */ struct gsm_paging_request { struct llist_head entry; struct gsm_subscriber *subscr; struct gsm_bts *bts; int requests; int chan_type; }; /* * This keeps track of the paging status of one BTS. It * includes a number of pending requests, a back pointer * to the gsm_bts, a timer and some more state. */ struct gsm_bts_paging_state { /* public callbacks */ void (*channel_allocated)(struct gsm_lchan *lchan); /* pending requests */ struct llist_head pending_requests; struct gsm_paging_request *last_request; struct gsm_bts *bts; /* tick timer */ struct timer_list page_timer; }; /* One BTS */ struct gsm_bts { struct gsm_network *network; /* number of ths BTS in network */ u_int8_t nr; /* location area code of this BTS */ u_int8_t location_area_code; /* type of BTS */ enum gsm_bts_type type; /* how do we talk OML with this TRX? */ struct e1inp_sign_link *oml_link; /* Abis network management O&M handle */ struct abis_nm_h *nmh; /* number of this BTS on given E1 link */ u_int8_t bts_nr; struct gsm48_control_channel_descr chan_desc; /* paging state and control */ struct gsm_bts_paging_state paging; /* CCCH is on C0 */ struct gsm_bts_trx *c0; /* transceivers */ int num_trx; struct gsm_bts_trx trx[BTS_MAX_TRX+1]; }; struct gsm_network { /* global parameters */ u_int16_t country_code; u_int16_t network_code; char *name_long; char *name_short; unsigned int num_bts; /* private lists */ struct gsm_bts bts[GSM_MAX_BTS+1]; }; struct gsm_network *gsm_network_init(unsigned int num_bts, u_int16_t country_code, u_int16_t network_code); const char *gsm_pchan_name(enum gsm_phys_chan_config c); const char *gsm_lchan_name(enum gsm_chan_t c); const char *gsm_chreq_name(enum gsm_chreq_reason_t c); enum gsm_e1_event { EVT_E1_NONE, EVT_E1_TEI_UP, EVT_E1_TEI_DN, }; #endif