How to Create New Hardware Integrations?
In certain instances, customers express their interest in seamlessly integrating a new hardware product into the Galooli systems, aiming to establish it as a standard component. This integration journey is a collaborative effort between the client and Galooli. Emphasizing the importance of precision, our joint efforts are dedicated to ensuring the seamless functionality and synchronization of the product with Galooli systems, following the detailed instructions outlined in this document.
Client Part
To achieve seamless integration with your new hardware product, please gather all relevant data regarding the hardware and perform the following actions in the Galooli system.
Galooli currently supports the following communication methods and protocols:
RS485, Ethernet
Modbus, Modbus over TCP, SNMP
In case your hardware product supports the communication methods and protocols listed bellow continue to step 1.
In the event that the communication method or protocol is different from those described above, please open a support ticket with Galooli. Upon receiving an answer from Galooli, you may proceed with the process.
Please ensure that the Elara gateway and the new device are in the office.
Ensure that the new device is connected to your computer.
According to the product protocol, the following steps should be taken:
“Modbus” protocol - The Physical Device ID should be configured using the manual guideline that came with the device. Keep a record of the Physical Device ID so you can use it later.
“Modbus over TCP” protocol - The Device IP address should be configured within the same range as this of the Galooli gateway using the manual instructions provided with the device. For example Elara IP is 192.168.100.101 by default. Keep a record of the Device IP Address so you can use it later.
“SNMP” protocol - The Device IP address should be configured within the same range as this of the Galooli gateway using the manual instructions provided with the device. For example Elara IP is 192.168.100.101 by default. Keep a record of the Device IP Address so you can use it later.
Disconnect the device from the computer.
Download the Galooli Power Center platform.
Assemble the Elara gateway and connect it to a power source and your computer.
Connect the the new device to the Elara gateway.
Open the Power Center and make a serial connection to the Elara gateway.
Configure the new device in the Power Center:
We will now demonstrate an example on how to integrate a new generator panel (RS485-Modbus).
Depending on the device communication method/protocol, select the appropriate method of adding the device to the Power Center:
RS485-Modbus → “Add Port 1 Device”
Ethernet-Modbus over TCP → “Add MODBUS ETH Device”
Ethernet-SNMP → “Add SNMP ETH Device”
Â
Select the appropriate device >> change the "Physical Device ID" to the device ID you specified in the previous paragraph (Paragraph 3). Click “Apply”.
Click "Write configuration", wait until the process is complete, and then click "Reset".
Â
Choose the "Configuration" tab, double click on the existing device, click on the “Port” line and click on “Add item”.
The following wizard will allow you to choose the “Assignment” and specify the different parameters for that assignment. Listed below are Galooli's recommendations for the required assignments.
Add the first assignment, fill in the parameters using the technical specification manual that came with the device, and apply the changes.Click "Write configuration", wait until the process is complete, and then click "Reset".
Â
Click on the "Status" tab, open the relevant device option, and compare the Power Center value of the assignment you added in the previous step with the actual value. Thus, you will be able to verify the accuracy of the readings in Power Center.
Â
Repeat the process for each assignment separately. After each new assignment is added, be sure to click "Write configuration", wait until the process has been completed, and then click "Reset". For each new assignment , make sure to verify the receiving of data each time.
Ensure that all relevant alarms are listed, as well as any remote control parameters. The technical specifications/datasheet of the product contains all the relevant information. You may need to contact the manufacturer if necessary. Apply the changes to complete the process.
Click "Write configuration", wait until the process is complete, and then click "Reset".
The configuration that you have made must be saved by clicking on "Save As", which will create a GIB file that is required for the next steps.
Â
Submit a support ticket through the Galooli solution to the Galooli support team. The ticket should contain the following information:
Describe your request for the creation of a new default integration with a new hardware product
Provide the full name, model, and method of communication of the product
Let Galooli know what hours and days the unit will be connected to a power source and the network so that they may conduct their own tests
Upload the GIB file
Include all technical documents related to the product
Galooli Recommended Assignments
Using Galooli's recommended assignments requires finding the appropriate protocol, locating the assignments, and returning to the last paragraph you reviewed.
Modbus | Modbus Over TCP | SNMP |
---|---|---|
Engine_Hours | Battery_Voltage | Total_Output_KWH |
Grid_Voltage_Phase_1/2/3 | Battery_Current | Solar_KWH |
Battery_Voltage | Battery_SOC_Percentage | Solar_W |
Engine_Speed | Balancing_Percentage | Voltage |
Frequency | Status | Current |
Voltage_Phase_1/2/3 | Cells_Count | Battery_Current |
Current_Phase_1/2/3 | Internal_Resistance | Battery_SOC_Percentage |
Coolant_Temperature | Temperature_1 | Battery_Temperature |
Oil_Pressure | Cells_Group_1 | Solar_X_Voltage |
Working_Mode | Â | Solar_X_Current |
Total_Output_KWH | Â | Rectifier_Current |
Â