Hide thumbs Also See for groov EPIC:
Table of Contents

Advertisement

Quick Links

Form 2267
groov EPIC
USER'S GUIDE

Advertisement

Table of Contents
loading
Need help?

Need help?

Do you have a question about the groov EPIC and is the answer not in the manual?

Questions and answers

Summary of Contents for OPTO 22 groov EPIC

  • Page 1 Form 2267 groov EPIC USER’S GUIDE...
  • Page 3 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: 951-695-3017 Email: support@opto22.com Web: support.opto22.com groov EPIC User’s Guide...
  • Page 4 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.
  • Page 5 These 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. DO NOT OPEN WHEN ENERGIZED. groov EPIC User’s Guide...
  • Page 6 Agency Approvals and Certifications Agency Applicable Standard RoHS EMC-EN61326- 1:2006; EN61000-6- 4:2007 ANSI/I.S.A. 12.12.01-2015, Rev. 2015-11-17; CAN/CSA C22.2 Hazardous Locations No. 213-16, 2nd Ed., Issued 2016-05-11 ATEX EN60079-15:2003; EN60079-15:2010 cULus UL61010-1: 2010, 3 Ed.; UL61010-201, 1 DFARS groov EPIC User’s Guide...
  • Page 7: Table Of Contents

    Chapter 4: Initializing the groov EPIC Processor ....... . 23...
  • Page 8 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 .
  • Page 9 Adding the Opto 22 Library Package to CODESYS Development System ......96...
  • Page 10 Creating a New CODESYS Project and Adding a groov EPIC Device ......102...
  • Page 11 Chapter 16: Maintaining Your groov EPIC Unit ....... . .
  • Page 12 GRV-IACI-12, GRV-IACIS-12 Pinout and Wiring Diagram ..........208 groov EPIC User’s Guide...
  • Page 13 Outbound Traffic Not Initiated by an Incoming Connection Request ......236 groov EPIC User’s Guide...
  • Page 14 EPIC User’s Guide...
  • Page 15: Chapter 1: Welcome To Groov Epic

    • 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.
  • Page 16: About This Guide

    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.
  • Page 17 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.
  • Page 18: What's In This Guide

    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.
  • Page 19: Appendix D: I/O Module Specifications

    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.
  • Page 20 ABOUT THIS GUIDE groov EPIC User’s Guide...
  • Page 21: Chapter 2: Additional Safety And Operating Instructions

    Use your groov EPIC unit only in a manner in which it complies with all safety and additional instructions described in this guide. If the groov EPIC unit is used in a manner not specified by Opto 22, the protection provided by the groov EPIC unit may be impaired.
  • Page 22: Explanation Of Labels Or Symbols

    EXPLANATION OF LABELS OR SYMBOLS EXPLANATION OF LABELS OR SYMBOLS The following table explains the labels or symbols you might see on the groov EPIC power supplies, processor, or modules: Label or Symbol Explanation CAUTION: Please consult the user’s guide for additional safety information and instructions for proper installation, operation, maintenance, and service of this unit.
  • Page 23: Service And Maintenance

    Opto 22 Product Support. Service (Product Support) If you are having problems installing or using groov EPIC products and cannot find the help you need in this guide or on our website, contact Opto 22 Product Support.
  • Page 24 SERVICE AND MAINTENANCE groov EPIC User’s Guide...
  • Page 25: Chapter 3: Assembling Your Groov Epic Unit

    • The groov EPIC power supply you selected for your project. • The groov EPIC chassis you selected for your project. Make sure you have the correct size chassis to hold the number of modules you are installing. • The groov I/O modules that you selected for your project.
  • Page 26: Verifying Serial Number On The Processor

    Each groov EPIC processor comes with an activation code, which helps you obtain your license file. Make a note of the serial number of your groov EPIC processor, which is on a label attached to the back of the LCD display.
  • Page 27: Assembling Your Unit

    CAUTION: For electrical safety, do not turn on the power supply. Make sure to de-energize field devices wired to the module terminal connectors before proceeding with these steps. Orient the groov EPIC chassis so that the module connector numbers are right-side up, with zero on the left, as shown in the diagram below.
  • Page 28 ASSEMBLING YOUR UNIT Install the processor: groov EPIC User’s Guide...
  • Page 29 CHAPTER 3: ASSEMBLING YOUR GROOV EPIC UNIT a. Lift the LCD display so you can see the notch on the processor. Notch b. Hold the processor by the left side, and make sure that the notch on the processor aligns with the guide tab on the power supply.
  • Page 30 Close the LCD display. Install the modules: a. Hold the module at a 45° angle, lining up the alignment tab on the back tip of the module with the slot at the back of the chassis. groov EPIC User’s Guide...
  • Page 31 CHAPTER 3: ASSEMBLING YOUR GROOV EPIC UNIT b. Pivot the front of the module down to the module connector on the chassis. Push to snap the module into the connector. c. Swing the module cover up so you can access the module hold-down screw. Secure the module into position by tightening the module hold-down screw.
  • Page 32: Connecting Power Supply Wires And Field Device Wires

    Hold-down screw CONNECTING POWER SUPPLY WIRES AND FIELD DEVICE WIRES After you complete the steps in this section, you will turn on you groov EPIC unit and move on to initializing the unit. Connecting field devices to the groov I/O modules Before you begin wiring, do the following tasks: •...
  • Page 33 CHAPTER 3: ASSEMBLING YOUR GROOV EPIC UNIT In this example, pin 3’s clamp release hole and corresponding field wiring hole are open. Terminal connector screw Pin numbers Field wiring holes Clamp release holes Follow these instructions to connect your field wires to the module:...
  • Page 34: Connecting Ground

    Some modules (for example, the GRV-OVMALC-8) provide their own isolated, regulated, field-side power supply. Power wiring guidelines Opto 22 recommends you follow these wiring guidelines: • Use a mains-isolated 24 to 48 VDC power source or supply to feed the GRV-EPIC-PSDC.
  • Page 35: Connecting The Ethernet Cable

    If the LCD display is closed, lift it so you can access the power switch. Flip the power switch and then close the LCD display. The LCD display shows you the progress of the processor’s start-up sequence. When you see the “Welcome!” screen, you are ready to initialize your groov EPIC unit. For important instructions about initializing your unit, see Chapter 4: Initializing the groov EPIC Processor.
  • Page 36 TURN ON UNIT AND CONTINUE WITH INITIALIZING THE UNIT groov EPIC User’s Guide...
  • Page 37: Chapter 4: Initializing The Groov Epic Processor

    4: Initializing the groov EPIC Processor After you assemble your groov EPIC unit and turn it on, the groov EPIC processor runs through its start-up sequence and then displays the Welcome! screen, shown below. Computer web browser groov EPIC touchscreen Before you click or tap on Let’s get started! (...
  • Page 38: Creating The First Administrator Account

    Pen and paper to note important information that you might need during this process or to keep for future reference. If this is the first time you navigate through a controller with a touchscreen or you are new to the groov EPIC processor, you might want to read through Chapter 5: Navigating Through the groov EPIC Processor become familiar with how to operate it and how it behaves.
  • Page 39: Choosing Between Quick Start And Configure Device

    Quick Start. The quick start provides a list of suggested configuration steps that you should complete first to get your groov EPIC system up and running. You may want to choose this option if this is the first time you configure a groov EPIC unit.
  • Page 40: Completing The Quick Start

    After you complete these initial configuration steps, you should check whether you have the latest firmware installed on your groov EPIC processor. If you do, you can continue on to more advanced configuration or begin to download and run a strategy or other control program.
  • Page 41: Chapter 5: Navigating Through The Groov Epic Processor

    CLICK OR TAP YOUR WAY AROUND groov MANAGE After you configure your groov EPIC processor with an IP address, you can connect to the processor through a web browser with that IP address. When you connect through a web browser, the processor displays the login...
  • Page 42: Learning The Screen Navigation Aids

    The diagram below shows some of the differences and similarities between pages when you look at them through the groov EPIC processor or a web browser (either on a computer or a mobile device). The diagram also identifies some of the important navigation aids, which are described on the following page:...
  • Page 43 In the groov EPIC touchscreen, you must tap on the arrow to navigate through that link. NAVIGATING THROUGH groov MANAGE At the top of the groov Manage page is a navigation bar that always remains visible as you navigate through the screens.
  • Page 44 While navigating through the screens on the groov EPIC processor touchscreen, in addition to tapping on buttons or other navigation aids, you can swipe your finger or stylus across the screen from left to right to return to a previous page.
  • Page 45 • Drag-and-drop—This is a feature commonly used on a computer to visually and easily move files from one location to another. You can drag-and-drop files into the groov EPIC processor on any groov Manage page with an upload button. •...
  • Page 46 To view information about and making changes to I/O modules and their channels is through the Modules page of groov Manage. To reach that page, log into your groov EPIC processor with a user ID that has administrator privileges and then do any of the following: •...
  • Page 47 CHAPTER 5: NAVIGATING THROUGH THE GROOV EPIC PROCESSOR You can click or tap on a black box to show current information about that module. For example, if you click or tap on module 3 ( ), the groov Manage displays the following page:...
  • Page 48 FINDING INFORMATION ABOUT I/O MODULES AND THEIR CHANNELS groov EPIC User’s Guide...
  • Page 49 PART OF AN OVERALL SECURITY SYSTEM When you control access to the groov EPIC processor, consider it as part of a total security system that includes other best practices you might want to implement; for example, requiring that authorized users change their passwords every three months or securing the control equipment in a locked cabinet with keys accessible to a limited number of personnel.
  • Page 50 (like groov Manage, groov View, and Node-RED) and web browsers on computers and mobile devices. When you connect to the groov EPIC processor through a web browser for the first time, the browser will display a warning message that the site (in this case, the groov EPIC processor) is untrusted.
  • Page 51 However, you might want to change the SSL security features on your groov EPIC processor for any of the following situations: •...
  • Page 52 If you have not created a self-signed certificate, do that first. See “Creating a Self-Signed Certificate” on page On a computer or mobile device, log into your groov EPIC processor with a user ID that has administrator privileges. Click Security.
  • Page 53 If you need to upload another certificate, repeat steps through 6. Changing SSL Security Features for Sparkplug If you are using Sparkplug with MQTT to publish data from the groov EPIC processor, you must first create and install a CA-signed Certificate on the processor. •...
  • Page 54 CONFIGURING THE FIREWALL After you installed the certificate(s): Log into your groov EPIC processor with a user ID that has administrator privileges. Click or tap Sparkplug. For each MQTT Broker that you have listed on the Sparkplug page and for which you want to enable SSL: a.
  • Page 55 Creating a Firewall Rule When you make changes to the groov EPIC processor’s firewall, the changes take effect immediately. So, make sure you schedule this change during a time that minimizes the impact to your system and users. If necessary, notify your users of this change so they can plan accordingly.
  • Page 56 – eth0, eth1, or wlan—Select which port this rule applies to by moving the slider to the right so that it shows green ( groov EPIC User’s Guide...
  • Page 57 CHAPTER 6: CONTROLLING ACCESS TO GROOV EPIC PROCESSOR Click or tap OK. If there are any errors in your selections groov Manage highlights the error and displays an error message. Fix the error or errors and then click OK. Repeat the previous two steps for any additional rules you want to create.
  • Page 58 Changing a Firewall Rule When you make changes to the groov EPIC processor’s firewall, the changes take effect immediately. So, make sure you schedule this change during a time that minimizes the impact to your system and users. If necessary, notify your users of this change so they can plan accordingly.
  • Page 59 CHAPTER 6: CONTROLLING ACCESS TO GROOV EPIC PROCESSOR Click or tap OK. If there are any errors in your changes, groov Manage highlights the error and displays an error message. Fix the error or errors and then click OK. Click or tap Save. groov Manage displays a message that it is configuring the firewall. If there are any conflicts with existing rules, groov Manage will highlight the row with the conflict and then you can change the rule to eliminate the conflict.
  • Page 60 CONFIGURING THE FIREWALL groov EPIC User’s Guide...
  • Page 61 The topic of networking can be complex. In this chapter, we cover the following scenarios: • Connecting the groov EPIC processor to a local area network, either wired or wireless. • Connecting the groov EPIC processor to a virtual private network (VPN).
  • Page 62 The groov EPIC processor is set up, by default, for you to plug an Ethernet cable into ETH0, turn on the processor, and it automatically connects to the network. This works best in a networking environment that is simple (for example, a computer and a few devices) and managed by a DHCP server.
  • Page 63 These examples illustrate why it is important to work with your IT department (if you have one) before connecting your groov EPIC processor to a complex network. Review the information in the rest of this section with your IT department. As you review the information, you’ll be collecting information that you’ll need when it’s time to configure the network interfaces.
  • Page 64 DHCP server to assign the IP address and subnet mask, but the IT administrator manually assigns the domain name server (DNS), you will need the IP address and domain name of that server when it’s time to configure the groov EPIC processor. Record this information “Table of Additional Gateways IP Addresses, DNS IP Addresses and Name Servers, and Order”...
  • Page 65 – SSID—A text string from 1 to 32 characters that uniquely identifies the wireless network. This should be the name of the wireless network access point you want the groov EPIC processor to join. – Encryption—The type of encryption to secure the packets: –...
  • Page 66 Advanced Networking Requirements” on page 50, that section described what information to collect and where to store in “Table of Additional Gateways IP Addresses, DNS IP Addresses and Name Servers, and Order” on the next page. groov EPIC User’s Guide...
  • Page 67 A public key, also known as a certificate, which is typically available as a file that ends in .crt – A private key that is created specifically for the groov EPIC processor. It is typically available as a file .key that ends in –...
  • Page 68 Some of this information can be provided in a configuration file, which you can then upload into the groov EPIC processor. Uploading a configuration file could make configuring the processor easier and you will be less likely to introduce typing errors. When you receive the configuration file, review it to make sure it has the following information (and in the format indicated), as appropriate for your OpenVPN server’s security and...
  • Page 69 CHAPTER 7: CONNECTING GROOV EPIC TO A NETWORK OR MULTIPLE NETWORKS CONFIGURING THE NETWORK INTERFACES Log into the groov EPIC processor with a user ID that has administrator privileges. Click or tap System. Click or tap Network. groov Manage displays the Network status page.
  • Page 70 If you selected Automatic and you don’t want to override the DHCP server settings for gateway, DNS address, and DNS name server, skip to step 5. Otherwise, now is when you enter those override values from “Table of Additional Gateways IP Addresses, DNS IP Addresses and Name Servers, and Order” page 53. groov EPIC User’s Guide...
  • Page 71 CHAPTER 7: CONNECTING GROOV EPIC TO A NETWORK OR MULTIPLE NETWORKS If you selected Manual, the Network configuration page changes to display additional fields. You’ll want to refer to the values you entered in “Table of Additional Gateways IP Addresses, DNS IP Addresses and Name Servers, and Order”...
  • Page 72 Verify that the OpenVPN server is reachable. Let’s begin: From a browser, connect to the groov EPIC processor and log into groov Manage with a user ID and password that has administrator privileges. If you will be entering the configuration manually (without a configuration file as described in “Collecting...
  • Page 73 CHAPTER 7: CONNECTING GROOV EPIC TO A NETWORK OR MULTIPLE NETWORKS Enter the configuration information you collected when you reviewed “Collecting Network Configuration Information for OpenVPN Connection” on page – If your VPN information is in a client configuration file, click Upload Configuration File. Navigate to the folder where you stored the configuration file, select it, then click Open.
  • Page 74 For enhanced security, disable any network interfaces you aren’t using. You may also want to update your security options and firewall settings: • “Managing the SSL Security Features of your groov EPIC Processor” on page 36 • “Configuring the Firewall” on page 40...
  • Page 75 One of the features of MQTT is that the data (payload) it transmits can be in a format best suited for the application. The groov EPIC processor can transmit payloads formatted to meet the Sparkplug specification or formatted as strings. In addition, the processor offers several features and capabilities to suit a variety of application requirements.
  • Page 76 Applications that need this option are typically SCADA or SCADA-like applications and critical applications. The Ignition Edge software is preloaded on the groov EPIC processor. You will also need either the GROOV-LIC-EDGE license (to use the Ignition Edge software) or a full Ignition license (to use the Ignition software).
  • Page 77 ConnTimeout (ms)—The default connection timeout value is 5000 milliseconds. You can adjust this value to account for slower or faster infrastructures. (For example, if your groov EPIC processor is in an area with “spotty” or slow connection, you may want to increase this value.) The minimum is 1000; the maximum is 30,000.
  • Page 78 CONFIGURING AND ENABLING MQTT WITH STRING PAYLOADS • Host TCP Port—This is the value of the groov EPIC processor's host TCP port. The default TCP port number is 22001. If you change this value, the new value must match the processor's host port.
  • Page 79 CONFIGURING AND ENABLING MQTT WITH SPARKPLUG PAYLOADS FROM GRV-EPIC-PR1 To connect your groov EPIC processor to an MQTT infrastructure, you will need to: • Create a new MQTT broker or establish access an existing one. The broker can be located on your premises or in the cloud.
  • Page 80 ConnTimeout (ms)—The default connection timeout value is 5000 milliseconds. You can adjust this value to account for slower or faster infrastructures. (For example, if your groov EPIC processor is in an area with “spotty” connection, you may want to increase this value.) The minimum is 1000; the maximum is 30,000.
  • Page 81 If the number of publications exceeds this value, the oldest entries are discarded to make room for newer entries. Configuring and Enabling MQTT Service Make sure you are logged into your groov EPIC processor with an ID with administrator privileges before starting: From the groov Manage Home page, click MQTT, then Configuration.
  • Page 82 CONFIGURING AND ENABLING MQTT WITH SPARKPLUG PAYLOADS (THROUGH IGNITION EDGE SOFTWARE) Ignition Edge software is preloaded onto your groov EPIC processor; you just need to enable it, and then configure it. If you are not familiar with Ignition Edge software, see “What is Ignition Edge?”...
  • Page 83 “What is MQTT?” on page Because Ignition Edge is included in the groov EPIC processor, you can use its tags (in your groov View operator interface, Node-RED flows, and MQTT with Sparkplug payload communications): •...
  • Page 84 Configuring the Ignition Edge System Gateway The Ignition Edge Gateway is a service that runs on the groov EPIC processor, in the background. You access it through a web browser (either through groov Manage or by entering a URL in the browser). The Gateway helps you connect to devices and databases, configure its settings (including options like security and authentication), and add Ignition Edge modules that add more capabilities to the Ignition Edge platform.
  • Page 85 Licensing Ignition Software The Ignition software on the groov EPIC processor runs for only two hours (trial mode), after which you will have to restart it. You can reset the trial as often as you wish. To run the software without the time restraint, you will need to purchase the correct license for the platform you selected in “Choosing Between Ignition or...
  • Page 86 CONFIGURING AND ENABLING MQTT WITH SPARKPLUG PAYLOADS (THROUGH IGNITION EDGE SOFTWARE) Obtaining License Keys To obtain an Ignition Edge License Key, you must purchase part number GROOV-LIC-EDGE from Opto 22. After you receive the License Key file, save it in a secure place and remember where you stored it.
  • Page 87 Deactivating the Ignition Edge license Before you update your groov EPIC processor or reset it to factory defaults, be sure to deactivate your Ignition Edge license. After the update or reset is finished, activate the license again. By deactivating and then reactivating, you avoid having to contact Ignition Edge to have the license reinstated.
  • Page 88 In the top right corner of the page, locate Sign Out. Click Sign Out. Then sign back in using your new username and password. Installing the OPC UA groov EPIC and SNAP PAC Driver If it’s not already open in a browser, open the Ignition Edge gateway page: https://[your groov EPIC’s hostname]:8043...
  • Page 89 CHAPTER 8: ENABLING MQTT In the left navigation, click Modules (under the System heading). Scroll down until you see the Opto 22 groov EPIC and SNAP PAC Driver module. Click Install. Confirm that you want to install the module. Review the Module License Agreement.
  • Page 90 CONFIGURING AND ENABLING MQTT WITH SPARKPLUG PAYLOADS (THROUGH IGNITION EDGE SOFTWARE) groov EPIC User’s Guide...
  • Page 91 118. After you restore your PAC Control strategy, if the strategy was communicating through an MQTT broker, you need to enable Sparkplug before you try running the strategy: Log into the groov EPIC processor with a user ID that has administrator authority. groov EPIC User’s Guide...
  • Page 92 • It is a good idea to select a couple of time servers to serve as backups in case the groov EPIC processor cannot establish a connection to the primary time server or if that time server becomes unavailable. The steps below instruct you to set two additional time servers.
  • Page 93 If you had set your date and time manually, setting the date and time as described in this section will overwrite your manual settings. Note: Changing the time manually will log out any users that are currently signed into your groov EPIC processor. Carefully choose when you will change the time to minimize any adverse affect on other users.
  • Page 94 CONNECTING SERIAL DEVICES There are two ways to connect serial devices: • Directly to the groov EPIC processor by inserting a USB-to-serial adapter into one of the USB ports on the groov EPIC processor • To the groov I/O unit by installing a groov serial module (GRV-CSERI-4 or GRV-CCANI-2)
  • Page 95 Device Name, Port Number, CAN Port Number, and CAN Port Name The groov EPIC processor assigns device names, port numbers, CAN port numbers, and CAN port names to channels on groov serial modules and USB ports with USB-to-serial adapters attached. You use these names and numbers in your control program to access the serial device.
  • Page 96 /dev/ttySer0.2 /dev/ttySer0.3 /dev/ttySer0.4 If you connect an 8-port USB hub to USB port 1 on the groov EPIC processor, then the processor assigns port numbers as follows: A USB hub connected to with a USB-to-serial adapter connected to port x...
  • Page 97 You can view a list of device names and port numbers of the USB-to-serial adapters plugged into USB ports and ports of GRV-CSERI-4 modules currently mounted on the chassis by doing the following: Log into your groov EPIC processor with a user ID that has administrator privileges. Click or tap the menu button ( Click or tap System >...
  • Page 98 If you are writing your own control programs, refer to your programming language’s reference for instructions on where to specify the device name. CONNECTING A MOUSE AND A KEYBOARD You can connect a mouse or a keyboard to the groov EPIC processor through the USB ports. groov EPIC User’s Guide...
  • Page 99 Manage screens because you won’t see a pointer that helps you aim accurately. These steps will require that you restart your groov EPIC processor’s display, which means you will be logged out and then you will have to log back in.
  • Page 100 EPIC touchscreen and start displaying on the external monitor. You will want a computer or mobile device with access to the groov EPIC nearby so you can change the orientation and resolution of the external monitor; these changes cannot be made through the external monitor.
  • Page 101 Portrait - Right vertically and groov Manage and your HMI are rotated 90° clockwise. The longest part of the screen is oriented Portrait - Left vertically and groov Manage and your HMI are rotated 90° counterclockwise. groov EPIC User’s Guide...
  • Page 102 CONNECTING A USB STORAGE DEVICE You can connect a USB storage device to either USB port on the groov EPIC processor, then use groov Manage on the processor’s touchscreen to copy files to and from the processor’s internal storage. Adding a USB storage device can increase the amount of storage available for your PAC Control strategy, CODESYS application, Node-RED flow, or custom control program to create, read, and write to files.
  • Page 103 USB storage devices do not utilize a power-fail safe file system. The groov EPIC processor supports reading and writing to USB storage devices formatted in either FAT or FAT32 file systems. This means that the largest partition that the groov EPIC processor can access is 32 GB. You can either: •...
  • Page 104 91) before pulling it out of a USB port. Mounting a USB Storage Device Log into your groov EPIC processor with a user ID that has administrator privileges. From the groov Manage Home page, click or tap System > USB.
  • Page 105 92.) Unmounting a USB Storage Device From a computer or mobile device, log into your groov EPIC processor with a user ID that has administrator privileges. From the groov Manage Home page, click or tap System > USB, then USB Files.
  • Page 106 90. You need to log into groov Manage from a computer or mobile device to copy, move, or download files. • Copy and move means to transfer a file from the USB storage device to the groov EPIC processor’s internal storage. •...
  • Page 107 INSTALLING AN APPROVED USB WIFI ADAPTER If you want to use the groov EPIC processor on a wireless network, you must purchase and install one of the following USB WiFi adapters that Opto 22 has tested and approved for use with GRV-EPIC-PR1. Unapproved WiFi adapters should not be used.
  • Page 108 UPLOADING FILES TO THE GROOV EPIC PROCESSOR UPLOADING FILES TO THE groov EPIC PROCESSOR The groov EPIC processor identifies files that you upload as “user files”. Before you upload files, you must decide whether they need to be uploaded as secured files: •...
  • Page 109 “Connecting Processor to Gateway and Entering the CODESYS Ticket ID” on page 97 In the CODESYS Development System, the gateway manages communication with many devices, including the groov EPIC processor. After you add the processor to the gateway, you’ll be able to enter the CODESYS ticket ID you obtained in step 1 above, which will install the license on to the processor.
  • Page 110 OBTAINING YOUR CODESYS ACTIVATION KEY CERTIFICATE AND TICKET ID You need to obtain an Activation Key Certificate from Opto 22 to help you get your CODESYS ticket ID. You’ll use the ticket ID when you do the steps in “Connecting Processor to Gateway and Entering the CODESYS...
  • Page 111 If these default settings work for your networking environment, you can move on to the next task. However, for the following situations, you’ll need to change the network settings on the groov EPIC processor: • The default settings don’t work for your networking environment •...
  • Page 112 CODESYS Development System automatically creates a license backup file (*.WibuCmRau), as described in Restoring licenses in the CODESYS Online Help. It would be a good idea to create a backup of your groov EPIC processor soon after completing these steps (see “Backing up Your groov EPIC Processor Settings”...
  • Page 113 Click or tap Disable. When the processor is done, the status will change to Disabled. After you disable the CODESYS Runtime Engine, the CODESYS Development System is disconnected from the groov EPIC processor. You will likely see a message like the following from the CODESYS Development System: Transferring the CODESYS License to Another GRV-EPIC-PR1 Transferring a CODESYS license requires contacting CODESYS product support for specific details.
  • Page 114 MANAGING CODESYS RUNTIME ENGINE AND CODESYS APPLICATIONS groov EPIC User’s Guide...
  • Page 115 This chapter does not explain how to design and build applications with the CODESYS Development System. (For this type of information, see the CODESYS Online Help at help.codesys.com.) When you are ready to download the application to the groov EPIC processor to run it and debug it, follow the instructions in “Downloading and Running CODESYS Applications”...
  • Page 116 IEC61131-3 programming language, then click OK. NOTE: If you see an error message about missing Opto 22 library files, in the Library Manager tab, click the Download Missing Libraries button and follow the on-screen instructions. After CODESYS Development System creates the project, you may want to change the standard name that CODESYS gives your device (which is “Device”) to something more helpful (for example, “Pump_Station_1”).
  • Page 117 If you are in the middle of a new project, go on to the next section. If you are creating a new project, double-check the version number to verify that you are using the recently installed version of the Opto 22 Library Package.
  • Page 118 CREATING NETWORK INTERFACES FOR THE groov EPIC DEVICE Click Add Device. CODESYS Development System adds an Ethernet branch to your groov EPIC processor’s branch. Click Close. In the Devices view, double-click Ethernet (Ethernet). Or if you added a preferred name, double-click the preferred name, for example, control_network (Ethernet).
  • Page 119 10. Click File > Save. Repeat these steps for each network interface you need to define. SETTING UP LOCAL I/O – ADDING groov EPIC TO THE DEVICE TREE In the Devices view, right-click Ethernet (Ethernet) or the preferred name for the interface, and select Add Device.
  • Page 120 Repeat the previous two steps for each module you want to add. CONFIGURING PROCESSOR PARAMETERS AND CHANNEL FEATURES After adding the groov EPIC processor and groov I/O modules to your project, you can configure the processor parameters and set channel features to meet the specific requirements of your application.
  • Page 121 CHAPTER 11: WORKING WITH GROOV EPIC DEVICES IN CODESYS PROJECTS Review all the parameters, paying particular attention to the following: – Address—Make sure the IP address or hostname of the GRV-EPIC-PR1 is correct in the Value column and surrounded by single quotes (‘).
  • Page 122 Configuring Channel Parameters If you haven’t started CODESYS Development System, start it and open your project. Open or select the Devices view, expand the Ethernet branch, then expand the branch of your groov EPIC processor. Double-click the module that contains the channel you want to configure. CODESYS Development System opens a module view for that module.
  • Page 123 CHAPTER 11: WORKING WITH GROOV EPIC DEVICES IN CODESYS PROJECTS – For channels with selectable input ranges/types: On the Channel Type row, double-click the Value cell to display the drop-down arrow. Click the arrow to display the list of available values. Each module will have a different list of values for Channel Type.
  • Page 124 To read or clear a latch or a state, you map a variable to the latch or state, then (in your application logic) program the variable to read or clear the latch or state. The following table lists the modules that offer latch or state. groov EPIC User’s Guide...
  • Page 125 CHAPTER 11: WORKING WITH GROOV EPIC DEVICES IN CODESYS PROJECTS Module Part Number Available Feature • GRV-IACDCTTL-24 • GRV-IDC-24 • On Latch • GRV-IAC-24 • GRV-IDCI-12 • Off Latch • GRV-IACHV-24 • GRV-IDCIFQ-12 • State • GRV-IACI-12 • GRV-IACIHV-12 Digital •...
  • Page 126 Mapping a Latch or State to a Variable If you haven’t started CODESYS Development System, start it and open your project. Open or select the Devices view, expand the Ethernet branch, then expand the branch of your groov EPIC processor.
  • Page 127 REFERENCING FILES STORED IN THE groov EPIC PROCESSOR You can upload files to the groov EPIC processor through groov Manage. If you want your CODESYS application to access these files, you must upload them to the unsecured area. (For details, see “Uploading Files to the...
  • Page 128 However, due to differences in how groov Manage and CODESYS Runtime Engine monitor and report information, the values you see in the CODESYS debugger won’t match what you see in groov Manage. For CODESYS applications, it’s more accurate to monitor this data from CODESYS, not from groov Manage. groov EPIC User’s Guide...
  • Page 129 12: Downloading and Running PAC Control Programs The groov EPIC processor can run flowchart programs built with PAC Control. These programs run on the PAC Control Engine. The PAC Control Engine and CODESYS Runtime Engine are mutually exclusive; that means that you can run one or the other, but not both.
  • Page 130 In the PAC Controller page, click or tap Disable. Read the warning message, then click OK. Wait a few seconds the processor to stop the Control Engine. When it is done, groov Manage changes the Control Engine page to show that the Control Engine was disabled. groov EPIC User’s Guide...
  • Page 131 Click or tap Serial Devices ( ). The Serial Devices page shows the devices attached to the groov EPIC processor. In the following example, the Serial Devices page shows that there is one serial device connected to USB port 1.
  • Page 132 If the CODESYS Runtime Engine is running when you enable the PAC Control Engine, the processor disables the CODESYS Runtime Engine and deletes any CODESYS applications on the processor. For more details about anything else that changes on the groov EPIC processor when you switch control engines, see “Switching Between PAC Control Engine and CODESYS Runtime Engine”...
  • Page 133 Linux OS. These programs can run independently of the PAC Control Engine or CODESYS Runtime Engine. If you develop custom programs, Opto 22 offers a variety of tools to help you access groov EPIC services and groov I/O modules. You can find information about these tools, as well as instructions to help you get started using them, at our developer web site, developer.opto22.com.
  • Page 134 Stopping the SSH Server To stop the SSH server, you must have the shell user ID and password. Log into the groov EPIC processor with a user ID that has administrator privileges. Click or tap the menu button ( ) and select System.
  • Page 135 Starting the SSH Server To start the SSH server, you must have the shell user ID and password. Log into the groov EPIC processor with a user ID that has administrator privileges. Click or tap the menu button ( ) and select System.
  • Page 136 EPIC User’s Guide...
  • Page 137 It is pre-installed on your groov EPIC processor Because Node-RED is integrated with the groov EPIC processor, you do not have to download and install it on a computer or embedded device. You can just log into your groov EPIC processor and start using Node-RED.
  • Page 138 The groov EPIC processor provides ways to backup and restore Node-RED projects, either separately or as part of the complete system backup and restore.
  • Page 139 In the Nodes palette on the left, locate the inject node. Click and hold on it, then drag it to the workspace. The inject node lets you inject messages into a flow, either by clicking the button on the node or by setting a time interval between injects. groov EPIC User’s Guide...
  • Page 140 The nodes exist only in the editor and must be deployed to the server. Click the Deploy button in the upper right. In the sidebar, select the debug tab. Click the button on the inject node. Numbers appear in the sidebar: groov EPIC User’s Guide...
  • Page 141 Delete on the keyboard. Add two new wires: one to link the output of the inject node to the input of the function node, the second wire to link the output of the function node to the input of the debug (msg.payload) node. groov EPIC User’s Guide...
  • Page 142 // Change the payload to be a formatted Date string msg.payload = date.toString(); Leave this code in place at the end: return msg; Click Done to close the edit dialog box and then click the Deploy button. groov EPIC User’s Guide...
  • Page 143 Now when you click the Inject button, the message in the sidebar shows a more readable time stamp: Installing groov View nodes Your groov EPIC processor must have access to the Internet to install groov View nodes. Click the menu button ( ), then select Manage palette.
  • Page 144 For either of these options, you need to complete the configuration instructions on developer.opto22.com. At the website, click on Node-RED for PAC Control, then expand Getting Started. For the groov EPIC processor, click on groov EPIC Controller Configuration; for the SNAP PAC controller, click SNAP PAC Controller configuration.
  • Page 145 For PAC Address, choose a protocol (HTTPS is strongly recommended because it is secure) and enter the IP address of the groov EPIC processor or the SNAP PAC controller. b. If you are configuring a SNAP PAC Controller, enter the API Key ID and Value. If you are configuring a a groov EPIC processor, leave this field blank.
  • Page 146 The Node-RED editor returns you to the Edit pac read node panel, where your node is now configured to access the I/O and variable data in the PAC Control strategy running on the groov EPIC processor or the SNAP PAC controller: Choose the Data Type from the dropdown list.
  • Page 147 Deploy button. In this example, everything is deployed (Full). 11. Click Deploy. Now click the inject button and see what message appears in the debug tab. You should see the data from your PAC Control strategy. Here’s how our example looks: groov EPIC User’s Guide...
  • Page 148 CREATING YOUR FIRST Node-RED FLOW groov EPIC User’s Guide...
  • Page 149 Assign names to channels, enable or disable quality indicators, and select features (on some modules) that a channel measures CHECKING THE HEALTH (STATUS) OF A MODULE groov EPIC offers two ways to quickly monitor the status of a module: • Through the module LED on the cover of a module •...
  • Page 150 CODESYS Development System, not through groov Manage. To view the status of modules mounted on the chassis: On a computer or mobile device, log into your groov EPIC processor with a user ID that has administrator privileges. In the Home page, click I/O ( ).
  • Page 151 “Backing up Your groov EPIC Processor Settings” on page 145. To configure an I/O channel on a module: Log into your groov EPIC processor with a user ID that has administrator privileges. Click or tap the menu button ( ), then select I/O.
  • Page 152 Click or tap on the channel you want to configure. groov Manage displays a channel page. The information on the page depends on the module type. The following diagram shows several examples: GRV-IACI-12 module GRV-OMRIS-8 module GRV-ODCI-12 module groov EPIC User’s Guide...
  • Page 153 141. – Feature–This is for modules with full feature sets. Simple modules don’t have this. When you click on None (or a feature name, if shown), groov Manage displays a list of features that this particular groov EPIC User’s Guide...
  • Page 154 Off-Pulse. Click Save. groov Manage refreshes the channel page with any changes we made. In the previous example, we selected the Off-Pulse feature. The follow diagram shows how groov Manage added Off-Pulse to the channel page. groov EPIC User’s Guide...
  • Page 155 Current outputs: open circuit; Voltage outputs: over-current GRV-OVMAILP-8 Current outputs: open circuit; Voltage outputs: none There are a few ways that the groov EPIC system shows you that there is a quality error: • The module LED changes color to yellow.
  • Page 156 UNDERSTANDING HOW QUALITY ERRORS ARE REPORTED Viewing Information About a Quality Error Log into your groov EPIC processor with a user ID that has administrator privileges. Click or tap the menu button ( ), then select I/O. groov Manage shows the Modules page.
  • Page 157 Manage displays the specific information about that channel: The Quality field shows you a message with an error code number and a possible reason for the error. This information can help you troubleshoot problems with a field device wired to that specific channel. groov EPIC User’s Guide...
  • Page 158 UNDERSTANDING HOW QUALITY ERRORS ARE REPORTED groov EPIC User’s Guide...
  • Page 159 The backup file is not a secured or encrypted file. You must apply your own security or encryption to the file to protect any sensitive information. Also, be aware that if you send a backup file to Opto 22 without any security or encryption, our personnel will have access to all the information in that file.
  • Page 160 After you select a back up folder or media, do the following steps: On a computer or mobile device that is connected to the media or folder where you want to save your back up file, log into your groov EPIC processor with a user ID that has administrator privileges. Click Maintenance.
  • Page 161 Backing up Your Ignition Edge Projects It’s important to back up your Ignition Edge projects before you apply maintenance or reset your groov EPIC processor to factory defaults. It’s a good idea to back up your Ignition Edge projects at the same time you back up your groov EPIC processor and save the backup file to the same location.
  • Page 162 So, make sure you know the user ID and password of any administrator account saved in the backup file so you can use that ID and password when you log into the groov EPIC processor. To restore a backup file or specific part of a backup file: Locate the media or folder that contains the backup file and remove any security you may have applied to the file.
  • Page 163 Click Upload Backup. Navigate to the folder or media device that contains your backup file. Click Open. groov Manage displays the following message, reminding you of what the groov EPIC processor will do during the restore: Click Restore and Restart. groov Manage displays a message that shows you the progress of the restore: 10.
  • Page 164 11. groov Manage shows you a message that gives you a few tips about what you might need to do next. Read the message and then click Close. 12. The groov EPIC processor restarts. Wait for the groov EPIC login screen and log back in with any user ID that has administrator authority and was stored in the backup file.
  • Page 165 UPDATING FIRMWARE ON A groov EPIC UNIT Updating firmware on a groov EPIC unit keeps it up-to-date with the latest features and fixes. You can update firmware on the processor or on the groov I/O modules. Updating firmware on a processor can take 10 minutes or more to complete and your groov EPIC processor will be restarted, so schedule the update during a time when it minimizes impact to your control program and equipment.
  • Page 166 EPIC processor. On a computer or mobile device, log into your groov EPIC processor with a user ID that has administrator privileges.
  • Page 167 CHAPTER 16: MAINTAINING YOUR GROOV EPIC UNIT 14. groov Manage displays an Update message, which shows you the progress of the update. The update can take several minutes to complete. During that time, the banner (in the background) will change color to yellow.
  • Page 168 UPDATING FIRMWARE ON A GROOV EPIC UNIT 16. groov Manage displays a message with instructions on what to do after the device restarts. Read the instructions and then click Close. The groov EPIC processor touchscreen displays the progress of the restart.
  • Page 169 Engine” on page – When you restore the groov EPIC processor’s backup file, make sure you select License as one of the options on the Restore page to restore the CODESYS license file. 22. Restore your backup file as described in “Restoring a Backup or Specific Settings from a Backup File”...
  • Page 170 If the file has a file type of .zip, decompress the file with a decompression utility on your mobile device or computer before going to the next step. On that same computer or mobile device, log into your groov EPIC processor with a user ID that has administrator privileges.
  • Page 171 CHAPTER 16: MAINTAINING YOUR GROOV EPIC UNIT If you are ready to proceed, click OK. groov Manage displays a message showing you the progress of the update: 13. When the update is complete, groov Manage shows you the module page and you can see that the...
  • Page 172 REPLACING THE BATTERY On the top of the groov EPIC processor, unscrew the captive screw until the battery holder extends out enough to slip a flathead screwdriver in the opening. With the flathead screwdriver, pull out the battery holder until you can grasp it with your fingers to completely pull it out.
  • Page 173 You might have to reset to factory defaults if instructed to do so by product support. A reset to factory defaults erases all the changes you made to the groov EPIC system, which is why it is important that you perform the following, if possible: •...
  • Page 174 (capture) the screens. If Product Support directs you to send log files, do the following steps: On a computer or mobile device, log into the groov EPIC processor with a user ID that has administrator privileges.
  • Page 175 OptoSupport RSS page: After the connection is established, you will see this message on the OptoSupport RSS page: Do not turn off your groov EPIC processor after you start the session. If this happens, you will need to start this process over.
  • Page 176 When it’s time to end the RSS session, click Delete RSC in the OptoSupport RSS page (Info and Help > OptoSupport RSS). All of the information that your groov EPIC processor created to establish the connection will be erased. If you need to start another RSS session, you’ll need to start from the first step in “Initiating an...
  • Page 177 17: Troubleshooting CANNOT CONNECT TO THE SSH SERVER Verify that you purchased and installed the groov EPIC SSH Access license to enable the SSH server. Log into your groov EPIC processor with a user ID that has administrator privileges. Click or tap System ( Click or tap License ( ).
  • Page 178 ). Look underneath the SSH Server field for the IP address and port number for shell access: ONE OF THE MODULES IS BLINKING RED This usually indicates that the module is trying to establish communication with the groov EPIC processor. For more information, see “Checking Module Status Through the Module LED” on page 136.
  • Page 179 • Check that the IP address is correct in the address or URL bar. • Verify that your computer or mobile device is connected to the same network as your groov EPIC processor. • On the processor, check the IP address and verify that it matches what you typed in the address or URL bar.
  • Page 180 You may see this message from CODESYS Development System when you are trying to connect (Online > Login) to the groov EPIC processor or it may appear as you are debugging your application: This could be caused by several different reasons: •...
  • Page 181 Troubleshooting networking issues can be a complex job, though it can be made simpler with the right tools. The groov EPIC processor provides a few tools to help you diagnose networking issues. You can access all of these tool by clicking or tapping (from the groov Manage Home page) System > Network > Diagnostics.
  • Page 182 The Traceroute tool can help you see the route a packet takes to reach its destination. The following example shows the route a packet took to reach the destination, www.example.com. NsLookup The NsLookup tool can help you determine the domain name and IP address of a DNS server at the host. groov EPIC User’s Guide...
  • Page 183 CHAPTER 17: TROUBLESHOOTING groov EPIC User’s Guide...
  • Page 184 TROUBLESHOOTING NETWORK ISSUES groov EPIC User’s Guide...
  • Page 185 The Edge Programmable Industrial Controller is an embedded Linux®, real-time controller with gateway functions. The modern design of the groov EPIC processor offers a condensed and sturdy unit that features a resistive-touch, high-resolution LCD display. The LCD display lifts to provide easy access to the power button, power supply connectors, network interfaces, ports, and status LEDs.
  • Page 186 -20 °C to +70 °C Storage temperature -40 °C to +85 °C Relative Humidity (non-condensing) 5–95% Agency approvals and certifications UL/cUL (Class 1 Div. 2); CE, ATEX (Category 3, Zone 2), RoHS; DFARS Warranty 30 months groov EPIC User’s Guide...
  • Page 187 GRV-EPIC-PSAC, GRV-EPIC-PSDC, GRV-EPIC-PSPT The GRV-EPIC-PSAC power supply and the GRV-EPIC-PSDC voltage converter are designed to provide power for a groov EPIC chassis with a GRV-EPIC-PR1 processor, and groov® I/O modules mounted on the chassis. The GRV-EPIC-PSPT pass-through power adapter is designed to allow you to connect a user-supplied, external 12 V power supply to the I/O unit.
  • Page 188 GRV-EPIC-PSAC, GRV-EPIC-PSDC, GRV-EPIC-PSPT groov EPIC User’s Guide...
  • Page 189 C: Chassis specifications GRV-EPIC-CHS0, GRV-EPIC-CHS4, GRV-EPIC-CHS8, GRV-EPIC-CHS16 groov EPIC I/O mounting chassis are designed to hold an intelligent groov EPIC processor, power supply, and several I/O modules. The GRV-EPIC-CHS0 is designed to hold only the processor and the power supply, making it ideal where no I/O is needed and cabinet space is at a premium.
  • Page 190 GRV-EPIC-CHS0, GRV-EPIC-CHS4, GRV-EPIC-CHS8, GRV-EPIC-CHS16 groov EPIC User’s Guide...
  • Page 191: Grv-Cseri-4

    Channel 3 RS-232 Tx / Rx RS-232 RTS / CTS RS-232 DCD, DTR, DSR, RI RS-485 half-duplex mode (TxRx+/-) RS-485 full-duplex Mode (Tx+/-, Rx+/-) RS-485 termination (120 Ohms) RS-485 Bias (750 Ohms to +V and COM) groov EPIC User’s Guide...
  • Page 192: Specifications

    The GRV-IACI-12 modules each have channel-to-channel isolation. They can sense status from up to 12 devices. • The GRV-IACS-24 and GRV-IACIS-12 modules provide input state only, offering a lower cost option for projects with simple requirements. groov EPIC User’s Guide...
  • Page 193: Features

    -40 °C to +85 °C -40 °C to +85 °C Relative Humidity (non-condensing) 5–95% 5–95% 5–95% 5–95% Agency Approvals UL/cUL(Class 1 Div. 2); CE, ATEX(Category 3, Zone 2); RoHS; DFARS; CB Scheme Warranty Lifetime Lifetime Lifetime Lifetime groov EPIC User’s Guide...
  • Page 194: Grv-Iacdcttl-24, Grv-Iacdcttls-24

    The GRV-IACDCTTLS-24 module provides input state only, offering a lower cost option for projects that require only point states. Features Feature GRV-IACDCTTL-24 GRV-IACDCTTLS-24 Number of channels On/off state On/off latching Counting On/off totalization Frequency measurement Period measurement Pulse measurement groov EPIC User’s Guide...
  • Page 195: Specifications

    • The GRV-IACIHV-12 module provides 12 channels per module, with channel-to-channel isolation. • The GRV-IACHVS-24 and the GRV-IACIHVS-12 modules provide input state only, offering a lower cost option for projects that require only on/off status. groov EPIC User’s Guide...
  • Page 196: Features

    -40 °C to +85 °C -40 °C to +85 °C Relative Humidity (non-condensing) 5–95% 5–95% 5–95% 5–95% Agency Approvals UL/cUL (Class 1 Div. 2); CE, ATEX(Category 3, Zone 2), RoHS; DFARS; CB Scheme Warranty Lifetime Lifetime Lifetime Lifetime groov EPIC User’s Guide...
  • Page 197: Grv-Idc-24, Grv-Idci-12, Grv-Idcs-24, Grv-Idcsw-12, Grv-Idcis-12, Grv-Idcifq-12

    Features Feature GRV-IDC-24 GRV-IDCS-24 GRV-IDCSW-12 GRV-IDCI-12 GRV-IDCIS-12 GRV-IDCIFQ-12 Number of channels Channel-to-channel isolation On/off state On/off latching Counting On/off totalization Frequency measurement Period measurement Pulse measurement Quadrature groov EPIC User’s Guide...
  • Page 198: Specifications For Grv-Idc-24, Grv-Idci-12, Grv-Idcs-24, Grv-Idcis-12, Grv-Idcifq-12

    5–95% Agency Approvals UL/cUL(Class 1 Div. 2); CE, ATEX(Category 3, Zone 2), RoHS; DFARS; CB Scheme Warranty Lifetime Lifetime Lifetime Lifetime Lifetime Note 1: IEC inputs have non-linear impedance. See the tables for typical V-I curves. groov EPIC User’s Guide...
  • Page 199 APPENDIX D: I/O MODULE SPECIFICATIONS groov EPIC User’s Guide...
  • Page 200: Specifications For Grv-Idcsw-12

    3.5 in-lb (0.4 N-m) Temperature (operating) -20 °C to +70 °C Temperature (storage) -40 °C to +85 °C Relative Humidity (non-condensing) 5–95% Agency Approvals UL/cUL(Class 1 Div. 2); CE, ATEX(Category 3, Zone 2), RoHS; DFARS; CB Scheme Warranty Lifetime groov EPIC User’s Guide...
  • Page 201: Grv-Iictd-12

    The GRV-IICTD-12 module collects temperature input data from any industry-standard Integrated Circuit Temperature Device (ICTD). The module has 12 channels of input. Features Features GRV-IICTD-12 Scaling Offset and Gain Minimum/Maximum Values Average Filter Weight Simple Moving Average Analog Totalizing Problem Indication groov EPIC User’s Guide...
  • Page 202: Specifications

    3.5 in-lb (0.4 N-m) Temperature (operating) -20 °C to +70 °C Temperature (storage) -40 °C to +85 °C Relative Humidity (non-condensing) 5–95% Agency Approvals UL/cUL(Class 1 Div. 2); CE, ATEX(Category 3, Zone 2), RoHS; DFARS; CB Scheme Warranty Lifetime groov EPIC User’s Guide...
  • Page 203: Grv-Ima-24, Grv-Imai-8

    The GRV-IMAI-8 module provides channel-to-channel isolation on its 8 channels of analog current input with an input range of 0 to 20 mA and 4 to 20 mA. Features Features GRV-IMA-24 GRV-IMAI-8 Scaling Offset and Gain Minimum/Maximum Values Average Filter Weight Simple Moving Average Analog Totalizing Problem indication groov EPIC User’s Guide...
  • Page 204: Specifications

    -20 °C to +70 °C Temperature (storage) -40 °C to +85 °C -40 °C to +85 °C Relative Humidity (non-condensing) 5–95% 5–95% Agency Approvals UL/cUL(Class 1 Div. 2); CE, ATEX(Category 3, Zone 2), RoHS; DFARS; CB Scheme Warranty Lifetime Lifetime groov EPIC User’s Guide...
  • Page 205: Grv-Itm-12, Grv-Itmi-8

    ±75 mV, ±50 mV, ±25 mV or Type B, E, J, K, N, R, S, or T thermocouples. Features Features GRV-ITM-12 GRV-ITMI-8 Scaling Offset and Gain Minimum/Maximum Values Average Filter Weight Simple Moving Average Analog Totalizing Problem indication groov EPIC User’s Guide...
  • Page 206: Specifications

    3.5 in-lb (0.4 N-m) 3.5 in-lb (0.4 N-m) Temperature (operating) -20 °C to +70 °C -20 °C to +70 °C Temperature (storage) -40 °C to +85 °C -40 °C to +85 °C Humidity (non-condensing) 5–95% RH 5–95% RH groov EPIC User’s Guide...
  • Page 207: Grv-Itr-12, Grv-Irtd-8

    It may also be used with PTC thermistors in resistance sensing applications. Features Features GRV-IRTD-8 GRV-ITR-12 Scaling Offset and Gain Minimum/Maximum Values Average Filter Weight Simple Moving Average (SMA) Analog Totalizing Problem indication groov EPIC User’s Guide...
  • Page 208: Specifications For Grv-Itr-12

    3.5 in-lb (0.4 N-m) Temperature (operating) -20 °C to +70 °C Temperature (storage) -40 °C to +85 °C Humidity (non-condensing) 5-95% RH Agency Approvals UL/cUL(Class 1 Div. 2), CE, ATEX(Category 3, Zone 2), RoHS, DFARS Warranty Lifetime groov EPIC User’s Guide...
  • Page 209: Specifications For Grv-Irtd-8

    The sum of the resistance in both lead wires cannot exceed this value. For example: a 24 AWG wire would need to be longer than 4,000 feet (or 1.2 kilome- ters), in each lead, to exceed 200 Ohms. groov EPIC User’s Guide...
  • Page 210: Grv-Iv-24, Grv-Ivi-12

    For more details about other differences, see the specification table on the next page. Features Features GRV-IV-24 GRV-IVI-12 Scaling Offset and Gain Minimum/Maximum Values Average Filter Weight Simple Moving Average Analog Totalizing Problem indication groov EPIC User’s Guide...
  • Page 211: Specifications

    -20 °C to +70 °C Temperature (storage) -40 °C to +85 °C -40 °C to +85 °C Relative Humidity 5–95% 5–95% (non-condensing) Agency Approvals UL/cUL(Class 1 Div. 2); CE, ATEX(Category 3, Zone 2), RoHS; DFARS; CB Scheme Warranty Lifetime Lifetime groov EPIC User’s Guide...
  • Page 212: Grv-Oac-12, Grv-Oaci-12, Grv-Oacs-12, Grv-Oacis-12

    The 12 channels in these modules do not share any field signal connection inside the module. • The GRV-OACS-12 and GRV-OACIS-12 modules switch output on or off only, offering a lower cost option for projects with simple requirements. groov EPIC User’s Guide...
  • Page 213: Specifications

    -40 °C to +85 °C -40 °C to +85 °C Relative Humidity (non-condensing) 5–95% 5–95% 5–95% 5–95% Agency Approvals UL/cUL(Class 1 Div. 2); CE, ATEX(Category 3, Zone 2), RoHS; DFARS; CB Scheme Warranty Lifetime Lifetime Lifetime Lifetime groov EPIC User’s Guide...
  • Page 214: Grv-Odci-12, Grv-Odcis-12

    The GRV-ODCIS-12 switches output on or off only, offering a lower cost option for projects with simple requirements. Features Feature GRV-ODCI-12 GRV-ODCIS-12 Number of channels Channel-to-channel isolation On/off state On/off totalization Output pulsing Watchdog Timeout Value groov EPIC User’s Guide...
  • Page 215: Specifications

    -20 °C to +70 °C Temperature (storage) -40 °C to +85 °C -40 °C to +85 °C Relative Humidity (non-condensing) 5–95% 5–95% Agency Approvals UL/cUL(Class 1 Div. 2); CE, ATEX(Category 3, Zone 2), RoHS; DFARS; CB Scheme Warranty Lifetime Lifetime groov EPIC User’s Guide...
  • Page 216: Grv-Odcsrc-24

    3.5 in-lb (0.4 N-m) Temperature (operating) -20 °C to +70 °C Temperature (storage) -40 °C to +85 °C Relative Humidity (non-condensing) 5–95% UL/cUL(Class 1 Div. 2); CE, ATEX(Category 3, Zone 2), Agency Approvals RoHS; DFARS; CB Scheme Warranty Lifetime groov EPIC User’s Guide...
  • Page 217: Grv-Omris-8

    Temperature (storage) -40 °C to +85 °C Shock (misoperation) Shock (survival) 100 G Relative Humidity (non-condensing) 5–95% Agency Approvals UL/cUL (Class 1 Div. 2); CE, ATEX (Category 3, Zone 2), RoHS; DFARS; CB Scheme Warranty 30 months groov EPIC User’s Guide...
  • Page 218: Grv-Ovmalc-8

    3.5 in-lb (0.4 N-m) Temperature (operating) -20 °C to +70 °C Temperature (storage) -40 °C to +85 °C Relative Humidity (non-condensing) 5–95% UL/cUL(Class 1 Div. 2); CE, ATEX(Category 3, Zone 2), RoHS; Agency Approvals DFARS; CB Scheme Warranty Lifetime groov EPIC User’s Guide...
  • Page 219: Appendix E: I/O Module Wiring Diagrams

    Appendix E E: I/O module wiring diagrams GRV-CCANI-2 PINOUT AND WIRING DIAGRAM groov EPIC User’s Guide...
  • Page 220: Grv-Cseri-4 Pinout And Wiring Diagram

    GRV-CSERI-4 PINOUT AND WIRING DIAGRAM GRV-CSERI-4 PINOUT AND WIRING DIAGRAM groov EPIC User’s Guide...
  • Page 221: Grv-Iac-24, Grv-Iacs-24 Pinout And Wiring Diagram

    APPENDIX E: I/O MODULE WIRING DIAGRAMS GRV-IAC-24, GRV-IACS-24 PINOUT AND WIRING DIAGRAM groov EPIC User’s Guide...
  • Page 222: Grv-Iaci-12, Grv-Iacis-12 Pinout And Wiring Diagram

    GRV-IACI-12, GRV-IACIS-12 PINOUT AND WIRING DIAGRAM GRV-IACI-12, GRV-IACIS-12 PINOUT AND WIRING DIAGRAM groov EPIC User’s Guide...
  • Page 223 APPENDIX E: I/O MODULE WIRING DIAGRAMS GRV-IACDCTTL-24, GRV-IACDCTTLS-24 PINOUT AND WIRING DIAGRAM groov EPIC User’s Guide...
  • Page 224 GRV-IACHV-24, GRV-IACHVS-24 PINOUT AND WIRING DIAGRAM GRV-IACHV-24, GRV-IACHVS-24 PINOUT AND WIRING DIAGRAM groov EPIC User’s Guide...
  • Page 225 APPENDIX E: I/O MODULE WIRING DIAGRAMS GRV-IACIHV-12, GRV-IACIHVS-12 PINOUT AND WIRING DIAGRAM groov EPIC User’s Guide...
  • Page 226 GRV-IDC-24, GRV-IDCS-24 PINOUT AND WIRING DIAGRAM GRV-IDC-24, GRV-IDCS-24 PINOUT AND WIRING DIAGRAM groov EPIC User’s Guide...
  • Page 227 APPENDIX E: I/O MODULE WIRING DIAGRAMS GRV-IDCSW-12 PINOUT AND WIRING DIAGRAM groov EPIC User’s Guide...
  • Page 228 GRV-IDCI-12, GRV-IDCIS-12 PINOUT AND WIRING DIAGRAM GRV-IDCI-12, GRV-IDCIS-12 PINOUT AND WIRING DIAGRAM groov EPIC User’s Guide...
  • Page 229 APPENDIX E: I/O MODULE WIRING DIAGRAMS GRV-IDCIFQ-12 PINOUT AND WIRING DIAGRAM Wiring to Quadrature Encoders groov EPIC User’s Guide...
  • Page 230 GRV-IDCIFQ-12 PINOUT AND WIRING DIAGRAM Wiring to Typical (Signal) Sources groov EPIC User’s Guide...
  • Page 231 APPENDIX E: I/O MODULE WIRING DIAGRAMS GRV-IICTD-12 PINOUT AND WIRING DIAGRAM groov EPIC User’s Guide...
  • Page 232 GRV-IMA-24 PINOUT AND WIRING DIAGRAM GRV-IMA-24 PINOUT AND WIRING DIAGRAM groov EPIC User’s Guide...
  • Page 233 APPENDIX E: I/O MODULE WIRING DIAGRAMS GRV-IMAI-8 PINOUT AND WIRING DIAGRAM groov EPIC User’s Guide...
  • Page 234 GRV-IRTD-8 PINOUT AND WIRING DIAGRAM GRV-IRTD-8 PINOUT AND WIRING DIAGRAM groov EPIC User’s Guide...
  • Page 235 APPENDIX E: I/O MODULE WIRING DIAGRAMS GRV-ITM-12 PINOUT AND WIRING DIAGRAM groov EPIC User’s Guide...
  • Page 236 GRV-ITMI-8 PINOUT AND WIRING DIAGRAM GRV-ITMI-8 PINOUT AND WIRING DIAGRAM groov EPIC User’s Guide...
  • Page 237 APPENDIX E: I/O MODULE WIRING DIAGRAMS GRV-ITR-12 PINOUT AND WIRING DIAGRAM groov EPIC User’s Guide...
  • Page 238 GRV-IV-24 PINOUT AND WIRING DIAGRAM GRV-IV-24 PINOUT AND WIRING DIAGRAM groov EPIC User’s Guide...
  • Page 239 APPENDIX E: I/O MODULE WIRING DIAGRAMS GRV-IVI-12 PINOUT AND WIRING DIAGRAM groov EPIC User’s Guide...
  • Page 240 Please see the specification table and wiring diagram for recommended operating currents and placement. Opto 22 strongly recommends the use of an appropriately rated and listed device. Failure to provide protection will void the product warranty. groov EPIC User’s Guide...
  • Page 241 APPENDIX E: I/O MODULE WIRING DIAGRAMS GRV-OACI-12, GRV-OACIS-12 PINOUT AND WIRING DIAGRAM groov EPIC User’s Guide...
  • Page 242 GRV-ODCI-12, GRV-ODCIS-12 PINOUT AND WIRING DIAGRAM GRV-ODCI-12, GRV-ODCIS-12 PINOUT AND WIRING DIAGRAM groov EPIC User’s Guide...
  • Page 243 APPENDIX E: I/O MODULE WIRING DIAGRAMS GRV-ODCSRC-24 PINOUT AND WIRING DIAGRAM groov EPIC User’s Guide...
  • Page 244 GRV-OMRIS-8 PINOUT AND WIRING DIAGRAM GRV-OMRIS-8 PINOUT AND WIRING DIAGRAM groov EPIC User’s Guide...
  • Page 245 APPENDIX E: I/O MODULE WIRING DIAGRAMS GRV-OVMAILP-8 PINOUT AND WIRING DIAGRAM groov EPIC User’s Guide...
  • Page 246 GRV-OVMALC-8 PINOUT AND WIRING DIAGRAM GRV-OVMALC-8 PINOUT AND WIRING DIAGRAM groov EPIC User’s Guide...
  • Page 247 Ignition Edge. The Ignition Edge software required the purchase and installation of the groov Enterprise license (part number GROOV-LIC-ENT). If you are working with a groov EPIC processor with older module firmware and you need to reload or re-obtain a copy of the license it came with, see “Activating the groov EPIC unit and downloading the license...
  • Page 248 GROOV-LIC-EDGE. After you receive your Ignition Edge License Key or CODESY Ticket Number, do the following: – “Installing (Activating) the Ignition Edge License” on page 72 – “Licensing the CODESYS Runtime Engine” on page 67 groov EPIC User’s Guide...
  • Page 249 REDIRECTING TRAFFIC INITIATED BY AN INCOMING CONNECTION REQUEST Each network interface on the groov EPIC processor can be assigned a gateway address. Normally, a DHCP server manages the assignment of gateway IP addresses to the network interfaces. Prior to version 1.4.0 of the groov EPIC firmware, the groov EPIC processor would select the gateway of the active network interface and make it the effective gateway, the gateway that directs traffic.
  • Page 250 Outbound Traffic Not Initiated by an Incoming Connection Request If the groov EPIC processor initiates a communication request (called an outgoing connection request), traffic travels through the gateway with the lowest order number (the effective gateway). However, if the outbound traffic specifies a source address or the IP address of the network interface (which is not a common situation), then the second or third gateway in the list order may be used.

Table of Contents