Neels Hofmeyr has uploaded this change for review. (
https://gerrit.osmocom.org/13578
Change subject: BSSMAP: add messages for inter-BSC and inter-MSC Handover
......................................................................
BSSMAP: add messages for inter-BSC and inter-MSC Handover
Change-Id: I9dac375331f6bea744769e973725d58e35f87226
---
M include/osmocom/gsm/gsm0808.h
M src/gsm/gsm0808.c
M src/gsm/libosmogsm.map
3 files changed, 241 insertions(+), 0 deletions(-)
git pull ssh://gerrit.osmocom.org:29418/libosmocore refs/changes/78/13578/1
diff --git a/include/osmocom/gsm/gsm0808.h b/include/osmocom/gsm/gsm0808.h
index a6c5239..b31f07d 100644
--- a/include/osmocom/gsm/gsm0808.h
+++ b/include/osmocom/gsm/gsm0808.h
@@ -27,6 +27,7 @@
#include <osmocom/gsm/protocol/gsm_08_08.h>
#include <osmocom/gsm/gsm0808_utils.h>
#include <osmocom/gsm/gsm23003.h>
+#include <osmocom/gsm/protocol/gsm_23_003.h>
#include <osmocom/core/utils.h>
#define BSSMAP_MSG_SIZE 1024
@@ -143,6 +144,56 @@
};
struct msgb *gsm0808_create_handover_required(const struct
gsm0808_handover_required *params);
+/*! 3GPP TS 48.008 §3.2.1.37 HANDOVER REQUIRED REJECT */
+struct gsm0808_handover_required_reject {
+ uint16_t cause;
+
+ /* more items are defined in the spec and may be added later */
+ bool more_items; /*< always set this to false */
+};
+struct msgb *gsm0808_create_handover_required_reject(const struct
gsm0808_handover_required_reject *params);
+
+/*! 3GPP TS 48.008 §3.2.1.8 HANDOVER REQUEST */
+struct gsm0808_handover_request {
+ struct gsm0808_channel_type channel_type;
+ struct gsm0808_encrypt_info encryption_information;
+ struct osmo_gsm48_classmark classmark_information;
+ struct gsm0808_cell_id cell_identifier_serving;
+ struct gsm0808_cell_id cell_identifier_target;
+ enum gsm0808_cause cause;
+
+ bool current_channel_type_1_present;
+ uint8_t current_channel_type_1;
+
+ enum gsm0808_permitted_speech speech_version_used;
+
+ uint8_t chosen_encryption_algorithm_serving;
+
+ /*! Pass either old_bss_to_new_bss_info or old_bss_to_new_bss_info_raw.
*/
+ bool old_bss_to_new_bss_info_present;
+ struct gsm0808_old_bss_to_new_bss_info old_bss_to_new_bss_info;
+ /*! To feed the Old BSS to New BSS Information IE unchanged from the
Handover Required message without having to
+ * decode it. Pass either old_bss_to_new_bss_info or
old_bss_to_new_bss_info_raw. Omit the TL part. */
+ const uint8_t *old_bss_to_new_bss_info_raw;
+ uint8_t old_bss_to_new_bss_info_raw_len;
+
+ const char *imsi;
+
+ const struct sockaddr_storage *aoip_transport_layer;
+
+ const struct gsm0808_speech_codec_list *codec_list_msc_preferred;
+
+ bool call_id_present;
+ uint32_t call_id;
+
+ const uint8_t *global_call_reference;
+ uint8_t global_call_reference_len;
+
+ /* more items are defined in the spec and may be added later */
+ bool more_items; /*!< always set this to false */
+};
+struct msgb *gsm0808_create_handover_request(const struct
gsm0808_handover_request *params);
+
struct gsm0808_handover_request_ack {
const uint8_t *l3_info;
uint8_t l3_info_len;
@@ -170,7 +221,22 @@
uint8_t chosen_channel,
uint8_t chosen_encr_alg,
uint8_t chosen_speech_version);
+struct gsm0808_handover_command {
+ const uint8_t *l3_info;
+ uint8_t l3_info_len;
+
+ struct gsm0808_cell_id cell_identifier;
+
+ const uint8_t *new_bss_to_old_bss_info_raw;
+ size_t new_bss_to_old_bss_info_raw_len;
+
+ /* more items are defined in the spec and may be added later */
+ bool more_items; /*!< always set this to false */
+};
+struct msgb *gsm0808_create_handover_command(const struct
gsm0808_handover_command *params);
+
struct msgb *gsm0808_create_handover_detect();
+struct msgb *gsm0808_create_handover_succeeded();
struct gsm0808_handover_complete {
bool rr_cause_present;
diff --git a/src/gsm/gsm0808.c b/src/gsm/gsm0808.c
index b46977b..3c77c77 100644
--- a/src/gsm/gsm0808.c
+++ b/src/gsm/gsm0808.c
@@ -857,6 +857,129 @@
return msg;
}
+/*! Create BSSMAP HANDOVER REQUIRED REJECT message.
+ * \returns newly allocated msgb with BSSMAP HANDOVER REQUIRED REJECT message.
*/
+struct msgb *gsm0808_create_handover_required_reject(const struct
gsm0808_handover_required_reject *params)
+{
+ struct msgb *msg;
+
+ msg = msgb_alloc_headroom(BSSMAP_MSG_SIZE, BSSMAP_MSG_HEADROOM,
"BSSMAP-HANDOVER-REQUIRED-REJECT");
+ if (!msg)
+ return NULL;
+
+ /* Message Type, 3.2.2.1 */
+ msgb_v_put(msg, BSS_MAP_MSG_HANDOVER_REQUIRED_REJECT);
+
+ /* Cause, 3.2.2.5 */
+ gsm0808_enc_cause(msg, params->cause);
+
+ /* prepend the header */
+ msg->l3h = msgb_tv_push(msg, BSSAP_MSG_BSS_MANAGEMENT,
msgb_length(msg));
+
+ return msg;
+}
+
+/*! Create BSSMAP HANDOVER REQUEST message, 3GPP TS 48.008 3.2.1.8.
+ * Sent from the MSC to the potential new target cell during inter-BSC
handover, or to the target MSC during inter-MSC
+ * handover.
+ */
+struct msgb *gsm0808_create_handover_request(const struct
gsm0808_handover_request *params)
+{
+ struct msgb *msg;
+
+ msg = msgb_alloc_headroom(BSSMAP_MSG_SIZE, BSSMAP_MSG_HEADROOM,
"BSSMAP-HANDOVER-REQUEST");
+ if (!msg)
+ return NULL;
+
+ /* Message Type, 3.2.2.1 */
+ msgb_v_put(msg, BSS_MAP_MSG_HANDOVER_RQST);
+
+ /* Channel Type 3.2.2.11 */
+ gsm0808_enc_channel_type(msg, ¶ms->channel_type);
+
+ /* Encryption Information 3.2.2.10 */
+ gsm0808_enc_encrypt_info(msg, ¶ms->encryption_information);
+
+ /* Classmark Information 1 3.2.2.30 or Classmark Information 2 3.2.2.19
(Classmark 2 wins) */
+ if (params->classmark_information.classmark2_len) {
+ msgb_tlv_put(msg, GSM0808_IE_CLASSMARK_INFORMATION_T2,
+ params->classmark_information.classmark2_len,
+ (const
uint8_t*)¶ms->classmark_information.classmark2);
+ } else if (params->classmark_information.classmark1_set) {
+ msgb_tlv_put(msg, GSM0808_IE_CLASSMARK_INFORMATION_TYPE_1,
+ sizeof(params->classmark_information.classmark1),
+ (const
uint8_t*)¶ms->classmark_information.classmark1);
+ }
+ /* (Classmark 3 possibly follows below) */
+
+ /* Cell Identifier (Serving) , 3.2.2.17 */
+ gsm0808_enc_cell_id(msg, ¶ms->cell_identifier_serving);
+
+ /* Cell Identifier (Target) , 3.2.2.17 */
+ gsm0808_enc_cell_id(msg, ¶ms->cell_identifier_target);
+
+ /* Cause, 3.2.2.5 */
+ gsm0808_enc_cause(msg, params->cause);
+
+ /* Classmark Information 3 3.2.2.20 */
+ if (params->classmark_information.classmark3_len) {
+ msgb_tlv_put(msg, GSM0808_IE_CLASSMARK_INFORMATION_T3,
+ params->classmark_information.classmark3_len,
+ (const
uint8_t*)¶ms->classmark_information.classmark3);
+ }
+
+ /* Current Channel type 1 3.2.2.49 */
+ if (params->current_channel_type_1_present)
+ msgb_tv_fixed_put(msg, GSM0808_IE_CURRENT_CHANNEL_TYPE_1, 1,
¶ms->current_channel_type_1);
+
+ /* Speech Version (Used), 3.2.2.51 */
+ if (params->speech_version_used) {
+ msgb_tv_put(msg, GSM0808_IE_SPEECH_VERSION,
params->speech_version_used);
+ }
+
+ /* Chosen Encryption Algorithm (Serving) 3.2.2.44 */
+ if (params->chosen_encryption_algorithm_serving)
+ msgb_tv_put(msg, GSM0808_IE_CHOSEN_ENCR_ALG,
params->chosen_encryption_algorithm_serving);
+
+ /* Old BSS to New BSS Information 3.2.2.58 */
+ if (params->old_bss_to_new_bss_info_raw &&
params->old_bss_to_new_bss_info_raw_len) {
+ msgb_tlv_put(msg, GSM0808_IE_OLD_BSS_TO_NEW_BSS_INFORMATION,
+ params->old_bss_to_new_bss_info_raw_len,
+ params->old_bss_to_new_bss_info_raw);
+ } else if (params->old_bss_to_new_bss_info_present) {
+ put_old_bss_to_new_bss_information(msg,
¶ms->old_bss_to_new_bss_info);
+ }
+
+ /* IMSI 3.2.2.6 */
+ if (params->imsi) {
+ uint8_t mid_buf[GSM48_MI_SIZE + 2];
+ int mid_len = gsm48_generate_mid_from_imsi(mid_buf,
params->imsi);
+ msgb_tlv_put(msg, GSM0808_IE_IMSI, mid_len - 2, mid_buf + 2);
+ }
+
+ if (params->aoip_transport_layer)
+ gsm0808_enc_aoip_trasp_addr(msg, params->aoip_transport_layer);
+
+ if (params->codec_list_msc_preferred)
+ gsm0808_enc_speech_codec_list(msg,
params->codec_list_msc_preferred);
+
+ if (params->call_id_present) {
+ uint8_t val[4];
+ osmo_store32le(params->call_id, val);
+ msgb_tv_fixed_put(msg, GSM0808_IE_CALL_ID, 4, val);
+ }
+
+ if (params->global_call_reference && params->global_call_reference_len)
{
+ msgb_tlv_put(msg, GSM0808_IE_GLOBAL_CALL_REF,
+ params->global_call_reference_len,
params->global_call_reference);
+ }
+
+ /* prepend header with final length */
+ msg->l3h = msgb_tv_push(msg, BSSAP_MSG_BSS_MANAGEMENT,
msgb_length(msg));
+
+ return msg;
+}
+
/*! Create BSSMAP HANDOVER REQUEST ACKNOWLEDGE message, 3GPP TS 48.008
3.2.1.10.
* Sent from the MT BSC back to the MSC when it has allocated an lchan to
handover to.
* l3_info is the RR Handover Command that the MO BSC sends to the MS to move
over. */
@@ -914,6 +1037,35 @@
return gsm0808_create_handover_request_ack2(¶ms);
}
+/*! Create BSSMAP HANDOVER COMMAND message, 3GPP TS 48.008 3.2.1.11.
+ * Sent from the MSC to the old BSS to transmit the RR Handover Command
received from the new BSS. */
+struct msgb *gsm0808_create_handover_command(const struct
gsm0808_handover_command *params)
+{
+ struct msgb *msg;
+
+ msg = msgb_alloc_headroom(BSSMAP_MSG_SIZE, BSSMAP_MSG_HEADROOM,
"BSSMAP-HANDOVER-COMMAND");
+ if (!msg)
+ return NULL;
+
+ /* Message Type, 3.2.2.1 */
+ msgb_v_put(msg, BSS_MAP_MSG_HANDOVER_CMD);
+
+ msgb_tlv_put(msg, GSM0808_IE_LAYER_3_INFORMATION, params->l3_info_len,
params->l3_info);
+
+ if (params->cell_identifier.id_discr != CELL_IDENT_NO_CELL)
+ gsm0808_enc_cell_id(msg, ¶ms->cell_identifier);
+
+ if (params->new_bss_to_old_bss_info_raw
+ && params->new_bss_to_old_bss_info_raw_len)
+ msgb_tlv_put(msg, GSM0808_IE_NEW_BSS_TO_OLD_BSS_INFO,
params->new_bss_to_old_bss_info_raw_len,
+ params->new_bss_to_old_bss_info_raw);
+
+ /* prepend header with final length */
+ msg->l3h = msgb_tv_push(msg, BSSAP_MSG_BSS_MANAGEMENT,
msgb_length(msg));
+
+ return msg;
+}
+
/*! Create BSSMAP HANDOVER DETECT message, 3GPP TS 48.008 3.2.1.40.
* Sent from the MT BSC back to the MSC when the MS has sent a handover RACH
request and the MT BSC has
* received the Handover Detect message. */
@@ -934,6 +1086,25 @@
return msg;
}
+/*! Create BSSMAP HANDOVER SUCCEEDED message, 3GPP TS 48.008 3.2.1.13.
+ * Sent from the MSC back to the old BSS to notify that the MS has
successfully accessed the new BSS. */
+struct msgb *gsm0808_create_handover_succeeded()
+{
+ struct msgb *msg;
+
+ msg = msgb_alloc_headroom(BSSMAP_MSG_SIZE, BSSMAP_MSG_HEADROOM,
"BSSMAP-HANDOVER-DETECT");
+ if (!msg)
+ return NULL;
+
+ /* Message Type, 3.2.2.1 */
+ msgb_v_put(msg, BSS_MAP_MSG_HANDOVER_SUCCEEDED);
+
+ /* prepend header with final length */
+ msg->l3h = msgb_tv_push(msg, BSSAP_MSG_BSS_MANAGEMENT,
msgb_length(msg));
+
+ return msg;
+}
+
/*! Create BSSMAP HANDOVER COMPLETE message, 3GPP TS 48.008 3.2.1.12.
* Sent from the MT BSC back to the MSC when the MS has fully settled into the
new lchan. */
struct msgb *gsm0808_create_handover_complete(const struct
gsm0808_handover_complete *params)
diff --git a/src/gsm/libosmogsm.map b/src/gsm/libosmogsm.map
index 5e1b58e..1e40af7 100644
--- a/src/gsm/libosmogsm.map
+++ b/src/gsm/libosmogsm.map
@@ -183,9 +183,13 @@
gsm0808_create_reset_ack;
gsm0808_create_sapi_reject;
gsm0808_create_handover_required;
+gsm0808_create_handover_required_reject;
+gsm0808_create_handover_request;
gsm0808_create_handover_request_ack;
gsm0808_create_handover_request_ack2;
+gsm0808_create_handover_command;
gsm0808_create_handover_detect;
+gsm0808_create_handover_succeeded;
gsm0808_create_handover_complete;
gsm0808_create_handover_failure;
gsm0808_create_handover_performed;
--
To view, visit https://gerrit.osmocom.org/13578
To unsubscribe, or for help writing mail filters, visit
https://gerrit.osmocom.org/settings
Gerrit-Project: libosmocore
Gerrit-Branch: master
Gerrit-MessageType: newchange
Gerrit-Change-Id: I9dac375331f6bea744769e973725d58e35f87226
Gerrit-Change-Number: 13578
Gerrit-PatchSet: 1
Gerrit-Owner: Neels Hofmeyr <[email protected]>
