1051 User Guide: Difference between revisions

From Phidgets Support
No edit summary
Line 1: Line 1:
[[Category:UserGuide]]
[[Category:UserGuide]]
{{UserguideTOC|1051.jpg|1051}}
==Getting Started==


===Checking the Contents===
===Required Hardware===
{{UGbox|
 
'''You should have received:'''
* A 1051 Phidget TemperatureSensor 1-Input
* A PhidgetTemperatureSensor 1-Input
* A Thermocouple
* A Mini-USB Cable
* A USB Cable
|
* A computer
'''In order to test your new Phidget you will also need:'''
* A Thermocouple with stripped end
||}}


===Connecting the Pieces===
===Connecting the Pieces===
{{UGbox|
[[Image:1051_0_Connecting_the_Hardware.jpg|300px|right|link=]]
# Connect the thermocouple to the input terminal block on the 1051. Make sure that the thermocouple ground wire goes into the ground terminal (-). For example, if you are using a 2007 - Phidget K-type Thermocouple, the white wire is the ground wire.
# Connect the thermocouple to the inputs on the Phidget TemperatureSensor. The datasheet or product page for the thermocouple should tell you which wire is positive and which is negative.
# Connect the 1051 to your PC using the Mini-USB cable.
# Connect the Phidget to your computer using the USB cable.
|
[[File:1051_2_Connecting_The_Hardware.jpg|400px|link=]]
||}}
 
===Testing Using Windows 2000 / XP / Vista / 7===
 
{{UGwin}}
 
===Running Phidgets Sample Program===


{{UGwin2|'''TemperatureSensor-full '''}}
<br clear="all">


{{UGbox|
==Testing Using Windows==
Double Click on the [[File:Ph.jpg|link=]] icon to activate the Phidget Control Panel and make sure that the '''Phidget Temperature Sensor''' is properly attached  to your PC.
|[[File:1051_2_Control_Panel_Screen.jpg|400px|link=]]
|
# Double Click on Phidget Temperature Sensor in the Phidget Control Panel to bring up TemperatureSensor-full and check that the box labelled Attached contains the word True.
# Select the thermocouple type (In this example, we're using a K-Type thermocouple). If you don't choose the correct type, your temperature results will be incorrect.
# Touch a source of heat (light bulb, candle or lighter flame) with the thermocouple probe and watch the Thermocouple temperature increase.
# The potential value will also increase as the thermocouple temperature increases.
# The ambient temperature gives you the board temperature.
# You can adjust the data sensitivity by moving the slider pointer.
|[[File:1051_2_Temperature_Screen.jpg|400px|link=]]
}}


===Testing Using Mac OS X===
{{UGcontrolpanel|1051}}


{{UGmac|e Phidget Temperature Sensor 1-Input|TemperatureSensor-full}}
{{ugTemperatureSensorThermocouple}}


===Using Linux===
{{ugTemperatureSensorIC}}


{{UGlinux}}
{{ugVoltageInput}}


===Using Windows Mobile / CE 5.0 / CE 6.0===
{{UGotheros}}
 
{{UGce}}


==Technical Details==
==Technical Details==
Line 60: Line 33:
For more information on thermocouples, check out the [[Thermocouple Primer]].
For more information on thermocouples, check out the [[Thermocouple Primer]].


==API==
{{UGnext|}}
{{UGapih}}
 
===Functions===
 
{{UGapi|int TemperatureInputCount () [get] : Constant
|Returns the number of thermocouples that can be read by this PhidgetTemperatureSensor.
}}
 
{{UGapi|double Temperature (int ProbeIndex) [get] : Celsius
|Returns the temperature of a thermocouple. This value is returned in degrees Celsius but can easily be converted into other units. This value will always be between TemperatureMin and TemperatureMax.  Please refer to the device specifications for noise and accuracy details.
}}
 
{{UGapi|double TemperatureMax (int ProbeIndex) [get] : Constant, Celsius
|Returns the maximum temperature that can be returned by a thermocouple input. This value depends on the thermocouple type.
}}
 
{{UGapi|double TemperatureMin (int ProbeIndex) [get] : Constant, Celsius
|Returns the minimum temperature that can be returned by a thermocouple input. This value depends on the thermocouple type.
}}
 
