Raven CDMA/1xRTT User Guide AirLink Communications, Inc. Version 2.09 December 2005 Information in this document is subject to change without notice ©Copyright AirLink Communications, Inc., 1993-2005. All rights reserved. WARNING The antenna(s) used for this transmitter must be installed to provide a separation distance of at least 20 cm from all persons and must not be co-located or operating in conjunction with any other antenna or transmitter. 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. Although significant delays or losses of data are rare when wireless devices such as the AirLink Communications modem are used in a normal manner with a well-constructed network, the AirLink modem should not be used in situations where failure to transmit or receive data could result in damage of any kind to the user or any other party, including but not limited to personal injury, death, or loss of property. AirLink Communications, Inc., accepts no responsibility for damages of any kind resulting from delays or errors in data transmitted or received using the AirLink Communications modem, or for failure of the AirLink Communications modem to transmit or receive such data. Safety and Hazards Do not operate the AirLink Communications modem in areas where blasting is in progress, where explosive atmospheres may be present, near medical equipment, near life support equipment, or any equipment which may be susceptible to any form of radio interference. In such areas, the AirLink Communications modem MUST BE POWERED OFF. The AirLink Communications modem can transmit signals that could interfere with this equipment. Do not operate the AirLink Communications modem in any aircraft, whether the aircraft is on the ground or in flight. In aircraft, the AirLink Communications modem MUST BE POWERED OFF. When operating, the AirLink Communications modem can transmit signals that could interfere with various on board systems. The driver or operator of any vehicle should not operate the AirLink Communications modem while in control of a vehicle. Doing so will detract from the driver or operator's control and operation of that vehicle. In some states and provinces, operating such communications devices while in control of a vehicle is an offence. Limitation of Liability The information in this manual is subject to change without notice and does not represent a commitment on the part of AirLink Communications, Inc. AIRLINK COMMUNICATIONS, INC. SPECIFICALLY DISCLAIMS LIABILITY FOR ANY AND ALL DIRECT, INDIRECT, SPECIAL, GENERAL, INCIDENTAL, CONSEQUENTIAL, PUNITIVE OR EXEMPLARY DAMAGES INCLUDING, BUT NOT LIMITED TO, LOSS OF PROFITS OR REVENUE OR ANTICIPATED PROFITS OR REVENUE ARISING OUT OF THE USE OR INABILITY TO USE ANY AIRLINK COMMUNICATIONS, INC. PRODUCT, EVEN IF AIRLINK COMMUNICATIONS, INC. HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES OR THEY ARE FORESEEABLE OR FOR CLAIMS BY ANY THIRD PARTY. i TELUS CDMA/1xRTT Raven User Guide Version 2.09 Contents CHAPTER 1 Introduction to Raven CDMA/1xRTT 1 Raven Overview 1 2 2 3 Raven front and back 1 CDMA/1xRTT Overview Establishing a Internet Connection Using the Raven to connect to the Internet 3 Using CDMA/1xRTT to Communicate with Your Equipment Common Uses for the Raven 4 Financial POS and Kiosk 4 Automation and Telemetry 5 Backup connection to the Internet 5 CHAPTER 2 Raven Activation 6 6 6 8 Connecting the Raven to your computer Quick Start Guide and Setup Wizard Setup Wizard Menu 7 Configuring the Raven using Wireless ACE TELUS CDMA/1xRTT Raven User Guide Version 2.09 ii Contents Raven Indicator Lights Raven indicator lights 8 8 CHAPTER 3 Raven Utilities AceView 9 10 AceView 10 AceView: About Raven 10 Wireless ACE and Wireless ACE Web Wireless ACE 11 11 AceNet 12 13 AceNet 12 Modem Doctor Modem Doctor 13 CHAPTER 4 DNS: Using Names Instead of IP addresses Configuring DNS 14 Wireless ACE: DNS 15 PPP-Peer 15 14 CHAPTER 5 IP Manager 16 17 18 17 Fully Qualified Domain Name Dynamic Name Resolution Configuring the Raven for Dynamic IP Wireless ACE: Dynamic IP (IP Manager configuration) 18 Restrictions for Modem Name 19 CHAPTER 6 Keepalive 20 Configuring Keepalive 20 21 Keepalive Configuration in Wireless ACE 21 Data usage using Keepalive. iii TELUS CDMA/1xRTT Raven User Guide Version 2.09 Contents CHAPTER 7 Host Modes 22 23 24 25 25 26 AT Mode PPP Mode Slip Mode PassThru Mode UDP Pad Mode UDP Auto Answer 26 Reliable UDP 27 Multicast UDP 28 TCP PAD Mode Hybrid Modes 28 29 TCP Auto Answer 29 Hybrid Mode Settings 30 CHAPTER 8 Modbus/BSAP Configuration Modbus Overview 31 31 Telemetry 32 Remote Terminal Unit (RTU) 32 Supervisory Control and Data Acquisition (SCADA) 32 Programmable Logic Controller (PLC) 32 Modbus TCP/IP 33 Raven Modbus on UDP 33 Automation and Telemetry 33 Configuring the Raven at the Polling Host for Modbus on UDP Port 34 Wireless ACE: Destination Port 34 Wireless ACE: Device Port 34 Default Power-up Mode 34 Wireless ACE: MD Configuration 34 IDs to IPs 35 Wireless ACE: Addr List 35 Dynamic IP 35 Wireless ACE: Modem Name and Domain 36 34 Configuring the Remote Ravens for Modbus with UDP Port 36 Default Power-up Mode 37 Wireless ACE: UDP Power-up Mode 37 36 TELUS CDMA/1xRTT Raven User Guide Version 2.09 iv Contents Host Raven IP 37 Wireless ACE: Destination IP 37 Dynamic IPs 37 RTU settings 38 Raven mounted in an enclosure with an RTU 38 RTU to Raven setup 39 Power Connections 39 CHAPTER 9 Simple Network Management Protocol (SNMP) SNMP Overview 40 Management Information Base (MIB) 41 SNMP Traps 41 40 Raven SNMP Configuration 41 Listening Port 41 Wireless ACE: *SNMPPORT 41 Security Level 42 Wireless ACE: *SNMPPORT 42 User Name and Password 42 Wireless ACE: Changing the Raven Password - Menu Option 43 Wireless ACE: Changing the Raven Password 43 Trap Destination 44 Wireless ACE: *SNMPPORT 44 Example of the MIB trap 44 CHAPTER 10 Hardware Installation Raven Mounting Kit 49 49 51 Raven Mounting Bracket, part number 100-170-1009 A 50 Connecting the Antenna Raven connectors 51 Connecting power 51 51 Connecting the Raven to a computer or other device CHAPTER 11 AT Commands 53 53 Using Wireless Ace Wireless ACE: Using AT Commands 53 Wireless ACE: toolbar 54 v TELUS CDMA/1xRTT Raven User Guide Version 2.09 Contents Using Telnet Terminal Emulation 54 HyperTerminal: Connection Name 55 HyperTerminal: TCP/IP Settings 55 HyperTerminal: AT mode via Telnet 56 Direct Serial Connection 56 HyperTerminal: Connection Name 56 HyperTerminal: Comport Setting 57 HyperTerminal: Comport Settings 57 AT Commands 57 Information and Status 58 Basic Commands 60 Activating (Provisioning) 62 Cellular Network (TELUS) 63 Local Network and Host Modes 64 PassThru Mode 71 Telnet 72 Friends Mode 73 Time and Date 74 Logging 74 DNS 75 IPManager 76 Keepalive 77 78 Direct Communication 79 SMTP (email) 80 Modbus Settings 81 SNMP 85 Commands Usable with PassThru 86 Other Settings 86 CHAPTER 12 Raven Specifications 92 92 Physical Characteristics: 92 Data Services & RF Features: Environmental: 93 Power Management: 93 Troubleshooting 94 Support web site 94 94 Contacting Technical Support TELUS CDMA/1xRTT Raven User Guide Version 2.09 vi CHAPTER 1 Introduction to Raven CDMA/1xRTT The AirLink Raven's serial port can be connected to a computer or other device. The Raven uses CDMA/1xRTT to connect to TELUS's cellular network to allow communication to the Internet. Raven Overview The Raven's rugged form factor is ideal for industrial and commercial applications that require real-time communications. The Raven provides cellular data communications for a variety of applications, such as telemetry, public safety, SCADA, traffic control, traffic metering, transit arrival systems and more. FIGURE 1. Raven front and back TELUS CDMA/1xRTT Raven User Guide Version 2.09 1 Introduction to Raven CDMA/1xRTT The Raven has several built in features to make it more effective in a variety of settings. In addition, Airlink provides several modem tools to further enhance the capabilities of the Raven. These features and tools are introduced in this User Guide. · · · · Wireless ACE, Wireless ACE Web, and AceNet IPManager Modem Doctor Keepalive CDMA/1xRTT Overview Code Division Multiple Access (CDMA) provides a digital cellular telephony system provides wireless Internet access at speeds between 60 and 80 kbps, with bursts up to 144 kbps. Establishing a Internet Connection The Internet Service Provider (ISP) from you to the Internet is TELUS with your Raven as the connection to TELUS. When your Raven is powered on, it automatically searches for cellular service using CDMA/1xRTT and establishes a PPP (Point to Point Protocol or "dial" up connection) link to TELUS's network. As soon as the Raven receives its IP, it's ready to create a network between your computer or device and TELUS's network so you can use TELUS to communicate on the Internet. To use your Raven to connect to the Internet from your computer, you need to connect the computer directly to the Raven's serial port and use Dial-Up Networking (DUN). TELUS CDMA/1xRTT Raven User Guide Version 2.09 2 Introduction to Raven CDMA/1xRTT FIGURE 2. Using the Raven to connect to the Internet Note: Private network connections are unique for each configuration and not covered as part of the standard installation. Using CDMA/1xRTT to Communicate with Your Equipment There are two types of addresses in TCP/IP, dynamic and static. · Dynamic addresses are assigned on a "need to have" basis. Your Raven might not always receive the same address each time it connects with TELUS. · Static addresses are permanently assigned to a particular account and will always be used whenever your Raven connects to the Internet. The IP address will not be given to anyone else. If you need to contact the Raven, a device connected to the modem, or a host system using the modem, you need to have a known IP (such as one which is static) or domain name (an IP address which is converted by a DNS server into a word based name). Most ISPs (cellular included) use dynamic IP addresses rather than static IP addresses. A dynamic IP address is suitable for many common Internet uses, such as web browsing, looking up data on another computer system, or other client function (such as data only being sent out or only being received after an initial request). 3 TELUS CDMA/1xRTT Raven User Guide Version 2.09 Introduction to Raven CDMA/1xRTT If you have a dynamic IP address for your Raven, you can use a service (such as IP Manager, covered later in this User Guide) to translate a dynamic IP address to a fully qualified domain name so you can contact the Raven as if it had a static IP. Caution: The IP address given to your Raven by TELUS must also be Internet routable if the computer you need to connect to the Raven is not connected directly to TELUS's IP network. Please check with TELUS to confirm you IP is scheme is correct for your application and needs. Common Uses for the Raven The Raven's rugged construction and cellular connection make it ideal for use in remote and/or industrial locations. The Raven can be used for telemetry and for more advanced communication to the device or devices behind it. FIGURE 3. Financial POS and Kiosk TELUS CDMA/1xRTT Raven User Guide Version 2.09 4 Introduction to Raven CDMA/1xRTT FIGURE 4. Automation and Telemetry FIGURE 5. Backup connection to the Internet 5 TELUS CDMA/1xRTT Raven User Guide Version 2.09 CHAPTER 2 Raven Activation Your Raven needs specific parameters before it can operate on the CDMA/1xRTT network. Generally TELUS will provide you with the necessary parameters to get the Raven configured. Connecting the Raven to your computer Your Raven's serial port can be connected directly to most computers or devices using a standard straight through serial cable. Quick Start Guide and Setup Wizard The preferred way to configure and activate your Raven is via the AirLink Setup Wizard for TELUS and CDMA/1xRTT. The Quick Start Guide will lead you through the using the Setup Wizard. · The Raven Setup Wizard for CDMA/1xRTT and TELUS is available from the AirLink web site, http://www.airlink.com/support. · The Quick Start Guide is also available at the AirLink web site. TELUS CDMA/1xRTT Raven User Guide Version 2.09 6 Raven Activation Note: The web site may have a more recent Setup Wizard and Quick Start Guide than those included with your Raven. It is recommended that you check with the web site for the latest version before installing your Raven. You will need to look for TELUS, CDMA/1xRTT, and the Raven. Other Setup Wizards may not work to connect you to TELUS. To run the Setup Wizard, you will need the Microsoft .NET framework and Mi ...