api,introspection: firmware images require a new `image-type' property

Image types of `MM_FIRMWARE_IMAGE_TYPE_GENERIC' will expose only the mandatory
parameters. Other vendor-specific images may expose other properties.

docs/reference/api/ModemManager-sections.txt

@@ -3,6 +3,7 @@
 <TITLE>Flags and Enumerations</TITLE>
 MMBearerIpFamily
 MMBearerIpMethod
+MMFirmwareImageType
 MMModem3gppFacility
 MMModem3gppNetworkAvailability
 MMModem3gppRegistrationState

include/ModemManager-enums.h

@@ -680,4 +680,16 @@ typedef enum { /*< underscore_name=mm_modem_3gpp_ussd_session_state >*/
     MM_MODEM_3GPP_USSD_SESSION_STATE_USER_RESPONSE = 3,
 } MMModem3gppUssdSessionState;
 
+/**
+ * MMFirmwareImageType:
+ * @MM_FIRMWARE_IMAGE_TYPE_UNKNOWN: Unknown firmware type.
+ * @MM_FIRMWARE_IMAGE_TYPE_GENERIC: Generic firmware image.
+ *
+ * Type of firmware image.
+ */
+typedef enum { /*< underscore_name=mm_firmware_image_type >*/
+    MM_FIRMWARE_IMAGE_TYPE_UNKNOWN = 0,
+    MM_FIRMWARE_IMAGE_TYPE_GENERIC = 1
+} MMFirmwareImageType;
+
 #endif /*  _MODEMMANAGER_ENUMS_H_ */

introspection/org.freedesktop.ModemManager1.Modem.Firmware.xml

@@ -25,6 +25,15 @@
       Certain properties are pre-defined, and some are required:
 
       <variablelist>
+        <varlistentry><term><literal>"image-type"</literal></term>
+          <listitem>
+            (Required) Type of the firmware image, given as a
+            <link linkend="MMFirmwareImageType">MMFirmwareImageType</link> value
+            (signature <literal>"u"</literal>). Firmware images of type
+            <link linkend="MM-FIRMWARE-IMAGE-TYPE-GENERIC:CAPS">MM_FIRMWARE_IMAGE_TYPE_GENERIC</link>
+            will only expose only the mandatory properties.
+          </listitem>
+        </varlistentry>
         <varlistentry><term><literal>"name"</literal></term>
           <listitem>
             (Required) A user-readable name for the firmware image, given as a
@@ -33,7 +42,7 @@
         </varlistentry>
         <varlistentry><term><literal>"version"</literal></term>
           <listitem>
-            (Optional) The version of the firmware, given as a string value
+            (Required) The version of the firmware, given as a string value
             (signature <literal>"s"</literal>). The format is
             unspecified; tools attempting to upgrade firmware automatically must
             understand the versioning scheme used by the modem driver they are