1499 Nvio Starter Kit Guide - Opto 22 · PDF fileLED Startup Sequence ... 4—Create and Test an Alarm Notification ... Sony Ericsson and existing Global System for Mobile Communications

NVIO STARTER KIT GUIDE

Form 1499-050823—August, 2005

43044 Business Park Drive • Temecula • CA 92590-3614Phone: 800-321-OPTO (6786) or 951-695-3000

Fax: 800-832-OPTO (6786) or 951-695-2712www.opto22.com

Product Support Services800-TEK-OPTO (835-6786) or 951-695-3080

Fax: 951-695-3017Email: [email protected]: support.opto22.com

Nvio Starter Kit GuideForm 1499-050823—August, 2005

Copyright © 2004–2005 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 later 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. These products include, but are not limited to, OptoTerminal-G70, OptoTerminal-G75, and Sony Ericsson GT-48; see the product data sheet for specific warranty information. Refer to Opto 22 form number 1042 for complete warranty information.

Opto 22 FactoryFloor, Cyrano, Optomux, and Pamux are registered trademarks of Opto 22. Generation 4, ioControl, ioDisplay, ioManager, ioProject, ioUtilities, mistic, Nvio, Nvio.net Web Portal, OptoConnect, OptoControl, OptoDisplay, OptoENETSniff, OptoOPCServer, OptoScript, OptoServer, OptoTerminal, OptoUtilities, SNAP Ethernet I/O, SNAP I/O, SNAP OEM I/O, SNAP Simple I/O, SNAP Ultimate I/O, and SNAP Wireless LAN I/O are trademarks of Opto 22.

ActiveX, JScript, Microsoft, MS-DOS, VBScript, Visual Basic, Visual C++, and Windows are either registered trademarks or trademarks of Microsoft Corporation in the United States and other countries. Linux is a registered trademark of Linus Torvalds. Unicenter is a registered trademark of Computer Associates International, Inc. ARCNET is a registered trademark of Datapoint Corporation. Modbus is a registered trademark of Schneider Electric. Wiegand is a registered trademark of Sensor Engineering Corporation. Nokia, Nokia M2M Platform, Nokia M2M Gateway Software, and Nokia 31 GSM Connectivity Terminal are trademarks or registered trademarks of Nokia Corporation. Sony is a trademark of Sony Corporation. Ericsson is a trademark of Telefonaktiebolaget LM Ericsson.

All other brand or product names are trademarks or registered trademarks of their respective companies or organizations.

ii Nvio Starter Kit Guide

Table of Contents

Chapter 1: Introduction ................................................................................ 1

Nvio Starter Kit.......................................................................................................................1Device Data .....................................................................................................................1Wireless Communications ..............................................................................................1Data Logging and Graphing.............................................................................................2Nvio Architecture ............................................................................................................2More About I/O ...............................................................................................................2

Nvio Starter Kit Contents .......................................................................................................3Nvio Starter Kit Unit........................................................................................................4

Power and GSM Antenna Connectors .....................................................................5Nvio Wireless Data Service ............................................................................................5

About this Guide.....................................................................................................................5For Help ...........................................................................................................................6

Chapter 2: Getting Started .......................................................................... 7

Introduction ............................................................................................................................7

Setting Up the Nvio Starter Kit Unit ......................................................................................7

Powering Up the Unit .............................................................................................................7

Connecting to the Wireless Network.....................................................................................8LED Startup Sequence.....................................................................................................9

Logging In to the Nvio.net Portal .........................................................................................10

Monitoring a Remote Sensor ...............................................................................................10

Controlling a Remote Device................................................................................................12

What’s Next?........................................................................................................................13

Chapter 3: Using the Nvio.net Web Portal .............................................. 15

Introduction ..........................................................................................................................15Wireless Communication ..............................................................................................15

Nvio Starter Kit Guide iii

Minimizing Wireless Data Expenses ............................................................................15On-Portal and On-Device Behaviors ..............................................................................16

Nvio.net Web Portal .............................................................................................................161—Log In.......................................................................................................................162—Create an On-Device Notification...........................................................................163—Create a Logical Sensor ..........................................................................................194—Create and Test an Alarm Notification...................................................................20

Testing the Alarm...................................................................................................22

What’s Next?........................................................................................................................22

Chapter 4: Doing More with the Nvio Starter Kit .................................. 23

Monitoring a Door Switch ....................................................................................................231—Create an On-Device Notification...........................................................................232—Create and Test an Alarm Notification...................................................................25

Testing the Alarm...................................................................................................27

Connecting Other Devices to the Starter Kit........................................................................28

Extending Nvio.net Services after Three Months ................................................................28

Other M2M Solutions from Opto 22 ....................................................................................28

Appendix A: Troubleshooting .................................................................... 29

Communication Problems.....................................................................................................29Confirming Wireless Signal Reception .........................................................................29Solutions to Common Communication Problems..........................................................30

Data Isn’t Recorded on the Nvio.net Web Portal.................................................................30

Resetting the Nvio Starter Kit Unit ......................................................................................31

Appendix B: Specifications and Wiring ................................................... 33

Nvio Starter Kit.....................................................................................................................33

Digital Inputs and Outputs (G4 Modules).............................................................................33

Built-in Analog Inputs...........................................................................................................34Converting between Counts and Degrees F or C ...................................................34

iv Nvio Starter Kit Guide

CHAPTER 1

Chapter 1

Introduction

Nvio Starter KitThe Nvio™ Starter Kit from Opto 22 provides in one turnkey system all the elements needed to monitor and manage remote devices so you can quickly evaluate or implement a machine-to-machine (M2M) application.

This packaged solution combines device interface and wireless communications hardware, wireless service on a nationwide network, and data logging and graphing capabilities—everything you'd otherwise need to acquire and integrate yourself to build a remote M2M application.

