LON is supported with SmartServer Pi 4.3 and higher with the exception of LON PL.
Info |
---|
For SmartServer 4.3 and prior, see Discovering, Defining, or Importing Devices (Release 4.3 and Prior). For SmartServer 3.4 and 3.5, see Discovering, Defining, or Importing Devices (Release 3.4 and 3.5). For SmartServer 3.3 and prior, see Discovering, Defining, or Importing Devices (Release 3.3 and Prior). |
...
If you are using your SmartServer on a LON network that is managed with an IzoT Net Server or LNS Server, you can continue to define and commission the devices using a tool based on the IzoT Net Server or LNS Server, such as the IzoT Commissioning Tool (CT), and then export the device definitions from the IzoT Net Server or LNS Server to the SmartServer as described in Importing LON Devices from an LNS Network with IzoT CT.
EnOcean Devices
REMOTE ENOCEAN INTERFACE (BETA) IS SUPPORTED WITH SMARTSERVER 4.3 AND HIGHER.
LOCAL ENOCEAN INTERFACE IS SUPPORTED WITH SMARTSERVER 4.0 AND HIGHER.
...
- Manually – to add EnOcean devices manually, follow these steps:
- Add an EnOcean interface to your Smartserver.
- Create an EnOcean XIF file (.eno for local mode or .iotc for remote mode). See (Optional) Creating a Local EnOcean Device Interface (XIF) Definition or (Optional) Creating a Remote EnOcean (Beta) Device Interface (XIF) Definition.
- Import the eno file into the SmartServer. See the Importing a Device Type section in Defining Device Types for more information.
- Manually add the devices using the SmartServer CMS Devices widget. See Creating Devices below.
- Device Discovery – The SmartServer can be setup to discover EnOcean devices. To add EnOcean devices using device discovery, follow these steps:
- Add an EnOcean interface to your Smartserver.
- Create an EnOcean XIF file (.eno for local mode or .iotc for remote mode). See (Optional) Creating a Local EnOcean Device Interface (XIF) Definition or (Optional) Creating a Remote EnOcean (Beta) Device Interface (XIF) Definition.
- Import the .eno file for local mode or .iotc file for remote mode into the SmartServer. See the Importing a Device Type section in Defining Device Types for more information.
- Run device discovery. See Discovering Devices below.
For devices that have a teach-in switch – pressing this switch once causes the device to transmit a teach-in message, which is then received by the EnOcean driver. If an EnOcean XIF exists where the EEP matches the EEP in the message, then the device is discovered.
For devices that do not have a teach-in switch (e.g., the Rocker Switch) – these devices can be discovered during device discovery by rapidly pressing and releasing the switch within 2 seconds.
The EnOcean driver discovery session ends when a period of 120 seconds elapses without any new devices being discovered. 120 seconds is the default, but this setting can be modified by changing the Discovery step callback timeout ms entry in the /var/apollo/conf.d/enocean/idl-enocean.conf system file for SmartServer IoT or /var/smartserver/conf.d/enocean/idl-enocean.conf system file for SmartServer Pi.
Warning If you discover remote EnOcean devices, then removing them using the SmartServer Devices widget removes will remove the devices from the remote server.
LoRaWAN Devices
LoRaWAN devices are supported with SmartServer 4.0 and higher.
You can add LoRaWAN devices to the SmartServer using one of the following methods:
...
You can discover previously installed BACnet, EnOcean, LON, or Modbus, or EnOcean devices. LoRaWAN devices are automatically discovered by the SmartServer when you add a LoRaWAN interface to the SmartServer. You can also discover unconfigured LON devices, that is, LON devices that have not been previously installed. If you have LON devices that were defined and commissioned using a tool based on the IzoT Net Server or LNS Server such as the IzoT Commissioning Tool, use the procedure described in Importing LON Devices from an LNS Network with IzoT CT instead of device discovery if you plan to continue using a LON tool such IzoT CT. To discover devices, follow these steps:
...
- Define the device interfaces for the devices to be discovered as described in Collecting or Creating Device Definitions.
- For BACnet device discovery, enable BACnet using the BACnet Configuration page as described in Add a BACnet Interface.
- For LON device discovery, specify a LON domain ID to discover or enable automatic LON domain ID discovery if your LON network uses a one-byte domain ID as described in Add a LON Interface.
Define CMS device types for the devices to be discovered as described in Defining Device Types. Following are driver-specific notes for XIF and device type definition:
- BACnet – if the SmartServer does not find a XIF definition for a discovered device, then the SmartServer creates one automatically as described in Creating a BACnet Device Interface (XIF) Definition.
- LON – if the SmartServer does not find a XIF definition for a discovered device, it will create the device in the SmartServer, but it will not be usable due to the missing XIF definition.
- Modbus – the SmartServer will only discover Modbus devices with a matching XIF definition that includes a marker for the XIF definition that the SmartServer uses to match the device to the XIF definition as described in Creating a Modbus Device Interface (XIF) Definition.
Open the SmartServer IoT CMS, .
Open the Devices widget. Click the Expand button ( ).
- Click the Discover button ().
When you click the Discover button, the SmartServer initiates discovery for BACnet, LON, and Modbus devices. The SmartServer adds each discovered device
The Discover Devices dialog box appears: - If you are using Remote CMS, then select the SmartServer where you want to initiate device discovery from the Segment Controller dropdown menu.
- Uncheck any protocol types that you do not want to discover (i.e., BACnet, EnOcean, LON, LoRaWAN, Modbus).
- Click the Discover button.
The SmartServer initiates discovery for the selected device protocols.
The SmartServer adds each discovered device that is not already defined in the SmartServer, first identifying or creating a CMS device type as follows:- If the SmartServer discovers a program ID in the device, the CMS searches for a CMS device type using the discovered program ID. If the SmartServer finds multiple CMS device types with the same program ID, the SmartServer uses the first one found with a the default property set to true, and if there are no default device types the SmartServer uses the first device type found with the matching program ID.
- If there is no matching CMS device type but there is an XIF file with a matching program ID, the SmartServer creates a CMS device type for the XIF file with the same name as the XIF file.
- If there is no matching CMS device type or XIF, the SmartServer creates a CMS device type for the driver/program ID pair named <driverName>-<programID> and assigns it to the device. For example, if a device is discovered with a program ID of 9F:FF:FF:05:01:84:04:60, and there is no CMS device type or XIF file for the program ID, the CMS creates a new device type called LON-9F:FF:FF:05:01:84:04:60.
Device discovery remains active from the time you start discovery until 3 minutes pass without a discovery event.
The SmartServer creates a name for each discovered device that is not already defined in the SmartServer using the following naming format: Discovered-<deviceType>-<installCode>-<instance>, where
- <devicetype> is the CMS device type name assigned above
- <installCode> is the last five hex digits of the unique ID
- <instance> is the instance number for this device type/install code pair (ordinal starting at 1 for each CMS device type/install code and increments forever without re-use for each CMS device type/install code)
For example, if three devices are discovered for the LON-9F:FF:FF:05:01:84:04:60 device type with unique IDs ending in 07F07, 07F08, and 07F09, then the three devices will be named:
- LON-9F:FF:FF:05:01:84:04:60-07F07-1
- LON-9F:FF:FF:05:01:84:04:60-07F08-1
- LON-9F:FF:FF:05:01:84:04:60-07F09-1
For LON, you can optionally press a service button on a device in the domain to be discovered. The LON driver will wait for a service message that is generated by the pressing of a service button. Next, the LON driver will read the domain index 0 configuration at the unique ID that is included in the service message, and if a domain is configured for domain index 0, then the LON driver will assign the configured domain ID as the LON domain ID to be discovered.
- For EnOcean devices that have a teach-in switch, pressing this switch once causes the device to transmit a teach-in message, which is then received by the EnOcean driver. If an EnOcean XIF exists where the EEP matches the EEP in the message, then the device is discovered. For EnOcean devices that do not have a teach-in switch (e.g., the Rocker Switch), rapidly pressing and releasing the switch within 2 seconds causes these devices to be discovered. (e.g., the Rocker Switch), rapidly pressing and releasing the switch within 2 seconds causes these devices to be discovered.
- Optionally, click the Stop button () to stop waiting for discovery results as shown in the example below.
The device discovery is stopped releasing the CMS from waiting for the discovery process to finish before making all of functionalities available, which would otherwise only be possible by a system reboot.
To resume discovery once it has been stopped, click the Discover Devices button (). Once the device discovery is completed, provision the Discover Devices dialog box will show a Finished status for all of the selected device protocols.
Click Close to return to the Devices widget.
The Devices widget displays the discovered devices.Provision the devices using the CMS Devices widget as described in Provisioning, Deprovisioning, and Replacing Devices.
Creating Devices
...
You can manually create devices as described in this section, and you can manually create devices in bulk as described in Creating Devices in Bulk.
Open the SmartServer IoT CMS, .
Open the Devices widget. Click the Expand button ( ).
Click the Create button (
The Create Edge Devices view appears. ).- Enter the device parameters as appropriate, including:
- Name
- Context – provides a digital representation of the physical world entities in the system with SmartServer 2.8 and higher.
- Select a method – Manual assignment or Guided discovery
- For Manual assignment, you will need to select the driver type and device type, and define the UID.
- For Guided discovery, press the service button for the LON device. The UID, driver type, and device type will be filled in through the guided discovery process.
- Select a driver – BACnet, LON, Modbus, IAP, EnOcean (for local mode, available with SmartServer 4.0 and higher), LoRaWAN (available with SmartServer 4.0 and higher; beta for SmartServer 4.0 and 4.1), IoTC (for remote mode, available with as beta SmartServer 4.3 and higher), or custom driver name.
- Select a type of device
UID
Info Each Modbus device that is added in the CMS must have a unique identifier (device UID). The UID is defined when a Modbus device is created using the SmartServer CMS in one of the following ways:
- Creating a single Modbus device
- Bulk loading multiple Modbus devices
- Importing devices from a file using a previously exported device CSV/DTD file
- Importing device type information using a previously exported DTP file from the Device Types widget (see Defining Device Types)
- For Modbus RTU (RS-485) devices, this field uses the form <channel type>:<logical address>, where the <channel type> is always 01 and the <logical address> is an 8-bit station address.
- Example: Modbus RTU (RS-485) device at address 4, the UID is 01:4
- Example: Modbus RTU (RS-485) device at address 4, the UID is 01:4
For Modbus TCP devices, this field uses the form <channel type>:<IP address>[:<logical address>], where the <channel type> is 02 and the <IP address> is an IPV4 address. The 8-bit [:<logical address>] is optional for a Modbus TCP device and only required if the target Modbus TCP device also resides at a specific Modbus logical address at this IP address.
With SmartServer release 3.5 and higher, you can optionally specify the TCP port to be used for a Modbus TCP device using the form<channel type>:<IP address>[:<port>] [:<logical address>], where the <channel type> is 03 and the <IP address> is an IPV4 address. The [:<port>] parameter is optional for a Modbus TCP device and is only required if the target Modbus TCP device uses a port other than the standard Modbus TCP port (502). The 8-bit [:<logical address>] is also optional for a Modbus TCP device and only required if the target Modbus TCP device also resides at a specific Modbus logical address at this IP address.- Examples:
- Using the standard Modbus TCP port (502): Modbus TCP device at IP address 192.168.42.42 with a logical address of 3, the UID is 02:192.168.42.42:3
- Using a non-standard Modbus TCP port (1502): Modbus TCP device at IP address 192.168.42.42 with a logical address of 3, the UID is 03:192.168.42.42:1502:3
- Examples:
- For BACnet, this field defines the Device Instance Number (also referred to as Device ID)or Instance Number). Do not include leading zeros for this value.
- Example: 0130055130055
- Example: 0130055130055
- For EnOcean devices, the UID correlates to the EnOcean ID, which is typically printed on the device as a hexadecimal string. It may also be part of a QR code that is found on the device. Support for EnOcean devices requires SmartServer 4.0 or higher for local mode, and SmartServer 4.3 and higher for remote mode (beta).
- Example: 00000413D73E or 2ED05D without leading zeros
- Example: 00000413D73E or 2ED05D without leading zeros
- For LoRaWAN (Long Range Wide Area Network), the UID is typically a 16-character hexadecimal string. See (Optional) Creating a LoRaWAN Device Interface (XIF) Definition for more information about supported devices. Support for LoRaWAN devices requires SmartServer 4.0 or higher.
- Tags (optional) – key=value pairs that identify where the device/datapoint originated.
With SmartServer 4.2 and higher, and for IDL-based drivers only (not LON), you can optionally add DBO device and datapoint tags to ev/data using the tag key prefix eit: , which indicates an event identification tag. This tag feature supports Haystack and Google DBO tags and should not be used with equal signs ( = ) or semicolons ( ; ).- Example:
Devices widget example
KEY eit:Device Name = VALUE some device name
IAP/MQ example of ev/data message, which also shows datapoint eit: tags defined as:
KEY eit:DBO New Tag = VALUE some value
KEY eit:DBO DP Name = VALUE Power B
- Example:
- Description (optional) – optional description limited to 255 characters.
- Click SAVE.
The new device appears on the Devices widget (e.g., DIO1 in the example below). - Provision the devices using the CMS Devices widget as described in Provisioning, Deprovisioning, and Replacing Devices.
...
To manually create devices in bulk, perform the following steps:
Open the SmartServer IoT CMS, .
Open the Devices widget. Click the Expand button ( ).
Click the Create button (
The Create Edge Devices view appears. ).- In the Count field, enter the number of devices to be created, and in the From field, enter the starting device number. (The Name field changes to Name Prefix.)
- In the Name Prefix field, enter the prefix that is to be assigned to the name of device that is being created.
- Enter the device parameters as appropriate, including:
- Context (optional) – provides a digital representation of the physical world entities in the system with SmartServer 2.8 and higher
- Select a method – Manual assignment or Guided discovery
- Select a driver – BACnet, EnOcean, LON, LoRaWAN, Modbus, IAP, IoTC, or custom driver name
- Select a type of device
- Tags (optional)
- Description (optional)
- Click SAVE.
The new devices appear on the Devices widget (e.g., TEST2, TEST3, and TEST4 in the example below).
...
To import device definitions from a CSV file, follow these steps:
Open the SmartServer IoT CMS.
- Click the Import / Export button (.
The Import / Export dialog appears. ) on the main CMS dashboard - Select the device definitions CSV file to be imported and place it in the Drop Files to Import area.
- Click IMPORT.
Notification messages will appear (similar to the one shown below) indicating that devices are being uploaded and the CPU usage on the main CMS page will show increased activity. - When the device definitions CSV file has finished loading, click CANCEL to close the Import / Export dialog.
The new device(s) will appear in the Devices widget in an unprovisioned (blue) state. - Provision the device(s) using the CMS Devices widget as described in Provisioning, Deprovisioning, and Replacing Devices.
...
You can export an individual device, selected devices, or all devices using the Devices widget. To do so, perform the following steps:
Open the SmartServer IoT CMS, .
Open the Devices widget. Click the Expand button ( ).
- Click the Action button (
Or, to export selected devices, select the devices you wish to export (a checkmark appears), and then click the Action button ( ) and select the Export Selected action.
Or, to export all devices, click the Action button ( ) and select the Export All action. ) for the device you wish to export and select the Export action.
...
Assigning a Device to a Context
With SmartServer 2.8 and higher, devices can be assigned to a context. A context provides a digital representation of the physical world entities in the system. Devices that are not assigned to a context appear with a yellow indicator on the device image . To assign a device to a context, perform the following steps:
Open the SmartServer IoT CMS, .
Open the Devices widget. Click the Expand button ( ).
- Click the Action button (
) for the desired device and select Assign to Context.
The Assign to context dialogue box appears. - Use the dropdown list to select the desired context.
- Click ASSIGN.
The device is assigned to the context.
...
You can remove a context assignment from a device. To do so, perform the following steps:
Open the SmartServer IoT CMS, .
Open the Devices widget. Click the Expand button ( ).
- Click the Action button (elect the Unassign from Context action. ) for the desired device and s
The device is unassigned from the context and appears with a yellow indicator on the device image.
...
To create a group, follow these steps:
Open the SmartServer IoT CMS, .
Open the Groups widget.
- Click the Action button (
- Enter the new group information, including name and geozone.
- Click Save.
The new group is added to the list.
...
To create a group, perform the following steps:
Open the SmartServer IoT CMS, .
Open the Groups widget.
- Click the Action button ( ) and select the Show on Map action.
...
To assign devices to a group using the Devices widget, follow these steps:
Open the SmartServer IoT CMS.
- If the group does not already exist, open the Groups widget and then create the new group.
Open the Devices widget. Click the Expand button ( ).
- Click the Action button (
Or, to select multiple devices to be assigned to a group, click the the desired devices (a checkmark appears), and then click the Action button ( ) and select the Assign Selected to Group action.
Or, to assign all devices to a group, click the Action button ( ) and select the Assign All to Group action.
The device assignment to a group view appears. ) for the desired device and select the Assign to Group action. - Select the group to which you wish to assign the device(s) from the dropdown list.
- Click Assign.
The device(s) is added to the selected group.
...
To assign devices to a group using the Groups widget, perform the following steps:
Open the SmartServer IoT CMS, .
Open the Groups widget.
Click the Action button (
) for the desired group and then click Edit Group.
The Group members view appears. Click the Expand button ( ).Click the Add Members button (
) to add devices to a group. Available devices appear.- Click the Action button (
Or, to select multiple devices to be added, click the checkmark for the desired devices, and then click the Action button ( ) and select the Add Selected to Group action.
Or, to add all devices, click the Select All button ( ), and then click the Action button ( ) and select the Add Selected to Group action.
The selected device(s) are added to the group.
Click BACK to return to the Groups widget view. ) for the desired device and select the Add to Group action.
...
To do so, perform the following steps:
Open the SmartServer IoT CMS, .
Open the Groups widget.
- Click the Action button () for the desired group and select the Edit Group action.
The Group members view appears. Click the Expand button ( ). - Click the Action button (
Or, to select multiple devices, click the checkmark for the desired devices, and then click the Action button ( ) and select the Remove Selected from Group action.
Or, to remove all devices, click the Select All button ( ), and then click the Action button ( ) and select the Remove Selected from Group action.
The selected device(s) are removed from the group. ) for the desired device and select the Remove from Group action. Click BACK to return to the Groups widget view.
...
To remove a group, perform the following steps:
Open the SmartServer IoT CMS, .
Open the Groups widget.
- Click the Action button (
- Click OK in the Confirmation dialog box to delete the selected group.
Or, to remove multiple groups, click the desired groups (a checkmark appears), and then click the Action button ( ) and select the Remove Selected Groups action. - Click OK in the Confirmation dialog box to remove the selected group(s).
...