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

groov EPIC User’s Guide ix
Understanding How Quality Errors are Reported . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 141
Viewing Information About a Quality Error . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 142
Chapter 16: Maintaining Your groov EPIC Unit . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 145
Backing up Your groov EPIC Processor Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 145
Backing up Your Ignition Edge Projects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 147
Restoring a Backup or Specific Settings from a Backup File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 147
Restoring your Ignition Edge Projects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 151
Updating Firmware on a groov EPIC Unit . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 151
Applying a Firmware Update to the groov EPIC Processor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 152
Installing an I/O Module Firmware Update . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 155
Replacing the Battery . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 157
How to Reset to Factory Defaults . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 159
Collecting Information for Product Support. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 159
Conducting an OptoSupport Remote Support Service (RSS) Session . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 160
Initiating an RSS Session . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 161
Pausing and Resuming an RSS Session . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 162
Ending the RSS Session . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 162
Chapter 17: Troubleshooting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 163
Cannot Connect to the SSH Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 163
One of the Modules is Blinking Red . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 164
One of the Modules is Blinking Violet. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 164
SSH Server User ID and Password are Rejected. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 164
Changes Aren’t Saved or They Suddenly Change . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 165
groov EPIC Processor Touchscreen Keeps Jumping to Module Information Page. . . . . . . . . . . . . . . . . . . . 165
Touchscreen Doesn’t Respond Accurately to Finger taps . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 165
Ethernet Cable is Plugged In, but No IP Address . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 165
Web Browser Can’t Connect to Processor. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 165
The SPEED LED on the Processor Changed Color. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 165
Time zone change not shown in Ignition Edge . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 166
CODESYS: Can’t Connect to groov EPIC Processor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 166
Troubleshooting Network Issues . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 167
Ping . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 167
Test TCP Port . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 167
Traceroute . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 168
NsLookup . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 168
Appendix A: Processor specifications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 171
GRV-EPIC-PR1. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 171
Appendix B: Power supply specifications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 173
GRV-EPIC-PSAC, GRV-EPIC-PSDC, GRV-EPIC-PSPT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 173
Appendix C: Chassis specifications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 175
GRV-EPIC-CHS0, GRV-EPIC-CHS4, GRV-EPIC-CHS8, GRV-EPIC-CHS16. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 175

groov EPIC User’s Guide
x
Appendix D: I/O module specifications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 177
GRV-CSERI-4. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 177
Features . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 177
Specifications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 178
GRV-IAC-24, GRV-IACI-12, GRV-IACS-24, GRV-IACIS-12 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 178
Features . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 179
Specifications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 179
GRV-IACDCTTL-24, GRV-IACDCTTLS-24. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 180
Features . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 180
Specifications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 181
GRV-IACHV-24, GRV-IACIHV-12, GRV-IACHVS-24, GRV-IACIHVS-12 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 181
Features . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 182
Specifications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 182
GRV-IDC-24, GRV-IDCI-12, GRV-IDCS-24, GRV-IDCSW-12, GRV-IDCIS-12, GRV-IDCIFQ-12. . . . . . . . . . . . . . 183
Features . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 183
Specifications for GRV-IDC-24, GRV-IDCI-12, GRV-IDCS-24, GRV-IDCIS-12, GRV-IDCIFQ-12 . . . . . . . 184
Specifications for GRV-IDCSW-12 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 186
GRV-IICTD-12 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 187
Features . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 187
Specifications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 188
GRV-IMA-24, GRV-IMAI-8 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 189
Features . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 189
Specifications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 190
GRV-ITM-12, GRV-ITMI-8. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 191
Features . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 191
Specifications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 192
GRV-ITR-12, GRV-IRTD-8 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 193
Features . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 193
Specifications for GRV-ITR-12 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 194
Specifications for GRV-IRTD-8 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 195
GRV-IV-24, GRV-IVI-12 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 196
Features . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 196
Specifications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 197
GRV-OAC-12, GRV-OACI-12, GRV-OACS-12, GRV-OACIS-12 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 198
Specifications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 199
GRV-ODCI-12, GRV-ODCIS-12. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 200
Features . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 200
Specifications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 201
GRV-ODCSRC-24. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 202
GRV-OMRIS-8. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 203
GRV-OVMALC-8. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 204
Appendix E: I/O module wiring diagrams . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 205
GRV-CCANI-2 Pinout and Wiring Diagram . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 205
GRV-CSERI-4 Pinout and Wiring Diagram. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 206
GRV-IAC-24, GRV-IACS-24 Pinout and Wiring Diagram . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 207
GRV-IACI-12, GRV-IACIS-12 Pinout and Wiring Diagram . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 208

