Cellular Communications
Cellular Configuration Properties¶
Please see the Cellular Commands for commands supported by these properties.
SCANSEQ¶
Scanseq specifies the search sequence for the modem. It can be a 6-digit or 10-digit number composed of three or five two-digit numbers. The format is “AABBCC” and “AABBCCDDEE” respectively, where “AA” is the first mode scanned, “BB” is the second mode scanned, “CC” is the third mode scanned, “DD” is the fourth mode scanned, and “EE” is the last mode scanned.
Scanseq is a 10-digit number composed of 5 two-digit numbers. The available mode values are:
| Value | Description |
|---|---|
| 00 | Automatic (LTE/WCDMA/TD-SCDMA/GSM) |
| 01 | GSM |
| 02 | TD-SCDMA |
| 03 | WCDMA |
| 04 | LTE |
| 05 | CDMA |
To scan for only GSM operators, use “0101010101”.
To scan LTE, then CDMA, then WCDMA and finally TD-SCDMA and GSM, use the value “0405030201”.
Scanseq is a 6-digit number composed of 3 two-digit numbers. The available mode values are:
| Value | Description |
|---|---|
| 00 | Automatic (LTE Cat M1/LTE Cat NB1/GSM) |
| 01 | GSM |
| 02 | LTE Cat M1 |
| 03 | LTE Cat NB1 |
To scan for only GSM operators, use “010101”.
To scan LTE Cat M1, then GSM twice, use the value “020101”.
SCANBAND¶
Scanband specifies the frequencies the modem should look for when searching for suitable carriers. The scanband property comprises three hexadecimal, comma-separated values. To select more than one band, simply add together the desired hexidecimal values in each group and use in a scanband command.
The scanband value comprises three comma separated hexadecimal values for GSM/WCDMA, LTE and TDS bands. Use the table below to select values for bands available with your cellular carrier. For example,
cfg gsm scanband <GSM/WCDMA>,<LTE>,<TDS>
cfg gsm scanband 3ff,1E00B0E18DF,3f
| Hex Value | Band |
|---|---|
| 000 | No change (means do not modify the current value) |
| 001 | SM900 |
| 002 | SM1800 |
| 004 | SM850 |
| 008 | SM1900 |
| 010 | CDMA 2100 |
| 020 | CDMA 1900 |
| 040 | CDMA 850 |
| 080 | CDMA 900 |
| 100 | CDMA 800 |
| 200 | CDMA 1700 |
| 3FF | Any frequency band. It's best to select only those bands supported by the your carrier in the country of operation. |
| Hex Value | Band |
|---|---|
| 00000000000 | No change (means do not modify the current value) |
| 00000000001 | LTE B1 |
| 00000000002 | LTE B2 |
| 00000000004 | LTE B3 |
| 00000000008 | LTE B4 |
| 00000000010 | LTE B5 |
| 00000000040 | LTE B7 |
| 00000000080 | LTE B8 |
| 00000000800 | LTE B12 |
| 00000001000 | LTE B13 |
| 00000020000 | LTE B18 |
| 00000040000 | LTE B19 |
| 00000080000 | LTE B20 |
| 00001000000 | LTE B25 |
| 00002000000 | LTE B26 |
| 00008000000 | LTE B28 |
| 02000000000 | LTE B38 |
| 04000000000 | LTE B39 |
| 08000000000 | LTE B40 |
| 10000000000 | LTE B41 |
| 1E00B0E18DF | Any frequency band. It's best to select only those bands supported by the your carrier in the country of operation. |
| Hex Value | Band |
|---|---|
| 00 | No change (means do not modify the current value) |
| 01 | TDS BCA |
| 02 | TDS BCB |
| 04 | TDS BCC |
| 08 | TDS BCD |
| 10 | TDS BCE |
| 20 | TDS BCF |
| 3f | Any frequency band. It's best to select only those bands supported by the your carrier in the country of operation. |
The scanband value comprises three comma separated hexadecimal values for GSM/WCDMA, LTE M1 and LTE NB1 bands. Use the table below to select values for bands available with your cellular carrier. For example,
cfg main scanband <GSM>,<LTE M1>,<LTE NB1>
cfg main scanband f,400a0e189f,a0e189f
| Hex Value | Band |
|---|---|
| 0 | No change (means do not modify the current value) |
| 1 | GSM 900MHz |
| 2 | GSM 1800MHz |
| 4 | GSM 850MHz |
| 8 | GSM 1900MHz |
| F | Any frequency band. It's best to select only those bands supported by the your carrier in the country of operation. |
| Hex Value | Band |
|---|---|
| 0000000000 | No Change (means do not modify the current value) |
| 0000000001 | LTE B1 |
| 0000000002 | LTE B2 |
| 0000000004 | LTE B3 |
| 0000000008 | LTE B4 |
| 0000000010 | LTE B5 |
| 0000000080 | LTE B8 |
| 0000000800 | LTE B12 |
| 0000001000 | LTE B13 |
| 0000020000 | LTE B18 |
| 0000040000 | LTE B19 |
| 0000080000 | LTE B20 |
| 0002000000 | LTE B26 |
| 0008000000 | LTE B28 |
| 4000000000 | LTE B39 |
| 400A0E189F | Any frequency band. It's best to select only those bands supported by the your carrier in the country of operation. |
| Hex Value | Band |
|---|---|
| 0000000 | No Change (means do not modify the current value) |
| 0000001 | LTE B1 |
| 0000002 | LTE B2 |
| 0000004 | LTE B3 |
| 0000008 | LTE B4 |
| 0000010 | LTE B5 |
| 0000080 | LTE B8 |
| 0000800 | LTE B12 |
| 0001000 | LTE B13 |
| 0020000 | LTE B18 |
| 0040000 | LTE B19 |
| 0080000 | LTE B20 |
| 2000000 | LTE B26 |
| 8000000 | LTE B28 |
| A0E189F | Any frequency band. It's best to select only those bands supported by the your carrier in the country of operation. |
COPS¶
Cops allows for the selection of specific carriers and access technology.
Only use the values indicated for each arguement. Other values could disconnect device from the network.
The cops value comprises four comma separated values. Use the table below to select values for each arguement. For example,
cfg gsm cops <arg1>,<arg2>,<arg3>,<arg4>
cfg gsm cops 4,2,45400,7
This argument instructs the modem as to what type of registration to perform.
| Value | Description |
|---|---|
| 0 | Automatic (default) |
| 1 | Manual |
| 4 | Manual with fallback to Auto. |
This argument indicates for format of the operator identifier that you are providing.
| Value | Description |
|---|---|
| 0 | Long Character Value (Full Operator Name) |
| 1 | Short Character Value (Short Operator Name) |
| 2 | Local Area Identification Number (Operator PLMNID) Recommended |
This argument indicates for format of the operator identifier that you are providing.
| When arg2 is set to | arg3 contains |
|---|---|
| Long Character Name | Up to 16 alphanumeric characters. |
| Short Operator Name | The short form of the operator name. |
| Operator PLMNID | The MCC+MNC code (PLMNID) assigned to the operator. Find the PLMNID for the operator in the country of interest at this link. Recommended |
This argument indicates the access technology to use when registering to a network.
| Value | Description |
|---|---|
| 0 | GSM |
| 2 | UTRAN |
| 3 | GSM W/EGPRS |
| 4 | UTRAN W/HSDPA |
| 5 | UTRAN W/HSUPA |
| 6 | UTRAN W/HSDPA and HSUPA |
| 7 | E-UTRAN |
| 100 | CDMA |
The cops value comprises four comma separated values. Use the table below to select values for each arguement. For example,
cfg main cops <arg1>,<arg2>,<arg3>,<arg4>
cfg main cops 1,1,50501,8
This argument instructs the modem as to what type of registration to perform.
| Value | Description |
|---|---|
| 0 | Automatic (default) |
| 1 | Manual |
| 4 | Manual with fallback to Auto. |
This argument indicates for format of the operator identifier that you are providing.
| Value | Description |
|---|---|
| 0 | Long Character Value (Full Operator Name) |
| 1 | Short Character Value (Short Operator Name) |
| 2 | Local Area Identification Number (Operator PLMNID) Recommended |
This argument indicates for format of the operator identifier that you are providing.
| When arg2 is set to | arg3 contains |
|---|---|
| Long Character Name | Up to 16 alphanumeric characters. |
| Short Operator Name | The short form of the operator name. |
| Operator PLMNID | The MCC+MNC code (PLMNID) assigned to the operator. Find the PLMNID for the operator in the country of interest at this link. Recommended |
This argument indicates the access technology to use when registering to a network.
| Value | Description |
|---|---|
| 1 | GSM |
| 8 | CAT-M1 |
| 9 | CAT-NB1 |
We recommend setting the COPS value to 0 initially to allow the modem to locate an appropriate operator. Once registered, query the device with the stat 3g command to determine to which operator and access technology the device registered.
When using a roaming SIM, it is worthwhile to steer to a specific operator to save time registering each time the modem restarts.
Advanced Cellular Commands¶
The advanced cellular commands are tools to discover which cellular resources are available local to the deivce.
Set Network Defaults¶
net dflt
Sets cellular network properties to default values.
Network Operator Scan¶
net scanoper network
| Parameter | Valid Values |
|---|---|
| network | 2g, 3g, or 4g |
Scan for available opertors on the specified network. Returns operator name and PLMNID.
If you do not see a response after 5 minutes, run the command again. The modem often times out during this operation. Re-issuing the command normally resolves the issue.
Example command
net scanoper 4g
Example output
Scanning 4G Operators
Net Scan Completed OK
Operator Name Identifier
SmarTone HK 45406
China Mobile HK 45412
CSL 45400
3 45403
The Identifier (PLMNID) in the output can be used in the COPS, arg3 property to select a specific carrier. It can also be used with net scanband to determine and operator's available bands.
Network Band Scan¶
net scanband plmnid network
| Parameter | Valid Values |
|---|---|
| plmnid | Operator's network identifier |
| network | 2g, 3g, or 4g |
Scan for available bands on the specified operator and network. Returns a list of available bands and the singal quality.
If you do not see a response after 5 minutes, run the command again. The modem often times out during this operation. Re-issuing the command normally resolves the issue.
Example command
net scanoper 45400 4g
Example output
Scanning Operator 45400 4G Bands
Net Scan Completed OK
CSL Bands
# Name B Qual
1 B8 8 Great
2 B3 3 Great
3 B26 26 Good
4 B7 7 Edge
The number (#) value can be used in the net switch command to configure modem to use a selected bands.
Net Switch¶
net switch n [,n [,n]]
| Parameter | Valid Values |
|---|---|
| n | Band number from the net scanband output (from the # column) Repeat for as many bands as you wish to configure. |
Configures cellular modem for selected bands.
Example command
net switch 1,2
Example output
MAIN->SCANBAND is 400,4,3f
MAIN->SCANSEQ is 04
Send 'reset modem' to invoke
Issue a reset modem command to retart modem with new band settings.