From 2904510e760fa1fdf491d1ef4574c29d05307b3b Mon Sep 17 00:00:00 2001
From: Ujjwal Pande <ujjwalpande@google.com>
Date: Thu, 30 May 2024 00:04:24 +0000
Subject: api: new NetworkRejection property

When a modem is not able to register to the network, MBIM and QMI indications
related to registration reports network rejection cause codes if request is
rejected by the network. This information is currently logged in the ModemManager
but not exposed outside of ModemManager.
These are the changes to define interface to expose network reject cause codes
over d-bus to the above layers which could be used by above layers to present
this information in a user friendly way.
---
 ...g.freedesktop.ModemManager1.Modem.Modem3gpp.xml | 47 ++++++++++++++++++++++
 1 file changed, 47 insertions(+)

(limited to 'introspection')

diff --git a/introspection/org.freedesktop.ModemManager1.Modem.Modem3gpp.xml b/introspection/org.freedesktop.ModemManager1.Modem.Modem3gpp.xml
index f7719676..04cabb8b 100644
--- a/introspection/org.freedesktop.ModemManager1.Modem.Modem3gpp.xml
+++ b/introspection/org.freedesktop.ModemManager1.Modem.Modem3gpp.xml
@@ -160,6 +160,53 @@
     -->
     <property name="RegistrationState" type="u" access="read" />
 
+    <!--
+        NetworkRejection:
+
+        This property holds the latest network rejection information received from the
+        network during registration failure, and it will be cleared whenever the modem
+        successfully registers.
+        Network errors are defined in 3GPP TS 24.008 in sections 10.5.3.6 and
+        10.5.5.14 (detailed in annex G) and in 3GPP TS 24.301 in section 9.9.3.9.
+
+        Mandatory items include:
+        <variablelist>
+          <varlistentry><term><literal>"error"</literal></term>
+            <listitem>
+              A <link linkend="MMNetworkError">MMNetworkError</link>,
+              specifying the reason why a request from the mobile station
+              is rejected by the network, given as an unsigned integer value
+              (signature <literal>"u"</literal>).
+            </listitem>
+          </varlistentry>
+        </variablelist>
+
+        Optionally following items could be included if reported by modem along
+        with network error.
+        <variablelist>
+          <varlistentry><term><literal>"operator-id"</literal></term>
+            <listitem>
+              Operator id reported along with network error, given as a string value (signature <literal>"s"</literal>).
+            </listitem>
+          </varlistentry>
+          <varlistentry><term><literal>"operator-name"</literal></term>
+            <listitem>
+              Operator name reported along with network error, given as a string value (signature <literal>"s"</literal>).
+            </listitem>
+          </varlistentry>
+          <varlistentry><term><literal>"access-technology"</literal></term>
+            <listitem>
+              A <link linkend="MMModemAccessTechnology">MMModemAccessTechnology</link>,
+              specifying the available data class reported along with network error,
+              given as an unsigned integer value (signature <literal>"u"</literal>).
+            </listitem>
+          </varlistentry>
+        </variablelist>
+
+        Since: 1.24
+    -->
+    <property name="NetworkRejection" type="a{sv}" access="read" />
+
     <!--
         OperatorCode:
 
-- 
cgit v1.2.3-70-g09d2