{{UGapi|double TemperatureChangeTrigger(int ProbeIndex) [get,set] : Celsius
|Sets the change trigger for an input. This is the amount by which the sensed temperature must change between TemperatureChangeEvents. By default this is set to 0.5.
 
:Setting TemperatureChangeTrigger to 0 will cause all temperature updates to fire events.This is helpful for applications that are implementing their own filtering.
}}
 
{{UGapi|double Potential (int ProbeIndex) [get] : Millivolts
|Returns the potential of a thermocouple input. This value is returned in millivolts, and will always be between getPotentialMin and getPotentialMax. This is the value that is internally used to calculate temperature in the library.
}}
 
{{UGapi|double PotentialMax (int ProbeIndex) [get] : Constant, Millivolts
|Returns the maximum voltage that can be measured by the 1051.
}}
 
{{UGapi|double PotentialMin (int ProbeIndex) [get] : Constant, Millivolts
|Returns the minimum voltage that can be measured by the 1051.
}}
 
{{UGapi|double AmbientTemperature () [get] : Celsius
|Returns the temperature of the 1051 board, measured near the thermocouple connector. This temperature is used as a reference for the thermocouple voltage.  This value will always be between getAmbientTemperatureMin and getAmbientTemperatureMax.
}}
 
{{UGapi|double AmbientTemperatureMax () [get] : Constant, Celsius
|Returns the maximum temperature that can be returned by the ambient sensor.
}}
 
{{UGapi|double AmbientTemperatureMin () [get] : Constant, Celsius
|Returns the minimum temperature that can be returned by the ambient sensor.
}}
 
{{UGapi|int ThermocoupleType(int ProbeIndex) [get,set]
|Returns/Sets the thermocouple type for an input. The possible values are J, K, E, and T, corresponding to K, E, J and T-Type Thermocouples.  Support for other thermocouple types, and voltage sources other then thermocouples in the valid range (between getPotentialMin and getPotentialMax) can be achieved using getPotential. Note that this function will vary widely between APIs.  Please refer to the Manual for the API you are programming against for exact calling conventions.
}}
 
===Events===
{{UGapi| | }}
{{UGapi|OnTemperatureChange(int ProbeIndex, double Temperature) [event]
|Event that fires whenever the temperature changes by more than the TemperatureChangeTrigger.
}}
 
{{UGapi|OnError(int code, String description) [event]
|PhidgetTemperatureSensor returns EEPHIDGET_OUTOFRANGE when an input goes out of the range specified by PotentialMin-PotentialMax or TemperatureMin-TemperatureMax. The event is reported once per input per out-of-range type. until the value has gone back into range. The description specifies the input, the type of out-of-range error and the out of range value that was read.


This should only happen for inputs which don’t have a thermocouple attached.
}}
==Product History==
==Product History==
{{UGhist}}
{{UGhist}}

Revision as of 19:08, 29 August 2016


Required Hardware

  • A 1051 Phidget TemperatureSensor 1-Input
  • A Thermocouple
  • A USB Cable
  • A computer

Connecting the Pieces

File:1051 0 Connecting the Hardware.jpg
  1. Connect the thermocouple to the inputs on the Phidget TemperatureSensor. The datasheet or product page for the thermocouple should tell you which wire is positive and which is negative.
  2. Connect the Phidget to your computer using the USB cable.


Testing Using Windows

Phidget Control Panel

In order to demonstrate the functionality of the 1051, the Phidget Control Panel running on a Windows machine will be used.


The Phidget Control Panel is available for use on both macOS and Windows machines.

Windows

To open the Phidget Control Panel on Windows, find the Ph.jpg icon in the taskbar. If it is not there, open up the start menu and search for Phidget Control Panel

Windows PhidgetTaskbar.PNG

macOS

To open the Phidget Control Panel on macOS, open Finder and navigate to the Phidget Control Panel in the Applications list. Double click on the Ph.jpg icon to bring up the Phidget Control Panel.


For more information, take a look at the getting started guide for your operating system:


Linux users can follow the getting started with Linux guide and continue reading here for more information about the 1051.

First Look

After plugging the 1051 into your computer and opening the Phidget Control Panel, you will see something like this:

1051 Panel.jpg


The Phidget Control Panel will list all connected Phidgets and associated objects, as well as the following information:

  • Serial number: allows you to differentiate between similar Phidgets.
  • Channel: allows you to differentiate between similar objects on a Phidget.
  • Version number: corresponds to the firmware version your Phidget is running. If your Phidget is listed in red, your firmware is out of date. Update the firmware by double-clicking the entry.


The Phidget Control Panel can also be used to test your device. Double-clicking on an object will open an example.

Temperature Sensor (Thermocouple)

Double-click on the Temperature Sensor object, labelled Thermocouple Input, in order to run the example: [[Image:{{{1}}}_TemperatureSensorThermocouple_Example.jpg|center|link=]]


General information about the selected object will be displayed at the top of the window. You can also experiment with the following functionality:

  • Modify the change trigger and/or data interval value by dragging the sliders. For more information on these settings, see the data interval/change trigger page.
  • Select your thermocouple type from the Thermocouple Type drop-down menu.
  • The measured temperature will be updated next to the Temperature label. Touch the thermocouple wire with your hands to see the temperature increase. If the temperature decreases when it should be increasing, you may have the wires plugged in incorrectly.


Temperature Sensor {{{3}}}

Double-click on the Temperature Sensor object {{{2}}} in order to run the example: [[Image:{{{1}}}_TemperatureSensorIC_Example.jpg|center|link=]]


General information about the selected object will be displayed at the top of the window. You can also experiment with the following functionality:

  • Modify the change trigger and/or data interval value by dragging the sliders. For more information on these settings, see the data interval/change trigger page.
  • The measured temperature can be seen next to the Temperature label. Cover the board with your hands to see the temperature quickly rise.


Voltage Input

Double-click on the Voltage Input object {{{2}}} in order to run the example: [[Image:{{{1}}}_VoltageInput_Example.jpg|center|link=]]


General information about the selected object will be displayed at the top of the window. You can also experiment with the following functionality:

  • Modify the change trigger and/or data interval value by dragging the sliders. For more information on these settings, see the data interval/change trigger page.

Testing Using Mac OS X

  1. Go to the Quick Downloads section on the Mac OS X page.
  2. Download and run the Phidget OS X Installer
  3. Click on System Preferences >> Phidgets (under Other) to activate the Preference Pane
  4. Make sure your device is properly attached
  5. Double click on your device's objects in the listing to open them. The Preference Pane and examples will function very similarly to the ones described above in the Windows section.

Testing Using Linux

For a general step-by-step guide on getting Phidgets running on Linux, see the Linux page.

Using a Remote OS

We recommend testing your Phidget on a desktop OS before moving on to remote OS. Once you've tested your Phidget, you can go to the PhidgetSBC, or iOS pages to learn how to proceed.

Technical Details

Cold Junction Compensation and Self-heating

Thermocouples consist of two junctions, one where the thermocouple meets the Phidget and one where the two wires are welded together at the sensing end of the device. In simplified terms, a thermocouple works by detecting the temperature difference between these two junctions. As such, in order to measure the temperature at the sensing end we need to know the temperature where the thermocouple connects to the Phidget. To do so, there is an ambient temperature sensor on the board.

An important thing to note is that the ambient temperature sensor measures the temperature of the board and the air around it, though not specifically at the junction. Generally you can assume they are nearly the same temperature, however as the electronics heat up by being powered on there can be some small error introduced. This is exacerbated by having the board in an enclosed space where normal airflow is restricted thereby increasing the effect of self-heating. As a result we recommend that the board be left in as open and well ventilated/cooled a place as possible to minimize this error source.

For more information on thermocouples, check out the Thermocouple Primer.

What to do Next

  • Programming Languages - Find your preferred programming language here and learn how to write your own code with Phidgets!
  • Phidget Programming Basics - Once you have set up Phidgets to work with your programming environment, we recommend you read our page on to learn the fundamentals of programming with Phidgets.


Product History

Template:UGhist Template:UGrow2 Template:UGrow2 Template:UGrow2 Template:UGrow2 Template:UGrow2 Template:UGrow2 Template:UGrow2

Retrieved from "http:///docs/index.php?title=1051_User_Guide&oldid=23982"