RST Instruments RSTAR Affinity Gateway Installation And Commissioning Manual
  1. Manuals
  2. Brands
  3. RST Instruments Manuals
  4. Gateway
  5. RSTAR Affinity Gateway
  6. Installation and commissioning manual

RST Instruments RSTAR Affinity Gateway Installation And Commissioning Manual

Hide thumbs Also See for RSTAR Affinity Gateway:
Table of Contents

Advertisement

Quick Links

Download this manual
RSTAR Affinity Gateway
Installation and Commissioning Guide
All efforts have been made to ensure the accuracy and
completeness
of
the
information
contained
in
this
document. RST Instruments Ltd reserves the right to
change the information at any time and assumes no liability
for its accuracy.
Copyright © 2020. RST Instruments Ltd. All rights reserved.
Document Number:
PSM0004A
Release Date: AUG 15, 2022
PSM0004A

Advertisement

Table of Contents
loading
Need help?

Need help?

Do you have a question about the RSTAR Affinity Gateway and is the answer not in the manual?

Questions and answers

Subscribe to Our Youtube Channel

Related Manuals for RST Instruments RSTAR Affinity Gateway

Summary of Contents for RST Instruments RSTAR Affinity Gateway

  • Page 1 RST Instruments Ltd reserves the right to change the information at any time and assumes no liability for its accuracy. Copyright © 2020. RST Instruments Ltd. All rights reserved. Document Number: PSM0004A Release Date: AUG 15, 2022 PSM0004A...

  • Page 2: Table Of Contents

    3.9.4 Install the Solar Panel and Battery Pack (if using solar power)....17 3.9.5 Install the Fiberglass Antenna for Outdoor Setup (Optional) ....18 COMMISSIONING PROCEDURES ................. 18 RSTAR Affinity Gateway Identification Sheet ..........18 Commissioning Pre-requisites ................. 19 Linux Commands .................... 19 Shell Scripts ....................
  • Page 3 Figure 5: Typical Junction Box Internal Layout ................8 Figure 6: Junction Box Terminator Assignment ................8 Figure 7: RSTAR Affinity Gateway Box Contents (standard options) ......... 10 Figure 8: Pole Mount Option ..................... 11 Figure 9: Mounting Bracket ....................... 12 Figure 10: Antenna Port ......................
  • Page 4 RSTAR Affinity Gateway Installation and Commissioning Guide IST OF ABLES Table 1: Gateway Identification Sheet ..................19 Table 2: Common Linux Console Commands ................19 Table 3: Custom Shell Scripts Commands ................20 Table 4: Interface Metric ......................25 PSM0004A RST Instruments Ltd.

  • Page 5: Introduction

    RSTAR Affinity Gateway Installation and Commissioning Guide INTRODUCTION RSTAR A FFINITY ONNECTIVITY OLUTION The RSTAR Affinity Connectivity Solution comprises data loggers, gateways, secure communications for data telemetry, and mobile and desktop applications. RSTAR Affinity is a complete industrial internet of things (IIoT) solution for reliable, real-time data flow from your worksite to your desktop –...

  • Page 6: Intended Audience

    RSTAR Affinity Gateway Installation and Commissioning Guide NTENDED UDIENCE This guide is for the service personnel responsible for installing and commissioning an RSTAR Affinity gateway. CONS AND ONVENTIONS UIDE This guide uses the following icons to call attention to important information.

  • Page 7: Rstar Affinity Gateway

    RSTAR A FFINITY ATEWAY The RSTAR Affinity gateway allows for steady data transmission using cellular signal to our secure cloud environment or straight to your own server. Bi-directional communications push firmware and sensor settings over the air. The gateway has a certified uptime of 99.9% built to withstand the harsh, real-world field conditions, and is rated for temperatures of -40ºC to 60ºC.

  • Page 8: Rstar Affinity Dashboard

    The open API supports integration with third-party data management and presentation software. ECURITY The RSTAR Affinity gateway is designed with the following security measures to prevent data breaches:  the gateway and the RSTAR Affinity field app incorporates MQTT authentication and authorization security algorithms ...

  • Page 9: Wireless Telemetry

    These network options, in order of preference, are ethernet, Wi-Fi, and cellular. SYSTEM OVERVIEW VERVIEW The RSTAR Affinity gateway has an IP65 rated waterproof enclosure than can be mounted using pole or wall mount options. PSM0004A RST Instruments Ltd.

  • Page 10: Figure 2: Rstar Affinity Gateway Device Overview

    RSTAR Affinity Gateway Installation and Commissioning Guide Figure 2: RSTAR Affinity Gateway Device Overview PSM0004A RST Instruments Ltd. Page 6...

  • Page 11: Hardware Interfaces

    RSTAR Affinity Gateway Installation and Commissioning Guide ARDWARE NTERFACES The gateway features hardware interfaces on the top and bottom panels as shown in the following pictures. Note that LTE/DIV is currently not used. Figure 3: Gateway Hardware Interfaces – Top Figure 4: Gateway Hardware Interfaces –...

  • Page 12: Figure 5: Typical Junction Box Internal Layout

    RSTAR Affinity Gateway Installation and Commissioning Guide NOTE: Error! Reference source not found. and Error! Reference source not fo und. show the typical configuration of a power junction box with the 120/220V AC power option. Diagrams of the solar power option will be available in the future.

  • Page 13: Pre-Configured Options

    RSTAR Affinity Gateway Installation and Commissioning Guide CONFIGURED PTIONS The gateway and its power junction box are pre-configured by RST with options specific to customers. Pre-configured options include LoRaWAN radio module (433, 868, or 915 MHz), with 120/220V AC power source or solar panel and battery pack.

  • Page 14: Installation Tools

    Phillips head screwdriver ONTENTS The gateway and power junction box are shipped with the parts and components listed in the table below and shown in Figure 7. Figure 7: RSTAR Affinity Gateway Box Contents (standard options) PSM0004A RST Instruments Ltd. Page 10...

  • Page 15: Install Gateway With Pole Mount Option

    RSTAR Affinity Gateway Installation and Commissioning Guide Item Quantity Description number Gateway Wall or pole mounting bracket and mounting screws LoRaWAN antenna* Power junction box with mounting brackets Cellular antenna and lightning arrestor * Wi-Fi antenna and lightning arrestor *...

  • Page 16: Install Gateway With Wall Or Panel Mount Option

    RSTAR Affinity Gateway Installation and Commissioning Guide 3. Attach the gateway to the pole bracket. 4. Attach the antenna to the correct port as shown on the labels on the gateway. NSTALL ATEWAY WITH ALL OR ANEL OUNT PTION This installation option uses the gateway wall mount assembly for mounting to a metal wall plate or a wall.

  • Page 17: Install Antenna

    RSTAR Affinity Gateway Installation and Commissioning Guide NSTALL NTENNA To install an antenna to the gateway, complete the following steps: Figure 10: Antenna Port 1. Unscrew the antenna port cover found on top of the enclosure. 2. Attach the wireless antenna.

  • Page 18: Mount The Power Junction Box To A Wall

    RSTAR Affinity Gateway Installation and Commissioning Guide To install a PoE cable on the gateway, complete the following steps: 1. Unscrew the cable gland from the bottom of the gateway. 2. Unscrew the pressure dome and remove the sealing sleeve.

  • Page 19: Install Optional Components

    RSTAR Affinity Gateway Installation and Commissioning Guide NSTALL PTIONAL OMPONENTS The following are optional components you can install in the power junction box to support the gateway:  grounding cable CAUTION: You will need to supply your own grounding cable. Ensure to use a grounding cable that is 14 AWG or thicker.

  • Page 20: Install The Poe Cable (Optional)

    RSTAR Affinity Gateway Installation and Commissioning Guide 3.9.2 Install the PoE Cable (Optional) Figure 14: Power Junction Box Optional PoE Cable To install an optional PoE cable to the power junction box, complete the following steps: Unscrew the cable gland assembly from the bottom of the power junction box.

  • Page 21: Install The Ac Line Cable (If Using Ac Power)

    RSTAR Affinity Gateway Installation and Commissioning Guide 3.9.3 Install the AC Line Cable (if using AC power) Figure 15: Power Junction Box Optional AC Line Cable To install the optional AC line cable, complete the following steps: CAUTION: The 120/220V AC line has three conductors – hot, neutral, and ground.

  • Page 22: Install The Fiberglass Antenna For Outdoor Setup (Optional)

    RSTAR Affinity Gateway Installation and Commissioning Guide 3.9.5 Install the Fiberglass Antenna for Outdoor Setup (Optional) To install the optional fiberglass antenna mounting for an outdoor setup, complete the following steps: 1. Install the gateway using the pole or wall mount option.

  • Page 23: Commissioning Pre-Requisites

    RSTAR Affinity Gateway Installation and Commissioning Guide Configuration option The build option ordered with the gateway such as LoRaWAN wireless module ID, region, and sub-band Table 1: Gateway Identification Sheet OMMISSIONING REQUISITES The following are the pre-requisites for commissioning the gateway: ...

  • Page 24: Shell Scripts

    RSTAR Affinity Gateway Installation and Commissioning Guide HELL CRIPTS The gateway uses pre-defined shell scripts to execute functions. Shell scripts are small computer programs that are executed from the SSH command line interpreter. They require the user to enter the full or relative path. Below are two examples of how to execute a shell script.

  • Page 25: Access Console From Secure Shell

    RSTAR Affinity Gateway Installation and Commissioning Guide 4.5.1 Access Console from Secure Shell As the installer, you must configure and verify operation during commissioning. Because of the different operational parameters, some configurations are required to be uniquely configured for each gateway. To allow on-site (local) configuration, you must log in to the gateway using its local console connection.

  • Page 26: Change Password (Optional)

    RSTAR Affinity Gateway Installation and Commissioning Guide 4.5.2 Change Password (Optional) The default user password is uniquely generated by RST. You may change this default password during commissioning or at any time after. To change the user’s password, complete the following steps: 1.

  • Page 27: Topology

    RSTAR Affinity Gateway Installation and Commissioning Guide local link address (169.254.0.0) to either a dynamic IP or a static IP address available on the network. 4.6.1 Topology The diagram below shows a typical ethernet topology for either a cloud or on- premises RSTAR Affinity software server environment.
  • Page 28 RSTAR Affinity Gateway Installation and Commissioning Guide  Metric – this parameter sets the ethernet adapter connection priority against the other available networking adapter such as the Wi-Fi and cellular  IP/Mask – static IP and mask*  Gateway – gateway IP address and mask* ...

  • Page 29: Wi-Fi

    RSTAR Affinity Gateway Installation and Commissioning Guide This parameter sets the ethernet adapter connection priority against the other available networking adapter such as the Wi-Fi and cellular. The gateway connects with the highest priority adapter. The default interface metric is defined in Table 4: Interface Metric, where 0 = highest priority and 999 = lowest priority.

  • Page 30: Set Up Wi-Fi Connection

    RSTAR Affinity Gateway Installation and Commissioning Guide Figure 17: Wi-Fi Topology Diagram 4.7.2 Set Up Wi-Fi Connection To configure the gateway’s Wi-Fi interface as a static or dynamic IP interface, complete the following steps: 1. The shell script gw-uplink with the argument “wifi” specifies the configuration for the Wi-Fi adapter.
  • Page 31 5. The script prompts for the Metric. Metric[default]: This parameter is identical to ethernet configuration. Refer to section 4.6.2. 6. For static IP address type, the script prompts for the RSTAR Affinity gateway IPv4 address. IP/mask: This parameter is identical to ethernet configuration. Refer to section 4.6.2.

  • Page 32: Cellular

    RSTAR Affinity Gateway Installation and Commissioning Guide This parameter is identical to ethernet configuration. Refer to section 4.6.2. After completing the configuration, the script will attempt to connect to the Wi-Fi access point. This typically takes less than 10 seconds. The connection status will be displayed.

  • Page 33: Verify Network Settings

    RSTAR Affinity Gateway Installation and Commissioning Guide 2. The script prompts for the access point name: APN: The access point name (APN) is the name of the gateway between the mobile network and the internet. The APN is presented to the carrier to determine what kind of network connection should be created.
  • Page 34 RSTAR Affinity Gateway Installation and Commissioning Guide username is unique to each organization. Consult with the system administrator.  Endpoint administration password – This is the same password used when installing the RSTAR Affinity software on-premises system. Consult with the system administrator.

  • Page 35: Retrieve The Guid And Pin From A Gateway

    4.8.5 Retrieve the GUID and PIN from a Gateway An RSTAR Affinity Gateway has a factory-assigned 128-bit globally unique identification number (GUID) that cannot be changed. It is on the product label and can also be found by running the SSH console command from the /opt/affinity_gw/script directory.

  • Page 36: Claim Or Add Gateway To A Site

    RSTAR Affinity Gateway Installation and Commissioning Guide 4.8.6 Claim or Add Gateway to a Site You must register the gateway's GUID to the RSTAR Affinity software before you can add it to a site. To register a gateway to the RSTAR Affinity dashboard, complete the following steps: 1.

  • Page 37: Set Up A Gateway Power Modes (Optional)

    RSTAR Affinity Gateway Installation and Commissioning Guide 5. Enter the 36-character gateway GUID and four-digit PIN from completing Register a Gateway for Use in On-Premises Environment (section 4.8.4). 6. Click Continue to add the gateway to the site.  The Configure gateway connection screen appears.
  • Page 38 RSTAR Affinity Gateway Installation and Commissioning Guide Feature SSH command Enable power management service gw-pow set Disable power management service gw-pow clear Show power management settings gw-pow-show Pause power management service gw-pow pause Resume power management service gw-pow resume The following parameters are specific to each installation.

  • Page 39: Enable Power Management Service

    RSTAR Affinity Gateway Installation and Commissioning Guide  Gateway Wakeup/Sleep Cycle(hours): 4  Gateway Wakeup/Sleep Cycle(minutes): 0  Gateway Minute Offset: 2 4.8.8 Enable Power Management Service To enable the gateway’s power management service, complete the following steps: 1. Run gw-pow set to specify the power management options.

  • Page 40: Pause Power Management Service

    RSTAR Affinity Gateway Installation and Commissioning Guide After disabling power management, the gateway would remain in operational state indefinitely. 4.8.10 Pause Power Management Service Pausing the gateway’s power management services may help extend an active console session. To pause the gateway’s power management services, run gw-pow pause.
  • Page 41 RSTAR Affinity Gateway Installation and Commissioning Guide RSTAR A FFINITY ATEWAY PECIFICATIONS PHYSICAL SPECIFICATIONS Dimensions Excluding Antenna(s) 220 mm (L) x 220 mm (W) x 104 mm (H) Dimensions Including Antenna(s) 1150 mm (L) x 220 mm (W) x 104 mm (H)
  • Page 42 RSTAR Affinity Gateway Installation and Commissioning Guide Maximum Antenna Gain 3 dBi RSTAR RADIO SPECIFICATIONS Operating Frequency (Country-dependent) 900 MHz, 868 MHz, 2.4 GHz spread spectrum band Outdoor Range Up to 14 km (at 900 MHz) in open country, depending on frequency and antenna...

Table of Contents