1002 User Guide: Difference between revisions

From Phidgets Support
No edit summary
Line 22: Line 22:
|style="width: 10%"|
|style="width: 10%"|


|[[Image:1002_0_Connecting_the_Hardware.jpg|400px|link=]]
|[[File:1002_0_Connecting_the_Hardware.jpg|400px|link=]]
|}
|}


Line 31: Line 31:
# Go to the Quick Downloads section on the [[OS_-_Windows#Quick_Downloads|Windows page]]
# Go to the Quick Downloads section on the [[OS_-_Windows#Quick_Downloads|Windows page]]
# Download and run the Phidget21 Installer (32-bit, or 64-bit, depending on your system)
# Download and run the Phidget21 Installer (32-bit, or 64-bit, depending on your system)
# You should see the [[Image:Ph.jpg|link=]] icon on the right hand corner of the Task Bar.
# You should see the [[File:Ph.jpg|link=]] icon on the right hand corner of the Task Bar.


===Running Phidgets Sample Program===
===Running Phidgets Sample Program===


Double clicking on the [[Image:Ph.jpg|link=]] icon loads Phidget Control Panel; we will use this program to ensure that your new Phidget works properly.
Double clicking on the [[File:Ph.jpg|link=]] icon loads Phidget Control Panel; we will use this program to ensure that your new Phidget works properly.


