RediGate 400 Series Getting Started Guide

Transcription

1 RediGate 400 Series Getting Started Guide Product Information Full information about other Elecsys products is available on our website at Product Support Tel: Toll free: Fax: Headquarters, Sales, Support & Manufacturing Elecsys Corporation 846 N Mart-Way Court Olathe, KS Tel: Fax: info@elecsyscorp.com While Elecsys may assist customers with their choice of products, the final choice of product for a specific application is entirely the responsibility of the buyer. Elecsys' entire liability with respect to its products or systems is defined in the Elecsys standard terms and conditions of sale. Any example code is provided only to illustrate the use of Elecsys products. No warranty, either expressed or implied, is made regarding any example code provided by Elecsys and Elecsys shall incur no liability whatsoever arising from any use made of this code. Disclaimers The information in this manual is believed to be accurate at the time of publication. Elecsys Corporation assumes no responsibility for inaccuracies that may be contained in this document and makes no commitment to update or keep current the information contained in this manual. Elecsys Corporation assumes no responsibility for any infringements of patents or other rights of third parties that may result from its use. Elecsys Corporation reserves the right to make changes or improvements to this document and/or product at any time and without notice. While Elecsys may assist customers with their choice of products, the final choice of product for a specific application is entirely the responsibility of the buyer. Elecsys' entire liability with respect to its products or systems is defined in the Elecsys standard terms and conditions of sale. Any example code is provided only to illustrate the use of Elecsys products. No warranty, either expressed or implied, is made regarding any example code provided by Elecsys and Elecsys shall incur no liability whatsoever arising from any use made of this code Elecsys Corporation Table of Contents Getting Started with Configurations Starting the RediGate Installing the ACE Program Download Latest Default Configuration Upload Configuration to RediGate Upload via Ethernet SSL Upload via Serial Tera Term Diagnostics Connecting via Putty Setting up PuTTY for Serial Communication Setting up PuTTY for Network Communication Host Configuration Ethernet Host Configuration Sim Card Installation (GSM, AT&T) Cellular Host Configuration (GSM, AT&T) Cellular Host Configuration (CDMA, Verizon) Testing Connectivity Ping Utility Page 1 of 13

2 Download and Install Latest Update Tarball Where Do I Go From Here? Getting Started with Configurations This section walks a first-time user through the steps of getting connected to the RediGate, creating an initial configuration, uploading the configuration, and logging into the user interface menu to observe its operation. Starting the RediGate If you are starting the RediGate for the first time, or if you don't know the Ethernet IP address, you will need to connect to the COM0 serial port to log in to the system console. Use a null modem serial cable between the RediGate and a configuration PC. You should also connect the RediGate to the same Ethernet network as the configuration PC, or directly using a crossover Ethernet cable (you may need to configure the PC to a compatible IP address in this case). If you are using Windows, it is recommended that you install the PuTTY program to your computer. PuTTY provides both serial and secure shell (SSH) network access to the RediGate user and administrative menus. Installing the ACE Program In order to configure the RediGate, you will need to install the ACE program. The basic instructions are outlined here, but see the ACE Operation Manual (accessible at for more complete instructions on installing and using the ACE program utilities. Download the latest ACE installation from Uninstall Previous Versions If you have a previous version of ACE installed on your machine, you will need to uninstall that version prior to running the latest AceSetup.msi file. The "DefaultTemplate.xml" file will be removed during the uninstall, so make sure you either rename or back-up this file if you would like to retain it Extract and run the AceSetup.msi file Follow the installation prompts Launch ACE Download Latest Default Configuration Determine the model number of your RediGate by locating the part number on the back of the device a. RediGate 100 Series P/N Page 2 of 13

