mobile_update

Purpose

Loads a preferred roaming list (PRL) into the cellular module on the Digi device. A PRL is a database that resides in a mobile device that contains information used during the system selection and acquisition process. It is built by the mobile service provider, and is normally not accessible to users.The PRL indicates which bands, sub bands and service provider identifiers will be scanned and in what priority order. Without a PRL, a mobile device may not be able to roam, or obtain service outside of the home area. There may be cases where missing or corrupt PRLs can lead to not having service at all.

On many networks, regularly updating the PRL is advised if the subscriber uses the device outside the home area frequently, particularly if they do so in multiple different areas. This allows the mobile device to choose the best roaming carriers, particularly “roaming partners” with whom the home carrier has a cost-saving roaming agreement, rather than using non-affiliated carriers. PRL files can also be used to identify home networks along with roaming partners, thus making the PRL an actual list that determines the total coverage of the subscriber, both home and roaming coverage.

The master subsidy lock (MSL) or a one-time subsidy lock (OTSL) associated with the module must be provided. The PRL file and the MSL or OTSL are obtained from the mobile service provider.

This command indicates whether the loading operation was successful. If it is unsuccessful, an error message is displayed.

Note This command applies to Digi cellular-enabled products that use the Sierra Wireless MC57xx series CDMA/EVDO modules only.

Required permissions

For Digi products with two or more users, to use this command, permissions must be set to set permissions s‑ppp=read to display settings, and set permissions s‑ppp=rw to display and configure settings. See set permissions for details on setting user permissions for commands.

Syntax

mobile_update
  prl=tftp host IP address:prl file name
 msl=msl/otsl code

Options

prl=tftp host ip address:prl file name

The location and name of the PRL file to be loaded. tftp host ip address is the IP address of a TFTP server where the specified prl file name resides.

msl=msl/otsl code

The master subsidy lock (MSL) or a one-time subsidy lock (OTSL) associated with the module. This value is a six-digit activation or unlock code supplied by the mobile service provider.

Examples

#> mobile_update prl=192.168.1.1:90439.prl