blob: 8d5f23d2b24a09c5f415b04c74c7774d9507618f [file] [log] [blame]
Pau Espin Pedrolc0a250d2021-01-21 18:46:13 +01001/* nacc_fsm.c
2 *
3 * Copyright (C) 2021 by sysmocom - s.f.m.c. GmbH <info@sysmocom.de>
4 * Author: Pau Espin Pedrol <pespin@sysmocom.de>
5 *
6 * This program is free software; you can redistribute it and/or
7 * modify it under the terms of the GNU General Public License
8 * as published by the Free Software Foundation; either version 2
9 * of the License, or (at your option) any later version.
10 *
11 * This program is distributed in the hope that it will be useful,
12 * but WITHOUT ANY WARRANTY; without even the implied warranty of
13 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
14 * GNU General Public License for more details.
15 *
16 * You should have received a copy of the GNU General Public License
17 * along with this program; if not, write to the Free Software
18 * Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
19 */
20
21#include <unistd.h>
22
23#include <talloc.h>
24
25#include <osmocom/core/rate_ctr.h>
26#include <osmocom/ctrl/control_cmd.h>
27#include <osmocom/ctrl/control_if.h>
28
29#include <osmocom/gsm/gsm48.h>
30#include <osmocom/gprs/gprs_bssgp.h>
31#include <osmocom/gprs/gprs_bssgp_rim.h>
32
33#include <nacc_fsm.h>
34#include <gprs_rlcmac.h>
35#include <gprs_debug.h>
36#include <gprs_ms.h>
37#include <encoding.h>
38#include <bts.h>
39#include <neigh_cache.h>
40
41#define X(s) (1 << (s))
42
Pau Espin Pedrol069a6372021-02-10 17:33:13 +010043/* Infer CTRL id (seqnum) for a given tgt arfcn+bsic (bsic range: 0-63) */
44#define arfcn_bsic_2_ctrl_id(arfcn, bsic) ((arfcn) * 100 + (bsic))
45
Pau Espin Pedrol41a22a72021-01-26 19:00:37 +010046static const struct osmo_tdef_state_timeout nacc_fsm_timeouts[32] = {
47 [NACC_ST_INITIAL] = {},
48 [NACC_ST_WAIT_RESOLVE_RAC_CI] = { .T = PCU_TDEF_NEIGH_RESOLVE_TO },
49 [NACC_ST_WAIT_REQUEST_SI] = { .T = PCU_TDEF_SI_RESOLVE_TO },
50 [NACC_ST_TX_NEIGHBOUR_DATA] = {},
51 [NACC_ST_TX_CELL_CHG_CONTINUE] = {},
Pau Espin Pedrol952cb3d2021-02-01 14:52:48 +010052 [NACC_ST_WAIT_CELL_CHG_CONTINUE_ACK] = {}, /* Timeout through event controlled by tbf::poll_timeout() */
Pau Espin Pedrol41a22a72021-01-26 19:00:37 +010053 [NACC_ST_DONE] = {},
54};
55
56/* Transition to a state, using the T timer defined in assignment_fsm_timeouts.
57 * The actual timeout value is in turn obtained from conn->T_defs.
58 * Assumes local variable fi exists. */
59
Pau Espin Pedrolc0a250d2021-01-21 18:46:13 +010060#define nacc_fsm_state_chg(fi, NEXT_STATE) \
Pau Espin Pedrol41a22a72021-01-26 19:00:37 +010061 osmo_tdef_fsm_inst_state_chg(fi, NEXT_STATE, \
62 nacc_fsm_timeouts, \
63 ((struct nacc_fsm_ctx*)(fi->priv))->ms->bts->pcu->T_defs, \
64 -1)
Pau Espin Pedrolc0a250d2021-01-21 18:46:13 +010065
66const struct value_string nacc_fsm_event_names[] = {
67 { NACC_EV_RX_CELL_CHG_NOTIFICATION, "RX_CELL_CHG_NOTIFICATION" },
68 { NACC_EV_RX_RAC_CI, "RX_RAC_CI" },
69 { NACC_EV_RX_SI, "RX_SI" },
70 { NACC_EV_CREATE_RLCMAC_MSG, "CREATE_RLCMAC_MSG" },
Pau Espin Pedrol952cb3d2021-02-01 14:52:48 +010071 { NACC_EV_RX_CELL_CHG_CONTINUE_ACK, "RX_CELL_CHG_CONTINUE_ACK"},
72 { NACC_EV_TIMEOUT_CELL_CHG_CONTINUE, "TIMEOUT_CELL_CHG_CONTINUE" },
Pau Espin Pedrolc0a250d2021-01-21 18:46:13 +010073 { 0, NULL }
74};
75
76/* TS 44 060 11.2.9e Packet Neighbour Cell Data */
77static struct msgb *create_packet_neighbour_cell_data(struct nacc_fsm_ctx *ctx,
78 const struct gprs_rlcmac_tbf *tbf,
79 bool *all_si_info_sent)
80{
81 struct msgb *msg;
82 int rc;
83 RlcMacDownlink_t *mac_control_block;
84 struct GprsMs *ms = tbf_ms(tbf);
85 OSMO_ASSERT(tbf_is_tfi_assigned(tbf));
86 uint8_t tfi_is_dl = tbf_direction(tbf) == GPRS_RLCMAC_DL_TBF;
87 uint8_t tfi = tbf_tfi(tbf);
88 uint8_t container_id = 0;
89 PNCDContainer_t container;
90 size_t max_len, len_to_write;
91 uint8_t *cont_buf;
92 uint8_t si_type = ctx->si_info.type_psi ? 0x01 : 0x0;
93
94 memset(&container, 0, sizeof(container));
95 if (ctx->container_idx == 0) {
96 container.UnionType = 1; /* with ID */
97 container.u.PNCD_Container_With_ID.ARFCN = ctx->neigh_key.tgt_arfcn;
98 container.u.PNCD_Container_With_ID.BSIC = ctx->neigh_key.tgt_bsic;
99 cont_buf = &container.u.PNCD_Container_With_ID.CONTAINER[0];
100 max_len = sizeof(container.u.PNCD_Container_With_ID.CONTAINER) - 1;
101 } else {
102 container.UnionType = 0; /* without ID */
103 cont_buf = &container.u.PNCD_Container_Without_ID.CONTAINER[0];
104 max_len = sizeof(container.u.PNCD_Container_Without_ID.CONTAINER) - 1;
105 }
106
107 len_to_write = ctx->si_info.si_len - ctx->si_info_bytes_sent;
108
109 if (len_to_write == 0) {
110 /* We sent all info on last message filing it exactly, we now send a zeroed one to finish */
111 *all_si_info_sent = true;
112 *cont_buf = (si_type << 5) | 0x00;
113 } else if (len_to_write >= max_len) {
114 /* We fill the rlcmac block, we'll need more messages */
115 *all_si_info_sent = false;
116 *cont_buf = (si_type << 5) | 0x1F;
117 memcpy(cont_buf + 1, &ctx->si_info.si_buf[ctx->si_info_bytes_sent], max_len);
118 ctx->si_info_bytes_sent += max_len;
119 } else {
120 /* Last block, we don't fill it exactly */
121 *all_si_info_sent = true;
122 *cont_buf = (si_type << 5) | (len_to_write & 0x1F);
123 memcpy(cont_buf + 1, &ctx->si_info.si_buf[ctx->si_info_bytes_sent], len_to_write);
124 ctx->si_info_bytes_sent += len_to_write;
125 }
126
127 msg = msgb_alloc(GSM_MACBLOCK_LEN, "neighbour_cell_data");
128 if (!msg)
129 return NULL;
130
131 /* Initialize a bit vector that uses allocated msgb as the data buffer. */
132 struct bitvec bv = {
133 .data = msgb_put(msg, GSM_MACBLOCK_LEN),
134 .data_len = GSM_MACBLOCK_LEN,
135 };
136 bitvec_unhex(&bv, DUMMY_VEC);
137
138 mac_control_block = (RlcMacDownlink_t *)talloc_zero(ctx->ms, RlcMacDownlink_t);
139
140 write_packet_neighbour_cell_data(mac_control_block,
141 tfi_is_dl, tfi, container_id,
142 ctx->container_idx, &container);
143 LOGP(DNACC, LOGL_DEBUG, "+++++++++++++++++++++++++ TX : Packet Neighbour Cell Data +++++++++++++++++++++++++\n");
144 rc = encode_gsm_rlcmac_downlink(&bv, mac_control_block);
145 if (rc < 0) {
146 LOGP(DTBF, LOGL_ERROR, "Encoding of Packet Neighbour Cell Data failed (%d)\n", rc);
147 goto free_ret;
148 }
149 LOGP(DNACC, LOGL_DEBUG, "------------------------- TX : Packet Neighbour Cell Data -------------------------\n");
150 rate_ctr_inc(&bts_rate_counters(ms->bts)->ctr[CTR_PKT_NEIGH_CELL_DATA]);
151 talloc_free(mac_control_block);
152
153 ctx->container_idx++;
154
155 return msg;
156
157free_ret:
158 talloc_free(mac_control_block);
159 msgb_free(msg);
160 return NULL;
161}
162
163/* TS 44 060 11.2.2a Packet Cell Change Continue */
164static struct msgb *create_packet_cell_chg_continue(const struct nacc_fsm_ctx *ctx,
Pau Espin Pedrol952cb3d2021-02-01 14:52:48 +0100165 const struct nacc_ev_create_rlcmac_msg_ctx *data,
166 uint32_t *new_poll_fn)
Pau Espin Pedrolc0a250d2021-01-21 18:46:13 +0100167{
168 struct msgb *msg;
169 int rc;
170 RlcMacDownlink_t *mac_control_block;
Pau Espin Pedrol952cb3d2021-02-01 14:52:48 +0100171 struct gprs_rlcmac_tbf *tbf = data->tbf;
Pau Espin Pedrolc0a250d2021-01-21 18:46:13 +0100172 struct GprsMs *ms = tbf_ms(tbf);
Pau Espin Pedrol952cb3d2021-02-01 14:52:48 +0100173 unsigned int rrbp;
174
175 rc = tbf_check_polling(tbf, data->fn, data->ts, new_poll_fn, &rrbp);
176 if (rc < 0) {
177 LOGP(DTBF, LOGL_ERROR, "Failed registering poll for Pkt Cell Chg Continue (%d)\n", rc);
178 return NULL;
179 }
Pau Espin Pedrolc0a250d2021-01-21 18:46:13 +0100180
181 msg = msgb_alloc(GSM_MACBLOCK_LEN, "pkt_cell_chg_continue");
182 if (!msg)
183 return NULL;
184
185 /* Initialize a bit vector that uses allocated msgb as the data buffer. */
186 struct bitvec bv = {
187 .data = msgb_put(msg, GSM_MACBLOCK_LEN),
188 .data_len = GSM_MACBLOCK_LEN,
189 };
190 bitvec_unhex(&bv, DUMMY_VEC);
191
192 mac_control_block = (RlcMacDownlink_t *)talloc_zero(ctx->ms, RlcMacDownlink_t);
193
194 OSMO_ASSERT(tbf_is_tfi_assigned(tbf));
195 uint8_t tfi_is_dl = tbf_direction(tbf) == GPRS_RLCMAC_DL_TBF;
196 uint8_t tfi = tbf_tfi(tbf);
197 uint8_t container_id = 0;
Pau Espin Pedrol952cb3d2021-02-01 14:52:48 +0100198 write_packet_cell_change_continue(mac_control_block, 1, rrbp, tfi_is_dl, tfi, true,
Pau Espin Pedrolc0a250d2021-01-21 18:46:13 +0100199 ctx->neigh_key.tgt_arfcn, ctx->neigh_key.tgt_bsic, container_id);
200 LOGP(DNACC, LOGL_DEBUG, "+++++++++++++++++++++++++ TX : Packet Cell Change Continue +++++++++++++++++++++++++\n");
201 rc = encode_gsm_rlcmac_downlink(&bv, mac_control_block);
202 if (rc < 0) {
203 LOGP(DTBF, LOGL_ERROR, "Encoding of Packet Cell Change Continue failed (%d)\n", rc);
204 goto free_ret;
205 }
206 LOGP(DNACC, LOGL_DEBUG, "------------------------- TX : Packet Cell Change Continue -------------------------\n");
207 rate_ctr_inc(&bts_rate_counters(ms->bts)->ctr[CTR_PKT_CELL_CHG_CONTINUE]);
208 talloc_free(mac_control_block);
Pau Espin Pedrol952cb3d2021-02-01 14:52:48 +0100209 tbf_set_polling(tbf, *new_poll_fn, data->ts, GPRS_RLCMAC_POLL_CELL_CHG_CONTINUE);
Pau Espin Pedrolc0a250d2021-01-21 18:46:13 +0100210 return msg;
211
212free_ret:
213 talloc_free(mac_control_block);
214 msgb_free(msg);
215 return NULL;
216}
217
218static int fill_rim_ran_info_req(const struct nacc_fsm_ctx *ctx, struct bssgp_ran_information_pdu *pdu)
219{
220 struct gprs_rlcmac_bts *bts = ctx->ms->bts;
221
222 *pdu = (struct bssgp_ran_information_pdu){
223 .routing_info_dest = {
224 .discr = BSSGP_RIM_ROUTING_INFO_GERAN,
225 .geran = {
226 .raid = {
227 .mcc = ctx->cgi_ps.rai.lac.plmn.mcc,
228 .mnc = ctx->cgi_ps.rai.lac.plmn.mnc,
229 .mnc_3_digits = ctx->cgi_ps.rai.lac.plmn.mnc_3_digits,
230 .lac = ctx->cgi_ps.rai.lac.lac,
231 .rac = ctx->cgi_ps.rai.rac,
232 },
233 .cid = ctx->cgi_ps.cell_identity,
234 },
235 },
236 .routing_info_src = {
237 .discr = BSSGP_RIM_ROUTING_INFO_GERAN,
238 .geran = {
239 .raid = {
240 .mcc = bts->cgi_ps.rai.lac.plmn.mcc,
241 .mnc = bts->cgi_ps.rai.lac.plmn.mnc,
242 .mnc_3_digits = bts->cgi_ps.rai.lac.plmn.mnc_3_digits,
243 .lac = bts->cgi_ps.rai.lac.lac,
244 .rac = bts->cgi_ps.rai.rac,
245 },
246 .cid = bts->cgi_ps.cell_identity,
247 },
248 },
249 .rim_cont_iei = BSSGP_IE_RI_REQ_RIM_CONTAINER,
250 .decoded_present = true,
251 .decoded = {
252 .req_rim_cont = {
253 .app_id = BSSGP_RAN_INF_APP_ID_NACC,
254 .seq_num = 1,
255 .pdu_ind = {
256 .ack_requested = 0,
257 .pdu_type_ext = RIM_PDU_TYPE_SING_REP,
258 },
259 .prot_ver = 1,
260 .son_trans_app_id = NULL,
261 .son_trans_app_id_len = 0,
262 .u = {
263 .app_cont_nacc = {
264 .reprt_cell = ctx->cgi_ps,
265 },
266 },
267 },
268 },
269 };
270
271 return 0;
272}
273
Pau Espin Pedrol0c10b3c2021-02-10 17:12:02 +0100274static int fill_neigh_key_from_bts_pkt_cell_chg_not(struct neigh_cache_entry_key *neigh_key,
275 const struct gprs_rlcmac_bts *bts,
276 const Packet_Cell_Change_Notification_t *notif)
277{
278 switch (notif->Target_Cell.UnionType) {
279 case 0: /* GSM */
280 neigh_key->local_lac = bts->cgi_ps.rai.lac.lac;
281 neigh_key->local_ci = bts->cgi_ps.cell_identity;
282 neigh_key->tgt_arfcn = notif->Target_Cell.u.Target_Cell_GSM_Notif.ARFCN;
283 neigh_key->tgt_bsic = notif->Target_Cell.u.Target_Cell_GSM_Notif.BSIC;
284 return 0;
285 default:
286 return -ENOTSUP;
287 }
288}
289
Pau Espin Pedrol44768f22021-02-02 13:11:30 +0100290#define SI_HDR_LEN 2
291static void bts_fill_si_cache_value(const struct gprs_rlcmac_bts *bts, struct si_cache_value *val)
292{
293 val->type_psi = false;
294 val->si_len = 0;
295 if (bts->si1_is_set) {
296 osmo_static_assert(sizeof(bts->si1) - SI_HDR_LEN == BSSGP_RIM_SI_LEN, _si1_header_size);
297 memcpy(&val->si_buf[val->si_len], bts->si1 + SI_HDR_LEN, BSSGP_RIM_SI_LEN);
298 val->si_len += BSSGP_RIM_SI_LEN;
299 }
300 if (bts->si3_is_set) {
301 osmo_static_assert(sizeof(bts->si3) - SI_HDR_LEN == BSSGP_RIM_SI_LEN, _si3_header_size);
302 memcpy(&val->si_buf[val->si_len], bts->si3 + SI_HDR_LEN, BSSGP_RIM_SI_LEN);
303 val->si_len += BSSGP_RIM_SI_LEN;
304 }
305 if (bts->si13_is_set) {
306 osmo_static_assert(sizeof(bts->si13) - SI_HDR_LEN == BSSGP_RIM_SI_LEN, _si13_header_size);
307 memcpy(&val->si_buf[val->si_len], bts->si13 + SI_HDR_LEN, BSSGP_RIM_SI_LEN);
308 val->si_len += BSSGP_RIM_SI_LEN;
309 }
310}
Pau Espin Pedrolc0a250d2021-01-21 18:46:13 +0100311
312////////////////
313// FSM states //
314////////////////
315
316static void st_initial(struct osmo_fsm_inst *fi, uint32_t event, void *data)
317{
318 struct nacc_fsm_ctx *ctx = (struct nacc_fsm_ctx *)fi->priv;
319 struct gprs_rlcmac_bts *bts = ctx->ms->bts;
320 Packet_Cell_Change_Notification_t *notif;
321
322 switch (event) {
323 case NACC_EV_RX_CELL_CHG_NOTIFICATION:
324 notif = (Packet_Cell_Change_Notification_t *)data;
Pau Espin Pedrol0c10b3c2021-02-10 17:12:02 +0100325 if (fill_neigh_key_from_bts_pkt_cell_chg_not(&ctx->neigh_key, bts, notif) < 0) {
Pau Espin Pedrolc0a250d2021-01-21 18:46:13 +0100326 LOGPFSML(fi, LOGL_NOTICE, "TargetCell type=0x%x not supported\n",
327 notif->Target_Cell.UnionType);
328 osmo_fsm_inst_term(fi, OSMO_FSM_TERM_ERROR, NULL);
Pau Espin Pedrol0c10b3c2021-02-10 17:12:02 +0100329 } else {
330 nacc_fsm_state_chg(fi, NACC_ST_WAIT_RESOLVE_RAC_CI);
Pau Espin Pedrolc0a250d2021-01-21 18:46:13 +0100331 }
332 break;
333 default:
334 OSMO_ASSERT(0);
335 }
336}
337
338static void st_wait_resolve_rac_ci_on_enter(struct osmo_fsm_inst *fi, uint32_t prev_state)
339{
340 struct nacc_fsm_ctx *ctx = (struct nacc_fsm_ctx *)fi->priv;
341 struct gprs_rlcmac_bts *bts = ctx->ms->bts;
342 struct gprs_pcu *pcu = bts->pcu;
343 const struct osmo_cell_global_id_ps *cgi_ps;
Pau Espin Pedrolc0805e62021-01-27 17:16:59 +0100344 struct ctrl_cmd *cmd = NULL;
Pau Espin Pedrolc0a250d2021-01-21 18:46:13 +0100345 int rc;
346
347 /* First try to find the value in the cache */
348 cgi_ps = neigh_cache_lookup_value(pcu->neigh_cache, &ctx->neigh_key);
349 if (cgi_ps) {
350 ctx->cgi_ps = *cgi_ps;
351 nacc_fsm_state_chg(fi, NACC_ST_WAIT_REQUEST_SI);
352 return;
353 }
354
355 /* CGI-PS not in cache, resolve it using BSC Neighbor Resolution CTRL interface */
356
357 LOGPFSML(fi, LOGL_DEBUG, "No CGI-PS found in cache, resolving " NEIGH_CACHE_ENTRY_KEY_FMT "...\n",
358 NEIGH_CACHE_ENTRY_KEY_ARGS(&ctx->neigh_key));
359
Pau Espin Pedrol069a6372021-02-10 17:33:13 +0100360 /* We may have changed to this state previously (eg: we are handling
361 * another Pkt cell Change Notify with different target). Avoid
362 * re-creating the socket in that case. */
363 if (ctx->neigh_ctrl_conn->write_queue.bfd.fd == -1) {
364 rc = osmo_sock_init2_ofd(&ctx->neigh_ctrl_conn->write_queue.bfd,
365 AF_UNSPEC, SOCK_STREAM, IPPROTO_TCP,
366 NULL, 0, pcu->vty.neigh_ctrl_addr, pcu->vty.neigh_ctrl_port,
367 OSMO_SOCK_F_CONNECT);
368 if (rc < 0) {
369 LOGPFSML(fi, LOGL_ERROR,
370 "Failed to establish CTRL (neighbor resolution) connection to BSC r=%s:%u\n\n",
371 pcu->vty.neigh_ctrl_addr, pcu->vty.neigh_ctrl_port);
372 goto err_term;
373 }
Pau Espin Pedrolc0805e62021-01-27 17:16:59 +0100374 }
375
Pau Espin Pedrolc0a250d2021-01-21 18:46:13 +0100376 cmd = ctrl_cmd_create(ctx, CTRL_TYPE_GET);
377 if (!cmd) {
378 LOGPFSML(fi, LOGL_ERROR, "CTRL msg creation failed\n");
379 goto err_term;
380 }
381
Pau Espin Pedrol069a6372021-02-10 17:33:13 +0100382 cmd->id = talloc_asprintf(cmd, "%u", arfcn_bsic_2_ctrl_id(ctx->neigh_key.tgt_arfcn,
383 ctx->neigh_key.tgt_bsic));
Pau Espin Pedrolc0a250d2021-01-21 18:46:13 +0100384 cmd->variable = talloc_asprintf(cmd, "neighbor_resolve_cgi_ps_from_lac_ci.%d.%d.%d.%d",
385 ctx->neigh_key.local_lac, ctx->neigh_key.local_ci,
386 ctx->neigh_key.tgt_arfcn, ctx->neigh_key.tgt_bsic);
387 rc = ctrl_cmd_send(&ctx->neigh_ctrl_conn->write_queue, cmd);
388 if (rc) {
389 LOGPFSML(fi, LOGL_ERROR, "CTRL msg sent failed: %d\n", rc);
390 goto err_term;
391 }
392
393 talloc_free(cmd);
394 return;
395
396err_term:
397 talloc_free(cmd);
Pau Espin Pedrola06ac182021-01-26 19:13:43 +0100398 nacc_fsm_state_chg(fi, NACC_ST_TX_CELL_CHG_CONTINUE);
Pau Espin Pedrolc0a250d2021-01-21 18:46:13 +0100399}
400
401
402static void st_wait_resolve_rac_ci(struct osmo_fsm_inst *fi, uint32_t event, void *data)
403{
Pau Espin Pedrol069a6372021-02-10 17:33:13 +0100404 struct nacc_fsm_ctx *ctx = (struct nacc_fsm_ctx *)fi->priv;
405 struct gprs_rlcmac_bts *bts = ctx->ms->bts;
406 Packet_Cell_Change_Notification_t *notif;
407 struct neigh_cache_entry_key neigh_key;
408
Pau Espin Pedrolc0a250d2021-01-21 18:46:13 +0100409 switch (event) {
410 case NACC_EV_RX_CELL_CHG_NOTIFICATION:
Pau Espin Pedrol069a6372021-02-10 17:33:13 +0100411 notif = (Packet_Cell_Change_Notification_t *)data;
412 if (fill_neigh_key_from_bts_pkt_cell_chg_not(&neigh_key, bts, notif) < 0) {
413 LOGPFSML(fi, LOGL_NOTICE, "TargetCell type=0x%x not supported\n",
414 notif->Target_Cell.UnionType);
415 nacc_fsm_state_chg(fi, NACC_ST_TX_CELL_CHG_CONTINUE);
416 return;
417 }
418 /* If tgt cell changed, restart resolving it */
419 if (!neigh_cache_entry_key_eq(&ctx->neigh_key, &neigh_key)) {
420 ctx->neigh_key = neigh_key;
421 nacc_fsm_state_chg(fi, NACC_ST_WAIT_RESOLVE_RAC_CI);
422 }
Pau Espin Pedrolc0a250d2021-01-21 18:46:13 +0100423 break;
424 case NACC_EV_RX_RAC_CI:
425 /* Assumption: ctx->cgi_ps has been filled by caller of the event */
426 nacc_fsm_state_chg(fi, NACC_ST_WAIT_REQUEST_SI);
427 break;
428 default:
429 OSMO_ASSERT(0);
430 }
431}
432
433/* At this point, we expect correct tgt cell info to be already in ctx->cgi_ps */
434static void st_wait_request_si_on_enter(struct osmo_fsm_inst *fi, uint32_t prev_state)
435{
436 struct nacc_fsm_ctx *ctx = (struct nacc_fsm_ctx *)fi->priv;
437 struct gprs_rlcmac_bts *bts = ctx->ms->bts;
438 struct gprs_pcu *pcu = bts->pcu;
439 struct bssgp_ran_information_pdu pdu;
440 const struct si_cache_value *si;
Pau Espin Pedrol44768f22021-02-02 13:11:30 +0100441 struct gprs_rlcmac_bts *bts_i;
Pau Espin Pedrolc0a250d2021-01-21 18:46:13 +0100442 int rc;
443
Pau Espin Pedrol44768f22021-02-02 13:11:30 +0100444 /* First check if the CGI-PS addresses a cell managed by this PCU. If
445 * that's the case, we already have the info and there's no need to go
446 * the RIM way since we'd end up to this same PCU on the other end anyway.
447 */
448 llist_for_each_entry(bts_i, &the_pcu->bts_list, list) {
449 if (bts_i == bts) /* Makes no sense targeting the same cell */
450 continue;
451 if (osmo_cgi_ps_cmp(&ctx->cgi_ps, &bts_i->cgi_ps) != 0)
452 continue;
453
454 LOGPFSML(fi, LOGL_DEBUG, "neighbor CGI-PS %s addresses local BTS %d\n",
455 osmo_cgi_ps_name(&ctx->cgi_ps), bts_i->nr);
456 bts_fill_si_cache_value(bts, &ctx->si_info);
457 /* Tell the PCU scheduler we are ready to go, from here one we
458 * are polled/driven by the scheduler */
459 nacc_fsm_state_chg(fi, NACC_ST_TX_NEIGHBOUR_DATA);
460 return;
461 }
462
Pau Espin Pedrolc0a250d2021-01-21 18:46:13 +0100463 /* First check if we have SI info for the target cell in cache */
464 si = si_cache_lookup_value(pcu->si_cache, &ctx->cgi_ps);
465 if (si) {
466 /* Copy info since cache can be deleted at any point */
467 memcpy(&ctx->si_info, si, sizeof(ctx->si_info));
468 /* Tell the PCU scheduler we are ready to go, from here one we
469 * are polled/driven by the scheduler */
470 nacc_fsm_state_chg(fi, NACC_ST_TX_NEIGHBOUR_DATA);
471 return;
472 }
473
474 /* SI info not in cache, resolve it using RIM procedure against SGSN */
475 if (fill_rim_ran_info_req(ctx, &pdu) < 0) {
Pau Espin Pedrola06ac182021-01-26 19:13:43 +0100476 nacc_fsm_state_chg(fi, NACC_ST_TX_CELL_CHG_CONTINUE);
Pau Espin Pedrolc0a250d2021-01-21 18:46:13 +0100477 return;
478 }
479
480 rc = bssgp_tx_rim(&pdu, gprs_ns2_nse_nsei(ctx->ms->bts->nse));
481 if (rc < 0) {
482 LOGPFSML(fi, LOGL_ERROR, "Failed transmitting RIM PDU: %d\n", rc);
Pau Espin Pedrola06ac182021-01-26 19:13:43 +0100483 nacc_fsm_state_chg(fi, NACC_ST_TX_CELL_CHG_CONTINUE);
Pau Espin Pedrolc0a250d2021-01-21 18:46:13 +0100484 return;
485 }
486}
487
488
489static void st_wait_request_si(struct osmo_fsm_inst *fi, uint32_t event, void *data)
490{
491 struct nacc_fsm_ctx *ctx = (struct nacc_fsm_ctx *)fi->priv;
492 struct si_cache_entry *entry;
493
494 switch (event) {
495 case NACC_EV_RX_SI:
496 entry = (struct si_cache_entry *)data;
497 /* Copy info since cache can be deleted at any point */
498 memcpy(&ctx->si_info, &entry->value, sizeof(ctx->si_info));
499 /* Tell the PCU scheduler we are ready to go, from here one we
500 * are polled/driven by the scheduler */
501 nacc_fsm_state_chg(fi, NACC_ST_TX_NEIGHBOUR_DATA);
502 break;
503 default:
504 OSMO_ASSERT(0);
505 }
506}
507
508/* st_tx_neighbour_data_on_enter:
509 * At this point, we already received all required SI information to send stored
510 * in struct nacc_fsm_ctx. We now wait for scheduler to ask us to construct
511 * RLCMAC DL CTRL messages to move FSM states forward
512 */
513
514static void st_tx_neighbour_data(struct osmo_fsm_inst *fi, uint32_t event, void *data)
515{
516 struct nacc_fsm_ctx *ctx = (struct nacc_fsm_ctx *)fi->priv;
517 struct nacc_ev_create_rlcmac_msg_ctx *data_ctx;
518 bool all_si_info_sent;
519
520 switch (event) {
521 case NACC_EV_CREATE_RLCMAC_MSG:
522 data_ctx = (struct nacc_ev_create_rlcmac_msg_ctx *)data;
523 data_ctx->msg = create_packet_neighbour_cell_data(ctx, data_ctx->tbf, &all_si_info_sent);
524 if (!data_ctx->msg) {
525 osmo_fsm_inst_term(fi, OSMO_FSM_TERM_ERROR, NULL);
526 return;
527 }
528 if (all_si_info_sent) /* DONE */
529 nacc_fsm_state_chg(fi, NACC_ST_TX_CELL_CHG_CONTINUE);
530 break;
531 default:
532 OSMO_ASSERT(0);
533 }
534}
535
Pau Espin Pedrol1aef1132021-02-01 19:33:59 +0100536/* st_cell_chg_continue_on_enter:
Pau Espin Pedrolc0a250d2021-01-21 18:46:13 +0100537 * At this point, we already sent all Pkt Cell Neighbour Change rlcmac
538 * blocks, and we only need to wait to be scheduled again to send PKT
539 * CELL CHANGE NOTIFICATION and then we are done
540 */
541
Pau Espin Pedrol1aef1132021-02-01 19:33:59 +0100542static void st_cell_chg_continue(struct osmo_fsm_inst *fi, uint32_t event, void *data)
Pau Espin Pedrolc0a250d2021-01-21 18:46:13 +0100543{
544 struct nacc_fsm_ctx *ctx = (struct nacc_fsm_ctx *)fi->priv;
545 struct nacc_ev_create_rlcmac_msg_ctx *data_ctx;
546
547 switch (event) {
548 case NACC_EV_CREATE_RLCMAC_MSG:
549 data_ctx = (struct nacc_ev_create_rlcmac_msg_ctx *)data;
Pau Espin Pedrol952cb3d2021-02-01 14:52:48 +0100550 data_ctx->msg = create_packet_cell_chg_continue(ctx, data_ctx, &ctx->continue_poll_fn);
551 if (data_ctx->msg) {
552 ctx->continue_poll_ts = data_ctx->ts;
553 nacc_fsm_state_chg(fi, NACC_ST_WAIT_CELL_CHG_CONTINUE_ACK);
554 }
555 break;
556 default:
557 OSMO_ASSERT(0);
558 }
559}
560
561static void st_wait_cell_chg_continue_ack(struct osmo_fsm_inst *fi, uint32_t event, void *data)
562{
563 switch (event) {
564 case NACC_EV_TIMEOUT_CELL_CHG_CONTINUE:
565 nacc_fsm_state_chg(fi, NACC_ST_TX_CELL_CHG_CONTINUE);
566 break;
567 case NACC_EV_RX_CELL_CHG_CONTINUE_ACK:
Pau Espin Pedrolc0a250d2021-01-21 18:46:13 +0100568 nacc_fsm_state_chg(fi, NACC_ST_DONE);
569 break;
570 default:
571 OSMO_ASSERT(0);
572 }
573}
574
575
576static void st_done_on_enter(struct osmo_fsm_inst *fi, uint32_t prev_state)
577{
578 osmo_fsm_inst_term(fi, OSMO_FSM_TERM_REGULAR, NULL);
579}
580
581static void nacc_fsm_cleanup(struct osmo_fsm_inst *fi, enum osmo_fsm_term_cause cause)
582{
583 struct nacc_fsm_ctx *ctx = (struct nacc_fsm_ctx *)fi->priv;
584 /* after cleanup() finishes, FSM termination calls osmo_fsm_inst_free,
585 so we need to avoid double-freeing it during ctx talloc free
586 destructor */
587 talloc_reparent(ctx, ctx->ms, ctx->fi);
588 ctx->fi = NULL;
589
590 /* remove references from owning MS and free entire ctx */
591 ctx->ms->nacc = NULL;
592 talloc_free(ctx);
593}
594
Pau Espin Pedrol41a22a72021-01-26 19:00:37 +0100595static int nacc_fsm_timer_cb(struct osmo_fsm_inst *fi)
596{
597 switch (fi->T) {
598 case PCU_TDEF_NEIGH_RESOLVE_TO:
599 case PCU_TDEF_SI_RESOLVE_TO:
600 nacc_fsm_state_chg(fi, NACC_ST_TX_CELL_CHG_CONTINUE);
601 break;
602 }
603 return 0;
604}
605
Pau Espin Pedrolc0a250d2021-01-21 18:46:13 +0100606static struct osmo_fsm_state nacc_fsm_states[] = {
607 [NACC_ST_INITIAL] = {
608 .in_event_mask =
609 X(NACC_EV_RX_CELL_CHG_NOTIFICATION),
610 .out_state_mask =
611 X(NACC_ST_WAIT_RESOLVE_RAC_CI),
612 .name = "INITIAL",
613 .action = st_initial,
614 },
615 [NACC_ST_WAIT_RESOLVE_RAC_CI] = {
616 .in_event_mask =
Pau Espin Pedrol069a6372021-02-10 17:33:13 +0100617 X(NACC_EV_RX_CELL_CHG_NOTIFICATION) |
Pau Espin Pedrolc0a250d2021-01-21 18:46:13 +0100618 X(NACC_EV_RX_RAC_CI),
619 .out_state_mask =
Pau Espin Pedrol069a6372021-02-10 17:33:13 +0100620 X(NACC_ST_WAIT_RESOLVE_RAC_CI) |
Pau Espin Pedrol41a22a72021-01-26 19:00:37 +0100621 X(NACC_ST_WAIT_REQUEST_SI) |
622 X(NACC_ST_TX_CELL_CHG_CONTINUE),
Pau Espin Pedrolc0a250d2021-01-21 18:46:13 +0100623 .name = "WAIT_RESOLVE_RAC_CI",
624 .onenter = st_wait_resolve_rac_ci_on_enter,
625 .action = st_wait_resolve_rac_ci,
626 },
627 [NACC_ST_WAIT_REQUEST_SI] = {
628 .in_event_mask =
629 X(NACC_EV_RX_CELL_CHG_NOTIFICATION) |
630 X(NACC_EV_RX_SI),
631 .out_state_mask =
Pau Espin Pedrol41a22a72021-01-26 19:00:37 +0100632 X(NACC_ST_TX_NEIGHBOUR_DATA) |
633 X(NACC_ST_TX_CELL_CHG_CONTINUE),
Pau Espin Pedrolc0a250d2021-01-21 18:46:13 +0100634 .name = "WAIT_REQUEST_SI",
635 .onenter = st_wait_request_si_on_enter,
636 .action = st_wait_request_si,
637 },
638 [NACC_ST_TX_NEIGHBOUR_DATA] = {
639 .in_event_mask =
640 X(NACC_EV_RX_CELL_CHG_NOTIFICATION) |
Pau Espin Pedrolc0a250d2021-01-21 18:46:13 +0100641 X(NACC_EV_CREATE_RLCMAC_MSG),
642 .out_state_mask =
643 X(NACC_ST_TX_CELL_CHG_CONTINUE),
644 .name = "TX_NEIGHBOUR_DATA",
645 .action = st_tx_neighbour_data,
646 },
647 [NACC_ST_TX_CELL_CHG_CONTINUE] = {
648 .in_event_mask =
649 X(NACC_EV_RX_CELL_CHG_NOTIFICATION) |
Pau Espin Pedrolc0a250d2021-01-21 18:46:13 +0100650 X(NACC_EV_CREATE_RLCMAC_MSG),
651 .out_state_mask =
Pau Espin Pedrol952cb3d2021-02-01 14:52:48 +0100652 X(NACC_ST_WAIT_CELL_CHG_CONTINUE_ACK),
Pau Espin Pedrolc0a250d2021-01-21 18:46:13 +0100653 .name = "TX_CELL_CHG_CONTINUE",
Pau Espin Pedrol1aef1132021-02-01 19:33:59 +0100654 .action = st_cell_chg_continue,
Pau Espin Pedrolc0a250d2021-01-21 18:46:13 +0100655 },
Pau Espin Pedrol952cb3d2021-02-01 14:52:48 +0100656 [NACC_ST_WAIT_CELL_CHG_CONTINUE_ACK] = {
657 .in_event_mask =
658 X(NACC_EV_RX_CELL_CHG_CONTINUE_ACK) |
659 X(NACC_EV_TIMEOUT_CELL_CHG_CONTINUE),
660 .out_state_mask =
661 X(NACC_ST_TX_CELL_CHG_CONTINUE) |
662 X(NACC_ST_DONE),
663 .name = "WAIT_CELL_CHG_CONTINUE_ACK",
664 .action = st_wait_cell_chg_continue_ack,
665 },
Pau Espin Pedrolc0a250d2021-01-21 18:46:13 +0100666 [NACC_ST_DONE] = {
667 .in_event_mask = 0,
668 .out_state_mask = 0,
669 .name = "DONE",
670 .onenter = st_done_on_enter,
671 },
672};
673
674static struct osmo_fsm nacc_fsm = {
675 .name = "NACC",
676 .states = nacc_fsm_states,
677 .num_states = ARRAY_SIZE(nacc_fsm_states),
Pau Espin Pedrol41a22a72021-01-26 19:00:37 +0100678 .timer_cb = nacc_fsm_timer_cb,
Pau Espin Pedrolc0a250d2021-01-21 18:46:13 +0100679 .cleanup = nacc_fsm_cleanup,
680 .log_subsys = DNACC,
681 .event_names = nacc_fsm_event_names,
682};
683
684static __attribute__((constructor)) void nacc_fsm_init(void)
685{
686 OSMO_ASSERT(osmo_fsm_register(&nacc_fsm) == 0);
687}
688
689void nacc_fsm_ctrl_reply_cb(struct ctrl_handle *ctrl, struct ctrl_cmd *cmd, void *data)
690{
691 struct nacc_fsm_ctx *ctx = (struct nacc_fsm_ctx *)data;
692 char *tmp = NULL, *tok, *saveptr;
Pau Espin Pedrol069a6372021-02-10 17:33:13 +0100693 unsigned int exp_id;
Pau Espin Pedrolc0a250d2021-01-21 18:46:13 +0100694
Pau Espin Pedrol069a6372021-02-10 17:33:13 +0100695 LOGPFSML(ctx->fi, LOGL_NOTICE, "Received CTRL message: type=%d %s %s: %s\n",
696 cmd->type, cmd->variable, cmd->id, osmo_escape_str(cmd->reply, -1));
Pau Espin Pedrolc0a250d2021-01-21 18:46:13 +0100697
698 if (cmd->type != CTRL_TYPE_GET_REPLY || !cmd->reply) {
Pau Espin Pedrola06ac182021-01-26 19:13:43 +0100699 nacc_fsm_state_chg(ctx->fi, NACC_ST_TX_CELL_CHG_CONTINUE);
Pau Espin Pedrolc0a250d2021-01-21 18:46:13 +0100700 return;
701 }
702
Pau Espin Pedrol069a6372021-02-10 17:33:13 +0100703 /* Validate it's the seqnum from our last GET cmd, and not from older
704 * one we may have requested in case MS decided to resend Pkt Cell
705 * Change Notify with a different tgt cell:
706 */
707 exp_id = arfcn_bsic_2_ctrl_id(ctx->neigh_key.tgt_arfcn, ctx->neigh_key.tgt_bsic);
708 if ((unsigned int)atoi(cmd->id) != exp_id) {
709 LOGPFSML(ctx->fi, LOGL_INFO,
710 "Received CTRL message with id=%s doesn't match our expected last id=%d, ignoring\n",
711 cmd->id, exp_id);
712 return;
713 }
714
Pau Espin Pedrolc0a250d2021-01-21 18:46:13 +0100715 /* TODO: Potentially validate cmd->variable contains same params as we
716 sent, and that cmd->id matches the original set. We may want to keep
717 the original cmd around by setting cmd->defer=1 when sending it. */
718
719 tmp = talloc_strdup(cmd, cmd->reply);
720 if (!tmp)
721 goto free_ret;
722
723 if (!(tok = strtok_r(tmp, "-", &saveptr)))
724 goto free_ret;
725 ctx->cgi_ps.rai.lac.plmn.mcc = atoi(tok);
726
727 if (!(tok = strtok_r(NULL, "-", &saveptr)))
728 goto free_ret;
729 ctx->cgi_ps.rai.lac.plmn.mnc = atoi(tok);
730
731 if (!(tok = strtok_r(NULL, "-", &saveptr)))
732 goto free_ret;
733 ctx->cgi_ps.rai.lac.lac = atoi(tok);
734
735 if (!(tok = strtok_r(NULL, "-", &saveptr)))
736 goto free_ret;
737 ctx->cgi_ps.rai.rac = atoi(tok);
738
739 if (!(tok = strtok_r(NULL, "\0", &saveptr)))
740 goto free_ret;
741 ctx->cgi_ps.cell_identity = atoi(tok);
742
743 /* Cache the cgi_ps so we can avoid requesting again same resolution for a while */
744 neigh_cache_add(ctx->ms->bts->pcu->neigh_cache, &ctx->neigh_key, &ctx->cgi_ps);
745
746 osmo_fsm_inst_dispatch(ctx->fi, NACC_EV_RX_RAC_CI, NULL);
747 return;
748
749free_ret:
750 talloc_free(tmp);
Pau Espin Pedrola06ac182021-01-26 19:13:43 +0100751 nacc_fsm_state_chg(ctx->fi, NACC_ST_TX_CELL_CHG_CONTINUE);
Pau Espin Pedrolc0a250d2021-01-21 18:46:13 +0100752 return;
753}
754
755static int nacc_fsm_ctx_talloc_destructor(struct nacc_fsm_ctx *ctx)
756{
757 if (ctx->fi) {
758 osmo_fsm_inst_free(ctx->fi);
759 ctx->fi = NULL;
760 }
761
762 if (ctx->neigh_ctrl_conn) {
763 if (ctx->neigh_ctrl_conn->write_queue.bfd.fd != -1) {
764 osmo_wqueue_clear(&ctx->neigh_ctrl_conn->write_queue);
765 osmo_fd_unregister(&ctx->neigh_ctrl_conn->write_queue.bfd);
766 close(ctx->neigh_ctrl_conn->write_queue.bfd.fd);
767 ctx->neigh_ctrl_conn->write_queue.bfd.fd = -1;
768 }
769 }
770
771 return 0;
772}
773
774struct nacc_fsm_ctx *nacc_fsm_alloc(struct GprsMs* ms)
775{
Pau Espin Pedrolc0a250d2021-01-21 18:46:13 +0100776 struct nacc_fsm_ctx *ctx = talloc_zero(ms, struct nacc_fsm_ctx);
777 char buf[64];
Pau Espin Pedrolc0a250d2021-01-21 18:46:13 +0100778
779 talloc_set_destructor(ctx, nacc_fsm_ctx_talloc_destructor);
780
781 ctx->ms = ms;
782
783 snprintf(buf, sizeof(buf), "TLLI-0x%08x", ms_tlli(ms));
784 ctx->fi = osmo_fsm_inst_alloc(&nacc_fsm, ctx, ctx, LOGL_INFO, buf);
785 if (!ctx->fi)
786 goto free_ret;
787
788 ctx->neigh_ctrl = ctrl_handle_alloc(ctx, ctx, NULL);
789 ctx->neigh_ctrl->reply_cb = nacc_fsm_ctrl_reply_cb;
790 ctx->neigh_ctrl_conn = osmo_ctrl_conn_alloc(ctx, ctx->neigh_ctrl);
791 if (!ctx->neigh_ctrl_conn)
792 goto free_ret;
Pau Espin Pedrol202a4782021-01-27 17:05:12 +0100793 /* Older versions of osmo_ctrl_conn_alloc didn't properly initialize fd to -1,
794 * so make sure to do it here otherwise fd may be valid fd 0 and cause trouble */
795 ctx->neigh_ctrl_conn->write_queue.bfd.fd = -1;
Pau Espin Pedrolc0a250d2021-01-21 18:46:13 +0100796 llist_add(&ctx->neigh_ctrl_conn->list_entry, &ctx->neigh_ctrl->ccon_list);
797
Pau Espin Pedrolc0a250d2021-01-21 18:46:13 +0100798 return ctx;
799free_ret:
800 talloc_free(ctx);
801 return NULL;
802}