path: root/openbsc/doc/paging.txt
diff options
authorHolger Hans Peter Freyther <>2013-02-06 11:51:56 +0100
committerHolger Hans Peter Freyther <>2013-02-06 12:04:32 +0100
commit0a7c6a35498e9c168b78212a6cb5e8fc865b33d3 (patch)
tree7352df606915c40f34a975e6d8c14709ac54c7ff /openbsc/doc/paging.txt
parent883fbc9d044318791239d79f86fc1aa235cb32e6 (diff)
doc: Add some documentation on how the paging system is working
Diffstat (limited to 'openbsc/doc/paging.txt')
1 files changed, 48 insertions, 0 deletions
diff --git a/openbsc/doc/paging.txt b/openbsc/doc/paging.txt
new file mode 100644
index 000000000..c597c22b4
--- /dev/null
+++ b/openbsc/doc/paging.txt
@@ -0,0 +1,48 @@
+GSM Paging implementation in OpenBSC
+== Code structure ==
+The code is implemented in the libbsc/paging.c file. The external
+interface is documented/specified in the include/openbsc/paging.h
+header file. The code is used by the NITB and BSC application.
+== Implementation ==
+Paging can be initiated in two ways. The standard way is to page by
+LAC. Each BTS has its own list/queue of outstanding paging operation.
+When a subscriber is paged one "struct paging_request" per BTS will
+be allocated and added to the tail of the list. The BTS is supposed
+to be configured to not repeat the paging.
+A paging_request will remain in the queue until a paging response or at
+the expiry of the T3113. Every 500 milliseconds a RSL paging command is
+send to the BTS. The 500 milliseconds is a throttling to not crash the
+ip.access nanoBTS. Once one paging_request has been handled it will be
+put at the end of the queue/list and the available slots for the BTS
+will be decreased.
+The available slots will be updated based on the paging load information
+element of the CCCH Load indication. If no paging slots are considered
+to be available and no load indication is sent a timer is started. The
+current timeout is 500 milliseconds and at the expiry of the timer the
+available slots will be set to 20.
+OpenBSC has the " paging free <-1-1024>" configuration option. In case
+there are less free channels than required no paging request will be
+sent to the BTS. Instead it will be attempted to send the paging request
+at the next timeout (500 milliseconds).
+== Limitation ==
+The paging throughput could be higher but this has lead to crashes on the
+ip.access nanoBTS in the past.
+== Configuration ==
+=== ip.access nanoBTS ===
+The current CCCH Load indication threshold is 10% and the period is 1 second.
+The code can be found inside the src/libbsc/bts_ipaccess_nanobts.c inside the
+nanobts_attr_bts array.