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.