gsm_map 1.0.0

GSM MAP (Mobile Application Part) operations per 3GPP TS 29.002 — SMS (MO/MT-ForwardSM, SRI-for-SM), mobility, authentication, USSD, supplementary services — as BER-codable ASN.1 types, with optional Rust-backed Python bindings
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108

//! Location Management operations — 3GPP TS 29.002.
//!
//! - updateLocation (op 2)
//! - cancelLocation (op 3)
//! - purgeMS (op 67)
//! - sendIdentification (op 55)

use rasn::prelude::*;

use crate::types::{Imsi, IsdnAddressString, Lmsi};

/// UpdateLocation-Arg (op 2).
#[derive(Debug, Clone, PartialEq, Eq, AsnType, Decode, Encode)]
pub struct UpdateLocationArg {
    /// IMSI of the subscriber.
    pub imsi: Imsi,
    /// ISDN number of the MSC/VLR.
    #[rasn(tag(context, 1))]
    pub msc_number: IsdnAddressString,
    /// VLR number.
    pub vlr_number: IsdnAddressString,
    /// LMSI assigned by the VLR.
    #[rasn(tag(context, 10))]
    pub lmsi: Option<Lmsi>,
    /// VLR capability (v3).
    #[rasn(tag(context, 6))]
    pub vlr_capability: Option<OctetString>,
}

/// UpdateLocation-Res (op 2).
#[derive(Debug, Clone, PartialEq, Eq, AsnType, Decode, Encode)]
pub struct UpdateLocationRes {
    /// HLR number.
    pub hlr_number: IsdnAddressString,
}

/// CancellationType for cancelLocation.
#[derive(Debug, Clone, Copy, PartialEq, Eq, AsnType, Decode, Encode)]
#[rasn(enumerated)]
pub enum CancellationType {
    UpdateProcedure = 0,
    SubscriptionWithdraw = 1,
    InitialAttachProcedure = 2,
}

/// CancelLocation-Arg (op 3).
#[derive(Debug, Clone, PartialEq, Eq, AsnType, Decode, Encode)]
pub struct CancelLocationArg {
    /// IMSI of the subscriber.
    pub identity: Imsi,
    /// Cancellation type.
    pub cancellation_type: Option<CancellationType>,
}

/// CancelLocation-Res (op 3).
#[derive(Debug, Clone, PartialEq, Eq, AsnType, Decode, Encode)]
pub struct CancelLocationRes {}

/// PurgeMS-Arg (op 67).
#[derive(Debug, Clone, PartialEq, Eq, AsnType, Decode, Encode)]
pub struct PurgeMsArg {
    /// IMSI of the subscriber.
    pub imsi: Imsi,
    /// VLR number.
    #[rasn(tag(context, 0))]
    pub vlr_number: Option<IsdnAddressString>,
    /// SGSN number.
    #[rasn(tag(context, 1))]
    pub sgsn_number: Option<IsdnAddressString>,
}

/// PurgeMS-Res (op 67).
#[derive(Debug, Clone, PartialEq, Eq, AsnType, Decode, Encode)]
pub struct PurgeMsRes {
    /// Freeze TMSI flag.
    #[rasn(tag(context, 0))]
    pub freeze_tmsi: Option<()>,
    /// Freeze P-TMSI flag.
    #[rasn(tag(context, 1))]
    pub freeze_p_tmsi: Option<()>,
}

/// SendIdentification-Arg (op 55).
#[derive(Debug, Clone, PartialEq, Eq, AsnType, Decode, Encode)]
pub struct SendIdentificationArg {
    /// TMSI.
    pub tmsi: OctetString,
    /// Number of requested authentication vectors.
    pub number_of_requested_vectors: Option<Integer>,
}

/// SendIdentification-Res (op 55).
#[derive(Debug, Clone, PartialEq, Eq, AsnType, Decode, Encode)]
pub struct SendIdentificationRes {
    /// IMSI of the subscriber.
    pub imsi: Imsi,
    /// Authentication set list (opaque).
    #[rasn(tag(context, 0))]
    pub authentication_set_list: Option<OctetString>,
}

/// Operation codes for location management.
pub mod op_codes {
    pub const UPDATE_LOCATION: i64 = 2;
    pub const CANCEL_LOCATION: i64 = 3;
    pub const PURGE_MS: i64 = 67;
    pub const SEND_IDENTIFICATION: i64 = 55;
}