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/ org.freedesktop.DBus.Introspectable.Introspect where: 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/. 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/ - 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/ org.freedesktop.ModemManager1.Modem.Gsm.Network.GetSignalQuality dbus-send --system --print-reply --dest=org.freedesktop.ModemManager1 /org/freedesktop/ModemManager1/Modems/ org.freedesktop.ModemManager1.Modem.Gsm.Network.GetRegistrationInfo dbus-send --system --print-reply --dest=org.freedesktop.ModemManager1 /org/freedesktop/ModemManager1/Modems/ org.freedesktop.DBus.Properties.GetAll string: is returned by the first command (EnumerateDevices). is either of org.freedesktop.ModemManager1 (do not use /Modems/ with this one) org.freedesktop.DBus.Properties (do not use /Modems/ 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 -> -> 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.