Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Info

For SmartServer 4.1 and prior, see (Optional) Create a LON Interface for a Modbus Device (Release 4.1 and Prior).

The SmartServer IoT can be used on an LNS network that is managed by the IzoT Commissioning Tool (CT), or other IzoT Net Server  or LNS tool. This section describes how to make Modbus RTU data updates available as network variables in an LNS network. 

In order to see Modbus datapoints in LON network variables, you need to create a custom internal application in the SmartServer IoT that subscribes to the Modbus data (MQTT) and updates the internal LON variables on your internal LON device so the data will populate on your device’s instance in IzoT CT.  

...

  • IzoT CT and IzoT Net Server (4.20.016 or higher)
  • Resource Files – those used by the internal application need to be added to the IzoT Resource Editor’s catalog.
    • Copy the resource file set (i.e., .enu, .fmt, .fpt, and .typ files) into the /LonWorks/Types/User/Echelon/ folder on the PC that is running IzoT CT
    • Update the IzoT Resource Editor’s device catalog
  • Internal application files deployed to the SmartServer IoT
  • Internal LON application device type package (DTP) file
  • Internal LON application XIF file used to commission within IzoT CT
  • SmartServer IoT XIF

Configuring the SmartServer

...

To configure the SmartServer IoT settings for Modbus IMM, follow these steps:

  1. Open the SmartServer Configuration page as described in Accessing the SmartServer IoT Configuration PageThe Network tab appears as the default SmartServer Configuration page. Once the network settings are configured for the SmartServer system, then the System tab will appear as the default.
    Image Removed
    Image Added
    SmartServer IoT Network tab

    Image Removed
    Image Added
    SmartServer IoT System tab

  2. From the Network tab, select the LAN Interface Static IP Address dropdown option and specify the address details. 
    Image Removed
    Image Added

  3. Click Update to save your configuration.

  4. Click Reboot the SmartServer IoT or SmartServer Pi.

  5. For SmartServer IoT, open the SmartServer Configuration page again and click the Firewall tab.
    Image Removed
    Image Added

  6. Enable the For SmartServer IoT, enable the port 1883 for eth0, which is required for the IzoT Net Export Tool and internal applications.
    Image Removed
    Image Added

  7. Click Update to save your configuration.

  8. Click the LON tab.

    SmartServer IoT and SmartServer Pi LON Configuration pages are shown below.
    Image RemovedThe examples that follow are shown using SmartServer IoT.

    Image Added
    SmartServer IoT LON tab

    Image Added
    SmartServer IoT Pi tab

  9. Enable the SmartServer IoT for IP-852  eth0 interface.

    Image RemovedImage Added
    SmartServer IoT LON tab

  10. Click Update to save your configuration.

  11. Click the CMS tab and log into the CMS.

  12. From the Devices widget, switch the LON management mode to LON Independent Management Mode (IMM).

...

Continue setting up Modbus IMM following the steps in the section below: Installing SmartServer IoT Files

Installing SmartServer

...

Files

  1. Use the CMS Import / Export button ( ) to import the internal LON application DTP file.

  2. Connect to the SmartServer IoT via FTP.

  3. In the /var/apollo/data/ directory, create a new directory called apps and a subdirectory under apps, where SmartServer IoT internal application files will be copied using the following commands:
    1. package.json
    2. package-lock.json
    3. <internalApp>.js

  4. Copy the <internalApp>.conf file into the /etc/supervisor/conf.d directory.

  5. If your SmartServer IoT has internet access, from the SmartServer console (as described in the section Connecting to Your SmartServer), navigate to the newly created internal app directory and enter the npminstall command to add the node packages required for this application.

    or 

    If your SmartServer IoT does not have internet access, use FTP to copy the entire node_modules folder into the SmartServer IoT internal application directory.

Continue setting up Modbus IMM following the steps in the section below: Starting the SmartServer IoT Internal Application

Starting the SmartServer

...

Internal Application

It is best practice is to design the SmartServer IoT internal application to delay its startup by 5 minutes when running as a service. Doing so allows time for dependent applications, like the CMS, to execute.  

  1. From the console, reboot the SmartServer IoT by typing the following command:

    Code Block
    sudo reboot


  2. Once the SmartServer IoT console has restarted, verify that the Internal App is running by typing the sudo supervisorctl command.

  3. Exit  supervisorctl by pressing control-c

...

  1. Launch the LonWorks Interfaces (32-bit) control panel applet on your Windows PC.



  2. Using the LonWorks Interfaces applet, add a new IP-852 interface. 

  3. Define an IP-852 VNI interface that will be used by IzoT CT in the LonWorks Interfaces applet.

  4. Launch the EnOcean IP-852 Configuration Server. 

  5. Create or open an existing IzoT CT network and attach to the defined IP-852 interface that is on the same IP-852 channel as the SmartServer IoT.

  6. Set the Management Mode to OnNet.

  7. Verify that the Channel Properties of the opened network is set to IP-852.

  8. Create and add new IP-70 channel that represents the internal IP-70 channel.

  9. Add a new router object to the drawing connecting the IP-852 channel to the newly defined IP-70 channel.

  10. Return to the SmartServer IoT SmartServer LON Configuration page.

  11. Click IP-852 Router Configuration → Service/Connect button to generate service connect messages for commissioning the router.
    Image Removed

    Image Added
    SmartServer IoT LON tab

  12. Drop a device on the IP-70 channel and commission it using the SmartServer IoT XIF and the LON Configuration page Service/Connect button.

  13. Drop a device on the IP-70 channel and commission it using the SmartServer internal application XIF file to expose the datapoints on the LON network. At this point, the outputs for the LON datapoints on the SmartServer IoT internal application device should be active and populating live datapoints.