View source for 1002 User Guide

[[Category:UserGuide]]
{{UserguideTOC|1002.jpg|{{SERVER}}/products.php?product_id=1002}}
==Getting Started==

===Checking the Contents===
{{UGbox|
'''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===
{{UGbox|
#Connect your device to the PhidgetAnalog board using one of the terminal blocks.
#Connect the PhidgetAnalog 4-Output to your computer using the Mini-USB cable.
|
[[File:1002_0_Connecting_the_Hardware.jpg|400px|link=]]
||}}

===Testing Using Windows 2000 / XP / Vista / 7===

{{UGwin}}

===Running Phidgets Sample Program===

{{UGwin2|Analog-full}}

{{UGbox|
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.
|
[[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.
|
[[File:1002 0 Analog Screen.jpg|400px|link=]]
}}

===Testing Using Mac OS X===
{{UGmac|PhidgetAnalog 4-Output|Analog-full}}

===Using Linux===
{{UGlinux}}

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

==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). The update rate of the outputs is dependant on the speed of your system.

===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.

===Further Reading===
For more information on analog outputs, see the [[Analog Output Primer]].

==API==
{{UGapih}}

===Functions===
{{UGapi|int OutputCount() [get]|Gets the number of analog outputs supported by the PhidgetAnalog.}}
{{UGapi|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.}}
{{UGapi|double VoltageMin(int OutputIndex) [get]|Gets the minimum supported output voltage, for an output, in Volts.}}
{{UGapi|double VoltageMax(int OutputIndex) [get]|Gets the maximum supported output voltage, for an output, in Volts.}}
{{UGapi|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===
{{UGapi|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 <nowiki>=</nowiki> 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==
{{UGhist}}
{{UGrow|March 2011|0|100|Product Release, requires phidget21 2.1.8 or newer}}