Device DataThe Nvio Starter Kit unit collects information about remote electrical and mechanical devices using proven Opto 22 input/output (I/O) technology, including industry-standard G4 digital I/O modules. The Nvio Starter Kit unit is designed for collecting device data out of the box; it includes a temperature probe and digital inputs that can be switched on and off. For simple access monitoring applications, door switches (contacts) and installation instructions are also included.

Wireless CommunicationsThe Nvio Starter Kit delivers device data to a secure server using communications hardware from Sony Ericsson and existing Global System for Mobile Communications (GSM) networks. The kit includes a pre-activated SIM card and three months of wireless data service. (Wireless data service for the Nvio Starter Kit is currently available only within the continental United States.)

Nvio Starter Kit User’s Guide 1

CHAPTER 1: INTRODUCTION

Data Logging and GraphingAt the secure server location, device data is logged into a database and can then be accessed securely via the Nvio.net™ Web Portal™ using a standard Web browser and your PC. The Web portal is available 24 hours a day, seven days a week, and includes unlimited authorized users (administered by you), all messaging, data archival, alarming, and trending. A user account is established when you purchase the Nvio Starter Kit, so device data can be collected as soon as power is applied to the Nvio Starter Kit unit.

Use the Nvio.net Web Portal to easily monitor temperature, door switch status, and other device inputs. Alarms can be defined for all inputs; alarm actions include sending an email message, or calling a telephone number with a synthesized voice alert.

Nvio ArchitectureNvio Starter Kit components work together to remotely monitor and control remote devices as shown in the following illustration:

More About I/ODescribed simply, the input/output (I/O) function of the Nvio Starter Kit unit operates by receiving electrical signals (inputs) from and sending electrical signals (outputs) to sensors and devices. These electrical signals are of two kinds: analog and digital.

• Analog signals represent a range of values: for example, the ICTD (temperature) probe included with the kit returns an electrical signal that varies with the environmental temperature, so the ICTD probe is attached to an analog input.

• Digital signals represent a binary state such as on/off or open/closed. Here, a good example is the door contact (switch) included with the Nvio Starter Kit; the door contact can be only open or closed, so it is attached to a digital input.

Web Browser for Nvio.net Web Portal

Secure Nvio.net Server

GSM Wireless Network

Nvio Starter Kit Unit

Nvio Starter Kit Unit

2 Nvio Starter Kit User’s Guide


The Nvio Starter Kit unit includes four built-in analog inputs, four Opto 22 G4 digital input modules, and four Opto 22 G4 digital output modules. These inputs and outputs, as well as the corresponding names used in the Nvio.net Web Portal, are listed in detail in the table below.

On the Web portal you’ll also see the item Temperature. This is not an actual sensor attached to the Nvio Starter Kit unit, but a logical sensor whose value is calculated by the portal based on the value of ICTD Probe.

Nvio Starter Kit ContentsThe Nvio Starter Kit includes the following:

• 90-day Nvio.net Web Portal account for monitoring and controlling remote devices from a Web browser

• 90 days of wireless data service on a GSM network (2 MB data and 300 SMS messages per month included)

• Sony Ericsson GT48 terminal with a pre-activated SIM card for data communication over a GSM wireless network

Name in Web Portal Explorer Tree Description Use in Nvio Starter Kit

Door Switch Opto 22 G4 digital module G4IDC5-SWNCDry contact (self-powered) input, normally closed

The door contact (switch) connected to this digital input is included in the Nvio Starter Kit.

ICTD Probe Built-in Analog Input 1 on the Nvio Starter Kit unit’s circuit board. Can be configured to accept the following signals:• ICTD (temperature)• –20 to +20 mA• –10 to +10 VDC

The ICTD (temperature) probe included in the Nvio Starter Kit is connected to this analog input.

_Analog In 2 (same as Analog In 1) Available (not used)



_Digital In 2 Opto 22 G4 digital module G4IDC5-MA10–32 VDC input

Available (not used)

_Digital In 3 Opto 22 G4 digital module G4IAC590–140 VAC input


_Digital In 4 Opto 22 G4 digital module G4IAC5-MA90–140 VAC input with manual switch


_Digital Out 1 Opto 22 G4 digital module G4OAC512–140 VAC output


_Digital Out 2 Opto 22 G4 digital module G4OAC5-MA12–140 VAC output with manual switch


_Digital Out 3 Opto 22 G4 digital module G4ODC5-MA5–60 VDC output with manual switch


_Digital Out 4 Opto 22 G4 digital module G4ODC5RReed relay output




• Pre-calibrated ICTD temperature analog input

• Door switch (contact) digital input and wiring

• Three digital input modules to monitor device states

• Four digital output modules to turn devices on and off

• Three additional built-in analog inputs to monitor changing voltage or current levels

• 110 VAC to 12 VDC power adapter.

IMPORTANT: Restrictions apply to the amount of data and number of messages the Nvio Starter Kit unit can exchange with the Nvio.net Web Portal. See “Nvio Wireless Data Service” on page 5 for information.

Nvio Starter Kit UnitThe Nvio Starter Kit unit is shown below:

Sony Ericsson GT48 communications terminal

Door switch (contact) and wiring

ICTD (temperature probe) wired to an analog input

Plug for 110 VAC to 12 VDC adapter

Four configurable analog inputs

Eight Opto 22 G4 digital I/O modules



Power and GSM Antenna Connectors

Nvio Wireless Data ServiceThe Nvio Starter Kit comes with 90 days of wireless data service on a GSM wireless network. If you plan to use the Nvio Starter Kit after this period, additional wireless data service can be purchased from Opto 22. Contact Opto 22 at 1-877-NVIO-2DAY (877-684-6232) for pricing and additional information.

