Difference between revisions of "1051 User Guide"

From Phidgets Support
Jump to: navigation, search
(Product History)
 
(20 intermediate revisions by 4 users not shown)
Line 1: Line 1:
 +
__NOINDEX__
 +
<metadesc>Connect a thermocouple to the PhidgetTemperatureSensor 1-Input to measure the temperature of an object or area. Plugs directly into a USB port.</metadesc>
 
[[Category:UserGuide]]
 
[[Category:UserGuide]]
{{UserguideTOC|1051.jpg|1051}}
 
 
==Getting Started==
 
==Getting Started==
 +
{{UGIntro|1051}}
 +
*[{{SERVER}}/products.php?product_id=1051 1051 Phidget TemperatureSensor 1-Input]
 +
*USB cable and computer
 +
*{{CT|TC|Thermocouple}}
  
===Checking the Contents===
 
{{UGbox|
 
'''You should have received:'''
 
* A PhidgetTemperatureSensor 1-Input
 
* A Mini-USB Cable
 
|
 
'''In order to test your new Phidget you will also need:'''
 
* A Thermocouple with stripped end
 
||}}
 
  
===Connecting the Pieces===
+
Next, you will need to connect the pieces:
{{UGbox|
+
[[Image:1051_2_Connecting_The_Hardware.jpg|500px|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===
+
<br clear="all">
 +
{{UGIntroDone|1051}}
  
{{UGwin}}
+
==Using the 1051==
 +
{{UGcontrolpanel|1051}}
  
===Running Phidgets Sample Program===
+
{{ugTemperatureSensorThermocouple|1051}}
  
{{UGwin2|'''TemperatureSensor-full '''}}
+
{{ugTemperatureSensorIC|1051|, labelled ''Temperature Sensor (IC)'', |(IC)}}
  
{{UGbox|
+
{{ugVoltageInput|1051|}}
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===
+
{{ugAddressingInformation}}
  
{{UGmac|e Phidget Temperature Sensor 1-Input|TemperatureSensor-full}}
+
{{ugUsingYourOwnProgram|1051}}
 
+
===Using Linux===
+
 
+
{{UGlinux}}
+
 
+
===Using Windows Mobile / CE 5.0 / CE 6.0===
+
 
+
{{UGce}}
+
  
 
==Technical Details==
 
==Technical Details==
 +
{{Coldjunctioncomp}}
  
 
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==
+
{{UGhist}}
+
{{UGrow|October 2003|0|100|Product Release}}
+
{{UGrow|January 2005|0|200|Noise performance improved to 2 Celsius}}
+
{{UGrow|October 2008|1|300|More accurate ambient temperature sensor. Added support for E, J, and T-type thermocouples in the API library, on-board noise filtering.}}
+
{{UGrow|April 2010  |2|400|Mini USB connector, new thermocouple connector}}
+
{{UGrow|May 2010    |2|401|Fixed setLabel}}
+
{{UGrow|May 2011    |2|402|getLabelString fixed for labels longer than 7 characters}}
+

Latest revision as of 16:12, 17 October 2019


Getting Started

Welcome to the 1051 user guide! In order to get started, make sure you have the following hardware on hand:


Next, you will need to connect the pieces:

1051 2 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.


Now that you have everything together, let's start using the 1051!

Using the 1051

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:

1051 TemperatureSensorThermocouple Example.jpg


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 (IC)

Double-click on the Temperature Sensor object , labelled Temperature Sensor (IC), in order to run the example:

1051 TemperatureSensorIC Example.jpg


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 in order to run the example:

1051 VoltageInput Example.jpg


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.

Finding The Addressing Information

Before you can access the device in your own code, and from our examples, you'll need to take note of the addressing parameters for your Phidget. These will indicate how the Phidget is physically connected to your application. For simplicity, these parameters can be found by clicking the button at the top of the Control Panel example for that Phidget.

The locate Phidget button is found in the device information box

In the Addressing Information window, the section above the line displays information you will need to connect to your Phidget from any application. In particular, note the Channel Class field as this will be the API you will need to use with your Phidget, and the type of example you should use to get started with it. The section below the line provides information about the network the Phidget is connected on if it is attached remotely. Keep track of these parameters moving forward, as you will need them once you start running our examples or your own code.

All the information you need to address your Phidget

Using Your Own Program

You are now ready to start writing your own code for the device. The best way to do that is to start from our Code Samples.

Select your programming language of choice from the drop-down list to get an example for your device. You can use the options provided to further customize the example to best suit your needs.

Code Sample Choose Language.png


Once you have your example, you will need to follow the instructions on the page for your programming language to get it running. To find these instructions, select your programming language from the Programming Languages page.

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.