3 Visit and download the latest default configuration for your particular part number You will need to extract the.xml file from the.zip file you downloaded from the website. By default, ACE stores configuration files in the Documents\Elecsys\ACE\CFG folder, but you can store the configuration in any file location accessible by the ACE program. 3. Open the extracted default configuration with ACE Upload Configuration to RediGate Upload via Ethernet SSL In order to upload a RediGate configuration across a network, you need to know the RediGate's network address. Visit com to download the latest default configurations which will have the default IP addresses for your particular RediGate model. Enter the following information on the "Upload XML to Device..." prompt a. Password: (the default password is 'user') b. Host Address: (use the RediGate's IP address) c. User Account: Dirupld d. Home Directory: /home/dirupld Once these options have been configured, click the Upload button to transfer the configuration to the RediGate. If successful, the completed status will be displayed. Otherwise, an error condition may be indicated. Page 3 of 13

4 After the configuration is loaded to the RediGate, it will automatically reconfigure in order to implement the configuration values. This may also require a full device restart. If you connect to the RediGate's console port with a serial terminal program, you should see a sequence of boot messages while the RediGate starts and/or configures itself. Once it has finished and started running the new configuration, you should be able to ping the RediGate's IP address from another computer with a compatible network address. You should be able to log into the RediGate with either a serial or SSH (i.e. PuTTY) terminal program, using the user login and password included in the System object properties (user / user) Upload via Serial Tera Term Connect your serial cable from your laptop to the serial port configured for SerialMMI communication on your RediGate a. By default, this port is Com 0 on a RediGate 400 device In the "Upload XML File" dialog, select the "Tera Term" option and set the Port to match your serial connection port number Page 4 of 13

5 3. Enter the following information on the "Upload XML to Device..." prompt a. Password: (the default password is 'user') b. User Account: (the default username is 'user') 4. Once these options have been configured, click the Upload button to transfer the configuration to the RediGate. You will need to wait for several seconds before the file transfer begins. Click "OK" when the "File transfer success" dialog appears. Exit Putty Before Upload The upload will fail if you have an open SSH connection to the device, so make sure you exit out of Putty before uploading the configuration. Page 5 of 13

6 Diagnostics Connecting via Putty Setting up PuTTY for Serial Communication To set up PuTTY for serial communication, run the PuTTY program and configure it to use the appropriate serial port on your configuration PC. In the image below, Windows has assigned the serial driver COM5 : The settings below are the default settings for the COM0 serial connection on the RediGate 400: Update Flow Control Setting - May Freeze Putty Menu You will need to update the Serial Flow Control setting from its default value of "XON/XOFF" to "None". Failure to do so may result in Putty freezing after boot-up. You can enter a "Saved Sessions" name and click the Save button to save this session for future use, if you desire. Click the Open button to begin communication. Power on the RediGate, and you should see initial startup messages come into the terminal window. Page 6 of 13

7 Setting up PuTTY for Network Communication To set up PuTTY for network communication, run the PuTTY program and configure it to the correct IP address of your Director By default, the SSH port number is 2 If you don t know the IP address, consult a system administrator or visit and review the IP address on the default configuration that corresponds to your RediGate device You can enter a Saved Sessions name and click the Save button to save this session for future use, if you desire With the RediGate powered on, click the Open button to begin communication Host Configuration Your RediGate 400 can connect to multiple host systems over a variety of communications paths including cellular, Ethernet, and/or external satellite. The instructions below demonstrate how to edit your configuration for connectivity to your host system. Ethernet Host Configuration To set the Ethernet properties, click on the "Ethernet 0" object Set the Network Card IP, Subnet Mask, and Default Gateway appropriately for the network that you are using with the RediGate, leaving the other options default as shown below Page 7 of 13

8 DHCP If you would like your Ethernet port to obtain it's address via DHCP, enter for the Network Card IP, Subnet Mask, and Default Gateway 3. Save your settings and upload the configuration to your device Sim Card Installation (GSM, AT&T) For GSM connections, the RediGate 400 uses a standard (also referred to as "mini") SIM card. The steps below show how to install the SIM card: Step 1: Remove power and all connectors from the front panel of the RediGate. Remove the rubber end cap and the five mounting screws from the front faceplate. Step 2: Gently slide the RediGate out of its enclosure about 5 inches (127 mm) to expose the SIM card slot. Do not remove the processor entirely from the enclosure. Step 3: Fully insert the SIM card into the SIM card slot, with the metal contacts facing down and the angled edge facing out. Page 8 of 13

