iconnect & IMOGateway

Transcription

1 iconnect & IMOGateway User Manual User Manual

2 Table Of Contents iconnect Overview... 3 iconnect Models... 4 IMOGateway... 5 Devices... 6 Software Modules... 9 IMOGateway Database Modbus Write Function Data IMOGateway Settings IMOGateway SIMS IMOGateway Billing IMOGateway Users Frequently Asked Questions... 19

3 iconnect Overview iconnect is a Remote M2M Gateway device allowing remote access to the IMO range of automation products and inverter drives. It automatically connects to the IMOGateway, enabling you to program your device*, change setpoints, monitor parameters and set up alerts. iconnect features include: 1 x Ethernet & 2 x USB Ports Industrial Internet of Things (IIoT) compatible Modbus RTU Read and Write connectivity Multi-user access available Multiple devices can be connected Buffer database feature Free 500MB of cloud storage Option to store data on personal designated servers FREE access to the IMOGateway management portal (can be custom branded) No software licensing fees * This feature will be available as an over-the-air (OTA) update by Q4/2016 iconnect Dimensions Antenna 125 Ethernet Port Modbus Port 93 DIN Rail Mount 65 NOTE: All dimensions in mm Technical Specification Input Voltage 5VDC Input Current 1.2A Operating Temperature 0 C to 50 C Operating Humidity 20% - 85% Non-condensing Weight 440g (491g 3G version) Screw Torque Rating 0.5Nm 3

4 iconnect Models Antenna Ethernet Port DIN Rail Mount iconnect-3g-v3 Modbus Port The iconnect-3g-v3 enables the user to setup FTP function between a device with FTP server and IMO Gateway or an external FTP server to transfer files between the device and server automatically. This module also enables to monitor the parameters and change the set points of a device using Modbus RTU read and write functions. The VPN* functionality in the iconnect enables the user to remotely monitor the controller connected to iconnect using Ethernet connection. Using the FTP files in the IMO gateway, alerts can be configured to send SMS and messages. Ethernet Port - This port is used to connect the iconnect to a controller which have a FTP server in it. The controller can be a HMI, PLC and others with FTP function enabled in the Ethernet port. This function is only tested for IMO controllers. Modbus USB Ports - The iconnect can be connected to a Modbus RTU device for reading data and writing set points. Antenna - The antenna is for internal 3G modem. An external antenna is available for purchase separately. Please contact IMO for details on the external antenna. Power Terminal - This terminal is for power supply connections to power up the iconnect. Please refer to the technical specification for details. Product Label - Please refer to the product label on the right hand side of the iconnect. Please note down the iconnect Unique Unit ID for configuring the iconnect in the IMO Gateway, iconnect-e-v3 The iconnect-e-v3 enables the user to setup FTP function between a device with FTP server and IMO Gateway or an external FTP server to transfer files between the device and server automatically. The VPN* functionality in the iconnect enables the user to remotely monitor the controller connected to iconnect using Ethernet connection. Using the FTP files in the IMO gateway, alerts can be configured to send SMS and messages. Ethernet Port - This port is used to connect the iconnect to Internet connection point. This port is also used to connect the iconnect to a controller which have a FTP server in it via a Ethernet hub. The controller can be a HMI, PLC and others with FTP function enabled in the Ethernet port. This function is only tested for IMO controllers. Power Terminal - This terminal is for power supply connections to power up the iconnect. Please refer to the technical specification for details. Product Label - Please refer to the product label on the right hand side of the iconnect. Please note down the iconnect Unique Unit ID for configuring the iconnect in the IMO Gateway, 4 * This feature will be available as an over-the-air (OTA) update by Q4/2016

5 IMOGateway IMOGateway Overview The IMOGateway allows you to register new iconnect devices, configure FTP settings to transfer data files between the remote device and data servers, setup and manage system alerts. The user settings within the IMOGateway allows to save the data files to IMOGateway or customer preferred data servers. The IMOGateway also enables you to configure VPN settings which facilitates uploading and downloading programs to IMO automation controllers. The iconnect can be used to configure Modbus RTU communication to IMO devices for reading process values and writing set points for process control and all these settings can be done via IMOGateway. The process values read from the Modbus slave units is saved in MySQL compliant database servers. IMOGateway can be customized with brand logos and suitable internet addresses. Please contact IMO for more information. Opening a New User Account in the IMOGateway After purchasing the iconnect, a username and temporary password will be sent to the registered address. Please login with username and password to the IMOGateway, Change the temporary password to a user password. Please refer to details of menu, USERS. More than one iconnect can be configured in the same user account and there is no need to create multiple accounts. Adding iconnect to the IMOGateway 1. Click on Add New Device as shown in image. 2. Note down the Unique Unit ID from the product label of the iconnect and enter the ID in the field Unit ID. Enter a user preferred name for easy identification for the user in the field Device Name. 3. Click Add Device button to add the iconnect device to the account. 4. The new device is now added to the account. 5

