iconnect & imogatewaydownloads.imopc.com/iconnect_v3_user_manual.pdf · iconnect is a remote...

iConnect & IMOGatewayUser Manual

User Manual

Table Of Contents

iConnect Overview.................................................................................................... 3 iConnect Models...................................................................................................... 4

IMOGateway............................................................................................................. 5

Devices........................................................................................................ 6

Software Modules..................................................................................................... 9

IMOGateway Database.............................................................................................. 13

Modbus Write Function............................................................................................. 14

Data......................................................................................................................... 16

IMOGateway Settings............................................................................................... 17

IMOGateway SIMS................................................................................................... 17

IMOGateway Billing.................................................................................................. 17

IMOGateway Users.................................................................................................. 18

Frequently Asked Questions..................................................................................... 19

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:

iConnect Dimensions

iConnect Overview

3

• 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

93

125

Antenna

DIN Rail Mount 65

Modbus Port

Ethernet Port

NOTE: All dimensions in mm

Input Voltage 5VDC

Input Current 1.2A

Operating Temperature 0°C to 50°C

Operating Humidity20% - 85%

Non-condensing

Weight 440g (491g 3G version)

Screw Torque Rating 0.5Nm

Technical Specification

* This feature will be available as an “over-the-air” (OTA) update by Q4/2016

4

iConnect Models

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, www.imo-gateway.com

Antenna

DIN Rail Mount

Modbus Port

Ethernet Port

iConnect-3G-V3

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, www.imo-gateway.com

iConnect-E-V3

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 email messages.

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 email messages.

* This feature will be available as an “over-the-air” (OTA) update by Q4/2016

5

IMOGateway

IMOGateway OverviewThe 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 IMOGatewayAfter purchasing the iConnect, a username and temporary password will be sent to the registered email address. Please login with username and password to the IMOGateway, www.imo-gateway.com . 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 IMOGateway1. 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.

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

Downloads - See overleaf

SIM Card - See page 8

CSV

7

Edit iConnectThe Edit function enables you to select a new software module on your iConnect and setup the name details as shown below.

Ethernet SettingsEthernet Settings allow you to change your iConnect Ethernet port settings.

CSV DownloadsClicking 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.

8

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

SIM Card

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.

Part Number Description

M2M-DATA-10MB 10MB Monthly Usage





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.

9

Software Modules

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.

FTP Function

10

Configuration Script

Device_0001 - 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.


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


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.



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.

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.


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


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.


12

Modbus Read FunctionThis 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 www.imopc.com. 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.

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 functions1. 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.

iConnect

USBOrange RS485+Yellow RS485–

IC-USB-RS-LPC Modbus Slave

RS485+RS485–

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 - http://www.heidisql.com/ Download Link - http://www.heidisql.com/installers/HeidiSQL_9.3.0.4984_Setup.exe2. Navicat for MySQL - https://www.navicat.com/store/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.

14

Modbus Write FunctionThe 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 www.imopc.com. 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.

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.

iConnect

USBOrange RS485+Yellow RS485–

IC-USB-RS-LPC Modbus Slave

RS485+RS485–

15

Click the Send CMD/API Example field to view the Modbus Write Command form and write a value to a Modbus register.

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

To Write a Register Value

16

Data

You can find all of your Alerts under DATA (main navigation) and by clicking on the folder icon

Alerts

Edit AlertsClicking here will take you to a new page, and you can then add a message to the alert and change the file name:-

• Decide the frequency of notification alerts (from “instant” to “300mins”)

• Add email addresses or mobile telephone numbers, separated by commas (“,”) i.e. [email protected], [email protected], 07777555555, 07973123456 etc.

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

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*

17

IMOGateway - SettingsThe contact details, email 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 - SIMSThe 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 - BillingAll 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 email automatically showing details of the invoice, amount etc.

18

IMOGateway - Users

Change Your PasswordYou 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.

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'.

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 email on [email protected] or phone 0333 344 1240. (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/email addresses separated by commas. i.e. [email protected], [email protected], 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

Frequently Asked Questions

IMO Worldwide Offices

IMO South Africa (Pty) Ltd G16 Centurion Business Park Montague Gardens Cape Town 7441 South Africa

Tel: 021 551 1787 Fax: 021 555 0676 Email: [email protected] Web: www.imopc.co.za

IMO Pacific Pty Ltd 1/6 Dillington Pass Landsdale Perth WA 6065 Australia

Tel: 08 9302 5246 (local) Fax: 08 9303 9908 Email: [email protected] Web: www.imopacific.com.au

IMO Automation LLC 101 Colony Park Drive, Suite 300 Cumming Georgia 30040 USA

Tel: 678 679 7110 Fax: 678 679 7112 Email: [email protected] Web: www.imoautomation.com

IMO Canada Unit 32 - B - North 18 Stratheam Avenue, Brampton Ontario L6T 4Y2 Canada

Tel: 905 799 9237 (local) Fax: 905 799 0450 Email: [email protected] Web: www.imopc.com

IMO Automazione Via Ponte alle Mosse, 61 50144 Firenze (FI) Italia

Tel: 800 930 872 (toll free) Fax: 8000 452 6445 Email: [email protected] Web: www.imopc.it

IMO Jeambrun Automation SAS Centre D’Affaires Rocroy 30, Rue de Rocroy 94100 Saint-Maur-Des-Fosses France

Tel: 0800 912 712 (no gratuit) Fax: 0145 134 737 Email: [email protected] Web: www.imojeambrun.fr

IMO Precision Controls Limited 1000 North Circular Road Staples Corner London NW2 7JP United Kingdom

Tel: +44(0)20 8452 6444 Fax: 020 8450 2274 Email: [email protected] Web: www.imopc.com

IMO UK

IMO Jeambrun

IMO Automazione

IMO Canada

IMO Automation

IMO South Africa

IMO Pacific

ISO 9001Registered

QualityManagement 015

Errors and omissions excepted Subject to change without notice

Information correct at time of printiConnect-v3-User-Manual-0716

iconnect & imogatewaydownloads.imopc.com/iconnect_v3_user_manual.pdf · iconnect is a remote...

Documents