groov EPIC User’s Guide xi
GRV-IACDCTTL-24, GRV-IACDCTTLS-24 Pinout and Wiring Diagram. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 209
GRV-IACHV-24, GRV-IACHVS-24 Pinout and Wiring Diagram. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 210
GRV-IACIHV-12, GRV-IACIHVS-12 Pinout and Wiring Diagram. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 211
GRV-IDC-24, GRV-IDCS-24 Pinout and Wiring Diagram . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 212
GRV-IDCSW-12 Pinout and Wiring Diagram. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 213
GRV-IDCI-12, GRV-IDCIS-12 Pinout and Wiring Diagram . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 214
GRV-IDCIFQ-12 Pinout and Wiring Diagram . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 215
Wiring to Quadrature Encoders . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 215
Wiring to Typical (Signal) Sources . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 216
GRV-IICTD-12 Pinout and Wiring Diagram . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 217
GRV-IMA-24 Pinout and Wiring Diagram . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 218
GRV-IMAI-8 Pinout and Wiring Diagram . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 219
GRV-IRTD-8 Pinout and Wiring Diagram . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 220
GRV-ITM-12 Pinout and Wiring Diagram. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 221
GRV-ITMI-8 Pinout and Wiring Diagram . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 222
GRV-ITR-12 Pinout and Wiring Diagram . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 223
GRV-IV-24 Pinout and Wiring Diagram . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 224
GRV-IVI-12 Pinout and Wiring Diagram. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 225
GRV-OAC-12, GRV-OACS-12 Pinout and Wiring Diagram . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 226
GRV-OACI-12, GRV-OACIS-12 Pinout and Wiring Diagram . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 227
GRV-ODCI-12, GRV-ODCIS-12 Pinout and Wiring Diagram . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 228
GRV-ODCSRC-24 Pinout and Wiring Diagram . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 229
GRV-OMRIS-8 Pinout and Wiring Diagram . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 230
GRV-OVMAILP-8 Pinout and Wiring Diagram . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 231
GRV-OVMALC-8 Pinout and Wiring Diagram. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 232
Appendix F: Installing the Correct License . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 233
Installing Licenses on Processors with Firmware Earlier Than 1.3.0 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 233
Installing the groov Plus or groov Enterprise License . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 233
Adding Ignition Edge or CODESYS when you Upgrade to 1.3.0 or Later . . . . . . . . . . . . . . . . . . . . . . . . . . . . 234
Appendix G: Advanced Networking Configurations . . . . . . . . . . . . . . . . . . . . . . . . . . . . 235
Redirecting Traffic Initiated by an Incoming Connection Request . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 235
Outbound Traffic Not Initiated by an Incoming Connection Request . . . . . . . . . . . . . . . . . . . . . . . . . . . 236

groov EPIC User’s Guide
xii

groov EPIC User’s Guide 1
1
Appendix A
1: Welcome to groov EPIC
The groov EPIC® system is the next step in the evolution of automation. The system includes:
•An Edge Programmable Industrial Controller with an embedded Linux® operating system and gateway
functions. We call it the groov EPIC processor because it can do controller functions and so much more:
–Edge–Moving more visualization, control, and data acquisition functions to the place where it all
happens: at the edge.
–Programmable–Offering more ways to support the creation of control programs that fit your needs:
flowchart programming through PAC Control, IEC 61131-3 compliant programming through
CODESYS®, or custom programming in popular programming languages with access to the Linux
operating system through a secure shell.
–Industrial–Designed to work in a wide range of environments, meeting UL and ATEX requirements
for hazardous locations.
–Controller®–You can rely on real-time control and I/O from an automation manufacturer with 45+
years of experience. Opto 22’s worldwide reputation for quality was built on solid state relays and
I/O, and all our experience is poured into the design of groov EPIC.
•groov® I/O modules, most guaranteed-for-life and available in discrete, analog, and serial models. All are
configurable by the groov EPIC processor and have up to 24 channels per module.
•groov EPIC power supplies for AC power, DC conversion, and adapters for pass-through connections from
a DC power supply you already own.
•groov EPIC chassis that holds the processor, I/O modules, and power supply. Available in 4-, 8-, and
16-module models.
SYSTEM REQUIREMENTS
•To build PAC Control strategies with the PAC Project Basic Software Suite that comes with groov EPIC, you
will need:
– A computer with a standard or mainstream processor and (at least) the minimum memory required
for your version of Microsoft Windows. (Low-end CPUs are not recommended.) Additional memory
may be required for some configurations.
– One of the following operating systems:
– Microsoft Windows 10 Professional (32-bit or 64-bit)
– Windows 8.1 Professional (32-bit or 64-bit)
– Windows 7 Professional (32-bit or 64-bit)
•To build operator interfaces with groov View, you’ll need:
– Any computer with a web browser (does not have to be a Windows PC)
– One or more of the following:
– A Modbus/TCP device

