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
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152

//! Subscriber Information operations — 3GPP TS 29.002.
//!
//! - provideSubscriberInfo (op 70)
//! - anyTimeInterrogation (op 71)
//! - anyTimeSubscriberDataModification (op 65)

use rasn::prelude::*;

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

/// SubscriberState.
#[derive(Debug, Clone, Copy, PartialEq, Eq, AsnType, Decode, Encode)]
#[rasn(enumerated)]
pub enum SubscriberState {
    AssumedIdle = 0,
    CamelBusy = 1,
    NetDetNotReachable = 2,
    NotProvidedFromVlr = 3,
}

/// GeographicalInformation — 8 bytes.
pub type GeographicalInformation = OctetString;

/// CellGlobalIdOrServiceAreaIdOrLAI.
pub type CellGlobalIdOrServiceAreaIdOrLai = OctetString;

/// LocationInformationWithLMSI — extended location info.
#[derive(Debug, Clone, PartialEq, Eq, AsnType, Decode, Encode)]
pub struct SubscriberLocationInfo {
    #[rasn(tag(context, 0))]
    pub age_of_location_information: Option<Integer>,
    #[rasn(tag(context, 1))]
    pub geographical_information: Option<GeographicalInformation>,
    #[rasn(tag(context, 2))]
    pub vlr_number: Option<IsdnAddressString>,
    #[rasn(tag(context, 3))]
    pub location_number: Option<OctetString>,
    #[rasn(tag(context, 4))]
    pub cell_global_id_or_service_area_id_or_lai: Option<CellGlobalIdOrServiceAreaIdOrLai>,
    #[rasn(tag(context, 8))]
    pub selected_lsa_id: Option<OctetString>,
    #[rasn(tag(context, 9))]
    pub msc_number: Option<IsdnAddressString>,
    #[rasn(tag(context, 13))]
    pub sai_present: Option<()>,
}

/// SubscriberInfo — returned by provideSubscriberInfo and anyTimeInterrogation.
#[derive(Debug, Clone, PartialEq, Eq, AsnType, Decode, Encode)]
pub struct SubscriberInfo {
    #[rasn(tag(context, 0))]
    pub location_information: Option<SubscriberLocationInfo>,
    #[rasn(tag(context, 1))]
    pub subscriber_state: Option<SubscriberState>,
    #[rasn(tag(context, 4))]
    pub imei: Option<OctetString>,
    #[rasn(tag(context, 5))]
    pub ms_classmark2: Option<OctetString>,
    #[rasn(tag(context, 6))]
    pub gprs_ms_class: Option<OctetString>,
    #[rasn(tag(context, 11))]
    pub mn_p_info_res: Option<OctetString>,
}

/// RequestedInfo — specifies what info to return.
#[derive(Debug, Clone, PartialEq, Eq, AsnType, Decode, Encode)]
pub struct RequestedInfo {
    #[rasn(tag(context, 0))]
    pub location_information: Option<()>,
    #[rasn(tag(context, 1))]
    pub subscriber_state: Option<()>,
    #[rasn(tag(context, 3))]
    pub current_location: Option<()>,
    #[rasn(tag(context, 6))]
    pub imei: Option<()>,
    #[rasn(tag(context, 7))]
    pub ms_classmark: Option<()>,
    #[rasn(tag(context, 8))]
    pub mn_p_requested_info: Option<()>,
}

/// ProvideSubscriberInfo-Arg (op 70).
#[derive(Debug, Clone, PartialEq, Eq, AsnType, Decode, Encode)]
pub struct ProvideSubscriberInfoArg {
    #[rasn(tag(context, 0))]
    pub imsi: Imsi,
    #[rasn(tag(context, 1))]
    pub lmsi: Option<OctetString>,
    #[rasn(tag(context, 2))]
    pub requested_info: RequestedInfo,
}

/// ProvideSubscriberInfo-Res (op 70).
#[derive(Debug, Clone, PartialEq, Eq, AsnType, Decode, Encode)]
pub struct ProvideSubscriberInfoRes {
    pub subscriber_info: SubscriberInfo,
}

/// SubscriberIdentity — CHOICE used in ATI.
#[derive(Debug, Clone, PartialEq, Eq, AsnType, Decode, Encode)]
#[rasn(choice)]
pub enum SubscriberIdentity {
    #[rasn(tag(context, 0))]
    Imsi(Imsi),
    #[rasn(tag(context, 1))]
    Msisdn(IsdnAddressString),
}

/// AnyTimeInterrogation-Arg (op 71).
#[derive(Debug, Clone, PartialEq, Eq, AsnType, Decode, Encode)]
pub struct AnyTimeInterrogationArg {
    #[rasn(tag(context, 0))]
    pub subscriber_identity: SubscriberIdentity,
    #[rasn(tag(context, 1))]
    pub requested_info: RequestedInfo,
    #[rasn(tag(context, 3))]
    pub gsm_scf_address: IsdnAddressString,
}

/// AnyTimeInterrogation-Res (op 71).
#[derive(Debug, Clone, PartialEq, Eq, AsnType, Decode, Encode)]
pub struct AnyTimeInterrogationRes {
    pub subscriber_info: SubscriberInfo,
}

/// AnyTimeSubscriberDataModification-Arg (op 65).
#[derive(Debug, Clone, PartialEq, Eq, AsnType, Decode, Encode)]
pub struct AnyTimeModificationArg {
    #[rasn(tag(context, 0))]
    pub subscriber_identity: SubscriberIdentity,
    #[rasn(tag(context, 1))]
    pub gsm_scf_address: IsdnAddressString,
    #[rasn(tag(context, 2))]
    pub modification_request_for_cf_info: Option<OctetString>,
    #[rasn(tag(context, 3))]
    pub modification_request_for_cb_info: Option<OctetString>,
    #[rasn(tag(context, 4))]
    pub modification_request_for_csi: Option<OctetString>,
}

/// AnyTimeSubscriberDataModification-Res (op 65).
#[derive(Debug, Clone, PartialEq, Eq, AsnType, Decode, Encode)]
pub struct AnyTimeModificationRes {
    #[rasn(tag(context, 0))]
    pub ss_info_for_cse: Option<OctetString>,
}

pub mod op_codes {
    pub const PROVIDE_SUBSCRIBER_INFO: i64 = 70;
    pub const ANY_TIME_INTERROGATION: i64 = 71;
    pub const ANY_TIME_MODIFICATION: i64 = 65;
}