Advertisement

Quick Links

Anybus Edge Gateway
Reference Manual
REFERENCE GUIDE
SCM-1202-154 1.0 en-US ENGLISH

Advertisement

Table of Contents
loading
Need help?

Need help?

Do you have a question about the Anybus Edge and is the answer not in the manual?

Questions and answers

Summary of Contents for HMS Anybus Edge

  • Page 1 Anybus Edge Gateway Reference Manual REFERENCE GUIDE SCM-1202-154 1.0 en-US ENGLISH...
  • Page 2 HMS Industrial Networks reserves the right to modify its products in line with its policy of continuous product development. The information in this document shall therefore not be construed as a commitment on the part of HMS Industrial Networks and is subject to change without notice.
  • Page 3: Table Of Contents

    Network ......................50 4.2.3 Portal ......................66 4.2.4 PLC ......................... 78 4.2.5 I/Os ........................ 84 4.2.6 Services......................119 Export ........................123 4.3.1 Event Log Messages .................... 123 4.3.2 Open-source Software ..................123 SCM-1202-154 1.0 en-US Anybus Edge Gateway Reference Guide...
  • Page 4 Bluetooth ........................140 Power ........................140 Factory Reset ........................141 10 Recommended Browsers ....................142 11 Open Source Software ....................143 11.1 Open Source Software ....................143 11.1.1 Used Components ....................143 SCM-1202-154 1.0 en-US Anybus Edge Gateway Reference Guide...
  • Page 5: Preface

    Preface 3 (148) Preface About This Document This manual describes the installation and configuration of Anybus Edge gateway. For additional documentation and software downloads, FAQs, troubleshooting guides and technical support, please visit www.anybus.com/support. Document Conventions The following conventions are used to indicate safety information and other important content...
  • Page 6: Home Page

    Enter your previous password here. New password Enter your new password here. The requirements for the new password are shown below the input field. Repeat password Repeat your new password here to detect typing errors. SCM-1202-154 1.0 en-US Anybus Edge Gateway Reference Guide...
  • Page 7: Hms Sequence Editor

    PLC. Toolbar The toolbar of the HMS Sequence editor contains buttons that can be used to navigate to other sites, to edit, load and store the diagram and the I/O mappings and to control the PLC.
  • Page 8 Opens a dialog through which you can edit a selected I/O mapping. See I/O Mapping, p. Deletes the selected diagram element or I/O mapping respectively. Discards the whole diagram or all I/O mappings respectively. Opens the help system in a new window. Login button SCM-1202-154 1.0 en-US Anybus Edge Gateway Reference Guide...
  • Page 9: Diagram

    The negation is performed logically. A value of 0 will be negated to 1. A value unequal to 0 will be negated to 0. Negating a string will result in an empty string. SCM-1202-154 1.0 en-US Anybus Edge Gateway Reference Guide...
  • Page 10 The elements on the diagram are processed one after the other. To see the processing order, click on the Processing order button on the toolbar. The HMS Hub editor will show the processing order of each element in a small box in its upper right corner. The element with the processing order number 0 is processed first.
  • Page 11: Units

    Changing the processing order of an element 3.2.1 Units In the following, the behavior of the available units will be described. If not stated otherwise, units are processed during the process stage of the Cycle. SCM-1202-154 1.0 en-US Anybus Edge Gateway Reference Guide...
  • Page 12 These times will be interpreted as times after the switch. The Anybus Edge gateway’s firmware includes daylight saving time rules for about 20 years starting from its release date. If you try to set a local time that lies before the release date or more than 20 years past the release date, setting the clock may fail.
  • Page 13 Minute: Compared if bit 5 of the Bitmap input port is set (8-bit unsigned integer, range [0..59]) • Second: Compared if bit 6 of the Bitmap input port is set (8-bit unsigned integer, range [0..59]) SCM-1202-154 1.0 en-US Anybus Edge Gateway Reference Guide...
  • Page 14 When SetOn = SetOff, the unit's behaviour is represented by diagram 1. The output port will be switched on, when Act SetOn. The output port will be swiched off, when Act <= SetOff. SCM-1202-154 1.0 en-US Anybus Edge Gateway Reference Guide...
  • Page 15 100 % (10,000) when Act <= SetHigh. It will fall from 100 % to 0 % when the value of Act rises between SetHigh and SetLow. And it will stay at 100 % (10,000) when Act becomes >= SetLow. Unlimited will go beneath 0 % when Act < SetHigh and SCM-1202-154 1.0 en-US Anybus Edge Gateway Reference Guide...
  • Page 16 The boolean OK port will be set to 1 for one cycle when the message has been successfully sent. If sending the message failed, the boolean Err port will be set to 1 for the duration of one cycle. SCM-1202-154 1.0 en-US Anybus Edge Gateway Reference Guide...
  • Page 17 The value of the TUp input port (32-bit unsigned integer) describes the time (ms) needed to reach the new value, if the old value is less than the new one. SCM-1202-154 1.0 en-US Anybus Edge Gateway Reference Guide...
  • Page 18 The subtraction is performed in the greatest numeric data type of all output ports connected to the unit's input ports. All ports of the unit will adopt this data type. SCM-1202-154 1.0 en-US Anybus Edge Gateway Reference Guide...
  • Page 19 This unit converts a numerical timestamp (number of microseconds since 00:00:00 January 1 1970; the timestamp format can be changed via the Program settings.) to a string representation. The numerical timestamp is expected at the TS input port (64-bit unsigned SCM-1202-154 1.0 en-US Anybus Edge Gateway Reference Guide...
  • Page 20: I/Os

    There is one element for each input and output. The number and structure of the I/Os depend on the particular Anybus Edge device and its configuration. Each I/O element has three ports that can be connected to other elements as described above.
  • Page 21: Variables

    Internally the I/Os are addressed via an interface, a device, a value and optionally an array index. For example, if the Anybus Edge features some digital I/Os and a Modbus Master interface, the interface index will select one of these two interfaces. The device index might for example select the Modbus slave and finally the value index would select the respective Modbus register.
  • Page 22: Data Type Conversion Units

    8-bit unsigned integer • 8-bit signed integer • 16-bit unsigned integer • 16-bit signed integer • 32-bit unsigned integer • 32-bit signed integer • 32-bit floating point number • 64-bit floating point number SCM-1202-154 1.0 en-US Anybus Edge Gateway Reference Guide...
  • Page 23: I/O Mapping

    String I/O Mapping Besides the diagram the HMS Sequence editor allows to directly map inputs to outputs using the I/O mappings. This can be done in a quick and easy manner using a mapping table. The table show inputs in the left column and outputs in the right column. Variables can also be used as inputs ot outputs respectively.
  • Page 24: Edit, Delete Discard Mappings

    This effects the Local Clock, UTC Clock, String to TS and TS to String (32-bit instead of 64-bit) unit as well as the I/O elements. For programs created with older versions this checkbox is checked automatically, but it can be unchecked. SCM-1202-154 1.0 en-US Anybus Edge Gateway Reference Guide...
  • Page 25: Running The Program

    MER HÄR! 3.5.1 IPO Cycle The Anybus Edge run-time system executes an IPO cycle (Input-Process-Output) in each cycle. This cycle includes the following steps: Input – During this step the following inputs will be read: – Local inputs –...
  • Page 26: Live View

    Stopping PLC due to missing licence. Since the device does not have a valid HMS Hub licence, the PLC runs in demo mode and is now being stopped after a runtime of four hours. Exception in task: <message>...
  • Page 27: Status Bar

    Fig. 14 The status bar of the HMS Sequence editor The image shows the status bar of the HMS Sequence editor. It shows information on the current state of the PLC. In the following the information that may be shown will be described in detail.
  • Page 28: Settings

    Settings 26 (148) Settings On the settings page you can configure your Anybus Edge device. Fig. 15 Screenshot of the settings page At the top of the page there is a toolbar. In the following, the toolbar's buttons will be described in detail.
  • Page 29: Event Log

    Event Log The event log is the central place where all components of the Anybus Edge firmware store their event messages. Each event message consists of the message text, a timestamp and an event type.
  • Page 30 Could not send to server <server name/IP> – Failed to receive reply from server <server name/IP> – Unexpected packet format from server <server name/IP> – Timestamps not plausible from server <server name/IP> SCM-1202-154 1.0 en-US Anybus Edge Gateway Reference Guide...
  • Page 31 Network lost (code <x>, network status <y>) – Data connection broken ([DCD pin: <x>, ]PPP status: <y>, Data connection: <z>) – Connection supervision failed – Modem reset – Hanging! (state: <x>) – Could not initialise GPS module SCM-1202-154 1.0 en-US Anybus Edge Gateway Reference Guide...
  • Page 32 Network Address Translation – Running – <x> static mapping(s) read from configuration – No free mapping entry available for incoming connection from internal interface – No free firewall rule entry available for outgoing connection SCM-1202-154 1.0 en-US Anybus Edge Gateway Reference Guide...
  • Page 33 Driver stopped unexpectedly. – Upload of authority's certificate failed. – Upload of certificate failed. – Upload of private key failed. – Upload of user and password file failed. – Upload of Diffie-Hellman file failed. SCM-1202-154 1.0 en-US Anybus Edge Gateway Reference Guide...
  • Page 34 Failed to allocate client data structure – Adding static lease IP=<x> failed, IP address is in use – Adding static lease IP=<x> failed, no free slot – Adding static lease IP=<x> failed, wrong IP address SCM-1202-154 1.0 en-US Anybus Edge Gateway Reference Guide...
  • Page 35 Could not connect: Could not resolve host name. – Could not connect: Could not send HTTP request. – Could not connect: Could not receive HTTP response. – Could not connect: Protocol error SCM-1202-154 1.0 en-US Anybus Edge Gateway Reference Guide...
  • Page 36 Could not process RPC: Receive error – Could not process RPC: Unexpected error <error code – Ack with sequence number <sequence numbercontained additional payload data – Could not log in: Access denied SCM-1202-154 1.0 en-US Anybus Edge Gateway Reference Guide...
  • Page 37 Could not process un-publish command: Send error – Could not process un-publish command: Unexpected error (<error code) – Could not send Nak for un-publish command – Could not process (committed) write command: Library not ready SCM-1202-154 1.0 en-US Anybus Edge Gateway Reference Guide...
  • Page 38 Could not execute kolibri.getStats() RPC: Error getting statistics (<error code) – Could not enqueue value for point <path: Out of memory – Could not enqueue value for point <path: Unexpected error (<error code) – Could not connect: Out of memory SCM-1202-154 1.0 en-US Anybus Edge Gateway Reference Guide...
  • Page 39 Could not create node. (Node path node path, error code error code) – Could not modify node properties. (Node path node path, error code error code) – Could not synchronise Variables with portal. SCM-1202-154 1.0 en-US Anybus Edge Gateway Reference Guide...
  • Page 40 Could not open a communication channel with the module. – Unable to open Sensor configuration file. The file is either damaged or missing. – Could not initialise RTD module. – Portal communication error <error code> SCM-1202-154 1.0 en-US Anybus Edge Gateway Reference Guide...
  • Page 41 Could not read value "<description>" from device "<manufacturer> - <medium> - <serial number>". – Read illegal floating point value "<description>" from device "<manufacturer> - <medium> - <serial number>". – Portal communication error <error code> SCM-1202-154 1.0 en-US Anybus Edge Gateway Reference Guide...
  • Page 42 Left state Data Exchange – Entered state Data Exchange, Master in Clear mode – Entered state Data Exchange, Master in Operate mode – Could not set slave address – Unexpected state: <state> SCM-1202-154 1.0 en-US Anybus Edge Gateway Reference Guide...
  • Page 43 Could not get timestamp at end of pulse command at address <information object address>. – The interval has been violated. – Could not update output at address <information object address>. Error code <code>, error message <message> – Portal communication error <error code> SCM-1202-154 1.0 en-US Anybus Edge Gateway Reference Guide...
  • Page 44 Missing or invalid application instance certificate for SecurityPolicy - Basic128Rsa15 (code <code>) – Missing or invalid application instance certificate for SecurityPolicy - Basic256Sha256 (code <code>) – Unhandled error (code <code>) – Out of memory SCM-1202-154 1.0 en-US Anybus Edge Gateway Reference Guide...
  • Page 45 <agent name> (IP <agent address>). (<msg>) – Could not process message from agent <agent name> (IP <agent address>). (<exception>) – Could not send response to INFORM request from agent <agent name> (IP <agent address>). (Error code <x>) SCM-1202-154 1.0 en-US Anybus Edge Gateway Reference Guide...
  • Page 46 Could not create database. – Data was lost. – Could parse configuration file: <error>. – Erasing old entries. – Connection lost. – Online. – Offline. – Could not open. – Could not close. SCM-1202-154 1.0 en-US Anybus Edge Gateway Reference Guide...
  • Page 47 This package is limited to the device with the MAC address <MAC address>. – Invalid package signature – Could not open package. Message: <message> – Update disallowed by application (<code>) – Could not launch update. – Portal communication error <x> SCM-1202-154 1.0 en-US Anybus Edge Gateway Reference Guide...
  • Page 48 The internal flash drive seems to be weak. – Flash write error. The internal flash drive is probably defect. – Could not create directory structure on external medium – One or more certificates could not be loaded. SCM-1202-154 1.0 en-US Anybus Edge Gateway Reference Guide...
  • Page 49 Could not initialise OpenVPN client: <error message> – Could not initialise system time manager: <error message> – This device is not licenced for HMS Hub. – Could not initialise COM server: <error message> – Could not initialise portal Event Log service: <error message>...
  • Page 50: Settings

    Time Zone Settings In this section you can enable and configure the Anybus Edge device time zone settings. If you enable it, the Anybus Edge device will update its local time according to the time zone and daylight saving time rules of its configured location.
  • Page 51 Daylight saving time rules will be used up within the next two years The firmware of your Anybus Edge device includes daylight saving time rules for a limited time period. New rules will be added with new firmware versions. This message indicates that the rules will be used up within the next two years.
  • Page 52: Network

    Backlight of the Esc key Backlight of the LCDs Red status LED Website The website shown on the Display. Orientation The Display orientation. 4.2.2 Network Via this form you can configure general network settings. SCM-1202-154 1.0 en-US Anybus Edge Gateway Reference Guide...
  • Page 53 NetBIOS name. So inside your local network you should be able to use the name instead of the IP address to access the Anybus Edge device. In addition to the configurable name another name built from the prefix MAC and the Anybus Edge device's MAC ID (e.g.
  • Page 54 GPS module cannot provide a vertical fix. If the cellular modem built into your Anybus Edge device features a GPS module, you can enable the GPS module. Once enabled, the GPS module will provide the coordinates latitude, longitude and altitude.
  • Page 55 The supply voltage for the cellular modem hardware has been switched on. • Modem initialised (RSSI: <x> dBm) The cellular modem has been successfully initialised. The RSSI value ranges from <= -113 to = -51 dBm. SCM-1202-154 1.0 en-US Anybus Edge Gateway Reference Guide...
  • Page 56 If you see an error code that is not on the above list, please contact the customer support. • Network registration timed out ((not) searching) No cellular network could be found within a reasonable time. The message also indicates whether the cellular modem hardware was still searching for networks. SCM-1202-154 1.0 en-US Anybus Edge Gateway Reference Guide...
  • Page 57 Unknown network status Registered to a network other than the home network (roaming) If you see an error code or network status that is not on the above lists, please contact the customer support. SCM-1202-154 1.0 en-US Anybus Edge Gateway Reference Guide...
  • Page 58 Could not initialise GPS module The cellular modem's GPS module could not be initialised. WLAN Via this form you can activate and configure the WLAN interface of your Anybus Edge device, in case it provides one. Settings The following table describes the available settings for the WLAN module.
  • Page 59 Press the WPS button to initiate a WPS connection. The wireless module attempts to connect to an access point that has also had its WPS Push-button method activated. The WPS Push-button method must be activated on both devices (Anybus Edge and access point) within 2 minutes.
  • Page 60 Settings 58 (148) Bluetooth Via this form you can activate and configure the Bluetooth interface of your Anybus Edge device, in case it provides one. Settings The following table describes the available settings for the Bluetooth module. Enable Bluetooth Enables the module.
  • Page 61 The HMS Hub firmware is able to perform network and port address translation (aka NAT/PAT) in order to route traffic between a local (internal) and a global (external) network. This feature can for example be used to allow another device connected to the Anybus Edge device's SCM-1202-154 1.0 en-US...
  • Page 62 Dynamic mapping is used to enable devices from the local network to access the global network. Requests from the local network will be given the Anybus Edge device's global IP address and the replies will be routed to the respective local device. You have to configure how many minutes dynamic mappings will be valid (time to live).
  • Page 63 If this option is checked OpenVPN will be started at device start-up. Allow connection to be If this option is checked OpenVPN can be started and stopped though the portal. HMS controlled via HMS Hub devices have a portal node at address /device-info/openvpn/running. Setting this node's Hub: value to 1 will start OpenVPN.
  • Page 64 – plugin – ifconfig-pool-persist – client-connect – client-disconnect – client-config-dir – tmp-dir – learn-address – auth-user-pass-verify – secret – replay-persist – capath – extra-certs – pkcs12 – askpass – tls-verify – tls-export-cert SCM-1202-154 1.0 en-US Anybus Edge Gateway Reference Guide...
  • Page 65 The private key file (cert.key) has been successfully uploaded. • User and password file uploaded The user and password file (userpass.txt) has been successfully uploaded. • Diffie-Hellman file uploaded The Diffie-Hellman file (dh.pem) has been successfully uploaded. SCM-1202-154 1.0 en-US Anybus Edge Gateway Reference Guide...
  • Page 66 The Diffie-Hellman file (dh.pem) could not be uploaded. DHCP Server The HMS Hub firmware features a DHCP server (Dynamic Host Configuration Protocol) which you can enable and configure via this form. The DHCP server loses all information on allocated IP addresses on reboot. So after the Edge gateway device has restarted, all DHCP clients must be restarted, too.
  • Page 67 Adding static lease IP=<x> failed, IP address is in use A static lease could not be added, because the respective IP address is already in use. The message also shows the IP address of the static lease that should be added. SCM-1202-154 1.0 en-US Anybus Edge Gateway Reference Guide...
  • Page 68: Portal

    The following section describes the messages that the portal communication module may log to the Event Log. Messages are prefixed with the text Portal module: . • Opening connection to <host> The device is connecting to the portal at the indicated host address. SCM-1202-154 1.0 en-US Anybus Edge Gateway Reference Guide...
  • Page 69 A communication timeout occurred while closing the portal connection. • Ack with sequence number <sequence number> could not be matched An Ack reply was received from the portal that could not be matched to any request. SCM-1202-154 1.0 en-US Anybus Edge Gateway Reference Guide...
  • Page 70 A connect error occurred while connecting to the portal. The indicated error code is an HTTP client error code. • Could not connect: TLS error (<error code>) A TLS error occurred while connecting to the portal. The indicated error code is an HTTP client error code. SCM-1202-154 1.0 en-US Anybus Edge Gateway Reference Guide...
  • Page 71 The get hash command could not be sent while synchronising published nodes with the portal. • Could not get publish hash: Timeout A communication timeout occurred while synchronising published nodes with the portal. SCM-1202-154 1.0 en-US Anybus Edge Gateway Reference Guide...
  • Page 72 The pong command could not be sent while carrying out the keep-alive handshake with the portal. • Mandatory RPC field missing A mandatory field was missing in an RPC request or response received from the portal. SCM-1202-154 1.0 en-US Anybus Edge Gateway Reference Guide...
  • Page 73 Write command with sequence number <sequence number> failed (<error code>) The write command with the indicated sequence number was not accepted by the portal. The indicated error code is a Kolibri library error code. SCM-1202-154 1.0 en-US Anybus Edge Gateway Reference Guide...
  • Page 74 The portal published a point with the indicated new path that had already been published before with the indicated known path. • Could not publish point: Initial publish for <path> (uncertain) without path The portal published a point without a path. SCM-1202-154 1.0 en-US Anybus Edge Gateway Reference Guide...
  • Page 75 An error occurred while receiving a (committed) write command from the portal. • Could not process (committed) write command: Invalid node index <point index> The portal wrote a point's value with the indicated invalid point index. SCM-1202-154 1.0 en-US Anybus Edge Gateway Reference Guide...
  • Page 76 The portal returned the indicated invalid path with a get node properties response. • Could not process get node properties response: Invalid flags <hexadecimal flags> The portal returned the indicated invalid flags with a get node properties response. SCM-1202-154 1.0 en-US Anybus Edge Gateway Reference Guide...
  • Page 77 • Could not execute kolibri.getStats() RPC: Error getting statistics (<error code>) Statistics could not be gotten while executing the kolibri.getStats() RPC. The indicated error code is a Kolibri library error code. SCM-1202-154 1.0 en-US Anybus Edge Gateway Reference Guide...
  • Page 78 An unexpected error occurred while processing a commit command received from the portal. • Could not process cancel command: Unexpected error (<error code>) An unexpected error occurred while processing a cancel command received from the portal. SCM-1202-154 1.0 en-US Anybus Edge Gateway Reference Guide...
  • Page 79 For devices with a bus system the I/O structure may change - for example if another I/O device is attached to the bus. The HMS Hub firmware will create portal nodes for new I/Os and delete portal nodes for I/Os that are no longer present. For existing nodes it will also overwrite the description as well as the properties for scaling and formatting provided the corresponding I/O driver provides this information.
  • Page 80: Plc

    When adding or editing a variable, a dialog will show up. Here the following parameters can be configured: Name The variable name is shown in the Diagram Editor and used as description of the corresponding portal node. Data type Variable's data type SCM-1202-154 1.0 en-US Anybus Edge Gateway Reference Guide...
  • Page 81 The device's Variable structure could not be synchronized with the portal. Further information about the reason of the problem is not available. Time Switches Through this form you can configure the HMS Hub Time Switches. The Time Switches functionality is based on the Unix Cron utility.
  • Page 82 = 0,2,4,6. OFF_Switch Will fire every time sec = 0, min = 0, hours = 13, month = *, year = *, month Day = *, week configuration Day = 0,2,4,6. SCM-1202-154 1.0 en-US Anybus Edge Gateway Reference Guide...
  • Page 83 For each message you can configure the following parameters: Active Through this check box the message can be activated or deactivated respectively. Channel Channel through which the message should be received SCM-1202-154 1.0 en-US Anybus Edge Gateway Reference Guide...
  • Page 84 Topic to which the last will message will be sent Last will message Here the so-called last will message can be defined. The Broker will send this message in the name of the client, if the connection breaks unexpectedly. SCM-1202-154 1.0 en-US Anybus Edge Gateway Reference Guide...
  • Page 85 Could not subscribe to MQTT topic "<topic>" (<error code>) The MQTT client could not subscribe the given topic. An error code from the MQTT Library or from the following list provides more information: The MQTT broker refused the subscription. SCM-1202-154 1.0 en-US Anybus Edge Gateway Reference Guide...
  • Page 86: I/Os

    Mode. The duty cycle can be controlled via the output named PWM Duty Cycle. In 16-bit mode valid values range from 0 (0 %) to 65535 (100 %). In 8-bit mode valid values range from 5 (5 %) to 95 (95 %). SCM-1202-154 1.0 en-US Anybus Edge Gateway Reference Guide...
  • Page 87 Using 1500 as input the output will generate an electric potential difference of 1.5 V or 1500 mV with the analog ground port. • 4 digital inputs (named Input 0 - Input 3) SCM-1202-154 1.0 en-US Anybus Edge Gateway Reference Guide...
  • Page 88 The following section describes the messages that the local I/O drivers may log to the Event Log. Depending on the specific driver, messages may be prefixed with one of the following texts: • Local I/O driver (EXT01): SCM-1202-154 1.0 en-US Anybus Edge Gateway Reference Guide...
  • Page 89 Communication with the module could not be established. • Unable to open Sensor configuration file. The file is either damaged or missing The configuration file for this sensor is either missing or could not be accessed. SCM-1202-154 1.0 en-US Anybus Edge Gateway Reference Guide...
  • Page 90 You can define up to 128 devices and 4096 values. However, since values can become arrays when reading/writing several registers/coils, there is another limit: The number of all scalar (non- array) values plus the size of all arrays must not exceed 8192. SCM-1202-154 1.0 en-US Anybus Edge Gateway Reference Guide...
  • Page 91 The corresponding value is identified by the Modbus function code used to read/ write it, its address (starting from 0) and the quantity of registers/coils. This message will only be shown if the driver failed to read/write the same value before. SCM-1202-154 1.0 en-US Anybus Edge Gateway Reference Guide...
  • Page 92 Waiting for slave response timed out. Either the slave is not available or you should increase the timeout. Received invalid packet (Checksum error) Sending request failed If you see a result code that is not on the above list, please contact the customer support. SCM-1202-154 1.0 en-US Anybus Edge Gateway Reference Guide...
  • Page 93 Below the value list there are several fields through which some general settings can be configured: Mode Defines whether to operate as a Modbus RTU Slave or a Modbus TCP Server. According to this particular setting, two different groups of additional settings are available. SCM-1202-154 1.0 en-US Anybus Edge Gateway Reference Guide...
  • Page 94 4096 and that at least one value will be read from any device. The number of devices to be read is limited to 64. SCM-1202-154 1.0 en-US Anybus Edge Gateway Reference Guide...
  • Page 95 After the scan has completed, the list will show the new configuration. Then you should save the new configuration to the device by clicking the Save button. Note that the HMS Hub firmware Run Time System will still be working with the old configuration. To apply the new configuration, you have to reboot the device.
  • Page 96 You can add, edit, delete or clone groups and values (input or output) via the buttons below the list. When adding or editing a group, a dialog will show up where you can configure the following parameters: SCM-1202-154 1.0 en-US Anybus Edge Gateway Reference Guide...
  • Page 97 Array that holds the data type of each value in the group (USINT, read only). For array values there is one entry per array element. The following data types may appear: BOOL SINT DINT USINT UINT UDINT REAL SCM-1202-154 1.0 en-US Anybus Edge Gateway Reference Guide...
  • Page 98 There is either a class 1 connection error or a duplicate IP address has been detected. • Unexpected state: <state> The state machine of the base driver for the Anybus CompactCom module has reached the indicated unexpected state. This should not happen. Please contact the customer support. SCM-1202-154 1.0 en-US Anybus Edge Gateway Reference Guide...
  • Page 99 64 bytes/words of data. For each 64 bytes/words of data another 3 bytes are added to the identifier. All module identifiers concatenated must not consume more than 244 bytes. SCM-1202-154 1.0 en-US Anybus Edge Gateway Reference Guide...
  • Page 100 ID. So if you want to access module 6, send a request with slot number 1 and index 6. Several Anybus Edge devices in the same network If you want to use several Edge gateway devices in your PROFIBUS DP network and these don't have the same configuration, you should do the following: •...
  • Page 101 The module ID is used to address the module on the PROFINET. It is a numerical value between 1 and 65535. Note that the same module ID cannot be used more than once. SCM-1202-154 1.0 en-US Anybus Edge Gateway Reference Guide...
  • Page 102 Event Log Messages The following section describes the messages that the PROFINET IO device driver may log to the Event Log. All messages are prefixed with the text Anybus CompactCom driver (EXT09):. SCM-1202-154 1.0 en-US Anybus Edge Gateway Reference Guide...
  • Page 103 This should not happen. Please contact the customer support. • Could not set DHCP The DHCP option could not be written into the Anybus CompactCom module. This should not happen. Please contact the customer support. SCM-1202-154 1.0 en-US Anybus Edge Gateway Reference Guide...
  • Page 104 Common Address Server's common address Number of unacknowledged I format APDUs after which the connection will be closed Number of received I format APDUs after which reception will be acknowledged at the latest SCM-1202-154 1.0 en-US Anybus Edge Gateway Reference Guide...
  • Page 105 – Bitstring of 32 bit with time tag CP56Time2a (33) – Measured value, normalized value with time tag CP56Time2a (34) – Measured value, short floating point value with time tag CP56Time2a (36) SCM-1202-154 1.0 en-US Anybus Edge Gateway Reference Guide...
  • Page 106 The list shows for each device or value a name, the communication parameters and an index. The name can be freely defined and will e.g. be shown on the portal. The indexes are used internally to address the values. SCM-1202-154 1.0 en-US Anybus Edge Gateway Reference Guide...
  • Page 107 You can define up to 32 devices and 4096 values. However, since values can become arrays when reading/writing several objects, there is another limit: The total number of objects must not exceed 8192. Settings Below the list general settings can be configured: SCM-1202-154 1.0 en-US Anybus Edge Gateway Reference Guide...
  • Page 108 The standard series IEC 61400-25 (Communication networks for wind power systems) is an extension of IEC 61850. The HMS Hub firmware supports both standards with the MMS mapping.
  • Page 109 A value was succesfully written or read. This message will only be shown if the driver failed to read or write the same value before. • The interval is being maintained again. This message appears after this message, when the interval is being maintained again. SCM-1202-154 1.0 en-US Anybus Edge Gateway Reference Guide...
  • Page 110 Class Classes can be used to group values. The master can poll all events regarding values of a certain class together. In this way the bandwidth can be used optimally. SCM-1202-154 1.0 en-US Anybus Edge Gateway Reference Guide...
  • Page 111 Could not update output with type ID type ID and index index. Error code error code The output value with the given data type ID and index could not be updated. The corresponding DNP3 error code is shown. SCM-1202-154 1.0 en-US Anybus Edge Gateway Reference Guide...
  • Page 112 64 alphanumeric ASCII characters, underscores, dots or hyphens. The first character must be alphanumeric. Note that the same portal name must not be used more than once inside the same group. Data type Data type of the value SCM-1202-154 1.0 en-US Anybus Edge Gateway Reference Guide...
  • Page 113 This is the private key for the application instance certificate for SecurityPolicy - Basic256Sha256 the SecurityPolicy - Basic256Sha256. Firstly choose the type of file. Secondly chose a file from the local file system and press the Start upload button. SCM-1202-154 1.0 en-US Anybus Edge Gateway Reference Guide...
  • Page 114 This message appears after this message, when the interval is being maintained again. • The interval has been violated. The driver was still busy reading/writing values when a new cycle should be started. You should probably increase the interval time. Anybus Edge Gateway Reference Guide SCM-1202-154 1.0 en-US...
  • Page 115 For each value a high and a low limit can be set. The limits are only functional if the Portal is enabled. When a limit is exceeded, values sampled 60 seconds before and 60 seconds after the limit event are communicated to the Portal with a special quality value of 100. SCM-1202-154 1.0 en-US Anybus Edge Gateway Reference Guide...
  • Page 116 Settings If the "Trigger meta-values over HMS Hub element" option is enabled, SGIM meta-values (average, maximum and minimum) can only be triggered over the "Power values trigger" and "Non-power values trigger" elements for power values (Active Power, Reactive Power and Apparent Power) and non-power values (all remaining values) respectively.
  • Page 117 IP address The IP address of the list. This field is only visible when the Write checkbox is selected. Port Defines the network port on which the variable packets will be broadcasted. SCM-1202-154 1.0 en-US Anybus Edge Gateway Reference Guide...
  • Page 118 • Error receiving CODESYS Network Variable pack with COB-ID <COB-ID>, sub-index <Sub- Index>. The received checksum is invalid. The driver has received a variable packet that contains an erroneous crc32 check value. SCM-1202-154 1.0 en-US Anybus Edge Gateway Reference Guide...
  • Page 119 A name used to build the path of the corresponding node on the portal. Object ID used to address the value through the SNMP protocol. SNMP Data The SNMP protocol data type: Type Integer SCM-1202-154 1.0 en-US Anybus Edge Gateway Reference Guide...
  • Page 120 Could not (write or read) value <value name> (OID <value oid>) on agent <agent name> (IP <agent address>). (error status <x>, error index <x>) A value belonging to the specified agent could not be successfully read or written. Check error status for exact reason. SCM-1202-154 1.0 en-US Anybus Edge Gateway Reference Guide...
  • Page 121: Services

    Services COM Server The HMS Hub firmware features a COM Server according to RFC 2217 which lets you access your Edge gateway device's serial port via the network. The COM Server can be configured via this form. Besides the TCP port the server should listen on and possibly the serial interface you...
  • Page 122 The COM server could not receive data on its TCP socket. Data Logging Data Logging can be used to store values in the HMS Hub database. Those values can then be exported in the ".csv" file format. At the top there is a list with the defined elements. It shows for every element its name, its actual value and its trigger.
  • Page 123 Data Logging is now online. • Offline. Data Logging is now offline. • Restoring connection. Data Logging is restoring connection. • Waiting for database connection. Data Logging is waiting for the database connection to be activated. SCM-1202-154 1.0 en-US Anybus Edge Gateway Reference Guide...
  • Page 124 Data Logging lost the database connection. Database Through this form you can configure the HMS Hub Database. The database file itself is not encrypted. This means that physical access to the file also allows access to the values stored in it. The database has no limit. It can grow until it has...
  • Page 125: Export

    Packing the configuration into an update package failed. A detailed error description is appended to the message. 4.3.2 Open-source Software The following open-source software has been used to implement the export functionality: SCM-1202-154 1.0 en-US Anybus Edge Gateway Reference Guide...
  • Page 126: Diagnostics

    At the top of the page there is a toolbar. In the following the toolbar's buttons will be described in detail. Closes the diagnostics page and opens the home page. Closes the diagnostics page and opens the HMS Hub editor. Closes the diagnostics page and opens the settings page. Closes the diagnostics page and opens the update page.
  • Page 127: Info Command

    Via a drop down field a certain network interface can be selected on which packets will be captured. The command is started via the Start button. It is stopped via the Stop button. SCM-1202-154 1.0 en-US Anybus Edge Gateway Reference Guide...
  • Page 128: Tasks Command

    The database command can be executed in the diagnostics console. It displays information from the database running in the system. Database information: Returns the database info headers. The command is started via the Start button. SCM-1202-154 1.0 en-US Anybus Edge Gateway Reference Guide...
  • Page 129: Update

    At the top of the page there is a toolbar. In the following the toolbar's buttons will be described in detail. Closes the update page and opens the home page. Closes the update page and opens the HMS Hub editor. Closes the update page and opens the settings page. Closes the update page and opens the page.
  • Page 130: Remote Update

    6.1.1 Remote update Software updates may also be distributed via the portal. The HMS Hub firmware creates three nodes on the portal via which you can trigger and monitor the remote update. The update package will be downloaded from any HTTP server.
  • Page 131 - such as a change in the firmware version - you can use this counter to check if the update package has been successfully applied. SCM-1202-154 1.0 en-US Anybus Edge Gateway Reference Guide...
  • Page 132: Event Log Messages

    Target file for remote update package is not accessible Loading an update package from a remote web server failed, because the target file already exists, but could not be overwritten. Maybe an external medium is write-protected. SCM-1202-154 1.0 en-US Anybus Edge Gateway Reference Guide...
  • Page 133 • Variant name does not match. This package is for "<variant name>" variant. The current update package is not intended for this variant of the HMS Hub firmware. The variant that the package is intended for is shown. •...
  • Page 134: Offline Update

    Wait for the Edge gateway device to acknowledge the start of the update by flashing all LEDs twice. • Wait until the update has been applied. Don't detach the Edge gateway device from the power supply before. SCM-1202-154 1.0 en-US Anybus Edge Gateway Reference Guide...
  • Page 135: System Start-Up

    System Start-up 133 (148) System Start-up At start-up, the HMS Hub firmware will go through several steps in order to bring the system into operation. • Check if there is an update package to be installed • Check for factory reset request •...
  • Page 136 Starting DHCP configuration at Ethernet (<interface index>), Port (<port index>). The run time system is trying to get a new IP configuration for the Ethernet interface with the given index from a DHCP server. SCM-1202-154 1.0 en-US Anybus Edge Gateway Reference Guide...
  • Page 137 The driver for the second Ethernet interface could not be started. • Unsupported Ethernet (1) interface type. (<interface type>) The HMS Hub firmware could not find a driver for the second Ethernet interface. The message also shows the numerical Ethernet interface type. SCM-1202-154 1.0 en-US...
  • Page 138 • This device is not licenced for HMS Hub. The device does not have a valid HMS Hub licence. The PLC runs in demo mode and will be stopped after a runtime of four hours. •...
  • Page 139 Device is secured with the default password, please change it. This message is shown when the default password is still used. For security purposes, it is recommended to change the password. You can do so through the login settings. SCM-1202-154 1.0 en-US Anybus Edge Gateway Reference Guide...
  • Page 140 System Start-up 138 (148) • Fatal error: <error message> A fatal error prevented firmware start-up. The message also shows an error message describing the error. SCM-1202-154 1.0 en-US Anybus Edge Gateway Reference Guide...
  • Page 141: Status Leds

    This LED indicates the status of the cellular modem connection if a cellular modem is installed on your device : Off: The cellular modem connection is not enabled. Slowly blinking (0.5 Hz): The connection is being established. The connection has been established. Fast blinking (4 Hz): SCM-1202-154 1.0 en-US Anybus Edge Gateway Reference Guide...
  • Page 142: Wifi

    Fast blinking (4 Hz): A fatal error has occurred. The Bluetooth driver no longer tries to establish a connection. Power This LED indicates whether the Edge gateway device is supplied with power. SCM-1202-154 1.0 en-US Anybus Edge Gateway Reference Guide...
  • Page 143: Factory Reset

    Wait for the Edge gateway device to acknowledge the reset by flashing all LEDs twice. • Release the reset button. • Wait until the Edge gateway device has started up. Don't detach it from the power supply before. SCM-1202-154 1.0 en-US Anybus Edge Gateway Reference Guide...
  • Page 144: Recommended Browsers

    We recommend that you always use the current version of browsers to make sure that the web- pages of the HMS Hub firmware are properly displayed. If you use older browsers, you might notice that some functions and features stop working. The following browsers are recommended: •...
  • Page 145: Open Source Software

    Licence: Dropbear SSH licence E2fsprogs: EXT2/3/4 File System Utilities Project website: e2fsprogs.sourceforge.net Licence: EXT2 file system utilities licence dosfstools Project website: github.com/dosfstools/dosfstools Licence: dosfstools licence libpcap Project website: tcpdump.org Licence: libpcap licence SCM-1202-154 1.0 en-US Anybus Edge Gateway Reference Guide...
  • Page 146 Licence: pppd Project website: ppp.samba.org Licence: pppd licence BlueZ Project website: www.bluez.org Licence: BlueZ licence D-Bus Project website: dbus.freedesktop.org Licence: D-Bus licence Expat XML Parser Project website: libexpat.github.io Licence: Expat licence SCM-1202-154 1.0 en-US Anybus Edge Gateway Reference Guide...
  • Page 147 Eclipse Distribution Licence SQLite Project website: www.sqlite.org Licence: SQLite Licence Dojo Toolkit Project website: dojotoolkit.org Licence: Dojo Licence FileSaver.js Project website: github.com/eligrey/FileSaver.js Licence: FileSaver.js licence clipboard.js Project website: clipboardjs.com Licence: clipboard.js licence SCM-1202-154 1.0 en-US Anybus Edge Gateway Reference Guide...
  • Page 148 Open Source Software 146 (148) Project website: lz4.github.io/lz4/ Library Licence: LZ4 library licence Executable Licence: executable licence SCM-1202-154 1.0 en-US Anybus Edge Gateway Reference Guide...
  • Page 149 This page intentionally left blank...
  • Page 150 © 2019 HMS Industrial Networks Box 4126 300 04 Halmstad, Sweden info@hms.se SCM-1202-154 1.0 en-US / 2019-11-18 / 16156...

Table of Contents