blob: f7469a3754844353bbd195f26b5c32ba15293d87 [file] [log] [blame]
Harald Welted41b7c72019-06-13 09:41:58 +02001[[smscb]]
2== SMSCB (Cell Broadcast)
3
4OsmoBSC supports SMS Cell Broadcast (SMSCB) services (CBS). This
5includes the CBSP protocol to interact with a CBC (Cell Broadcast
6Centre) such as OsmoCBC, as well as the scheduling of SMSCB messages on
7both the BASIC and EXTENDED CBCH and transmission of related RSL
8messages to the attached BTS.
9
10More high-level information can be found at
11https://en.wikipedia.org/wiki/Cell_Broadcast and the related
12specification is <<3gpp-ts-23-041>>.
13
14In order to use SMSCB with OsmoBSC, you will need to
15
16* Configure the CBSP server and/or client
17* Use a channel combination including a CBCH on the BTSs
18
19=== Enabling a CBCH channel combination
20
21On the Um interface, SMSCB are transmitted via the CBCH (Cell Broadcast
22Channel). The CBCH is a separate downlink-only logical channel which
23must be activated on any of the BTSs requiring CBSP support.
24
25The channel combination is configured in the `timeslot` node of each TRX.
26
27The two `phys_chan_config` supporting CBCH are `CCCH+SDCCH4+CBCH` and
28`SDCCH/8+CBCH`. Please note that the CBCH steals one of the SDCCH, so
29a SDCCH/4 will only have three remaining SDCCH, and a SDCCH/8 will
30have only seven remaining SDCCH.
31
32=== Configuring the CBSP connection
33
34CBSP is the protocol between BSC and CBC. It operates over TCP.
35
36According to 3GPP TS 48.049, a BSC typically operates as a TCP server,
37and the CBC connects as TCP client. This would require the CBC to have
38out-of-band knowledge of all the BSCs in the network (and their IP
39addresses).
40
41In order to comply with the specifications, OsmoBSC supports this mode
42of operation as CBSP TCP server. However, to make network operation and
43configuration more simple, it also can operate in TCP client mode,
44connecting to the CBC. This way the all the BSCs need to know is the CBC IP
45address, but not vice-versa.
46
47The BSC can operate both CBSP TCP server and CBSP TCP client mode in
48parallel.
49
50The CBC related configuration of OsmoBSC can be found in the `cbc` configuration
51node of the VTY interface.
52
53.Example: Configure CBSP TCP client to connect to CBC at 1.2.3.4:48049
54----
55OsmoBSC> enable
56OsmoBSC# configure terminal
57OsmoBSC(config)# cbc
58OsmoBSC(config-cbc)# remote-ip 1.2.3.4
59OsmoBSC(config-cbc)# remote-port 48049
60OsmoBSC(config-cbc)# end
61----
62
63.Example: Disable CBSP TCP client
64----
65OsmoBSC> enable
66OsmoBSC# configure terminal
67OsmoBSC(config)# cbc
68OsmoBSC(config-cbc)# no remote-ip
69OsmoBSC(config-cbc)# end
70----
71
72.Example: Configure CBSP TCP server to listen for CBC at 127.0.0.2:9999
73----
74OsmoBSC> enable
75OsmoBSC# configure terminal
76OsmoBSC(config)# cbc
77OsmoBSC(config-cbc)# listen-ip 127.0.0.2
78OsmoBSC(config-cbc)# listen-port 9999
79OsmoBSC(config-cbc)# end
80----
81
82For more details on the available configuration commands, please check the OsmoBSC VTY Reference.