9 Step 4: Gently slide the RediGate back into its enclosure and carefully replace the five mounting screws to avoid over-tightening. Replace the rubber end cap and all front panel connectors. Cellular Host Configuration (GSM, AT&T) The main action required for configuring a GSM RediGate is to set the APN, which is done under the "CellModem" object in your ACE configuration: Some common APN's are: Page 9 of 13

10 i2gold (AT&T public static) m2m.com.attz (AT&T IoT sim) Once you set your APN, you should save you configuration and upload it to the RediGate device. Cellular Host Configuration (CDMA, Verizon) In order to connect your device to a CDMA network, you will need to know the MEID number. If you cannot locate MEID on the RediGate itself, you can recover it by connecting over putty. 3. SSH into your RediGate using Putty Navigating to the "Cell Modem Diags" section by entering the following commands a. 1 - (System Services) b (Cell Modem Diags" c (Diag AT Cmds These commands will take you to the following screen, where you will be able to retrieve the MEID or CIMI (IMEI, GSM, AT&T) of your cellular RediGate device. The screenshot below is of a GSM modem, so it has an "ERROR" where the MEID would be for a Verizon device. 4. Once you have your MEID, you can call your provider and activate the RediGate Testing Connectivity Ping Utility The easiest way to test RediGate network connectivity is by using the ping tool built-in to the RediGate diagnostics: Connect to the RediGate using Putty Enter the following commands a. b. c. 3 Diagnostics Services 14 Ping Service (IP address or domain of Host destination or google.com for example for internet connected devices) Page 10 of 13

11 d. If you see a reply from the IP address you pinged, you are connected and ready to send data from your field device to your host platform Download and Install Latest Update Tarball We are constantly adding new protocols, host platforms, and features to the RediGate platform, so it is a good idea to check and make sure your RediGate software is up-to-date. 3. Download the "Latest Update Tarball" for your RediGate 100 Series or 400 Series device from Open up your device's configuration using ACE Select "File Upload XML to Device", and make sure the "Upload additional file(s)" box is checked Do not change tar filename In order for the.tar to be properly installed, you must upload the file with its original filename. Uploading a file with a space in it (such as RegiGate_400_7_ZEUS_3.12_07 (1).tar.gz ) will prevent the RediGate from properly installing the update, and may cause issues with future updates. 4. Click "Upload", "Add File", and then select the downloaded tar.gz file Page 11 of 13

12 5. After the upload, you device will reset and contain the latest firmware Confirm Software Version You can confirm the version of software on your RediGate by logging into Putty. The screenshot below shows a RediGate with V: : Where Do I Go From Here? Once you have read and completed the steps in this Getting Started Guide, you can go on to configure your RediGate according to the needs of the system. There are a number of example configurations and tutorials on the that walk you through connecting your RediGate to common field devices (such as Modbus) and host platforms (such as Ignition and IBM Bluemix/Watson). The RediGate documentation consists of a set of manuals covering the hardware, configuration, diagnostics, protocols, and programming of the RediGate products. The component manuals are described below, and most of them are available on the website. Getting Started Gu ide RediGate Hardwar e Manuals ACE Operation Manual Configuration Manual Diagnostics Manual POD Programming Manual Elecsys ISaGRAF Manual Gives a product overview and instructions to the first-time user to get started using the RediGate. Contains specifications, jumper settings, and connection diagrams for the RediGate's standard and optional hardware components. Contains installation and user instructions for the Advanced Configuration Environment software, which is used to configure the RediGate. Gives detail on the standard configuration options of the RediGate product. Describes the RediGate's diagnostic capabilities and user interface. Provides instructions on using POD programming features in the RediGate configuration. Includes instructions on using the ISaGRAF programming software, with functions specific to the RediGate product. Page 12 of 13

13 Protocol Manuals Individual protocol manuals describe the configuration settings and usage information for several of the master or slave communication protocols supported by the RediGate. If you are using the Elecsys HCP2 or OPC Appliance, refer to the separate product documentation for those software applications. Page 13 of 13