ModemManager Reference Manual

Dan Williams

<dcbw@redhat.com>

Aleksander Morgado

<aleksander@lanedo.com>

For ModemManager version 1.0.0

Copyright © 2008, 2009, 2010, 2011, 2012, 2013 The ModemManager Authors

Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation License, Version 1.3 or any later version published by the Free Software Foundation with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts. You may obtain a copy of the GNU Free Documentation License from the Free Software Foundation by visiting their Web site or by writing to:

          The Free Software Foundation, Inc.
          51 Franklin Street, Suite 500
          Boston, MA 02110-1335
          USA

I. ModemManager Overview

Introduction

Modem detection and setup

Detection mechanisms

Pre-probing filters
Probing sequence
Post-probing filters
Probing setup examples

Port grabbing and Modem object creation

Modem state machine

Initialization
Enabling
Connection & disconnection
Disabling

Plugin-specific Modems

II. Common types and definitions

Version checks — Version information in the API.
Flags and Enumerations — Common enumerations and types in the API.
Errors — Common errors in the API.

III. D-Bus Reference

The org.freedesktop.ModemManager1 bus name

Standard interfaces

org.freedesktop.DBus.Properties
org.freedesktop.DBus.Introspectable
org.freedesktop.DBus.ObjectManager

The /org/freedesktop/ModemManager1 object

org.freedesktop.ModemManager1 — The ModemManager Manager interface.

The /org/freedesktop/ModemManager/Modems objects

org.freedesktop.ModemManager1.Modem — The ModemManager Modem interface.
org.freedesktop.ModemManager1.Modem.Simple — The ModemManager Simple interface.
org.freedesktop.ModemManager1.Modem.Modem3gpp — The ModemManager 3GPP interface.
org.freedesktop.ModemManager1.Modem.Modem3gpp.Ussd — The ModemManager 3GPP USSD interface.
org.freedesktop.ModemManager1.Modem.ModemCdma — The ModemManager CDMA interface.
org.freedesktop.ModemManager1.Modem.Messaging — The ModemManager Messaging interface.
org.freedesktop.ModemManager1.Modem.Location — The ModemManager Location interface.
org.freedesktop.ModemManager1.Modem.Time — The ModemManager Time interface.
org.freedesktop.ModemManager1.Modem.Firmware — The ModemManager Firmware interface.

The /org/freedesktop/ModemManager/Bearers objects

org.freedesktop.ModemManager1.Bearer — The ModemManager Bearer interface.

The /org/freedesktop/ModemManager/SIMs objects

org.freedesktop.ModemManager1.Sim — The ModemManager SIM interface.

The /org/freedesktop/ModemManager/SMSs objects

org.freedesktop.ModemManager1.Sms — The ModemManager SMS interface.

IV. Migrating from ModemManager 0.6 to ModemManager 1.0

Listing available modems
PIN unlocking
Connection and disconnection
Simple connection