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
164
165
166
167
168
169
170
171
172
173
174
175
176
177
|
Modem Manager (MM) specification: https://developer.gnome.org/ModemManager/unstable/ref-dbus.html
// TODO - UPDATE
Requirements
============
Backend tested using git versions of NetworkManager and ModemManager as of May 16, 2010. To verify which interfaces ModemManager and your modem supports do:
dbus-send --system --print-reply --dest=org.freedesktop.ModemManager1 /org/freedesktop/ModemManager1 org.freedesktop.DBus.Introspectable.Introspect
dbus-send --system --print-reply --dest=org.freedesktop.ModemManager1 /org/freedesktop/ModemManager1/Modems/<modem number> org.freedesktop.DBus.Introspectable.Introspect
where:
<modem number> is returned by dbus-send --system --print-reply --dest=org.freedesktop.ModemManager1 /org/freedesktop/ModemManager1 org.freedesktop.ModemManager1.EnumerateDevices
I had to add the uni() method to NetworkManager backend because most MM methods requires a path that looks like /org/freedesktop/ModemManager1/Modems/<modem number>. uni() return such path, so it is the easier way to find a MM object from a NM object.
Implementation
==============
The backend organizes MM interfaces as follow:
→ class ModemManager
org.freedesktop.ModemManager1
→ class ModemDevice
- doesn't have an interface on dbus, represents /org/freedesktop/ModemManager1/Modems/<modem number>
- contains all the interfaces below
→ class Modem
org.freedesktop.ModemManager1.Modem
org.freedesktop.ModemManager1.Modem.Simple
→ class Modem3gpp inherits from Interface
org.freedesktop.ModemManager1.Modem.Modem3gpp
→ class Modem3gppUssd inherits from Interface
org.freedesktop.ModemManager1.Modem.Modem3gpp.Ussd
→ class ModemCdma inherits from Interface
org.freedesktop.ModemManager1.Modem.ModemCdma
→ class ModemLocation inherits from Interface
org.freedesktop.ModemManager1.Modem.Location
→ class ModemMessaging inherits from Interface
org.freedesktop.ModemManager1.Modem.Messaging
→ class ModemTime inherits from Interface
org.freedesktop.ModemManager1.Modem.Time
// TODO - missing
→ class ModemFirmware inherits from Interface
org.freedesktop.ModemManager1.Modem.Firmware
→ class ModemContacts inherits from Interface
org.freedesktop.ModemManager1.Modem.Contacts
→ class Bearer
org.freedesktop.ModemManager1.Bearer
→ class Sim
org.freedesktop.ModemManager1.Sim
→ class Sms
org.freedesktop.ModemManager1.Sms
// TODO - needs to update to mach the new ModemManager
Current Implementation Status
============================
org.freedesktop.ModemManager1
- fully implemented
- still needs testing: signals DeviceAdded and DeviceRemoved
org.freedesktop.DBus.Properties
- fully implemented and tested
org.freedesktop.ModemManager1.Modem
- fully implemented, needs more testing
- modem MD300 does not supports: method GetIP4Config
org.freedesktop.ModemManager1.Modem.Simple
- fully implemented, needs more testing
org.freedesktop.ModemManager1.Modem.Location
- fully implemented, not tested yet
- modem MD300 does not support this interface (it is not listed when calling org.freedesktop.DBus.Introspectable.Introspect)
org.freedesktop.ModemManager1.Modem.Cdma
- fully implemented, not tested yet
- modem MD300 does not support this interface
org.freedesktop.ModemManager1.Modem.3gpp
- fully implemented and tested
org.freedesktop.ModemManager1.Modem.Gsm.Card
- fully implemented, needs more testing
org.freedesktop.ModemManager1.Modem.Gsm.Contacts
- fully implemented, not tested yet
- modem MD300 does not support this interface
org.freedesktop.ModemManager1.Modem.Gsm.Network
- fully implemented
- to be tested: methods Register and SetApn
- still not working (returns error): method scan
- modem MD300 does not support: method GetBand and probably method SetBand too. SignalQuality method only works in 2G mode for MD300 modem, maybe for other modems it works in 3G mode.
org.freedesktop.ModemManager1.Modem.Gsm.SMS
- fully implemented, not tested yet
- modem MD300 does not support method List and probably all other methods in this interface.
org.freedesktop.ModemManager1.Modem.Gsm.Hso - fully implemented, not tested yet
- modem MD300 does not support this interface
org.freedesktop.ModemManager.Modem.Gsm.Ussd
- fully implemented, not tested yet
- modem MD300 does not support this interface
Pending Problems
================
1. Needs more testing with other modems/cell phones.
2. When I hook up a second 3G modem (my cell phone actually) in my notebook
sometimes ModemManager disconnects the first modem from Internet. This is not a
KDE problem, just to warn everybody.
3. I still need to implement some caching to prevent stress in the DBus bus.
4. Missing comments about methods, enum and signal in some classes. Now that everything is implemented I will add the missing comments.
Command line
============
The dbus methods can be tested in command line with:
dbus-send --system --print-reply --dest=org.freedesktop.ModemManager1 /org/freedesktop/ModemManager1 org.freedesktop.ModemManager1.EnumerateDevices
dbus-send --system --print-reply --dest=org.freedesktop.ModemManager1 /org/freedesktop/ModemManager1/Modems/<modem number> org.freedesktop.ModemManager1.Modem.Gsm.Network.GetSignalQuality
dbus-send --system --print-reply --dest=org.freedesktop.ModemManager1 /org/freedesktop/ModemManager1/Modems/<modem number> org.freedesktop.ModemManager1.Modem.Gsm.Network.GetRegistrationInfo
dbus-send --system --print-reply --dest=org.freedesktop.ModemManager1 /org/freedesktop/ModemManager1/Modems/<modem number> org.freedesktop.DBus.Properties.GetAll string:<interface name>
<modem number> is returned by the first command (EnumerateDevices).
<interface name> is either of
org.freedesktop.ModemManager1 (do not use /Modems/<modem number> with this one)
org.freedesktop.DBus.Properties (do not use /Modems/<modem number> with this one)
org.freedesktop.ModemManager1.Modem
org.freedesktop.ModemManager1.Modem.Simple
org.freedesktop.ModemManager1.Modem.Location
org.freedesktop.ModemManager1.Modem.Cdma
org.freedesktop.ModemManager1.Modem.Gsm
org.freedesktop.ModemManager1.Modem.Gsm.Card
org.freedesktop.ModemManager1.Modem.Gsm.Contacts
org.freedesktop.ModemManager1.Modem.Gsm.Network
org.freedesktop.ModemManager1.Modem.Gsm.SMS
org.freedesktop.ModemManager1.Modem.Gsm.Hso
org.freedesktop.ModemManager1.Modem.Gsm.Ussd
Devices Known to Work
=====================
. Sony Ericsson MD300 modem
- connects to the Internet.
- Signal Quality indication only in Edge mode. When in 3G mode the modem only reports the number of bars (zero to five), but Modem Manager does not report that either. We can change Modem Manager to report an approximation of the signal quality based on the number of bars.
. Samsung Omnia HD i8910
- connects to the Internet.
- Select "Any" in Plasma NM -> Manage Connections -> Mobile Broadband -> <connection name> -> Edit -> Type or it will not connect
- Access technology not reported by Modem Manager.
. Nokia N95
- connects to the Internet.
- Access technology not reported by Modem Manager.
. Huwaei e226
- connects to the Internet.
|
