PICO picoscope 3204 User manual

Copyright 2005 Pico Technology Limited. All rights reserved.
PicoScope 3000 Series
User guide
PS3000044 1.4
PC Oscilloscopes

Table of Contents
.............................................................................................2
1 Introduction
...................................................................................................2
1 Overview
...................................................................................................2
2 Safety symbols
...................................................................................................3
3 Safety warning
...................................................................................................3
4 FCC notice
...................................................................................................4
5 CE notice
...................................................................................................4
6 Licence conditions
...................................................................................................4
7 Trademarks
...................................................................................................5
8 Warranty
...................................................................................................5
9 Company details
.............................................................................................6
2 Product information
...................................................................................................6
1 Minimum system requirements
...................................................................................................6
2 Installation instructions
...................................................................................................8
3 Specifications
.............................................................................................9
3 Technical reference
...................................................................................................9
1 Driver
...................................................................................................9
2 Driver error codes
...................................................................................................10
3 Functions
...................................................................................................26
4 Advanced features
...................................................................................................29
5 Using different modes
...................................................................................................30
6 Programming
.............................................................................................32
4 Troubleshooting
...................................................................................................32
1 Software error codes
...................................................................................................33
2 Powering the 3204/5/6
.............................................................................................34
5 Glossary
......................................................................................................37
Index
PicoScope 3000 Series User GuideI
Copyright 2005 Pico Technology Limited. All rights reserved.
PS3000044 1.4

Introduction 2
Copyright 2005 Pico Technology Limited. All rights reserved. PS3000044 1.4
1Introduction
1.1 Overview
The
PicoScope 3000 Series
is a range of high speed PC Oscilloscopes, fully
USB 2.0
-
capable and backwards-compatible with USB 1.1. There is no need for an additional
power supply as power input is from the USB port, so these oscilloscopes are highly
portable.
With the
PicoScope software
, you can use PicoScope 3000 Series PC Oscilloscopes as
oscilloscopes and spectrum analysers; with the
PicoLog software
, you can use them as
data loggers. Alternatively, you might want to use some of the API functions to develop
your own programs to collect and analyse data from the oscilloscope.
A typical PicoScope 3000 Series PC Oscilloscope is supplied with the following items:
USB cable, for use with USB 1.1 and 2.0 ports
Software CD
Installation guide
Quick start guide
1.2 Safety symbols
Symbol 1: Warning Triangle
This symbol indicates that a safety hazard exists on the indicated
connections if correct precautions are not taken. Read all safety
documentation associated with the product before using it.
Symbol 2: Equipotential
This symbol indicates that the outer shells of the indicated BNC
connectors are all at the same potential (shorted together). You must
therefore take necessary precautions to avoid applying a potential
across the return connections of the indicated BNC terminals as this
may result in a large current flow causing damage to the product and/or
connected equipment.

PicoScope 3000 Series User Guide
3
Copyright 2005 Pico Technology Limited. All rights reserved.
PS3000044 1.4
1.3 Safety warning
We strongly recommend that you read the general safety information below before using
your oscilloscope for the first time.
Safety protection built in to equipment may cease to
function if the equipment is used incorrectly. This could cause damage to your computer,
or lead to injury to yourself and others.
Maximum input range
PicoScope 3000 Series PC Oscilloscopes are designed to measure voltages in the range
-20 V to +20 V and are protected to ±50 V (3204/5/6 variants) or ±100 V (3224/3424
variants). Contact with voltages outside the protection range may cause physical damage.
Mains voltages
Pico Technology products are not designed for use with mains voltages. To measure
mains, use a differential isolating probe specifically designed for a high source voltage.
Safety grounding
PicoScope 3000 Series PC Oscilloscopes connect direct to the ground of a computer
through the interconnecting cable provided. This method minimises interference.
As with most oscilloscopes, avoid connecting the ground input to any source other than
ground. If in doubt, use a meter to check that there is no significant AC or DC voltage
between the ground input of the oscilloscope and the point to which you intend to connect
it. Failure to check may cause damage to your computer, or lead to injury to yourself and
others.
You should assume that the product does not have a protective safety earth.
Repairs
The oscilloscope contains no serviceable parts. Repair or calibration of the oscilloscope
requires specialised test equipment and must be performed by Pico Technology.
1.4 FCC notice
This equipment has been tested and found to comply with the limits for a Class A digital
device, pursuant to
Part 15 of the FCC Rules
. These limits are designed to provide
reasonable protection against harmful interference when the equipment is operated in a
commercial environment. This equipment generates, uses, and can radiate radio
frequency energy and, if not installed and used in accordance with the instruction manual,
may cause harmful interference to radio communications. Operation of this equipment in
a residential area is likely to cause harmful interference in which case the user will be
required to correct the interference at his or her own expense.
For safety and maintenance information see the
safety warning
.

