libosmogsm  1.5.1
Osmocom GSM library
gsm0502.h
Go to the documentation of this file.
1 
3 #pragma once
4 
5 #include <stdint.h>
6 
9 
10 /* 4.3.3 TDMA frame number : constants and modular arithmetic */
11 #define GSM_TDMA_FN_DURATION_nS 4615384 /* in 1e−9 seconds (approx) */
12 #define GSM_TDMA_FN_DURATION_uS 4615 /* in 1e-6 seconds (approx) */
13 
14 #define GSM_TDMA_SUPERFRAME (26 * 51)
15 #define GSM_TDMA_HYPERFRAME (2048 * GSM_TDMA_SUPERFRAME)
16 
18 #define GSM_TDMA_FN_SUM(a, b) \
19  ((a + b) % GSM_TDMA_HYPERFRAME)
20 
21 #define GSM_TDMA_FN_SUB(a, b) \
22  ((a + GSM_TDMA_HYPERFRAME - b) % GSM_TDMA_HYPERFRAME)
23 
24 #define GSM_TDMA_FN_DIFF(a, b) \
25  OSMO_MIN(GSM_TDMA_FN_SUB(a, b), GSM_TDMA_FN_SUB(b, a))
26 
28 #define GSM_TDMA_FN_INC(fn) \
29  ((fn) = GSM_TDMA_FN_SUM((fn), 1))
30 
31 #define GSM_TDMA_FN_DEC(fn) \
32  ((fn) = GSM_TDMA_FN_SUB((fn), 1))
33 
34 /* Table 5 Clause 7 TS 05.02 */
35 static inline unsigned int
37 {
38  if (chan_desc->ccch_conf == RSL_BCCH_CCCH_CONF_1_C)
39  return 3 - chan_desc->bs_ag_blks_res;
40  else
41  return 9 - chan_desc->bs_ag_blks_res;
42 }
43 
44 /* Chapter 6.5.2 of TS 05.02 */
45 static inline unsigned int
46 gsm0502_get_ccch_group(uint64_t imsi, unsigned int bs_cc_chans,
47  unsigned int n_pag_blocks)
48 {
49  return (imsi % 1000) % (bs_cc_chans * n_pag_blocks) / n_pag_blocks;
50 }
51 
52 /* Chapter 6.5.2 of TS 05.02 */
53 static inline unsigned int
54 gsm0502_get_paging_group(uint64_t imsi, unsigned int bs_cc_chans,
55  int n_pag_blocks)
56 {
57  return (imsi % 1000) % (bs_cc_chans * n_pag_blocks) % n_pag_blocks;
58 }
59 
60 unsigned int
62 
71 };
72 
73 uint32_t gsm0502_fn_remap(uint32_t fn, enum gsm0502_fn_remap_channel channel);
74 
75 uint16_t gsm0502_hop_seq_gen(const struct gsm_time *t,
76  uint8_t hsn, uint8_t maio,
77  size_t n, const uint16_t *ma);
gsm0502_hop_seq_gen
uint16_t gsm0502_hop_seq_gen(const struct gsm_time *t, uint8_t hsn, uint8_t maio, size_t n, const uint16_t *ma)
Hopping sequence generation as per 3GPP TS 45.002, section 6.2.3.
Definition: gsm0502.c:233
n
write Write running configuration to or terminal n Write configuration to the copy running config startup Copy configuration n Copy running config to n Copy running config to startup write Write running configuration to or terminal n Write to terminal n
gsm_time
Definition: gsm_utils.h:44
FN_REMAP_FACCH_H0
@ FN_REMAP_FACCH_H0
Definition: gsm0502.h:68
gsm0502_calc_paging_group
unsigned int gsm0502_calc_paging_group(struct gsm48_control_channel_descr *chan_desc, uint64_t imsi)
Definition: gsm0502.c:37
gsm0502_get_n_pag_blocks
static unsigned int gsm0502_get_n_pag_blocks(struct gsm48_control_channel_descr *chan_desc)
Definition: gsm0502.h:36
RSL_BCCH_CCCH_CONF_1_C
#define RSL_BCCH_CCCH_CONF_1_C
Definition: gsm_08_58.h:656
FN_REMAP_TCH_H0
@ FN_REMAP_TCH_H0
Definition: gsm0502.h:65
FN_REMAP_MAX
@ FN_REMAP_MAX
Definition: gsm0502.h:70
gsm_04_08.h
gsm48_control_channel_descr
Definition: gsm_04_08.h:928
gsm0502_fn_remap_channel
gsm0502_fn_remap_channel
Definition: gsm0502.h:63
FN_REMAP_FACCH_H1
@ FN_REMAP_FACCH_H1
Definition: gsm0502.h:69
FN_REMAP_TCH_H1
@ FN_REMAP_TCH_H1
Definition: gsm0502.h:66
gsm0502_fn_remap
uint32_t gsm0502_fn_remap(uint32_t fn, enum gsm0502_fn_remap_channel channel)
Calculate the frame number of the beginning of a block.
Definition: gsm0502.c:177
FN_REMAP_TCH_F
@ FN_REMAP_TCH_F
Definition: gsm0502.h:64
gsm_08_58.h
gsm0502_get_ccch_group
static unsigned int gsm0502_get_ccch_group(uint64_t imsi, unsigned int bs_cc_chans, unsigned int n_pag_blocks)
Definition: gsm0502.h:46
chan_desc
struct gsm48_chan_desc chan_desc
Definition: gsm_04_08.h:683
gsm0502_get_paging_group
static unsigned int gsm0502_get_paging_group(uint64_t imsi, unsigned int bs_cc_chans, int n_pag_blocks)
Definition: gsm0502.h:54
FN_REMAP_FACCH_F
@ FN_REMAP_FACCH_F
Definition: gsm0502.h:67