mh corbin connect:its installation and user manual cut sheet.pdf• lufft nirs31 umb non evasive...
TRANSCRIPT
MH Corbin CONNECT:ITS
Installation and User Manual
Version 1.3 Feb 21, 2018
2
MH Corbin, LLC. 8355 Rausch Drive
Plain City, OH 43064 800-380-1718
3
Table of Contents Overview ....................................................................................................................................................... 5
Installation .................................................................................................................................................... 5
Cabinet Installation ................................................................................................................................... 5
Power Hook Up ......................................................................................................................................... 5
Indicator and Connectors.............................................................................................................................. 6
Front Panel LEDs ....................................................................................................................................... 6
Front Panel and Rear Panel Connectors ................................................................................................... 6
Front Panel Connectors ........................................................................................................................ 6
Rear Panel Connectors .......................................................................................................................... 6
Connect:ITS Administration .......................................................................................................................... 7
Connecting to the Connect:ITS ................................................................................................................. 7
Control Page .............................................................................................................................................. 8
Setup Page ................................................................................................................................................ 8
Location: ................................................................................................................................................ 8
Ping Remote Host: ................................................................................................................................ 9
Configure Weather Data Polling: .......................................................................................................... 9
SNMP and NTCIP Parameters: .............................................................................................................. 9
Reboot Button ....................................................................................................................................... 9
System Info ........................................................................................................................................... 9
Factory Reset ...................................................................................................................................... 10
IP page ..................................................................................................................................................... 10
Dual NICs and Bridged Mode .............................................................................................................. 10
DHCP ................................................................................................................................................... 12
Static IP................................................................................................................................................ 12
Logging Page ........................................................................................................................................... 12
Info Log................................................................................................................................................ 13
Debug Log ........................................................................................................................................... 13
Password Page ........................................................................................................................................ 14
Firmware Page ........................................................................................................................................ 14
Units & Time Page ................................................................................................................................... 14
ITS Sensors Page...................................................................................................................................... 14
Sensors .................................................................................................................................................... 15
4
Adding New Sensors ............................................................................................................................... 15
Wiring Information for the Lufft WS600 UMB .................................................................................... 16
Modem Page ........................................................................................................................................... 17
PPP peer port Step 1 ........................................................................................................................ 18
Modem Provisioning Step 2 ................................................................................................................ 18
PPP Chat Script Step 3 ......................................................................................................................... 18
PPPo Adapters Step 4 .......................................................................................................................... 18
Perform Manual PPP Connection Step 5 ............................................................................................ 19
Show Addresses and Routing Step 6 ................................................................................................... 19
Change Default Route Step 7 .............................................................................................................. 19
Command Execution ........................................................................................................................... 19
Scripts Page ............................................................................................................................................. 19
Creating Scripts ....................................................................................................................................... 20
Weather Page ............................................................................................................................................. 21
Weather Data View ................................................................................................................................. 22
Air Temperature Chart ........................................................................................................................ 22
Dew Point Temperature Chart ............................................................................................................ 22
Relative Humidity Chart ...................................................................................................................... 23
Absolute Air Pressure Chart ................................................................................................................ 23
Wind Speed Chart ............................................................................................................................... 23
Wind Direction Chart .......................................................................................................................... 24
Precipitation Type Chart ..................................................................................................................... 24
Precipitation Intensity Chart ............................................................................................................... 24
VX-21 Status Chart .............................................................................................................................. 25
VX-21 Surface Temperature Chart ...................................................................................................... 25
VX-21 Sub Surface Temperature Chart ............................................................................................... 26
5
Overview
The Connect: ITS is a controller that provides connectivity and data collection services for various
ITS/weather sensors. The Connect communicates via TCP/IP over NTCIP, HTTP, and Representational
State Transfer (REST) protocols. The Connect includes a built in web based configuration and
management GUI as well as support for running multiple user created Python scripts that can be used
for automation of device control or data logging. The Connect also includes a built in Verizon Skywire
modem that provides cellular connectivity and GPS location.
Sensors that the Connect: ITS can be integrated with:
• Lufft WS600 UMB All in One Atmospheric Sensor
• Lufft NIRS31 UMB Non Evasive Pavement Sensor
• Lufft VS2K UMB Visual Distance Sensor
• MH Corbin VXMS Radio VX-21 Monitor Radio
• Vaisala DSC11 Non Evasive Pavement Sensor
• Wavetronix HD Radar Traffic Sensor
The Connect can also be configured for additional sensors if they support one of the following
communication types:
• RS/485
• USB
• RS/232
• Ethernet
• GPIO
The low power requirements of the Connect makes it a viable option for solar powered applications.
Installation
Cabinet Installation
Connect: ITS comes configured for a 19 “rack mount cabinet installation. The Connect: ITS enclosure is
10.5” D X 3.5”H X 19” W, and it weights approximately 10lbs. Four rack mount screws can secure the
enclosure into the rack through four mounting holes located on the front panel.
Power Hook Up
Power is supplied through a 12VDC 2.5-amp power supply, or from a 12VDC battery array. Power is
provided to the power connector located on the back of the Connect: ITS enclosure.
6
Indicator and Connectors
Front Panel LEDs
PWR – Lights green when the unit is receiving power from the backplane. SBC – Lights green when the internal Computer has powered up. HDD – Flashes green during disk activity HBT – Flashes green when unit is operating normally. If the light stops flashing, an error has occurred.
Front Panel and Rear Panel Connectors
Front Panel Connectors
RS485 #1, 2 – Sensor Input connector for sensors that utilize the RS485 serial data connections. RS232 #1, 2 –Connector for RS232 sensors. USB #1, 2 – Connector for USB sensors.
GPIO – 10 General Purpose pins used for analog/digital inputs and outputs.
Cell – Antenna connector for internal cellular modem. GPS – Antenna connector for internal cellular GPS. VX – Antenna connector for 915Mhz internal radio. Display Button – This button allows user to cycle through pertinent system information such as: IP address, IP Mode, CPU Temp (C), Firmware Version.
Rear Panel Connectors
• Power Jack – 12VDC Power Input (12VDC 2.5-amp) size 2.1mm X 5.5mm.
• Fuse Holder – 2.5-amp Slow Blow fuse.
7
Connect:ITS Administration
Connecting to the Connect:ITS
After booting up, the Connect: ITS will display its current IP address on the LCD screen. You can then use
a laptop/web browser to connect to the unit’s web interface as follows:
Connect your laptop to the Connect: ITS Ethernet port (on the faceplate) using an Ethernet patch cable. Ensure that the laptop is set to use a static IP which is in the same Subnet as the Connect: ITS’s current IP address (obtained from front panel LCD display). Open a web browser and navigate to the Connect: ITS URL using the following format:
http://{ipaddress}
If successful, you will be presented with the Connect: ITS login page. Click on the Login link:
Enter the “control” username and password:
After a successful login, the main page is displayed, and various features can be accessed via a two tier
menu system. The top level menu has two tabs, labeled CONTROL and SETUP:
NOTE: Both the CONTROL and SETUP tabs are protected and each has its own username and password.
8
The 2nd tier menu allows access to the features selected on the top tier menu. In the above example,
the CONTROL tab is selected which includes the WEATHER and V2I feature pages.
Control Page The default CONTROL page shows the system status:
The digital outputs of the Connect:ITS can be toggled on or off using the buttons in the right column.
Setup Page Setup page allows users to enter configuration information for Connect: ITS.
- Click on the Setup toolbar button:
- Enter the “setup” username and password:
Location: Enter a location, description, or name to identify this Connect: ITS unit.
9
Ping Remote Host: By entering a valid IP address of a host machine you can ensure that a connection between that host
and the Connect:ITS is able to ping properly.
Configure Weather Data Polling: This entry allows users to set the polling frequency (in seconds) for data collection from the weather
sensors. Additionally, users can specify how much historic data (in hours) is to be stored by the unit.
SNMP and NTCIP Parameters: These entries store parameters for SNMP and NTCIP such as:
- Community Name:
- Write Community Name:
- NTCIP Port:
Reboot Button A soft reboot can be accomplished by clicking the Reboot Now button.
System Info System information such as CPU Temp (C), Kernel Release, and Uptime can be viewed here.
10
Factory Reset The Connect: ITS can be reset to factory defaults by clicking this button. All configuration settings will be
reloaded with factory defaults and the unit will reboot. Note that the default IP address and network
settings may need to be restored after the reboot.
IP page The Connect: ITS supports two IPv4 network ports through DHCP and Static addressing. From the
factory, the unit comes with a static IP configured.
Dual NICs and Bridged Mode
Only the primary NIC interface settings will be shown by default. To show settings for the 2nd NIC, check
the Enable dual NIC mode and press the SUBMIT button. It may take up to a minute to refresh the
page, which will then show the 2nd NIC adapter settings box:
11
If using the 2nd NIC adapter, it can be bridged with the primary NIC to allow pass-through IP for a 2nd
device, such as an IP camera. This would allow up to two IP devices to be connected to a modem
without the need for an additional switch.
12
DHCP To allow a host system to assign an IP address automatically select the Assign automatically with DHCP
radio button.
Static IP To assign a static IP address to Connect: ITS fill in the IP, Network mask, Broadcast, and Gateway fields
with valid IP information.
- Choose DHCP or static addressing and click Submit - Wait a few minutes until the address change completes - Enter the new IP range into the laptop if necessary (network adapter settings on laptop or
computer) - Restart the web browser with the new IP address
Logging Page The logging form displays a page of the most recent entries in the system log. The types of log entries
recorded to the log, either DEBUG or INFO, can be modified by changing the dropdown at the top of the
form:
NOTE: Important information about
the Connect: ITS system is located at
the bottom of each page such as:
MAC Address, Firmware Version,
Refresh Date Stamp
13
The changes made on this form only affect log entries going forward. Any log data already collected
under the previous setting - and being displayed – remains as it was with the original setting.
Logging data has the following format:
{date} {time} [module] {type} {message} where:
{date} is the date of the log entry in YYYY-MM-DD format
{time} is the 24-hour time of the log entry in HHMM:SS,ms format
{module} is the name of the module where the log entry originated from
{type} is the log entry type – either DEBUG or INFO
{message} is the log message
Log data is displayed for the current day only. Log files are rotated at the end of each day and are kept
for up to 7 days on the Connect: ITS (or as space allows).
All date and time values displayed in the log data are based on the time zone settings for the Connect:
ITS unit.
Info Log Info Log captures logged information concerning the unit and its normal operation. An example of the
type of information that is logged is below.
Debug Log Any errors that the system may have will be logged here in the Debug log file. This information is
important for troubleshooting issues that may arise. A MH Corbin technical support personnel may have
you select debug mode and copy the log file and send it to them for troubleshooting purposes.
14
Password Page Use this form if you want to change the default passwords for the Control and Setup page. MHC
recommends that you change the passwords since the default passwords are published.
Firmware Page This section allows users to install firmware updates on the Connect: ITS. Once the new firmware image
has been selected, the SUBMIT button will load the new image and reboot the Connect: ITS.
Firmware updates should only be installed under the direction of MH Corbin technical support personnel.
Units & Time Page The Units and Time form allows users to change the units of measure for recording data, including the
time zone to use for log entries:
ITS Sensors Page This section allows users to setup various ITS sensors so that the Connect can communicate with them
for collecting data.
Default passwords
are:
Login:
username: control
password: control
Setup:
username: setup
password: setup
15
Sensors Connect: ITS can be configured for a variety of different sensors. The following sensors are presently
supported by the firmware, but it is possible to use additional sensors:
• Lufft WS600 UMB -- All-in-One Atmospheric Sensor
• Lufft NIRS31 UMB-- Non-Invasive Pavement Sensor
• Lufft VS2K UMB -- Visibility Sensor
• MH Corbin VX21-- VX-21 Wireless Pavement Sensor
• Vaisala DSC11-- Non-Invasive Pavement Sensor
• Wavetronix HD-- Radar Traffic Sensor
Sensors are setup on the SETUP|ITS SENSORS tab:
The Polling Interval is used as the data collection interval for all configured sensors. If this value is set to
zero, data collection is disabled. Typical values are 600 (which is 10 minutes).
The History entry indicates how much sensor data to hold onto before the data is erased. A value of 24
indicates to hold one day’s worth of collected sensor data.
Adding New Sensors Initially no configured sensors will be shown.
The Connect:ITS will identify all USB, RS485, and serial ports and assign each port a uniquely generated
alpha-numeric port name. These names will appear in the Port dropdown list box.
16
Identifying the correct port name of a new sensor may require some trial and error, since the port
names do not correspond to the labels on the faceplate of the Connect:ITS unit. The procedure outlined
below will describe how to identify the correct port name to use for a new sensor:
1) Plug the sensor into one of the ports on the faceplate of the Connect:ITS (USB, RS485, or serial
port)
2) Power the sensor up
3) Select the sensor type using the Type dropdown
4) Select a Port to use for this sensor:
a. Ports with names containing USB are used for either a USB connection or for a RS485
connection.
b. Ports that have names containing the word Modem are not used for sensors, so
normally these should not be selected.
c. Ports with names ending in ttySx are typically RS232 (serial) ports.
5) Enter the Device ID of the sensor. Typically, this can be found by examining the sensor’s
software configuration. Not all sensors require this value, but if the sensor does require an ID
assignment and this field is set incorrectly, the Connect:ITS will not be able to communicate with
the sensor and data will not be polled.
6) Enter a description for the sensor.
7) Press the ADD button to add the sensor. You will see the sensor appear in the Configured
Sensor list.
8) Set the Polling Interval to 10, and press the SUBMIT. Wait 10 seconds for polling to start.
9) Click on the CONTROL tab and find the ITS Sensor Status field. If you see Sensor polling failure,
the Connect:ITS is not able to communicate with the sensor. It is possible that the wrong port is
selected. Go back to the SETUP|ITS SENSORS page and select a different port and repeat the
process starting at step 4.
10) If all ports have been tried, it is possible that the Device ID being used is incorrect.
Some sensors share a port, such as the MH Corbin VX sensor. In these cases, the same port can be
assigned to multiple sensors, but typically the port assignment is for a single sensor, ie one-to-one.
Wiring Information for the Lufft WS600 UMB
The Lufft WS600 Sensor utilizes the RS485 port for interfacing with the Connect: ITS system. Either the
RS485 #1 or #2 connector can be used, which are located on the front panel:
17
Use the following images to wire the Lufft WS600 cable to the Connect:ITS RS485 port.
- White – Ground.
- Green – RS485 A
- Yellow – RS485 B
- Brown –Power to the sensor 12 VDC
Warning: The heating voltage (red = positive heating voltage; blue = heating voltage ground) is not
connected to the Connect:ITS faceplate port, but wired direct to a separate power supply unit.
These wires are not required to be hooked up if you do not want to utilize the internal heater of the
WS600.
Modem Page An internal modem is integrated into the Connect: ITS system which can provide the Connect: ITS with
data access without the need to purchase an additional equipment. The modem is setup for operation
by clicking on the Modem tab:
18
PPP peer port Step 1 NOTE: You only need to change this setting if the modem port has changed since factory setup. To setup
just select the serial port the modem is using.
Modem Provisioning Step 2 Select the modem type supplied with the Connect: ITS and click the Submit button. The modem will be
provisioned OTASP (Over The Air). NOTE: The modem needs to have IMEI and be activated by Verizon.
This step only needs to be completed if the modem has not been provisioned before or if the modem has
been replaced. A data plan associated with the SIM card IMEI needs to setup prior to completing this
step.
PPP Chat Script Step 3 Use the same selection here as was used in step #1.
PPPo Adapters Step 4 This sets the network adapter for the modem.
19
Perform Manual PPP Connection Step 5 This connects or disconnects the Modem through PPP to the cellular network.
Show Addresses and Routing Step 6 If you select Show it will show all the IP addresses that are assigned to the modem.
Change Default Route Step 7 Select either modem or Ethernet as the default route for devices connected to the Ethernet through the
Connect: ITS external Ethernet ports.
Command Execution This field allows users to execute a Linux command on the Connect: ITS system. For example, if you type
in ls -l you get a listing of everything in the root directory. This is for troubleshooting purposes and only
use this when directed by MH Corbin Personal.
Scripts Page NOTE: Scripts are an advanced feature of the Connect:ITS and require software development skills and a
programming background.
20
The Connect:ITS supports the execution of user generated Python scripts which can automate tasks
based upon the data from various sensors. These scripts have the capability to turn on beacons or put a
message on a message sign. The example below is the Python script to send an e-mail.
import smtplib from email.mime.text import MIMEText class Email: mail_server = 'smtp-host.email.com' mail_port = 587 mail_user = 'email-user-name-goes-here' mail_password = 'password-goes-here' def __init__(self, logger): self.logger = logger def send(self, mail_to, mail_from, subject, body): #self.logger.info('to: ' + mail_to); self.logger.info('subject: ' + subject); self.logger.info('body: ' + body); msg = MIMEText(body); msg['Subject'] = subject msg['From'] = mail_from msg['To'] = ", ".join(mail_to) try: s = smtplib.SMTP(self.mail_server, self.mail_port) s.login(self.mail_user, self.mail_password) s.sendmail(mail_from, mail_to, msg.as_string()) s.quit() except requests.exceptions.Exception as e: self.logger.error(e)
Creating Scripts Connect:ITS supports an editor window that can be used to write scripts directly, or scripts can be
imported using file uploads or cut/copy and paste.
Existing Scripts are shown in a table:
To enable a particular script, click the radio button next to the script you want to enable, then Click
Start.
21
To stop a script from running simply Click Stop,
The Disable button will stop the script from being executed automatically.
To remove a script click the Remove button.
Clicking the Code link located next to the name of the script will load the script into the editor window
at the bottom of the form, where changes can be made and later saved.
Weather Page RWIS Data can be viewed on the Weather page link from the tool bar. At the top of the Weather page a
chart will display all the real-time data from the connected weather sensors, along with real time data
from any connected VX-21 sensors.
22
Weather Data View Data from the Lufft WS600 will be displayed in charts. Data such as: Air Temperature, Dewpoint
Temperature, Relative Humidity, etc. Examples are below.
Air Temperature Chart
Dew Point Temperature Chart
23
Relative Humidity Chart
Absolute Air Pressure Chart
Wind Speed Chart
24
Wind Direction Chart
Precipitation Type Chart
Precipitation Intensity Chart
25
VX-21 Status Chart
VX-21 Surface Temperature Chart