org.freedesktop.ModemManager1.Modem.Oma: ModemManager Reference Manual

## org.freedesktop.ModemManager1.Modem.Oma org.freedesktop.ModemManager1.Modem.Oma — The ModemManager Open Mobile Alliance interface. |

## Methods

    Setup                         (IN  u features);
    StartClientInitiatedSession   (IN  u session_type);
    AcceptNetworkInitiatedSession (IN  u session_id,
                                   IN  b accept);
    CancelSession                 ();

## Signals

    SessionStateChanged (i old_session_state,
                         i new_session_state,
                         u session_state_failed_reason);

## Properties

    Features                         readable   u
    PendingNetworkInitiatedSessions  readable   a(uu)
    SessionType                      readable   u
    SessionState                     readable   i

## Description

This interface allows clients to handle device management operations as specified by the Open Mobile Alliance (OMA).

Device management sessions are either on-demand (client-initiated), or automatically initiated by either the device itself or the network.

## Method Details

### The Setup() method

    Setup (IN  u features);

Configures which OMA device management features should be enabled.

`IN u `features``: | Bitmask of MMModemOmaFeature flags, specifying which device management features should get enabled or disabled. MM_OMA_FEATURE_NONE will disable all features.

### The StartClientInitiatedSession() method

    StartClientInitiatedSession (IN  u session_type);

Starts a client-initiated device management session.

`IN u `session_type``: | Type of client-initiated device management session,given as a MMModemOmaSessionType

### The AcceptNetworkInitiatedSession() method

    AcceptNetworkInitiatedSession (IN  u session_id,
                                   IN  b accept);

Accepts or rejects a network-initiated device management session.

`IN u `session_id``: | Unique ID of the network-initiated device management session.
`IN b `accept``: | Boolean specifying whether the session is accepted or rejected.

### The CancelSession() method

    CancelSession ();

Cancels the current on-going device management session.

## Signal Details

### The "SessionStateChanged" signal

    SessionStateChanged (i old_session_state,
                         i new_session_state,
                         u session_state_failed_reason);

The session state changed.

`i `old_session_state``: | Previous session state, given as a MMOmaSessionState.
`i `new_session_state``: | Current session state, given as a MMOmaSessionState.
`u `session_state_failed_reason``: | Reason of failure, given as a MMOmaSessionStateFailedReason, if `session_state` is MM_OMA_SESSION_STATE_FAILED.

## Property Details

### The "Features" property

    Features  readable   u

Bitmask of MMModemOmaFeature flags, specifying which device management features are enabled or disabled.

### The "PendingNetworkInitiatedSessions" property

    PendingNetworkInitiatedSessions  readable   a(uu)

List of network-initiated sessions which are waiting to be accepted or rejected, given as an array of unsigned integer pairs, where:

| The first integer is a MMOmaSessionType.
| The second integer is the unique session ID.

### The "SessionType" property

    SessionType  readable   u

Type of the current on-going device management session, given as a MMOmaSessionType.

### The "SessionState" property

    SessionState  readable   i

State of the current on-going device management session, given as a MMOmaSessionState.