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.

  1. Please ensure that the Elara gateway and the new device are in the office.

  2. Ensure that the new device is connected to your computer.

  3. 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.

  4. Disconnect the device from the computer.

  5. Download the Galooli Power Center platform.

  6. Assemble the Elara gateway and connect it to a power source and your computer.

  7. Connect the the new device to the Elara gateway.

  8. Open the Power Center and make a serial connection to the Elara gateway.

  9. 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

      image-20240212-125717.png

       

  • Select the appropriate device >> change the "Physical Device ID" to the device ID you specified in the previous paragraph (Paragraph 3). Click “Apply”.

image-20240212-125849.png
  • 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".

  1. 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.

 

  1. Submit a support ticket through the Galooli solution to the Galooli support team. The ticket should contain the following information:

    1. Describe your request for the creation of a new default integration with a new hardware product

    2. Provide the full name, model, and method of communication of the product

    3. 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

    4. Upload the GIB file

    5. 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

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