The wireless data service used with the Nvio Starter Kit allows a maximum of 300 SMS messages (for communications from the portal to the unit) and a maximum of 2 MB of data (for communications from the unit to the portal). If your use of the Nvio Starter Kit causes these limits to be exceeded, your Nvio account will be charged accordingly. See “Minimizing Wireless Data Expenses” on page 15 for suggestions on how to manage the use of wireless data service.

About this GuideThis guide includes:

Chapter 1, “Introduction,” describes the Nvio Starter Kit and the components that comprise it. This section also includes contact information for Opto 22 Product Support.

Chapter 2, “Getting Started,” provides instructions for setting up, configuring, and testing the Nvio Starter Kit.

Pre-attached GSM antenna for Sony Ericsson communications terminal

ICTD (temperature probe) wired to an analog input, and door contacts wired to a digital input

Connector for 110 VAC to 12 VDC power adapter



Chapter 3, “Using the Nvio.net Web Portal,” introduces behaviors, alarming, and other tasks performed using the Nvio.net Web Portal.

Chapter 4, “Doing More with the Nvio Starter Kit,” describes other uses for the Nvio Starter Kit and introduces other M2M solutions from Opto 22.

Appendix A, “Troubleshooting,” lists common problems you may encounter and describes how to diagnose and resolve them.

Appendix B, “Specifications and Wiring,” provides detailed specifications of the Nvio Starter Kit hardware.

For HelpIf you have problems setting up or using the Nvio Starter Kit and cannot find the help you need in this guide, contact Opto 22 Product Support.

Phone: 800-TEK-OPTO (835-6786)951-695-3080(Hours are Monday through Friday, 7 a.m. to 5 p.m. Pacific Time)

Fax: 951-695-3017

Email: [email protected]

Opto 22 Web site: support.opto22.com

When calling for technical support, please be prepared to provide the following information to the Product Support engineer:

• Email address used for your Nvio.net Web Portal account

• Both the local placement (for example, near a window) and geographic location of the Nvio Starter Kit unit

• Specific error messages seen on the Nvio.net Web Portal.

NOTE: Email messages and phone calls to Opto 22 Product Support are grouped together and answered in the order received.


CHAPTER 2

Chapter 2

Getting Started

IntroductionThe Nvio Starter Kit is designed so you can quickly get up and running with a working M2M application. The instructions in this section expand on those in the kit’s Quick Start Card to help you understand how the Nvio Starter Kit works and what it can do for your M2M application.

Setting Up the Nvio Starter Kit Unit1. Unpack the Nvio Starter Kit unit, power adapter, and other contents from the shipping box.

2. Confirm that a grounded 110 VAC electrical outlet is available where the unit will be located.

3. Place the Nvio Starter Kit unit upright on a desk or table so that the external wires are on the left-hand side of the case. You should be able to see the unit’s transparent cover.

4. Place the magnetic antenna at least 2–3 feet (0.5–1 m) above the unit. If possible, place the antenna near an outside window.

Powering Up the Unit1. Plug the power adapter into a grounded 110 VAC electrical outlet.


CHAPTER 2: GETTING STARTED

2. Plug the power adapter’s connector into side of the Nvio Starter Kit unit.

Connecting to the Wireless NetworkThe Nvio Starter Kit unit uses four built-in LEDs to indicate communication and power status. (See diagram on next page.)

• Comm Terminal Activity—This small green LED on the Sony Ericsson communications terminal flashes slowly when the terminal is connected to the wireless network. It flashes rapidly when information is being transmitted or received.

• Activity—Indicates unit is receiving or transmitting data over the wireless network.

• Network Connection—Indicates the unit is successfully connected to the wireless network.

• Power—Indicates the unit is receiving power from a 12–24 VDC source.

Pre-attached antenna

Connector for 110 VAC to 12 VDC power adapter



Nvio Starter Kit unit LEDs are shown in the illustration below:

LED Startup SequenceWhen the Nvio Starter Kit unit is powered up, the following activities take place:

• The red Activity and Network Connection LEDs turns on for a moment and then turns off.

During this period, the unit is performing internal diagnostics and connecting to the local wireless network.

• After a few moments, the Network Connection LED turns on again and remains on.

This process may take up to one minute, depending on the performance of your local wireless network.

IMPORTANT: The Network Connection LED indicates a successful connection has been made to your local wireless network. This LED must be on for the Nvio Starter Kit to work.

If the Network Connection LED does not turn on, first try moving the antenna to different locations. If the LED still doesn’t turn on, move the entire Nvio Starter Kit unit to another location

Comm Terminal Activity— Indicates the communications terminal is connected to the wireless network. The LED flashes rapidly when information is being transmitted or received.

Power—Indicates the unit is receiving power from a 12–24 VDC source.

Activity—Indicates unit is receiving or transmitting data over the wireless network.

Network Connection— Indicates the unit is successfully connected to the wireless network.



where a wireless signal can be received. See “Communication Problems” on page 29 in the Troubleshooting section if problems continue.

Logging In to the Nvio.net Portal1. Start your Web browser and go to the Web site www.nvio.net.

2. Enter the email address and password shown on your Nvio registration form. (This information is also included in your Nvio confirmation email.)

The Nvio.net Web Portal window opens.

The Web portal’s default view gives a comprehensive overview of all sensors and devices connected to your Nvio Starter Kit unit. The Monitor Center, Commands Center, and other sections of the Web portal are used for monitoring sensors, controlling devices, configuring alarms, and other tasks.

Monitoring a Remote SensorA simple way to start using the Nvio Starter Kit is to check the temperature where the unit is located.



1. Click Commands (located near the center of the browser window).

2. Under “Explorer” on the left, click + next to the device “Nvio Starter Kit,” and then click Temperature.

3. In the “Available Commands” section, click Request latest reading from the transducer.