6 IMOGateway - Devices Once the device is added, the parameters such as following can be seen for the device. Version - This is the OS version number of the iconnect. When a new OS update is available, a new button will be available to press, to update the OS of the iconnect. Last Comms - This is the latest time at which IMO Gateway have seen the iconnect device. This time is updated every hour or after a power reboot of the iconnect device. IP Addresses - This is the internal IP address of the Ethernet port or the 3G modem module. Links - Edit iconnect - See overleaf Ethernet Settings - See overleaf CSV Downloads - See overleaf SIM Card - See page 8 6

7 Edit iconnect The Edit function enables you to select a new software module on your iconnect and setup the name details as shown below. Ethernet Settings Ethernet Settings allow you to change your iconnect Ethernet port settings. CSV Downloads Clicking this option navigates the menu to the FTP saved data files for the device. The same can be seen under the menu, DATA. You can download all files in CSV format for use with Microsoft Excel. 7

8 SIM Card With the SIM link you can view and edit your SIM card settings: Change the description name See your monthly Data usage Change you Tariff depending on your needs Change the SIM state Here you can visualise how much Data you have used. Also check the status of your SIM card. By pressing on Name/ICCID; Status or MSISDN you will be sent to your SIM card settings page, where you have the ability to change your Tariff if you exceed your Data Limit and want to add more. The following data plans are available to select in Tariff under SIMS. The plan has to be selected depending on the application requirements, and can be changed according to application data usage at a later date. Part Number M2M-DATA-10MB M2M-DATA-30MB M2M-DATA-50MB M2M-DATA-100MB M2M-DATA-200MB Description 10MB Monthly Usage 30MB Monthly Usage 50MB Monthly Usage 100MB Monthly Usage 200MB Monthly Usage 8

9 Software Modules FTP Function Clicking on one of the repository modules will open the software module. The module can be edited with user application parameters and can be saved to the Customer Modules by clicking Save As New. The default modules are as below: 1. iview to IMO Gateway This software module is to send files in the iview HMI to the IMO Gateway storage using the iconnect FTP function. 9

10 Device Name - The device name can be edited as required. Schedule - The dropdown for schedule gives option to select the interval at which the files need to be sent to the IMOGateway storage. The schedule interval ranges from a minute to a particular day of week. Configuration Script Device_ User editable and can be changed to identify the module in the application Source_server - IP Address of the source device from which the files needs to be send to the IMO gateway storage. In this case, the IP address of the iview HMI controller. Source_user - Username of the FTP server in the iview Source_password - Password of the FTP server in the iview Source_Folder - Folder from which the files need to be sent Source_Files - The file extension type of the file which needs to be sent Delete_Files - Y for deleting the files after transferring the files from the iview folder or N for keeping the files after transferring the files from the iview folder Suffix_Timestamp - Y for suffixing with a timestamp in the file name after transferring the files from the iview folder or N for not suffixing with a timestamp in the file name after transferring the files from the iview folder. The script can be copied and edited in the configuration field for up to 10 devices connected to an Ethernet switch. 2. Device FTP to External FTP Server This software module is to send files in any device FTP Server to an external FTP Server using the iconnect FTP function. Configuration Script Device_ User editable and can be changed to identify the module in the application Source_server - IP Address of the source device from which the files need to be sent to the external FTP server. Source_user - Username of the FTP server in the device Source_password - Password of the FTP server in the device Source_Folder - Folder from which the file needs to be sent Source_Files - The file extension type of the file which needs to be sent Destination_server - IP Address of the external FTP server to which the files need to be sent from the Device FTP server Destination_user - Username of the external FTP server Destination_password - Password of the external FTP server Destination_Folder - Folder to which the files need to be saved Delete_Files - Y for deleting the files after tranferring the files from the device folder or N for keeping the files after transferring the files from the device folder. Suffix_Timestamp - Y for suffixing with a timestamp in the file name after transferring the files from the device folder or N for not suffixing with a timestamp in the file name after transferring the files from the device folder. The script can be copied and edited in the configuration field for up to 10 devices connected to an Ethernet switch. 10