Introduction 4
Copyright 2005 Pico Technology Limited. All rights reserved. PS3000044 1.4
1.5 CE notice
The PicoScope 3000 Series PC Oscilloscopes meet the intent of the
EMC directive
89/336/EEC
and have been designed to
EN61326-1 (1997) Class B Emissions and
Immunity
standard.
PicoScope 3000 Series PC Oscilloscopes also meet the intent of the
Low Voltage
Directive
and have been designed to meet the
BS EN 61010-1:2001 IEC 61010-1:2001
(safety requirements for electrical equipment, control, and laboratory use) standard.
1.6 Licence conditions
The material contained in this release is licensed, not sold. Pico Technology Limited
grants a licence to the person who installs this software, subject to the conditions listed
below.
Access
The licensee agrees to allow access to this software only to persons who have been
informed of these conditions and agree to abide by them.
Usage
The software in this release is for use only with Pico products or with data collected using
Pico products.
Copyright
Pico Technology Limited claims the copyright of, and retains the rights to, all material
(software, documents etc.) contained in this release. You may copy and distribute the
entire release in its original state, but must not copy individual items within the release
other than for backup purposes.
Liability
Pico Technology and its agents shall not be liable for any loss, damage or injury,
howsoever caused, related to the use of Pico Technology equipment or software, unless
excluded by statute.
Fitness for purpose
Because no two applications are the same, Pico Technology cannot guarantee that its
equipment or software is suitable for a given application. It is your responsibility,
therefore, to ensure that the product is suitable for your application.
Mission-critical applications
This software is intended for use on a computer that may be running other software
products. For this reason, one of the conditions of the licence is that it excludes usage in
mission-critical applications; for example, life-support systems.
1.7 Trademarks
Windows
and
Excel
are registered trademarks or trademarks of Microsoft Corporation in
the USA and other countries.
Pico Technology Limited
,
PicoLog
and
PicoScope
are trademarks of Pico Technology
Limited, registered in the United Kingdom and other countries.

PicoScope 3000 Series User Guide
5
Copyright 2005 Pico Technology Limited. All rights reserved.
PS3000044 1.4
1.8 Warranty
Pico Technology warrants upon delivery, and for a period of 24 months unless otherwise
stated from the date of delivery, that the Goods will be free from defects in material and
workmanship.
Pico Technology shall not be liable for a breach of the warranty if the defect has been
caused by fair wear and tear, wilful damage, negligence, abnormal working conditions or
failure to follow Pico Technology's spoken or written advice on the storage, installation,
commissioning, use or maintenance of the Goods or (if no advice has been given) good
trade practice; or if the Customer alters or repairs such Goods without the written consent
of Pico Technology.
1.9 Company details
Address:
Pico Technology Limited
The Mill House
Cambridge Street
St Neots
Cambridgeshire
PE19 1QB
United Kingdom
Phone:
[phone]
Fax:
[phone]
Email:
Technical Support:
[email protected]
Sales:
[email protected]
Web site:
www.picotech.com

