How to Create New Hardware Integrations With Galooli?

Owned by arkadi kaplon
Last updated: 02.12.24
5 min read

In certain instances, customers express interest in integrating a new device into Galooli's systems, aiming to establish it as a standard component. This integration is a collaborative effort between the client and Galooli, ensuring the seamless functionality and synchronization of the device with Galooli systems by following to the detailed instructions provided in this document.

If the hardware in question supports one of the common communication protocols that Galooli supports, the customer can complete the integration independently and start collecting supported parameters.

In case one of the following is required as part of the integration, Galooli will have to be included in the integration process:

  • Device name to show in the system display.

  • Get the new integration as one of the power center defaults.

  • New parameters that are not supported by Galooli.

  • Device Alarms

  • X-Ray

In such cases, the customer will submit the integration request to his account manager in Galooli.

Galooli will analyze the integration request and reply to the customer if the request is accepted.

Pre Integration Required Data

If the hardware in question supports one of the common communication protocols that Galooli supports like, RS485, Ethernet, Modbus, Modbus over TCP, SNMP, please gather the following data:

  • Device Type (e.g. Rectifier, Generator panel, etc.)

  • Brand (e.g. Delta, Eltek, DSE, Cummins)

  • Model (e.g. Orion, SmartPack, DSE 7320, PCC1302)

  • Technical Manual: A detailed guide for the specific model is required to understand how to configure the device for integration with our system.

  • Communication Protocol/MIB File: Depending on the integration type, ensure the appropriate files are available.

  • Register/OID List vs. Existing System Fields: Provide a clear mapping of registers or OIDs to the fields already present in our system. If needed, please reach out to your Galooli contact person.

    • Include scaling factors (if applicable).

    • Alarms list

    • List parameters needed for X-Ray depending on the integration type.

    • This section is also applicable for requests to update an existing integration. In such cases, all items remain valid except for providing documentation, which should already exist from the initial integration phase.

Configuration Process

The configuration process varies depending on the protocol type. Below, we will provide details about the different types of protocols and the way to configure the devices.

  1. Ensure the device is connected to the gateway and the gateway is connected to your computer

  2. Download the Galooli Power Center platform and login

  3. Configure the new device in the Power Center according to the below:

Modbus & Modbus over TCP Protocols

  • For the Modbus & Modbus over TCP Protocols, add a serial device (Modbus) or Modbus ETH (Modbus over TCP) and then select the appropriate device.

  • For “Modbus” update the Physical Device ID, Virtual Device ID, Device Baudrate as needed.
    For “Modbus over TCP” update the Physical Device ID, Virtual Device ID, and Device IP and the Device Port as needed.

  • Finally, click Apply to save the changes.

Modbus

Modbus over TCP

Modbus

Modbus over TCP

image-20241128-124002.png
image-20241128-121552.png

  • Navigate to the Configuration tab, double-click on the existing device, select the ID line, and then click Add Item.

  • The wizard will guide you through selecting the Assignment and configuring its parameters.

    Add the first assignment, complete the parameters using the device's technical specification manual, and click Apply to save the changes.

“SNMP” Protocol

  • For the SNMP protocol, add the “SNMP ETH” device and then select the appropriate device. Update the Device ID and the Virtual Device ID as needed.

  • Finally, click Apply to save the changes.

  • Navigate to the Configuration tab, double-click on the existing device, select the ID line, and then click Add Item.

  • The wizard will guide you through selecting the Assignment and configuring its parameters. Add the first assignment, complete the parameters using the device's technical specification manual, and click Apply to save the changes.

The next steps apply equally to all protocols.

  • 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".