| /* Paging helper and manager.... */ |
| /* (C) 2009 by Holger Hans Peter Freyther <zecke@selfish.org> |
| * All Rights Reserved |
| * |
| * This program is free software; you can redistribute it and/or modify |
| * it under the terms of the GNU Affero General Public License as published by |
| * the Free Software Foundation; either version 3 of the License, or |
| * (at your option) any later version. |
| * |
| * This program is distributed in the hope that it will be useful, |
| * but WITHOUT ANY WARRANTY; without even the implied warranty of |
| * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the |
| * GNU Affero General Public License for more details. |
| * |
| * You should have received a copy of the GNU Affero General Public License |
| * along with this program. If not, see <http://www.gnu.org/licenses/>. |
| * |
| */ |
| |
| #ifndef PAGING_H |
| #define PAGING_H |
| |
| #include <stdlib.h> |
| #include <string.h> |
| |
| #include <osmocom/core/linuxlist.h> |
| #include <osmocom/core/timer.h> |
| |
| #include <osmocom/bsc/gsm_data.h> |
| #include <osmocom/bsc/bsc_subscriber.h> |
| #include <osmocom/bsc/bsc_msc_data.h> |
| |
| struct bsc_msc_data; |
| |
| #define LOG_PAGING(PARAMS, SUBSYS, LEVEL, fmt, args...) \ |
| LOGP(SUBSYS, LEVEL, "(msc%d) Paging%s: %s: " fmt, \ |
| (PARAMS)->msc ? (PARAMS)->msc->nr : -1, \ |
| (PARAMS)->reason == BSC_PAGING_FOR_LCS ? " for LCS" : "", \ |
| bsc_subscr_name((PARAMS)->bsub), \ |
| ##args) |
| |
| #define LOG_PAGING_BTS(PARAMS, BTS, SUBSYS, LEVEL, fmt, args...) \ |
| LOG_PAGING(PARAMS, SUBSYS, LEVEL, "(bts%u) " fmt, (BTS) ? (BTS)->nr : 255, ##args) |
| |
| #define BSUB_USE_PAGING_START "paging-start" |
| #define BSUB_USE_PAGING_REQUEST "paging-req" |
| |
| /* Bitmask of reasons for Paging. Each individual Paging via bsc_paging_start() typically has only one of these reasons |
| * set, but when a subscriber responds, we need to aggregate all pending Paging reasons (by bitwise-OR). */ |
| enum bsc_paging_reason { |
| BSC_PAGING_NONE = 0, |
| BSC_PAGING_FROM_CN = 0x1, |
| BSC_PAGING_FOR_LCS = 0x2, |
| }; |
| |
| struct bsc_paging_params { |
| enum bsc_paging_reason reason; |
| struct bsc_msc_data *msc; |
| struct bsc_subscr *bsub; |
| uint32_t tmsi; |
| struct osmo_mobile_identity imsi; |
| uint8_t chan_needed; |
| struct gsm0808_cell_id_list2 cil; |
| }; |
| |
| /** |
| * A pending paging request |
| */ |
| struct gsm_paging_request { |
| /* list_head for list of all paging requests */ |
| struct llist_head entry; |
| /* the subscriber which we're paging. Later gsm_paging_request |
| * should probably become a part of the bsc_subsrc struct? */ |
| struct bsc_subscr *bsub; |
| /* back-pointer to the BTS on which we are paging */ |
| struct gsm_bts *bts; |
| /* what kind of channel type do we ask the MS to establish */ |
| int chan_type; |
| |
| /* Timer 3113: how long do we try to page? */ |
| struct osmo_timer_list T3113; |
| |
| /* How often did we ask the BTS to page? */ |
| int attempts; |
| |
| /* MSC that has issued this paging */ |
| struct bsc_msc_data *msc; |
| |
| enum bsc_paging_reason reason; |
| }; |
| |
| /* schedule paging request */ |
| int paging_request_bts(const struct bsc_paging_params *params, struct gsm_bts *bts); |
| |
| int paging_request_stop(struct bsc_msc_data **msc_p, enum bsc_paging_reason *reasons_p, |
| struct gsm_bts *bts, struct bsc_subscr *bsub); |
| int paging_request_cancel(struct bsc_subscr *bsub, enum bsc_paging_reason reasons); |
| |
| /* update paging load */ |
| void paging_update_buffer_space(struct gsm_bts *bts, uint16_t); |
| |
| /* pending paging requests */ |
| unsigned int paging_pending_requests_nr(struct gsm_bts *bts); |
| |
| void paging_flush_bts(struct gsm_bts *bts, struct bsc_msc_data *msc); |
| void paging_flush_network(struct gsm_network *net, struct bsc_msc_data *msc); |
| |
| int bsc_paging_start(struct bsc_paging_params *params); |
| #endif |