Programmer's Guide
ps6000pg.en-11
PC Oscilloscopes
PicoScope
®
6000 Series
PicoScope 6000 Series Programmer's Guide Contents
3Copyright © 2009–2022 Pico Technology Ltd. All rights reserved.ps6000pg.en-11
Contents
1 Introduction .............................................................................................................................. 7
1 Welcome ............................................................................................................................................................................ 7
2 Software license conditions ......................................................................................................................................... 8
3 Trademarks ....................................................................................................................................................................... 8
2 Programming overview ........................................................................................................... 9
1 System requirements ..................................................................................................................................................... 9
2 Driver ................................................................................................................................................................................ 10
3 Voltage ranges ............................................................................................................................................................... 10
4 Triggering ........................................................................................................................................................................ 10
5 Sampling modes ............................................................................................................................................................ 11
1 Block mode ....................................................................................................................................................... 12
2 Rapid block mode ............................................................................................................................................ 14
3 ETS (Equivalent Time Sampling) ................................................................................................................. 19
4 Streaming mode .............................................................................................................................................. 21
5 Retrieving stored data .................................................................................................................................... 22
6 Oversampling ................................................................................................................................................................. 24
7 Timebases ...................................................................................................................................................................... 24
8 Combining several oscilloscopes ............................................................................................................................. 25
3 API functions ......................................................................................................................... 26
1 ps6000BlockReady ....................................................................................................................................................... 27
2 ps6000CloseUnit ........................................................................................................................................................... 28
3 ps6000DataReady ......................................................................................................................................................... 29
4 ps6000EnumerateUnits ............................................................................................................................................... 30
5 ps6000FlashLed ............................................................................................................................................................ 31
6 ps6000GetAnalogueOffset ......................................................................................................................................... 32
7 ps6000GetMaxDownSampleRatio ............................................................................................................................ 33
8 ps6000GetNoOfCaptures ............................................................................................................................................ 34
9 ps6000GetNoOfProcessedCaptures ....................................................................................................................... 35
10 ps6000GetStreamingLatestValues ........................................................................................................................ 36
11 ps6000GetTimebase ................................................................................................................................................. 37
12 ps6000GetTimebase2 ............................................................................................................................................... 39
13 ps6000GetTriggerTimeOffset ................................................................................................................................. 40
14 ps6000GetTriggerTimeOffset64 ............................................................................................................................ 41
15 ps6000GetUnitInfo ..................................................................................................................................................... 42
16 ps6000GetValues ....................................................................................................................................................... 43
1 Downsampling modes ................................................................................................................................... 44
17 ps6000GetValuesAsync ............................................................................................................................................ 45
18 ps6000GetValuesBulk ............................................................................................................................................... 46
19 ps6000GetValuesBulkAsync ................................................................................................................................... 47
PicoScope 6000 Series Programmer's Guide Contents
4Copyright © 2009–2022 Pico Technology Ltd. All rights reserved.ps6000pg.en-11
20 ps6000GetValuesOverlapped .................................................................................................................................. 48
1 Using the GetValuesOverlapped functions ............................................................................................... 48
21 ps6000GetValuesOverlappedBulk .......................................................................................................................... 50
22 ps6000GetValuesTriggerTimeOffsetBulk ............................................................................................................ 51
23 ps6000GetValuesTriggerTimeOffsetBulk64 ....................................................................................................... 52
24 ps6000IsReady ............................................................................................................................................................ 53
25 ps6000IsTriggerOrPulseWidthQualifierEnabled ................................................................................................. 54
26 ps6000MemorySegments ........................................................................................................................................ 55
27 ps6000NoOfStreamingValues ................................................................................................................................. 56
28 ps6000OpenUnit .......................................................................................................................................................... 57
29 ps6000OpenUnitAsync .............................................................................................................................................. 58
30 ps6000OpenUnitProgress ......................................................................................................................................... 59
31 ps6000PingUnit ........................................................................................................................................................... 60
32 ps6000RunBlock ......................................................................................................................................................... 61
33 ps6000RunStreaming ................................................................................................................................................ 63
34 ps6000SetChannel ..................................................................................................................................................... 65
35 ps6000SetDataBuffer ................................................................................................................................................ 68
36 ps6000SetDataBufferBulk ....................................................................................................................................... 69
37 ps6000SetDataBuffers ............................................................................................................................................. 70
38 ps6000SetDataBuffersBulk ..................................................................................................................................... 71
39 ps6000SetEts ............................................................................................................................................................... 72
40 ps6000SetEtsTimeBuffer ......................................................................................................................................... 73
41 ps6000SetEtsTimeBuffers ....................................................................................................................................... 74
42 ps6000SetExternalClock ........................................................................................................................................... 75
43 ps6000SetNoOfCaptures .......................................................................................................................................... 76
44 ps6000SetPulseWidthQualifier ............................................................................................................................... 77
1 PS6000_PWQ_CONDITIONS structure ..................................................................................................... 79
45 ps6000SetSigGenArbitrary ....................................................................................................................................... 80
1 Calculating deltaPhase .................................................................................................................................. 82
2 Index modes ..................................................................................................................................................... 82
46 ps6000SetSigGenBuiltIn ........................................................................................................................................... 84
47 ps6000SetSigGenBuiltInV2 ...................................................................................................................................... 87
48 ps6000SetSimpleTrigger .......................................................................................................................................... 88
49 ps6000SetTriggerChannelConditions .................................................................................................................... 89
1 PS6000_TRIGGER_CONDITIONS structure ............................................................................................. 90
50 ps6000SetTriggerChannelDirections ..................................................................................................................... 91
51 ps6000SetTriggerChannelProperties ..................................................................................................................... 92
1 TRIGGER_CHANNEL_PROPERTIES structure .......................................................................................... 93
52 ps6000SetTriggerDelay ............................................................................................................................................. 94
53 ps6000SigGenArbitraryMinMaxValues .................................................................................................................. 95
54 ps6000SigGenFrequencyToPhase ......................................................................................................................... 96
55 ps6000SigGenSoftwareControl ............................................................................................................................... 97
56 ps6000Stop .................................................................................................................................................................. 98
PicoScope 6000 Series Programmer's Guide Contents
5Copyright © 2009–2022 Pico Technology Ltd. All rights reserved.ps6000pg.en-11
57 ps6000StreamingReady ............................................................................................................................................ 99
58 Wrapper functions .................................................................................................................................................... 100
4 Programming support and examples .............................................................................. 102
5 Numeric data types ............................................................................................................. 103
6 Enumerated types and constants ..................................................................................... 104
7 Driver status codes ............................................................................................................. 105
8 Glossary ............................................................................................................................... 106
Index ......................................................................................................................................... 107
