Sierra Wireless DART 300 CDPD Modem Migration Guide For Users of the DART 200 2110291 Rev 1.
DART 300 Modem Migration Guide Important Notice Because of the nature of wireless communications, transmission and reception of data can never be guaranteed. Data may be delayed, corrupted (i.e., have errors) or be totally lost.
DART 300 Modem Migration Guide Regulatory Information The equipment certifications appropriate to your device are marked on the device and the accompanying product specific information. Where appropriate, the use of the equipment is subject to the following conditions: CAUTION Unauthorized modifications or changes not expressly approved by Sierra Wireless, Inc. could void compliance with regulatory rules, and thereby your authority to use this equipment.
DART 300 Modem Migration Guide RSA Licensee If you have purchased this product under a United States Government contract, it shall be subject to restrictions as set forth in subparagraph (c)(1)(ii) of Defense Federal Acquisitions Regulations (DFARs) Section 252.227-7013 for Department of Defense contracts, and as set forth in Federal Acquisitions Regulations (FARs) Section 52.227-19 for civilian agency contracts or any successor regulations.
DART 300 Modem Migration Guide Contents 1. About this Guide .............................................................................1 1.1. Introduction .............................................................................................................1 1.1.1. Document Structure ................................................................................1 1.2. References ................................................................................................................
DART 300 Modem 4. Migration Guide Comparative AT Command Reference .......................................20 4.1. Introduction ...........................................................................................................20 4.2. AT Command Set..................................................................................................20 4.3. DART 300 Specific Commands ...........................................................................29 4.4. Status Registers ....................
1. About this Guide 1.1. Introduction This Migration Guide is designed to assist application software developers who have experience with the DART 200 in porting applications for use with the new DART 300 CDPD modem. Installations will require changes to the DART configuration commands used on the DART 200 in order to use the DART 300 in its place. There should not be a need to alter either local or remote system applications related to end-to-end communication.
DART 300 Migration Guide Introduction 1.3. Currency This document may be revised from time to time as new firmware and features are made available. Please check our website for revisions. This edition is: Rev 1.0 November 8, 2000 DART 300 / SB300 This document is current with the modem firmware revision R1.3.5. To determine your firmware revision: 1.
2. Sample Configurations The DART 200 User’s Guide contained several sample configurations. This section provides the equivalent configurations for the DART 300 modem to illustrate the scope of configuration differences. The commands for both the DART 200 and DART 300 are shown side by side for comparison. Details of the differences in behaviour between the two modems are summarized in subsequent sections.
DART 300 Migration Guide Sample Configurations Table 2-1 Remote UDP Setup (Server) (continued) DART 200 Command DART 300 Equivalent Description F1 (default) +WS62=0 Data state echo off. X1 (default) N/A Extended result codes. The DART 300 will accept the X1 command but takes no action. &C1 (default) N/A DCD follows state of connection. The DART 300 uses this configuration and does not allow changes to DCD function. &D0 (default) &D0 Ignore DTR for data state escape.
DART 300 Migration Guide Sample Configurations Table 2-2 Host UDP Setup (client) DART 200 Command DART 300 Equivalent Description ^A +WPNEI= Set the IP address (NEI) of the modem. \N +WS174= Set the side preference. The direct translation of the side preference numbers is: s2 s3 1 3 A Only 2 4 B Only 3 1 A Preferred 4 2 B Preferred \J0 (default) +WPSPNI= No channel restrictions, no SPNI matching. \R4 +WS173=1 Use auto-registration mode.
DART 300 Migration Guide Sample Configurations Table 2-2 Host UDP Setup (client) (continued) DART 200 Command DART 300 Equivalent Description \Q2 (default) N/A Use hardware flow control (RTS/CTS). The DART 300 supports only this flow control. \T1 (default) +WS70=20 Timed data forwarding (always used with binary data). The DART 200 configuration assumes use of the default value in S50 (20 tenths of a second). *B0 (default) N/A Disable broadcast reception.
DART 300 Migration Guide Sample Configurations Table 2-3 Remote TCP Setup (Server) (continued) DART 200 Command DART 300 Equivalent Description V0 V0 Use numeric result codes. Q0 (default) Q0 (default) Disable Quiet mode. F1 (default) +WS62=0 Data state echo off. X1 (default) N/A Extended result codes. The DART 300 will accept the X1 command but takes no action. &C1 (default) N/A DCD follows state of connection.
DART 300 Migration Guide Sample Configurations Following is the client side configuration for a TCP installation. Table 2-4 Host TCP Setup (client) DART 200 Command DART 300 Equivalent Description ^A +WPNEI= Set the IP address (NEI) of the modem. \N +WS174= Set the side preference. The direct translation of the side preference numbers is: s2 s3 1 3 A Only 2 4 B Only 3 1 A Preferred 4 2 B Preferred \J0 (default) +WPSPNI= No channel restrictions, no SPNI matching.
DART 300 Migration Guide Sample Configurations Table 2-4 Host TCP Setup (client) (continued) DART 200 Command DART 300 Equivalent Description \Q2 (default) N/A Use hardware flow control (RTS/CTS). The DART 300 supports only this flow control. \T1 (default) +WS70=20 Timed data forwarding (always used with binary data). The DART 200 configuration assumes use of the default value in S50 (20 tenths of a second). *B0 (default) N/A Disable broadcast reception.
3. Difference Summary This section summarizes the differences between the DART 200 and DART 300 in several main categories: • Interfaces • Operation • Additional Control Considerations • Specifications 3.1. Interfaces 3.1.1. Serial Interface Specifications The DART 300 supports a broader range of data rates (up to 57600 bps) but does not support autobaud rate detection as the DART 200 did. The DART 300 also restricts the port characteristics to 8 data bits and no parity.
DART 300 Migration Guide 3.1.2. Difference Summary Control Lines The DART 300 does not allow configuration of the DCD and DSR signals; a feature supported in the DART 200. Flow control on the DART 300 is through hardware only via RTS/CTS and DTR. RTS/CTS DART 200 DART 300 Hardware and software flow control both supported via AT command. Hardware flow control only. Only active in online mode. RTS must be asserted to allow serial communication from the DART 300 to the host.
DART 300 Migration Guide 3.1.3. Difference Summary Packet Service Interfaces The DART 300 does not include TELNET or PING generation support found in the DART 200. The DART 300 will reply to PINGs but cannot generate them internally. The DART 300 adds support for PPP connections. DART 200 DART 300 RFC 1055 RFC 1055 SLIP header compression supported. SLIP header compression is NOT supported.
DART 300 Migration Guide Difference Summary 3.2. Operation 3.2.1. Monitoring Network Connection Both modems provide mechanisms to monitor the CDPD network connection although the methods to access this information differ. DART 200 DART 300 Signal Strength in -dBm S102 +WPRSSI Normalized Signal Strength (%) Not supported.
DART 300 Migration Guide 3.2.3. Difference Summary TCP Characteristics Friends Only mode Auto Answer TCP Keep Alive DART 200 DART 300 Yes (up to 10 IP addresses) Yes (up to 10 IP addresses) Yes 2 1 Yes, drops connection on receive timeout and generates character on transmit timeout. Yes Yes, drops connection on receive or transmit timeout. This timer also applies to UDP sessions. 1 On the DART 200 Auto Answer is off if DTR is off and either &D1 or &D2 is specified.
DART 300 Migration Guide 3.2.4. Difference Summary UDP Characteristics UDP Server DART 200 DART 300 Supports multiple concurrent clients.1 Supports both single and multiple client sessions (by setting +WS217). (Receive locking with FIFO queue) (Receive locking with FIFO queue and timer). Server is active when listening port +WS212 > 0. Auto answer Based on S0=1 and *A2 to configure UDP Server mode. Based on S0=1 and listening port > 0.
DART 300 Migration Guide Difference Summary 3.3. Additional Control Considerations 3.3.1. Escape Sequence The escape sequence is used to change from data state to command state. This is a necessary step for the modem to respond to AT commands to close a data session. There are three possible mechanisms to gracefully change to command state: 1. Time Dependent Escape Sequence (TDES) involving the escape character repeated three times with a guard time to prevent false detection in a data stream. 2.
DART 300 Migration Guide 3.3.2.2. Difference Summary Packet Assembly Local Echo Both models are capable of echoing back data as the packet assembler receivers it. This allows a user to see what is being entered before it is sent. For most telemetry applications, this feature should be turned off. The DART 200 uses the F command: F0 to disable echo, F1 to enable it. The DART 300 uses +WS62; 0 to disable echo, 1 to enable it. 3.3.2.3.
DART 300 Migration Guide Difference Summary 3.4. Specifications 3.4.1. 3.4.2. Modem Features DART 200 DART 300 CDPD Version supported 1.0 & 1.1 1.1 only Maximum packet size (bytes) 1924 (or less as determined by TCP handshake) User adjustable (+WS74) from 1 – 1000. V.
DART 300 Migration Guide 3.4.3. Difference Summary Electrical Specification 2110291 Rev 1.0 DART 200 DART 300 Power Supply 12V, 2.5A 12V, 1A Peak Transmit Current 2.
4. Comparative AT Command Reference 4.1. Introduction This chapter compares the AT commands available on the DART 300 with those of the original DART 200. This is not intended as a complete reference to the AT Command behaviour, but instead identifies the differences in behaviour of commands and offers suggested alternatives where the new DART 300 does not support the same functionality as the original DART 200.
DART 300 Migration Guide Comparative AT Command Reference Table 4-1: Basic AT Commands (continued) Command DART 200 DART 300 D [options] Dial Dial Takes dial modifier T or P for TCP and UDP sessions respectively. Assumes the protocol from the setting of +WS45. Takes dotted-decimal IP and optional port number delimited using a slash (/); e.g. DP192.0.2.1/2100 – dials a UDP session to port 2100. If the port number is omitted a value of 23 is used.
DART 300 Migration Guide Comparative AT Command Reference Table 4-1: Basic AT Commands (continued) Command DART 200 DART 300 Q[n] Quiet – Result Code Display Option Quiet – Result Code Display Option Suppress result codes to the DTE. Same behaviour. S-Register Write S-Register Write Sets the contents of the specified S-register (n) to the new value (x). Same behaviour.
DART 300 Migration Guide Comparative AT Command Reference Table 4-2: AT [&] Commands (continued) Command DART 200 DART 300 &E[n] Escape Code Recognition Escape Code Recognition Controls handling of the escape character sequence: enabled or disabled, and whether or not to forward the sequence to the network. TDES is disabled by setting the escape character in S2 to a value >127. TIES is disabled using +WS60=0. The DART 300 always filters the escape sequence from the data stream.
DART 300 Migration Guide Comparative AT Command Reference The Backslash (\) command set is only available on the DART 200. The DART 300 uses alternative commands or registers where equivalents exist. Table 4-3: AT [\] Commands Command DART 200 DART 300 Equivalent \F Character Data Forwarding Operation PAD Forwarding Character Feature Mask The DART 200 supports two forwarding characters, indicated in S51 and S52. The DART 300 supports only one forwarding character, indicated in +WS64.
DART 300 Migration Guide Comparative AT Command Reference Table 4-3: AT [\] Commands (continued) Command DART 200 DART 300 Equivalent \R Registration Control Registration Control Controls the modem’s CDPD network registration. Auto-registration is controlled by a combination of \R4 and S13=0. The DART 300 controls registration with a combination of +WS173 and commands +WPREG and +WPDEREG. S13 controls the registration timeout. Register +WS198 controls the registration process timeout.
DART 300 Migration Guide Comparative AT Command Reference Table 4-4: AT [*] Commands (continued) Command DART 200 DART 300 Equivalent *C Compress SLIP Header Compress SLIP Header Controls SLIP mode header compression (V-J compression) between the local host and the DART 200 modem. Not supported. Enable / Disable Network Operations Enable / Disable Network Operations If PINs are required for network access, this command enables and disables access to the network. Not supported.
DART 300 Migration Guide Comparative AT Command Reference Table 4-4: AT [*] Commands (continued) Command DART 200 DART 300 Equivalent *S SLIP Mode Initiate SLIP Mode Initiate Initiates a SLIP session on the serial port. It is also used to return to SLIP mode following an escape. SLIP sessions are started or re-entered with the ATO (On-line) command. Telnet Keep-Alive Telnet Keep-Alive Allows the modem to time out, or keep-alive a telnet session with no current activity.
DART 300 Migration Guide Comparative AT Command Reference Table 4-5: AT [^] Commands (continued) Command DART 200 DART 300 Equivalent ^L LASI and WASI Set LASI and WASI Set Sets the LASI/WASI value into one of the 10 slots in the DART’s table. Not supported. Personalization Mode Personalization Mode ^P This command must be issued before any other Not supported. Service Provider commands can be executed. ^S SLIP Address Set SLIP Address Set Sets the SLIP IP Address of the Modem.
DART 300 Migration Guide Comparative AT Command Reference 4.3. DART 300 Specific Commands The Plus (+) command set is only available on the new DART 300. The DART 200 uses alternative commands or registers where equivalents exist. This section is provided as a cross reference to the equivalent commands in the older DART 200. Table 4-7: AT [+] Commands Command DART 200 DART 300 +IPR I/O Port Rate (DTE speed) I/O Port Rate (DTE speed) Supported via the &L command.
DART 300 Migration Guide Comparative AT Command Reference Table 4-7: AT [+] Commands (continued) Command DART 200 DART 300 +WPRSSI Mean RSSI RSSI and Channel State The mean RSSI is available in register S102. Returns the current Receive Signal Strength Indication (RSSI), channel state, registration status, and channel number. +WPSPNI= [n[,n[,...n]]] Restrict Channel Selection Service Provider Network ID Table Write.
DART 300 Migration Guide Comparative AT Command Reference 4.4. Status Registers This section deals with the registers available on the two modems from the aspect of function only. Consult the specific model references for detailed descriptions of specific value ranges and meanings. DART 200 registers used for Service Provider Mode are generally not shown as these are unsupported in the DART 300 and do not have equivalents. If an equivalent does exist, the register is shown in the table below. 4.4.1.
DART 300 Migration Guide Comparative AT Command Reference Table 4-8: S-Registers (continued) Register DART 200 DART 300 52 PAD Primary Forwarding Character 2 Not supported. The DART 300 has only one Primary Forwarding Character (+WS64). 53 IP Address and port number of current TCP/UDP session partner. Not supported. The IP address can be obtained with +WVCALLERIP. The port number is not available. 57 State information (bitmapped) Not supported.
DART 300 Migration Guide Comparative AT Command Reference Table 4-8: S-Registers (continued) Register DART 200 DART 300 83 UDP Receive Lock Timer (Service Provider Mode) UDP Receive Lock Timer 85 TCP Keep-Alive Character Not supported. 86 Telnet/TCP Keep Alive Timeout Not supported. The DART 300 uses S30 for timing out UDP/TCP sessions. 100 RF channel currently being reported (may not be acquired) Not supported. The current channel can be read from +WS200.
DART 300 Migration Guide 4.4.2. Comparative AT Command Reference WS-Registers in the DART 300 This section provides a cross reference from the DART 300’s +WS register set to the equivalent DART 200 commands or registers. Table 4-9: WS-Registers Register DART 200 Equivalent DART 300 45 *A for server side and T or P dial modifier for client side. PAD – Packet Service 50 Not supported. Normalized Signal Strength 56 S57 bit 0 Network Registration Status 60 Not supported.
DART 300 Migration Guide Comparative AT Command Reference 4.5. Result Codes This table provides a numerical list of the result codes possible on the DART 300. DART 200 codes 9 and 10 are related to PIN use, which is not supported on the DART 300. Table 4-10: DART 300 Result Codes Code Verbose DART 300 Meaning 0 OK Command executed without error.