4. In the “I want to...” section, click Prepare a command.

The screen updates to display the command you selected.

5. In the “I want to...” section, click Launch the command.

6. Click Open command monitor.

For receiving sensor data from the Nvio Starter Kit unit, communication between the portal and the unit may require up to five minutes to complete.

Monitor | Alarms | Behaviors | Commands | Accounts | Users | Properties

Explorer

•C <Your Organization>

Nvio Starter Kit

Door Switch

ICTD Probe

Temperature

_Analog In 2

_Analog In 3

_Analog In 4

_Digital In 2

_Digital In 3

_Digital In 4

_Digital Out 1

_Digital Out 2

_Digital Out 3

_Digital Out 4

Command CenterTemperature

Available CommandsRequest latest reading from the transducer.

Command

Monitor

Nvio Starter Kit:D Control Fri Sept 10 13:57 PDT Success

Destination Request When Issued State



7. When the State column says “Success,” return to the Nvio Portal window in your Web browser.

8. Click Monitor (next to Commands), and then locate and click Temperature.

The Monitor graph view of the data for Temperature appears.

9. In the Report Type drop-down menu above the graph, select “Tabular View.”

The temperature (in degrees F) at the Nvio Starter Kit unit‘s location appears at the top of the list.

Controlling a Remote DeviceNext, try controlling a light on the Nvio Starter Kit unit, in this case the LED on one of the eight G4 I/O modules installed on the unit’s mounting rack.

1. Click Commands near the center of the browser window.

2. Under “Explorer” on the left, click _Digital Out 4.

Line Chart

Hour Day Week Month Quarter Yea


Explorer


Nvio Starter Kit

Door Switch

ICTD Probe

Temperature

_Analog In 2

_Analog In 3

_Analog In 4

_Digital In 2

_Digital In 3

_Digital In 4

_Digital Out 1

_Digital Out 2

_Digital Out 3

_Digital Out 4

Monitor CenterTemperature



3. In the “Available Commands” section, click Turn the selected transducer ON.




6. Wait until the LED on the module closest to the center of the Nvio Starter Kit unit turns on.

For turning a device on or off, communication between the portal and the Nvio Starter Kit unit may require up to three minutes to complete.

What’s Next?See Chapter 3, “Using the Nvio.net Web Portal” to learn about setting alarms based on sensor and device data. You’ll also learn more about the communication methods used by the portal and the Nvio Starter Kit unit.


Explorer


Nvio Starter Kit

Door Switch

ICTD Probe

Temperature

_Analog In 2

_Analog In 3

_Analog In 4

_Digital In 2

_Digital In 3

_Digital In 4

_Digital Out 1

_Digital Out 2

_Digital Out 3

_Digital Out 4

Command Center__Digital Out 4

Available CommandsTurn the selected transducer ON.Turn the selected transducer OFF.




CHAPTER 3

Chapter 3

Using the Nvio.net Web Portal

IntroductionThe Nvio.net Web Portal is your means of monitoring and controlling the Nvio Starter Kit unit and the sensors and devices connected to it. A standard Web browser is all that’s needed to access the Web portal, which is used to send commands to and receive information from the remote Nvio Starter Kit unit.

Wireless CommunicationThe Web portal communicates with the Nvio Starter Kit unit using standard GSM wireless networks, the same networks used for many mobile phones. Two forms of wireless data communication are used:

• When the Web portal sends a command to the remote unit, it sends a Simple Message Service (SMS) message to the telephone number assigned to that unit.

• When the Nvio Starter Kit unit sends data to the Nvio.net Web Portal, it uses the General Packet Radio Services (GPRS) protocol to connect to the Web portal and send its data.

Minimizing Wireless Data ExpensesThe Nvio Starter Kit’s wireless data plan includes 300 SMS messages and 2 MB of data (via GPRS) per month. If your wireless data use exceeds these limits, your Nvio.net account will be charged for the additional wireless data service used.

When using the Nvio Starter Kit unit, here are some suggestions for keeping your wireless data use within these limits:

• Have the Nvio Starter Kit unit contact the Web portal only when pre-defined events occur. If you don’t need to have data reported at a regular interval, configure the Nvio Starter Kit unit to contact the Web portal only when a predefined event occurs (for example, a threshold is exceeded). This configuration is presented in this guide on pages 16, 19, and 23.

• Avoid having the Nvio Starter Kit unit report unnecessarily. If you need to have the Nvio Starter Kit unit report data to the Web portal at regular intervals, choose a reporting


CHAPTER 3: USING THE NVIO.NET WEB PORTAL

interval suitable for your application. For example, instead of reporting a slow-changing office temperature at five-minute intervals, reporting this data once an hour would probably be sufficient.

On-Portal and On-Device BehaviorsThe Nvio.net Web Portal and Nvio Starter Kit unit use behaviors, or pre-programmed rules, to define alarm thresholds, configure the unit, and perform calculations and other actions. Behaviors that run and are evaluated on the Web portal, such as alarm notifications and logical sensors, are called on-portal behaviors. Behaviors that need to occur on the Nvio Starter Kit unit independently of the Nvio.net Web Portal are called on-device behaviors. Examples of these behaviors include sending data to the Web portal when an event occurs, and configuring analog and digital inputs and outputs.

Nvio.net Web PortalThese instructions step you through using the Nvio.net Web Portal to monitor a temperature and to send an alarm via phone or email when that temperature exceeds a predefined value.

1—Log InIf you are not already in the Nvio.net Web Portal, log in to www.nvio.net. If you need help doing this, see page 10.

2—Create an On-Device NotificationBefore setting up an alarm to contact you when a temperature threshold is exceeded, you must first configure the Nvio Starter Kit unit to contact the Nvio.net Web Portal when the predefined temperature is exceeded.

