User manual

USB DrDAQ Programmer's Guide 9
Copyright © 2010-2011 Pico Technology Ltd. All rights reserved. usbdrdaqpg.en
3.5
USB DrDAQ Routines
3.5.1
Summary
The following table explains each of the driver routines supplied with the USB DrDAQ
data logger:
Routine
Description
UsbDrDaqOpenUnit
open and enumerate the unit
UsbDrDaqCloseUnit
close the unit
UsbDrDaqGetUnitInfo
return various items of information about the
unit
UsbDrDaqRun
tell the unit to start capturing data
UsbDrDaqReady
indicate when UsbDrDaqRun has captured
data
UsbDrDaqStop
abort data collection
UsbDrDaqSetInterval
set the sampling speed of the unit
UsbDrDaqSetTrigger
set the trigger on the unit
UsbDrDaqGetValues
get a number of sample values after a run
UsbDrDaqGetTriggerTimeOffsetNs
returns the time between the trigger point and
the first post-trigger sample
UsbDrDaqGetSingle
get a single value from a specified channel
UsbDrDaqOpenUnitAsync
open the unit without waiting for completion
UsbDrDaqOpenUnitProgress
report progress of UsbDrDaqOpenUnitAsync
UsbDrDaqGetScalings
discover the scalings, both built-in and custom,
that are available
UsbDrDaqSetScalings
sets the scaling for a particular channel
UsbDrDaqSetSigGenBuiltIn
sets the arbitrary waveform generator using
standard waveform types
UsbDrDaqSetSigGenArbitrary
allows full control of the arbitrary waveform
generator
UsbDrDaqStopSigGen
turns the AWG off
UsbDrDaqSetDO
control the digital outputs on the unit
UsbDrDaqSetPWM
used to configure the general-purpose I/Os as
pulse-width modulation outputs
UsbDrDaqGetInput
used to configure the general-purpose I/Os as
digital inputs
UsbDrDaqStartPulseCount
used to configure the general-purpose I/Os for
pulse counting and to start counting
UsbDrDaqGetPulseCount
will return the current pulse count
UsbDrDaqEnableRGBLED
enables or disables RGB mode on the LED
UsbDrDaqSetRGBLED
used to set the colour of the LED once RGB
mode has been enabled
UsbDrDaqGetChannelInfo
returns a set of information about the currently
selected scaling for the specified channel
The driver allows you to do the following:
Identify and open the logger
Take a single reading from a particular channel
Collect a block of samples at fixed time intervals from one or more channels
Set up a trigger event for a particular channel
Get information about scalings available for a channel
Select a scaling for a channel
Control and read general-purpose I/Os
Control arbitrary waveform generator
11
12
13
14
15 14
16
17
18
19
21
21
22
23 22
24
25
26
27
28
29
30
31
32
33
34
35
36