In some cases, a customer wishes to integrate a new hardware product that he intends to use into the Galooli systems and make it a defaulted product. New Integration process conducted by the client and Galooli together. In order to ensure that the product works and synchronizes with Galooli systems correctly, it is imperative that the process is completed accurately and according to the instructions attached to this document.
Client Part
It is the client's responsibility to gather all data relevant to the hardware product and carry out the following actions in the Galooli system.
Gather the following data about the hardware product:
Model
Registry or OID’s
Communication method
This information can be found in the product's technical specifications/datasheet. You may need to contact the manufacturer if necessary.
...
Please ensure that the Elara gateway and the new device are in the office.
...
Ensure that the new device is connected to your computer.
...
Set the device ID using the manual guideline that came with the device. Keep a record of the device ID 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.
...
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
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.
| Table of Contents | ||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
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.
Ensure the device is connected to the gateway and the gateway is connected to your computer
Download the Galooli Power Center platform and login
Configure the new device in the Power Center according to the below:
| Info |
|---|
We will now demonstrate an example on how to integrate a new generator panel (RS485). |
Depending on the device communication method/protocol, select the appropriate method of adding the device to the Power Center.
Select the appropriate device type and any model of the device from the list. Following this action, you must change the "Physical Device ID" to the device ID you specified in the previous paragraph (Paragraph 4). Click “Apply”.
| Info |
|---|
Later in the document, you will find a table summarizing the recommendations for selecting a model when integrating a new product. The specific model indicated in the table contains the most parameters for the purpose of integration, so we recommend it. |
...
Click "Write configuration", wait until the process is complete, and then click "Reset".
Choose the "Configuration" tab, double click on the existing device, and delete all the registers one by one. The ID and Port lines should not be erased.
After all the registers are erased, click on the “Port” line and click on “Add item”.
The following wizard will allow you to choose the appropriate register and specify the parameters for that register related to your new device. You can find all the data in the technical specifications/datasheet of the product. If necessary, you may need to contact the manufacturer. Complete the process by applying the changes.
...
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 |
|---|---|
 |  |
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 register 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 register assignment separately. After each new register assignment is added, be sure to click "Write configuration", wait until the process has been completed, and then click "Reset". For each new registerassignment , 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
...