The source code for the Analog-full sample program can be found in the quick downloads section on the [[Language_-_C_Sharp#Quick_Downloads|C# Language Page]].
The source code for the Analog-full sample program can be found in the quick downloads section on the [[Language_-_C_Sharp#Quick_Downloads|C# Language Page]].
If you'd like to see examples in other languages, you can visit our [[Software_Overview#Language_Support|Languages page]].
If you'd like to see examples in other languages, you can visit our [[Software_Overview#Language_Support|Languages page]].
{|
|Double click on the [[File:Ph.jpg|link=]] icon to activate the Phidget Control Panel and make sure that the '''Phidget Analog 4-output''' is properly attached to your PC.
|style="width: 10%"|
|[[File:1002_0_Control_Panel_Screen.jpg|400px|link=]]
|-
|
# Double click on '''Phidget Analog 4-output''' in the Phidget Control Panel to bring up Analog-full and check that the box labelled Attached contains the word True.
# Enable the Channel to which your device is connected.
# Use the slider to set the voltage. Your device should react according to the set voltage.  If you are using a multimeter, it should display the voltage as set by the slider.
|style="width: 10%"|
|[[File:1002 0 Analog Screen.jpg|400px|link=]]
|}


===Testing Using Mac OS X===
===Testing Using Mac OS X===
* Click on System Preferences >> Phidgets (under Other) to activate the Preference Pane
* Make sure that the PhidgetAnalog 4-Output is properly attached.
* Double Click on Phidget PhidgetAnalog 4-Output in the Phidget Preference Pane to bring up the Analog-full Sample program. This program will function in a similar way as the Windows version.


===Using Linux===
===Using Linux===
For a step-by-step guide on getting Phidgets running on Linux, check the [[OS_-_Linux]] page.


===Using Windows Mobile / CE 5.0 / CE 6.0===
===Using Windows Mobile / CE 5.0 / CE 6.0===
For a step-by-step guide on getting Phidgets running on Windows CE, check the [[OS_-_Windows_CE]] page.


==Technical Details==
==Technical Details==
===General===
Produces a voltage over -10V to +10V. This voltage will be asserted up to +-20mA (short-circuit). An error will be reported when this current is exceeded, and the voltage the customer is getting is no longer accurate. The voltage is produced with 12 bit resolution (4.8mV).
===Isolation===
The 1002 is not isolated. All 4 channels use the same ground.
===Current===
The PhidgetAnalog board will limit the available current per channel at approximately 20mA.  For reliable results, don’t approach this limit, as it will vary from channel to channel.  For maximum accuracy, limit the current to 5mA. If more than +- 20mA of current is drawn, the device goes into a constant current supply mode. When this happens, the current will be held constant at it’s maximum value, and the output voltage will depend on the value of the load that the device is trying to drive. 
If your application requires a larger current source / sink, the analog output can be used as an input to a larger external amplifier circuit.
All the power is supplied by the USB bus.


==API==
==API==
We document API Calls specific to this product in this section. Functions common to all Phidgets and functions not
We document API Calls specific to this product in this section. Functions common to all Phidgets and functions not applicable to this device are not covered here. This section is deliberately generic. For calling conventions under a specific language, refer to the associated API manual. For exact values, refer to the device specifications.
applicable to this device are not covered here. This section is deliberately generic. For calling conventions under a  
 
specific language, refer to the associated API manual. For exact values, refer to the device specifications.
===Functions===
===Functions===
====Properties====
'''int OutputCount() [get]'''
'''int OutputCount() [get]'''
:Gets the number of analog outputs supported by the PhidgetAnalog.
:Gets the number of analog outputs supported by the PhidgetAnalog.
Line 64: Line 101:
'''bool Enabled(int OutputIndex) [get, set]'''
'''bool Enabled(int OutputIndex) [get, set]'''
:Gets the enabled state for an output. When enabled, the output drives at the set Voltage, up to 20mA. When disabled, the output is tied to ground via a 4K pull-down.
:Gets the enabled state for an output. When enabled, the output drives at the set Voltage, up to 20mA. When disabled, the output is tied to ground via a 4K pull-down.
====Events====
 
'''OnError(int ErrorCode, String ErrorDescription)
===Events===
'''OnError(int ErrorCode, String ErrorDescription)'''
:The PhidgetAnalog will throw error events under certain circumstances:
:The PhidgetAnalog will throw error events under certain circumstances:
:'''ErrorCode = EEPHIDGET_OVERCURRENT''' - An overcurrent condition has occured on an output. Under this condition, the output is clamped to 20mA.
*'''ErrorCode = EEPHIDGET_OVERCURRENT'''
:'''ErrorCode = EEPHIDGET_OVERTEMP''' - A Thermal Shutdown state has occured. The outputs will be shut down under this condition.
:An overcurrent condition has occured on an output. Under this condition, the output is clamped to 20mA.
:When overcurrent or overtemperature state have ended, there will be an error event with the EEPHIDGET_OK code.
*'''ErrorCode = EEPHIDGET_OVERTEMP'''
:See the ErrorDescription string for specific error details
:A Thermal Shutdown state has occured. The outputs will be shut down under this condition.
 
When overcurrent or overtemperature state have ended, there will be an error event with the '''EEPHIDGET_OK''' code.
See the ErrorDescription string for specific error details.


==Product History==
==Product History==
{| style="border:1px solid darkgray;" cellpadding="7px;"
|-style="background: #f0f0f0" align=center
! Date || Board Revision || Device Version || Comment
|-
|style="background: #f0f0ff" align=center| March 2011
|style="background: #f0f0ff" align=center| 0
|style="background: #f0f0ff" align=center| 100
|style="background: #f0f0ff" align=center| Product Release, requires phidget21 2.1.8 or newer
|-

Revision as of 19:32, 18 July 2012

Getting Started

Checking the Contents

You should have received:
  • A PhidgetAnalog 4-Output
  • A Mini-USB cable
  • A Hardware Mounting Kit
 In order to test your new Phidget you will also need:
  • A device requiring a 0 to 10V signal
  • A multimeter could also be used to monitor the output voltage

Connecting the Pieces

  1. Connect your device to the PhidgetAnalog board using one of the terminal blocks.
  2. Connect the PhidgetAnalog 4-Output to your computer using the Mini-USB cable.
 1002 0 Connecting the Hardware.jpg

Testing Using Windows 2000 / XP / Vista / 7

Make sure you have the current version of the Phidget library installed on your PC. If you don't, follow these steps:

  1. Go to the Quick Downloads section on the Windows page
  2. Download and run the Phidget21 Installer (32-bit, or 64-bit, depending on your system)
  3. You should see the Ph.jpg icon on the right hand corner of the Task Bar.

Running Phidgets Sample Program

Double clicking on the Ph.jpg icon loads Phidget Control Panel; we will use this program to ensure that your new Phidget works properly.

The source code for the Analog-full sample program can be found in the quick downloads section on the C# Language Page. If you'd like to see examples in other languages, you can visit our Languages page.

Double click on the Ph.jpg icon to activate the Phidget Control Panel and make sure that the Phidget Analog 4-output is properly attached to your PC. File:1002 0 Control Panel Screen.jpg
  1. Double click on Phidget Analog 4-output in the Phidget Control Panel to bring up Analog-full and check that the box labelled Attached contains the word True.
  2. Enable the Channel to which your device is connected.
  3. Use the slider to set the voltage. Your device should react according to the set voltage. If you are using a multimeter, it should display the voltage as set by the slider.
 File:1002 0 Analog Screen.jpg

Testing Using Mac OS X

  • Click on System Preferences >> Phidgets (under Other) to activate the Preference Pane
  • Make sure that the PhidgetAnalog 4-Output is properly attached.
  • Double Click on Phidget PhidgetAnalog 4-Output in the Phidget Preference Pane to bring up the Analog-full Sample program. This program will function in a similar way as the Windows version.

Using Linux

For a step-by-step guide on getting Phidgets running on Linux, check the OS_-_Linux page.

Using Windows Mobile / CE 5.0 / CE 6.0

For a step-by-step guide on getting Phidgets running on Windows CE, check the OS_-_Windows_CE page.

Technical Details

General

Produces a voltage over -10V to +10V. This voltage will be asserted up to +-20mA (short-circuit). An error will be reported when this current is exceeded, and the voltage the customer is getting is no longer accurate. The voltage is produced with 12 bit resolution (4.8mV).

Isolation

The 1002 is not isolated. All 4 channels use the same ground.

Current

The PhidgetAnalog board will limit the available current per channel at approximately 20mA. For reliable results, don’t approach this limit, as it will vary from channel to channel. For maximum accuracy, limit the current to 5mA. If more than +- 20mA of current is drawn, the device goes into a constant current supply mode. When this happens, the current will be held constant at it’s maximum value, and the output voltage will depend on the value of the load that the device is trying to drive.

If your application requires a larger current source / sink, the analog output can be used as an input to a larger external amplifier circuit.

All the power is supplied by the USB bus.

API

We document API Calls specific to this product in this section. Functions common to all Phidgets and functions not applicable to this device are not covered here. This section is deliberately generic. For calling conventions under a specific language, refer to the associated API manual. For exact values, refer to the device specifications.

Functions

int OutputCount() [get]

Gets the number of analog outputs supported by the PhidgetAnalog.

double Voltage(int OutputIndex) [get, set]

Gets or sets the current voltage output setting for an analog output, in Volts. The range is VoltageMinVoltageMax. Voltage is not actually applied until Enabled is set to true.

double VoltageMin(int OutputIndex) [get]

Gets the minimum supported output voltage, for an output, in Volts.

double VoltageMax(int OutputIndex) [get]

Gets the maximum supported output voltage, for an output, in Volts.

bool Enabled(int OutputIndex) [get, set]

Gets the enabled state for an output. When enabled, the output drives at the set Voltage, up to 20mA. When disabled, the output is tied to ground via a 4K pull-down.

Events

OnError(int ErrorCode, String ErrorDescription)

The PhidgetAnalog will throw error events under certain circumstances:
  • ErrorCode = EEPHIDGET_OVERCURRENT
An overcurrent condition has occured on an output. Under this condition, the output is clamped to 20mA.
  • ErrorCode = EEPHIDGET_OVERTEMP
A Thermal Shutdown state has occured. The outputs will be shut down under this condition.

When overcurrent or overtemperature state have ended, there will be an error event with the EEPHIDGET_OK code. See the ErrorDescription string for specific error details.

Product History

Date Board Revision Device Version Comment
March 2011 0 100 Product Release, requires phidget21 2.1.8 or newer
Retrieved from "https://www.phidgets.com/docs/index.php?title=1002_User_Guide&oldid=20754"