NOTE: This exercise assumes that the Nvio Starter Kit unit is located indoors where the temperature is no higher than 85 °F (29 °C).

1. Click Behaviors (located near the center of the browser window).

2. Under “Explorer” on the left, click ICTD Probe.



3. In the “I want to...” section, click Add a new behavior.

4. In the “Available Behaviors” section, scroll down the list of behaviors and click On the device, report on analog value out-of-bounds.

5. In the “I want to...” section click Create behavior.


Explorer


Nvio Starter Kit

Door Switch

ICTD Probe

Temperature

_Analog In 2

_Analog In 3

_Analog In 4

_Digital In 2

_Digital In 3

_Digital In 4

_Digital Out 1

_Digital Out 2

_Digital Out 3

_Digital Out 4

Behavior ComposerICTD Probe

Existing BehaviorsOn the device, calibrate this transducer to display ICTD input

I want to...Add a new behavior Create logical sensor• •


Available BehaviorsAlarm threshold ruleThreshold range alarm ruleThreshold control ruleSensor reading notifierEvery day poll for telemetry ruleEvery day make sure reading is receivedAuto ack or clear ruleAlarm escalation ruleAlarm notifier ruleOn the device, report on analog value out-of-boundsOn the device, report point at a specific time

I want to...Create behavior Go back to previous step• •



The screen updates to display the behavior you selected.

The Template section describes in a sentence the behavior that you created. You specify the threshold figures by clicking the appropriate highlighted words and replacing them with values. In this exercise, you want the Nvio Starter Kit to report when the temperature exceeds a high value, so replace the word highhigh. You will also need to replace the word lowlow to define the low value in the temperature range, although this low value won’t be tested in this exercise.

6. Do the following:

a. Click highhigh, enter the value 18040, and then click Okay.b. Click lowlow, enter the value 16890, and then click Okay.

Both values must be entered in counts, not degrees F or C. On the ICTD probe connected to the Nvio Starter Kit, 18040 counts corresponds to 90 °F (32 °C) and 16890 counts corresponds to 55 °F (13 °C). See “Converting between Counts and Degrees F or C” on page 34 for conversion information.

7. In the “I want to...” section, click Save the behavior.

The Nvio.net Web Portal connects to the Nvio Starter Kit unit and sends the new behavior. You should see the unit’s green Comm Terminal activity LED flash more rapidly when this occurs.

IMPORTANT: Allow up to five minutes for the new behavior to be sent to the Nvio Starter Kit unit and programmed into it. During this time do not configure other behaviors.

You can monitor the status of this process in the Command Monitor; click Commands at the top of the window and then click Open the command monitor in the center of the screen.


Behavior

TemplateOn the device, report when the value crosses out of bounds of low and high, and again when it crosses out of bounds of lowlow and highhigh.

I want to...Save the behavior•

Behavior properties are highlighted below. You can modify a property by clicking it. A dialog will appear with the appropriate properties for editing. Once you are satisfied with the configuration of the behavior and required properties have been entered, save it. Just form a sentence that tells your agent what to do.

Go back to list of behaviors•



The Nvio Starter Kit unit is now configured to contact the Nvio.net Web Portal when the temperature range is exceeded.

3—Create a Logical SensorA logical sensor modifies the data from an actual sensor or device to provide an alternative view of data, such as a unit conversion or an average. A logical sensor is a Web portal behavior, and no information needs to be exchanged with the Nvio Starter Kit unit. In this exercise, you’ll create a logical sensor that converts the counts value reported by ICTD Probe into degrees Celsius.

1. Click Behaviors.

2. Under “Explorer,” click ICTD Probe.

3. In the “I want to...” section, click Create logical sensor.

4. In the dialog box that appears, select Logical Scaling Sensor.

A logical scaling sensor converts reported data from its original scale into another scale. In this case, counts reported by ICTD Probe are converted into degrees Celsius.

To have the logical sensor report average values, you would instead select Logical Averaging Sensor, which reports an average value of a specified number of instances.

5. Enter the name “Temperature (deg C)” and click Next.

6. Next, step through the screens in the Logical Sensor Wizard to enter the following information:


Explorer


Nvio Starter Kit

Door Switch

ICTD Probe

Temperature

_Analog In 2

_Analog In 3

_Analog In 4

_Digital In 2

_Digital In 3

_Digital In 4

_Digital Out 1

_Digital Out 2

_Digital Out 3

_Digital Out 4


Existing BehaviorsOn the device, calibrate this transducer to display ICTD input.




– Coefficient: 0.016932

– Offset: –273.2

– Unit Label: (deg C)

7. At the final screen in the Logical Sensor Wizard, review the information you entered and then click Finish.

The new logical sensor Temperature (deg C) appears in the Explorer tree. Whenever ICTD Probe reports a value, this logical sensor will convert that value into degrees Celsius.

4—Create and Test an Alarm NotificationAlarm notifications are on-portal behaviors that can notify you, as well as others, of any number of device-related activities that occur.

1. Click Behaviors.

2. Under “Explorer,” click Temperature.

NOTE: This is the logical sensor for degrees F. If you want to test the alarm notification using the Temperature (deg C) logical sensor, click Temperature (deg C) instead and then continue with the following steps.



Explorer


Nvio Starter Kit

Door Switch

ICTD Probe

Temperature

_Analog In 2

_Analog In 3

_Analog In 4

_Digital In 2

_Digital In 3

_Digital In 4

_Digital Out 1

_Digital Out 2

_Digital Out 3

_Digital Out 4


Existing BehaviorsOn the device, calibrate this transducer to display ICTD input.




4. In the “Available Command Templates” section, click Alarm threshold rule.

5. In the “I want to...” section, click Create behavior.


6. In the “Behavior template” section, click on the following parameters and enter the required values:

