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
153
154
155
156
157
158
159
160
161
162
163

//! LCS (Location Services) operations — 3GPP TS 29.002.
//!
//! - provideSubscriberLocation (op 83)
//! - subscriberLocationReport (op 86)
//! - sendRoutingInfoForLCS (op 85)

use rasn::prelude::*;

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

/// LocationType.
#[derive(Debug, Clone, PartialEq, Eq, AsnType, Decode, Encode)]
pub struct LocationType {
    #[rasn(tag(context, 0))]
    pub location_estimate_type: LocationEstimateType,
    #[rasn(tag(context, 1))]
    pub deferred_location_event_type: Option<OctetString>,
}

/// LocationEstimateType.
#[derive(Debug, Clone, Copy, PartialEq, Eq, AsnType, Decode, Encode)]
#[rasn(enumerated)]
pub enum LocationEstimateType {
    CurrentLocation = 0,
    CurrentOrLastKnownLocation = 1,
    InitialLocation = 2,
    ActivateDeferredLocation = 3,
    CancelDeferredLocation = 4,
}

/// LCS-ClientID.
#[derive(Debug, Clone, PartialEq, Eq, AsnType, Decode, Encode)]
pub struct LcsClientId {
    #[rasn(tag(context, 0))]
    pub lcs_client_type: LcsClientType,
    #[rasn(tag(context, 1))]
    pub lcs_client_external_id: Option<OctetString>,
    #[rasn(tag(context, 2))]
    pub lcs_client_dialed_by_ms: Option<OctetString>,
    #[rasn(tag(context, 3))]
    pub lcs_client_internal_id: Option<Integer>,
    #[rasn(tag(context, 4))]
    pub lcs_client_name: Option<OctetString>,
}

/// LCS-ClientType.
#[derive(Debug, Clone, Copy, PartialEq, Eq, AsnType, Decode, Encode)]
#[rasn(enumerated)]
pub enum LcsClientType {
    EmergencyServices = 0,
    ValueAddedServices = 1,
    PlmnOperatorServices = 2,
    LawfulInterceptServices = 3,
}

/// ProvideSubscriberLocation-Arg (op 83).
#[derive(Debug, Clone, PartialEq, Eq, AsnType, Decode, Encode)]
pub struct ProvideSubscriberLocationArg {
    pub location_type: LocationType,
    pub mlc_number: IsdnAddressString,
    #[rasn(tag(context, 0))]
    pub lcs_client_id: Option<LcsClientId>,
    #[rasn(tag(context, 2))]
    pub imsi: Option<Imsi>,
    #[rasn(tag(context, 3))]
    pub msisdn: Option<IsdnAddressString>,
    #[rasn(tag(context, 5))]
    pub imei: Option<OctetString>,
    #[rasn(tag(context, 6))]
    pub lcs_priority: Option<OctetString>,
    #[rasn(tag(context, 7))]
    pub lcs_qos: Option<OctetString>,
    #[rasn(tag(context, 9))]
    pub lcs_service_type_id: Option<Integer>,
}

/// ProvideSubscriberLocation-Res (op 83).
#[derive(Debug, Clone, PartialEq, Eq, AsnType, Decode, Encode)]
pub struct ProvideSubscriberLocationRes {
    pub location_estimate: OctetString,
    #[rasn(tag(context, 0))]
    pub age_of_location_estimate: Option<Integer>,
    #[rasn(tag(context, 2))]
    pub additional_location_estimate: Option<OctetString>,
    #[rasn(tag(context, 3))]
    pub deferred_mt_lr_response_indicator: Option<()>,
    #[rasn(tag(context, 5))]
    pub cell_id_or_sai: Option<OctetString>,
    #[rasn(tag(context, 6))]
    pub accuracy_fulfilment_indicator: Option<Integer>,
}

/// SubscriberLocationReport-Arg (op 86).
#[derive(Debug, Clone, PartialEq, Eq, AsnType, Decode, Encode)]
pub struct SubscriberLocationReportArg {
    pub lcs_event: LcsEvent,
    pub lcs_client_id: LcsClientId,
    pub network_node_number: IsdnAddressString,
    #[rasn(tag(context, 0))]
    pub msisdn: Option<IsdnAddressString>,
    #[rasn(tag(context, 1))]
    pub imsi: Option<Imsi>,
    #[rasn(tag(context, 2))]
    pub imei: Option<OctetString>,
    #[rasn(tag(context, 4))]
    pub location_estimate: Option<OctetString>,
    #[rasn(tag(context, 5))]
    pub age_of_location_estimate: Option<Integer>,
}

/// SubscriberLocationReport-Res (op 86).
#[derive(Debug, Clone, PartialEq, Eq, AsnType, Decode, Encode)]
pub struct SubscriberLocationReportRes {
    #[rasn(tag(context, 0))]
    pub na_esrd: Option<IsdnAddressString>,
    #[rasn(tag(context, 1))]
    pub na_esrk: Option<IsdnAddressString>,
}

/// LCS-Event.
#[derive(Debug, Clone, Copy, PartialEq, Eq, AsnType, Decode, Encode)]
#[rasn(enumerated)]
pub enum LcsEvent {
    EmergencyCallOrigination = 0,
    EmergencyCallRelease = 1,
    MoLr = 2,
    DeferredMtLrResponse = 3,
    DeferredMoLrTttpInitiation = 4,
}

/// SendRoutingInfoForLCS-Arg (op 85).
#[derive(Debug, Clone, PartialEq, Eq, AsnType, Decode, Encode)]
pub struct SendRoutingInfoForLcsArg {
    #[rasn(tag(context, 0))]
    pub mlc_number: IsdnAddressString,
    #[rasn(tag(context, 1))]
    pub target_ms: SubscriberIdentityLcs,
}

/// SubscriberIdentity for LCS.
#[derive(Debug, Clone, PartialEq, Eq, AsnType, Decode, Encode)]
#[rasn(choice)]
pub enum SubscriberIdentityLcs {
    #[rasn(tag(context, 0))]
    Imsi(Imsi),
    #[rasn(tag(context, 1))]
    Msisdn(IsdnAddressString),
}

/// SendRoutingInfoForLCS-Res (op 85).
#[derive(Debug, Clone, PartialEq, Eq, AsnType, Decode, Encode)]
pub struct SendRoutingInfoForLcsRes {
    #[rasn(tag(context, 0))]
    pub target_ms: SubscriberIdentityLcs,
    #[rasn(tag(context, 1))]
    pub lcs_location_info: OctetString,
}

pub mod op_codes {
    pub const PROVIDE_SUBSCRIBER_LOCATION: i64 = 83;
    pub const SEND_ROUTING_INFO_FOR_LCS: i64 = 85;
    pub const SUBSCRIBER_LOCATION_REPORT: i64 = 86;
}