Product information 6
Copyright 2005 Pico Technology Limited. All rights reserved. PS3000044 1.4
2Product information
2.1 Minimum system requirements
For PicoScope 3000 Series PC Oscilloscopes to operate, you must have a computer with
the minimum system requirements to run Windows or the following (whichever is the
higher specification):
Processor
Pentium class processor or equivalent minimum.
Memory
32 MB minimum.
Disk space
10 MB minimum.
Operating system
Microsoft Windows 98 SE, ME, 2000, XP or later.
Ports
USB 1.1 compliant port minimum. USB 2.0 compliant port
recommended. Must be connected direct to the port or a
powered USB hub. Will not work on a passive hub.
2.2 Installation instructions
Important
Do not connect your
PicoScope 3000 Series
PC Oscilloscope to the PC
until you have installed the software.
Procedure
Follow the instructions in the Quick Start Guide included with your product package.
Connect your PC Oscilloscope to the PC using the USB cable supplied.
There is no need for an additional power supply, as the unit obtains its power from the
USB port.
Checking the installation
Once you have installed the software and connected the PC Oscilloscope to the PC, start
the
PicoScope
or
PicoLog
software. The software should now display the voltage that you
have connected. If you are using the PicoScope software and have a probe connected to
your oscilloscope, you should see a small 50Hz or 60Hz mains signal in the oscilloscope
window when you touch the probe tip with your finger .
Standard oscilloscope connectors
PicoScope 3000 Series
PC Oscilloscopes have standard oscilloscope connectors. The
input impedance is also standard, so the x10 function on scope probes works correctly.

PicoScope 3000 Series User Guide
7
Copyright 2005 Pico Technology Limited. All rights reserved.
PS3000044 1.4
Connector diagrams
3204
3205
3206
3224
3424
1
USB port.
2
LED. When lit, indicates the oscilloscope is sampling data.
3
Power socket. 12 V DC at 500 mA.
A
Input channel A.
B
Input channel B.
C
Input channel C.
D
Input channel D.
E
External trigger
input /
Signal generator
output.
The BNC connector labelled '
E
' on the 3204/5/6 models has two functions. In normal use
it is the external trigger input with an adjustable threshold. Alternatively, on some
oscilloscopes, this connector can also be used to output sine, square and triangle
waveforms which can be swept back and forth at a user-defined frequency. The
integrated signal generator can be controlled via the PicoScope software or by API calls.
The signal generator can also be used to compensate x10 scope probes when set to
output a square wave.
Ground loops
If you experience excessive noise or voltage offsets when using the PicoScope 3204/5/6
variants, you may have a ground loop problem. See
Powering the 3204/5/6
for advice on
overcoming this.
Moving your PicoScope PC Oscilloscope to another USB port
When you install the PicoScope 3000 Series PC Oscilloscope by plugging it into a
USB
port, Windows associates the Pico
driver
software with that port. If you later move the
oscilloscope to a different USB port, Windows will display the "New Hardware Found
Wizard" again. When this occurs, simply follow the steps listed in the Quick Start Guide
after the instruction "Connect the PicoScope 3000 Series PC Oscilloscope to the PC..."
As all the software you need is already installed on your computer, there is no need to
insert the Pico Software CD again.

