core: add DeviceIdentifier property

This is computed before any PIN is entered, and thus before we can
usually get IMEI or MEID/ESN out of the device in many cases. It's
therefore not the same as EquipmentIdentifier.

This is intended to be used by UI programs for matching devices with
PIN numbers for automatic unlocking.  While the PIN number is actually
*SIM* specific, no modems allow access to the IMSI before the PIN is
entered, and thus we cannot actually match the PIN with the SIM.  The
device ID is the next best thing we can use and should allow auto
unlocking in most cases.

1 files changed, 10 insertions, 0 deletions

diff --git a/src/mm-modem-helpers.h b/src/mm-modem-helpers.h
index fb100bce..03f6dec2 100644
--- a/src/mm-modem-helpers.h
+++ b/src/mm-modem-helpers.h
@@ -59,5 +59,15 @@ gboolean mm_gsm_parse_cscs_support_response (const char *reply,
 
 MMModemGsmAccessTech mm_gsm_string_to_access_tech (const char *string);
 
+char *mm_create_device_identifier (const char *vid,
+                                   const char *pid,
+                                   const char *ati,
+                                   const char *ati1,
+                                   const char *gsn,
+                                   const char *revision,
+                                   const char *model,
+                                   const char *manf,
+                                   gboolean debug);
+
 #endif  /* MM_MODEM_HELPERS_H */