11 3. Device FTP to IMOGateway This software module is to send files in the device FTP server to the IMOGateway storage using the iconnect FTP function. Configuration Script Device_ User editable and can be changed to identify the module in the application Source_server IP Address of the source device from which the files need to be sent to the IMO gateway storage. Source_user - Username of the FTP server in the device Source_password - Password of the FTP server in the device Source_Folder - Folder from which the file needs to be sent Source_Files - The file extension type of the file which needs to be sent Delete_Files - Y for deleting the files after transferring the files from the device folder or N for keeping the files after transferring the files from the device folder. Suffix_Timestamp - Y for suffixing with a timestamp in the file name after transferring the files from the device folder or N for not suffixing with a timestamp in the file name after transferring the files from the device folder. The script can be copied and edited in the configuration field for up to 10 devices connected to an Ethernet switch. 11

12 Modbus Read Function This software module is to configure the Modbus Read function in iconnect to communicate with a Modbus slave device such as PLC, HMI, inverter drives and others to monitor addresses using 03H Read Holding Register Modbus command for up to 400 holding registers. The value read from the slave unit is logged to a MySQL compatible database in the IMO Gateway. The Modbus function uses the following port specification and these settings are not editable in the iconnect. Protocol - Modbus RTU; Baud Rate 9600; Data Bits 8; Stop Bits 1; Parity None, Type RS 485; Handshake Half Duplex; A Modbus cable is required to connect the iconnect to the Modbus Slave device. The part number of the cable is IC-USB-RS- LPC and is available to order from The cable is a USB to RS485 converter and should be plugged to any of the USB ports, USB 1 or USB 2. The RS 485 end of the cable should be connected to the slave device as below. iconnect IC-USB-RS-LPC Modbus Slave USB Orange Yellow RS485+ RS485 RS485+ RS485 The Modbus Read configuration is as below in the image. Module Name - User configurable Name Node ID - This is the Modbus ID of the slave unit which needs to be monitored Register - This is the Modbus Holding register of the slave unit. Use 4xxxx.0 for the first bit of the register, 4xxxx.1 for the second bit and similar or 4xxxx for the 16-bit register value. Name\Description - This is an user configurable field for identification of the Modbus register Min/Threshold and Max - These fields have the following functions 1. If these fields are blank, then any change in the register value is registered and logged to the database. 2. If the field Min/Threshold is filled with a value x and the field Max is kept empty, then the register value will be logged only when the current value is higher or lower by a value of x. 3. If the field Min/Threshold is filled with a value x and the field Max is y, then the register value will be logged only when the value is less than x or greater than y. Database Field - This is the tag of the register as in the database where the monitored value is logged. 12

13 IMOGateway Database The Modbus Read function logs all the values to a MySQL compliant database. The value from the database can be queried from a suitable database front end and the data can be processed suitably. Alternatively, suitable MySQL database tools can be used to view the database. There are many MySQL database tools available to view the database and following are some examples. Click the link to download the file. 1. HeidiSQL - Download Link Navicat for MySQL - The details to access the database such as hostname, username, password, database and the table can be noted from the top of the software module as below. 13

14 Modbus Write Function The iconnect have Modbus Write function which enables a user to change the value of a Modbus Write register in a Modbus RTU slave device. The function uses the Modbus command 10H. Only one register can be changed at a time. The Modbus function uses the following specification and these settings are not editable in the iconnect. Protocol - Modbus RTU; Baud Rate 9600; Data Bits 8; Stop Bits 1; Parity None, Type RS 485; Handshake Half Duplex; A Modbus cable is required to connect the iconnect to the Modbus Slave device. The part number of the cable is IC-USB-RS-LPC and is available to order from The cable is a USB to RS485 converter and should be plugged to any of the USB ports, USB 1 or USB 2. The RS 485 end of the cable should be connected to the slave device as below. iconnect IC-USB-RS-LPC Modbus Slave USB Orange Yellow RS485+ RS485 RS485+ RS485 The function can be used in two ways. An API link can be generated which can be used from a website or others to change the value of the register or a Modbus Write form is available to change the set points. In the Settings menu, the API for this function can be enabled. As shown in the image above, the API is enabled and by clicking the field shown as Click to disable the function can be disabled in the iconnect. Click the API key field to view and agree the caution notice for this function and view the API. 14

15 Click the Send CMD/API Example field to view the Modbus Write Command form and write a value to a Modbus register. To Write a Register Value Enter the Modbus ID of the slave device in the field Node ID. Enter the register address in the field Register in the format 4xxxx. Enter the value in the Value field as required for the application. The Value can be directly written to the slave device by clicking SEND. An API link can be generated by clicking Obtain URL and the generated URL can be found under Example URL. If the value is written successfully, then a message OK can be seen under Response 15