• Threshold value: 90

Behavior ComposerTemperature

Available BehaviorsAlarm threshold ruleThreshold range alarm ruleThreshold control ruleSensor reading notifierEvery day poll for telemetry ruleEvery day make sure reading is receivedAuto ack or clear ruleAlarm escalation ruleAlarm notifier ruleOn the device, report on analog value out-of-boundsOn the device, report point at a specific time


Behavior ComposerTemperature (deg F)

Behavior

TemplateWhen the sensor publishes a reading, if the value of the reading is greater than a threshold value then create a minor alarm and send notification to a notification list.

SettingsThis behavior is enabled and allowed to run 1 time after which the behavior will be disabled.






Enter 32 if you are using the Temperature (deg C) logical sensor.

• Notification list: (Enter one or more email addresses or telephone numbers.)

7. The “Settings” section describes in a sentence the behavior’s status and how often it will run. In this section, confirm that the default values shown below appear in the sentence:

“This behavior is enabled and allowed to run 1 time after which the behavior will be disabled.”


The new behavior is saved on the Nvio.net Web Portal.

The Web portal is now configured to notify you when the temperature limit is exceeded.

Testing the Alarm

To trigger the on-device behavior and test the alarm notification, the ICTD (temperature) probe connected to the Nvio Starter Kit unit needs to detect a temperature above the High value defined earlier—that is, greater than 90 °F (32 °C).

1. To test the alarm, place the tip of the ICTD (temperature) probe near a source of moderate heat, such as a desk lamp or a cup of coffee.

WARNING: Do not immerse the tip of the ICTD (temperature) probe in liquid. Damage to the probe and the Nvio Starter Kit unit may result.

2. Watch the Nvio Starter Kit unit’s green Comm Terminal Activity indicator.

After a few seconds, the LED should start to blink rapidly, indicating the Nvio Starter Kit unit is communicating with the Nvio.net Web Portal.

3. Wait for your alarm notification phone call or email message.

It may take 2–3 minutes to receive a phone call from the Web portal. Email message arrival times are usually similar, but may be longer if your organization’s email system checks for incoming messages less frequently.

NOTE: If you are expecting to receive an alert notification email message but it never arrives, check with your system administrators or your Internet provider that the message from the Nvio.net Web Portal is not being filtered out as unwanted email (or “spam”).

What’s Next?See Chapter 4, “Doing More with the Nvio Starter Kit,” to learn about other common remote monitoring and control tasks you can do with the Nvio Starter Kit. Chapter 4 also introduces related M2M systems available from Opto 22.


CHAPTER 4

Chapter 4

Doing More with the Nvio Starter Kit

This chapter describes additional applications for your Nvio Starter Kit and introduces other M2M solutions from Opto 22.

Monitoring a Door SwitchThe Nvio Starter Kit includes a door switch (or contact) that is already connected to one of the digital input modules. This switch is ideal for demonstrating event-based alarming and can also be used for monitoring doors if you choose to deploy your Nvio Starter Kit unit for an application.

Configuring the Nvio.net Web Portal and Nvio Starter Kit unit to monitor a door switch uses on-device and on-portal behaviors similar to the exercises in Chapter 3, “Using the Nvio.net Web Portal.” Follow the steps below to configure the required behaviors and alarms.

1—Create an On-Device NotificationThis behavior configures the Nvio Starter Kit unit to contact the Nvio.net Web Portal when the door switch is opened. The default state of the switch is normally closed, so the Nvio Starter Kit unit needs to contact the Web portal when there is a transition from closed to open.



CHAPTER 4: DOING MORE WITH THE NVIO STARTER KIT

2. Under “Explorer” on the left, click Door Switch.


4. In the “Available Command Templates” section, click On the device, report on digital transition.


Explorer


Nvio Starter Kit

Door Switch

ICTD Probe

Temperature

_Analog In 2

_Analog In 3

_Analog In 4

_Digital In 2

_Digital In 3

_Digital In 4

_Digital Out 1

_Digital Out 2

_Digital Out 3

_Digital Out 4

Behavior ComposerDoor Switch

Existing BehaviorsOn the device, make this transducer a digital in.



Available BehaviorsSensor reading notifierEvery day poll for telemetry ruleEvery day make sure reading is receivedOn the device, report on digital transitionDigital change alarm notifierDigital Transducer Alarm NotifierAuto ack or clear ruleAlarm escalation ruleAlarm notifier ruleOn the device, report point at a specific timeOn the device, report on interval






The “Behavior template” section describes in a sentence the behavior that you created. The door switch’s transition from closed to open corresponds to a transition from low to high, so you must modify the existing description.

6. In the behavior description, click High to Low, select “Low to High” in the dialog box that opens, and then click OK.

7. In the “Behavior template” section, click Save the behavior.

The Nvio.net Web Portal connects to the Nvio Starter Kit unit and sends the new behavior. You should see the unit’s green Comm Terminal activity LED flash more rapidly when this occurs.

IMPORTANT: Allow up to five minutes for the new behavior to be sent to the Nvio Starter Kit unit and programmed into it. During this time do not configure other behaviors.


The Nvio Starter Kit unit is now configured to contact the Nvio.net Web Portal when the door contact is opened.

2—Create and Test an Alarm NotificationNow configure an alarm notification that will phone or email you when the door contact switch is opened.


Behavior

TemplateOn the device, report the value of this input on a transition from High to Low.







2. Under “Explorer,” click Door Switch.


4. In the “Available Command Templates” section, click Digital change alarm notifier.



Available BehaviorsSensor reading notifierEvery day poll for telemetry ruleEvery day make sure reading is receivedOn the device, report on digital transitionDigital change alarm notifierDigital Transducer Alarm NotifierAuto ack or clear ruleAlarm escalation ruleAlarm notifier ruleOn the device, report point at a specific timeOn the device, report on interval