Product information 8
Copyright 2005 Pico Technology Limited. All rights reserved. PS3000044 1.4
2.3 Specifications
Variant
3204
3205
3206
3224
3424
Vertical resolution
8 bits
8 bits
8 bits
12 bits
Analog bandwidth
50 MHz
100 MHz
200 MHz
10 MHz
Max. sampling rate
Single channel
Dual channel
Triple or quad channel
Repetitive signals
50 MS/s
50 MS/s
-
2.5 GS/s
100 MS/s
100 MS/s
-
5 GS/s
200 MS/s
100 MS/s
-
10 GS/s
20 MS/s
10 MS/s
-
-
20 MS/s
10 MS/s
5 MS/s
-
Trigger bandwidth
50 MHz
100 MHz
150 MHz
10 MHz
Buffer size
(samples per channel)
One channel in use
Two channels in use
3 or 4 channels in use
256 K
128 K
-
512 K
256 K
-
1 M
512 K
-
512 K
256 K
-
512 K
256 K
128 K
Inputs
2 BNC channels
4 BNC
channels
1 M
W
impedance
AC/DC coupling
20 pF capacitance
Outputs
Signal generator
Fixed
(Note 1)
Variable
(Note 2)
None
External trigger
1 BNC input shared with signal generator
Variable trigger threshold ± 20 V
Rising/falling
12.2 mV resolution
1 M
W
impedance
None
Voltage ranges
± 100 mV to ± 20 V in 1, 2, 5 steps
± 20 mV to ± 20 V
Accuracy
3% voltage
100 ppm time
1% voltage
100 ppm time
Operating environment
Temperature range
Humidity
0°C to 70°C (25°C for quoted accuracy)
25% to 75% RH
0°C to 70°C
(20°C to 30°C for
quoted accuracy)
25% to 75% RH
Overload protection
Channels
External trigger
± 50 V
± 30 V
± 100 V
-
PC connection
USB 2.0
Compatible with USB 1.1
Power supply
From USB port: 4.6 to 5.25 V 500 mA
External power supply is not required
From USB port
Dimensions
140 mm x 190 mm x 45 mm
Compliance
CE standard
;
FCC rules
(1)
1 BNC shared with external trigger. Fixed frequency 1 kHz. 5 V square wave. 600
W
output
impedance.
(2) 1 BNC shared with external trigger. Variable frequency 100 Hz to 1 MHz. 5 V square wave, 1 V
sine wave and triangle functions. Repeat sweep function. Dual slope function. 600
W
output
impedance.

PicoScope 3000 Series User Guide
9
Copyright 2005 Pico Technology Limited. All rights reserved.
PS3000044 1.4
3Technical reference
3.1 Driver
The Windows 98SE/ME/2000/XP/2003 32-bit driver,
picopp.sys
, is installed in
Windows. It is loaded using an inf file,
picopp.inf
.
Once you have installed the PicoScope and PicoLog software, and the PicoScope 3000
Series PC Oscilloscope is plugged in for the first time, Windows will automatically install
the driver.
3.2 Driver error codes
This section is aimed at those people who intend to write their own programs for use with
the driver. A description of the driver error codes is given below.
If the PicoScope or
PicoLog software reports an error, refer to the
FAQ
.
Code
Enumeration
Description
0
PS3000_OK
The oscilloscope is functioning correctly.
1
PS3000_MAX_UNITS_OPENED
Attempts have been made to open more than
PS3000_MAX_UNITS.
2
PS3000_MEM_FAIL
Not enough memory could be allocated on the
host machine.
3
PS3000_NOT_FOUND
An oscilloscope could not be found.
4
PS3000_FW_FAIL
Unable to download firmware.
5
PS3000_NOT_RESPONDING
The oscilloscope is not responding to
commands from the PC.
6
PS3000_CONFIG_FAIL
The configuration information in the
oscilloscope has become corrupt or is missing.
7
PS3000_OS_NOT_SUPPORTED
Driver supports Windows 98SE, ME, 2000, XP,
2003 or later.

Technical reference 10
Copyright 2005 Pico Technology Limited. All rights reserved. PS3000044 1.4
3.3 Functions
3.3.1 ps3000_open_unit
short ps3000_open_unit
( void)
This function opens a PicoScope 3000 Series PC Oscilloscope. The API driver can
support up to four oscilloscopes.
Arguments
None.
Returns
-1
if the oscilloscope fails to open,
0
if no oscilloscope is found,
>0
(handle) if the device opened.

