CTM-15X Modem Command Reference (R1.3.0)

This command is used to configure Assisted GPS (A-GPS) parameters on supported wireless data cards/modules.

The cellular device chipset contains a GPS receiver. Position Determine Equipment (PDE) assists the cellular device to speed up satellite acquisition, the PDE sends satellite almanac and ephemeris information to the device.

This feature currently only works on later model Sierra Wireless data devices that support A-GPS (USB598, USB597). When a later model Sierra Wireless data device is used with a modem configured in half bridge mode, A-GPS support is not available and must be disabled.

cmd agpspde ip port tm pc pl nl

Where:

ip ip address for location processing (Range: 0.0.0.0 to 255.255.255.255)

port port id for location processing (Range: 0 to 65535)

tm transportation mechanism (Range: 0 to 1) 0 - TCP/IP(default), 1 - Data Burst

pc position calculation type, fix type (Range: 1 to 6) 1 - Standalone, 2 - MS-based only, 3 - MS-assisted only = A-GPS Only(default), 4 - Optimum speed, 5 - Optimum accuracy, 6 - Optimum data

pl privacy level for location processing (Range: 0 to 2) 0 - low(default), 1 - medium, 2 - high

nl network access level for location processing (Range: 0 to 3) 0 - network access only, 1 - no network access, 2 - network access with demodulation(default),3 - network access without demodulation

Examples:

1. Set A-GPS parameters:
2. Disable A-GPS feature:

A cmd save and a powercycle is required for this command to take effect.

APN <name-of-apn>
This command configures the APN(Access Point Name) for a modem. This command is only applicable to GSM/GPRS/HSPA devices.

cmd apn will query current APN value

Examples:

1. Query current APN
2. Set APN

apply

This command applies changes to network and firewall settings. The command takes no arguments, and returns OK when complete.

cmd apply is required to make changes take effect after the following configuration commands:

• cmd dmz
• cmd friends
• cmd lanip
• cmd lannetmask
• cmd landhcp
• cmd rmtweb
• cmd rmttelnet
• cmd rmtssh
• cmd user
• cmd pswd
• cmd firewall
• cmd telnetport
• cmd ethernet

Examples:

1. Set the LAN subnet

boomreport [r1] [r2] [r3] [r4] [r5] [r6] [r7] [r8]

This command sets the report(s) to be used for boom-tracker triggered reports.
Where:
r = 0 disables the report
r = 1 to 999 report number

boomreport requires the modem to be listening for traffic from the WPAN gateway, this requires cmd mode 10 to be configured.

Examples:

1. Use report 2 for boom-tracker triggered reports.
2. User report 1, 2 and 4 for boom-tracker triggered reports.
3. Disable boom-tracker triggered reports
A cmd save is required for this command to take effect.

---

See also: mode, repaddmes, repdelmes, repemail, replocport, repremip, repremport, repsms, reptype

cardlistclear

Removes list of approved swipe-card IDs from modem.

Example:

---

See also: cardlistload, cardlistsave

cardlistload file-name url username passwd

This command is used to load the approved ID list used with the swipe card interface from a remote location (FTP/HTTP server). The approved ID list file is copied to /var/config/approved.txt.

The command requires 4 parameters when accessing an FTP server or 2 parameters when accessing an HTTP server:

• file-name the name of the approved ID list to load onto the modem
• url the address of the FTP or HTTP server, can also be an IP address, prefixed by ftp:// or http:// respectively; if no prefix is specified (eg. cypress.bc.ca) then ftp:// is used
• username username to access FTP server (ignored when url is prefixed by http://)
• passwd password to access FTP server (ignored when url is prefixed by http://)

Examples:
cmd cardlistload new-approved.txt cypress.bc.ca guest guestpw where new-approved.txt is the approved ID list, cypress.bc.ca is the FTP server, guest is the username of the FTP server and guestpw is the password of the FTP server

cmd cardlistload new-approved.txt http://cypress.bc.ca where new-approved.txt is the approved ID list, and cypress.bc.ca is the HTTP server

After using this command, a cmd save is required to save the approved ID list.

---

See also: cardlistclear, cardlistsave, mode, swipereport

cardlistsave

Store a list of approved swipe-card IDs for use by redboot loader swipe card reader application.
Note that a list of approved IDs must first be loaded to the modem using cardlistload.

Example:

---

See also: cardlistclear, cardlistload

cardlockload lock-script-file-name url username passwd

This command is used to load the custom lock script associated with the swipe card interface. The command requires 4 parameters when accessing an FTP server or 2 parameters when accessing an HTTP server:

• lock-script-file-name the name of the lock script file
• url the address of the FTP or HTTP server, can also be an IP address, prefixed by ftp:// or http:// respectively; if no prefix is specified (eg. cypress.bc.ca) then ftp:// is used
• username username to access FTP server (ignored when url is prefixed by http://)
• passwd password to access FTP server (ignored when url is prefixed by http://)

Examples:
cmd cardlockload lock.sh cypress.bc.ca guest guestpw where lock.sh is the lock script, cypress.bc.ca is the FTP server, guest is the username of the FTP server and guestpw is the password of the FTP server

cmd cardlockload lock.sh http://cypress.bc.ca where lock.sh is the lock script, and cypress.bc.ca is the HTTP server

After using this command, a cmd save is required to save the lock script.

---

See also: cardunlockload, mode

cardunlockload lock-script-file-name url username passwd

This command is used to load the custom unlock script associated with the swipe card interface. The command requires 4 parameters when accessing an FTP server or 2 parameters when accessing an HTTP server:

• unlock-script-file-name the name of the unlock script file
• url the address of the FTP or HTTP server, can also be an IP address, prefixed by ftp:// or http:// respectively; if no prefix is specified (eg. cypress.bc.ca) then ftp:// is used
• username username to access FTP server (ignored when url is prefixed by http://)
• passwd password to access FTP server (ignored when url is prefixed by http://)

Examples:
cmd cardunlockload unlock.sh cypress.bc.ca guest guestpw where unlock.sh is the unlock script, cypress.bc.ca is the FTP server, guest is the username of the FTP server and guestpw is the password of the FTP server

cmd cardunlockload unlock.sh http://cypress.bc.ca where unlock.sh is the unlock script, and cypress.bc.ca is the HTTP server

After using this command, a cmd save is required to save the unlock script.

---

See also: cardlockload, mode

clientmac nn:nn:nn:nn:nn:nn

Use clientmac to set the MAC address of a client computer Ethernet interface, if using modem mode (half-bridge mode) and DHCP.

nn:nn:nn:nn:nn:nn 12-digit hexadecimal address

The clientmac address can be queried by using this command without parameters.

Examples:
cmd clientmac 00:a0:d1:69:b2:c8
OK

cmd clientmac
cmd clientmac 00:a0:d1:69:b2:c8
OK

---

See also: modemmode, modemmodedhcp

confupgrade script-name url username passwd

Configures the modem for over-the-air configuration by means of a custom configuration script retrieved from a defined FTP or HTTP server.

The command requires 4 parameters when accessing an FTP server, 2 parameters when accessing an HTTP server, or 2 parameters when accessing scripts locally.

The script file is a text file containing modem commands used to configure a modem. The script file must have UNIX line endings.

For example:

• script-name the name of the configuration script to fetch/run
• url can be localhost, or the address of the FTP or HTTP server, can also be an IP address, prefixed by ftp:// or http:// respectively; if no prefix is specified (eg. cypress.bc.ca) then ftp:// is used
• username username to access FTP server (ignored when url is prefixed by http:// or localhost://, or url is localhost)
• passwd password to access FTP server (ignored when url is prefixed by http:// or localhost://, or url is localhost)

When localhost is specified as the url, the script file and its corresponding .md5 file must be located in /etc/config on the modem. Likewise, when localhost://tmp is specified as the url, the script file and its corresponding .md5 file must be located in /tmp on the modem.

Examples:
cmd confupgrade ctm15x-config.sh cypress.bc.ca guest guestpw where ctm15x-config.sh is the script file, cypress.bc.ca is the FTP server, guest is the username of the FTP server, and guestpw is the password of the FTP server

cmd confupgrade ctm15x-config.sh http://cypress.bc.ca where ctm15x-config.sh is the script file, and cypress.bc.ca is the HTTP server

cmd confupgrade action.sh localhost://tmp will execute the script /tmp/action.sh on the modem

cmd confupgrade action.sh localhost will execute the script /etc/config/action.sh on the modem

ctm15x

This command is used to enable a reset of protected configuration values.
Current protected configuration commands are:

• cmd data
• cmd ethernet
• cmd enghours
• cmd odometer
• cmd rfswitch

cmd ctm15x must be run once prior to setting any of the above configuration values.
cmd ctm15x is volatile and cannot be saved, its state will be reset following a modem power cycle or reboot

---

See also: data, ethernet, enghours, odometer

data [0]

This command keeps track of the amount of data transmitted and received over the wireless data link.

The total data transmitted and data received counts can only be reset by using the following command:
cmd data 0

0 Set to 0 to reset

The current amount of data transmitted and received can be queried using cmd data without parameters, the result is shown in megabytes (MB).
A cmd factory does not reset the wireless link count statistics of this command.

Examples:

1. Reset the link data count to 0
2. Query the current link data count

---

See also: ctm15x, datacond

datacond x

This command is used to set the condition that will trigger wireless link data count report(s). Report(s) are sent whenever the total amount of data transmitted and received is a multiple of a specified amount.

x = 0 disables the condition
x = 1 to 1999999 total data amount in MB used for periodic triggering

The default configuration upon cmd factory is cmd datacond 10.

Examples:
1. Set trigger when 5 MB total data has been transmitted and received (such as when 1 MB of data was transmitted, and 4 MB of data was received)
2. Query the current link data trigger condition

---

See also: data, datareport

datareport [r1] [r2] [r3] [r4] [r5] [r6] [r7] [r8]

This command sets the report(s) to be used for link data count triggered events.
See data and datacond for information on configuring the link data reports.

Where:
r = 0 disables the report
r = 1 to 999 report number

Examples:

1. Use report 2 for link data count triggered reports.
2. User report 1, 2 and 4 for link data count triggered reports.
3. Disable link data count triggered reports

---

See also: datacond, repaddmes, repdelmes, repemail, replocport, repremip,
repremport, repsms, reptype

dir pppppppppp [qqqqqqqqqq]

This command sets the NAM (Number Assignment Module) value for the modem. It is a 10-digit phone number assigned to the modem by the service provider. Use the spc command to unlock the modem first. The NAM value may be queried by using the dir command without parameters.

This command also sets the MIN (Mobile Identification Number) value for the modem. It is a 10-digit number assigned to the modem by the service provider. Use the spc command to unlock the modem first.

pppppppppp 10-digit phone number (MDN) to be assigned to the modem or “+” if only MIN is to be assigned

Optional Parameter:

qqqqqqqqqq 10-digit phone number (MIN) to be assigned to the modem

Note: Previous firmware versions included cmd min for setting the MIN value of the modem. However, cmd min has been replaced by cmd dir. Using cmd dir as shown one of the examples below are the only ways to set the MIN value of the modem.

Examples:

1. Set the modem’s MDN and MIN
2. Set the modem’s 10-digit number (MDN)
3. Set the modem’s 10-digit number (MIN)
4. Query the modem’s currently assigned phone number (MDN)
A cmd save is required for this command to take effect.

dnscheck x

This command is used to enable or disable the CTM-15X modem from checking for valid DNS IP addresses obtained from the carrier when it connects to the network. If the DNS IP addresses are invalid, the modem will disconnect the current network connection and reconnect.

After 5 reconnects have been attempted every 30 secs, and the modem still gets an invalid DNS, the modem will stop disconnecting and reconnecting the network connection.

x = 0 disable checking for valid DNS IP addresses from the carrier
x = 1 enable checking for valid DNS IP addresses from the carrier (default)

Examples:

1. Disable checking DNS IP addresses from the carrier.

A cmd save and a power cycle are required for this command to take effect.

dout n x

This command is used to set the state of each of the all outputs. There are four outputs in total.

n = 1 to 4 output channel number
x = 0 sets output to off
x = 1 sets output to on

The current settings can be queried by using the dout command without parameters.

Examples:

1. Set output #2 ON
2. Query the state of all four outputs
A cmd save is required for this command to take effect.

dyndns text1 text2 text3

This command configures the modem to perform regular updates to the Dynamic Domain Name Service.
This feature creates an alias from a dynamic IP address to a static hostname allowing the modem to be more easily accessed over the Internet for remote configuration or for end application. For this feature, the modem requires a public IP address . By default this feature is disabled - “, ,”. This command requires a cmd save command and power cycle for the changes to take effect.

text1 user name for the DYNDNS service.
text2 user password for the DYNDNS service.
text3 domain (hostname) name for the DYNDNS

The current settings of the DYNDNS (Dynamic Domain Name Service) can be queried by using the dyndns command without parameters.
DYNDNS updates can be disabled by using 0 for the user name, 0 for the user password, and 0.0.0.0 for the hostname. Note that after disabling DYNDNS updates, the hostname will continue to point to the last IP address of the modem. For instructions on clearing the IP address associated with the hostname, please refer to DYNDNS documentation for details on using the offline hostname feature.

Examples:

1. Set the user name and password and the domain name
2. Disable DYNDNS updates
3. Query the modem’s setting for this setting
A cmd save is required for this command to take effect.

emailsrv a.a.a.a

This command is used to set the IP address of the SMTP email server that will be used by the modem for sending email reports.
The commands gpsrep, ignreport, and reptype are used to enable email reporting.

a.a.a.a = 0.0.0.0 to 255.255.255.255 IP address of the email server to be used for email reports. Default = 0.0.0.0
The current email server IP address can be queried by using the emailsrv without parameters.

Examples:

1. Set the email server IP address to 100.120.10.10
2. Query current email server
A cmd save is required for this command to take effect.

enghours n

Since total engine hours data is not available through standard OBD2 interface, Total engine hours must be calculated using other methods.
When a modem is installed in a vehicle and the current vehicle engine hours are known, the current engine hours will need to be programmed.

This can be done through the following command:
cmd enghours n

n Total engine hours in hours (0-999999.99).

The current value of engine hours can be queried using cmd enghours without parameters and is shown in hours.

The modem must be configured to enable engine hours counting using the enghrmode command.

Example:

1. Set the engine hours to 2501

---

See also: ctm15x

enghrmode n

cmd enghrmode n
Where n:

0 Disabled (Default, Engine hours can still be obtained if vehicle has J1939 capability)
1 Use ignition input only
2 Use OBD2 input only
3 Use combination of ignition and OBD2 inputs

A cmd save is required for this command to take effect.

esn

This command queries the 32 bit ESN (Electronic Serial Number) of the embedded wireless network access device.
The ESN is read only and cannot be altered.

Example:

1. Query the 11 digit ESN in decimal format

http://en.wikipedia.org/wiki/Electronic_Serial_Number

ethernet x

This command is used to enable or disable the Ethernet services of the modem.
Ethernet services are enabled by default whenever a cmd factory is issued.
x = 0 disable Ethernet services
x = 1 enable Ethernet services

Example:

1. Disable Ethernet services
A cmd apply followed by a cmd save are required for this command to take effect.

---

See also: ctm15x

firewall n eeeee lllll t iii.iii.iii.iii s

This command is used to setup the port forwarding configuration of the modem.
Up to 10 port forwarding configurations can be set.
The local IP address will default to 192.168.1.X, where X is extracted from iii.iii.iii.iii and 192.168.1 is extracted from the IP address in the LAN Configuration setting.

n = 1 to 10 port forwarding number
eeeee = 0 to 65535 external port number to forward to
lllll = 0 to 65535 local port number to forward to
t = 0 disable
t = 1 UDP
t = 2 TCP
t = 3 both UDP and TCP
iii.iii.iii.iii = 0.0.0.0 to 255.255.255.255 local IP address to forward to
s = 0 disable forwarding
s = 1 enable forwarding

The current port forward settings can be queried by using firewall without parameters.

Note that LAN IP addresses used in port forwarding rules must match the LAN subnet as configured using cmd lanip, cmd lannetmask, and cmd lanrepip.

Examples:

1. Set port forwarding #1 to forward data destined for port 8080 (same external & local port number), on both using UDP and TCP protocol to IP 192.168.1.20 and enabled
2. Set port forwarding #2 to forward data destined for external port 42375 and redirect it to local port 5001, on UDP protocol to IP 192.168.1.20 and enabled.
3. Query the current firewall configuration
A cmd apply followed by a cmd save are required for this command to take effect.

freeconsole

Kill the serial console shell process. This command must be done at first if you use cmd pad or cmd modbusgw from the SSH/Telnet console in mode 4 or 6.

Example:

1. Free the serial console port to use by pad or modbusgw mode.

The serial console is not available after this command. You may need to set cmd port to use serial console again.

friends n x.x.x.x y.y.y.y

This command is used to setup the modem's firewall friends list, which is used to block incoming packets from an IP address that is not specifically enabled.
Use this to define a range of IP addresses whose traffic you wish to be accepted by the modem.

This feature controls access to the following modem features:

• MODBUS
• PAD
• ULCP
• Remote SSH access (R1.3.0 only)
• Remote Telnet access
• Remote Web access

Port forwarding configured via firewall and the DMZ feature configured via dmz are accessible by all IP addresses. The friends list feature does not control access to these features.

Modem access is verified in ascending order via the OR condition of all entries in the friends list.

n = 1 to 8 friends list number
x.x.x.x = 0.0.0.0 to 255.255.255.255 IP address/range to allow
y.y.y.y = 0.0.0.0 to 255.255.255.255 netmask of addresses to allow

By default, the friends list is disabled and all IP addresses are allowed to access the modem.

The current friends list can be queried by using friends without parameters. An empty friends list indicates that this feature is disabled.

Examples:

1. Allow only incoming requests from the IP address 1.2.3.4 to access the modem
2. Allow only incoming requests from the 1.2.3.x subnet to access the modem
3. Allow only incoming requests from the 1.2.3.x subnet to access the modem. This is equivalent to Example #2 above.
4. Disable the friends list entry and allow all IP addresses to access the modem (default)

A cmd apply followed by a cmd save are required for this command to take effect.

gpsaccel n a d

Sets the GPS report triggers for capturing hard acceleration and deceleration events.
Reports will be triggered if the instantaneous acceleration is greater than a or the instantaneous acceleration is less than d.
The default thresholds are 0 km/h/s for acceleration and 0 km/h/s for deceleration.

n = 1 to 8 GPS report number
a acceleration threshold in km/h/s
d deceleration threshold in km/h/s

Examples:

1. Send GPS report #7 whenever acceleration is greater than 10 km/h/s or deceleration is less than -10 km/h/s
A cmd save is required for this command to take effect.

gpsaddmes n x [x2] [x3] [x4]

Adds messages to a GPS report. 4 messages can be included in a single report. Duplicate messages cannot be included in a report.
Messages will be sent in a report in the same order that they are added with this command.
ULCP header messages will be sent as individual UDP packets, NMEA format messages will be combined into a single packet.

n = 1 to 8 GPS report number
x message type to be added, valid message types must be used - see Message Formats

Examples:

1. Adds message #16 – GPS NMEA GLL – to GPS report #4
2. Query messages for GPS report #4
A cmd save is required for this command to take effect.

---

See also: gpsrep, gpsdelmes, gpslocport, gpsremip, gpsremport, gpsemail, gpssms

gpscond n b t [d] [ms Ms] [h hs] [mt]

Sets the condition(s) that will trigger a GPS report.
The conditional operator is used to indicate how all following parameters will be used to determine if a report is triggered.
The mt parameter must be used at the end if all other optional parameters are entered.
The default condition for report #11 is 11 1 10 (these can be changed, the first three parameters are valid for report #11 ONLY).

n = 1 to 8 GPS report number
b = 0 conditional operator for all following parameters: Off
b = 1 conditional operator for all following parameters: AND
b = 2 conditional operator for all following parameters: OR
t = 0 timeout disabled
t = 1 to 65535 timeout in seconds

Optional parameters:
d = 0 to 65535 distance traveled threshold in meters
ms = 0 to 65535 low speed threshold in kph – use with Ms
Ms = 0 to 65535 high speed threshold in kph – use with ms
h = 0 to 359 heading change in degrees – use with hs
hs = 0 65535 minimum speed threshold to make heading measurement valid, in kph – use with h
mt = 0 to 65535 maximum reporting rate in seconds (minimum time between reports)

The current condition(s) for a report can be queried by using the gpscond n command. If n is blank, all GPS reports will be queried.

Examples:

1. Send report #1 every 60 seconds
2. Send report #2 every 60 seconds AND distance is greater than 50 metres
3. Send report #4 every 60 seconds AND the distance traveled is greater than 50 metres AND the speed is between 20kph and 60kph
4. Send report #5 every 60 seconds OR when distance traveled is greater than 50 metres OR speed is greater than 60kph, OR if the heading changes by more than 45 degrees, with a maximum report rate of one every 10 seconds
5. Send report #6 only when distance traveled is greater than 0 metres AND the speed is between 0kph and 5kph AND with a maximum report rate of one every 7 seconds
6. Query the conditions used to trigger all GPS reports
7. Query the conditions used to trigger GPS report #4
A cmd save is required for this command to take effect.

gpsdata

Displays the current status of GPS input devices configured via gpsinput and corresponding GPS data.
This command is read-only.

Example:
cmd gpsdata displays the status of currently configured GPS input devices and GPS data obtained from the devices

---

See also: gpsinput, gpsparam

gpsdelmes n x

This command is used to delete a message type (or all messages) from a GPS report.

n = 1 to 8 GPS report number
x message type to be deleted (0 to delete all messages)

Examples:

1. Delete message type #16 from GPS report #1
2. Delete all messages from GPS report #4
A cmd save is required for this command to take effect.

---

See also: gpsrep, gpsaddmes, gpslocport, gpsremip, gpsremport, gpsemail, gpssms

gpsemail n <email address>

Sets the email address that the GPS report will be sent to (if configured for email using gpsrep).
Up to 8 email addresses may be configured – one for each of the 8 GPS reports. The default email address is blank.

Note that an email server is required – see emailsrv.

n = 1 to 8 GPS report number
<email address> = name@domain email address to which the report will be sent
(leave blank to clear the address)

The current email address configured for all GPS reports can be queried by using the gpsemail command without parameters.

Examples:

1. Set the destination email address for GPS report #1
2. Clear the email address for GPS report #1
3. Query the email address for all GPS reports
A cmd save is required for this command to take effect.

---

See also: gpsrep, gpsdelmes, gpslocport, gpsremip, gpsremport, gpsaddmes, gpssms

gpsgga

Displays the current GPS position in NMEA0183 format.
This command is a read only command.

Example:

1. Return a current GPS NMEA format GGA message

gpsinput m

This command defines what source to use for GPS data.

cmd gpsinput m

Where:
m=mode (bit mapped) default=0x01
m.0 - Input 1 = Use internal GPS module (TSIP)
m.1 - Input 2 = Use internal GPS module (NMEA)
m.2 - Input 3 = Use external GPS module (NMEA)
m.3 - Input 4 = Use A-GPS module (NMEA)

Example:

A cmd save and a powercycle is required for this command to take effect.

gpslocport n xxxxx

Sets the port number of the local server that the GPS report will be sent to.
Up to 8 GPS reports may be configured.
The default port for report #11 is 6102.

n = 1 to 8 or 11 GPS report number
xxxxx = 0 to 65535 local port number in decimal

The current local port configuration for a GPS report can be queried by entering gpslocport n, where n is the port number.
If n is omitted, all reports will be queried.

Examples:

1. Send report #1 to local port 5005
2. Query the local port setting of all GPS reports
A cmd save is required for this command to take effect.

---

See also: gpsrep, gpsdelmes, gpsaddmes, gpsremip, gpsremport, gpsemail, gpssms

gpsmes

Displays all messages associated with each GPS report.
This command is read only.

Example:
cmd gpsmes displays all messages associated with each GPS report

gpsparam

This command configures the parameters and priority of the port the modem will use for obtaining GPS information.

cmd gpsparam input priority port br db p sb fc

Where:
input - GPS input to configure 1-4
priority - Data Priority (0-3). 0=highest
port - Serial port to use. e.g. ttyS1 or ttyUSB14
br - baud rate (same as cmd port)
db - data bits (same as cmd port)
p - parity (same as cmd port)
sb - stop bits (same as cmd port)
fc - flow control (same as cmd port)

If all enabled ports are available and have valid GPS, the highest priority input is used.

Notes:

• This can feature can also be used for A-GPS since it is outputting NMEA data on a ttyUSB port.
• When GPS inputs are configured at the same priority, GPS data will be obtained from whichever GPS input has valid data first, in ascending order from GPS input 0 to GPS input 3.

Example:

A cmd save and a powercycle is required for this command to take effect.

gpspos n ±xx.xxxxxx ±yyy.yyyyyy

Set fixed GPS position mode. This sets the GPS coordinates used in modem reports to user-defined latitude and longitude values. When this setting is enabled, the GPS date and time used in modem reports is synchronized to the modem's system time.

This setting is used for monitoring modems used with fixed-site applications.

n = 0 Disable fixed GPS position mode. Use GPS position from GPS input device configured with gpsinput. (Default)

n = 1 Enable fixed GPS position mode. Use user-defined location.

±xx.xxxxxx = -90.000000 <= ±xx.xxxxxx <= +90.000000 latitude in decimal format, where North=positive and South=negative

±yyy.yyyyyy = -180.000000 <= ±yyy.yyyyyy <= +180.000000 longitude in decimal format where East=positive and West=negative

A cmd save and a power cycle are required for this command to take effect.

Notes:

• cmd gpspos 0 will disable the fixed GPS position mode but preserve the user-defined location
  
• cmd gpspos 0 0 0 will disable the fixed GPS position mode and clear the user-defined location
  

Example:

1. Enable fixed GPS position mode and set the user-defined location to (49.256553, -122.996733):
2. Disable fixed GPS position mode but preserve the user-defined location:
3. Disable fixed GPS position mode and clear the user-defined location:

---

See also: gpsinput

gpsremip n iii.iii.iii.iii

Sets the IP address of the remote server that the GPS report will be sent to. Up to 8 GPS reports can be configured.

n = 1 to 8 or 11 GPS report number
iii.iii.iii.iii = 0.0.0.0 to 255.255.255.255 remote IP address in decimal

The remote IP address of a report can be queried by using gpsremip n where n is the report number.
If n is omitted, all reports will be queried.

Examples:

1. Report #1 will be sent to remote IP address 123.10.1.101
2. Query the remote IP address setting of all GPS reports
A cmd save is required for this command to take effect.

---

See also: gpsrep, gpsdelmes, gpslocport, gpsaddmes, gpsremport, gpsemail, gpssms

gpsremport n xxxxx

Sets the IP port number of the remote server that the GPS report will be sent to.
Up to 8 GPS reports can be configured.

n = 1 to 8 or 11 GPS report number
xxxxx = 0 to 65535 remote port number in decimal

The current IP port configuration for a GPS report can be queried by using gpsremport n where n is the report number.
If n is omitted, all reports will be queried.

Examples:

1. Report #1 will be sent to port 5005 on remote IP address set by gpsremip
2. Query the remote port setting of all GPS reports
A cmd save is required for this command to take effect.

---

See also: gpsrep, gpsdelmes, gpsaddmes, gpsremip, gpsremport, gpsemail, gpssms

gpsrep n l r s

Sets the reporting type for each GPS report for the local and remote servers.

n = 1 to 8 or report 11 GPS report number

l = 0 disables local GPS report (default)
l = 1 asynchronous NMEA or ULCP messages over RS232
l = 2 asynchronous NMEA or ULCP messages with a ULCP header over RS232
l = 3 in-band NMEA or ULCP messages in a UDP Packet over Ethernet
l = 4 in-band NMEA or ULCP messages with a ULCP header and in individual UDP packets over Ethernet
l = 5 in-band NMEA or ULCP messages in a TCP Packet over Ethernet
l = 6 file-based reports

r = 0 disables remote GPS report (default)
r = 3 in-band NMEA or ULCP messages in a UDP Packet
r = 4 in-band NMEA or ULCP messages with a ULCP header and in individual UDP packets
r = 5 in-band NMEA or ULCP messages in a TCP Packet
r = 6 email reports
r = 7 SMS reports

s = 0 disables the store and forward of GPS reports
s = 1 enables the store and forward of GPS reports

Note: For r = 7 (SMS reports), the total length of the report must not exceed 166 characters including <CR> and <LF>

The current report type configuration for a GPS report can be queried by using gpsrep n where n is the report number.
If n is omitted, all reports will be queried.

Examples:

1.Send GPS report #4 as a UDP packet over Ethernet and over the wireless link, do not store GPS reports
2. Send GPS report #2 as a UDP packet over Ethernet and as an SMS message to the SMS destination set using the gpssms command, and enable the store and forward of GPS reports
3. Queries the reporting method for all GPS reports
A cmd save is required for this command to take effect.

---

See also: gpsaddmes, gpsdelmes, gpslocport, gpsremip, gpsremport, gpsemail, gpssms

gpsrmc

Displays the current GPS position in NMEA0183 format.
This command is a read only command.

Example:

1. Return a current GPS NMEA format RMC message NMEA 0183 v2.0:
NMEA 0183 v3.0:

gpssms n pppppppppp or <email address>

Sets the destination of the GPS report that is sent as an SMS message.
Up to 8 GPS reports may be configured. The default SMS destination is blank.

Note: SMS features are only available for specific manufacturer, RF modules, cards or devices. Please contact Cypress Solutions for a complete list of products that support SMS functionality.

n = 1 to 8 GPS report number
pppppppppp phone number which the SMS report will be sent to. For long distance calls, a “1” needs to be added In front of the phone number.
(leave blank to clear the phone number)

<email address> email address which the SMS report will be sent to.
(leave blank to clear the address)

The current SMS destination configured for all GPS reports can be queried by using the gpssms command without parameters.

Examples:

1. Send GPS report #1 as an SMS message to the specified phone number
2. Send GPS report #2 as an SMS message to the specified email address
3. Clear the SMS destination for GPS report #1
4. Query the phone numbers or email addresses for all GPS SMS reports
A cmd save is required for this command to take effect.

gpstime n

Set the priority of valid GPS as an external system time synchronization source.

n = 0 Disabled
n = 1-3 Priority relative to other external system time synchronization sources with 1 = highest (default: 1)

A cmd save and a power cycle are required for this command to take effect.

Example:

1. Set valid GPS as lowest priority relative to other external time synchronization sources:

---

See also: networktime, ntpserver, ntptime, timesync

igncond n a

Sets the condition(s) that would trigger an ignition report.
The state of the ignition is controlled by the "white" wire of the 3 wire power connection.
The conditional parameter, a is used to indicate how all following parameters will be used to determine if a report is triggered.

n = 1 to 8 ignition condition number
a = 0 trigger disabled (default)
a = 1 trigger on ignition going OFF
a = 2 trigger on ignition going ON
a = 3 trigger on transition (ON->OFF or OFF->ON)

The current ignition condition(s) for can be queried by igncond n where n is the condition number.
If n is blank, all ignition conditions will be queried.

Examples:

1. Set ignition condition 1 to trigger when ignition is going OFF
2. Set ignition condition 2 to trigger when an ignition transition (ON to OFF or OFF to ON) is detected.
A cmd save is required for this command to take effect.

---

See also: ignreport

ignreport [n] [r]

This command sets the report to be used for ignition triggered reports.
Up to 8 ignition trigger reports can be configured.

n = 1 to 8 ignition trigger condition
r = 1 to 999 report number
r = 0 disables the report

Example:

1. Set report #2 for ignition trigger condition #1.
A cmd save is required for this command to take effect.

---

See also: igncond, repaddmes, repdelmes, repemail, replocport, repremip, repremport, repsms, reptype

input

Reads the value and state of all inputs. There are a total of six inputs.
Both the analog voltage (range 0 to 10 Volts) and digital state (0 for off and 1 for on) are returned.

This is a read only command.

Example:

1. Query the current status of input #1 through #6

insetup n d x.x p a

Configures the six inputs. Their use as a digital or analog input can be set along with their alarm states.

Note: Voltage threshold values are accurate to one decimal place, (X.X), if additional decimal place values are entered, they will be rounded to the nearest decimal place.

n = 1 to 6 input channel number

d = A set as analog input
d = D set as digital input

x.x = 0 to 9.9 sets the voltage threshold for alarm reporting (valid if input set as analog only, use 0.0 for digital input)

p = P sets input polarity to positive (this also determines the alarm level)
p = N sets input polarity to negative (this also determines the alarm level)

a = 0 alarm off
a = 1 alarm on
a = 2 alarm on change state (valid for digital inputs only)

The current setup can be queried by using the insetup without parameters.

Note: When configuring insetup with a digital input, the voltage threshold parameter is ignored. The modem's I/O module has fixed digital input thresholds of 3 V and 2 V (1 V hysteresis).

Examples:

1. Set input #2 as digital, with alarm when ON
2. Set input #4 as analog, with alarm when > 7.5V
3. Query the setup parameters for all 6 inputs
A cmd save is required for this command to take effect.

ioaddmes n x [x2][x3][x4]

Adds a message to an IO report. 4 messages can be included in a single report. Duplicate messages cannot be included in a report.
Messages will be sent in a report in the same order that they are added.
Note that ULCP header messages will be sent as individual UDP packets – NMEA format messages will be combined into one UDP packet.

n = 1 to 8 IO report number
x message type to be added, valid message types must be used - see Message Formats.

Example:
cmd ioaddmes 4 16 adds message type #16 – GPS NMEA GLL – to IO report #4
cmd ioaddmes 4 displays all messages associated with IO report #4

A cmd save is required for this command to take effect.

iocond n b t i1 i2 IP mt

Sets the condition(s) that would trigger an IO report.
The conditional parameter is used to indicate how all following parameters will be used to determine if a report is triggered.
Use the Off setting to disable the report.

n = 1 to 8 IO report number

b = 0 conditional operator for the following parameters: Off (default)
b = 1 conditional operator for the following parameters: AND
b = 2 conditional operator for the following parameters: OR

t = 0 timeout disabled
t = 1 to 65535 timeout in seconds

i1 = 0 alarm on input trigger: disabled
i1 = 1 to 6 alarm on input trigger: input number
i2 = 0 alarm on input trigger: disabled
i2 = 1 to 6 alarm on input trigger: input number

IP = 0 report if change in IP address: disabled
IP = 1 report if change in IP address: enabled

mt = 0 to 65535 maximum reporting rate in seconds (minimum time between reports)

The current condition(s) for a report can be queried by using iocond n where n is the report number.
If n is blank, all IO reports will be queried.

Examples:
cmd iocond 1 1 60 sends report #1 every 60 seconds
cmd iocond 2 1 60 1 sends report #2 every 60 seconds if input #1 is in alarm
cmd iocond 3 1 60 1 2 send report #3 every 60 seconds if inputs #1 and #2 are in alarm
cmd iocond 4 2 0 0 0 1 send report #4 whenever the IP address of the modem changes – this indicates that it has made a new network connection
cmd iocond 5 2 60 0 3 0 10 send report #5 every 60 seconds or while input #3 is in alarm but with a maximum report rate of one every 10 seconds
cmd iocond 6 1 0 6 0 0 10 send report #6 only while input #6 is in alarm but with a maximum report rate of one every 10 seconds
cmd iocond queries the conditions to trigger all IO reports

A cmd save is required for this command to take effect.

iodelmes n x

Deletes a message (or all messages) from an IO report.

n = 1 to 8 IO report number
x message type to be deleted or 0 to delete all messages

Examples:
cmd iodelmes 1 16 deletes message type #16 from IO report #1
cmd iodelmes 4 0 deletes all messages from IO report #4

A cmd save is required for this command to take effect.

ioemail n <email address>

Sets the email address that the IO report will be sent to (if configured for email using iorep).
Up to 8 email addresses may be configured – one for each of the 8 IO reports. The default email address is blank.

n = 1 to 8 IO report number

<email address> = name@domain email address to which the report will be sent
(leave blank to clear the email address)

The current email address can be queried for all IO reports by using the ioemail command without parameters.

Note that an email server is required – see emailsrv

Examples:

cmd ioemail 1 me@… sets the send to email address for IO report #1
cmd ioemail 1 clears the email address for IO report #1
cmd ioemail returns the email address for all 8 IO reports

A cmd save is required for this command to take effect.

iolocport n xxxxx

Sets the port number of the local server that the IO report will be sent to. Up to 8 IO reports may be configured.

n = 1 to 8 IO report number
xxxxx = 0 to 65535 local port number

The current local port configuration for an IO report can be queried by using iolocport n where n is the report number.
If n is omitted, all reports will be queried.

Examples:
cmd iolocport 1 5005 report #1 will be sent to local port 5005
cmd iolocport queries the local port setting of all IO reports

A cmd save is required for this command to take effect.

iomes

Displays all messages associated with each IO report.
This is a read only command.

Example:
cmd iomes displays all messages associated with each IO report

ioremip n iii.iii.iii.iii

Set the IP address of the remote server that the IO report will be sent to. Up to 8 IO reports may be configured.

n = 1 to 8 IO report number

iii.iii.iii.iii = 0.0.0.0 to 255.255.255.255 remote IP address in decimal

The current IP address for an IO report can be queried by using ioremip n where n is the report number.
If n is omitted, all reports will be queried.

Examples:

cmd ioremip 1 123.10.1.101 report #1 will be sent to remote IP address 123.10.1.101

cmd ioremip queries the remote IP address setting of all IO reports

A cmd save is required for this command to take effect.

ioremport n xxxxx

Sets the IP port number of the remote server that the IO report will be sent to. Up to 8 IO reports may be configured.

n = 1 to 8 IO report number

xxxxx = 0 to 65535 remote port number

The current IP port configuration for an IO report can be queried by using ioremport n where n is the report number.
If n is omitted, all reports will be queried.

Examples:

cmd ioremport 1 5005 report #1 will be sent to port 5005 on remote IP address set by ioremip

cmd ioremport queries the remote port setting of all IO reports

A cmd save is required for this command to take effect.

iorep n l r s

Sets the reporting type for each IO report for the local and remote servers.

n = 1 to 8 IO report number

l = 0 disables the local report (default)
l = 1 asynchronous NMEA or ULCP messages over RS232
l = 2 asynchronous NMEA or ULCP messages with a ULCP header over RS232
l = 3 in-band NMEA or ULCP messages in a UDP Packet over Ethernet
l = 4 in-band NMEA or ULCP messages with a ULCP header and in individual UDP packets over Ethernet
l = 5 in-band NMEA or ULCP messages in a TCP Packet over Ethernet
l = 6 file-based reports

r = 0 disables the remote report (default)
r = 3 in-band NMEA or ULCP messages in a UDP Packet
r = 4 in-band NMEA or ULCP messages with a ULCP header and in individual UDP packets
r = 5 in-Band NMEA or ULCP messages in a TCP Packet
r = 6 email reports
r = 7 SMS reports

s = 0 disables the store and forward of IO reports
s = 1 enables the store and forward of IO reports

Note: For r = 7 (SMS reports), the total length of the report must not exceed 166 characters including <CR> and <LF>

The current report configuration for an IO report can be queried by using iorep n where n is the report number.
If n is omitted, all reports will be queried.

Examples:
cmd iorep 4 3 3 this will send IO report #4 as a UDP packet over Ethernet and over the wireless link, and will not store IO reports

cmd iorep 2 3 7 1 this will send IO report #2 as a UDP packet over Ethernet and as an SMS message to the SMS destination set using the iosms command, and will enable the store and forward of IO reports

cmd iorep queries the reporting method for all IO reports

A cmd save is required for this command to take effect.

iosms n pppppppppp or <email address>

Sets the destination of the IO report that is sent as an SMS message. Up to 8 IO reports may be configured. The default SMS destination is blank.

Note: SMS features are only available for specific manufacturer, RF modules, cards or devices. Please contact Cypress Solutions for a complete list of products that support SMS functionality.

n = 1 to 8 IO report number

pppppppppp phone number which the SMS report will be sent to. For long distance calls, a “1” needs to be added In front of the phone number.
(leave blank to clear the phone number)

<email address> email address which the SMS report will be sent to.
(leave blank to clear the address)

The current SMS destination configured for all IO reports can be queried by using the iosms command without parameters.

Examples:

cmd iosms 1 1234567890 sends IO report #1 as an SMS message to the specified phone number

cmd iosms 2 me@… sends IO report #2 as an SMS message to the specified email address

cmd iosms 1 clears the SMS destination for IO report #1

cmd iosms queries the phone numbers or email addresses for all IO SMS reports

A cmd save is required for this command to take effect.

ipadr
Queries the IP address assigned to the modem by the wireless network.

This is a read only command.

Example:

1. Query the current IP address of the modem

landhcp ddd n (Firmware version R1.3.X)

Configures the LAN dynamic host configuration protocol (DHCP) server settings, specifically the starting IP address to assign to DHCP users and the maximum number of DHCP users on the LAN.

ddd = 0 to 255 Last number of starting DHCP IP address in decimal (default: 20)
n = 1 to 254 Maximum number of DHCP clients (default: 10)

The starting DHCP IP address (default: 192.168.1.20) is aaa.bbb.ccc.ddd where aaa.bbb.ccc is the bitwise AND result of the LAN IP address and the LAN netmask, and ddd is specified in this command. The ending DHCP IP address (default: 192.168.1.29) is aaa.bbb.ccc.eee where aaa.bbb.ccc is the bitwise AND result of the LAN IP address and the LAN netmask, and eee = ddd + n - 1.

A cmd apply followed by a cmd save are required for this command to take effect.

Examples:

1. Assign DHCP users with IP addresses starting at 192.168.1.20 to a maximum of 15 users.
2. When the LAN IP is set to 192.168.10.1, assign DHCP users with IP addresses starting at 192.168.10.20 to a maximum of 10 users.
3. Query current DHCP range and number of users

---

See also: landns, lanip, lannetmask, lanrepip, http://en.wikipedia.org/wiki/DHCP

lanip iii.iii.iii.iii

Sets the IP address of the modem on the LAN.

iii.iii.iii.iii = 0.0.0.0 to 255.255.255.255 LAN IP address of the modem in decimal (default: 192.168.1.1)

Note: Special care must be taken when configuring this command, if an improperly configured lanip IP address is entered the ethernet port can be rendered unusable. Before configuring this command it is advisable to make sure that a command console is available via the serial port, or the IP address is known and remote telnet is enabled to allow the modem to be accessed wirelessly.

The current LAN IP address can be queried by using lanip.

Examples:

1. Set the LAN IP address of the modem to 192.168.10.1
2. Query the LAN IP address of the modem
A cmd apply followed by a cmd save and a power cycle are required for this command to take effect. After taking effect, local Telnet should be accessed via the IP address specified in the command.

---

See also: landhcp, landns, lannetmask, lanrepip

lannetmask iii.iii.iii.iii

Sets the netmask of the modem on the LAN.

iii.iii.iii.iii = 0.0.0.0 to 255.255.255.255 LAN netmask of the modem in decimal (default: 255.255.255.0)

Note: Special care must be taken when configuring this command, if an improperly configured lannetmask IP address is entered the ethernet port can be rendered unusable. Before configuring this command it is advisable to make sure that a command console is available via the serial port, or the IP address is known and remote telnet is enabled to allow the modem to be accessed wirelessly.

The current LAN netmask can be queried by using lannetmask.

Examples:

1. Set the LAN netmask of the modem to 255.255.0.0
2. Query the LAN netmask of the modem
A cmd apply followed by a cmd save and a power cycle are required for this command to take.

---

See also: landhcp, landns, lanip, lanrepip

http://en.wikipedia.org/wiki/Netmask

lanrepip iii.iii.iii.iii

Sets the IP address of the local server connected to the modem’s LAN that will receive local reports.

iii.iii.iii.iii = 0.0.0.0 to 255.255.255.255 LAN IP address to receive local reports in decimal (default: 192.168.1.20)

This command requires a cmd save and power cycle to take effect.

The LAN IP address of the server currently used to receive local reports can be queried by using lanrepip.

Examples:

1. Set the local reporting LAN IP address to 192.168.1.21
2. Query the LAN IP address to which local reports will be sent
A cmd save is required for this command to take effect.

---

See also: landhcp, landns, lanip, lannetmask

mip n

Sets the Mobile IP operation of the modem. This command is only applicable to CDMA/EV-DO devices.

n = 0 simple IP only (mobile IP disable)
n = 1 mobile IP preferred (default)
n = 2 mobile IP only

The current mobile IP can be queried by using the mip without parameters.

Examples:
cmd mip 1 sets the MIP option to be MIP preferred
cmd mip returns the current MIP value

A cmd save is required for this command to take effect.

http://en.wikipedia.org/wiki/Mobile_IP

modbusadd

This command when used without arguments is used to display all the entries in the MODBUS slave gateway list.

Example:
cmd modbusadd displays the MODBUS list

modbusadd id nnn.nnn.nnn.nnn

This command is used when the modem is being used as a MODBUS SLAVE device.
Adds a MODBUS TCP Slave. The listening port for TCP slaves is the port number configured using modbusport.
id = 1 to 247 MODBUS ID
nnn.nnn.nnn.nnn = 1.0.0.0 to 255.255.255.255 MODBUS slave IP address (IP address of MODBUS devices connected to the modem's ethernet port)

modbusadd id Serial m

Adds a MODBUS Serial Slave (Added in firmware version R1.2.1)

id = 1 to 247 MODBUS ID
m = a or A ASCII transmission mode
m = r or R RTU transmission mode

Note1: The MODBUS slave gateway will use the serial port settings configured using the port command for all serial slaves.

Note2: For MODBUS RTU configuration to function properly d = 8 must be entered for the port command. (This configuration is in accordance with the MODBUS specification)

Note3: modbusadd will return “Invalid IP address (Sx)” followed by an “OK” if modbusadd is configured with parameters missing or incorrect parameters. Ensure that the modbussadd parameters match those from the above list.

Note4: All MODBUS serial slave devices connected to a serial bus configuration such as RS485 must use the same transmission mode. (This configuration is in accordance with the MODBUS specification)

modbusadd id n p d s m w

Adds a MODBUS Serial Slave (Previously in firmware version R1.2.0 and below)

id = 1 to 247 MODBUS ID
n = 1200 1200 Baud
n = 2400 2400 Baud
n = 4800 4800 Baud
n = 9600 9600 Baud
n = 19200 19200 Baud
n = 38400 38400 Baud
n = 57600 57600 Baud
n = 115200 115200 Baud
p = n or N no parity
p = e or E even parity
p = o or O odd parity
d = 7 or 8 data bits
s = 1 or 2 stop bits
m = a or A ASCII transmission mode
m = r or R RTU transmission mode
w = f or F flow control, leave empty for no flow control

Note1: For MODBUS RTU configuration to function properly d = 8 must be entered. (This configuration is in accordance with the MODBUS specification)

Note2: modbusadd will return ERROR if modbusadd is configured with parameters missing or incorrect parameters. Ensure that the modbusadd parameters match those from the above list.

Note3: If the baud rate of the serial port is changed from the serial console using the modbusadd command, and the baud rate of the host application is changed to match the new configuration after implementing this command, then the serial console should still be able to accept commands. This functionality is only available if the connection mode of the modem is mode = 1 or mode = 2 before issuing modbusadd. After changing the serial port configuration, a cmd save and a power cycle is highly recommended.

modbusadd backward compatibility
Starting in firmware version R1.2.1, the newer form modbusadd id Serial m used with the port command is the preferred way for adding new serial slaves.

Starting in firmware version R1.2.1, the form modbusadd id n p d s m w is provided for backward compatibility only. This form uses the n p d s w parameters with port to set the serial port settings and the id m parameters with modbusadd id Serial m. The form modbusadd id n p d s m w is only used for setting and will not be queried back in the same form. The changes that come into effect by using this form can be queried by using the modbusadd and the port commands; using modbusadd without parameters will always display commands in the form modbusadd id Serial m.

Example:

When the modem is upgraded to firmware version R1.2.1 and has been previously set to cmd mode 6, modem configurations containing the form modbusadd id n p d s m w will automatically be converted upon power cycle to modbusadd id Serial m and port n d p s f (where f = 2 if w = f or F, and f = 0 in all other cases).

After upgrading to firmware version R1.2.1, to convert from modbusadd id n p d s m w to modbusadd id Serial m when another mode has been previously configured, enter cmd mode 6, cmd save, and power cycle. To restore the modem to its previous mode, enter cmd mode n (where n is the previous mode), cmd save, and power cycle.

modbusadd id

Adds MODBUS self slave - only one is permitted.
id = 1 to 247 MODBUS ID

Examples:

1. add TCP slave with ID 1 and IP 192.168.100.122

2. add itself as a MODBUS slave with ID = 3

3. Add serial slave with baud 115200, no parity, 8 data bits, 1 stop bit and as ASCII transmission mode

4. Display the list of modbus devices.
TCP slave device with ID = 247, self slave device with ID = 10, serial slave device (ASCII transmission mode) with ID = 155
A cmd save is required for this command to take effect.

modbusctm130 n

Enables MODBUS backward compatibility with the CTM-13X by using MODBUS RTU encapsulated in UDP packets for messages transmitted/received over-the-air.
CTM-13X Modems only use MODBUS RTU over UDP as the over-the-air protocol for communicating between other modems configured as MODBUS master and slave gateways.

n = 0 use MODBUS TCP for over-the-air communications (default)
n = 1 use MODBUS RTU over UDP for over-the-air communications

A cmd save, and a power cycle are required before the modem is configured to use the specified MODBUS over-the-air protocol.

Examples:

cmd modbusctm130 1 Set MODBUS gateway to send/receive MODBUS RTU over UDP messages

cmd modbusctm130 Query the currently configured MODBUS over-the-air protocol

A cmd save is required for this command to take effect.

modbusdel n

Deletes an entry or all entries from the MODBUS list.

n = 0 deletes all MODBUS entries
n = 1 to 247 MODBUS ID entry

Examples:
cmd modbusdel 1 delete the entry with MODBUS ID 1
cmd modbusdel 0 delete all entries in the MODBUS list

A cmd save is required for this command to take effect.

modbusgw

Use this to initiate the MODBUS gateway manually from the serial port console. In firmware version R1.3.0 and above, "cmd freeconsole" must be run first before using this command from the SSH/Telnet console.
Use cmd mode 6 to put the modem in permanent MODBUS mode (enter MODBUS automatically after a power cycle).

Example:
1. Initiate the MODBUS gateway manually

---

See also: freeconsole, modbusadd, modbusctm130, modbusdel, modbusidmap, modbusmode, modbusport

modbusidmap n a.a.a.a p

This command is only configured when using the modem as a MASTER GATEWAY (cmd modbusmode 1 or cmd modbusmode 2). This command returns ERROR if the modem is configured as a SLAVE GATEWAY (cmd modbusmode 0).

This command sets up the MODBUS ID to modem IP for each remote MODBUS slave device (i.e. another CTM-15X Modem configured as a MODBUS slave gateway).
The default for all entries is n 0.0.0.0. Use n 0.0.0.0 0 to erase an entry. Use 0 0.0.0.0 to erase all entries. One entry is added at a time with a limit of up to 247 entries (each entry requires a unique ID).
To change an entry, one must first erase it then enter the changed IP address and port number.

n = 1 to 247 MODBUS ID, in decimal
a.a.a.a = 0.0.0.0 to 255.255.255.255 MODBUS slave modem IP address, in decimal(wireless modem IP address)
p = 0 to 65535 Port that the slave modem will be listening on, in decimal

Examples:

1. Set the MODBUS master gateway to forward messages designated for the slave device with ID 1 to the modem at 123.1.2.3, port 502
2. Clear the MODBUS ID to modem IP entry for slave ID 1
3. Change slave ID 1 entry to the modem with an IP of 123.1.2.4
4. Clear all MODBUS ID to modem IP entries
5. Query all MODBUS ID to modem IP entries
A cmd save is required for this command to take effect.

---

See also: modbusctm130, modbusmode

modbusmode n

Sets the specified MODBUS gateway mode of the modem, specifically, the transmission mode between the modem configured as the serial master gateway and the MODBUS serial device connected to the modem.

n = 0 slave gateway (default)
n = 1 RTU master gateway
n = 2 ASCII master gateway

A cmd mode 6, cmd save, and a power cycle are required before the modem is fully configured in a MODBUS mode.

Examples:

1. Set modem to be a MODBUS serial RTU master gateway

2. Query the currently configured MODBUS gateway mode

A cmd save is required for this command to take effect.

---

See also: mode

modbusport xxxxx

Sets the listening port number for the MODBUS server and the listening port number for MODBUS TCP slaves.
Default is 502.

xxxxx = 1 to 65535 MODBUS server port number

The current MODBUS port number can be queried by entering the modbusport command without parameters.

Note: If the modem is currently in MODBUS mode and any other LAN or firewall configuration commands are set after issuing the modbusport command, then both a cmd save and a power cycle are required to resume proper MODBUS operation.

Examples:

1.Set the MODBUS port to 12345

2. Query the existing MODBUS port

A cmd save and power cycle are required for this command to take effect.

---

See also: modbusadd, modbusdel, modbusctm130, modbusidmap, modbusmode, mode

mode n

Sets the required connection mode of the modem.

n = 1 manual connection
n = 2 auto connect to the network (default)
n = 3 auto connect to the network and go directly into PPP mode (only supported on firmware version R1.2.x and earlier)
n = 4 auto connect to both the network and the PAD host interface
n = 5 auto connect to the network and serial LCD (future)
n = 6 auto connect to both the network and the MODBUS host interface
n = 8 auto connect to both the network and the Elmscan diagnostic tool for OBD II
n = 9 auto connect to both the network and the magnetic swipe card reader
n = 10 auto connect to both the network and the WPAN Gateway
n = 12 auto connect to both the network and the Chlorobyte Salt Spreader interface
n = 13 configure the serial port for connection to an external GPS receiver, see gpsparam for details) (only supported on firmware version R1.3.0)
n = 20 configure the serial port for direct input of LoopBack WPAN PAD client(device type 10) (only supported on firmware version R1.3.0)

For all mode settings except n = 1 or 2, a cmd save and a power cycle are required before the mode takes effect.

To escape out of the mode (to get a command prompt – console) do the following:

mode = 3 – type EXIT, type cmd port nnnn (where nnnn is the current baud rate)

mode = 4 – type +++, wait 3 seconds, type cmd port nnnn (where nnnn is the current baud rate); Refer to padesc and padesct for escape sequence

mode = 8 – change hyper terminal baud rate to 9600, type EXIT, change hyper terminal baud rate to nnnn, type cmd port nnnn (where nnnn is the currently set baud rate)

The current mode setting can be queried by using the mode without parameters.

Examples:
1. Set the mode to auto connect
2. Query the current connection mode of the modem

A cmd save is required for this command to take effect.

modemdevice [ /dev/ttyUSBn ]

Configure the modem serial port device. Default is /dev/ttyUSB0.

This command requires a cmd save and modem power cycle to take effect.

Example:

modemid <string>

Assigns a user configurable ID to the modem.
If no ID is given then the modem’s 11-digit decimal ESN (if available) will be used.
If less than 11 characters is entered, trailing 0’s will be automatically inserted in message type 112.

Examples:
cmd modemid CAR1234 sets the modem ID to <CAR1234>
cmd modemid returns the currently configured modem ID

A cmd save is required for this command to take effect.

modemmode n

Configures the modem for "half bridge mode"

This command is used to provide the connected device, such as a laptop the same IP address that is assigned to the modem.
This command is useful for application software that requires a specific IP address to operate properly.

n = 0 modem mode off (default)
n = 1 modem mode on

The current modem mode can be queried by entering modemmode without parameters.

For modemmode to take effect, a cmd save and a power cycle is required.

Notes (all versions):

• In modem mode, remote web interface, remote ssh/telnet on the modem are not available.
  
• This feature should not be used with other modem features.

Notes (applicable to OpenCTM firmware only):

• For a static IP configuration, the client computer's Ethernet settings must be configured to use the WAN IP address, Gateway IP address, and DNS addresses of the phone card/module. If the modem has an active wireless connection, obtain these addresses from output displayed by using cmd syslog.
• For a dynamic IP configuration, the modem must also be configured using modemmodedhcp and clientmac commands in addition to using cmd modemmode.
• For modems configured in half bridge mode and using later model Sierra Wireless data devices that support A-GPS (USB598, USB597), A-GPS support is not available and must be disabled. Refer to agpspde for details on disabling the A-GPS feature.

Notes (applicable to Snapgear firmware only):

• This feature also requires a phone card/module that is configured to acquire a static IP address from the wireless carrier.
• modemmode does not support WAN IP addresses that have either a xxx.xxx.xxx.0 or xxx.xxx.xxx.255 as part of their IP address
• On the connected device, a DHCP release, a DHCP renew, and a power cycle may need to be performed for it to acquire the modem's IP address.

Examples:
cmd modemmode 1 enable modem mode
cmd modemmode queries the current modem mode setting

---

See also: agpspde, clientmac, modemmodedhcp

modemmodedhcp n

Configures the modem to use DHCP when configured for "half bridge mode"
DHCP with modem mode should only be enabled when the modem does not have a static IP address from the wireless carrier.

n = 0 modem mode will not use DHCP (default)
n = 1 modem mode will use DHCP

The current modem mode DHCP setting can be queried by entering modemmodedhcp without parameters.

For modemmodedhcp to take effect, a cmd save and a power cycle is required.

Note:

• If modemmodedhcp is enabled, the client computer mac address must also be configured using cmd clientmac
• The client computer must be configured with the following Ethernet settings:
  • DHCP to obtain an IP address automatically
  • Manually specified DNS server addresses. If the modem has an active wireless connection, obtain these addresses from output displayed by using cmd syslog

Examples:
cmd modemmodedhcp 1 use DHCP with modem mode
cmd modemmodedhcp queries the current modem mode DHCP setting

---

See also: clientmac, modemmode

netwd t n

Sets the network watchdog feature.
This feature is used to listen for incoming data traffic to make sure there is network connectivity.
If no data is received within the watchdog timer time out period (t * n), the modem will disconnect from the network and reconnect to the network. If the watchdog timer expires a second time after attempting to reconnect unsuccessfully the first time (no data received), the modem will be power cycled.

The user will define the time interval (t) the command will use to monitor network activity. The user will also define the number of times the command needs to see consecutive data packets (n) before the watchdog timer expires and the command resets the network connection/device. If data is received within this interval, the timer interval and number of times will be reset.

t = 0 disable (default)
t = 1 to 65535 time to wait for incoming data (seconds)
n = 0 to 65535 number of times the timer needs to expire before disconnecting and reconnecting to the network

A cmd save and power cycle is required before this setting takes effect.

Typically, netwd is used in conjunction with the ping command. The ping command will generate the network traffic that netwd will watch for.

Examples:

1. Set the timer to 10 seconds and check 6 times.

In the above example, the command will look for incoming traffic from the network at 10 seconds intervals. If no data traffic is detected for 6 consecutive intervals 6 x 10 = 60 sec. the command will disconnect and reconnect to the network. If a reconnect does not resolve the issue (approx 10 seconds reconnect time) the command will cycle the modem power completely (approx 50 seconds reconnect time) after an additional 6 intervals of no data.

If data is received, the command will not reset the network connection and the device will operate without interruption.

2. Query the current netwd configuration

---

See also: ping

networktime n

Set priority of cellular network time as an external system time synchronization source. This feature works with Sierra Wireless data devices/modules only.

n = 0 Disabled
n = 1-3 Priority relative to other external system time synchronization sources with 1 = highest (default: 2)

A cmd save and a power cycle are required for this command to take effect.

Example:
1. Set cellular network time as highest priority relative to other external time synchronization sources:

---

See also: gpstime, ntpserver, ntptime, timesync

nmeamode n

Sets the NMEA 0183 version that applies to the GPS message format for GPGLL and GPRMC sentences. NMEA 0183 v3.0 standard supports an additional field for the Mode Indicator.

n = 0 use NMEA 0183 v2.0 messages (default)
n = 1 use NMEA 0183 v3.0 messages

Examples:
1. Enable NMEA 0183 v3.0 message format
2. Query current NMEA 0183 version

ntpserver url

Set the network time protocol (NTP) server used by the modem's built-in NTP client for external system time synchronization. Requires a non-zero priority for ntptime and a modem to be configured in a mode other than manual connection mode (not in cmd mode 1).

url = URL/IP of the NTP server (default: 0.openwrt.pool.ntp.org)

A cmd save and a power cycle are required for this command to take effect.

Example:
1. Use an alternate NTP server:

---

See also: gpstime, mode, networktime, ntptime, timesync

ntptime n

Set priority of the built-in network time protocol (NTP) client as an external system time synchronization source. Requires a valid NTP server URL/IP to be configured using ntpserver and a modem to be configured in a mode other than manual connection mode (not in cmd mode 1).

n = 0 Disabled
n = 1-3 Priority relative to other external system time synchronization sources with 1 = highest (default: 3)

A cmd save and a power cycle are required for this command to take effect.

Example:
1. Set NTP time as highest priority relative to other external time synchronization sources:

---

See also: gpstime, mode, networktime, ntpserver, timesync

obdcond n b t mt [trig1 ... trig4]

Sets the condition(s) that will trigger an OBD report.
The conditional operator is used to indicate how all following parameters will be used to determine if a report is triggered.

n = 1 to 8 OBD trigger number
b = 0 conditional operator for all following parameters: Off
b = 1 conditional operator for all following parameters: AND
b = 2 conditional operator for all following parameters: OR
t = 0 timeout disabled
t = 1 to 65535 timeout in seconds
mt = 0 to 65535 maximum reporting rate in seconds (minimum time between reports)

Optional parameters:
trigx trigger parameter x enclosed in single quotes and without spaces in between, in the form 'pid^val' where:
pid = p1 to pb engine parameters as per OBD2/J1939 Parameters table except for p4 and id
^ - > trigger using greater than operator
^ - = trigger using equal to operator
^ - < trigger using less than operator
val engine parameter value that sets off the trigger, in decimal nnnn.nn (refer to OBD2/J1939 Parameters table for allowable range of values)

Each OBD trigger condition may be configured with up to 4 trigger parameters.

The current parameter(s) for a trigger condition can be queried by using the obdcond n command. If n is blank, all OBD trigger conditions will be queried.

Examples of OBD trigger parameters:
'p1>0' trigger is set off when p1 (vehicle speed) is greater than 0 km/h
'p2=5000' trigger is set off when p2 (engine RPM) is equal to 5000 RPM
'p8<200.75' trigger is set off when p8 (engine coolant temperature) is less than 200.75°C

Examples:

1. Set OBD trigger #1 to send a report every 60 seconds

2. Set OBD trigger #2 to send a report every 30 seconds AND P1 (vehicle speed) is equal to 0.0 km/h with a maximum report rate of one every 5 seconds

3. Set OBD trigger #3 to send a report every 60 seconds OR P1 (vehicle speed) is greater than 0 km/h OR P2 (engine RPM) is greater than 2000 with a maximum report rate of one every 5 seconds

4. Set OBD trigger #4 to send a report only when P1 (vehicle speed) is less than 10 km/h AND P2 (engine RPM) is equal to 0 RPM AND P7 (calculated engine load value) is equal to 0 percent AND P8 (engine coolant temperature) is -40°C with a maximum report rate of one every 15 seconds

5. Query all the trigger conditions used for OBD reports

6. Query the parameters for OBD trigger condition #3

A cmd save is required for this command to take effect.

---

See also: OBD2/J1939 Parameters, obdreport, pobda-pobdd

obddata

Displays the current OBD engine parameters and corresponding values obtained from the OBDII transmitter and the time since they were last updated.
If no engine parameters have been obtained yet, the command returns ERROR

This command is read-only.

Example:

cmd obddata displays OBD engine parameters and time since they were last updated

obdreport [n] [r]

This command sets the report to be used for a OBD triggered report.

n = 1 to 8 number of the OBD trigger condition
r = 1 to 999 report number
r = 0 disables the report

obdreport requires the modem to be listening for traffic from the WPAN gateway, this requires cmd mode 10 to be configured.

Example:

1. Set report #2 for OBD triggered report #1.

A cmd save is required for this command to take effect.

---

See also: mode, obdcond, repaddmes, repdelmes, repemail, replocport, repremip, repremport, repsms, reptype

obdsp n

Sets the protocol used by the OBDII transmitter.

n = 0 Automatic
n = 1 SAE J1850 PWM
n = 2 SAE J1850 VPW
n = 3 ISO 9141-2
n = 4 ISO 14230-4 KWP (slow)
n = 5 ISO 14230-4 KWP (fast)
n = 6 ISO 15765-4 CAN (11 bit ID, 500 Kbaud)
n = 7 ISO 15765-4 CAN (29 bit ID, 500 Kbaud)
n = 8 ISO 15765-4 CAN (11 bit ID, 250 Kbaud)
n = 9 ISO 15765-4 CAN (29 bit ID, 250 Kbaud)
n = 10 SAE J1939 CAN (29 bit ID, 250 Kbaud)
n = 11 USER1 CAN (11 bit ID, 125 Kbaud)
n = 12 USER2 CAN (11 bit ID, 50 Kbaud)

The current OBDII transmitter protocol can be queried by using the obdsp command without parameters.
Note that option 0 (Automatic) only replaces OBD2 protocol options 1-9. Some vehicles may exhibit problems with automatic protocol discovery. obdsp must specifically be set to match the protocol on those vehicles.

Examples:

1. Set the OBDII transmitter to use the J1939 protocol

2. Query the current OBDII transmitter protocol

A cmd save and a power cycle are required for this command to take effect.

odometer n

Sets/queries the GPS odometer.
The GPS odometer keeps track of the distance travelled in km by using GPS position data. If n is omitted, the current value of the GPS odometer will be queried.
The maximum odometer value is 1999999 km. The odometer will roll over to 0 km when the current odometer value exceeds the maximum.

The GPS odometer is reset to 0 km whenever one of these cases applies:
(i) n is specified as reset
(ii) n is specified as 0
(iii) cmd factory is issued.

Examples:

1. Reset the GPS odometer value to 0

2. Reset the GPS odometer value to 0
3. Set the GPS odometer to 100000 km
4. Query the current GPS odometer value in km

---

See also: ctm15x

otasp

This command is used to perform automatic wireless network activation and updates any required network related files that are embedded in the wireless modem.

The modem responds with one or more of the following messages:

• SPL Unlocked
• Authentication key has been exchanged
• Shared secrets data has been updated
• New NAM parameters have been downloaded
• New MDM has been downloaded
• IMSI has been downloaded
• PRL has been downloaded

During updating, if any of the above data is unsuccessful, an OTASP Timeout message will be displayed.
A progress message OTASP Processing will be displayed every 10 seconds.
When the OTASP process has been completed, the OTASP Disconnected message will be displayed.

Example:

1. Initiate automatic wireless network activation

pad

Initiates a packet data connection. Use this to initiate a manual PAD connection from the serial port console. In firmware version R1.3.0 and above, "cmd freeconsole" must be run first before using this command from the SSH/Telnet console.
Use cmd mode 4 to put the modem in permanent PAD mode (enter PAD automatically after a power cycle).

Example:

1. Initiate a manual PAD packet connection to the wireless network

---

See also: freeconsole, padecho, padesc, padesct, padfwdc, padfwdl, padfwdt, padip, padmode, padport, padreset, padsvct

padclientport xxxxx

Sets the default client PAD port number for use with dialup emulation via UDP mode (cmd padmode 6) or dialup emulation via TCP mode (cmd padmode 7). Default is 5006.
padclientport is valid for only cmd padmode 6 or cmd padmode 7 when the dial command ATDT is issued by an external serial device to initiate an outgoing connection.

xxxxx = 0 to 65535 dialup emulation PAD client port number

The current dialup emulation PAD client port number can be queried by entering the padclientport command without parameters.

Examples:

1.Set the dialup emulation PAD client port to 5006
2. Query the existing dialup emulation PAD client port

A cmd save is required for this command to take effect.

---

See also: pad, padecho, padesc, padesct, padfwdc, padfwdl, padfwdt, padip, padmode, padport, padreset, padsvct

padecho n

Sets the PAD echo mode – if echo is enabled then all data sent to the modem on its RS232 port by an external device is echoed back to that device.

n = 0 PAD echo mode: disabled
n = 1 PAD echo mode: enabled (default). The current PAD echo mode can be queried by using the padecho command without parameters.

Examples:

1. Disable the PAD echo – characters received on the modem’s RS232 port will not be echoed to the connected device

2. Query the current PAD echo setting

A cmd save is required for this command to take effect.

---

See also: pad, padesc, padesct, padfwdc, padfwdl, padfwdt, padip, padmode, padport, padreset, padsvct

padesc <str>

Sets the PAD escape sequence used to return to command line mode.
Default is +++.
When using the escape sequence it is necessary to wait the guard time (padesct) before entering data
Enter only the escape sequence (do not enter any other characters including <CR> or <LF>)
If PAD forwarding time (padfwdt) is set there will be a delay until the escape characters are forwarded.
The guard time (padesct) must also be honored, to allow the modem to escape from PAD mode.

<str> PAD escape sequence, 10 characters maximum, no spaces, case sensitive

The current PAD escape sequence can be queried by using the padesc command without parameters.

Examples:

1. Set the PAD escape sequence to ASCII string 12345

2. Query the current PAD escape string

A cmd save is required for this command to take effect.

---

See also: pad, padecho, padesct, padfwdc, padfwdl, padfwdt, padip, padmode,
padport, padreset, padsvct

padesct n

Sets the PAD escape guard time.
This is the idle time before and after the PAD escape sequence which must be present for the escape sequence to be recognized.

n = 0 to 65535 PAD escape guard time in seconds. Default is 3 seconds.

NOTE: values greater than 8 seconds shouldn't be used in TCP PAD client mode.

The current PAD escape guard time can be queried by using the padesct command without parameters.

Examples:

1. Set the PAD escape guard time to 4 seconds

2. Query the current PAD escape guard time

A cmd save is required for this command to take effect.

---

See also: pad, padecho, padesc, padfwdc, padfwdl, padfwdt, padip, padmode, padport, padreset, padsvct

padfwdc x r

Sets the PAD forwarding character and to remove the forwarding character before forwarding the packet (optional). Default forwarding character = 13 (ASCII <enter>), default forwarding character removal disabled.

x = 0 padfwdt or padfwdl will invoke sending the packet
x = 1 to 255 PAD forwarding character representing an ASCII character.
r = 0 Do not remove the forwarding character before forwarding the packet (default)
r = 1 Remove the forwarding character before forwarding the packet

If the r parameter is omitted, it is considered to be 0. The current PAD forwarding character can be queried by using the padfwdc command without parameters

Examples:

1. sets the PAD forwarding character to ASCII <space> and do not remove the forwarding character before forwarding the packet

2. sets the PAD forwarding character to ASCII <space> and remove the forwarding character before forwarding the packet

3. Query the current PAD forwarding character

A cmd save is required for this command to take effect.

---

See also: pad, padecho, padesc, padesct, padfwdl, padfwdt, padip, padmode, padpfc,
padport, padreset, padsvct

padfwdl x

Sets the maximum PAD packet length. Default = 40.
If 0 is specified then every character is sent immediately.

x = 0 sent every characters immediately
x = 1 to 1000 maximum PAD packet length

The current PAD packet length can be queried by using the padfwdl command without parameters.

Examples:

1. Configure the received RS232 data to be sent in packets of 10 characters each
2. Query the current PAD forwarding length setting

A cmd save is required for this command to take effect.

---

See also:pad, padecho, padesc, padesct, padfwdc, padfwdl, padfwdt, padip, padmode,
padport, padreset, padsvct

padfwdt x

Sets the PAD forwarding time. Default = 1 second.
If 0 is specified then this disables the forwarding timer and every character will be sent immediately.

x = 0 to 255 PAD forwarding time in increments of 50ms

The current PAD forwarding time can be queried by using the padfwdt command without parameters.

Examples:

1. Set the PAD forwarding time to 2 seconds
2. Query the current PAD forwarding time

A cmd save is required for this command to take effect.

---

See also: pad, padecho, padesc, padesct, padfwdc, padfwdl, padip, padmode, padport, padreset, padsvct

padip iii.iii.iii.iii

Sets the remote PAD IP address.

iii.iii.iii.iii = 0.0.0.0 to 255.255.255.255 remote IP address

Use 0.0.0.0 to set the modem in PAD server mode. Default is 0.0.0.0

The current remote PAD IP address can be queried by using the padip command without parameters.

Examples:

1. Set the PAD IP address to 192.168.1.1

2. Query the current PAD IP address

A cmd save is required for this command to take effect.

---

See also: pad, padecho, padesc, padesct, padfwdc, padfwdl, padfwdt, padmode, padport, padreset, padsvct

Sets the PAD mode.

x = 0 start up UDP PAD mode. The modem will revert to server mode once the connection is closed. (default)
x = 1 start up TCP PAD mode. The modem will revert to server mode once the connection is closed.
x = 2 start up UDP PAD client mode - one session. The modem will revert to command mode once the connection is closed.
x = 3 start up TCP PAD client mode - one session. The modem will revert to command mode once the connection is closed.
x = 4 start up persistent UDP PAD client mode
x = 5 start up persistent TCP PAD client mode
x = 6 start up Dialup Emulation over UDP mode
x = 7 start up Dialup Emulation over TCP mode

The current PAD mode can be queried by entering the padmode command without parameters. The connection is closed if one of the following occurs:

• padsvct idle timeout expires
• padsvct maximum session timeout expires
• cmd padreset is executed
• The connection is closed by remote host (TCP PAD only)

If padip is set to 0.0.0.0, PAD will start in server mode. Otherwise it will start in client mode. Note that for the client modes (2, 3, 4 and 5), padip must be different than 0.0.0.0. Note that for dialup emulation modes (6 and 7), padclientport must be set.

Examples:

1. Set to TCP PAD mode

2. Query the current PAD mode

A cmd save is required for this command to take effect.

---

See also: pad, padclientport, padecho, padesc, padesct, padfwdc, padfwdl, padfwdt, padip, padport, padreset, padsvct

padpfc x

Sets the PAD postfix character that is added at the end of each packet. Default = none (disabled)

x = none Disabled. No character is added to the end of a PAD packet.
x = 1 to 255 PAD forwarding character representing an ASCII character.

The current PAD forwarding character can be queried by using the padpfc command without parameters

Examples:

1. Set the PAD postfix character to ASCII <LF>

2. Query the current PAD postfix character

A cmd save is required for this command to take effect.

---

See also: pad, padecho, padesc, padesct, padfwdc, padfwdl, padfwdt, padip,
padmode, padport, padreset, padsvct

padport xxxxx

Sets the remote PAD port number.
This is the listening port if the modem is in PAD server mode. Default is 5005.

xxxxx = 0 to 65535 remote PAD port number

The current PAD port number can be queried by entering the padport command without parameters.

Note: If the modem is currently in PAD mode and any other LAN or firewall configuration commands are set after issuing the padport command, then both a cmd save and a power cycle are required to resume proper PAD operation."

Examples:

1.Set the PAD port to 5005
2. Query the existing PAD port

A cmd save is required for this command to take effect.

---

See also: pad, padecho, padesc, padesct, padfwdc, padfwdl, padfwdt, padip, padmode, padreset, padsvct

padreset

Resets the PAD connection.
The actions taken by padreset are to drop the PAD connection and to return the modem to server mode.
These actions are equivalent to those that occur when the padsvct timer expires.

Examples:

1. Reset the PAD port

---

See also: pad, padecho, padesc, padesct, padfwdc, padfwdl, padfwdt, padip, padmode, padport, padreset, padsvct

padsvct n [c]

Sets the PAD server connection timeout.
If no data is sent or received within this timeout value, the PAD connection will be dropped and the modem will return to server mode.
If the optional parameter for the maximum PAD connection timer is specified, once the timer expires, the current PAD connection will be dropped regardless of the data connection condition.
The modem will revert to the current PAD mode setting and maintain the PAD session.

n = 0 PAD server connection timeout: disabled
n = 1 to 65535 PAD server connection timeout in seconds. Default is 15 seconds

Optional Parameter:

c = 0 Maximum PAD connection time: disabled (default)
c = 1 to 65535 Maximum PAD connection time in seconds.

The current PAD server connection timeout setting can be queried by entering padsvct command without parameters

Examples:

1. Configure the modem to revert to server mode after 10 seconds of data inactivity

2. Configure the PAD connection to be dropped after 60 seconds

3. Query the current padsvct settings

A cmd save is required for this command to take effect.

---

See also: pad, padecho, padesc, padesct, padfwdc, padfwdl, padfwdt, padip, padmode, padport, padreset, padsvct

panicreport [r1] [r2] [r3] [r4] [r5] [r6] [r7] [r8]

This command will set the report(s) to be used for pendant triggered panic reports (PANIC and MPANIC only)

Up to 8 reports can be assigned to the panicreport.

r = 0 disables the report
r = 1 to 999 report number

panicreport requires the modem to be listening for traffic from the WPAN gateway, this requires cmd mode 10 to be configured.

The modem must be configured using the commands wpanadddev and wpanacktype and wpanpanid for panicreport to function properly.

Note: panicreport does not support server ACK mode and report type 8 and 9

Example: use report 1 for pendant panic triggered reports

A cmd save is required for this command to take effect.

---

A Pendant panic report is triggered by a panic message received from the pendant. The following message is appended to the report:
$PPEN,ID,SEQ,MES*CHKSUM
ID - 64 bit unique hex ID of Pendant
SEQ - Packet sequence number
MES - Pendant panic message payload (PANIC or MPANIC)
CHKSUM - NMEA message checksum

Examples:
$PPEN,0013A200402CB498,17,PANIC*07
$PPEN,0013A2004000DBA9,16,MPANIC*33

---

See also: mode, repaddmes, repdelmes, repemail, replocport, repremip, repremport, repsms, reptype

panicreportack t

This command will set the modem to wait for a Pendant panic triggered report (PANIC or MPANIC message only) and send the corresponding acknowledgment message.

t = 0 disables panicreportack (default)
t = 1 to 65535 time period, in seconds, to wait for the next PANIC or MPANIC message from a pendant and send it an ACK

For panicreportack to function properly, the modem must be configured with wpanacktype set to server type acknowledgment and with panicreport. When panicreportack is set, panicreport will be disabled to stop triggering the script. This command is meant to be used with custom report triggered scripts via reportscripts and is always volatile.

When panicreportack is entered without parameters, the command returns the configured time period and the elapsed time, in seconds, since panicreportack was set.

Examples: 1. Wait for 60 seconds for a PANIC or MPANIC message and send a pendant an ACK if received
2. Query the time period set for waiting for a PANIC or MPANIC message to ACK, and the current time elapsed since panicreportack was set

---

See also: mode, panicreport, reportscripts, wpanacktype

pendantreport [r1] [r2] [r3] [r4] [r5] [r6] [r7] [r8]

This command sets the report(s) to be used for pendant triggered reports.

Up to 8 reports can be assigned to the pendantreport.

r = 0 disables the report
r = 1 to 999 report number

pendantreport requires the modem to be listening for traffic from the WPAN gateway, this requires cmd mode 10 to be configured.

The modem must be configured using the commands wpanadddev and wpanacktype and wpanpanid for pendantreport to function properly.

Example: use report 1 for pendant triggered reports

A cmd save is required for this command to take effect.

---

Pendant report is triggered by any message received from the pendant. The following message is appended to the report:

$PPEN,ID,SEQ,MES*CHKSUM
ID - 64 bit unique hex ID of Pendant
SEQ - Packet sequence number
MES - Pendant message payload
CHKSUM - NMEA message checksum

Example:
$PPEN,0013A200402CB498,17,PANIC*07

---

See also: mode, repaddmes, repdelmes, repemail, replocport, repremip, repremport, repsms, reptype

ping n [iii.iii.iii.iii or <website name>]

Configures the modem to ping a specific IP address or website periodically.
This feature is similar to ppp keep alive.

n = 0 disables ping
n = 1 to 65535 number of seconds between pings

iii.iii.iii.iii IP address of the site to ping, IP Address must be in the range 0 to 255 for each value of iii, If values outside this range are entered, it will be interpreted as a URL

<website name> website to ping

The current ping setting can be queried by using the ping command without parameters.

Examples:

1. ping www.google.ca every 10 seconds

2. ping 66.102.7.147 every 15 seconds

3. Disable ping

4. Queries the modem’s ping setting

---

See also: netwd

pobdx n1 [n2] [n3] [n4]

Configures the engine - vehicle diagnostic report messages.

Maximum of 4 report messages.
Maximum of 4 parameters can be configured for each report message.

x = a, b, c, d

n1 (n2, n3, n4 are optional parameters) = engine parameters as per OBD2/J1939 Parameters table

Examples:

cmd pobda p1 reports vehicle speed

cmd pobdb p2 p12 p25 reports engine speed, intake air temperature and total engine hours

cmd pobdc pa pb reports calculated peak acceleration and calculated peak deacceleration

cmd pobdd p20 reports distance travelled since diagnostic trouble codes cleared

A cmd save is required for this command to take effect.

port n d p s f

Configures the modem’s serial port baud rate and data format.
After implementing this command it will be necessary to change the baud rate of the host application to match the new configuration.

n = 1200 1200 Baud
n = 2400 2400 Baud
n = 4800 4800 Baud
n = 9600 9600 Baud
n = 19200 19200 Baud
n = 38400 38400 Baud
n = 57600 57600 Baud
n = 115200 115200 Baud (default)

d = 5,6,7 or 8 number of data bits (d=8, default)

p = n or N no parity (default)
p = e or E even parity
p = o or O odd parity

s = 1 or 2 number of stop bits (s=1, default)

f = 0 no flow control (default)
f = 1 software flow control
f = 2 hardware flow control

The current port setting can be queried by entering the port command without parameters.

Examples:
cmd port 115200 8 n 1 2 baud rate=115200bps, 8 data bits, no parity, 1 stop bit and hardware flow control

cmd port returns the current port value

Note 1: For MODBUS Serial Master Gateway there are 2 options only for the data bit configuration:

• 7 and 8 for ASCII Mode.
• 8 for RTU-over-UDP Mode.

Note 2: If the baud rate of the serial port is changed from the serial console using the port command, and the baud rate of the host application is changed to match the new configuration after implementing this command, then the serial console should still be able to accept commands. This functionality is only available if the connection mode of the modem is mode = 1 or mode = 2 before issuing port.

A cmd save and a powercycle is required for this command to take effect.

ppp

Provide the connected device a PPP connection through the serial port.
After the modem is powered up, enter the cmd ppp command and disconnect from the terminal program.
Use a Windows Dial Up Network (DUN) connection to connect to the modem. Use #777 as the dial string/phone number for the serial PPP connection.
To escape from this mode and return to the command line, type EXIT in the terminal program.

Use cmd mode 3 to put the modem into permanent PPP mode.

When the modem is configured for PPP mode, the IP addresses used in the serial PPP connection will use the same subnet as the modem's Ethernet LAN IP, after configuring using cmd lanip, cmd apply, cmd save, and a power cycle. For example, if the modem was configured with a LAN IP of 192.168.6.1, the serial PPP connection will use 192.168.6.200 and 192.168.6.202 as the IP addresses for the serial PPP client and the modem, respectively.

When using cmd mode 3 or cmd ppp, the modem's DHCP server IP pool, configured using landhcp, must not include the range x.x.x.200 - x.x.x.202.

Example:

1. Start the modem into PPP mode

---

See also: landhcp, lanip, mode

pswd n

Sets the password used for wireless network access via simple IP. This is often set to the electronic serial number (ESN) of the modem.

n a maximum of 40-character alpha-numeric username

A save operation is required.

Examples:
cmd pswd 12345678900 sets the password to 12345678900
cmd pswd displays the current password used for wireless network access via simple IP

A cmd apply followed by a cmd save are required for this command to take effect.

---

See also: mip, user

pupcond n a

Sets the condition(s) that would trigger a power up report.

The conditional parameter is used to indicate how all following parameters will be used to determine if a report is triggered.

n = 1 to 8 power up condition numbers
a = 0 power up trigger disabled
a = 1 power up trigger enabled

The current power up reporting condition(s) can be queried by entering the pupcond n where n is the condition number.
If n is blank, all power up condition triggers will be queried.

Examples:

cmd pupcond 1 1 enables powerup condition 1
cmd pupcond 2 0 disables powerup condition 2
cmd pupcond queries the conditions to trigger all power up reports

A cmd save is required for this command to take effect.

---

See also: pupreport

pupreport [n] [r]

This command sets the report to be used for power-up triggered reports.
Up to 8 ignition trigger reports can be configured.

n = 1 to 8 power-up trigger condition
r = 1 to 999 report number
r = 0 disables the report

Example:

1. Configure report #2 for power-up trigger condition #1.

A cmd save is required for this command to take effect.

---

See also: pupcond, repaddmes, repdelmes, repemail, replocport, repremip, repremport, repsms, reptype

pwrmode n

Controls the modem’s power mode.

n = 1 puts the modem in shutdown mode - it can be woken up either by a power cycle, an input alarm event if configured, or a configured periodic wakeup, see pwrwoe.

n = 2 will power cycle the modem immediately

This command is immediate and does not require a save operation.

Example:
cmd pwrmode 2 this command will power cycle the modem

pwrsdwn a ddddd

Places the modem into shutdown mode (blinking power LED) based on the state of the modem's standby signal (ignition).
The ignition state is controlled by the "white" wire of the 3 wire power connection to the modem.
To disable any ignition sense capability connect the "white" wire to the + Voltage "Red" wire.
Default is pwrsdwn 1 10 (modem will switch off based on the standby (ignition) signal state changing with a 10 second delay before entering shutdown mode).

a = 0 disables the standby signal (ignition) event qualifier
a = 1 enables the standby signal (ignition) event qualifier (default)
ddddd = 10 to 65535 the delay time in seconds after the standby signal event changing state that the modem will go into power shutdown mode.

The current configuration can be queried by using the pwrsdwn without parameters.

Examples:

cmd pwrsdwn 1 3600 this will cause the modem to power down when the standby signal (ignition) has been inactive for 1 hour. The modem will power back up when the standby signal becomes active with no delay.

cmd pwrsdwn returns the current settings of enable/disable and delay time

A cmd save is required for this command to take effect.

pwrvcct vv.v t

Controls the supply voltage below which the modem will automatically go into shutdown mode (blinking power LED). This command is useful for battery powered applications where the modem can be put into a very low power consumption mode (shutdown mode) to prevent draining the battery.

vv.v = 9.0 to 25.5 The threshold supply voltage at which the modem will go into shutdown (default = 9.0V, typical for 12V battery operation)
t = 10 to 255 the time in seconds after which the modem will go into shutdown once the supply voltage has gone below the threshold voltage. (default = 10)
Note that this timeout applies for powering the modem back up as well.

The current setting can be queried by entering the pwrvcct command without parameters.

Examples:

1. Set the threshold to 20.0 volts with 10 seconds delay – this may be appropriate for a 24 volt battery

2. Query the current voltage and time settings

A cmd save is required for this command to take effect.

pwrwoe m t1 t2 i

Configures what event will wake the modem up (input alarm event or timer expire) and how long the modem will stay awake after the event.
This is used to have the modem in minimum power mode(< 2 mA) until it is required to communicate over the wireless network.

If it is required to have the modem start its shutdown mode immediately (without waiting for timer t1 to expire) than use the pwrmode command to put the modem into shutdown with immediate effect.

If the standby signal in the pwrsdwn command is enabled or on then this will cause the modem to be on whenever the standby signal is on. The modem will only use the pwrwoe parameters when the standby signal is off (and after the delay timer has expired). If the standby signal is disabled then the pwrwoe parameters will be in effect all the time.

This command can also be used to configure scheduled power cycles without having to put the modem into shutdown.
m = 0 disables the power wake on event operation
m = 1 shutdown
m = 2 shutdown with periodic wakeup when ignition is off

t1 = 0 disables the ON timer (stay on forever – pwrsdwn can be enabled to shutdown the modem)
t1 = 1 to 65535 the ON time in minutes – the modem will remain on for this time once it has woken up due to an input alarm event, or periodic wakeup (set by parameter t2)

t2 = 0 disables the OFF timer (stay in shutdown mode forever or until an input alarm event occurs –or standby signal if enabled in pwrsdwn).
t2 = 1 to 255 the OFF time in minutes - the time that the modem will stay in shutdown if an input alarm event (or standby signal if enabled in pwrsdwn) does not occur
t2 = c power cycle the modem immediately once the ON timer expires (only use with m = 1 and i = 0)

i = 0 disables the input event trigger
i = 1 to 6 selects which input going into alarm will trigger wake up

Default configuration is 0 0 10 0 (wake on event disabled). The current configuration can be queried by using the pwrwoe without parameters.

Examples:

1. Configure the modem to go into shutdown mode in 5 minutes. An alarm event on input #2 – and only this - will cause it to wake up for 5 minutes then go back into shutdown.
2. Configure the modem to go into shutdown mode in 5 minutes. Every 55 minutes it will wake up and remain on for 5 minutes then go back into shutdown.
3. Configure the modem to power cycle after 60 minutes.
4. Query the current configured parameters for wake on event
A cmd save is required for this command to take effect.

ratesel n

Sets the required network rate mode (CDMA vs. EV-DO) of the device. This command is not valid for GSM/GPRS/HSPA devices.

Note:

• Prior to using the cmd ratesel command, use cmd mode to verify that the modem is in manual connection mode=1. Otherwise, use cmd mode 1 to put the modem in manual connection mode. The ratesel command talks directly to the embedded card/module and does not require cmd save for the setting to be saved.
• Entering cmd ratesel without parameters before setting the command to 0 or 1 will return an “ERROR”, this is normal operation.
• ratesel is valid for Sierra Wireless CDMA/EV-DO data devices and modules only
• The Sierra Wireless AC580 (EV-DO revision 0, Cardbus device) only supports ratesel n = 2

n = 0 1xRTT only
n = 1 EV-DO only
n = 2 Auto Rate Select (hybrid mode) - default

The network rate mode can be queried by entering ratesel without parameters.

Examples:

1. Set the network rate mode to 1xRTT only

2. Query the current network rate mode of the device

ratetmr n

Sets the required network rate test timer of the device. This is used to configure the modem to test for an available EV-DO network while it is in a 1xRTT connection.
This command is valid for Sierra Wireless CDMA/EV-DO data devices and modules only.

n = 0 disable the timer (default)
n = 1 to 65535 time in seconds. Note that time in second is an approximate value; the time between periods will be greater than the “n” value set

The current timer setting can be queried by entering the ratetmr without parameters.

Examples:

1. During a 1xRTT connection the modem will disconnect approx every 120 seconds and then reconnect on the EV-DO network if available, otherwise it will reconnect on the 1xRTT network.

2. Query the current network rate test timer setting

A cmd save is required for this command to take effect.

repaddmes n x [x2][x3][x4]

Adds a message type to a report. 4 messages can be included in a single report. Duplicate messages cannot be included in a report.
Messages will be sent in a report in the same order that they are added.
ULCP header messages will be sent as individual UDP packets – NMEA format messages will be combined into a single UDP packet.

n = 1 to 999 report number
x message type to be added, valid message types must be used - see Report Messages

The messages associated with a single report can be displayed by using the repaddmes n command. If n is omitted, the messages associated with all configured reports will be displayed.

Examples:

1. Add message type #16 – GPS NMEA GLL – to report #4

2. Query messages associated with report #4

3. Query messages associated with all configured reports

A cmd save is required for this command to take effect.

---

See also: message formats, repdelmes, repemail, replocport, repremip, repremport, repsms, reptype

repdelmes n x

This command is used to delete a message type (or all messages) from a report.

n = 1 to 999 report number
x message type to be deleted (0 to delete all messages)

Examples:

1. Delete message type #16 from report #1

2. Delete all messages from report #4

A cmd save is required for this command to take effect.

---

See also: repaddmes repemail replocport repremip repremport repsms reptype

repemail n <email address>

Sets the email address that the report will be sent to (if configured for email using reptype).
The default email address is blank.

Note that an email server is required – see emailsrv.

n = 1 to 999 report number
<email address> = name@domain email address to which the report will be sent

The current email address configured for all reports can be queried by using the repemail command without parameters.

Examples:

1. Set the send to email address for report #1

2. Query the email address for report #1

3. Query the email address for all reports

A cmd save is required for this command to take effect.

---

See also: repaddmes repdelmes replocport repremip repremport repsms reptype

repfiledelivery n t rt username server-path port

Where
n - report number (1-999)
t - file upload time period [s] (0-65535) 0=disable upload
rt - file upload retry period if uploads fail (0-65535) 0=disable retries
username - ssh username
server-path - ssh server host:path definition
port - ssh server TCP/IP port number, usually 22

Firmware version R1.3.0 only: To complete file-based reporting configuration, do a cmd save and power cycle the modem.

Example:

1. Set file delivery for report 1

A cmd save and power cycle is required for this command to take effect.

---

See also: repfilename, sshkey

repfilename n name

Sets the file prefix used for a file-based report.

n = 1 to 999 report number
name file prefix to be used

File reports are named using a concatenation of this prefix, the report number, the modem mac address, and a timestamp (UNIX format). eg. diginput-1-0010A1772797-1267216159

Firmware version R1.3.0 only: To complete file-based reporting configuration, power cycle the modem.

Example:

1. Set file name for report 1 to diginput.

A cmd save and power cycle is required for this command to take effect.

---

See also: repfiledelivery

repfilezip c

Enables or disables the ability to compress data files generated by the file-based reporting system using different formats. Data files will be output in a required format with file names ending with the proper file extension.

Where
c = 0 compression of data files = disabled (default)
c = 1 compression of data files = enabled GZIP format (.gz)
c = 2 compression of data files = enabled ZIP format (.zip)

The current status of compression of data files generated by the file-based reporting system can be queried by using the repfilezip command without parameters.

Firmware version R1.3.0 only: To complete file-based reporting configuration, do a cmd save and power cycle the modem.

Example:

1. Enable compression of file-based reporting data files using GZIP format.
2. Query the current state of compression of file-based reporting data files.

A cmd save and power cycle is required for this command to take effect.

---

See also: repfiledelivery, repfilename, sshkey

http://en.wikipedia.org/wiki/Gzip

replocport n xxxxx

Sets the port number of the local server that the report will be sent to.
Up to 999 reports may be configured.

n = 1 to 999 report number
xxxxx = 0 to 65535 local port number in decimal

The current local port configuration for a report can be queried by entering replocport n, where n is the port number.
If n is omitted, all reports will be queried.

Examples:

1. Report #1 will be sent to local port 5005

2. Query the local port setting of all reports

A cmd save is required for this command to take effect.

---

See also: repaddmes repdelmes repemail repremip repremport repsms reptype

reportscripts n

This command enables custom scripts to be triggered when reports are generated

n = 0 disable custom report triggered scripts (default)
n = 1 enable custom report triggered scripts

A cmd save and a power cycle are required for this command to take effect.

Custom scripts should be located in the directory /etc/reports/scripts, and must be named "reportN.sh" where N is

N = 1 to 999 for general reports 1 to 999
N = 1020 to 1027 GPS reports 1 to 8
N = 1040 to 1047 I/O reports 1 to 8

Custom scripts must be copied over to the modem via local scp.

Examples:

1. Enable custom report triggered scripts
2. Query the current configuration

repremip n iii.iii.iii.iii

Sets the IP address of the remote server that the report will be sent to. Up to 999 reports may be configured.

n = 1 to 999 report number
iii.iii.iii.iii = 0.0.0.0 to 255.255.255.255 remote IP address in decimal

The current IP address for a report can be queried by using the repremip n where n is the report number.
If n is omitted, all reports will be queried.

Examples:

1. Report #1 will be sent to remote IP address 123.10.1.101

2. Query the remote IP address setting of all reports

A cmd save is required for this command to take effect.

---

See Also: repaddmes repdelmes repemail replocport repremport repsms reptype

repremport n xxxxx

Sets the IP port number of the remote server that the report will be sent to.

n = 1 to 999 report number
xxxxx = 0 to 65535 remote port number

The current IP port configuration for a report can be queried by using remport n where n is the report number.
If n is omitted, all reports will be queried.

Examples:

1. Report #1 will be sent to port 5005 on remote IP address set by repremip

2. Query the remote port setting of all reports

A cmd save is required for this command to take effect.

---

See also: repaddmes, repdelmes, repemail, replocport, repremip, repsms, reptype

repsms n pppppppppp or <email address>

Sets the destination of the report that is sent as an SMS message. Up to 999 reports may be configured. The default SMS destination is blank.

Note: SMS features are only available for specific manufacturer, RF modules, cards or devices. Please contact Cypress Solutions for a complete list of products that support SMS functionality.

n = 1 to 999 report number

pppppppppp phone number which the SMS report will be sent to. For long distance calls, a “1” needs to be added In front of the phone number.

<email address> email address which the SMS report will be sent to.

The current SMS destination configured for all reports can be queried by using the repsms command without parameters.

Examples:

1. Send report #1 as an SMS message to the specified phone number

2. Send report #2 as an SMS message to the specified email address

3. Query the SMS destination for report #1

4. Query the SMS phone numbers or email addresses for all reports

A cmd save is required for this command to take effect.

---

See also: repaddmes, repdelmes, repemail, replocport, repremip, repremport, reptype

reptype n l r s

Sets the reporting type for local and remote servers.

Note: SMS features are only available for specific manufacturer, RF modules, cards or devices. Please contact Cypress Solutions for a complete list of products that support SMS functionality.

n = 1 to 999 report number

l = 0 disables local report (default)
l = 1 asynchronous NMEA or ULCP messages over RS232
l = 2 asynchronous NMEA or ULCP messages with a ULCP header over RS232
l = 3 in-band NMEA or ULCP messages in a UDP Packet over Ethernet
l = 4 in-band NMEA or ULCP messages with a ULCP header and in individual UDP packets over Ethernet
l = 5 in-band NMEA or ULCP messages in a TCP Packet over Ethernet
l = 6 file-based reports

r = 0 disables remote report (default)
r = 3 in-band NMEA or ULCP messages in a UDP Packet
r = 4 in-band NMEA or ULCP messages with a ULCP header and in individual UDP packets
r = 5 in-band NMEA or ULCP messages in a TCP Packet
r = 6 email reports
r = 7 SMS reports

s = 0 disables the store and forward of report
s = 1 enables the store and forward of report

Note: For r = 7 (SMS reports), the total length of the report must not exceed 166 characters including <CR> and <LF>

The current report type configuration for a report can be queried by using reptype n where n is the report number.
If n is omitted, all reports will be queried.

Examples:

1. Send report #4 as a UDP packet over Ethernet and over the wireless link, and will not store reports

2. Send report #2 as a UDP packet over Ethernet and as an SMS message to the SMS destination set using the repsms command, and will enable the store and forward of reports

3. Query the reporting methods for all reports

A cmd save is required for this command to take effect.

---

See also: repaddmes, repdelmes, repemail, replocport, repremip, repremport, repsms

restore

Restores the configuration to the previously saved version (overwrite any commands not yet saved).
This command has the same effect as a power cycle with regard to the configuration.

Example:
cmd restore

rmtd iii.iii.iii.iii xxxx

Configures the modem to perform a reverse telnet connection to an IP address and port.
The modem tries to connect periodically until a connection is established.
By default this is disabled with IP 0.0.0.0 and port 0.

iii.iii.iii.iii = 0.0.0.0 to 255.255.255.255 remote IP address. 0.0.0.0 = disabled (default)

xxxxx = 0 to 65535 remote port number. 0 = disabled (default)

The current state of remote reverse telnet setting can be queried by using the rmtd command without parameters

Examples:

cmd rmtd 204.123.1.10 5000 sets the IP to 204.123.1.10 and the port to 5000

cmd rmtd queries the modem’s rtmd setting

A cmd save is required for this command to take effect.

rmtssh n

Enables or disables remote SSH access to the modem.
If enabled, it will be possible to access the modem with a SSH client, using the current IP address allocated to the modem by the network.

n = 0 remote access = disabled (default)
n = 1 remote access = enabled

The current status of remote SSH access can be queried by using the rmtssh command without parameters.

Examples:

cmd rmtssh 1 enables remote access to the modem using SSH
cmd rmtssh queries the current status of remote SSH access.

A cmd apply followed by a cmd save are required for this command to take effect.

rmttelnet

This command configures the modem to respond to incoming telnet commands over the wireless network.
The modem must be connected to a wireless network.

n=0 remote telnet = disabled (default)

n=1 remote telnet = enabled

The current state of remote telnet setting can be queried by using the rmttelnet command without pararmeters.

Examples:

cmd rmttelnet 1 sets the modem to respond to incoming telnet commands
cmd rmttelnet queries the modem’s setting for remote telnet access

A cmd apply followed by a cmd save are required for this command to take effect.

rmtweb n

Enables or disables remote access to the embedded web server feature of the modem.
If enabled, it will be possible to access the modem's embedded web pages by using the current IP address allocated to the modem by the network.

n = 0 remote access = disabled (default)
n = 1 remote access = enabled

The current status of remote web server access can be queried by using the rmtweb command without parameters.

Examples:

cmd rmtweb 1 enables remote access to the modem’s web pages
cmd rmtweb queries the current status of remote web

A cmd apply followed by a cmd save are required for this command to take effect.

rssi

This command queries to the current wireless network signal strength seen by the modem for both the 1x and EV-DO networks.
The values are given in dBm in the range, for example: -105dBm (poor), to -60dBm (excellent).

Note: This command is not supported by all wireless network cards and modules.

This is a read only command.

Example:

1. Query the current network signal strengths seen by the modem

saltreport [r1] [r2] [r3] [r4] [r5] [r6] [r7] [r8]

This command sets the report(s) to be used for the chlorobyte salt-spreader interface triggered reports.
Up to 8 reports can be assigned to the saltreport configuration:

r = 0 disables the report
r = 1 to 999 report number

When saltreport is configured to use a report, it appends to the already existing messages configured in the report a modified 114 message.

The appended message contains the specific salt spreader parameters received on the serial port instead of the modem ID in the default 114 message. The mode must be configured correctly to allow the spreader controller to communicate with the modem.

Example:

uses report 2 for salt-spreader interface triggered reports, adds a standard message 114 as a message, saves the configuration.

Report output:

In the above example the first line is the default 114 message, the second line shows the 114 message but with the salt spreader information instead of the modem ID. Note, the message type 114 does not have to be explicitly added as a message, this is handled automatically by the saltreport command.

A cmd save is required for this command to take effect.

---

See also: mode, reptype, repremport, repremip, replocport, repemail, repsms, repaddmes

satbackup b bt g gt o

Sets the option to switch to a backup satellite modem if the cellular network’s coverage is poor.
The satellite modem power must be driven by a modem output for this feature to work.
The user defines the RSSI(receive signal strength) threshold to initiate the switchover, the timeouts and the output number to use.
When the RSSI value falls below the bad RSSI threshold for a certain timeout period, an output will be set.
When the RSSI value rises above or equal to the good RSSI threshold for a certain timeout period, an output will be cleared.

NOTE: This command is only available on data cards/modules that provide RSSI information to the modem. Contact Cypress Solutions for a complete line of supported data devices

b = 0 Disable (default)[[br] b = -1 to -125 Bad RSSI threshold in dBm; requires the negative sign

bt = 0 to 65535 Bad RSSI timeout in seconds; if the RSSI is less than the bad threshold for the timeout period, than set the output. Default is 0

g = 0 Disable (default)
g = -1 to -125 Good RSSI threshold in dBm; requires the negative sign

gt = 0 to 65535 Good RSSI timeout in seconds; if the RSSI is greater than or equal to the good threshold for the timeout period than clear the output. Default is 0

o = 1 to 4 Output number. Default is 1

A cmd save and power cycle are required before this setting takes effect.
The current satellite backup setting can be queried by entering satbackup without parameters.
To clear setting, use cmd satbackup 0 0 0 0 0

Examples:

cmd satbackup -100 30 -95 30 2 Set the bad RSSI threshold to -100dBm with a timeout of 30 seconds; set the good RSSI threshold to -95dBm with a timeout of 30 second; trigger output 2.

cmd satbackup Queries the current satbackup configuration

A cmd save is required for this command to take effect.

cmd save

Save modem configuration to non-volatile memory.

Note: A single cmd save can be entered after a series of commands are configured, the entire session will be saved.

If settings are not saved, they will remain in effect until the next powercycle

Example:

1. Save current configuration

showconfig

Returns the current configurations of the modem.
This is a read only command.

showconfig returns the configuration of the commands as they were entered, including the cmd statement.

The output of showconfig is written to a script file /tmp/config.sh and to the console, both of which can be used to configure the modem.

The below commands are not supported in showconfig. To query the status of the below commands use showstate. To configure these commands the showconfig script file or input text must be manually updated.

The below commands are not supported in either showconfig or showstate commands. To configure these commnands the showconfig script file or input text must be manually updated.

Commands can be manually entered as shown in the output of showconfig using the syntax shown. The showconfig output can be 'Copy & Pasted', if there is a long list list of commands, it is recommended to use a telnet session rather than the serial console to capture the output of showconfig.

Example:
cmd showconfig returns the current modem configurations

showstate

Returns the current state of the modem.
This is a read only command.

showstate returns the modem state:

• firmware revision
• modem ESN
• modem ID
• modem IP address
• odometer
• engine hours
• RF Switch output mode, 0 = RF device connected or connecting, 1 = RF device off, awaiting switch input.
• SMS text
• amount of data transmitted and received over the wireless data link

Example:

singlepc n

Sets the modem’s DHCP allocation of IP addresses.
If enabled, the modem’s DCHP server will only allocate one IP address.
This single IP address assigned by the modem will be 192.168.1.20.

n = 0 Disable (default)
n = 1 Enable

The current DCHP allocation setting can be queried by entering singlepc without parameters.

Examples:

1.Enable single PC mode

2. Query the current singlepc configuration

A cmd save is required for this command to take effect.

smssend

Used to SEND the previously setup SMS message (smsto and smstext).

Note: SMS features are only available for specific manufacturer, RF modules, cards or devices. Please contact Cypress Solutions for a complete list of products that support SMS functionality.

The modem needs to be connected to the network.

Example:
cmd smssend send the SMS message

smstext <string> <delimiter>

Used to enter the text message of the SMS.

Note: SMS features are only available for specific manufacturer, RF modules, cards or devices. Please contact Cypress Solutions for a complete list of products that support SMS functionality.

The delimiter is used to indicate an end of text message.
Text message is not saved in non-volatile memory a <CR> denotes a carriage return.

<string> text message(max 166 chars)

<delimiter> sequence of a blank line followed by a carriage return and then the sequence “.”

Example:

cmd smstext <CR>
Hi <CR>
This is test <CR>
message<CR>
from Bob<CR>

.<CR>

Note:cmd smstext cannot be used from a serial console.

smsto pppppppppp

This command is used to set the phone number of the SMS text message to be sent.

Note: SMS features are only available for specific manufacturer, RF modules, cards or devices. Please contact Cypress Solutions for a complete list of products that support SMS functionality.

The phone number is not saved in non-volatile memory.

pppppppppp phone number which the text message will be sent to. For long distance calls, a “1” needs to be added in front of the phone number.

The current settings can be queried by using the smsto command without parameters.

Examples:
cmd smsto 1235551212 sets the phone number to send the SMS
cmd smsto returns the phone number this command is set to

smsview

Querys the message entered via smstext command.

Note: SMS features are only available for specific manufacturer, RF modules, cards or devices. Please contact Cypress Solutions for a complete list of products that support SMS functionality.

This is a read only command.

Example:
cmd smsview returns the text message to be sent

snfdelay [n]

This command sets the store-and-forward delay time. The delay time is the number of seconds the modem must have a good quality RF connection before stored messages are forwarded. Valid range is 1 to 65535 seconds. The default is 20 seconds.

Note that message forwarding may not occur exactly at the snfdelay interval specified, and stored messages will only start forwarding when network conditions are deemed acceptable.

Example:

1. Set the delay time before forwarding SNF data to 60 seconds

A cmd save is required for this command to take effect.

snfflush

Flushes and resets store and forward NVRAM.

snflog n

Used to display the contents of the store and forward log locally thru a serial console, and the status of the log entries. The log can contain up to 3000 records.

This is a read only command.

n = 1 to 3000 number of store reports to be displayed

The number of stored reports and their status can be queried by entering snflog without parameters.

T:t where t is the total number of stored reports
F:f where f is the number of reports forwarded
N:n where n is the number of reports not yet forwarded

Examples:
cmd snflog 100 displays the first 100 SnF log entries
cmd snflog displays the SnF log status

Note: snflog may erroneously report number of forwarded messages as 1 in cases where number of forwarded messages is actually 0. When network coverage resumes, all packets will be forwarded.

spc nnnnnn

This command is used to enter the modem’s CSL (Client Subsidy Lock) as part of the network activation commands prior to loading the modem’s 10-digit phone number using the dir command.
The 6-digit lock code is used by the modem’s embedded module to compare against the pre-loaded 6-digit CSL. This number will be provided by the service provider at the time of service activation.

nnnnnn 6-digit lock code

Example:
cmd spc 123456 set the modem’s SPC to 123456

A cmd save is required for this command to take effect.

speedth ss t

Sets the speed threshold for automatically enabling the RF module of the modem when it has been previously disabled.
Turns off output #4 when it has been previously turned on.
The RF module of the modem is disabled by using an external switch box(supplied by Cypress Solutions) connected to the modem when the modem is used in areas sensitive to RF interference.

The defaults are 30 km/h for ss and 3 seconds for t.
If ss and t are omitted, the current speed threshold will be queried.

ss speed threshold(kph)
t time (seconds)

Example:

cmd speedth 50 5 set the RF module of the modem to automatically turn on when the speed reaches 50 km/h for at least 5 seconds

cmd speedth queries the current speed threshold conditions

A cmd save is required for this command to take effect.

sshkey [dss/rsa]

Generate a SSH public/private key pair.

dss Generate a 1024 bit DSS key pair
rsa Generate a 1024 bit RSA key pair

Example:

cmd sshkey dss
root@OpenWrt:~# cmd sshkey dss
Will output 1024 bit dss secret key to '/etc/dropbear/id_dss'
Generating key, this may take a while...
Public key portion is:
ssh-dss AAAAB3NzaC1kc3MAAACBAKV8x80K0wnyc4Ia/NiD0BTZLhPYVPO8FhB3kWzLOdB99Sy
QBgl6tXaYvPXT+rV24qzmJaNIDlwMAsJRxp86Jki/WogktrN1jjjl8bnwrvjvM1kCCmWf8SUry
Rhk+tvqCgQX1qk3CQsFE0JjU66Fk6+s5+Ng7ofigajDNCJYCDo7AAAAFQDDTQ9nonJwG5
xLxoOeHO21CDjOZwAAAIA6MxUSC34am0YmmiCAOUPa6Vy6SbJVhsffoBBVFkoDmTqkd
v/lMR4iP4Rhjb3rl27r+8wnlzorm5sKJGvhbLjLbQqlvv0aUiywmM31L5ZIIglq7adGJ6cLwIQ
KZ5+1Vt1Nx9MQiayD9vey5HCdgtS6OBENVOp4H7bWfqAOkuZnDAAAAIBd1f8d5aguW/
ySngmjH64MNyk7t8k9bmN+2kFS6szUd40EwjAHMTAK+Rgu4Q/tiXlVOq8qomCgfd2oEN
6KbiJDoqEYsRzCQ8AhCWfNEKiQd9X3Dw7Q8dRxD6Qx+Ro18ptklXIQtsURUrBWXJtetr0w
pihQnkhLtedu028o1+Ex6A== root@OpenWrt
Fingerprint: md5 6b:06:6e:f4:2e:0e:58:21:12:1d:f8:51:25:2a:a5:6d
OK

sshport [port]

Sets the port for ssh access (both local and remote).
A cmd apply, followed by cmd save and power cycle are required for this command to take effect.

port = 1 to 65535 port to be used for ssh (default: port 22)

The current ssh port setting can be queried by entering cmd sshport without parameters.

Example:
1. Set ssh port to 3322

sshtimeout n

Sets the timeout period for a ssh session with no activity. The ssh timeout will take effect on the next sshlogin.

n = 0 to 65535 timeout time, in seconds (default: 60 seconds)

The current ssh timeout setting can be queried by entering sshtimeout without parameters.

Example:

1. Disable ssh timeout

swipemode n

Sets the swipe card interface to be used with the modem.

n = 0 Serial HID swipe card interface (default), requires cmd mode 9
n = 1 Serial iButton swipe card interface, requires cmd mode 9
n = 10 GPIO HID swipe card interface, works in any mode and takes priority in cmd mode 9

When swipemode is configured with n = 0 or n = 1, the command cmd mode 9 must be used. When swipemode is configured with n = 10, any mode can be used.

Note: In order to use swipemode 10, power management controller firmware version 105 must be loaded. To check this version cmd mmq 47 command can be issued and should return the value of 69. Contact Cypress Solutions for instructions on upgrading power management controller firmware.

Examples:

1. Set modem to use the serial iButton swipe card interface
2. Set modem to use the GPIO HID swipe card interface
3. Query the currently configured swipe card interface

A cmd save and a power cycle are required for this command to take effect.

---

See also: mode

swipereport [r1] [r2] [r3] [r4] [r5] [r6] [r7] [r8]

This command sets the report(s) to be used for swipe card reader triggered reports.
Up to 8 reports can be assigned to the swipereport configuation:
r = 0 disables the report
r = 1 to 999 report number

When swipereport is configured to use a report, it appends to the already existing messages configured in the report a modified 114 message.

The appended message contains the ID of the swipe card detected by the swipe card reader. mode must be configured correctly to allow the swipe card reader to communicate with the modem. When using the redboot loader swipe card reader application to trigger remote reports, store and forward must be enabled for the report(s) assigned using swipereport.

Example:

uses report 2 with store and forward enabled for swipe card reader triggered reports, adds a standard message 114 as a message, saves the configuration.

Report output:

In the above example the first line is the default 114 message, the second line shows the appended swipe card ID information added to the message. Note, the message type 114 does not have to be explicitly added as a message, this is handled automatically by the swipereport command.

A cmd save is required for this command to take effect.

---

See also: mode, reptype, repremport, repremip, replocport, repemail, repsms, repaddmes

syslog n

Provides a mechanism to retrieve the log of system events recorded by the modem.
Log events include network connects and disconnects.
Note that the system log is stored in volatile memory so it will be lost when power is cycled on the modem.

n = 0 to 65535 number of system log records to return. Leaving n blank will return the entire contents of the system log up to a maximum of 65535.

Examples:
cmd syslog 10 returns the last 10 events stored in the system log
cmd syslog returns all events stored in the system log

tcppersist n

This command configures the CTM-15X to maintain persistent TCP connections for configured TCP reports.

n = 0 persistent connections for TCP reports = disabled (default)
n = 1 persistent connections for TCP reports = enabled

The current state of the command can be queried by using the tcppersist command without parameters.

Examples:

1. Enable persistent connections for TCP reports
   cmd tcppersist 1
   OK
   
   
2. Query the current setting for persistent TCP report connections
   cmd tcppersist
   cmd tcppersist 0
   OK

A cmd save and a power cycle are required for this command to take effect.

telnetport n

Sets the port for telnet access (both local and remote).
A cmd save and power cycle is required for this command to take effect.

n = 1 to 65535 port to be used for telnet (default: port 23)

The current telnet port setting can be queried by entering telnetport without parameters.

Firmware version R1.2.1 and below: When the telnet port is changed using telnetport from within a local/remote Telnet session, this session will be disconnected. To complete telnet port configuration, you will need to reconnect to the telnet server at the new telnet port, issue a cmd save and power cycle.

Firmware version R1.3.0 only: To complete telnet port configuration, power cycle the modem.

Example:
1. Set telnet port to 33
A cmd apply followed by a cmd save are required for this command to take effect.

---

See also: telnetpswd, telnettimeout

telnetpswd n

Sets password for telnet access (both local and remote) and ssh access (both local and remote). ssh access is available in firmware version R1.3.0 only.

n a maximum of 40-character alpha-numeric password

Example:
1. Set telnet password to ‘cypress’

Firmware version R1.2.1 and below: A cmd save is required for this command to take effect.

Firmware version R1.3.0 only: This command takes effect immediately.

---

See also: telnetport, telnettimeout

telnettimeout n

Sets the timeout period for a telnet session with no activity. The telnet timeout will take effect on the next telnet login.

n = 0 to 65535 timeout time, in seconds (default: 60 seconds)

The current telnet timeout setting can be queried by entering telnettimeout without parameters.

Example:

1. Disable telnet timeout
A cmd save is required for this command to take effect.

---

See also: telnetpswd, telnetport

timesync

Set the period in seconds when the modem's system time and the power management controller's time are synchronized with one or more external sources:

• Valid GPS (gpstime)
• Network time protocol (NTP) built-in client (ntptime)
• Cellular network time (networktime)

t = 0 to 65535 synchronization period in seconds (default: 3600 seconds)

A cmd save and a power cycle are required for this command to take effect.

Examples:
1. Update system time and power management controller time as fast as possible
2. Update system time and power management controller time every 10 seconds

---

See also: gpstime, networktime, ntpserver, ntptime

univwd <mode> <url>/<report>

Configure the Universal Watchdog.

mode = 0 disabled
mode = 1 detect increase in received packets.
mode = 2 ping specified url
mode = 3 send specified report

Examples:

1. Configure a report to send PMID message #3, to remote server on UDP port 7002.
Set universal watchdog into mode 3, which will use report 1 to generate ping activity.
A cmd save is required for this command to take effect.

---

See also: message formats, repdelmes, repemail, replocport, repremip, repremport, repsms, reptype

upgradefw imagefile.tar url username passwd

Remote upgrade of the CTM-15X firmware (kernel and root filesystem images).

The command requires 5 parameters when accessing an FTP server, 3 parameters when accessing an HTTP server, or 3 parameters when accessing scripts locally.

imagefile.tar the name of the file containing the firmware image

url can be localhost, or the address of the FTP or HTTP server, can also be an IP address, prefixed by ftp:// or http:// respectively; if no prefix is specified (eg. cypress.bc.ca) then ftp:// is used.

username username to access FTP server (ignored when url is prefixed by http:// or url is localhost)

passwd password to access FTP server (ignored when url is prefixed by http:// or url is localhost)

When localhost is specified as the url, the image file must be located in /tmp on the modem.

Examples:

cmd upgradefw openctm-1.3.0-r1590.tar cypress.bc.ca guest guestpw where openctm-1.3.0-r1590.tar is the image file, cypress.bc.ca is the FTP server, guest is the username of the FTP server, and guestpw is the password of the FTP server

cmd upgradefw openctm-1.3.0-r1590.tar localhost where openctm-1.3.0-r1590.tar is the image file, and /tmp is the location of the image file.

upgradesrv a.a.a.a

This command is used to set the IP address of a remote client that is authorized to run remote administration commands.

The RemoteAdminServer commands: Showconfig, Confupgrade and Pwrcycle are restricted to an authorized IP.

a.a.a.a = 0.0.0.0 to 255.255.255.255 IP address of the authorized IP client. Default = 0.0.0.0

0.0.0.0 disables all remote clients 255.255.255.255 enables all remote clients

The current upgrade server IP address can be queried by using the upgradesrv without parameters.

Examples:

1. Set the upgrade server IP address to 209.121.68.211
2. Query current email server

usepeerdns x

This command is used to enable or disable the modem from obtaining its DNS nameserver IP addresses from the carrier when it connects to the network.
This is enabled by default whenever a cmd factory is issued.

If specific DNS nameservers are to be used, this setting should be disabled. DNS nameserver IP addresses can be added from the main Network web page under the lan DNS servers section by entering the DNS nameserver IP address in the text field, clicking on the Add button, followed by clicking on the Save Changes button.

x = 0 disable obtaining DNS nameserver IP addresses from the carrier
x = 1 enable obtaining DNS nameserver IP addresses from the carrier (default)

Examples:
1. Disable obtaining DNS nameserver IP addresses from the carriere.

This command takes effect immediately.

user n

Sets the username used for wireless network access via simple IP. This is often in the format of [phone number]@[carrier].com.

n a maximum of 40-character alpha-numeric username

A save operation is required.

Examples:
cmd user 6045551234@… sets the username to 6045551234@…
cmd user displays the current username used for wireless network access via simple IP

A cmd apply followed by a cmd save are required for this command to take effect.

---

See also: mip, pswd

vcc

Returns the current value of the modem’s supply voltage. This is a read only command.

Example:

1. Query the supply voltage in xx.xx ASCII format

vcccond [n] [o] [a.a] [mt]

This command is used to set the condition(s) that would trigger a supply voltage level report.
The conditional parameter is used to indicate how all following parameters will be used to determine if a report is triggered. Use the Off setting to disable the report.

n = 1 to 8 supply voltage level condition trigger
o=0 trigger disabled (default)
o=1 trigger while supply voltage is below threshold
o=2 trigger while supply voltage is above threshold
o=3 trigger on transition (whenever supply voltage threshold is passed)

(above threshold->below threshold or below threshold->above threshold)

Optional parameters:
a.a = 9.0 to 36.0 threshold voltage, in volts (default = 9.0 V)
mt = 0 to 65535 maximum reporting rate in seconds (minimum time between reports)

(default = 60 s)

The current condition(s) can be queried by using the vcccond n command.
If n is blank, all vcccond triggers will be queried.

Examples:

1.Triggers vcccond 1 every 60 seconds while supply voltage is below the threshold voltage of 9.0 volts
2. Triggers vcccond 2 every 60 seconds while supply voltage is below the threshold voltage of 9.0 volts
A cmd save is required for this command to take effect.

---

See also: vccreport

vccreport [n] [r]

This command sets the report to be used for supply voltage level triggered reports.
Up to 8 supply voltage level trigger reports can be configured.

n = 1 to 8 supply voltage level trigger condition
r = 1 to 999 report number
r = 0 disables the report

Example:
cmd vccreport 1 1 uses report #1 for supply voltage level trigger condition #1.

A cmd save is required for this command to take effect.

---

See also: vcccond, repaddmes, repdelmes, repemail, replocport, repremport, repremip repsms, reptype

ver

Queries the currently installed firmware version of the modem.

Example:

1. Query the current firmware version

wifiwd n [t]

Enable/disable wifi watchdog.
n 0 = disabled; 1 = enabled t watchdog threshold time in seconds, time must be in range 31 to 65535 (optional:default is 120 seconds).

Example:

1. Enable wifi watchdog with a 5 minute threshold

wpanacktype n

Assigns an acknowledgment type for the Work Alone system.
There are two acknowledgment types:

• modem
• server

Note: CTM-15X Modem firmware 1.2.0 only supports modem mode acknowledgment type.

If a user initiates a ‘Man Down Emergency’ alert, the pendant will provide the worker with either a positive acknowledgment or a negative acknowledgment.

n = m modem type acknowledgment (default)
n = s server type acknowledgment

Entering wpanacktype with no arguments returns the current command configuration.

A cmd save and a power cycle are required before either mode takes effect.

• Modem type acknowledgment:

A positive acknowledgment (ACK) means the modem has received the alert. If the pendant has not received an acknowledgment from the modem, the pendant will continue to send PANIC/MPANIC messages until an acknowledgment (ACK) is received. (Pendant firmware V1.1 and later)

• Server type acknowledgment:

A positive acknowledgment means that the server has received the alert from the modem and acknowledged back to the modem then to the pendant. If the pendant has not received an acknowledgment from the server, the pendant will continue to send PANIC/MPANIC messages until it receives an acknowledgement (ACK). (Pendant firmware V1.1 and later)

Note:

The remote server must also be configured to respond to messages from the modem.
The message format sent from the modem is as follows:
The acknowledgment that the modem expects from the server is as follows:
The 16-digit hex number following the PPEN message is the Pendant ID and is unique to each pendant.

Examples:

1. Configured as modem type acknowledgment
2. Configured as server type acknowledgment

wpanadddev xx-xx-xx-xx-xx-xx-xx-xx

Adds a WPAN device ID to the Chameleon Modem’s registered WPAN devices list. Up to 16 WPAN IDs can be entered.

xx-xx-xx-xx-xx-xx-xx-xx WPAN device ID (hex digits), hyphens are optional

Using wpanadddev without a device ID, queries all WPAN devices IDs currently registered in the Chameleon Modem.

Note that the ID of FF-FF-FF-FF-FF-FF-FF-FF will allow any pendant to talk through the modem.

Example:

cmd wpanadddev 00-13-a2-00-40-08-58-5e add WPAN device with this ID to the registered devices list

cmd wpanadddev 0013a2004008585e above example with optional hyphens omitted

cmd wpanadddev queries all devices IDs

A cmd save is required for this command to take effect.

---

Note that the modem needs to be power cycled for the new settings to take effect.

wpandelall

Deletes all WPAN device IDs from the Chameleon Modem’s registered WPAN devices list.

Example:

cmd wpandelall deletes all WPAN devices from the registered devices list

---

Note that the modem needs to be power cycled for the new settings to take effect.

wpandeldev xx-xx-xx-xx-xx-xx-xx-xx

Deletes a WPAN device ID from the Chameleon Modem’s registered WPAN devices list. xx-xx-xx-xx-xx-xx-xx-xx WPAN device ID (hex digits), hyphens are optional

Example:

cmd wpandeldev 00-13-a2-00-40-08-58-5e delete WPAN device with this ID from the registered devices list

cmd wpandeldev 0013a2004008585e above example with optional hy[hens omitted

A cmd save is required for this command to take effect.

---

Note that the modem needs to be power cycled for the new settings to take effect.

wpanpanid xxxx

Set the WPAN PAN ID to communicate with the WPAN devices.

xxxx WPAN PAN ID (hex digits)

Using wpanpanid without a PAN ID, queries the WPAN PAN ID currently configured in the Chameleon Modem.

Example:

cmd wpanpanid 2000 change the WPAN PAN ID to 0x2000

cmd wpanpanid queries the current WPAN PAN ID

---

Note: A cmd save and a power cycle must occur for the new settings to take effect.

wpanpensrv x yyyy

Configure the listening protocol and port of the Pendant Server that provides remote access to Man Down Pendant devices.

x = 0 UDP protocol (default)
x = 1 TCP protocol
yyyy = 0 to 65535 port number of listening port, in decimal (0 = disabled, default)

Using wpanpensrv without arguments returns the currently configured protocol and port in the Chameleon Modem.

Note:

If the modem is currently in WPAN Gateway mode, mode 10, and any other LAN or firewall configuration commands are set after issuing the wpanpensrv command, then both a cmd save and a power cycle are required to resume proper remote access to pendant devices through wpanpensrv.

Example:

cmd wpanpensrv 0 21001 change the Pendant Server to listen on UDP port 21001
cmd wpanpensrv 1 21002 change the Pendant Server to listen on TCP port 21002
cmd wpanpensrv queries the current Pendant Server settings

A cmd save and a power cycle must occur for the new settings to take effect.

---

See also: mode