SNMP device definitions
The SNMP devices definition specifies the communication components in the network. For each network component the device configuration needs to be specified. Based on the datapoint configuration which is discussed in the next section, the NETx BMS Core Server adds server items to the device which is represented in a separate directory.
File location
<WorkspaceDirectory>\DataFiles\xio.SNMP.DeviceDefinitions.dat
Parameter | Description | Scope | Unit | Mandatory / default value | |
|---|---|---|---|---|---|
| 1 | SNMP Server | This parameter specifies the name of the SNMP device which represents the device on the Core Server and is important for the configuration of the data points. | String | none | mandatory |
| 2 | Host IP | The parameter refers to the IP address of the SNMP device in the network. | IP address | none | mandatory |
| 3 | Port | This attribute specifies the IP port of the SNMP device for the communication with the NETx BMS Core Server in the network. The default value is the "'161"'. | Port | 0 – 65535 | 161 |
| 4 | Community string | The authentication on a SNMP device requires a password which is called community string. The password can be individually set on each device, but the default value is "'public"'. | string | none | public |
| 5 | Version code | The SNMP standard has different versions with different functionality. The SNMP module supports Version 1 and Version 2 of the standard. This parameter identifies which version is supported by the device and used during the communication. By default the version code is "'V1"', which stands for SNMP Version 1. | V1, V2, V3 | none | V1 |
| 6 | Refresh interval | This attribute specifies the time span in which the Core Server checks the availability of the SNMP device in the network. | 100 - 2147483647 | ms | 5000 |
| 7 | Max Request Items | The number of polling items can be limited, so that the SNMP device is not overloaded. | 1 - 2147483647 | none | 10 |
| 8 | Max Parallel cmds | Defines the number of requests which are used by the Core Server to poll the defined items. | 1 - 2147483647 | none | 1 |
| 9 | Ignore Items Quality | The parameter enables to reset item values on the Core Server, depending on the quality (status) of the SNMP device. | true/false | none | false |
| 10 | Authentication Name | SNMP version 3 requires allows the encryption of data which is transferred during the communication. The name refers to the configuration of the user in the SNMP user definition file. | none | Reference to SNMP user definitions | empty |
| 11 | Retry count | Number of tries that are performed before considered a network failure. | 1 - 2147483647 | none | 3 |