display carriers

Purpose

Displays a list of the GSM carriers that are broadcasting in the area of the Digi device and available for use as a carrier; that is, carriers that have towers and equipment in the area. GSM carriers broadcast that they are available, and the phone/modem selects the best one.

The output from this command includes the carrier names and associated numbers that represent the carrier (the mobile country code (MCC), concatenated with the mobile network code (MNC), in this manner: <MCC>(+)<MNC>. The numbers can be then used for the set mobile carrier=mobile country code+mobile network code command.

Before using this command, you must disable the cellular module.

  1. Issue the command set mobileppp state=disable.
  2. Kill the PPP session by issuing the who command. In the ID field of the command output, locate the index number for the PPP session is displayed.
  3. Issue the kill command, specifying the index number for the PPP session, for example, kill 3
  4. Issue the display carriers command.

Required permissions

For Digi products with two or more users, permissions must be set to set permissions display=execute to use this command. In addition, the commands noted in the procedure above, set mobilepp, and the who command, have their own permissions and are noted in their respective command descriptions. See set permissions for details on setting user permissions for commands.

Syntax

display carriers

Example

#> set mobileppp state=disable
#>
#> who

ID  From                   To                     Protocol              Sessions
--  -------------------    -------------------    --------------------  --------
1                                                 ppp [mobile init]
2   local                  USB                    NMEA GPS Processor
3   10.8.16.105            local shell            telnet

#>
#> kill 1

Connection 1 : Killing connection...

#>
#> display carriers

Active Carrier List

Carrier Name             Network ID               Status           Service
--------------------     -----------              ----------       --------
AT&T                     310410                   Available        2G
AT&T                     310410                   Current          3G
T-Mobile                 31026                    Available        2G

See also