gsm29118: add generator functions for GSM29118 messages

We already have some GSM29118 related definitions and functions in
libosmocore. Lets also add some functions to generate GSM29118 messages
(similar to those we have for GSM0808).

Change-Id: Ic87f8a771b87b52215d0a7451b67794557b80b8a
Related: OS#3615

3 files changed, 73 insertions, 0 deletions

diff --git a/include/Makefile.am b/include/Makefile.am
index 59a5feda..366fd70b 100644
--- a/include/Makefile.am
+++ b/include/Makefile.am
@@ -88,6 +88,7 @@ nobase_include_HEADERS = \
                        osmocom/gsm/gsm0808.h \
                        osmocom/gsm/gsm0808_utils.h \
                        osmocom/gsm/gsm23003.h \
+                       osmocom/gsm/gsm29118.h \
                        osmocom/gsm/gsm48.h \
                        osmocom/gsm/gsm48_ie.h \
                        osmocom/gsm/gsm_utils.h \
diff --git a/include/osmocom/gsm/gsm29118.h b/include/osmocom/gsm/gsm29118.h
new file mode 100644
index 00000000..e81cce4c
--- /dev/null
+++ b/include/osmocom/gsm/gsm29118.h
@@ -0,0 +1,65 @@
+/*! \file gsm23003.h */
+
+/* (C) 2018 by sysmocom s.f.m.c. GmbH
+ * All Rights Reserved
+ *
+ * Author: Harald Welte, Philipp Maier
+ *
+ * SPDX-License-Identifier: GPL-2.0+
+ *
+ * This program is free software; you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation; either version 2 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 General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License along
+ * with this program; if not, write to the Free Software Foundation, Inc.,
+ * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
+ *
+ */
+
+#pragma once
+
+#include <osmocom/core/msgb.h>
+#include <osmocom/gsm/gsm23003.h>
+#include <osmocom/gsm/protocol/gsm_29_118.h>
+#include <osmocom/gsm/protocol/gsm_04_08.h>
+
+/*! 3GPP TS 3GPP TS 29.018 8.14 SGsAP-PAGING-REQUEST. */
+struct gsm29118_paging_req {
+	char imsi[GSM48_MI_SIZE];
+	char vlr_name[SGS_VLR_NAME_MAXLEN + 1];
+	uint8_t serv_ind;
+
+	bool lai_present;
+	struct osmo_location_area_id lai;
+};
+
+/*! 3GPP TS 3GPP TS 29.018 8.15 SGsAP-RESET-ACK and 8.16 SGsAP-RESET-INDICATION. */
+struct gsm29118_reset_msg {
+	bool vlr_name_present;
+	char vlr_name[SGS_VLR_NAME_MAXLEN + 1];
+	bool mme_name_present;
+	char mme_name[SGS_MME_NAME_LEN + 1];
+};
+
+struct msgb *gsm29118_msgb_alloc(void);
+struct msgb *gsm29118_create_alert_req(const char *imsi);
+struct msgb *gsm29118_create_dl_ud(const char *imsi, struct msgb *nas_msg);
+struct msgb *gsm29118_create_eps_det_ack(const char *imsi);
+struct msgb *gsm29118_create_imsi_det_ack(const char *imsi);
+struct msgb *gsm29118_create_lu_ack(const char *imsi, const struct osmo_location_area_id *lai, const uint8_t *new_id,
+				    unsigned int new_id_len);
+struct msgb *gsm29118_create_lu_rej(const char *imsi, uint8_t rej_cause, const struct osmo_location_area_id *lai);
+struct msgb *gsm29118_create_mm_info_req(const char *imsi, const uint8_t *mm_info, uint8_t mm_info_len);
+struct msgb *gsm29118_create_paging_req(struct gsm29118_paging_req *params);
+struct msgb *gsm29118_create_reset_ack(struct gsm29118_reset_msg *params);
+struct msgb *gsm29118_create_reset_ind(struct gsm29118_reset_msg *params);
+struct msgb *gsm29118_create_status(const char *imsi, enum sgsap_sgs_cause cause, const struct msgb *err_msg);
+struct msgb *gsm29118_create_release_req(const char *imsi, const uint8_t sgs_cause);
+struct msgb *gsm29118_create_service_abort_req(const char *imsi);
diff --git a/include/osmocom/gsm/protocol/gsm_29_118.h b/include/osmocom/gsm/protocol/gsm_29_118.h
index 70f15003..cfe772aa 100644
--- a/include/osmocom/gsm/protocol/gsm_29_118.h
+++ b/include/osmocom/gsm/protocol/gsm_29_118.h
@@ -173,4 +173,11 @@ static inline const char *sgsap_ue_emm_mode_name(enum sgsap_ue_emm_mode mode) {
 /* TS 29.118 Section 6.3 */
 #define SGS_PORT_DEFAULT 29118
 
+/* TS 29.118 Section 9.4.13 MME Name */
+#define SGS_MME_NAME_LEN 55
+
+/* TS 29.118 Section 9.4.22 VLR name
+ * See also: RFC1123 Section 2.1 Host Names and Numbers */
+#define SGS_VLR_NAME_MAXLEN 255
+
 const struct tlv_definition sgsap_ie_tlvdef;