Device Questions
General Device Questions
For custom devices, please refer to How to add a custom device type?
- Go to Stations.
- Select a station where you want to add the device.
- Go to Devices.
- Click the Add Device button.
- Select the device you want to add.
- Fill in all the required fields and click Add Device.
The device is now added to Avensor.
This is the list of devices that are now supported, but keep in mind that Avensor is constantly adding new devices. Please check the Compatible Devices page for the most recent list.
Note: Devices that are not on the list of compatible devices can be added as custom devices.
- Go to Stations.
- Select a station.
- Go to Devices.
- Select a device.
- Click Delete.
- Avensor deletes the device.
If a user deletes a device, all of the data that is related to the device is permanently lost. The deletion includes active alarms and alarm history.
If a user changes the communication link for a device, no data is lost.
Devices that are not on the list of compatible devices can be added as custom devices.
Custom Devices
For more information, see What are the data model and data source for a custom device type?
- Go to Admin > Device types.
- Select the device type.
- Go to Data points > Add data point.
- Define the data type.
a) When the dynamic or static data type is selected:- Set the Category1
- Select the Subcategory2
- Set the Target
- Go to the Source tab
- Set the data source
- Go to the Unit and scaling tab
- Set the scaling of the data
Select the unit.
When the category Status and the subcategory Running is selected, leave the Detailed name blank to show the pump in the stations model.
If none of the predefined categories are applicable for both data points, select Other in the drop-down for category and add a Detailed name.
b) When the alarm data type is selected.
- Set the Activation level
- Set the Alarm priority
- Set the Target
- Add a Detailed name. It is mandatory to enter a detailed name
- Go to the Source tab
- Set the data source
5. Click the Save button
1 The category of a data point describes the type of the data that the data point reflects
2 The subcategory is a refinement of the category
- Go to Admin > Device types.
- Select a custom device type.
- Go to the Data points tab.
- Locate the data point that is to change its placement.
- Click and hold the
icon to drag and drop the data point at a new placement.
Avensor changes the order of the data points in Live data.
Data model
The data points must be accurately defined for Avensor to show the data correctly.
Parameter | Description |
Dynamic Data | Live data from the device, for example the water level or input current This data is visible on the Live data page. |
Static Data | Static data, for example the serial number or software version. This data is visible on the Device configuration page. |
Alarms | Alarms from the device |
Category | The data that is read from the data point, for example, speed, level, or power |
Subcategory | The type of data, for example, maximum, reference, or input |
Target | The source of the data, for example, the device, a machine, or an input on the device |
The following table shows examples of configurations for different data points.
Data point | Parameter | Value |
Pump running | Data type | Dynamic data |
Category | Status | |
Subcategory | Current level | |
Target | Pump | |
High level alarm | Data type | Alarm |
Category | Level | |
Subcategory | High | |
Target | Input |
Data source
The data source is six numbers that represent the Modbus object type and location. The first number represents the object type.
Number | Object type |
0 | Coil |
1 | Discrete input |
3 | Input register |
4 | Holding register |
The remaining five numbers represent a location from 1–65 535. If the location as less than five numbers, then zeroes are added before the location so that the data source has six numbers in total. When the data source is an individual bit, the data source uses the format register:bit, where the bit location is a number from 0–15. For example, 400102:0 is the bit in position 0 in the holding register 102.
- Go to Admin > Device types.
- Select a device type.
- Go to the Data points tab.
- Click the Add data point button.
- Go to the Source tab.
- Type the Modbus register followed by a colon.
The Size and order field is automatically set to BITMASK_16_BIT. - After the colon, type the bit or the bit range that is to be read. Use a dash to denote a range.
- Click Save.
ATU
Contact support or the sales contact person.
- Connect to the ATU with the use of the software OPTWin.
- Click Hardware Definition.
- Below Modbus, click Go.
- In the field Output Mapping, find the Modbus address for the applicable port type and function code.
Example:
In the example, the Modbus base address for the digital inputs is set to 3000. The Modbus base address for the analog inputs is set to 10000.
Find the Modbus address for the applicable port type and function code.
- Add 1 to the address.
- If the address is now a four-digit number, concatenate 0 to the start of the address.
- Concatenate the function code number to the start of the address. Each function code is related to a digit in the following way.
Function code | Digit |
Coils | 0 |
Status | 1 |
Input | 3 |
Holding | 4 |
Related FAQ: How to find Modbus base numbers in OPTWin?
Example 1:
- Modbus address: 2000
Function code: Holding - Add 1 to the address: 2001
- The address contains four digits. Concatenate 0 to the start of the address: 02001
- Concatenate the function code number to the start of the address: 402001
The Modbus number is 402001.
Example 2:
- Modbus address: 15000
Function code: Input - Add 1 to the address: 15001
- The address contains five digits. No need to concatenate 0.
- Concatenate the function code number to the start of the address: 315001
The Modbus number is 315001.
Aquavar
- Go to Stations.
- Select a station with an Aquavar device.
- Go to the Devices and click the Aqauvar device.
- Click Edit.
- In the Device information, go to the Value data interpretation and change the pressure unit to the bar or the psi.
- Click Save.
Ecotouch
The EcoTouch supports 24 lamps.
MyConnect
Avensor only supports reading if MyConnect is set to l/s and will present in that unit.
Nexicon
- Go to Stations.
- Select a station.
- Go to Devices.
- Select the device XAM 912.
- Go to the tab Alarm configuration.
- For the applicable alarm, click Edit.
- Edit the field Name.
- Click Save.
Remote Inspection Kit
- Finish the physical installation and power up the new Xylem Gateway unit.
- Go to DEVICES.
- Select the device type Remote Inspection Kit.
- Click the Replace button in the Upper-right corner.
- Fill in the new MAC address and click replace.
Enable Surface debris detection in Settings → Services.
Go to Devices → Camera → Image archive to see the snapshots.
How to take new snapshots:
- Go to OVERVIEW, click the three dots on the camera card to Refresh the snapshot.
- Go to Camera and click Refresh the snapshot.
- Go to DEVICES → Camera → Device configuration and click Refresh the snapshot.