Information

PicoLog 1000 Series Programmer's Guide 7
Copyright © 2009 Pico Technology Ltd. All rights reserved. pl1000pg.en
3.3
Driver routines
3.3.1
Summary
The following table explains each of the driver routines supplied with the PicoLog 1000
Series data loggers:
Routine
Description
pl1000CloseUnit
close the unit
pl1000GetSingle
get a single value from a specified channel
pl1000GetUnitInfo
return various items of information about the unit
pl1000GetValues
get a number of sample values after a run
pl1000MaxValue
return the maximum ADC value
pl1000OpenUnit
open and enumerate the unit
pl1000OpenUnitAsync
open the unit without waiting for completion
pl1000OpenUnitProgress
report progress of pl1000OpenUnitAsync
pl1000Ready
indicate when pl1000Run has captured data
pl1000Run
tell the unit to start capturing data
pl1000SetDo
control the digital outputs on the unit
pl1000SetInterval
set the sampling speed of the unit
pl1000SetPulseWidth
configure the PWM output
pl1000SetTrigger
set the trigger on the unit
pl1000Stop
abort data collection
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
You can specify a sampling interval from 1 microsecond to 1 second. The shortest
interval that the driver will accept depends on the capture mode selected.
The normal calling sequence to collect a block of data is as follows:
Check that the driver version is correct
Open the driver
Set trigger mode (if required)
Set sampling mode (channels and time per sample)
While you want to take measurements,
Run
While not ready
Wait
End while
... Get a block of data ...
End While
Close the driver
8
9
10
11
12
13
14
15 14
16 17
17
18
19
20
21
22
6