ABOUT THIS GUIDE
groov EPIC User’s Guide
2
– A database, online service, or software program to get data from or put data into a Data Store
using the groov API
–Agroov EPIC processor or SNAP PAC controller (SNAP PAC S-series, R-series, or SoftPAC, with
firmware R9.2a or newer), running a PAC Control strategy
– An Opto 22 SNAP PAC I/O unit
– A database, cloud application, API, or serial device accessible via a Node-RED node.
– OPC UA-compatible automation system or equipment. Ignition Edge supplies an internal
server and drivers for groov EPIC. Additional drivers or an external OPC UA server may be
required for your equipment.
•To build control programs with the CODESYS Development System, you’ll need:
– A computer that meets the minimum requirements established by CODESYS. For more information,
visit the CODESYS website (www.codesys.com).
– The Opto 22 Library Package, which contains the information that CODESYS Development System
needs to correctly configure and connect to a groov EPIC processor. For instructions on
downloading and installing this package, see “Adding the Opto 22 Library Package to CODESYS
Development System”on page 64.
– CODESYS Development System, V3.5 SP13 Patch 1 or newer (32-bit version). For instructions, see
“Downloading and Installing CODESYS Development System”on page 64.
If you are using CODESYS PROFINET Controller SL, you will need CODESYS Development System,
V3.5 SP15 Patch 10 or newer. You also want to make sure the CODESYS PROFINET device is at version
3.5.15.10 or newer. To check:
1. Click Tools > Device Repository.
2. Expand Fieldbusses > Profinet I/O > Profinet I/O Device.
3. Find CODESYS Profinet Device and check the version.
–Agroov EPIC processor (GRV-EPIC-PR1) with minimum firmware version 1.3.0.
Note: If you are using CODESYS PROFINET Controller SL, you need version 1.5.0 or newer.
ABOUT THIS GUIDE
This user’s guide shows you how to assemble and initialize your groov EPIC unit, how to configure the software
and I/O modules, how to configure system settings, and much more.

CHAPTER 1: WELCOME TO GROOV EPIC
groov EPIC User’s Guide 3
Throughout this guide, you might see two versions of the same page. This is done to show you important
differences between viewing a page through the groov EPIC processor’s touchscreen and viewing the same
page through a computer web browser or mobile device.
groov EPIC touchscreen Computer web browser

ABOUT THIS GUIDE
groov EPIC User’s Guide
4
What’s in This Guide
Chapter 1: Welcome to groov EPIC (this chapter) introduces this user’s guide and groov EPIC.
Chapter 2: Additional safety and operating instructions describes important safety and operating
information.
Chapter 3: Assembling your groov EPIC unit describes how to assemble the parts of a groov EPIC unit (the
processor, the power supply, the chassis, and the I/O modules).
Chapter 4: Initializing the groov EPIC Processor describes the configuration steps you might want to do
first to get your groov EPIC system up and running.
Chapter 5: Navigating Through the groov EPIC Processor describes how to navigate through software on
the groov EPIC processor touchscreen, some differences between navigating on the touchscreen and
navigating through a web browser, and introduces you to some of the important features of some of the
screens, like the Modules page.
Chapter 6: Controlling Access to groov EPIC Processor describes the security features available on the
groov EPIC processor and how you might want to configure these features to control who has access to your
unit.
Chapter 7: Connecting groov EPIC to a Network or Multiple Networks describes the options available to
connect a groov EPIC processor to more complex networking environments.
Chapter 8: Enabling MQTT describes the options available for publishing automation data in a MQTT
infrastructure, as well as what to do to set up these options.
Chapter 9: Configuring System Features describes how to modify features (like networking) so they work
the way you need them to in your application.
Chapter 10: Configure CODESYS and groov EPIC for IEC61131-3 describes how to enable the CODESYS
Runtime Engine so you can build and download applications developed with the CODESYS Development
System.
Chapter 11: Working with groov EPIC Devices in CODESYS Projects describes how to add and configure
a groov EPIC processor to your CODESYS Development System, and how to configure processor parameters
and channel features so you can begin programming.
Chapter 12: Downloading and Running PAC Control Programs describes how to download and run PAC
Control strategies.
Chapter 13: Downloading and Running Custom Control Programs describes how to access the secure
shell feature to develop and download control programs written in other programming languages.
Chapter 14: Developing and Deploying Node-RED flows describes how to get started building and
deploying Node-RED flows, including how to add the Opto 22 nodes.
Chapter 15: Monitoring and Configuring Modules and Channels describes the features available on the
groov EPIC processor to help view the status of your modules and how to configure them.
Chapter 16: Maintaining Your groov EPIC Unit describes the tasks you can do to keep your groov EPIC unit
running in top shape, like applying maintenance. It also describes how to start an OptoSupport Remote
Support Service session.
Chapter 17: Troubleshooting describes what to do when you encounter problems (troubleshooting).
Appendix A: Processor specifications provides the technical specifications of the groov EPIC processor.
Appendix B: Power supply specifications provides the technical specifications of the groov EPIC power
supply, power converter, and power adapter.
Appendix C: Chassis specifications provides the technical specifications of the groov EPIC chassis.

CHAPTER 1: WELCOME TO GROOV EPIC
groov EPIC User’s Guide 5
Appendix D: I/O module specifications provides the technical specifications of all the groov I/O modules.
Appendix E: I/O module wiring diagrams provides the wiring diagrams for all the groov I/O modules.
Appendix F: Installing the Correct License describes how to properly install licenses for groov EPIC
processors that have versions of firmware older than 1.3.0.
Appendix G: Advanced Networking Configurations describes special networking functions that are
usually managed by network administrators for specific and rare situations.

ABOUT THIS GUIDE
groov EPIC User’s Guide
6