Java library for connecting to Emerson Einstein 2 Enhanced controllers. (Abbreviation: E2e)The goal of this library is to provide access to controller data by using the E2e's "FSD Client Port".This library is not based around any official Emerson API documentation.
Repository:
<repositories><repository><id>jitpack.io</id><url>https://jitpack.io</url></repository></repositories>
Dependency:
<dependency><groupId>com.github.JustBru00</groupId><artifactId>E2e4J</artifactId><version>0.1.0</version><!-- Use version "master-SNAPSHOT" for the latest snapshot.--></dependency>
The main class you will be dealing with is theE2e class.
E2ee2e =newE2e("192.168.0.26");This will create a new instance of theE2e class that is ready to connect to a E2e controller at 192.168.0.26:14106.The constructor of theE2e class is blocking because we need to contact the E2e to get the controller name.This controller name is important when constructing data pointers for the E2e.If the E2e you are connecting to uses a different "FSD Client Port", you can set a custom port using the following code:
E2ee2e =newE2e("192.168.0.26","CUSTOM_PORT_NUMBER_HERE");Next, lets get the current status of theCONTROL TEMP value on two different standard circuit applications.In this example the two standard circuit applications are named1 S FRZR EVAP and2 N FRZR EVAP.
ArrayList<String>pointers =newArrayList<String>();pointers.add("1 S FRZR EVAP:CONTROL TEMP");pointers.add("2 N FRZR EVAP:CONTROL TEMP");try {Optional<MultiExpandedStatus>multiExpanded =e2e.getMultiExpandedStatus(pointers);if (multiExpanded.isPresent()) {for (ExpandedStatuses :multiExpanded.get().getExpandedStatuses()) {System.out.println(es.toString());}}else {System.out.println("Optional was empty.");}}catch (UnirestExceptione) {e.printStackTrace();System.out.println("Exception occured while attempting to get the multi expanded status.");}TheExpandedStatus class stores the information returned by the E2e. I have an example output of the data returned below:
ExpandedStatus [pointer=EINSTEIN:1 S FRZR EVAP:CONTROL TEMP, value=66.30, alarm=false, notice=false, fail=false, override=true, overrideTime=78:16:51, overrideType=0, engineeringUnits=DF, dataType=1, bypassTime=]ExpandedStatus [pointer=EINSTEIN:2 N FRZR EVAP:CONTROL TEMP, value=67.40, alarm=false, notice=false, fail=false, override=true, overrideTime=0:00:00, overrideType=0, engineeringUnits=DF, dataType=1, bypassTime=]
Notice that thepointer variable now has the controller name as a prefix. This is why the E2e class blocks to retrieve the controller name.
This shows the most basic application of this library, retrieving the current temperature from a standard circuit application.
E2e4J - A Java library for connecting with Emerson Einstein 2 Enhanced controllers. Copyright (C) 2024 Rufus Brubaker Refrigeration This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with this program. If not, see <https://www.gnu.org/licenses/> You can contact us at rbr@rbrubaker.com.