PicoScope 3000 Series User Guide
11
Copyright 2005 Pico Technology Limited. All rights reserved.
PS3000044 1.4
3.3.2 ps3000_get_unit_info
short ps3000_get_unit_info (
short
handle,
char
* string,
short
string_length,
short
info
)
This function writes oscilloscope information to a character string. If the oscilloscope fails
to open, only infos 0 and 6 are available to explain why the last open unit call failed.
Arguments
handle
, the handle to the device from which info is required. If an
invalid handle is passed, the error code from the last unit that failed to
open is returned from line 2.
* string
, a pointer to the character string buffer in the calling function
where the unit information string (selected with line) will be stored. If a
null pointer is passed, no information will be written.
string_length
, the length of the character string buffer. If the string
is not long enough to accept all of the information, only the first
string_length
characters are returned.
info
, is an enumerated type specifying what information is required
from the driver.
Returns
The length of the string written to the character string buffer, string, by
the function. If one of the parameters are out of range, or a null pointer
is passed for string, zero will be returned.
info
Description
Example
PS3000_DRIVER_VERSION
(0)
Returns the version number of the
DLL used by the oscilloscope driver.
"1, 0, 0, 2"
PS3000_USB_VERSION
(1)
Returns the type of USB connection
that is being used to connect the
oscilloscope to the computer.
"1.1" or "2.0"
PS3000_HARDWARE_VERSION
(2)
Returns information about what is
the hardware version of the attached
oscilloscope.
"1"
PS3000_VARIANT_INFO
(3)
Returns information about what
model of PicoScope 3000 Series PC
Oscilloscope is attached to the
computer.
"3206"
PS3000_BATCH_AND_SERIAL
(4)
Returns the batch and serial number
of the oscilloscope.
"CMY66/052"
PS3000_CAL_DATE
(5)
Returns the calibration date of the
oscilloscope.
"21Oct03"
PS3000_ERROR_CODE
(6)
Returns one of the
Error codes
.
"4"

Technical reference 12
Copyright 2005 Pico Technology Limited. All rights reserved. PS3000044 1.4
3.3.3 ps3000_flash_led
short ps3000_flash_led ( short handle )
Flashes the LED on the front of the oscilloscope three times and returns within one
second.
Arguments
handle
, the handle of the PicoScope 3000 Series PC Oscilloscope.
Returns
1
if a valid handle is passed,
0
if not.

PicoScope 3000 Series User Guide
13
Copyright 2005 Pico Technology Limited. All rights reserved.
PS3000044 1.4
3.3.4 ps3000_close_unit
short ps3000_close_unit
(short handle)
Shuts down a
PicoScope 3000 Series
PC Oscilloscope.
Arguments
handle
, the handle, returned by
ps3000_open_unit
, of the
oscilloscope
being closed.
Returns
1
if a valid handle is passed,
0
if not.

Technical reference 14
Copyright 2005 Pico Technology Limited. All rights reserved. PS3000044 1.4
3.3.5 ps3000_set_channel
short ps3000_set_channel (
short
handle,
short
channel,
short
enabled,
short
dc,
short
range )
Specifies if a is to be enabled, the position of the
AC\DC switch and the input range.
Arguments
handle
, the handle to the required device.
channel
, an enumerated type, use PS3000_CHANNEL_A (0),
PS3000_CHANNEL_B (1), PS3000_CHANNEL_C (2) or
PS3000_CHANNEL_D (3). Channels C and D are not available on all
models.
enabled
, specify if the channel is active: TRUE=active,
FALSE=inactive.
dc
, specifies the position of the AC/DC switch: TRUE=DC, FALSE=AC.
range
, a code between 0 and 12. See the table below.
Returns
0
if unsuccessful, or if one or more of the arguments are out of range.
1
if successful.
Code
Enumeration
Range
0
PS3000_10MV
±10 mV
Not available on all variants.
1
PS3000_20MV
±20 mV
Not available on all variants..
2
PS3000_50MV
±50 mV
Not available on all variants.
3
PS3000_100MV
±100 mV
4
PS3000_200MV
±200 mV
5
PS3000_500MV
±500 mV
6
PS3000_1V
±1 V
7
PS3000_2V
±2 V
8
PS3000_5V
±5 V
9
PS3000_10V
±10 V
10
PS3000_20V
±20 V
11
PS3000_50V
±50 V
Not available on all variants.

