1. Manuals
  2. Brands
  3. OPTO 22 Manuals
  4. Controller
  5. GROOV BOX
  6. User manual

OPTO 22 GROOV BOX User Manual

Hide thumbs
Table of Contents

Advertisement

Quick Links

Download this manual
Form 2077
GROOV BOX
USER'S GUIDE FOR
GROOV-AT1

Advertisement

Table of Contents
loading
Need help?

Need help?

Do you have a question about the GROOV BOX and is the answer not in the manual?

Questions and answers

Subscribe to Our Youtube Channel

Related Manuals for OPTO 22 GROOV BOX

Summary of Contents for OPTO 22 GROOV BOX

  • Page 1 Form 2077 GROOV BOX USER’S GUIDE FOR GROOV-AT1...
  • Page 2 GROOV BOX USER’S GUIDE FOR GROOV-AT1 Form 2077-160331—March 2016 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...
  • Page 3 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 4: Table Of Contents

    Step 7: Activate the groov Box and Get the License File ......
  • Page 5 Step 3: Install the CA-Signed Certificate on groov Box ....... .
  • Page 6 Cannot log into the groov Box using the hostname ....... .
  • Page 7 Box User’s Guide for GROOV AT1...

  • Page 8: Chapter 1: Welcome

    1: Chapter 1 1: Welcome groov is Opto 22’s web-based operator interface system that is simple, mobile, and connects easily to almost any automation system or device. Simple: groov requires only a web browser to build mobile interfaces. It puts ready-made gadgets at your fingertips and requires no programming.

  • Page 9: Choose Your Groov

    OPC DA servers, or any device or system supported by your OPC UA server. The KEPServerEX communication platform from Kepware Technolgies is recommended by Opto 22 and tested to work with groov. (For more information about OPC UA, go to opcfoundation.org/UA.)

  • Page 10: About This Guide

    CHAPTER 1: WELCOME Whether you store and serve groov software on a groov Box or on a computer using groov Server for Windows, an operator interface you develop with groov can be viewed on almost any mobile device or computer.

  • Page 11: Groov Box Communications

    With two independent wired Ethernet network interfaces plus an independent wireless interface, the unit gives you the flexibility to monitor devices in hard-to-reach areas and to set up networking suited to your business. Wireless antenna Ethernet connectors groov Box User’s Guide for GROOV AT1...

  • Page 12: System Architecture

    When you first set up groov, the PC you use must reside on the same network (broadcast domain) as the groov Box. In a quick and easy setup, the development PC and smartphone or tablet running View all reside within the same domain as groov. The controller can also be on the same network, or it can be on a separate control network as shown here.

  • Page 13: What's In This Guide

    Appendix B: Connectors, Indicators, and LEDs describes connector names and what the status and activity LEDs mean. Product Support If you have any questions about groov, you can call, fax, or e-mail Opto 22 Product Support. Phone: 800-TEK-OPTO (800-835-6786 NOTE: Email messages and phone toll-free in the U.S.

  • Page 14: Chapter 2: Getting Started

    What You Will Need In order to set up your groov Box and do the activities in this chapter you will need a computer with a web browser on the same network you’ll use for the groov Box. For the best experience, we recommend Chrome, Firefox, or Internet Explorer 10 or newer.

  • Page 15: Step 1: Get To Know The Groov Box

    Step 1: Get To Know the groov Box To set up the groov Box, you’ll use the groov Box components shown below. Make sure to peel the label from the Activation Key certificate and affix it to the top of the groov Box.

  • Page 16: Step 2: Choose A Location

    Step 3: Mount the groov Box You can mount the groov Box on a flat surface using the four mounting tabs, or you can mount it on a DIN rail using the DIN rail clips provided on the back of the groov Box. Use #8 screws with the mounting tabs.

  • Page 17: Step 5: Connect The Power Supply

    Step 5: Connect the Power Supply Your groov Box requires a power supply with an output of 14-36 VDC, 24 VDC @ 1 amp. You can use the power supply that comes with the groov Box, or provide your own. In either case, we recommend using a UPS (uninterruptible power supply) for backup power and surge protection.

  • Page 18: Step 6: Turn On The Groov Box

    CAUTION: Reversing wire polarity may cause damage to your groov Box. This damage is not covered by Opto 22’s warranty. If you are not certain about the polarity of the wires on your power supply, check with a meter. b. Connect the COM wire from the power supply (normally black) to the – (negative) terminal on the power connector.

  • Page 19: Step 8: Open Groov

    Using your web browser: a. On your computer, open Firefox or Chrome, or Internet Explorer 10 or newer. b. Enter https:// and your groov Box’s hostname as the URL. The hostname is printed on top of the groov Box. For example, if the hostname is opto-01-ab-c2, you type...
  • Page 20 To proceed, enter the Administrator User Name and Password. If you do not have this information, contact your IT department. groov Find opens and automatically searches for groov Boxes on the network. Find the serial number on the top of the groov Box. Serial number groov Box User’s Guide for GROOV AT1...

  • Page 21: Step 9: Install The License File

    The Welcome to groov window opens in your web browser. Step 9: Install the License File Make sure to install your license file. Without an installed license, groov will only work for two hours. groov Box User’s Guide for GROOV AT1...

  • Page 22: Step 10: Create New Usernames And Passwords

    You will need this information each time you log in. If you lose your login information, you will have to reset the groov Box back to factory defaults, which will erase your project. After you have completed the instructions in welcome to groov, groov Build opens in your web browser.
  • Page 23 STEP 10: CREATE NEW USERNAMES AND PASSWORDS groov Box User’s Guide for GROOV AT1...

  • Page 24: Chapter 3: Using Groov Admin

    From groov Find (only on a Windows computer)—page 18 Open groov Admin from groov Build In groov Build, choose Configure > groov Admin. To log in, see page Open groov Admin using the URL 1. In your web browser, enter https://hostname:10000 groov Box User’s Guide...

  • Page 25: Open Groov Admin Using Groov Find (Windows Only)

    Open groov Admin using groov Find (Windows only) groov Find is a utility included on the groov CD that locates your groov Box on the network and provides a link so that you can access the groov applications. It is useful if you have multiple groov Boxes, because it finds and lists them all.

  • Page 26: Accepting The Security Warning

    If your computer resides in the same domain as the groov Box, you can safely accept the warning because your data is protected by the 256-bit encryption. However, if you want to avoid seeing the security warning, you can install the self-signed certificate on your computer and other devices that access groov.

  • Page 27: For Chrome

    You will need this information each time you log in. If you lose your login information, you will have to reset the groov Box back to factory defaults, which will erase your project. 1. Enter the groov Admin account Username and Password.

  • Page 28: Quick Start Menu

    Your groov project opens in groov View. For groov Build, in View click the gear icon in the upper right and choose Switch to groov Build. For information on using groov Build and View, see form 2027, the groov User’s Guide. groov Box User’s Guide...

  • Page 29: Configuring Network Connections

    Domain Name Server (DNS). If your network has DHCP and DNS, you do not need to assign an IP address to the groov Box; you just plug it in and the IP address is assigned automatically. This is the recommended method for setting up the groov Box.

  • Page 30: Changing The Hostname, Dns Servers, Or Ipv4 Gateway

    Changing the Hostname, DNS Servers, or IPv4 Gateway In order to identify the groov Box more easily on the network, you might want to change the hostname from the default. And, depending on your network setup, you might need to change the DNS Servers or IPv4 Gateway.

  • Page 31: Configuring Eth1 For The Control Network

    If your computer is on a different network than the control network, you need to configure ETH1 by assigning it an IP address and subnet appropriate for the control network. 1. In the left navigation bar choose Networking > Network Configuration, or click the Configure Network Interfaces button in Quick Start. groov Box User’s Guide...

  • Page 32: Configuring Wireless Communications

    4. Click Save. Configuring Wireless Communications You can configure the groov Box to connect to a wireless network through an access point using the 802.11b, 802.11g, and 802.11n protocols. Before you begin, get the following information from your IT Department: SSID—Name of the wireless network access point you want the groov Box to join...
  • Page 33 This should match the SSID of the access point you want to connect to. NOTE: If the SSID contains one or more spaces, enclose the SSID with quotation marks. For example, enter “Opto 22” instead of Opto 22. 4. Select the Encryption Type.
  • Page 34 10. If ETH0 and WLAN are on the same subnet, disconnect the cable from ETH0. You need to disable ETH0 because the groov Box will continue to communicate over ETH0 as long as it is connected on the same subnet and enabled.

  • Page 35: Updating Groov App (Build And View)

    Guide) or groov Admin (see page 29). 2. Make sure the groov Box is activated. See “Step 7: Activate the groov Box and Get the License File” on page 3. Go to manage.groov.com and follow directions to download the latest groovApp update file and save it to your computer.

  • Page 36: Backing Up Groov

    Opto 22 recommends that you secure your backup files using file- or disk-based encryption provided either by the operating system or other software/hardware. Also, be aware that if you send project files to Opto 22, our personnel will have access to the information listed above.
  • Page 37 – Select Download to PC. – Insert a USB drive into a USB slot on the front of the groov Box. (The option is not available until you insert the USB drive. If necessary, refresh the page.) Select Save to USB Flash Drive.

  • Page 38: Restoring Groov

    IP, Subnet, Gateway, Hostname, SSID, Wireless Network Key, etc. 4. Do one of the following: – To restore from your PC, select Upload from PC, then click Choose File and locate your backup file. groov Box User’s Guide...

  • Page 39: Updating Groov Admin

    – To restore from a USB flash drive, insert the drive with the backup file into a slot on the front of the groov Box. (The option is not available until you insert the USB drive. If necessary, refresh the page.) Click Load from USB Flash Drive, then click the browse button and select your backup file.

  • Page 40: Restarting The Groov Box

    During the restart, you’ll notice the LED lights on the groov Box go off and then come back on. You and your users will be able to use groov View and groov Build once the groov Box has fully restarted and the SYS LED has stopped flashing.
  • Page 41 On/Off button again to power it back up. During a restart, you’ll notice that the LED lights on the groov Box go off and then come back on. You and your users will be able to use groov View and groov Build once the groov Box has fully restarted and the SYS LED has stopped flashing.

  • Page 42: Changing Username And Password

    : Write down your new Username and Password, and keep it in a safe place. You will need this information each time you log in. If you lose your login information, you will have to restore the groov Box back to factory defaults, erasing your project. There is no password recovery option. 4. Click Save.

  • Page 43: Checking System Information

    Information icon in Quick Start. The following information is provided. Checking Hardware Status 1. To check the status of the internal components in the groov Box, in the left navigation bar, choose System > Hardware Status. groov Box User’s Guide...
  • Page 44 Temperature of the internal PCB located near the power supply Fan 1: Fan speed in revolutions per minute. If either of these values Fan 2: is 0, call Opto 22 for a fan replacement. Input Voltage: Main power supply for the groov Box 5.0V Supply Voltage: 3.3V Supply Voltage:...

  • Page 45: Setting The System Time

    4. Click Save. Setting the System Time You can set the time and time zone used by the groov Box. You can also set the Box to synchronize with a specific time server. 1. In the left navigation bar, choose System > System Time.
  • Page 46 Change timezone tab. 4. In the drop-down list, select a time zone, and then click Save. 5. To set up the groov Box to automatically synchronize the time with a remote server, click the Time server sync tab. Synchronization uses the Unix time protocol or NTP, depending on the remote system.
  • Page 47 SETTING THE SYSTEM TIME groov Box User’s Guide...

  • Page 48: Chapter 4: Using An Ssl Certificate

    If you are using a self-signed certificate, see “Using a Self-Signed Certificate” on page If you are using a CA-signed certificate, see “Using a CA-Signed Certificate on groov Box” on page groov Box User’s Guide...

  • Page 49: Using A Self-Signed Certificate

    Step 1: Create a Self-Signed Certificate and Private Key Follow the steps below to generate the following components required to configure self-signed certificate SSL communication. The self-signed certificate is automatically installed on the groov Box. • Private Key: This must be kept secret and never shared. Keep a copy of it in a safe and secure place.
  • Page 50 CHAPTER 4: USING AN SSL CERTIFICATE Server name: Enter the hostname of this groov Box that client browsers will use to access groov. (See also, “Changing the Hostname, DNS Servers, or IPv4 Gateway” on page 23.) The server name may contain letters a–z (case insensitive), digits 0–9, or a hyphen (-). No other characters are allowed.
  • Page 51 (where <server name> is replaced by the server name value you entered on the Create SSL key form.) This is the private key that was installed on the groov Box in the previous step. NOTE: Do not lose the private key. You must keep a copy of it to restore later in case you commission a replacement groov Box or have to restore the Box to factory defaults.
  • Page 52 CHAPTER 4: USING AN SSL CERTIFICATE It might take some time, but eventually you should see the security warning. (The security warning appears because the new certificate that was just installed on the groov Box is not trusted by the browser.) 7.

  • Page 53: Step 2: Add The Self-Signed Certificate To A Browser Trust Store On A Computer

    “OS X” on page 48 Windows Internet Explorer & Chrome 1. In Windows file explorer, locate the <server name>.cer file you created in the previous step. 2. Right-click on the file and choose Install Certificate. The Certificate Import Wizard appears. groov Box User’s Guide...
  • Page 54 1. Open Firefox and enter https://<server name> A warning appears that says, “This Connection is Untrusted.” 2. Expand “I Understand the Risks.” 3. Click Add Exception to open the Add Security Exception dialog box. 4. Select “Permanently store this exception.” groov Box User’s Guide...

  • Page 55: Os X

    If the browser does not generate an untrusted site warning, the certificate was installed correctly. OS X Safari and Chrome 1. Open Safari and enter https://<server name> to open this dialog box: 2. Click Show Certificate to reveal the full details: groov Box User’s Guide...

  • Page 56: Step 3: Install An Ssl Certificate On Mobile Devices

    7. Click Done. 8. To verify the certificate was installed correctly, open a browser and enter the hostname specified on the certificate. If the browser does not generate an untrusted site warning, the certificate was installed correctly. groov Box User’s Guide...

  • Page 57: Android Devices

    2. Click the Create certificate tab. 3. Fill in the Create SSL key form as follows: Server name: Enter the fully qualified hostname of this groov Box that client browsers will use to access groov (i.e. the hostname and domain name, such as mobilehmi.mydomain.com.) The server name may contain letters a–z (case insensitive), digits 0–9, or a hyphen (-).
  • Page 58 Admin creates a certificate signing request in addition to a new private key and self-signed certificate (which is automatically installed). groov Admin initially displays all of these together. 5. Select the Current Certificate tab, then click the CSR hyperlink at the bottom of the dialog box. groov Box User’s Guide...

  • Page 59: Step 2: Obtain A Ca-Signed Certificate

    USING A CA-SIGNED CERTIFICATE ON GROOV BOX 6. Copy and paste the entire text to a file named <server name>.csr (where <server name> is replaced by the server name value you entered on the Create SSL key form in step Step 2: Obtain a CA-Signed Certificate A CA-signed certificate contains identification information, the public key, and a digital signature.

  • Page 60: Step 3: Install The Ca-Signed Certificate On Groov Box

    CHAPTER 4: USING AN SSL CERTIFICATE 3. Finish the transaction with the certificate authority and receive your new SSL certificate. Step 3: Install the CA-Signed Certificate on groov Box 1. In groov Admin, select Networking > SSL Configuration. 2. Click the Upload certificate tab on the SSL Encryption page.
  • Page 61 7. To verify the certificate was installed correctly, use a browser to access the groov Box using the hostname specified on the certificate. If the browser does not generate an untrusted site warning, the certificate was installed correctly.

  • Page 62: Chapter 5: Maintenance And Troubleshooting

    Turning the Box on 1. Check to make sure the PWR LED is on. This means that the groov Box is receiving power. 2. Briefly press the On/Off button. Wait until the SYS LED has stopped blinking and is solid green.

  • Page 63: Resetting The Groov Box To Factory Defaults

    STOR LED stop blinking orange, the procedure is finished. 3. Briefly press the On/Off button to turn off the groov Box, then briefly press it again to turn the groov Box back on so that you can log in.

  • Page 64: Troubleshooting

    The groov Box is connected to the Ethernet network but not working • Make sure the groov Box has been turned on, the PWR LED is lit and not blinking, and the LNK ACT LED for the connected Ethernet interfaces are lit. (See “LEDs” on page 64.)

  • Page 65: Dns (Domain Name Server)

    Find (Windows only)” on page Once you’ve found your groov Box in groov Find, click the link to set up the Box. Also make a note of the IP address shown, so later you can use it in your web browser instead of the hostname: for the URL enter https:// plus the Box’s IP address.

  • Page 66: Considerations For Locating The Groov Box

    Considerations for locating the groov Box The groov Box is an industrial appliance made to operate in tough environments, so it doesn’t have to be pampered. Make sure you check the specs for temperature and humidity, and then place it where you can connect it to both your company computer network and your control network.
  • Page 67 TROUBLESHOOTING groov Box User’s Guide for GROOV AT1...

  • Page 68: A: Specifications And Dimensions

    Operating Humidity 10% to 90% relative humidity, non-condensing Storage Humidity 5% to 95% relative humidity, non-condensing CE, RoHS, DFARS Agency Approvals Wireless: U.S., FCC Part 15 Subpart C; Canada, IC RSS-210 Warranty 30 months groov Box User’s Guide for GROOV AT1...

  • Page 69: Dimensions

    DIMENSIONS Dimensions groov Box User’s Guide for GROOV AT1...

  • Page 70: B: Connectors, Indicators, And Leds

    Appendix B B: Connectors, Indicators, and LEDs Connectors and Indicators Status and activity LEDs Ethernet LEDs On/Off button USB connectors for backing up and restoring Power connector Independent 10/100/1000 Mbps Ethernet interfaces (RJ-45 connectors) groov Box User’s Guide for GROOV AT1...

  • Page 71: Leds

    LEDS LEDs The groov Box’s LEDs use color and blinking to show status information. What it shows Color What it means Blinking green Activity on hard drive STOR Hard drive activity Hard drive is being restored to factory Blinking orange...
  • Page 72 , 21 opening from groov Admin CSS3 , 28 updating , 13, 18 groov Find , 56 default factory settings , 56 default network settings , 36 hardware status , 22, 56, 57 DHCP groov Box User’s Guide for GROOV AT1...
  • Page 73 , 55 , 52 buying CA-signed , 55 , 12, 57 static IP address , 11 On/Off button , 22 assigning , 12 opening groov , 55 STOR LED , 61 operating temperature groov Box User’s Guide for GROOV AT1...
  • Page 74 , 58 communications , 61 LAN specifications , 58 hostname , 26 , 58 network interface card Opto 22 Product Support , 57 power , 55 turning groov Box on and off groov Box User’s Guide for GROOV AT1...
  • Page 75 Box User’s Guide for GROOV AT1...

Table of Contents