6. In the “Behavior template” section, click the following parameter and change it as shown below.

• Notification list: Enter one or more email addresses and telephone numbers to receive an email or telephone alert.

The other parameters do not have to be changed for this exercise.

7. The “Settings” section describes in a sentence the behavior’s status and how often it will run. In this section, confirm that the default values shown below appear in the sentence:

“This behavior is enabled and allowed to run 1 time after which the behavior will be disabled.”


The new behavior is saved on the Nvio.net Web Portal.

The Web portal is now configured to notify you when the door contact is opened.

Testing the Alarm

To trigger the on-device notification and test the alarm notification, do the following:

1. Separate the two parts of the door switch.

The LED on the module on the right side of the Nvio Starter Kit unit lights.

2. Watch the Nvio Starter Kit unit’s green Comm Terminal Activity indicator.


Behavior

TemplateWhen the sensor publishes a reading, if the value of the reading is high and is different from the previous reading then create a minor alarm and send notification to a notification list.

SettingsThis behavior is enabled and allowed to run 1 time after which the behavior will be disabled.






After a few seconds, the LED should start to blink rapidly, indicating the Nvio Starter Kit unit is communicating with the Nvio.net Web Portal.

3. Wait for your alarm notification phone call or email message.

It may take 2–3 minutes to receive a phone call from the Web portal. Email message arrival times are usually similar, but may be longer if your organization’s email system checks for incoming messages less frequently.

NOTE: If you are expecting to receive an alert notification email message but it never arrives, check with your system administrators or your Internet provider that the message from the Nvio.net Web Portal is not being filtered out as unwanted email (or “spam”).

Connecting Other Devices to the Starter KitYou can connect other sensors and devices can be connected to the Nvio Starter Kit unit, depending on the signal the sensor or device requires. For more information, see “More About I/O” on page 2, “Digital Inputs and Outputs (G4 Modules)” on page 33, and “Built-in Analog Inputs” on page 34. If you plan to deploy the Nvio Starter Kit unit in an application, you’ll also need to extend the 90-day period of wireless and Web portal service. See Extending Nvio.net Services after Three Months in this section for information.

Extending Nvio.net Services after Three MonthsThe Nvio Starter Kit includes 90 days of Nvio.net Web Portal service plus wireless data communication from a nationwide (U.S.) provider. If you plan to use your Nvio Starter Kit equipment for an application or need additional evaluation time, service can be purchased from Opto 22. Call 1-877-NVIO-2DAY (877-684-6232) for purchase information.

Other M2M Solutions from Opto 22The Nvio Starter Kit provides a small sample of the M2M solutions available from Opto 22. Opto 22 M2M systems are used in applications worldwide where reliable remote monitoring and control is required, and several families of Opto 22 products are available to provide the best solution for a particular M2M application. Contact an Opto 22 Sales Engineer to discuss your application needs at 1-877-NVIO-2DAY (877-684-6232).


APPENDIX A

Appendix A

Troubleshooting

This section describes problems you may encounter while using the Nvio Starter Kit. Refer to the headings below to find the section covering your general problem, and then try the steps suggested to remedy it. If you still encounter problems after trying these steps, contact Opto 22 Product Support. See “For Help” on page 6 for contact information.

Communication ProblemsThe most common problem you may encounter with the Nvio Starter Kit is difficulty receiving the signal from the wireless network used for communication between the Nvio Starter Kit unit and the Nvio.net Web Portal.

The Nvio Starter Kit unit uses a standard commercial GSM/GPRS wireless phone network to connect to the Nvio.net Web Portal, and the Sony Ericsson communications terminal used in the unit is essentially a mobile phone without keypad, display, microphone, and speaker. This means that most communication problems you may encounter are similar to those you might also have with a mobile phone.

Confirming Wireless Signal ReceptionTo confirm that the Nvio Starter Kit unit is receiving a signal from the GSM network, first look at the Network Connection and Comm Terminal Activity LEDs shown in the following illustration:

Nvio Starter Kit Guide 29

APPENDIX A: TROUBLESHOOTING

The Comm Terminal Activity LED should be blinking steadily when the unit is connected to a wireless network. The Network Connection LED should also be lit.

Solutions to Common Communication ProblemsAfter checking the unit’s LEDs, do the following:

• Confirm that the Nvio Starter Kit is receiving electrical power. Is the AC adapter firmly plugged into both the electrical outlet and the starter kit case?

• Move the antenna to a different location. The higher the location and the closer to a window, the better.

• Unplug the Nvio Starter Kit unit and move it to a different location, preferably closer to a window, to make it easier to receive the signal from the wireless network.

Data Isn’t Recorded on the Nvio.net Web PortalBy itself, the Nvio.net Web Portal does not automatically record sensor data from the Nvio Starter Kit unit. You must configure the Nvio Starter Kit unit to report to the Web portal by creating an on-device behavior. When you save this behavior, the Nvio Starter Kit unit is then programmed automatically.

Check the following:

• Confirm that an on-device behavior is set up to report data to the Nvio.net Web Portal. To check this, click Behaviors (located at the center of the screen) and then click a sensor or

Comm Terminal Activity—Indicates the communications terminal is connected to the wireless network. The LED flashes rapidly when information is being transmitted or received.

Activity—Indicates unit is receiving or transmitting data over the wireless network.

Network Connection—Indicates the unit is successfully connected to the wireless network.

30 Nvio Starter Kit Guide


transducer in the Explorer tree. The behaviors configured for that sensor or actuator are listed under “Existing Behaviors.” See “On-Portal and On-Device Behaviors” on page 16 for basic steps to create on-device behaviors.

