Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.
Awesome Lists | Featured Topics | Projects
https://github.com/kde/modemmanager-qt

Qt wrapper for ModemManager DBus API.
https://github.com/kde/modemmanager-qt
Last synced: 4 days ago
JSON representation
Qt wrapper for ModemManager DBus API.
Host: GitHub
URL: https://github.com/kde/modemmanager-qt
Owner: KDE
Created: 2015-09-18T11:20:57.000Z (about 9 years ago)
Default Branch: master
Last Pushed: 2024-08-18T11:24:41.000Z (3 months ago)
Last Synced: 2024-08-18T12:36:03.481Z (3 months ago)
Language: C++
Homepage: https://invent.kde.org/frameworks/modemmanager-qt
Size: 994 KB
Stars: 11
Watchers: 4
Forks: 6
Open Issues: 0
Metadata Files:
- Readme: README
- License: LICENSES/BSD-3-Clause.txt
Awesome Lists containing this project

README

        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.