Notice for E-FOTA on MDM partners: Changes to how the device serial number is obtained for OS 9 and newer devices

Notice for E-FOTA on MDM partners: Changes to how the device serial number is obtained for OS 9 and newer devices

04 Sep 2020
By Knox Partner Program Admin

Starting on Samsung devices that shipped with Android OS 9, the system property for obtaining the device serial number has changed from ril.serialnumber to ro.serialno. This change has an impact on two E-FOTA on MDM version 2 API methods: forceUpdate and abnormalDeviceList.

 

As illustrated in the table below, the system property for obtaining the device serial number is determined by the device’s Android OS version at the time when the following Knox SDK method is called: RestrictionPolicy.setAllowedFOTAVersion() during registering.

 

Device’s Android OS version during registration to the B2B FOTA server

System Property for obtaining Serial Number

OS 8 or lower

ril.serialnumber

OS 9

Try ril.serialnumber first. If it is null, use ro.serialno

OS 10 or higher

ro.serialno

 

Please note the following:

  1. As the same device model may have two different Android OS versions, refer to the system property associated with the device’s Android OS at the time of registration to the B2B FOTA server. For example,

 

Model name

Device’s Android OS version during registration to the B2B FOTA server

System Property for obtaining Serial Number

Device 1

SM-A600FN

OS 9

ril.serialnumber

Device 2

OS 10

ro.serialno

 

  1. Once the device is registered to the B2B FOTA server, the serial number remains valid until the device has been removed from the B2B FOTA server, even after the device has received an OS update. For example,

 

 

System Property for obtaining Serial Number

Device 1 (SM-A600FN)

OS 9: Registered to B2B FOTA server

ril.serialnumber

OS 10: Received update to OS 10

same as above

 

  1. If the device is re-registered to the B2B FOTA server after an Android OS update, use the following method to obtain serial number. For example,

 

 

System Property for obtaining Serial Number

Device 1 (SM-A600FN)

OS 9: Registered to B2B FOTA server

ril.serialnumber

OS 10: Received update to OS 10

same as above

OS 10: Removed from B2B FOTA server

-

OS 10: Registered again to B2B FOTA server

ro.serialno

 

Tip: Consider blocking OTA update during the device re-registration process to avoid unintended OTA update. Recommended steps to re-register a device:

  1. Call allowOTAUpgrade(false) to block OTA update.
  2. Call setAllowedFOTAVersion(version, bundle) where version and bundle are set to null to remove the device from the B2B FOTA server.
  3. Call setAllowedFOTAVersion(version, bundle) to register the device again. Follow the guidance listed above to obtain device serial number.
  4. Call allowOTAUpgrade(true) to allow OTA update.