• If you need an analog value measured in something other than counts, you must create a logical sensor based on the analog value. For example, the Nvio Starter Kit’s logical sensor Temperature is based on the value of ICTD Probe. See page 19 for instructions.

Resetting the Nvio Starter Kit UnitWhen you create an on-device behavior for the Nvio Starter Kit unit, it’s important to wait until the behavior has been completely downloaded and programmed into the unit. If you create another on-device behavior before the first behavior is downloaded and programmed, the Nvio Starter Kit unit can potentially lock up; that is, it no longer responds to Web portal commands and does not execute on-device behaviors.

If the Nvio Starter Kit unit locks up, follow these steps to first reset the unit and then resend all on-device behaviors.

IMPORTANT: Resetting the Nvio Starter Kit unit to its default configuration will erase all configured behaviors. After resetting the unit, you must recreate and resave all behaviors.

1. Click Behaviors in the menu bar at the top of the screen.

2. For each item in the Explorer tree, click the object and see if any behaviors are configured for it. If one or more behaviors are configured for an object, write down the behavior name(s) and the order in which they appear in the list of existing behaviors.

3. Click Commands in the menu bar at the top of the screen.

4. In the Explorer tree, click the device Nvio Starter Kit.



5. In the “Available Commands” section, click On the device, reset the device to factory configuration.




The Nvio.net Web Portal connects to the Nvio Starter Kit unit and reset the unit to its original factory configuration. You should see the unit’s green Communications Terminal activity LED flash more rapidly when this occurs.

IMPORTANT: Allow up to 5–10 minutes for the Nvio Starter Kit unit to be reset. During this time do not configure other behaviors.


8. Next, recreate and resave all the behaviors you wrote down in step 2.

As you do this, leave the Command Monitor window open to watch the progress of each command.


Explorer


Nvio Starter Kit

Door Switch

ICTD Probe

Temperature

_Analog In 2

_Analog In 3

_Analog In 4

_Digital In 2

_Digital In 3

_Digital In 4

_Digital Out 1

_Digital Out 2

_Digital Out 3

_Digital Out 4

Command CenterNvio Starter Kit

Available CommandsRestore on-device behaviorsOn the device, reset the device to factory configuration.

I want to...Prepare command Open command monitor• •


APPENDIX B

Appendix B

Specifications and Wiring

Nvio Starter Kit

Digital Inputs and Outputs (G4 Modules)The Nvio Starter Kit unit includes the following Opto 22 G4 I/O modules:

Wireless Communication* GSM/GPRS data service from GSM network providerDual-band operation: 850 MHz and 1900 MHz GSM networks

Power Requirements 12–24 VDC (110 VAC to 12 VDC power adapter provided)

Dimensions 180 x 524 x 90 mm (7.1 x 10.0 x 3.5 in.)

Operating Temperature -10° to +55° C (14° to +131° F)

Storage Temperature -40° to +85° C (-40° to +185° F)

Operating Humidity 20–75% non-condensing

Storage Humidity 5–95% non-condensing

* Wireless network and Web portal service is currently available only within the continental United States. Contact Opto 22 for more information.

Module Position on G4-SE-4A8D Rack

Input or Output Module

G4 I/O Module Specifications

0

Inpu

t

G4IDC5-SWNC Dry contact (self-powered) input, normally closed

1 G4IDC5-MA 10–32 VDC input

2 G4IAC5 90–140 VAC input

3 G4IAC5-MA 90–140 VAC input with manual switch


APPENDIX B: SPECIFICATIONS AND WIRING

The following illustration shows these modules in their installed locations:

For information on wiring devices and sensors to the Opto 22 G4 I/O modules included with the Nvio Starter Kit, see the G4 Family Data Book (Opto 22 form 727). This document can be downloaded at no charge from the Opto 22 Web site. The best way to find a document on the Web site is to enter its form number in the Search box on the main page.

Built-in Analog Inputs

Converting between Counts and Degrees F or C

When creating an on-device notification that is based on a temperature reading, you must provide a value in counts (the raw units the Nvio Starter Kit unit uses to record an analog input). These counts and the temperature they correspond to are shown in the following table.

4

Out

put

G4OAC5 12–140 VAC output

5 G4OAC5-MA 12–140 VAC output with manual switch

6 G4ODC5-MA 5–60 VDC output with manual switch

7 G4ODC5R Reed relay output

Module Position on G4-SE-4A8D Rack

Input or Output Module

G4 I/O Module Specifications

12345678- +- +- +- +

12345678910111213141516

1234567 0

12-24VDCPOWER

DIGITAL I/O1234567 0

ANALOGINPUTS

G4-

SE

-4A

8D

+–ANT

G4ID

C5-S

WNC

G4ID

C5-M

A

G4IA

C5

G4IA

C5-M

A

G4OA

C5

G4OA

C5-M

A

G4OD

C5-M

A

G4OD

C5R



These conversion formulas and values have been used to create the following reference table:

These values are based on the following conversion formulas:

For this temperature... ...enter this value in counts

For this temperature... ...enter this value in countsDegrees F Degrees C Degrees F Degrees C

50 10 16725 90 32 18040

55 13 16890 95 35 18200

60 16 17055 100 38 18370

65 18 17220 105 41 18530

70 21 17380 110 43 18695

75 24 17550 115 46 18860

80 27 17710 120 49 19025

85 29 17875 125 52 19190

counts = (degrees + offset) / coefficient

degrees = (counts * coefficient) + offset

where coefficient and offset have the following values:

Degrees Fahrenheit

• Coefficient: 0.030456

• Offset: –459.4

Degrees Celsius

• Coefficient: 0.016932

• Offset: –273.2




Documents

1499 Nvio Starter Kit Guide - Opto 22 · PDF fileLED Startup Sequence ... 4—Create and Test an Alarm Notification ... Sony Ericsson and existing Global System for Mobile Communications