Page 1 User manual netIOT Edge Gateway NIOT-E-TPI51-EN-RE (Connect) V1.1.2 Hilscher Gesellschaft für Systemautomation mbH www.hilscher.com DOC170502UM04EN | Revision 4 | English | 2018-08 | Released | Public...
Page 2: Table Of Contents
Displaying the system log files................ 35 8.3.4 Setting the system time................... 39 8.3.5 Backup and restore.................. 42 8.3.6 Rebooting the system .................. 49 Edge Gateway | NIOT-E-TPI51-EN-RE (Connect) © Hilscher 2017 – 2018 DOC170502UM04EN | Revision 4 | English | 2018-08 | Released | Public...
Page 3 11.2 Configuring the fieldbus and defining the signals............ 153 11.2.1 Creating a new fieldbus configuration............ 153 11.2.2 Changing the existing fieldbus configuration .......... 160 Edge Gateway | NIOT-E-TPI51-EN-RE (Connect) © Hilscher 2017 – 2018 DOC170502UM04EN | Revision 4 | English | 2018-08 | Released | Public...
Page 4 15.2 Working with Docker via the web GUI................ 213 15.2.1 The portainer.io interface ................ 213 15.2.2 Example: Executing the web server NGINX as a container...... 215 Edge Gateway | NIOT-E-TPI51-EN-RE (Connect) © Hilscher 2017 – 2018 DOC170502UM04EN | Revision 4 | English | 2018-08 | Released | Public...
Page 5 Working with certificates for client authentication ......... 235 16.6.2 Working with key files for client authentication .......... 238 17 Technical data ........................ 241 17.1 Technical data NIOT-E-TPI51-EN-RE ................. 241 17.2 Technical data PROFINET IO Device................ 243 17.3 Technical data EtherNet/IP Adapter................ 244 18 Authorizations........................ 245 18.1 FCC authorization ...................... 245...
Page 6: Introduction
RGö, HHe Section Displaying the system log files [} page 35] added. Section Security [} page 68] added. Section Public Key Infrastructure [} page 218] added. Table 1: List of revisions Edge Gateway | NIOT-E-TPI51-EN-RE (Connect) © Hilscher 2017 – 2018 DOC170502UM04EN | Revision 4 | English | 2018-08 | Released | Public...
Page 7: Brief Description
OPC UA and MQTT functions address objects in IoT-capable field devices or in the cloud via standardized IoT protocols. The Hilscher netIOT Service offers additional software packets to extend the Edge Gateway base functions by further applications or accesses to specific clouds.
Page 8: Device Drawings
Positions of the interfaces APL SYS LED1 LED2 ACT POW Fieldbus LINK Rx/TX LINK Rx/TX Top view Front view Bottom view Edge Gateway | NIOT-E-TPI51-EN-RE (Connect) © Hilscher 2017 – 2018 DOC170502UM04EN | Revision 4 | English | 2018-08 | Released | Public...
Page 9: Dimensions
Real-Time Ethernet connectors [} page 10] (11) +24 V DC supply voltage connector (Mini Combicon) Power supply [} page 10] (12) Cover at bottom of device (bolted) Table 2: Positions of the interfaces of NIOT-E-TPI51-EN-RE Dimensions APL SYS LED1 LED2 ACT POW Fieldbus LINK Rx/TX...
Page 10: Connectors And Mounting
The Edge Gateway has 4 USB connectors (4 x USB 2.0), positions (see section Positions of the interfaces [} page 8]). Edge Gateway | NIOT-E-TPI51-EN-RE (Connect) © Hilscher 2017 – 2018 DOC170502UM04EN | Revision 4 | English | 2018-08 | Released | Public...
Page 11: Wi-Fi
If you want to use it, find an example docker image with activated HDMI interface and desktop at https:// hub.docker.com/r/hilschernetpi/. Edge Gateway | NIOT-E-TPI51-EN-RE (Connect) © Hilscher 2017 – 2018 DOC170502UM04EN | Revision 4 | English | 2018-08 | Released | Public...
Page 12: Leds
Positions of the LEDs on the gateway APL SYS LED1 LED2 ACT POW Fieldbus LINK Rx/TX LINK Rx/TX Figure 3: NIOT-E-TPI51-EN-RE LED positions Edge Gateway | NIOT-E-TPI51-EN-RE (Connect) © Hilscher 2017 – 2018 DOC170502UM04EN | Revision 4 | English | 2018-08 | Released | Public...
Page 13: Gateway Status Leds
Position in the device (yellow) (load drawing dependent) The device does not send/receive frames. (off) Table 5: LEDs LAN interface Edge Gateway | NIOT-E-TPI51-EN-RE (Connect) © Hilscher 2017 – 2018 DOC170502UM04EN | Revision 4 | English | 2018-08 | Released | Public...
Page 14: Leds Of The Profinet Io Device Interface
"on" for approximately 50 ms, followed by "off" for 50 ms. The indicator turns on and off in irregular intervals to indicate low Ethernet activity. Table 7: LED state definitions for the PROFINET IO-Device protocol Edge Gateway | NIOT-E-TPI51-EN-RE (Connect) © Hilscher 2017 – 2018 DOC170502UM04EN | Revision 4 | English | 2018-08 | Released | Public...
Page 15: Leds Of The Ethernet/Ip Adapter Interface
(yellow) dependent) The device does not send/receive Ethernet frames. (off) Table 8: LED states for the EtherNet/IP Adapter protocol Edge Gateway | NIOT-E-TPI51-EN-RE (Connect) © Hilscher 2017 – 2018 DOC170502UM04EN | Revision 4 | English | 2018-08 | Released | Public...
Page 16: Table 9: Led State Definitions For The Ethernet/Ip Adapter Protocol
50 ms. The indicator turns on and off in irregular intervals to indicate low Ethernet activity Table 9: LED state definitions for the EtherNet/IP Adapter protocol Edge Gateway | NIOT-E-TPI51-EN-RE (Connect) © Hilscher 2017 – 2018 DOC170502UM04EN | Revision 4 | English | 2018-08 | Released | Public...
Page 17: Commissioning The Edge Gateway
Read section Using the web browser to establish a connection with the Edge Gateway [} page 18] to find out how to access the Edge Gateway. Edge Gateway | NIOT-E-TPI51-EN-RE (Connect) © Hilscher 2017 – 2018 DOC170502UM04EN | Revision 4 | English | 2018-08 | Released | Public...
Page 18: Using The Web Browser To Establish A Connection With The Edge Gateway
You can now use the Edge Gateway manager to configure the device. For this purpose, read section Edge Gateway Manager web page [} page 21]. Edge Gateway | NIOT-E-TPI51-EN-RE (Connect) © Hilscher 2017 – 2018 DOC170502UM04EN | Revision 4 | English | 2018-08 | Released | Public...
Page 19: Access To The Edge Gateway In The Windows Network Environment
You can now use the Edge Gateway manager to configure the device. For this purpose, read section Edge Gateway Manager web page [} page 21]. Edge Gateway | NIOT-E-TPI51-EN-RE (Connect) © Hilscher 2017 – 2018 DOC170502UM04EN | Revision 4 | English | 2018-08 | Released | Public...
Page 20: Edge Gateway Manager
Figure 8: Edge Gateway Manager Note: Remember that the secured HTTPS protocol is used here, not the widely spread HTTP protocol. Edge Gateway | NIOT-E-TPI51-EN-RE (Connect) © Hilscher 2017 – 2018 DOC170502UM04EN | Revision 4 | English | 2018-08 | Released | Public...
Page 21: Edge Gateway Manager Web Page
Opens the Edge Gateway documentation stored in the device. Opens the homepage of the Device Information Portal in the Internet. Requires a connection to the Internet. Edge Gateway | NIOT-E-TPI51-EN-RE (Connect) © Hilscher 2017 – 2018 DOC170502UM04EN | Revision 4 | English | 2018-08 | Released | Public...
Page 22: Table 10: Starting Applications With The Edge Gateway Manager
Function Opens the homepage of the netIOT platform in the Internet. Requires a connection to the Internet. Opens the Hilscher homepage in the Internet. Requires a connection to the Internet. Opens legal information concerning the Edge Gateway. Requires a connection to the Internet.
Page 23: Control Panel
Ø Enter your user name and your password. Ø Click at Login. ð The Control Panel will be displayed. Edge Gateway | NIOT-E-TPI51-EN-RE (Connect) © Hilscher 2017 – 2018 DOC170502UM04EN | Revision 4 | English | 2018-08 | Released | Public...
Page 24: First Login
Ø Enter the new administrator password. It must have at least 7 characters. For reasons of safety, Hilscher recommends using significantly more characters. A strong password consists of upper and lower case letters, digits and special characters. A quality indicator in the dialog box evaluates the password.
Page 25: Secure Connection
As standard, Edge Gateways contain a certificate issued by Hilscher that is not on the list of the known authorized issuers of certificates. Due to that, the browser signals an insecure connection and requests the confirmation to continue.
Page 26: Figure 10: Security Error Message Of The Internet Explorer
Ø To define an exceptional rule that enables the display of the user interface without repeated error messages, click Add Exception. Edge Gateway | NIOT-E-TPI51-EN-RE (Connect) © Hilscher 2017 – 2018 DOC170502UM04EN | Revision 4 | English | 2018-08 | Released | Public...
Page 27: Figure 13: Firefox Dialog Box: Adding Exceptional Safety Rule
Ø To save the rule, click Confirm Security Exception. ð When you open the control panel in future, security messages will no longer be displayed. Edge Gateway | NIOT-E-TPI51-EN-RE (Connect) © Hilscher 2017 – 2018 DOC170502UM04EN | Revision 4 | English | 2018-08 | Released | Public...
Page 28: Figure 14: Security Error Message Of Google Chrome (1)
Figure 15: Security error message of Google Chrome (2) Ø In order to continue, click at Proceed to ... (unsafe). ð The Control Panel is displayed. Edge Gateway | NIOT-E-TPI51-EN-RE (Connect) © Hilscher 2017 – 2018 DOC170502UM04EN | Revision 4 | English | 2018-08 | Released | Public...
Page 29: Overview And Main Menu
No data are displayed. All important controls and displays of the page · are grayed out respectively inactive. Edge Gateway | NIOT-E-TPI51-EN-RE (Connect) © Hilscher 2017 – 2018 DOC170502UM04EN | Revision 4 | English | 2018-08 | Released | Public...
Page 30: System Information And System Time
System info Description Hardware ident. Serial number of the Edge Gateway Model name Model designation of the Edge Gateway (NIOT-E-TPI51-EN-RE) Firmware version Complete version designation of the firmware stored in the Edge Gateway System time Synchronization status of the internal clock of the Edge Gateway.
Page 31: Table 13: Info Center: Area Monitoring
Table 14: Info Center: Area Temperature If the data of the area Monitoring cannot be read, this is grayed out. Edge Gateway | NIOT-E-TPI51-EN-RE (Connect) © Hilscher 2017 – 2018 DOC170502UM04EN | Revision 4 | English | 2018-08 | Released | Public...
Page 32: License Manager
To open the Details window: Ø Click at the info button on the left edge of the line (within column Details ). Edge Gateway | NIOT-E-TPI51-EN-RE (Connect) © Hilscher 2017 – 2018 DOC170502UM04EN | Revision 4 | English | 2018-08 | Released | Public...
Page 33: Figure 19: License Information In Window Details
Ø Hilscher creates an individual license file for your Edge Gateway according to the information supplied by you. Ø Hilscher sends this file back to you as an attachment within the answer e-mail. Consequently, this license file has to be transferred into the Edge Gateway as described in section How to transfer a license into the device? [} page 34].
Page 34: Figure 20: Message After The Transfer Of The License File Into The Edge Gateway
34/258 8.3.2.3 How to transfer a license into the device? Load the individual license file received from Hilscher from your PC into the Edge Gateway. Do the upload as follows: Ø Open the Control Panel in a web browser. Ø Select System > License Manager.
Page 35: Displaying The System Log Files
So ,for system supervision and safeguarding correct reaction on error situations, the file logging daemon syslogd (or an improved successor of it) runs on every Linux system,. On the Edge Gateways from Hilscher, the widely-spread logging daemon Syslog-ng is used, which had been developped by BalaBit IT Security Ltd.
Page 36: Table 15: Numeric Coding Of Facility Value In Priority Pri
Table 15: Numeric coding of facility value in priority PRI The severity is coded according to the following table: Edge Gateway | NIOT-E-TPI51-EN-RE (Connect) © Hilscher 2017 – 2018 DOC170502UM04EN | Revision 4 | English | 2018-08 | Released | Public...
Page 37: Table 16: Numeric Coding Of Severity Value In Priority (Pri)
UTF-8 (if a BOM character has been detected) or otherwise it is ASCII-coded. Edge Gateway | NIOT-E-TPI51-EN-RE (Connect) © Hilscher 2017 – 2018 DOC170502UM04EN | Revision 4 | English | 2018-08 | Released | Public...
Page 38: Table 17: Assignment Of Parts Of Message Line
This procedure is denominated as Log rotation. Edge Gateway | NIOT-E-TPI51-EN-RE (Connect) © Hilscher 2017 – 2018 DOC170502UM04EN | Revision 4 | English | 2018-08 | Released | Public...
Page 39: Setting The System Time
Gateway afterwards so that all software components in the Edge Gateway take the changed time: System > Reboot. Edge Gateway | NIOT-E-TPI51-EN-RE (Connect) © Hilscher 2017 – 2018 DOC170502UM04EN | Revision 4 | English | 2018-08 | Released | Public...
Page 40 Synchronized to time server <IP address of the time server>:<Port number of the time server > (<NTP address of the time server>) Edge Gateway | NIOT-E-TPI51-EN-RE (Connect) © Hilscher 2017 – 2018 DOC170502UM04EN | Revision 4 | English | 2018-08 | Released | Public...
Page 41 Edge Gateway afterwards so that all software components in the Edge Gateway take the changed time. Edge Gateway | NIOT-E-TPI51-EN-RE (Connect) © Hilscher 2017 – 2018 DOC170502UM04EN | Revision 4 | English | 2018-08 | Released | Public...
Page 42: Backup And Restore
Ø Select System > Backup and Restore in the control panel. Ê The following screen is displayed: Figure 23: Backup and recovery Ø Click at Create local backup. Edge Gateway | NIOT-E-TPI51-EN-RE (Connect) © Hilscher 2017 – 2018 DOC170502UM04EN | Revision 4 | English | 2018-08 | Released | Public...
Page 43: Figure 24: Warning Message
This means, the backup of system files has been completed. Edge Gateway | NIOT-E-TPI51-EN-RE (Connect) © Hilscher 2017 – 2018 DOC170502UM04EN | Revision 4 | English | 2018-08 | Released | Public...
Page 44: Figure 26: Backup And Recovery
Figure 26: Backup and recovery Ø Click at Restore from backup. Ê The following recovery dialog is displayed: Figure 27: Recovery dialog Edge Gateway | NIOT-E-TPI51-EN-RE (Connect) © Hilscher 2017 – 2018 DOC170502UM04EN | Revision 4 | English | 2018-08 | Released | Public...
Page 45: Figure 28: Security Query Prior To System Recovery From Internal Backup File
In any way, do not interrupt the power supply of the Edge Gateway during system recovery! Edge Gateway | NIOT-E-TPI51-EN-RE (Connect) © Hilscher 2017 – 2018 DOC170502UM04EN | Revision 4 | English | 2018-08 | Released | Public...
Page 46: Figure 29: Backup And Recovery
Ø Select System>Backup and Restore within the Control Panel. Ê The following screen appears: Figure 29: Backup and recovery Ø Click at Restore from backup. Edge Gateway | NIOT-E-TPI51-EN-RE (Connect) © Hilscher 2017 – 2018 DOC170502UM04EN | Revision 4 | English | 2018-08 | Released | Public...
Page 47: Figure 30: Recovery Dialog (External Source)
In any way, do not interrupt the power supply of the Edge Gateway during system recovery! Edge Gateway | NIOT-E-TPI51-EN-RE (Connect) © Hilscher 2017 – 2018 DOC170502UM04EN | Revision 4 | English | 2018-08 | Released | Public...
Page 48: Figure 32: Backup And Restore When Backup File Is Present
ð The local backup is internally deleted. Right of Local backup the text No backup is displayed now instead the name of the former backup. Edge Gateway | NIOT-E-TPI51-EN-RE (Connect) © Hilscher 2017 – 2018 DOC170502UM04EN | Revision 4 | English | 2018-08 | Released | Public...
Page 49: Rebooting The System
Take care of the consequences of shutting down and restarting for your network, if you reboot the Edge Gateway. Edge Gateway | NIOT-E-TPI51-EN-RE (Connect) © Hilscher 2017 – 2018 DOC170502UM04EN | Revision 4 | English | 2018-08 | Released | Public...
Page 50: System Shutdown
· updates already installed signed packages. Note: You can only install packages signed by Hilscher! Use the package management only when Hilscher requests you to use the package management. Edge Gateway | NIOT-E-TPI51-EN-RE (Connect) © Hilscher 2017 – 2018 DOC170502UM04EN | Revision 4 | English | 2018-08 | Released | Public...
Page 51: Network
Gateway address, and the IP addresses of the 1st and 2nd domain name server. Figure 37: Default LAN configuration Edge Gateway | NIOT-E-TPI51-EN-RE (Connect) © Hilscher 2017 – 2018 DOC170502UM04EN | Revision 4 | English | 2018-08 | Released | Public...
Page 52: Table 19: Table Lan: Meaning Of The Columns
Table 19: Table LAN: Meaning of the columns If you want to save your changes permanent, click on Save changes. Edge Gateway | NIOT-E-TPI51-EN-RE (Connect) © Hilscher 2017 – 2018 DOC170502UM04EN | Revision 4 | English | 2018-08 | Released | Public...
Page 53: Figure 38: Lan Configuration (Cifx0 Activated)
ð The Ethernet interface cifx0 is activated and you can configure it now. Figure 38: LAN configuration (cifx0 activated) Edge Gateway | NIOT-E-TPI51-EN-RE (Connect) © Hilscher 2017 – 2018 DOC170502UM04EN | Revision 4 | English | 2018-08 | Released | Public...
Page 54: Configuring Wireless Communication (Wifi)
WiFi interface (wlan0). MAC address displays the MAC address, if WiFi is activated. Table 21: WiFi Edge Gateway | NIOT-E-TPI51-EN-RE (Connect) © Hilscher 2017 – 2018 DOC170502UM04EN | Revision 4 | English | 2018-08 | Released | Public...
Page 55: Figure 41: Wifi Operating Mode: Access Point
ð The message WiFi Settings are succcessfully changed is displayed. Operating mode Access point Figure 41: WiFi operating mode: Access point Edge Gateway | NIOT-E-TPI51-EN-RE (Connect) © Hilscher 2017 – 2018 DOC170502UM04EN | Revision 4 | English | 2018-08 | Released | Public...
Page 56: Table 22: Parameters Of The Operating Mode Access Point
DHCP server if you have checked the box DHCP server. Table 22: Parameters of the operating mode Access point Edge Gateway | NIOT-E-TPI51-EN-RE (Connect) © Hilscher 2017 – 2018 DOC170502UM04EN | Revision 4 | English | 2018-08 | Released | Public...
Page 57: Figure 42: Wifi Operating Mode: Client
Shows the SSID (Service Set Identifier) of the Access Point the Edge Gateway is connected to. Table 23: Parameters of the operating mode Client Edge Gateway | NIOT-E-TPI51-EN-RE (Connect) © Hilscher 2017 – 2018 DOC170502UM04EN | Revision 4 | English | 2018-08 | Released | Public...
Page 58 Ø Click Save changes. ð A security request box appears: Ø Click at OK. ð The WiFi settings are saved. Edge Gateway | NIOT-E-TPI51-EN-RE (Connect) © Hilscher 2017 – 2018 DOC170502UM04EN | Revision 4 | English | 2018-08 | Released | Public...
Page 59: Field
· the fieldbus output node to send data to the fieldbus (see section Example 7: Fieldbus output node [} page 143]). Inactive The interface is deactivated. Table 24: Operating mode fieldbus interface Edge Gateway | NIOT-E-TPI51-EN-RE (Connect) © Hilscher 2017 – 2018 DOC170502UM04EN | Revision 4 | English | 2018-08 | Released | Public...
Page 60: Hostname
The hostname is saved by clicking at If storing the hostname has succeeded, the following message box is displayed: Edge Gateway | NIOT-E-TPI51-EN-RE (Connect) © Hilscher 2017 – 2018 DOC170502UM04EN | Revision 4 | English | 2018-08 | Released | Public...
Page 61: Services
Ê A security question is displayed. Ø If you intend to delete all flows, click Yes. ð All Node-RED flows are deleted. Edge Gateway | NIOT-E-TPI51-EN-RE (Connect) © Hilscher 2017 – 2018 DOC170502UM04EN | Revision 4 | English | 2018-08 | Released | Public...
Page 62: Figure 45: Opc-Ua Server For Edge Settings Within The Control Panel, Page Network>Field
Figure 45: OPC-UA Server for Edge settings within the Control Panel, page Network>Field The following table describes the parameters of the OPC UA Server for Edge. Edge Gateway | NIOT-E-TPI51-EN-RE (Connect) © Hilscher 2017 – 2018 DOC170502UM04EN | Revision 4 | English | 2018-08 | Released | Public...
Page 63: Table 26: Parameters Of The Opc Ua Server For Edge
Not checked: The OPC UA Server should not provide passively acquired process data. Connection settings for the Edge Server Edge Gateway | NIOT-E-TPI51-EN-RE (Connect) © Hilscher 2017 – 2018 DOC170502UM04EN | Revision 4 | English | 2018-08 | Released | Public...
Page 64 Edge Gateway. Ø Click at Stop. Ø Wait for some seconds. Ø Click at Start. Edge Gateway | NIOT-E-TPI51-EN-RE (Connect) © Hilscher 2017 – 2018 DOC170502UM04EN | Revision 4 | English | 2018-08 | Released | Public...
Page 65: User Management
Access via REST-API (see Functions of the Edge Server [} page 201]) is also a resource. Edge Gateway | NIOT-E-TPI51-EN-RE (Connect) © Hilscher 2017 – 2018 DOC170502UM04EN | Revision 4 | English | 2018-08 | Released | Public...
Page 66: Table 27: Access Rights Onto Resources
No access None Read access only Read Read and write access Read, Write Table 28: Access rights to resources Edge Gateway | NIOT-E-TPI51-EN-RE (Connect) © Hilscher 2017 – 2018 DOC170502UM04EN | Revision 4 | English | 2018-08 | Released | Public...
Page 67: Managing User Accounts
· Figure 47: User account page Each user account has a user name, a password, and an assigned role. Edge Gateway | NIOT-E-TPI51-EN-RE (Connect) © Hilscher 2017 – 2018 DOC170502UM04EN | Revision 4 | English | 2018-08 | Released | Public...
Page 68: Security
1. Selection list for the certificate type (1): Trusted Certification Authorities or Service certificates 2. File selection area for certificate and key files 3. Certificate Viewer Edge Gateway | NIOT-E-TPI51-EN-RE (Connect) © Hilscher 2017 – 2018 DOC170502UM04EN | Revision 4 | English | 2018-08 | Released | Public...
Page 69: Figure 49: Certificate Type Selection List
On selection of Trusted Certification Authorities the list structure of the Trusted CA Store in the Edge Gateway is displayed. Edge Gateway | NIOT-E-TPI51-EN-RE (Connect) © Hilscher 2017 – 2018 DOC170502UM04EN | Revision 4 | English | 2018-08 | Released | Public...
Page 70: Figure 50: Certificate Viewer
For more information on the foundations of asymmetric encryption techniques and public key infrastructure, see sections Asymmetric encryption [} page 218] and Certificates and keys [} page 220]. Edge Gateway | NIOT-E-TPI51-EN-RE (Connect) © Hilscher 2017 – 2018 DOC170502UM04EN | Revision 4 | English | 2018-08 | Released | Public...
Page 71: Help
· change your E-mail address, and · change your password. · Edge Gateway | NIOT-E-TPI51-EN-RE (Connect) © Hilscher 2017 – 2018 DOC170502UM04EN | Revision 4 | English | 2018-08 | Released | Public...
Page 72: Logout
Prior to accessing the Edge Gateway again, a new login (Specifying user name and password) is necessary. Edge Gateway | NIOT-E-TPI51-EN-RE (Connect) © Hilscher 2017 – 2018 DOC170502UM04EN | Revision 4 | English | 2018-08 | Released | Public...
Page 73: Node-Red - The Wiring Editor
The current documentation is available here: http:// nodered.org/docs/. For beginning, read the document Getting Started: http://nodered.org/docs/getting-started/. Edge Gateway | NIOT-E-TPI51-EN-RE (Connect) © Hilscher 2017 – 2018 DOC170502UM04EN | Revision 4 | English | 2018-08 | Released | Public...
Page 74: Modelling Iot Flows With Nodes
A node can modify and overwrite data before passing the data on. · A node transports data via the msg object in the JSON format. Edge Gateway | NIOT-E-TPI51-EN-RE (Connect) © Hilscher 2017 – 2018 DOC170502UM04EN | Revision 4 | English | 2018-08 | Released | Public...
Page 75: Opening Node-Red
Ø Open the Edge Gateway manager (see Calling the Edge Gateway Manager [} page 20]) Ø In the Edge Gateway manager click on the tile Node-RED. Edge Gateway | NIOT-E-TPI51-EN-RE (Connect) © Hilscher 2017 – 2018 DOC170502UM04EN | Revision 4 | English | 2018-08 | Released | Public...
Page 76: Figure 56: Node-Red Workspace
Connection without certificate with Microsoft Internet Explorer [} page 26] Connection without certificate with Firefox [} page 26] Connection without certificate with Google Chrome [} page 28] Edge Gateway | NIOT-E-TPI51-EN-RE (Connect) © Hilscher 2017 – 2018 DOC170502UM04EN | Revision 4 | English | 2018-08 | Released | Public...
Page 77: Graphical User Interface
Expand or collapse the node library (13) Node library (14) Node category (15) Nodes (16) Node filter Table 29: Node-RED user interface Edge Gateway | NIOT-E-TPI51-EN-RE (Connect) © Hilscher 2017 – 2018 DOC170502UM04EN | Revision 4 | English | 2018-08 | Released | Public...
Page 78: Figure 58: Node
The blue circle shows that this node has been changed but not transmitted yet. Output port (if available) Node status (if available) Input port (if available) Table 30: Node elements Edge Gateway | NIOT-E-TPI51-EN-RE (Connect) © Hilscher 2017 – 2018 DOC170502UM04EN | Revision 4 | English | 2018-08 | Released | Public...
Page 79: Working With Node-Red
Ø Use the mouse to drag a node from the library and insert the node in the flow. Edge Gateway | NIOT-E-TPI51-EN-RE (Connect) © Hilscher 2017 – 2018 DOC170502UM04EN | Revision 4 | English | 2018-08 | Released | Public...
Page 80 Ø Click on Deploy. ð The flow will be deployed from the workspace to the Edge Gateway and activated. Edge Gateway | NIOT-E-TPI51-EN-RE (Connect) © Hilscher 2017 – 2018 DOC170502UM04EN | Revision 4 | English | 2018-08 | Released | Public...
Page 81: Using Git Hub Repository To Store Flows (Projects)
Note: For a description of the projects function, see https://nodered.org/ docs/user-guide/projects/. Edge Gateway | NIOT-E-TPI51-EN-RE (Connect) © Hilscher 2017 – 2018 DOC170502UM04EN | Revision 4 | English | 2018-08 | Released | Public...
Page 82: Menu Deploy
Ê The menu Deploy opens. Ø Click on the menu command to be executed. Ê The dialog box Confirm Deploy is displayed. Edge Gateway | NIOT-E-TPI51-EN-RE (Connect) © Hilscher 2017 – 2018 DOC170502UM04EN | Revision 4 | English | 2018-08 | Released | Public...
Page 83 Ø Click on Confirm deploy to deploy the flow to the Edge Gateway and activate it. ð Thus, the flow is activated in the Edge Gateway. Edge Gateway | NIOT-E-TPI51-EN-RE (Connect) © Hilscher 2017 – 2018 DOC170502UM04EN | Revision 4 | English | 2018-08 | Released | Public...
Page 84: Dashboard
The register card Dashboard of the Edge Bar is itself divided into three register cards: Layout · Theme · Site · Edge Gateway | NIOT-E-TPI51-EN-RE (Connect) © Hilscher 2017 – 2018 DOC170502UM04EN | Revision 4 | English | 2018-08 | Released | Public...
Page 85: Table 33: Areas Of The Dashboard Configuration
Color selection field „Page Settings“ Theme - is only displayed, if option „Custom“ has been chosen in selection list "Style" Edge Gateway | NIOT-E-TPI51-EN-RE (Connect) © Hilscher 2017 – 2018 DOC170502UM04EN | Revision 4 | English | 2018-08 | Released | Public...
Page 86 ð The background color is changed. However, the change will get effective at the next deploy operation. Edge Gateway | NIOT-E-TPI51-EN-RE (Connect) © Hilscher 2017 – 2018 DOC170502UM04EN | Revision 4 | English | 2018-08 | Released | Public...
Page 87: Figure 60: Dialog "Edit Dashboard Tab Node
ð The dialog Edit dashboard tab node is closed and the tab is adapted according to your specifications. Edge Gateway | NIOT-E-TPI51-EN-RE (Connect) © Hilscher 2017 – 2018 DOC170502UM04EN | Revision 4 | English | 2018-08 | Released | Public...
Page 88: Figure 61: Dialog "Edit Dashboard Tab Node
Ø Click at the icon (right of the name of the according group). ð The dialog Edit dashboard tab node is opened. Edge Gateway | NIOT-E-TPI51-EN-RE (Connect) © Hilscher 2017 – 2018 DOC170502UM04EN | Revision 4 | English | 2018-08 | Released | Public...
Page 89: Figure 62: Dialog "Edit Dashboard Tab Node
ð The dialog Edit dashboard tab node is closed and the group is adapted according to your specifications. Edge Gateway | NIOT-E-TPI51-EN-RE (Connect) © Hilscher 2017 – 2018 DOC170502UM04EN | Revision 4 | English | 2018-08 | Released | Public...
Page 90: Figure 63: Dialog "Edit Dashboard Tab Node
Further information can be found in the documentation of Node- RED. You can find it at https://github.com/node-red/node-red- dashboard. Ø Configure the widget according to your needs. Edge Gateway | NIOT-E-TPI51-EN-RE (Connect) © Hilscher 2017 – 2018 DOC170502UM04EN | Revision 4 | English | 2018-08 | Released | Public...
Page 91 Ø Click at ð The widget is deleted and removed from the group, to which it belonged previously. Edge Gateway | NIOT-E-TPI51-EN-RE (Connect) © Hilscher 2017 – 2018 DOC170502UM04EN | Revision 4 | English | 2018-08 | Released | Public...
Page 92: Figure 64: Dialog "Edit Link Node
Edit link node. ð The dialog Edit link node is closed and the link is adapted according to your specifications. Edge Gateway | NIOT-E-TPI51-EN-RE (Connect) © Hilscher 2017 – 2018 DOC170502UM04EN | Revision 4 | English | 2018-08 | Released | Public...
Page 93: Figure 65: Dialog "Edit Link Node
Edit link node. ð The dialog Edit link node is closed and the link is removed from the link list. Edge Gateway | NIOT-E-TPI51-EN-RE (Connect) © Hilscher 2017 – 2018 DOC170502UM04EN | Revision 4 | English | 2018-08 | Released | Public...
Page 94: List Of Nodes
Watson IoT serial Output debug link mqtt http response web socket fieldbus opc ua (client) s7comm Watson IoT serial Edge Gateway | NIOT-E-TPI51-EN-RE (Connect) © Hilscher 2017 – 2018 DOC170502UM04EN | Revision 4 | English | 2018-08 | Released | Public...
Page 95 Modbus Getter Modbus Flex Getter Modbus Write Modbus Flex Write Modbus Server Modbus Queue Info Modbus Flex Connector Edge Gateway | NIOT-E-TPI51-EN-RE (Connect) © Hilscher 2017 – 2018 DOC170502UM04EN | Revision 4 | English | 2018-08 | Released | Public...
Page 96 Table 34: List of standard nodes Edge Gateway | NIOT-E-TPI51-EN-RE (Connect) © Hilscher 2017 – 2018 DOC170502UM04EN | Revision 4 | English | 2018-08 | Released | Public...
Page 97: Mqtt Input Node
Here you enter the name of the MQTT input node that is displayed at the node in Node-RED and used for identification. Table 35: Parameter MQTT input node Edge Gateway | NIOT-E-TPI51-EN-RE (Connect) © Hilscher 2017 – 2018 DOC170502UM04EN | Revision 4 | English | 2018-08 | Released | Public...
Page 98: Figure 68: Dialog Box Mqtt Broker Config Node - Tab Connection
By checking this box you can activate MQTT 3.1 support. MQTT 3.1 support Table 36: Parameters in the tab Connection Edge Gateway | NIOT-E-TPI51-EN-RE (Connect) © Hilscher 2017 – 2018 DOC170502UM04EN | Revision 4 | English | 2018-08 | Released | Public...
Page 99: Figure 69: Dialog Box Mqtt Broker Config Node - Tab Security
This checkbox is active only if the checkbox Enable secure (SSL/TLS) connection has been checked. Table 37: Parameters in the tab Security Edge Gateway | NIOT-E-TPI51-EN-RE (Connect) © Hilscher 2017 – 2018 DOC170502UM04EN | Revision 4 | English | 2018-08 | Released | Public...
Page 100: Figure 70: Dialog Box Mqtt Broker Config Node - Tab Birth Message
Here you can enter the payload (text) to be transmitted in the Birth Message via MQTT. Table 38: Parameters in the tab Birth Message Edge Gateway | NIOT-E-TPI51-EN-RE (Connect) © Hilscher 2017 – 2018 DOC170502UM04EN | Revision 4 | English | 2018-08 | Released | Public...
Page 101: Figure 71: Dialog Box Mqtt Broker Config Node - Tab Will Message
Here you can enter the payload (text) to be transmitted in the Will Message via MQTT. Table 39: Parameters in the tab Will Message Edge Gateway | NIOT-E-TPI51-EN-RE (Connect) © Hilscher 2017 – 2018 DOC170502UM04EN | Revision 4 | English | 2018-08 | Released | Public...
Page 102: Mqtt Output Node
Parameters of the MQTT output node This section describes the parameters of the MQTT output node. Figure 73: Dialog box Edit MQTT out node Edge Gateway | NIOT-E-TPI51-EN-RE (Connect) © Hilscher 2017 – 2018 DOC170502UM04EN | Revision 4 | English | 2018-08 | Released | Public...
Page 103: Table 40: Parameters Of The Edit Mqtt Out Node
Message of the MQTT output and input node are identical and described in section MQTT input node [} page 97]. Edge Gateway | NIOT-E-TPI51-EN-RE (Connect) © Hilscher 2017 – 2018 DOC170502UM04EN | Revision 4 | English | 2018-08 | Released | Public...
Page 104: Opc Ua Input Node
Here you enter the name that is displayed at the node. Table 41: Parameters of the configuration dialog OPC UA in node Edge Gateway | NIOT-E-TPI51-EN-RE (Connect) © Hilscher 2017 – 2018 DOC170502UM04EN | Revision 4 | English | 2018-08 | Released | Public...
Page 105: Figure 76: Dialog Box „Add New Opcua Client Config Node
The following figure shows a configured Home tab. Figure 77: Dialog box „Edit opcua in node“ – tab Home Edge Gateway | NIOT-E-TPI51-EN-RE (Connect) © Hilscher 2017 – 2018 DOC170502UM04EN | Revision 4 | English | 2018-08 | Released | Public...
Page 106: Figure 78: Dialog Box Edit Opc Ua In Node - Tab Browse
Tab Mode In the tab Mode you select the parameters for the operating mode Subscribe or Polling (under Transfer). Edge Gateway | NIOT-E-TPI51-EN-RE (Connect) © Hilscher 2017 – 2018 DOC170502UM04EN | Revision 4 | English | 2018-08 | Released | Public...
Page 107: Figure 79: Dialog Box Edit Opc Ua In Node - Tab Mode - Polling
By selecting the option specific you can select the attributes to be transmitted in the payload. Figure 81: OPC UA in - specific payload Edge Gateway | NIOT-E-TPI51-EN-RE (Connect) © Hilscher 2017 – 2018 DOC170502UM04EN | Revision 4 | English | 2018-08 | Released | Public...
Page 108: Figure 82: Options Of The List Repeat
(at every) take place to an exact time range (between and) and defined weekdays. Table 43: Options of the list Repeat Edge Gateway | NIOT-E-TPI51-EN-RE (Connect) © Hilscher 2017 – 2018 DOC170502UM04EN | Revision 4 | English | 2018-08 | Released | Public...
Page 109: Figure 83: Dialog Box Edit Opc Ua In Node - Tab Mode - Subscribe
Number of the elements of the queue Discard old If selected, old values are discarded Table 44: Parameters in Subscription Settings and Monitored Items Settings Edge Gateway | NIOT-E-TPI51-EN-RE (Connect) © Hilscher 2017 – 2018 DOC170502UM04EN | Revision 4 | English | 2018-08 | Released | Public...
Page 110: Opc Ua Output Node
Here you enter the name that is displayed at the node. Table 45: Parameters of the configuration dialog Edit OPC UA out node Edge Gateway | NIOT-E-TPI51-EN-RE (Connect) © Hilscher 2017 – 2018 DOC170502UM04EN | Revision 4 | English | 2018-08 | Released | Public...
Page 111: Figure 86: Dialog Box „Add New Opcua Client Config Node
OPC UA server address, transmitted the OPC UA output node to the Edge Gateway by means of Deploy, and established a connection to the OPC UA server. Edge Gateway | NIOT-E-TPI51-EN-RE (Connect) © Hilscher 2017 – 2018 DOC170502UM04EN | Revision 4 | English | 2018-08 | Released | Public...
Page 112: Examples For Node-Red
ð The inject node can send messages to the debug node. Edge Gateway | NIOT-E-TPI51-EN-RE (Connect) © Hilscher 2017 – 2018 DOC170502UM04EN | Revision 4 | English | 2018-08 | Released | Public...
Page 113 ð The sidebar should display numbers. In the standard default setting, the inject node uses the quantity of milliseconds that have elapsed since January 1st, 1970, as payload. Edge Gateway | NIOT-E-TPI51-EN-RE (Connect) © Hilscher 2017 – 2018 DOC170502UM04EN | Revision 4 | English | 2018-08 | Released | Public...
Page 114: Example 2: Mqtt Input Node
Ø To open the edit dialog, double-click on the MQTT input node. Ê The edit dialog for entering the parameters will be displayed. Edge Gateway | NIOT-E-TPI51-EN-RE (Connect) © Hilscher 2017 – 2018 DOC170502UM04EN | Revision 4 | English | 2018-08 | Released | Public...
Page 115 Ê The dialog box returns to the first edit dialog. Ê Under Server the edit dialog shows the address and the port localhost:1883. Edge Gateway | NIOT-E-TPI51-EN-RE (Connect) © Hilscher 2017 – 2018 DOC170502UM04EN | Revision 4 | English | 2018-08 | Released | Public...
Page 116 The section MQTT input node [} page 97] describes the parameters of the MQTT input node. Edge Gateway | NIOT-E-TPI51-EN-RE (Connect) © Hilscher 2017 – 2018 DOC170502UM04EN | Revision 4 | English | 2018-08 | Released | Public...
Page 117 ð The Debug node displays messages of the MQTT input node as soon as the topic Timestamp1 changes. Edge Gateway | NIOT-E-TPI51-EN-RE (Connect) © Hilscher 2017 – 2018 DOC170502UM04EN | Revision 4 | English | 2018-08 | Released | Public...
Page 118: Example 3: Mqtt Output Node
Ø Click the MQTT output node to display its properties and a functional description in the tab Info. Edge Gateway | NIOT-E-TPI51-EN-RE (Connect) © Hilscher 2017 – 2018 DOC170502UM04EN | Revision 4 | English | 2018-08 | Released | Public...
Page 119 Ê The dialog box returns to the first edit dialog. Ê Under Server the edit dialog shows the address and the port localhost:1883. Edge Gateway | NIOT-E-TPI51-EN-RE (Connect) © Hilscher 2017 – 2018 DOC170502UM04EN | Revision 4 | English | 2018-08 | Released | Public...
Page 120 MQTT output node. The example for copying [{"id":"c28f8355.ed0b7","type":"inject","z":"6b03759e.b5eb4c","name" :"","topic":"","payload":"","payloadType":"date","repeat":"","cronta b":"","once":false,"x":187,"y":163,"wires":[["9bc7b36a.df3c3"]]}, {"id":"9bc7b36a.df3c3","type":"mqtt out","z":"6b03759e.b5eb4c","name":"MyPublishingNode","topic":"Timest amp1","qos":"1","retain":"","broker":"cf82b7fc.b44d18","x":461,"y":1 63,"wires":[]},{"id":"cf82b7fc.b44d18","type":"mqtt- broker","z":"6b03759e.b5eb4c","broker":"localhost","port":"1883","cl ientid":"","usetls":false,"compatmode":true,"keepalive":"60","cleans ession":true,"willTopic":"","willQos":"0","willPayload":"","birthTop ic":"","birthQos":"0","birthPayload":""}] Edge Gateway | NIOT-E-TPI51-EN-RE (Connect) © Hilscher 2017 – 2018 DOC170502UM04EN | Revision 4 | English | 2018-08 | Released | Public...
Page 121 MQTT broker. If you use this example together with the example MQTT input node, you can display the value of the topic Timestamp1 in the tab Debug. Edge Gateway | NIOT-E-TPI51-EN-RE (Connect) © Hilscher 2017 – 2018 DOC170502UM04EN | Revision 4 | English | 2018-08 | Released | Public...
Page 122: Example 4: Opc Ua Input Node
Ø Click the OPC UA input node to display its properties and a functional description in the tab Info. Edge Gateway | NIOT-E-TPI51-EN-RE (Connect) © Hilscher 2017 – 2018 DOC170502UM04EN | Revision 4 | English | 2018-08 | Released | Public...
Page 123 Ê The dialog box returns to the first edit dialog. Ê Under Server the edit dialog displays the IP-address and the port. Edge Gateway | NIOT-E-TPI51-EN-RE (Connect) © Hilscher 2017 – 2018 DOC170502UM04EN | Revision 4 | English | 2018-08 | Released | Public...
Page 124 Ê If the OPC UA node has a connection to the server, the node reads and displays the address space of the server. Edge Gateway | NIOT-E-TPI51-EN-RE (Connect) © Hilscher 2017 – 2018 DOC170502UM04EN | Revision 4 | English | 2018-08 | Released | Public...
Page 125 Ø Under Repeat select how often and when the object is to be read, e.g. interval and 10 seconds so that the object is read every 10 seconds. Edge Gateway | NIOT-E-TPI51-EN-RE (Connect) © Hilscher 2017 – 2018 DOC170502UM04EN | Revision 4 | English | 2018-08 | Released | Public...
Page 126 The blue circle indicates that the modified node has not yet been transferred into the Edge Gateway. Edge Gateway | NIOT-E-TPI51-EN-RE (Connect) © Hilscher 2017 – 2018 DOC170502UM04EN | Revision 4 | English | 2018-08 | Released | Public...
Page 127 Debug node displays every 10 seconds messages of the OPC UA node which contains the value of the object read. Edge Gateway | NIOT-E-TPI51-EN-RE (Connect) © Hilscher 2017 – 2018 DOC170502UM04EN | Revision 4 | English | 2018-08 | Released | Public...
Page 128: Example 5: Opc Ua Output Node
Ø In the field Name enter the name of this node, e.g. Write number 1. Ê All parameters are entered. Edge Gateway | NIOT-E-TPI51-EN-RE (Connect) © Hilscher 2017 – 2018 DOC170502UM04EN | Revision 4 | English | 2018-08 | Released | Public...
Page 129 Ê The red triangle the OPC UA output node is displayed with indicates that the node still needs some more parameters which you have to configure in the following steps. Edge Gateway | NIOT-E-TPI51-EN-RE (Connect) © Hilscher 2017 – 2018 DOC170502UM04EN | Revision 4 | English | 2018-08 | Released | Public...
Page 130 Ø To open the edit dialog, double-click on the OPC UA output node. Ê The edit dialog for entering the parameters will be displayed. Edge Gateway | NIOT-E-TPI51-EN-RE (Connect) © Hilscher 2017 – 2018 DOC170502UM04EN | Revision 4 | English | 2018-08 | Released | Public...
Page 131 Ê If the OPC UA node has a connection to the server, node status connected will be displayed. Edge Gateway | NIOT-E-TPI51-EN-RE (Connect) © Hilscher 2017 – 2018 DOC170502UM04EN | Revision 4 | English | 2018-08 | Released | Public...
Page 132 Ø In the field Topic enter the name of the topic, e.g. Write_DOUT1. Ø In the field Name enter the name of the node, e.g. Write_DOUT1. Edge Gateway | NIOT-E-TPI51-EN-RE (Connect) © Hilscher 2017 – 2018 DOC170502UM04EN | Revision 4 | English | 2018-08 | Released | Public...
Page 133 Inject node to the input port of the OPC UA node. Ø Connect the second Inject node with the OPC UA output node. Ê The nodes are connected. Edge Gateway | NIOT-E-TPI51-EN-RE (Connect) © Hilscher 2017 – 2018 DOC170502UM04EN | Revision 4 | English | 2018-08 | Released | Public...
Page 134 Ø Click the button to the left of Inject node 2. Ê Value 2 will be written to object DOUT1 in the OPC UA server. Edge Gateway | NIOT-E-TPI51-EN-RE (Connect) © Hilscher 2017 – 2018 DOC170502UM04EN | Revision 4 | English | 2018-08 | Released | Public...
Page 135: Example 6: Fieldbus Input Node
Ø Click the tab Info. Ø Click thefieldbus input node to display its properties and a functional description in the tab Info. Edge Gateway | NIOT-E-TPI51-EN-RE (Connect) © Hilscher 2017 – 2018 DOC170502UM04EN | Revision 4 | English | 2018-08 | Released | Public...
Page 136 Add new fieldbus interface), click Edit to add a new fieldbus interface. Ê The fieldbus configuration node will be displayed. Edge Gateway | NIOT-E-TPI51-EN-RE (Connect) © Hilscher 2017 – 2018 DOC170502UM04EN | Revision 4 | English | 2018-08 | Released | Public...
Page 137 Ø Then, double-click the entry 16 receive byte (outputs) in the list of Available IO items. Ê The list of IO items displays 2 PROFINET modules. Edge Gateway | NIOT-E-TPI51-EN-RE (Connect) © Hilscher 2017 – 2018 DOC170502UM04EN | Revision 4 | English | 2018-08 | Released | Public...
Page 138 Ê Column Tag displays Temperature_1 to Temperature_8. If required, you can adapt the signal names in the column Tag. Edge Gateway | NIOT-E-TPI51-EN-RE (Connect) © Hilscher 2017 – 2018 DOC170502UM04EN | Revision 4 | English | 2018-08 | Released | Public...
Page 139 Ê The display returns to the edit dialog. 13. Entering names: Ø Under Name enter a node name e.g. MyInput. Edge Gateway | NIOT-E-TPI51-EN-RE (Connect) © Hilscher 2017 – 2018 DOC170502UM04EN | Revision 4 | English | 2018-08 | Released | Public...
Page 140 ð As soon as the value of the signal changes, the Debug output will display the changed value/s and status information. Edge Gateway | NIOT-E-TPI51-EN-RE (Connect) © Hilscher 2017 – 2018 DOC170502UM04EN | Revision 4 | English | 2018-08 | Released | Public...
Page 141: Figure 93: Message Of The Fieldbus Input Node (Without Error)
Set_temperature_2. The value 0 for "Error" indicates that the cyclic PROFINET communication works without problems. Figure 93: Message of the fieldbus input node (without error) Edge Gateway | NIOT-E-TPI51-EN-RE (Connect) © Hilscher 2017 – 2018 DOC170502UM04EN | Revision 4 | English | 2018-08 | Released | Public...
Page 142: Figure 94: Message Of The Fieldbus Input Node (With Error)
The following figure displays a value for "Error" that is unequal to 0, i.e. the PROFINET communication does not work. Figure 94: Message of the fieldbus input node (with error) Edge Gateway | NIOT-E-TPI51-EN-RE (Connect) © Hilscher 2017 – 2018 DOC170502UM04EN | Revision 4 | English | 2018-08 | Released | Public...
Page 143: Example 7: Fieldbus Output Node
1. Inserting the first Inject node: Ø Drag an Inject node from the node library and drop it in the worksheet. Edge Gateway | NIOT-E-TPI51-EN-RE (Connect) © Hilscher 2017 – 2018 DOC170502UM04EN | Revision 4 | English | 2018-08 | Released | Public...
Page 144 3. Inserting the second Inject node: Ø Drag another Inject node from the node library and drop it in the worksheet. Edge Gateway | NIOT-E-TPI51-EN-RE (Connect) © Hilscher 2017 – 2018 DOC170502UM04EN | Revision 4 | English | 2018-08 | Released | Public...
Page 145 Ê The red triangle the fieldbus node is displayed with indicates that the node still needs some more parameters which you have to configure in the following steps. Edge Gateway | NIOT-E-TPI51-EN-RE (Connect) © Hilscher 2017 – 2018 DOC170502UM04EN | Revision 4 | English | 2018-08 | Released | Public...
Page 146 Ø If it is not displayed, use to select the entry PROFINET IO Device under fieldbus interface and click Reconfigure. Edge Gateway | NIOT-E-TPI51-EN-RE (Connect) © Hilscher 2017 – 2018 DOC170502UM04EN | Revision 4 | English | 2018-08 | Released | Public...
Page 147 Ê The new Tagname which is part of the entire signal name is now displayed for each module. Edge Gateway | NIOT-E-TPI51-EN-RE (Connect) © Hilscher 2017 – 2018 DOC170502UM04EN | Revision 4 | English | 2018-08 | Released | Public...
Page 148 Ê The PROFINET configuration and signal definition are saved in the Edge Gateway, but they are not activated yet. Edge Gateway | NIOT-E-TPI51-EN-RE (Connect) © Hilscher 2017 – 2018 DOC170502UM04EN | Revision 4 | English | 2018-08 | Released | Public...
Page 149 Ø Click Deploy to transmit the nodes, that have so far existed in the editor only, to the device and activate them. ð The flow is activated in the Edge Gateway. Edge Gateway | NIOT-E-TPI51-EN-RE (Connect) © Hilscher 2017 – 2018 DOC170502UM04EN | Revision 4 | English | 2018-08 | Released | Public...
Page 150 ð Signal Temperature_2 is set to value 2 and transferred to the PROFINET IO Controller. Ø At the PROFINET IO Controller, display the input data in a window. Edge Gateway | NIOT-E-TPI51-EN-RE (Connect) © Hilscher 2017 – 2018 DOC170502UM04EN | Revision 4 | English | 2018-08 | Released | Public...
Page 151: Configuring And Using The Fieldbus Node
2. Configuring the fieldbus system (e.g. PROFINET) 3. Defining the signals 4. Configuring the fieldbus output node Table 46: Standard procedure Edge Gateway | NIOT-E-TPI51-EN-RE (Connect) © Hilscher 2017 – 2018 DOC170502UM04EN | Revision 4 | English | 2018-08 | Released | Public...
Page 152: Table 47: Configuration Steps
Configure modules node Fieldbus node (configured) Project > Save Define signals Reconfigure / Update Deploy Table 47: Configuration steps Edge Gateway | NIOT-E-TPI51-EN-RE (Connect) © Hilscher 2017 – 2018 DOC170502UM04EN | Revision 4 | English | 2018-08 | Released | Public...
Page 153: Configuring The Fieldbus And Defining The Signals
Ê The edit dialog Add new fieldbus interface config node will be displayed. 2. Opening the PROFINET configuration Ø Click the square to the right of fieldbus interface Edge Gateway | NIOT-E-TPI51-EN-RE (Connect) © Hilscher 2017 – 2018 DOC170502UM04EN | Revision 4 | English | 2018-08 | Released | Public...
Page 154: Figure 97: Dialog Box "Add New Fieldbus Interface Config Node
Figure 98: Dialog box “Add new fieldbus interface config node” Edge Gateway | NIOT-E-TPI51-EN-RE (Connect) © Hilscher 2017 – 2018 DOC170502UM04EN | Revision 4 | English | 2018-08 | Released | Public...
Page 155: Figure 99: Profinet Configuration
ð The user interface for the fieldbus configuration of the Edge Gateway will be opened in a new browser window: (the example shows the PROFINET configuration) Figure 99: PROFINET configuration Edge Gateway | NIOT-E-TPI51-EN-RE (Connect) © Hilscher 2017 – 2018 DOC170502UM04EN | Revision 4 | English | 2018-08 | Released | Public...
Page 156: Figure 100: Available Io Items (Example In Figure: Profinet)
IO items in einer neuen Zeile angezeigt. Figure 101: IO items (Example: PROFINET) Edge Gateway | NIOT-E-TPI51-EN-RE (Connect) © Hilscher 2017 – 2018 DOC170502UM04EN | Revision 4 | English | 2018-08 | Released | Public...
Page 157 Ø Save your signal configuration via the menu function Project > Save. Ø The configuration is prepared. Ø Return to the Node-RED browser window that was originally used. Edge Gateway | NIOT-E-TPI51-EN-RE (Connect) © Hilscher 2017 – 2018 DOC170502UM04EN | Revision 4 | English | 2018-08 | Released | Public...
Page 158: Figure 102: Dialog Box "Add New Fieldbus Interface Config Node
ð The flow will thus be transmitted to the Edge Gateway, and the new configuration will be applied in the Edge Gateway. Edge Gateway | NIOT-E-TPI51-EN-RE (Connect) © Hilscher 2017 – 2018 DOC170502UM04EN | Revision 4 | English | 2018-08 | Released | Public...
Page 159: Figure 103: Error Message - Firmware Mismatch
For a detailed description of what happens when you click at Reconfigure interface, see Loading firmware and configuration [} page 166]. Edge Gateway | NIOT-E-TPI51-EN-RE (Connect) © Hilscher 2017 – 2018 DOC170502UM04EN | Revision 4 | English | 2018-08 | Released | Public...
Page 160: Changing The Existing Fieldbus Configuration
Figure 105: Fieldbus node Ê The edit dialog Edit fieldbus in node will be displayed. Figure 106: Dialog Edit fieldbus in node Edge Gateway | NIOT-E-TPI51-EN-RE (Connect) © Hilscher 2017 – 2018 DOC170502UM04EN | Revision 4 | English | 2018-08 | Released | Public...
Page 161: Figure 107: Dialog Edit Fieldbus In Node
Figure 107: Dialog Edit fieldbus in node Ø Select the interface to be changed (in the example this is cifX0 PROFINET...). Edge Gateway | NIOT-E-TPI51-EN-RE (Connect) © Hilscher 2017 – 2018 DOC170502UM04EN | Revision 4 | English | 2018-08 | Released | Public...
Page 162: Figure 108: Dialog "Edit Fieldbus Interface Config Node
Gateway does not process the received data anymore. Ø Click Open fieldbus configurator. Figure 109: Button Open fieldbus configurator Edge Gateway | NIOT-E-TPI51-EN-RE (Connect) © Hilscher 2017 – 2018 DOC170502UM04EN | Revision 4 | English | 2018-08 | Released | Public...
Page 163: Figure 110: Start Screen Of The User Interface For Fieldbus Configuration Of The Netiot Edge Gateway (The Example In The Figure Shows Profinet)
Ê The steps to be made in the user interface for fieldbus configuration of the Edge Gateway are thus completed. Ø Return to the Node-RED browser window that was originally used. Edge Gateway | NIOT-E-TPI51-EN-RE (Connect) © Hilscher 2017 – 2018 DOC170502UM04EN | Revision 4 | English | 2018-08 | Released | Public...
Page 164: Figure 111: Dialog Edit Fieldbus Interface Node
Ê This operation causes the transmission of the fieldbus configuration (in this case: PROFINET) to the device and the update of the signal definitions to the fieldbus node: Edge Gateway | NIOT-E-TPI51-EN-RE (Connect) © Hilscher 2017 – 2018 DOC170502UM04EN | Revision 4 | English | 2018-08 | Released | Public...
Page 165: Figure 112: Error Message - Firmware Mismatch
That means that the expected firmware and the actually determined firmware do not match. Check your settings in such a case! Edge Gateway | NIOT-E-TPI51-EN-RE (Connect) © Hilscher 2017 – 2018 DOC170502UM04EN | Revision 4 | English | 2018-08 | Released | Public...
Page 166: Loading Firmware And Configuration
(the network communication of the Gateway will stop, modifications to the network configuration will be lost). Edge Gateway | NIOT-E-TPI51-EN-RE (Connect) © Hilscher 2017 – 2018 DOC170502UM04EN | Revision 4 | English | 2018-08 | Released | Public...
Page 167 3. The bootloader will be executed to load the selected firmware into the Edge Gateway. 4. The new firmware loaded will be started. Edge Gateway | NIOT-E-TPI51-EN-RE (Connect) © Hilscher 2017 – 2018 DOC170502UM04EN | Revision 4 | English | 2018-08 | Released | Public...
Page 168: Configuring Profinet And Defining Signals
(see Help - Contents [} page 170]), and · display the software version of the configuration GUI (see Help - · Information [} page 170]). Edge Gateway | NIOT-E-TPI51-EN-RE (Connect) © Hilscher 2017 – 2018 DOC170502UM04EN | Revision 4 | English | 2018-08 | Released | Public...
Page 169: Project - Save
Ø Select a printer or an output file and set the printing parameters. ð The current configuration and signal definition will be printed. Edge Gateway | NIOT-E-TPI51-EN-RE (Connect) © Hilscher 2017 – 2018 DOC170502UM04EN | Revision 4 | English | 2018-08 | Released | Public...
Page 170: Help - Contents
To display the version of the PROFINET configuration software of the netIOT Edge Gateway, proceed as follows: Ø Click Help > Info. ð The version will be displayed. Edge Gateway | NIOT-E-TPI51-EN-RE (Connect) © Hilscher 2017 – 2018 DOC170502UM04EN | Revision 4 | English | 2018-08 | Released | Public...
Page 171: Configuration Tree
PROFINET IO controller or a stand-alone tool. For this purpose the tools use the DCP protocol. Edge Gateway | NIOT-E-TPI51-EN-RE (Connect) © Hilscher 2017 – 2018 DOC170502UM04EN | Revision 4 | English | 2018-08 | Released | Public...
Page 172: Figure 117: List Of The Possible Input And Output Modules
Shows the start address of the module (offset in bytes) in the input- and output data memory. The offset is calculated automatically. Table 50: Contents of the table “IO items” Edge Gateway | NIOT-E-TPI51-EN-RE (Connect) © Hilscher 2017 – 2018 DOC170502UM04EN | Revision 4 | English | 2018-08 | Released | Public...
Page 173: Table 51: Controls Of The Table "Io Items
Enter key. Table 51: Controls of the table “IO Items” Edge Gateway | NIOT-E-TPI51-EN-RE (Connect) © Hilscher 2017 – 2018 DOC170502UM04EN | Revision 4 | English | 2018-08 | Released | Public...
Page 174: Figure 119: Selected Io Item (Module) For Which You Define Signals
Figure 120: List of the signal names of an IO item (module) Edge Gateway | NIOT-E-TPI51-EN-RE (Connect) © Hilscher 2017 – 2018 DOC170502UM04EN | Revision 4 | English | 2018-08 | Released | Public...
Page 175: Table 53: Contents Of The Table „Signals
Enter key. Table 54: Controls of the table „Signals“ Edge Gateway | NIOT-E-TPI51-EN-RE (Connect) © Hilscher 2017 – 2018 DOC170502UM04EN | Revision 4 | English | 2018-08 | Released | Public...
Page 176: Table 55: Data Types For Signal Names
5. You can enter the name for signal_tag or bitlist_signal_tag as described in section Defining signals (procedure) [} page 178]. Edge Gateway | NIOT-E-TPI51-EN-RE (Connect) © Hilscher 2017 – 2018 DOC170502UM04EN | Revision 4 | English | 2018-08 | Released | Public...
Page 177: Figure 121: List Of The Configured Input And Output Modules
PROFINET configuration. In the next step define the signal names as described in section Defining signals (procedure) [} page 178]. Edge Gateway | NIOT-E-TPI51-EN-RE (Connect) © Hilscher 2017 – 2018 DOC170502UM04EN | Revision 4 | English | 2018-08 | Released | Public...
Page 178 Ø Click Delete selected items. Ê The predefined signal is deleted and you can define your own signals. Edge Gateway | NIOT-E-TPI51-EN-RE (Connect) © Hilscher 2017 – 2018 DOC170502UM04EN | Revision 4 | English | 2018-08 | Released | Public...
Page 179 6. Defining signals: Ø Repeat steps 1‑5 until you have defined all required signals. ð The signal definition is prepared. Edge Gateway | NIOT-E-TPI51-EN-RE (Connect) © Hilscher 2017 – 2018 DOC170502UM04EN | Revision 4 | English | 2018-08 | Released | Public...
Page 180 The name in the column Tag is a part of the signal name and is described as Signal_tag or Bitlist_signal_tag in section Structure of the signal names [} page 176]. Edge Gateway | NIOT-E-TPI51-EN-RE (Connect) © Hilscher 2017 – 2018 DOC170502UM04EN | Revision 4 | English | 2018-08 | Released | Public...
Page 181: Figure 122: List Of The Send And Receive Signals
Table 56: Columns of the table of the send and receive signals You can print the table using Print > Print configuration. Edge Gateway | NIOT-E-TPI51-EN-RE (Connect) © Hilscher 2017 – 2018 DOC170502UM04EN | Revision 4 | English | 2018-08 | Released | Public...
Page 182: Help
Page with the contents of the online help (currently empty) Info This page displays the version of the PROFINET configuration software. Edge Gateway | NIOT-E-TPI51-EN-RE (Connect) © Hilscher 2017 – 2018 DOC170502UM04EN | Revision 4 | English | 2018-08 | Released | Public...
Page 183: Configuring Ethernet/Ip And Defining Signals
(see Help - Contents [} page 185]), and · display the software version of the configuration GUI (see Help - Information [} page 185]). Edge Gateway | NIOT-E-TPI51-EN-RE (Connect) © Hilscher 2017 – 2018 DOC170502UM04EN | Revision 4 | English | 2018-08 | Released | Public...
Page 184: Project - Save
Ø Select a folder and then click Save. Ø Use the saved EDS file to configure the EtherNet/IP Scanner. Edge Gateway | NIOT-E-TPI51-EN-RE (Connect) © Hilscher 2017 – 2018 DOC170502UM04EN | Revision 4 | English | 2018-08 | Released | Public...
Page 185: Printing The Configuration
To display the version of the EtherNet/IP configuration software of the netIOT Edge Gateway, proceed as follows: Ø Click Help > Info. ð The version will be displayed. Edge Gateway | NIOT-E-TPI51-EN-RE (Connect) © Hilscher 2017 – 2018 DOC170502UM04EN | Revision 4 | English | 2018-08 | Released | Public...
Page 186: Figure 124: Ip Settings
Network mask of Edge Gateway · IP address of the gateway, to which the Edge Gateway is connected within the IP network Edge Gateway | NIOT-E-TPI51-EN-RE (Connect) © Hilscher 2017 – 2018 DOC170502UM04EN | Revision 4 | English | 2018-08 | Released | Public...
Page 187: Io And Signal Configuration
Min_length and Max_length). The lower table (IO items) displays the EtherNet/IP configuration and is empty at the beginning. Edge Gateway | NIOT-E-TPI51-EN-RE (Connect) © Hilscher 2017 – 2018 DOC170502UM04EN | Revision 4 | English | 2018-08 | Released | Public...
Page 188: Figure 125: List Of The Possible Send And Receive Assemblies
Do not enter two or more underscores in succession. To open the signal configuration of the respective assembly, double-click any line. Edge Gateway | NIOT-E-TPI51-EN-RE (Connect) © Hilscher 2017 – 2018 DOC170502UM04EN | Revision 4 | English | 2018-08 | Released | Public...
Page 189: Figure 127: Selected Io Item (Assembly) For Which You Define Signals
Shows the start address of the assembly (offset in bytes) in the input- and output data memory. The offset is calculated automatically. Table 62: Contents of the table „IO items“ Edge Gateway | NIOT-E-TPI51-EN-RE (Connect) © Hilscher 2017 – 2018 DOC170502UM04EN | Revision 4 | English | 2018-08 | Released | Public...
Page 190: Figure 128: List Of The Signal Names Of An Io Item (Assembly)
(a-z), · numbers (0-9), and the underscore. · Do not enter two or more underscores in succession. Edge Gateway | NIOT-E-TPI51-EN-RE (Connect) © Hilscher 2017 – 2018 DOC170502UM04EN | Revision 4 | English | 2018-08 | Released | Public...
Page 191: Table 64: Controls Of The Table „Signals
Real (Floating point ) 32 ≈ -/+ 10 real64 Long real ≈ -/+ 10 Table 65: Data types for signal names Edge Gateway | NIOT-E-TPI51-EN-RE (Connect) © Hilscher 2017 – 2018 DOC170502UM04EN | Revision 4 | English | 2018-08 | Released | Public...
Page 192: Figure 126: List Of The Configured Send And Receive Assemblies
Item“ line has been marked, or before a marked „IO item“ line. Figure 129: List of the configured send and receive assemblies Edge Gateway | NIOT-E-TPI51-EN-RE (Connect) © Hilscher 2017 – 2018 DOC170502UM04EN | Revision 4 | English | 2018-08 | Released | Public...
Page 193 If you want to access each single bit, define 16 signals of data type bit each. Edge Gateway | NIOT-E-TPI51-EN-RE (Connect) © Hilscher 2017 – 2018 DOC170502UM04EN | Revision 4 | English | 2018-08 | Released | Public...
Page 194 5. Defining signals: Ø Repeat steps 1‑5 until you have defined all required signals. ð The signal definition is prepared. Edge Gateway | NIOT-E-TPI51-EN-RE (Connect) © Hilscher 2017 – 2018 DOC170502UM04EN | Revision 4 | English | 2018-08 | Released | Public...
Page 195 The name in the column Tag is a part of the signal name and is described as Signal_tag or Bitlist_signal_tag in section Structure of the signal names [} page 192]. Edge Gateway | NIOT-E-TPI51-EN-RE (Connect) © Hilscher 2017 – 2018 DOC170502UM04EN | Revision 4 | English | 2018-08 | Released | Public...
Page 196: Signal Definitions Overview
Table 66: Columns of the table of the send and receive signals You can print this table using Print > Print configuration. Edge Gateway | NIOT-E-TPI51-EN-RE (Connect) © Hilscher 2017 – 2018 DOC170502UM04EN | Revision 4 | English | 2018-08 | Released | Public...
Page 197: Download Of The Eds File
Info This page only displays the current version of the EtherNet/IP configuration software. See Help - Information [} page 185]. Edge Gateway | NIOT-E-TPI51-EN-RE (Connect) © Hilscher 2017 – 2018 DOC170502UM04EN | Revision 4 | English | 2018-08 | Released | Public...
Page 198: Edge Server
The Configuration of the Edge Server [} page 206] 14.1 Function principle The Edge Server is a software component that has been developed by Hilscher and is · executed under the Linux operating system of the Edge Gateway. enables secure and capsuled access from the IT-network to functions ·...
Page 199: Figure 131: Edge Server Structure
Figure 131: Edge Server structure Note: For more information on the protocol HTTPS, see https:// en.wikipedia.org/wiki/HTTPS, on REST APIs, see https:// en.wikipedia.org/wiki/Representational_State_Transfer. Edge Gateway | NIOT-E-TPI51-EN-RE (Connect) © Hilscher 2017 – 2018 DOC170502UM04EN | Revision 4 | English | 2018-08 | Released | Public...
Page 200: Communication With The Ot-Network
4. Granting read and right access rights requires administrator rights and is described in section Managing user roles [} page 65]. Edge Gateway | NIOT-E-TPI51-EN-RE (Connect) © Hilscher 2017 – 2018 DOC170502UM04EN | Revision 4 | English | 2018-08 | Released | Public...
Page 201: Functions Of The Edge Server
For a detailed description of the functions and parameters provided by the netIOT Edge Server API, see http://www.netiot.com/external/stkit-doku/. Edge Gateway | NIOT-E-TPI51-EN-RE (Connect) © Hilscher 2017 – 2018 DOC170502UM04EN | Revision 4 | English | 2018-08 | Released | Public...
Page 202: Internal Structure Of The Edge Server
The following figure shows the internal structure of the Edge Server for the Edge Gateways: Figure 133: Internal structure of the Edge Server Edge Gateway | NIOT-E-TPI51-EN-RE (Connect) © Hilscher 2017 – 2018 DOC170502UM04EN | Revision 4 | English | 2018-08 | Released | Public...
Page 203: Edge Server Control Center
Information on the Edge Server · Configuration of the Edge Server · List of services · Scan protocols of field devices Edge Gateway | NIOT-E-TPI51-EN-RE (Connect) © Hilscher 2017 – 2018 DOC170502UM04EN | Revision 4 | English | 2018-08 | Released | Public...
Page 204: Service List
For this service, an error message has been stored. Table 68: Symbols for the state of operation in the service list Edge Gateway | NIOT-E-TPI51-EN-RE (Connect) © Hilscher 2017 – 2018 DOC170502UM04EN | Revision 4 | English | 2018-08 | Released | Public...
Page 205 Operating status (displayed as text) · Last information · Version · Description · · Information on the author Edge Gateway | NIOT-E-TPI51-EN-RE (Connect) © Hilscher 2017 – 2018 DOC170502UM04EN | Revision 4 | English | 2018-08 | Released | Public...
Page 206: Configuration Of The Edge Server
Configuration. Ê The configuration screen page displays the settings for the server configuration. Figure 136: Server configuration Edge Gateway | NIOT-E-TPI51-EN-RE (Connect) © Hilscher 2017 – 2018 DOC170502UM04EN | Revision 4 | English | 2018-08 | Released | Public...
Page 207: Figure 137: Configuration Of The Scan Settings
IP-address range, the entered IP-addresses must fall into the range of the cifX0 network and its IP-address. Edge Gateway | NIOT-E-TPI51-EN-RE (Connect) © Hilscher 2017 – 2018 DOC170502UM04EN | Revision 4 | English | 2018-08 | Released | Public...
Page 208: Figure 138: Correct Configuration Of The Scan Settings
ð Now, the screen page for the scan settings should look like that: Figure 138: Correct configuration of the scan settings Edge Gateway | NIOT-E-TPI51-EN-RE (Connect) © Hilscher 2017 – 2018 DOC170502UM04EN | Revision 4 | English | 2018-08 | Released | Public...
Page 209: Selecting The Protocols To Scan For Field Devices
Ø To save your settings in the Edge Server, click ð Thus, your scan protocol settings of the field devices are saved. Edge Gateway | NIOT-E-TPI51-EN-RE (Connect) © Hilscher 2017 – 2018 DOC170502UM04EN | Revision 4 | English | 2018-08 | Released | Public...
Page 210: Isolated Application Execution With Docker
This GUI provides the essential functions for managing the Docker services. Note: For more information on portainer.io, see http://portainer.io. Edge Gateway | NIOT-E-TPI51-EN-RE (Connect) © Hilscher 2017 – 2018 DOC170502UM04EN | Revision 4 | English | 2018-08 | Released | Public...
Page 211 For more information on images, see the Docker documentation https://docs.docker.com/engine/docker-overview/%23docker- objects and, in particular, its glossary https://docs.docker.com/ glossary/?term=image. Edge Gateway | NIOT-E-TPI51-EN-RE (Connect) © Hilscher 2017 – 2018 DOC170502UM04EN | Revision 4 | English | 2018-08 | Released | Public...
Page 212 Note: For more information on containers, see the Docker documentation (https://docs.docker.com/get-started/#prerequisites) and, in particular, its glossary (https://docs.docker.com/glossary/? term=container). Edge Gateway | NIOT-E-TPI51-EN-RE (Connect) © Hilscher 2017 – 2018 DOC170502UM04EN | Revision 4 | English | 2018-08 | Released | Public...
Page 213: Working With Docker Via The Web Gui
Edge Gateway Manager, see User management [} page 65]. Ê The start page "Dashboard" of the user interface portainer.io will be displayed. Edge Gateway | NIOT-E-TPI51-EN-RE (Connect) © Hilscher 2017 – 2018 DOC170502UM04EN | Revision 4 | English | 2018-08 | Released | Public...
Page 214: Figure 141: View Of Portainer.io Dashboard
Figure 142: Container list (portainer.io) Edge Gateway | NIOT-E-TPI51-EN-RE (Connect) © Hilscher 2017 – 2018 DOC170502UM04EN | Revision 4 | English | 2018-08 | Released | Public...
Page 215: Example: Executing The Web Server Nginx As A Container
80, used by NGINX as standard, e.g. to port 8080 and make it accessible for the web browser. Edge Gateway | NIOT-E-TPI51-EN-RE (Connect) © Hilscher 2017 – 2018 DOC170502UM04EN | Revision 4 | English | 2018-08 | Released | Public...
Page 216: Figure 143: Nginx Example - Screen Page "Create Container
Ø Field container: Enter the port, e.g. 80, that NGINX uses within the container. Figure 143: NGINX example - screen page "Create container" Edge Gateway | NIOT-E-TPI51-EN-RE (Connect) © Hilscher 2017 – 2018 DOC170502UM04EN | Revision 4 | English | 2018-08 | Released | Public...
Page 217 Ø Enter the following address in the adress line of your web browser: http://<IP-address of your device>:8080 ð The NGINX-start screen will be displayed. Edge Gateway | NIOT-E-TPI51-EN-RE (Connect) © Hilscher 2017 – 2018 DOC170502UM04EN | Revision 4 | English | 2018-08 | Released | Public...
Page 218: Public Key Infrastructure
Edge Gateway | NIOT-E-TPI51-EN-RE (Connect) © Hilscher 2017 – 2018 DOC170502UM04EN | Revision 4 | English | 2018-08 | Released | Public...
Page 219: Figure 144: Process Of Asymmetric Encryption
5. The server decrpyt the message using his private key. 6. Client and server continue its encrypted communication using one new created protected transmitted key (symmetric communication). Edge Gateway | NIOT-E-TPI51-EN-RE (Connect) © Hilscher 2017 – 2018 DOC170502UM04EN | Revision 4 | English | 2018-08 | Released | Public...
Page 220: Certificates And Keys
Country or region State Location Table 70: Attributes concerning the issuer and owner of the certificate zum Zertifikats- Aussteller und Zertifikats-Inhaber Edge Gateway | NIOT-E-TPI51-EN-RE (Connect) © Hilscher 2017 – 2018 DOC170502UM04EN | Revision 4 | English | 2018-08 | Released | Public...
Page 221: Hierarchy Of Trust
The display of root certificates in the Control Panel of the Edge Gateway follows this list. Edge Gateway | NIOT-E-TPI51-EN-RE (Connect) © Hilscher 2017 – 2018 DOC170502UM04EN | Revision 4 | English | 2018-08 | Released | Public...
Page 222: File Formats For Certificate And Key Files
Use case 2: Server certificates for Edge Gateway services [} page 224] Use case 3: Client certificates for specific servers [} page 226] Edge Gateway | NIOT-E-TPI51-EN-RE (Connect) © Hilscher 2017 – 2018 DOC170502UM04EN | Revision 4 | English | 2018-08 | Released | Public...
Page 223: Use Case 1: Verification Of The Authenticity Of The Communication Partner (Server)
For details about “How to work with the certificates of this list (Upload, Download, Removal, Creation, Show List)”, see section Working with root certificates [} page 228]. Edge Gateway | NIOT-E-TPI51-EN-RE (Connect) © Hilscher 2017 – 2018 DOC170502UM04EN | Revision 4 | English | 2018-08 | Released | Public...
Page 224: Use Case 2: Server Certificates For Edge Gateway Services
Both files have the PEM file format, see section File formats for certificate and key files [} page 222]. Edge Gateway | NIOT-E-TPI51-EN-RE (Connect) © Hilscher 2017 – 2018 DOC170502UM04EN | Revision 4 | English | 2018-08 | Released | Public...
Page 225: Table 71: Edge Gateway Services
For details about “How to work with the certificates and key files (Upload, Download, Removal, Creation)”, see section Working with server certificates for inbound connections [} page 230]. Edge Gateway | NIOT-E-TPI51-EN-RE (Connect) © Hilscher 2017 – 2018 DOC170502UM04EN | Revision 4 | English | 2018-08 | Released | Public...
Page 226: Use Case 3: Client Certificates For Specific Servers
Server using the authentication based-on client certificates. The file names Certificate file node-opcuaclient_cert.pem and · · File with the private key node-opcuaclient_key.pem Edge Gateway | NIOT-E-TPI51-EN-RE (Connect) © Hilscher 2017 – 2018 DOC170502UM04EN | Revision 4 | English | 2018-08 | Released | Public...
Page 227 Edge Gateway [} page 240] How to accomplish these, describes section Working with client authentication certificates for outbound connections [} page 235]. Edge Gateway | NIOT-E-TPI51-EN-RE (Connect) © Hilscher 2017 – 2018 DOC170502UM04EN | Revision 4 | English | 2018-08 | Released | Public...
Page 228: Working With Root Certificates
Ø If you are really sure to need the current certificate file not any longer, click at Yes. ð The certificate file is being uploaded into the Edge Gateway. Edge Gateway | NIOT-E-TPI51-EN-RE (Connect) © Hilscher 2017 – 2018 DOC170502UM04EN | Revision 4 | English | 2018-08 | Released | Public...
Page 229: Download Of Certificates From The Edge Gateway Into A File
Adding a new trustworthy certificate to the trusted certification authority store of the Edge Gateway This functionality is currently not supported. Edge Gateway | NIOT-E-TPI51-EN-RE (Connect) © Hilscher 2017 – 2018 DOC170502UM04EN | Revision 4 | English | 2018-08 | Released | Public...
Page 230: Working With Server Certificates For Inbound Connections
Ø Within window Certificates, select the entry cert.pem below nginx. Alternatively: If the server certificate applies to the communication with the OPC UA-Server or mosquitto: Edge Gateway | NIOT-E-TPI51-EN-RE (Connect) © Hilscher 2017 – 2018 DOC170502UM04EN | Revision 4 | English | 2018-08 | Released | Public...
Page 231 Edge Gateway and offers you options for further processing of the downloaded file such as Open, Open directory. Edge Gateway | NIOT-E-TPI51-EN-RE (Connect) © Hilscher 2017 – 2018 DOC170502UM04EN | Revision 4 | English | 2018-08 | Released | Public...
Page 232 16.5.1.4 Newly creating a server certificate on the Edge Gateway This functionality is currently not supported. Edge Gateway | NIOT-E-TPI51-EN-RE (Connect) © Hilscher 2017 – 2018 DOC170502UM04EN | Revision 4 | English | 2018-08 | Released | Public...
Page 233: Working With Key Files For Http And Opc Ua Server
HTTP server, Node-RED, the Edge Server or the REST API from a file into the Edge Gateway , a reboot of the Edge Gateways is not necessary. Edge Gateway | NIOT-E-TPI51-EN-RE (Connect) © Hilscher 2017 – 2018 DOC170502UM04EN | Revision 4 | English | 2018-08 | Released | Public...
Page 234 Newly creating a key file for a server certificate on the Edge Gateway This functionality is currently not supported. Edge Gateway | NIOT-E-TPI51-EN-RE (Connect) © Hilscher 2017 – 2018 DOC170502UM04EN | Revision 4 | English | 2018-08 | Released | Public...
Page 235: Working With Client Authentication Certificates For Outbound Connections
Ê In window Certificates, a tree structure is displayed. Ø In window Certificates, select the entry node- opcuaclient_cert.pem below node-red. Edge Gateway | NIOT-E-TPI51-EN-RE (Connect) © Hilscher 2017 – 2018 DOC170502UM04EN | Revision 4 | English | 2018-08 | Released | Public...
Page 236 Ø If you are really sure to need the current key file not any longer, click at Yes. ð The selected certificate file is being removed from the Edge Gateway's Root Certificate Store. Edge Gateway | NIOT-E-TPI51-EN-RE (Connect) © Hilscher 2017 – 2018 DOC170502UM04EN | Revision 4 | English | 2018-08 | Released | Public...
Page 237 ð The path is now being copied into Windows clipboard. You can use it within Node-RED to open and configure the corresponding element within Node-RED. Edge Gateway | NIOT-E-TPI51-EN-RE (Connect) © Hilscher 2017 – 2018 DOC170502UM04EN | Revision 4 | English | 2018-08 | Released | Public...
Page 238: Working With Key Files For Client Authentication
Yes. ð The key file is being uploaded into the Edge Gateway. The former key file is overwritten. Edge Gateway | NIOT-E-TPI51-EN-RE (Connect) © Hilscher 2017 – 2018 DOC170502UM04EN | Revision 4 | English | 2018-08 | Released | Public...
Page 239 Edge Gateway | NIOT-E-TPI51-EN-RE (Connect) © Hilscher 2017 – 2018 DOC170502UM04EN | Revision 4 | English | 2018-08 | Released | Public...
Page 240 ð The path to the key file is now being copied into Windows clipboard. You can use it within Node-RED to open and configure the corresponding Node-RED element. Edge Gateway | NIOT-E-TPI51-EN-RE (Connect) © Hilscher 2017 – 2018 DOC170502UM04EN | Revision 4 | English | 2018-08 | Released | Public...
Page 241: Technical Data
Ambient temperature range for -40°C ... +85°C storage Humidity range 10 % … 95 % relative humidity (non-condensing) Edge Gateway | NIOT-E-TPI51-EN-RE (Connect) © Hilscher 2017 – 2018 DOC170502UM04EN | Revision 4 | English | 2018-08 | Released | Public...
Page 242 (Burst) Surge voltage EN 61000-4-5 Tests Shock IEC 60068-2-27 Ea Vibration IEC 60068-2-6 Fc Table 72: Technical data NIOT-E-TPI51-EN-RE Edge Gateway | NIOT-E-TPI51-EN-RE (Connect) © Hilscher 2017 – 2018 DOC170502UM04EN | Revision 4 | English | 2018-08 | Released | Public...
Page 243: Technical Data Profinet Io Device
Reference to stack version V3.9 Table 73: Technical data PROFINET IO RT IRT Device Protocol Edge Gateway | NIOT-E-TPI51-EN-RE (Connect) © Hilscher 2017 – 2018 DOC170502UM04EN | Revision 4 | English | 2018-08 | Released | Public...
Page 244: Technical Data Ethernet/Ip Adapter
CIP Sync Services are not implemented. TAGs are not supported. Reference to stack version V2.10 Table 74: Technical data EtherNet/IP Adapter protocol Edge Gateway | NIOT-E-TPI51-EN-RE (Connect) © Hilscher 2017 – 2018 DOC170502UM04EN | Revision 4 | English | 2018-08 | Released | Public...
Page 245: Authorizations
20cm between the radiator and your body. This transmitter must not be co-located or operating in conjunction with any other antenna or transmitter. Edge Gateway | NIOT-E-TPI51-EN-RE (Connect) © Hilscher 2017 – 2018 DOC170502UM04EN | Revision 4 | English | 2018-08 | Released | Public...
Page 246: Ic Authorization
(2) L’appareil doit accepter tout brouillage radioélectrique subi, même si le brouillage est susceptible d’en compromettre le fonctionnement. Edge Gateway | NIOT-E-TPI51-EN-RE (Connect) © Hilscher 2017 – 2018 DOC170502UM04EN | Revision 4 | English | 2018-08 | Released | Public...
Page 247: Decommissioning, Dismounting And Disposal
As a consumer, you are legally obliged to dispose of all waste electronic equipment according to national and local regulations. Edge Gateway | NIOT-E-TPI51-EN-RE (Connect) © Hilscher 2017 – 2018 DOC170502UM04EN | Revision 4 | English | 2018-08 | Released | Public...
Page 248: Appendix
The manual delivered with the product shall apply. Under no circumstances shall Hilscher Gesellschaft für Systemautomation mbH be liable for direct, indirect, ancillary or subsequent damage, or for any loss of income, which may arise after use of the information contained herein.
Page 249 Appendix 249/258 Liability disclaimer The hardware and/or software was created and tested by Hilscher Gesellschaft für Systemautomation mbH with utmost care and is made available as is. No warranty can be assumed for the performance or flawlessness of the hardware and/or software under all application conditions and scenarios and the work results achieved by the user when using the hardware and/or software.
Page 250 Additional guarantees Although the hardware and software was developed and tested in-depth with greatest care, Hilscher Gesellschaft für Systemautomation mbH shall not assume any guarantee for the suitability thereof for any purpose that was not confirmed in writing. No guarantee can be granted whereby the...
Page 251 The customer hereby expressly acknowledges that this document contains trade secrets, information protected by copyright and other patent and ownership privileges as well as any related rights of Hilscher Gesellschaft für Systemautomation mbH. The customer agrees to treat as confidential all of the information made available to customer by Hilscher Gesellschaft für...
Page 252: List Of Figures
List of figures Figure 1: Edge Gateway communication structure.............. Figure 2: Dimensions......................Figure 3: NIOT-E-TPI51-EN-RE LED positions ..............12 Figure 4: Gateway state LEDs..................... 13 Figure 5: Default settings of the Ethernet network connectors ..........17 Figure 6: Device label: Hostname..................18 Figure 7: netIOT Edge Gateway in the Windows network ...........
Page 253 Figure 80: Options of the selection list Payload..............107 Figure 81: OPC UA in - specific payload ................107 Edge Gateway | NIOT-E-TPI51-EN-RE (Connect) © Hilscher 2017 – 2018 DOC170502UM04EN | Revision 4 | English | 2018-08 | Released | Public...
Page 254 List of the configured input and output modules........... 177 Figure 122: List of the send and receive signals ..............181 Edge Gateway | NIOT-E-TPI51-EN-RE (Connect) © Hilscher 2017 – 2018 DOC170502UM04EN | Revision 4 | English | 2018-08 | Released | Public...
Page 255 (Server)......................... 223 Figure 146: Use case 2: Server certificates for Edge Gateway services......... 224 Figure 147: FCC label......................245 Edge Gateway | NIOT-E-TPI51-EN-RE (Connect) © Hilscher 2017 – 2018 DOC170502UM04EN | Revision 4 | English | 2018-08 | Released | Public...
Page 256 List of tables 256/258 List of tables Table 1: List of revisions ....................... Table 2: Positions of the interfaces of NIOT-E-TPI51-EN-RE ..........Table 3: Power supply connector ..................Table 4: Description of gateway status LEDs ............... Table 5: LEDs LAN interface ....................
Page 257 Attributes concerning the issuer and owner of the certificate zum Zertifikats- Aussteller und Zertifikats-Inhaber ................220 Table 71: Edge Gateway services ..................225 Table 72: Technical data NIOT-E-TPI51-EN-RE ..............241 Table 73: Technical data PROFINET IO RT IRT Device Protocol.......... 243 Table 74: Technical data EtherNet/IP Adapter protocol ............244 Edge Gateway | NIOT-E-TPI51-EN-RE (Connect) ©...
Page 258: Contacts
Phone: +1 630-505-5301 E-mail: info@hilscher.it E-mail: info@hilscher.us Support Support Phone: +39 02 25007068 Phone: +1 630-505-5301 E-mail: it.support@hilscher.com E-mail: us.support@hilscher.com Edge Gateway | NIOT-E-TPI51-EN-RE (Connect) © Hilscher 2017 – 2018 DOC170502UM04EN | Revision 4 | English | 2018-08 | Released | Public...

hilscher NIOT-E-TPI51-EN-RE User Manual

Table of Contents

1 Introduction

2 Brief Description

3 Device Drawings

4 Connectors and Mounting

5 Leds

6 Commissioning the Edge Gateway

7 Edge Gateway Manager

8 Control Panel

9 Node-RED - the Wiring Editor

10 Examples for Node-RED

11 Configuring and Using the Fieldbus Node

12 Configuring PROFINET and Defining Signals

13 Configuring Ethernet/Ip and Defining Signals

14 Edge Server

15 Isolated Application Execution with Docker

16 Public Key Infrastructure

17 Technical Data

18 Authorizations

19 Decommissioning, Dismounting and Disposal

20 Appendix

Quick Links

Chapters

Related Manuals for hilscher NIOT-E-TPI51-EN-RE

Summary of Contents for hilscher NIOT-E-TPI51-EN-RE