PicoScope 3000 Series User Guide
15
Copyright 2005 Pico Technology Limited. All rights reserved.
PS3000044 1.4
3.3.6 ps3000_get_timebase
short ps3000_get_timebase (
short
handle,
short
timebase,
long
no_of_samples,
long
* time_interval_ns,
short
* time_units,
short
oversample,
long
* max_samples)
This function discovers which
timebases are available on the oscilloscope. This function
should be called after channel and
ETS options have been set.
Arguments
handle
, the handle to the required device.
timebase
, a code between 0 and the maximum timebase (dependant
on variant). Timebase 0 is the fastest timebase, timebase 1 is twice the
time per sample as timebase 0, timebase 2 is four times, etc.
no_of_samples
, the number of samples required. This value is used
to calculate the most suitable time unit to use.
time_interval_ns
, a pointer to the time interval, in ns, between
readings at the selected timebase. If a null pointer is passed, nothing will
be written here.
time_units
, a pointer to the most suitable time units to return data in,
when calling
ps3000_get_times_and_values
. If a null pointer is passed,
nothing will be written here.
oversample
, the amount of oversample required. An oversample of 4
would quadruple the time interval and quarter the maximum samples. At
the same time it would increase the effective resolution by the amount
given by the equation below:
Increase in resolution (bits) = ( log oversample ) / ( 2 log 2 )
max_samples
, A pointer to the maximum samples available. The
maximum samples may vary depending on the number of channels
enabled, the timebase chosen and the oversample selected. If this
pointer is null, nothing would be written here.
Returns
1
if all parameters are in range, otherwise
0
.

Technical reference 16
Copyright 2005 Pico Technology Limited. All rights reserved. PS3000044 1.4
3.3.7 ps3000_set_siggen
long ps3000_set_siggen (
short
handle,
short
wave_type,
long
start_frequency,
long
stop_frequency,
float
increment,
short
dwell_time,
short
repeat,
short
dual_slope)
This function is used to enable or disable the
signal generator
and sweep functions.
Sweep functions are not available if the oscilloscope is in
streaming mode
.
The signal generator is available only on the PicoScope 3204/5/6 PC Oscilloscope
variants. See remarks and
specifications
for more information.

PicoScope 3000 Series User Guide
17
Copyright 2005 Pico Technology Limited. All rights reserved.
PS3000044 1.4
Arguments
handle
, the handle of the required device.
wave_type
, the type of wave. Choose
PS3000_SQUARE (0),
PS3000_TRIANGLE (1)
or
PS3000_SINE (2)
.
This argument has no
effect if used with the PicoScope 3204 variant.
start_frequency
, the required frequency, in the range 0 < freq < 1
MHz, to start the sweep or the frequency generated in a non-sweep
mode.
0
switches the signal generator off.
stop_frequency
, the required stop frequency of the sweep, in the
range 0 < freq < 1 MHz but not necessarily greater than
start_frequency
. If the start and stop frequencies are the same, the
signal generator will be run with a constant frequency.
This argument
has no effect if used with the PicoScope 3204 variant..
increment
, the size of the steps to increment or decrement the
frequency by in a sweep mode. This must always be positive; the start
and stop frequencies will determine whether to increment or decrement.
This must be a frequency in the range 0.1 Hz <
increment
<
|
stop_frequency
-
start_frequency
|. This is not used in a non-
sweep mode.
T
his argument has no effect if used with the PicoScope
3204 variant..
dwell_time
, This is the time, in ms, to wait before increasing the
frequency by
increment
in a sweep mode. This is unused in a non-
sweep mode.
This argument has no effect if used with the PicoScope
3204 variant..
repeat
,
TRUE
restarts the sweep when the
stop_frequency
is
reached,
FALSE
continues indefinitely at
stop_frequency
when it is
reached.
This argument has no effect if used with the PicoScope 3204
variant..
dual_slope
, if repeat is
TRUE
this specifies what to do at the
stop_frequency
.
TRUE
will sweep back towards the
start_frequency
,
FALSE
will restart the sweep from
start_frequency
.
This argument has no effect if used with the
PicoScope 3204 variant..
Returns
The actual frequency or start frequency, in hertz, that is generated. Zero
if one of the parameters are not in range.
Remarks
The PicoScope 3204 variant has a simple 1 kHz square wave signal generator for scope
probe calibration. With this variant, therefore, only two arguments of this function have
any effect:
To switch the square wave on, use a valid
handle
and set
start_frequency
to a non-
zero value. To switch the square wave off, use a valid
handle
and set
start_frequency
to
0
.

