OPTO 22 groov EPIC User manual

groov EPIC
USER’S GUIDE
Form 2267

groov EPIC User’s Guide i
groov EPIC
USER’S GUIDE
Form 2267-191221—December 2019
43044 Business Park Drive • Temecula • CA 92590-3614
Phone: 800-321-OPTO (6786) or 951-695-3000
Fax: 800-832-OPTO (6786) or 951-695-2712
www.opto22.com
Product Support Services
800-TEK-OPTO (835-6786) or 951-695-3080
Fax: [phone]
Email: [email protected]
Web: support.opto22.com

groov EPIC User’s Guide
ii
groov EPIC User’s Guide
Form 2267-191221—December 2019
Copyright © 2018-2019 Opto 22.All rights reserved.
Printed in the United States of America.
The information in this manual has been checked carefully and is believed to be accurate; however, Opto 22 assumes no
responsibility for possible inaccuracies or omissions. Specifications are subject to change without notice.
Opto 22 warrants all of its products to be free from defects in material or workmanship for 30 months from the
manufacturing date code. This warranty is limited to the original cost of the unit only and does not cover installation, labor,
or any other contingent costs. Opto 22 I/O modules and solid-state relays with date codes of 1/96 or newer are guaranteed
for life. This lifetime warranty excludes reed relay, SNAP serial communication modules, SNAP PID modules, and modules
that contain mechanical contacts or switches. Opto 22 does not warrant any product, components, or parts not
manufactured by Opto 22; for these items, the warranty from the original manufacturer applies. Refer to Opto 22 form
1042 for complete warranty information.
Wired+Wireless controllers and brains are licensed under one or more of the following patents: U.S. Patent No(s). 5282222,
RE37802, 6963617; Canadian Patent No. 2064975; European Patent No. 1142245; French Patent No. 1142245; British Patent
No. 1142245; Japanese Patent No. 2002535925A; German Patent No. 60011224.
Opto 22 FactoryFloor, groov, groov EPIC, mobile made simple, Optomux, and Pamux are registered trademarks of Opto 22.
Generation 4, groov Server, ioControl, ioDisplay, ioManager, ioProject, ioUtilities, mistic, Nvio, Nvio.net Web Portal,
OptoConnect, OptoControl, OptoDataLink, OptoDisplay, OptoEMU, OptoEMU Sensor, OptoEMU Server, OptoOPCServer,
OptoScript, OptoServer, OptoTerminal, OptoUtilities, PAC Control, PAC Display, PAC Manager, PAC Project, PAC Project Basic,
PAC Project Professional, SNAP Ethernet I/O, SNAP I/O, SNAP OEM I/O, SNAP PAC System, SNAP Simple I/O, SNAP Ultimate
I/O, and Wired+Wireless are trademarks of Opto 22.
ActiveX, JScript, Microsoft, MS-DOS, VBScript, Visual Basic, Visual C++, Windows, and Windows Vista are either registered
trademarks or trademarks of Microsoft Corporation in the United States and other countries. Linux is a registered
trademark of Linus Torvalds. ARCNET is a registered trademark of Datapoint Corporation. Modbus is a registered trademark
of Schneider Electric, licensed to the Modbus Organization, Inc. Wiegand is a registered trademark of Sensor Engineering
Corporation. Allen-Bradley, CompactLogix, ControlLogix, MicroLogix, SLC, and RSLogix are either registered trademarks or
trademarks of Rockwell Automation. CIP and EtherNet/IP are trademarks of ODVA. Raspberry Pi is a trademark of the
Raspberry Pi Foundation. The registered trademark Ignition by Inductive Automation® is owned by Inductive Automation
and is registered in the United States and may be pending or registered in other countries. CODESYS® is a registered
trademark of 3S-Smart Software Solutions GmbH.
groov includes software developed by the OpenSSL Project for use in the OpenSSL Toolkit. (http://www.openssl.org)
All other brand or product names are trademarks or registered trademarks of their respective companies or organizations.
Opto 22
Automation Made Simple.

groov EPIC User’s Guide iii
The equipment covered by this report is considered to be a component intended to be professionally
configured/installed into another manufacturer’s end-product equipment. Also the equipment is intended to
be mounted in an #IP54 enclosure according to the manual. No cleaning instruction is provided in manual.
Therefore, testing and evaluation for the requirements of these clauses is not considered necessary.
IMPORTANT INSTALLATION INSTRUCTIONS
Power, input, and output wiring must be in accordance with Class I, Division 2 wiring methods, Article 501-4
(b) of the National Electrical Code, NFPA 70 for installation in the U.S., or as specified in Section 18-1J2 of the
Canadian Electrical Code for installations in Canada, and in accordance with the authority having jurisdiction.
The following warning must be heeded:
WARNING - EXPLOSION HAZARD - SUBSTITUTION OF COMPONENTS MAY IMPAIR SUITABILITY FOR CLASS 1,
DIV. 2.
WARNING - EXPLOSION HAZARD - WHEN IN HAZARDOUS LOCATIONS, TURN OFF POWER BEFORE REPLACING
OR WIRING MODULES.
WARNING - EXPLOSION HAZARD - DO NOT DISCONNECT EQUIPMENT UNLESS POWER HAS BEEN SWITCHED
OFF OR THE AREA IS KNOWN TO BE NON-HAZARDOUS.
THIS DEVICE SHALL BE POWERED BY CLASS 2 OUTPUTS ONLY.
MVI (Multi Vendor Interface) Modules
WARNING - EXPLOSION HAZARD - DO NOT DISCONNECT EQUIPMENT UNLESS POWER HAS BEEN SWITCHED
OFF OR THE AREA IS KNOWN TO BE NON-HAZARDOUS.
AVERTISSEMENT - RISQUE D’EXPLOSION - AVANT DE DÉCONNECTER L’ÉQUIPEMENT, COUPER LE COURANT OU
S’ASSURER QUE L’EMPLACEMENT EST DÉSIGNÉ NON DANGEREUX.
WARNINGS
North America Warnings
Power, input, and output wiring must be in accordance with Class I, Division 2 wiring methods, Article 501-4
(b) of the National Electrical Code, NFPA 70 for installation in the U.S., or as specified in Section 18-1J2 of the
Canadian Electrical Code for installation sin Canada, and in accordance with the authority having jurisdiction.
The following warnings must be heeded:
AWarning - Explosion Hazard - Substitution of components may impair suitability for Class 1, Div. 2.
EWarning - Explosion Hazard - When in hazardous locations, turn off power before replacing or wiring
modules.
FWarning - Explosion Hazard - Do not disconnect equipment unless power has been switched off or the
area is known to be non-hazardous.
Avertissement - Risque d’explosion - Avant de déconnecter l’équipment, couper le courant ou s’assurer que
l’emplacement est désigné non dangereux.
GSuitable for use in Class I, Division 2 Groups A, B, C and D Hazardous Locations or Non-Hazardous Loca-
tions.
ATEX Warnings and Conditions of Safe Usage
Power, input, and output (I/O) wiring must be in accordance with the authority having jurisdiction.
AWarning - Explosion Hazard - When in hazardous locations, turn off power before replacing or wiring
modules.
EWarning - Explosion Hazard - Do not disconnect equipment unless power has been switched off or the
area is known to be non-hazardous.
FThese products are intended to be mounted in an IP54 enclosure. The devices shall provide external
means to prevent the rated voltage being exceeded by transient disturbances of more than 40%. This
device must be used only with ATEX certified backplanes.
GDO NOT OPEN WHEN ENERGIZED.

groov EPIC User’s Guide
iv
MARKINGS
Electrical Ratings
• Power Requirements: 7.1 W typical, 9.1 W max.
• Operating Temperature: -20 °C to +70 °C
• Storage Temperature: -40 °C to +85 °C
• Relative Humidity: 5–95%
For the electrical ratings of power supplies, I/O modules, and chassis, see their respective data sheets.
Label Markings
ATEX
II3 G Ex NA IIC T4 Gc
-20 °C ≤ Ta ≤ 70 °C
cULus
Class 1 Division 2, Groups A, B, C, D
T4
-20 °C ≤ Ta ≤ +70 °C
Agency Approvals and Certifications
Agency Applicable Standard
RoHS
CE EMC-EN61326- 1:2006; EN61000-6- 4:2007
Hazardous Locations ANSI/I.S.A. 12.12.01-2015, Rev. 2015-11-17; CAN/CSA C22.2
No. 213-16, 2nd Ed., Issued 2016-05-11
ATEX EN60079-15:2003; EN60079-15:2010
cULus UL61010-1: 2010, 3rd Ed.; UL61010-201, 1st Ed.
DFARS

groov EPIC User’s Guide v
v
Table of Contents
Chapter 1: Welcome to groov EPIC . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1
System Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1
About This Guide . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2
What’s in This Guide . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
Chapter 2: Additional safety and operating instructions . . . . . . . . . . . . . . . . . . . . . . . . . . 7
Safety instructions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
Safety instructions for installing the groov EPIC unit as part of machinery. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
Explanation of labels or symbols . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8
Operating controls . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8
Service and maintenance. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
Service (Product Support) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
Chapter 3: Assembling your groov EPIC unit . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
Gathering your equipment and information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
Familiarize yourself with groov I/O modules . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
Verifying serial number on the processor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12
Activating the groov EPIC unit and downloading the license file . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12
Assembling your unit . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
Connecting power supply wires and field device wires. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18
Connecting field devices to the groov I/O modules . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18
Connecting ground . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20
Connecting power supply wires . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20
Connecting the Ethernet cable . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21
Turn on unit and continue with initializing the unit . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21
Chapter 4: Initializing the groov EPIC Processor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23
Creating the First Administrator Account . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24
Choosing Between Quick Start and Configure Device . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25
Completing the Quick Start. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26
Chapter 5: Navigating Through the groov EPIC Processor . . . . . . . . . . . . . . . . . . . . . . . 27
Click or Tap Your Way Around groov Manage. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27
Learning the Screen Navigation Aids . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28

groov EPIC User’s Guide
vi
Navigating Through groov Manage . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29
Navigating Through groov Manage on the groov EPIC Processor Touchscreen . . . . . . . . . . . . . . . . . . 30
Navigating Through groov Manage on a Computer or Mobile Device . . . . . . . . . . . . . . . . . . . . . . . . . . . 31
Finding Information About I/O Modules and Their Channels . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32
Chapter 6: Controlling Access to groov EPIC Processor . . . . . . . . . . . . . . . . . . . . . . . . . 35
Part of an Overall Security System. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35
Creating User IDs and Configuring Their Access . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35
Choosing Access Levels for Users . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35
Creating User IDs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36
Managing the SSL Security Features of your groov EPIC Processor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36
Learning How SSL Works on groov EPIC . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36
Why Change the SSL Security Features on Your groov EPIC Processor? . . . . . . . . . . . . . . . . . . . . . . . . . . 37
Creating a Self-Signed Certificate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37
Switching to a CA-signed Certificate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38
Uploading a Public Key Certificate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39
Changing SSL Security Features for Sparkplug . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39
Configuring the Firewall. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40
Creating a Firewall Rule . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41
Changing a Firewall Rule . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44
Chapter 7: Connecting groov EPIC to a Network or Multiple Networks . . . . . . . . . . . . .47
Selecting a Network Configuration. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48
Initializing with ETH0 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48
Keeping Networks Separate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49
Reviewing Network Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49
Collecting Network Configuration Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51
Collecting Information for Automatic Connections . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51
Collecting Information for Manual Connections . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52
Collecting Network Configuration Information for OpenVPN Connection . . . . . . . . . . . . . . . . . . . . . . . 53
Configuring the Network Interfaces . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55
Configuring ETH0 or ETH1 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56
Configuring WLAN0 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57
Saving the Configuration. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58
Connecting to a Virtual Private Network (VPN). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58
Testing the Network Connections and Fine-Tuning Security. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60
Chapter 8: Enabling MQTT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61
What is MQTT?. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61
MQTT on the groov EPIC processor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61
Configuring and Enabling MQTT with String Payloads . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63
Collecting Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63
Configuring and Enabling MQTT Service . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64
Configuring and Enabling MQTT with Sparkplug Payloads from GRV-EPIC-PR1 . . . . . . . . . . . . . . . . . . . . . . . 65
Collecting Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 66
Configuring and Enabling MQTT Service . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 67
Configuring and Enabling MQTT with Sparkplug Payloads (through Ignition Edge Software). . . . . . . . . . 68
What is Ignition Edge? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 69

groov EPIC User’s Guide vii
Configuring and Starting Ignition Software . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 70
Configuring the Ignition Edge System Gateway . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 70
Licensing Ignition Software . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 71
Changing the Default Password for Ignition Edge Gateway . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73
Installing the OPC UA groov EPIC and SNAP PAC Driver . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74
Installing the Ignition Edge MQTT Module . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75
Chapter 9: Configuring System Features . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77
Switching Between PAC Control Engine and CODESYS Runtime Engine. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77
Setting and Adjusting Date, Time, and Time Zones . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 78
Setting the Date and Time Manually . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 78
Setting the Date, Time, and Time Zone by Synchronizing with Time Servers . . . . . . . . . . . . . . . . . . . . 78
Setting the Time and Time Zone by Selecting a Location . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 79
Selecting Which App to Load After User Log In . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 79
Configuring the groov EPIC Processor for Shell Access. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 80
Connecting Serial Devices . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 80
Connecting a Serial Device Directly to the groov EPIC Processor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 80
Connecting a Serial Device Through a groov Serial Module . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81
Device Name, Port Number, CAN Port Number, and CAN Port Name . . . . . . . . . . . . . . . . . . . . . . . . . . . 81
Finding Device Names, Port Numbers, CAN Port Names, or CAN Port Numbers . . . . . . . . . . . . . . . . . 82
Configuring the Communication Ports or Handles to Serial Devices . . . . . . . . . . . . . . . . . . . . . . . . . . . . 84
Connecting a Mouse and a Keyboard . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 84
Connecting an External Monitor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 85
Connecting an External Monitor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 86
Disconnecting an External Monitor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 88
Connecting a USB Storage Device. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 88
Disabling Access to USB Storage Devices . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 89
Mounting and Unmounting USB Storage Devices . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 90
Copying, Moving, or Downloading a File on a USB Storage Device . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 92
Installing an Approved USB WiFi Adapter. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 93
Calibrating the Processor’s Touchscreen. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 93
Uploading Files to the groov EPIC Processor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 94
Chapter 10: Configure CODESYS and groov EPIC for IEC61131-3 . . . . . . . . . . . . . . . . . . 95
Obtaining Your CODESYS Activation Key Certificate and Ticket ID. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 96
Downloading and Installing CODESYS Development System . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 96
Adding the Opto 22 Library Package to CODESYS Development System . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 96
Reviewing Network Configurations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 97
Enable the CODESYS Control Engine on the groov EPIC Processor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 97
Connecting Processor to Gateway and Entering the CODESYS Ticket ID . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 97
Managing CODESYS Runtime Engine and CODESYS Applications. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 98
Enabling the CODESYS Runtime Engine . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 98
Disabling the CODESYS Runtime Engine . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 99
Transferring the CODESYS License to Another GRV-EPIC-PR1 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 99
Chapter 11: Working with groov EPIC Devices in CODESYS Projects . . . . . . . . . . . . . . .101
Adding a groov EPIC Device to a CODESYS Project . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 101

groov EPIC User’s Guide
viii
Creating a New CODESYS Project and Adding a groov EPIC Device . . . . . . . . . . . . . . . . . . . . . . . . . . . . 102
Editing an Existing Project to Add a groov EPIC Device . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 102
Updating groov EPIC and groov I/O Module Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 103
Creating Network Interfaces for the groov EPIC Device . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 103
Setting Up Local I/O – Adding groov EPIC to the Device Tree . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 105
Setting Up Local I/O – Plugging in groov I/O Modules . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 105
Plugging in I/O modules automatically . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 105
Plugging in I/O modules manually . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 106
Configuring Processor Parameters and Channel Features . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 106
Configuring Processor Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 106
Setting Channel Features . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 107
Reading or Clearing Latches and States . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 110
Creating a Symbol Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 112
Referencing Files Stored in the groov EPIC Processor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 113
Downloading and Running CODESYS Applications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 113
Starting or Stopping CODESYS Applications on the groov EPIC Processor . . . . . . . . . . . . . . . . . . . . . . 113
Monitoring Latches, States, and Counters: CODESYS or groov Manage? . . . . . . . . . . . . . . . . . . . . . . . . 113
Chapter 12: Downloading and Running PAC Control Programs . . . . . . . . . . . . . . . . . . . 115
Downloading and Running PAC Control Strategies . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 115
Identifying the Strategy that is Running on the groov EPIC Processor . . . . . . . . . . . . . . . . . . . . . . . . . . 115
Enabling or Disabling Background Downloading . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 115
Identifying Serial Devices Accessible to the Control Engine . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 117
Disabling the PAC Control Engine . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 117
Enabling the PAC Control Engine . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 118
Chapter 13: Downloading and Running Custom Control Programs . . . . . . . . . . . . . . . . 119
Verifying SSH Access . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 119
Stopping the SSH Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 120
Starting the SSH Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 121
Chapter 14: Developing and Deploying Node-RED flows . . . . . . . . . . . . . . . . . . . . . . . . .123
What is Node-RED and how does it work in groov EPIC?. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 123
Node-RED in the groov EPIC processor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 123
Creating your first Node-RED flow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 124
Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 124
Opening the Node-RED Editor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 124
Creating a flow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 125
Deploying the flow and testing it . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 126
Adding a Function node . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 127
Installing groov View nodes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 129
Adding an Opto 22 PAC Control node . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 130
Chapter 15: Monitoring and Configuring Modules and Channels . . . . . . . . . . . . . . . . . .135
Checking the Health (Status) of a Module . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 135
Checking Module Status Through the Module LED . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 136
Checking Module Status Through groov Manage on a Browser . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 136
Configuring groov I/O Modules and Channels . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 137