16 Data Alerts You can find all of your Alerts under DATA (main navigation) and by clicking on the folder icon The Copy icon will copy the alert and paste it underneath the existing one Deleting can be effected by clicking on the delete icon to remove the alert Edit Alerts Clicking here will take you to a new page, and you can then add a message to the alert and change the file name:- NOTE: You can display information by cell references (as in Microsoft Excel) in the message/alert sent out. You can use an * (asterisk) to reference the last row of a column as used in Microsoft Excel. E.g. C* Decide the frequency of notification alerts (from instant to 300mins ) Add addresses or mobile telephone numbers, separated by commas (, ) i.e. test1@sample.com, test2@sample.com, , etc. 16

17 IMOGateway - Settings The contact details, address and mobile alert number can be seen on this page, and can be edited at any time. To purchase more SMS credits for alerts, click Buy Additional. This will take you to SagePay to make a secure payment, credit will be available immediately. IMOGateway - SIMS The SIM card can be managed under SIMS. Clicking on the edit option gives the option to select data plans as required for the application usage. See page 8 for more information. IMOGateway - Billing All the billing details can be viewed under the menu, BILLING. All the relevant charges and the invoices can be viewed here. A monthly recurring payment can be set up using the Make Payment button. The standard payment details such as card number, expiry date, CVC and postcode is required to set up the payment plan. Once set up, you will receive a monthly automatically showing details of the invoice, amount etc. 17

18 IMOGateway - Users Users can manage the usernames and passwords under the menu, USERS. To add a new user, click Add New User. To delete a user, click 'x'. Change Your Password You can change your password at any time by simply navigating to USERS. A key-shaped icon will appear in front of the user name that you want to change, click the icon and the system will generate a new password. 18

19 Frequently Asked Questions Q: How many devices can I have, running on my account? A: There is no Limit for the amount of Devices you can have running on your IMOGateway account. Q: How secure is my Data? A: Your Data is very secure, we use McAfee Secure, Comodo, we are PCI DSS Compliant and comply to ISO 9001, to ensure your Data is always secure. Q: Do you offer Support? A: We do Offer Support, via on support@imo-gateway.com or phone (Mon-Fri 8:30am- 5:30pm GMT) Q: How much storage am I allocated? A: 500MB - In the need of more storage, please contact us and we will assist you in finding the correct storage for your account. Q: Does IMO Gateway provide Backups? A: We do Backup your data continually to prevent data loss. Q: How quickly does my Mobile Data usage show in the IMO Gateway? A: 15 minutes after the end of a Data connection, a reboot or 24 hours lapse will then force a data connection reset. Q: Can I add multiple contacts to receive my alerts? A: Yes, you can. In the alerts, on each recipient box you can enter multiple numbers/ addresses separated by commas. i.e. test@gateway.co.uk, jhg@gateway.co.uk, and so on. Q: How good is the coverage of the SIM? A: Our SIMs select the strongest network they can find. Q: Can the iconnect be used on a boat? A: It can. While at sea (outside network coverage) the iconnect will not get any network coverage, but when your connection comes back the iconnect will send all the data you collected while in the sea. Q: For how long does my warranty last? A: 1 year. Q: Areas with poor 3G reception (Basements)? A: If there is a poor reception, for example on a basement, you can purchase an aerial to connect to the 3G modem. Q: Can a third party SIM be used in the iconnect? A: No. 19

20 IMO Worldwide Offices IMO Precision Controls Limited 1000 North Circular Road Staples Corner London NW2 7JP United Kingdom Tel: +44(0) Fax: Web: IMO Jeambrun Automation SAS Centre D Affaires Rocroy 30, Rue de Rocroy Saint-Maur-Des-Fosses France Tel: (n o gratuit) Fax: imo-fr@imopc.com Web: IMO Automazione Via Ponte alle Mosse, Firenze (FI) Italia Tel: (toll free) Fax: imo-it@imopc.com Web: IMO Canada Unit 32 - B - North 18 Stratheam Avenue, Brampton Ontario L6T 4Y2 Canada Tel: (local) Fax: imo-ca@imopc.com Web: IMO UK IMO Jeambrun IMO Automazione IMO Canada IMO Automation IMO South Africa IMO Pacific IMO Automation LLC 101 Colony Park Drive, Suite 300 Cumming Georgia USA Tel: Fax: imo-usa@imopc.com Web: IMO South Africa (Pty) Ltd G16 Centurion Business Park Montague Gardens Cape Town 7441 South Africa Tel: Fax: info@imopc.co.za Web: IMO Pacific Pty Ltd 1/6 Dillington Pass Landsdale Perth WA 6065 Australia Tel: (local) Fax: sales@imopacific.com.au Web: iconnect-v3-user-manual-0716 Errors and omissions excepted Subject to change without notice Information correct at time of print ISO 9001 Registered Quality Management 015