
Chapter 5 – Network Service Commands
Multi-Tech Systems, Inc. CDMA Wireless AT Commands (PN S000294J)
31
Roam Preference +WRMP
Description:
The Roam Preference of a CDMA modem informs the MS whether it is allowed to roam on foreign CDMA
networks or only allow operation on home networks. The determination of what is a foreign or home network
is programmed into the PRL (Preferring Roaming List). This command simply enables or disables the
capability of the MS to roam, based on the PRL configuration. If the setting is accepted by the MS, the value
will be written to non-volatile RAM and persist after a power-cycle. After execution of the +WRMP command,
the MS may change roaming states. The unsolicited WROM: <mode> will indicate the new state.
See
Unsolicited Result Codes
in Chapter 21.
Note
: This command is not available in Sprint® and Verizon software versions.
Values:
The parameter values are the following ones:
<mode>
0
Home Networks only, as defined in the PRL (default value)
1
Roaming on Affiliated networks, as defined in the PRL
2
Roaming on Any Network, as defined in the PRL.
Syntax: Command
syntax:
AT+WRMP=<mode>
Command
Possible Responses
AT+WRMP?
Note: Ask for current Mode Preference
+WRMP: 0
OK Note: Home only
AT+WRMP=?
+WRMP: (0-2)
OK Note: Home, Affiliated, Any
AT+WRMP=0
Note: Allow Home only networks
OK
+WROM: 0
Note: UnsolWROM may or may not
appear based on current circumstances
AT+WRMP=1
Note: Allow Roaming Affiliated Networks
OK
+WROM: 1
Note: UnsolWROM may or may not
appear based on current circumstances
AT+WRMP=2
Note: Allow Roaming on Any Network
OK
+WRMP: 2
Note: UnsolWROM may or may not
appear based on current circumstances
Network Registration & Roaming +CREG
Description:
This command is used by the application to ascertain the registration and roaming status of the product.
Note:
Also see +WROM unsolicited response for CDMA roaming status.
Values:
<mode>
0
Disable network registration unsolicited result code (
default
)
1
Enable network registration unsolicited code result code +CREG: <stat>
<stat>
0
not registered, MS is not currently searching for a new operator.
1
registered, home network.
2
not registered, MS currently searching for a base station.
4
unknown.
5
registered, roaming
Syntax:
Command syntax:
AT+CREG= <mode>
Response syntax:
+CREG: <mode>, <stat>
Command
Possible Responses
AT+CREG=0
Note: Disable network registration unsolicited result code.
+CREG: 0,1
OK Note: Command valid
AT+CREG=1
Note: Enable network registration unsolicited result code
+CREG: 1,1
OK Note: Command valid
AT+CREG? +CREG:
1,5
OK Note: Unsolicited enabled,
MS currently roaming.
AT+CREG=?
+CREG: (0-1)
OK Note: 0,1 <mode> values are
supported
Note: Example of the unsolicited result code. MS is
searching for a base station.
+CREG: 2