Technical reference 18
Copyright 2005 Pico Technology Limited. All rights reserved. PS3000044 1.4
3.3.8 ps3000_set_ets
long ps3000_set_ets (
short
handle,
short
mode,
short
ets_cycles,
short
ets_interleave)
This function is used to enable or disable
ETS
(equivalent time sampling) and to set the
ETS parameters.
Note: The 3224 and 3424 variants do not have an ETS mode.
Arguments
handle
, the handle to the required device.
mode
,
PS3000_ETS_OFF
(
0
) - disables ETS,
PS3000_ETS_FAST
(
1
) -
enable ETS and provides ets_cycles of data, which may contain data
from previously returned cycles,
PS3000_ETS_SLOW
(
2
) - enable ETS
and provide fresh data every
ets_cycles
cycles.
PS3000_ETS_SLOW
takes longer to provide each data set, but the data sets are more stable
and unique.
ets_cycles
, Specifies the number of cycles to store: the computer can
then select
ets_interleave
cycles to give the most uniform spread of
samples.
ets_cycles
should be between two and five times the value
of
ets_interleave
.
ets_interleave
, Specifies the number of ETS interleaves to use. If
the sample time is 20 ns and the interleave 10, the approximate time per
sample will be 2 ns.
Returns
If ETS is enabled, the effective sample time will be returned.
Zero if ETS is disabled or one of the parameters is out of range.

PicoScope 3000 Series User Guide
19
Copyright 2005 Pico Technology Limited. All rights reserved.
PS3000044 1.4
3.3.9 ps3000_set_trigger
short ps3000_set_trigger (
short
handle,
short
source,
short
threshold,
short
direction,
short
delay,
short
auto_trigger_ms)
This function is used to enable or disable triggering and its parameters. Triggering is not
available in
streaming mode
.
Arguments
handle
, the handle to the required device.
source
, specifies where to look for a trigger. Use
PS3000_CHANNEL_A
(
0
),
PS3000_CHANNEL_B
(
1
),
PS3000_CHANNEL_C
(
2
),
PS3000_CHANNEL_D
(
3
),
PS3000_EXTERNAL
(
4
) or
PS3000_NONE
(
5
).
Channels C, D and External are not available on all models.
threshold
, the threshold for the trigger event. This is scaled in 16-bit
ADC counts at the currently selected range. If an external trigger is
enabled the range is fixed at +/-20V.
direction
, use
PS3000_RISING
(
0
) or
PS3000_FALLING
(
1
).
delay
, This specifies the delay, as a percentage of the requested
number of data points, between the trigger event and the start of the
block. It should be in the range -100% to +100%. Thus, 0% means that
the first data value in the block, and -50% means that the trigger event
is in the middle of the block.
auto_trigger_ms
, the delay in ms after which the
o
scilloscope will
collect samples if no trigger event occurs. If this is set to zero the
oscilloscope
will wait for a trigger indefinitely.
Returns
0
if one of the parameters are out of range, otherwise
1
.