EDR Overview: Difference between revisions

From EMIT Controls
(Created page with "== Overview == The EDR has a configuration and status page that can be viewed using a phone or computer by connecting to the device over WiFi. This console generally is used on installation to make sure data is collected correctly, or for debugging. == EDR Config Tool == The EDR (EMIT Data Relay) is configured by editing a series of three Excel tables, which are uploaded through the wifi console (see https://forum.emittechnologies.com/knowledgebase/articles/1980972-edr-...")
 
 
(24 intermediate revisions by 2 users not shown)
Line 1: Line 1:
== Overview ==
See the bottom part of this page for a general overview, or the articles below for specific topics.
The EDR has a configuration and status page that can be viewed using a phone or computer by connecting to the device over WiFi. This console generally is used on installation to make sure data is collected correctly, or for debugging.


== EDR Config Tool ==
==EDR Documents and Guides==
The EDR (EMIT Data Relay) is configured by editing a series of three Excel tables, which are uploaded through the wifi console (see https://forum.emittechnologies.com/knowledgebase/articles/1980972-edr-field-configuration ). Alternately, the EDR Config program can be used to create the three tables more quickly.


=== Downloading Program ===
=== Main Guides ===
The program can be downloaded here: https://drive.google.com/file/d/1CbfNI8BfQtF0PlDO-t_-Uj2eRFd18c8S/view?usp=sharing


After downloading, unzip into some location. The program is run by going to the folder program and running the file EDR_Config_Tool_4.exe . (For convenience you can make a shortcut to this program right clicking and going to "Send to"-> "Desktop" (create shortcut) )
[[EDR Manual]]


When you first run the program it may ask to download and install some support libraries from Microsoft.
[[EDR Wi-Fi Console]]


Using Program
[[EDR Installation Guide]]


When you start the program, it will ask to choose a panel type. Choose the type that matches the panel.
[[EDR Troubleshooting Guide]]


<nowiki>*</nowiki>Insert Image*
=== Minor Topics ===


After choosing a type, it will ask to enter the channel list or shutdown code list. This is found on the panel itself, the panel drawing, or sometimes other documents.
[[Default Panel Settings for EDRs]]


<nowiki>*</nowiki>Insert Image*
[[EDR Software Update]]


''DD40 example-  entering the input list''
[[EDR Field Configuration]]


The 'value' column can't be changed, if a value is not used it can be left alone.
[[EDR Config Tool]]


Some types of panels will require an input link where certain tags (e.g. Suction pressures) are matched to a channel number. If this is needed, follow the instructions on the screen.
[[EDR Internal EDT Update]]


After everything is ready a box will appear for creating the files. The button here can be selected to navigate to a location to save the files, then those files can later be used to apply the config through the EDR wifi console.
[[Connecting EDR to EIM with Ethernet]]


Tip: Put new configs in a folder that is named in a way that identifies the unit and/or drawing number. This will prevent accidentally mixing up files.
[[CAN Terminations With CAT Panel]]


== Field Configuration ==
[[EDR Port Timings]]
Video for this topic: https://www.youtube.com/watch?v=y2lrFy0ITbQ


Generally EMIT will send out the EDR already configured to communicate via Modbus to a specific panel. If the module is not configured, the guides below detail how to configure the module for a type of panel.
[[EDR to 20240 Connection]]


Configuring for DE3000 Panel: https://drive.google.com/file/d/1dyrNdjfzIoRU_jQudMkycjfdVLv5qpE9/view?usp=sharing
[[EDR Loopback Test]]


Configuring for DD40 Panel: https://drive.google.com/file/d/1ezXo-FjjVbN7KEMYP_QOT_bAh-wFuItK/view?usp=sharing
== EDR Overview ==


Configuring for TTD Panel: https://drive.google.com/file/d/1T3Swgi9AEfIZVWNaiK0IRWOVD0lQ8qfm/view?usp=sharing
=== Hardware and System Overview ===


Configuring for Centurion C4 Panel: https://drive.google.com/file/d/1HymMxYioAVNnu5k8kos7s0r-imrJR0Am/view?usp=sharing
The EMIT Data Relay (EDR) is a module for interfacing non-EMIT control system data to EMIT’s telematics platform. Non-EMIT systems include popular compressor control annunciators and engine control units. The EDR connects to these systems via MODBUS and propriety protocols, organizes the data, and transmits the data via cellular modem to a customer facing database for remote observation.


== Installation Guides ==
'''Power'''
There are install guides for different types of panels that shows the specific details for that type. The currently available install guide links are below.


New combined document: https://drive.google.com/file/d/1TUEDAemMng3xTDCwqNSy16d1HOJxVciA/view?usp=sharing
*12 – 30VDC power supply input range
*Maximum power consumption: 30W


Murphy TTD: https://drive.google.com/file/d/1HAgyOSzoLrYLllkaGtimA7d615ya94mX/view?usp=sharing
'''Environmental'''


Murphy Centurion C4: https://drive.google.com/file/d/1tuuhHGA9hmNi1F7u8UZXB_T4W_WQ0ZDw/view?usp=sharing
*Temperature: -40°C to +65°C (-40°F to 149°F) T4
*Humidity: 5% - 90%, non-condensing


Altronic DD40: https://drive.google.com/file/d/19JtSU3lCrNTc7ImUOF3COnTjD202lT8K/view?usp=sharing
'''Communication'''


Altronic DE3000: https://drive.google.com/file/d/1Vr13MZFmAYcYUXR2m1OtI8qCx5ZwBlM6/view?usp=sharing
*USB host for future use
*RS-485 half-duplex MODBUS RTU Master for panel annunciator communication
*RS-485 half-duplex MODBUS RTU Slave for spare or expansion
*Ethernet port for Modbus/TCP access, both master and slave
*ECU J1708 and ECU CAN for Caterpillar ADEM access
*Wi-Fi Antenna for local wireless access to unit information
*Cell module for remote data collection and callouts
*GPS for location service & accurate time


EMIT EIM (ETS): https://drive.google.com/file/d/1kl9VpiL9J_T9oSIxmK3vCQONw2cDAIAM/view?usp=sharing
=== General System Concepts ===


== Internal EDT Update ==
In the most typical use case, the Data Relay acts as a “Modbus Master” to a non-EMIT panel system. Using some defined data tables, the Data Relay will request data values such as suction pressure, oil temp, etc., from the panel system via RS-485 Modbus or Modbus/TCP.
The EDR has an internal EDT that is updated separately from the EDR itself. It is uncommon that it needs to be updated, but if it does follow these steps.


1. Download the latest EDT_xxxx.hex file from this page
[[File:Edr-concept-diagram.png]]


2. Put the file on a USB drive
Each Modbus data value is configured by specifying a target Register and Slave ID of the source of the information (typically the panel annunciator). For example, the suction pressure might be present at Slave ID 10, Register 41001. The Data Relay will request for Register 41001 from Slave ID 10, the annunciator will respond with the data, and the Data Relay will store this response as “Suction Pressure”.


3. Remove the cover of the EDR by loosening the screws on one of the end caps
This data is accumulated into standard blocks of information and then sent to EMIT Data Services via cell connection. This also includes run status information for the purposes of sending callouts. Additionally, the Data Relay will collect engine data from an engine control unit, such as Caterpillar ADEM ®, which will also be sent to the server.


4. Locate the USB port near the power switch that was previously hidden
Separately, the Data Relay can operate as a Modbus Slave device. In this scenario, another SCADA system uses the Data Relay only for engine data translation.


<nowiki>*</nowiki>Insert Image*
===Wiring===


''USB port location''
A general wiring diagram of all possible connections is shown below. In most cases some subset of these connections will be used.


5. Turn power off and back on (or if already off, turn on)
[[File:Edr-wiring-full.png]]


6. Wait about 60 seconds for the update to complete. If you connect to the EDR wifi console, the new version number should show up under the debug tab
===Configuration===


7. Remove USB and replace cover
There are three spreadsheet files that define how an EDR communicates with another panel. These are called the modbus master table, the run status table, and the fault code (or shutdown code) table.


== Troubleshooting Guide ==
These three files can be saved and loaded to different EDRs when the panels are the same.
This document covers troubleshooting steps for various EDR issues:


https://drive.google.com/file/d/1-gnsQWNj71XOUQYHcC5wN2dpd5X-1Hr6/view?usp=sharing
Creating a new configuration is described in the page [[EDR Field Configuration]]


== Connecting ==
Additionally parts of the tables can be edited through the wifi console. See [[EDR Wi-Fi Console]]
Check your target device’s Wi-Fi settings for a network called “EDR_xxxx”, where xxxx is the serial number of the Data Relay. Connect to this network and enter the password ‘emitemit’.
 
Note: There will be no internet access while you are connected to the network. It is recommended that you turn auto reconnect off.
 
Once connected, open a web browser and type <nowiki>http://172.16.16.1/</nowiki> . This will bring up the Data Relay console.
 
<nowiki>*</nowiki>Insert Image*
 
= Wi-Fi Console Pages =
From the top right menu on a phone, or along the top on a computer, there will be the following page categories: Status, Compressor Master, Alerts, Engine Data Translator, Modbus Slave, and Debug. Each of these 6 pages are detailed below.
 
=== Status ===
The Status page shows the current readings for engine and compressor data. Settings cannot be edited on this page. Also shown under “General” is the serial number and software version.
 
<nowiki>*</nowiki>Insert Images*
 
The Modbus master data will show the latest values read from the annunciator, and when the value was last read. Normally values are polled every 10 seconds, but this may vary by software version.
 
The engine data section of General Status will show any collected data from the engine data translator.
 
== Compressor Master ==
The Compressor Master page is used for viewing and changing information related to the Modbus master table. Sections are:
 
Modbus Master Table
 
Under this heading is shown the full master table and raw values read.
 
<nowiki>*</nowiki>Insert Image*
 
In the above screenshot, Engine speed is being pulled from Register 41003, ID 10. The value is being read as “0” successfully, because the age is 7s.
 
Some values will have a ‘Never’ value for the Age because they have not yet been successfully read. In some cases, the value is never even expected because the register is “0”- For example, “Manifold Pressure Right” on a single bank unit will never be seen. If an expected value is missing, it can be debugged from this table.
 
The table can be edited on this page by selecting a cell and changing the value.
 
=== Modbus Master Table File ===
The next heading on this page is “Modbus Master Table File”, where the entire master table can be downloaded or uploaded.
 
<nowiki>*</nowiki>Insert Image*
 
On initial setup, it may be easier to edit the file to get all the registers entered at once rather than edit each row individually over the Wi-Fi console. Also, the download/upload function can be used to use a configuration on another unit.
 
To download the current file, select “Download”. To upload a new file, select “Browse” then “Upload”.
 
=== Network Configuration ===
The network configuration section is used to setup the RS-485 or Ethernet settings to connect to the slave device(s). Select either Serial or Ethernet by selecting a checkbox, then enter the information to match the settings for the device being targeted.
 
=== Network Statistics ===
The network statistics section shows the number of bytes sent and received. This may be useful for debugging.
 
=== Recent Messages ===
This heading shows the latest message sent and received over RS-485. This may be useful for debugging.
 
== Alerts ==
 
=== Current Run Register ===
There is a target register and ID that the Data Relay uses to determine the current run status.
 
The “Current Run Register” heading shows the current reading from that register and how it is decoded using the Run Status Table.
 
Below the current reading/state, the configuration for the target ID/ register for the run status can be adjusted. Normally this should be set up only once.
 
=== Current Fault Register ===
Like the “Current Run Register”, the Current Fault Register section will show the latest reading from the fault register and how it is interpreted.
 
In some cases, the fault code register might not have a valid value if the unit is not actually faulted.
 
The current ID / Register being polled for the fault status can also be edited here if needed.
 
=== Run Status Table ===
The Run Status Table section shows the entire run status table configured. The value/ state type pairs can be adjusted here if needed. When the Data Relay reads the run status register, it will use this table to interpret the current state of the annunciator.
 
=== Fault Code Table ===
Under the Fault Code Table section, the entire fault code table is shown. The table can be edited or expanded here if needed.
 
=== Table Configuration Files ===
Under this section, the fault code table or the run status table can be downloaded / uploaded to the computer for editing in Excel ®. This is often the fastest way to set up the tables on initial setup.
 
== Engine Data Translator ==
The Engine Data Translator tab has two sections related to the engine data.
 
=== Engine Data ===
This section will show all currently collected engine data. Any valid information seen on the engine data bus will show up here.
 
=== Configuration ===
Under this section, the engine type can be selected.
 
== Modbus Slave ==
The Modbus Slave tab is used to set up the slave connection of the Data Relay. This is only used if another SCADA needs to pull engine data over Modbus from the Data Relay. This tab has three sections.
 
=== Network Configuration ===
The Network Configuration section is used to configure the serial or IP settings for the Data Relay. The slave ID of the Data Relay itself can also be set here.
 
=== Network Statistics ===
This section shows the bytes sent and received by the RS-485 slave port. This information may be useful for debugging.
 
=== Modbus Table ===
This section has a link to download the Modbus slave table. This table is the same for all devices.
 
== Debug ==
The Debug tab has three sections related to the connection to EMIT Data Services and Debugging.
 
=== Device Config ===
This section shows the cellular config of the device.
 
The “Service Level” will show 2 or higher if the unit is activated to send remote data to EMIT. The activation is done by calling 307-673-0883 and asking for “Telematics Activation” or emailing [[Mailto:telematics@emittechnologies.com|telematics@emittechnologies.com]] with the board serial number, and the activation is sent over the air. The Unit Number is also pulled from the remote server and can be configured in the portal at <nowiki>https://data.emittechnologies.com/</nowiki> .
 
The “Sync Telematics Config” button is not often used but may be requested by EMIT Tech support. The button will ping the server for the latest service level and Unit. If the Unit number is not correct, try this button.
 
The “Send Test Callout” button can be used to send a test callout to the current callout targets for the unit.
 
=== Connection Information ===
The connection information section shows current Cell connection info. If there is no signal strength or carrier shown here, check the antenna connections. In some cases, a higher antenna may be needed.
 
=== Software Update ===
The software update section is used to upload a software update. Select “Browse” to select a file, then “Update” to start an update. The update process will take about a minute. Software updates will have a file name “EDR_update[…].emt” where the […] varies.

Latest revision as of 21:17, 5 January 2024

See the bottom part of this page for a general overview, or the articles below for specific topics.

EDR Documents and Guides

Main Guides

EDR Manual

EDR Wi-Fi Console

EDR Installation Guide

EDR Troubleshooting Guide

Minor Topics

Default Panel Settings for EDRs

EDR Software Update

EDR Field Configuration

EDR Config Tool

EDR Internal EDT Update

Connecting EDR to EIM with Ethernet

CAN Terminations With CAT Panel

EDR Port Timings

EDR to 20240 Connection

EDR Loopback Test

EDR Overview

Hardware and System Overview

The EMIT Data Relay (EDR) is a module for interfacing non-EMIT control system data to EMIT’s telematics platform. Non-EMIT systems include popular compressor control annunciators and engine control units. The EDR connects to these systems via MODBUS and propriety protocols, organizes the data, and transmits the data via cellular modem to a customer facing database for remote observation.

Power

  • 12 – 30VDC power supply input range
  • Maximum power consumption: 30W

Environmental

  • Temperature: -40°C to +65°C (-40°F to 149°F) T4
  • Humidity: 5% - 90%, non-condensing

Communication

  • USB host for future use
  • RS-485 half-duplex MODBUS RTU Master for panel annunciator communication
  • RS-485 half-duplex MODBUS RTU Slave for spare or expansion
  • Ethernet port for Modbus/TCP access, both master and slave
  • ECU J1708 and ECU CAN for Caterpillar ADEM access
  • Wi-Fi Antenna for local wireless access to unit information
  • Cell module for remote data collection and callouts
  • GPS for location service & accurate time

General System Concepts

In the most typical use case, the Data Relay acts as a “Modbus Master” to a non-EMIT panel system. Using some defined data tables, the Data Relay will request data values such as suction pressure, oil temp, etc., from the panel system via RS-485 Modbus or Modbus/TCP.

Edr-concept-diagram.png

Each Modbus data value is configured by specifying a target Register and Slave ID of the source of the information (typically the panel annunciator). For example, the suction pressure might be present at Slave ID 10, Register 41001. The Data Relay will request for Register 41001 from Slave ID 10, the annunciator will respond with the data, and the Data Relay will store this response as “Suction Pressure”.

This data is accumulated into standard blocks of information and then sent to EMIT Data Services via cell connection. This also includes run status information for the purposes of sending callouts. Additionally, the Data Relay will collect engine data from an engine control unit, such as Caterpillar ADEM ®, which will also be sent to the server.

Separately, the Data Relay can operate as a Modbus Slave device. In this scenario, another SCADA system uses the Data Relay only for engine data translation.

Wiring

A general wiring diagram of all possible connections is shown below. In most cases some subset of these connections will be used.

Edr-wiring-full.png

Configuration

There are three spreadsheet files that define how an EDR communicates with another panel. These are called the modbus master table, the run status table, and the fault code (or shutdown code) table.

These three files can be saved and loaded to different EDRs when the panels are the same.

Creating a new configuration is described in the page EDR Field Configuration

Additionally parts of the tables can be edited through the wifi console. See EDR Wi-Fi Console