PICO PicoScope 3204 MSO Скачать руководство пользователя страница 28 | Manualshive

Страница: 28 / 144

PICO PicoScope 3204 MSO Скачать руководство пользователя страница 28

Prog ramming the 3000A Series oscilloscopes

22

Copyright © 2011-2013 Pico Technology Limited. All rights reserved.

ps3000abpg.en r9

2.12

API functions

The PicoScope 3000A API exports the following functions for you to use in your own
applications. All functions are C functions using the standard call naming convention
(

__stdcall

). They are all exported with both decorated and undecorated names. An

additional set of

wrapper functions

is provided for use with programming languages that

do not support callbacks.

ps3000aBlockReady

indicate when block-mode data ready

ps3000aChangePowerSource

configure the unit's power source

ps3000aCloseUnit

close a scope device

ps3000aCurrentPowerSource

indicate the current power state of the device

ps3000aDataReady

indicate when post-collection data ready

ps3000aEnumerateUnits

find all connected oscilloscopes

ps3000aFlashLed

flash the front-panel LED

ps3000aGetAnalogueOffset

query the permitted analog offset range

ps3000aGetChannelInformation

query which ranges are available on a device

ps3000aGetMaxDownSampleRatio

query the aggregation ratio for data

ps3000aGetMaxSegments

query the maximum number of segments

ps3000aGetNoOfCaptures

find out how many captures are available

ps3000aGetNoOfProcessedCaptures

query number of captures processed

ps3000aGetStreamingLatestValues

get streaming data while scope is running

ps3000aGetTimebase

find out what timebases are available

ps3000aGetTimebase2

find out what timebases are available

ps3000aGetTriggerTimeOffset

find out when trigger occurred (32-bit)

ps3000aGetTriggerTimeOffset64

find out when trigger occurred (64-bit)

ps3000aGetUnitInfo

read information about scope device

ps3000aGetValues

retrieve block-mode data with callback

ps3000aGetValuesAsync

retrieve streaming data with callback

ps3000aGetValuesBulk

retrieve data in rapid block mode

ps3000aGetValuesOverlapped

set up data collection ahead of capture

ps3000aGetValuesOverlappedBulk

set up data collection in rapid block mode

ps3000aGetValuesTriggerTimeOffsetBulk

get rapid-block waveform timings (32-bit)

ps3000aGetValuesTriggerTimeOffsetBulk64

get rapid-block waveform timings (64-bit)

poll driver in block mode

ps3000aIsTriggerOrPulseWidthQualifierEnable

find out whether trigger is enabled

ps3000aMaximumValue

query the max. ADC count in GetValues calls

ps3000aMemorySegments

divide scope memory into segments

ps3000aMinimumValue

query the min. ADC count in GetValues calls

ps3000aNoOfStreamingValues

get number of samples in streaming mode

ps3000aOpenUnit

open a scope device

ps3000aOpenUnitAsync

open a scope device without waiting

ps3000aOpenUnitProgress

check progress of OpenUnit call

ps3000aPingUnit

check communication with device

ps3000aRunBlock

start block mode

ps3000aRunStreaming

start streaming mode

ps3000aSetBandwidthFilter

control the bandwidth limiter

ps3000aSetChannel

set up input channels

ps3000aSetDataBuffer

register data buffer with driver

ps3000aSetDataBuffers

register aggregated data buffers with driver

ps3000aSetDigitalPort

enable the digital port and set the logic level

set up equivalent-time sampling

ps3000aSetEtsTimeBuffer

set up buffer for ETS timings (64-bit)

ps3000aSetEtsTimeBuffers

set up buffer for ETS timings (32-bit)

ps3000aSetNoOfCaptures

set number of captures to collect in one run

ps3000aSetPulseWidthQualifier

set up pulse width triggering

ps3000aSetPulseWidthQualifierV2

set up pulse width triggering (digital
condition)

ps3000aSetSigGenArbitrary

set up arbitrary waveform generator

ps3000aSetSigGenBuiltIn

set up standard signal generator

ps3000aSetSimpleTrigger

set up level triggers only

ps3000aSetTriggerChannelConditions

specify which channels to trigger on

ps3000aSetTriggerChannelConditionsV2

specify trigger channels for

ps3000aSetTriggerChannelDirections

set up signal polarities for triggering

ps3000aSetTriggerChannelProperties

set up trigger thresholds

ps3000aSetTriggerDelay

set up post-trigger delay

ps3000aSetTriggerDigitalPortProperties

set individual digital channels trigger
directions

«
...
26
27
28
29
30
...
»

Содержание PicoScope 3204 MSO

Страница 1: ...Copyright 2011 2013Pico Technology Limited All rights reserved PicoScope 3000A Series Programmer s Guide ps3000abpg en r9 PC Oscilloscopes and MSOs...

Страница 2: ......

Страница 3: ...11 Combining several oscilloscopes 22 12 API functions 24 1 ps3000aBlockReady callback 25 2 ps3000aChangePowerSource 26 3 ps3000aCurrentPowerSource 27 4 ps3000aCloseUnit 28 5 ps3000aDataReady callback...

Страница 4: ...47 ps3000aSetNoOfCaptures 77 48 ps3000aSetPulseWidthQualifier 80 49 ps3000aSetPulseWidthQualifierV2 83 50 ps3000aSetSigGenArbitrary 87 51 ps3000aSetSigGenBuiltIn 90 52 ps3000aSetSimpleTrigger 91 53 p...

Страница 5: ...III PicoScope 3000A Series Programmer s Guide Copyright 2011 2013 Pico Technology Limited All rights reserved ps3000abpg en r9 129 17 Numeric data types 130 3Glossary 133 Index...

Страница 6: ......

Страница 7: ...PI application program m ing interface functions so that you can develop your own program s to collect and analyse data from the oscilloscope The inform ation in this m anual applies to the following...

Страница 8: ...lated to the use of Pico equipm ent or software unless excluded by statute Fitness for purpose No two applications are the sam e so Pico cannot guarantee that its equipm ent or software is suitable fo...

Страница 9: ...ails You can obtain technical assistance from Pico Technology at the following address Address Pico Technology Jam es House Colm worth Business Park St Neots Cam bridgeshire PE19 8YP United Kingdom Ph...

Страница 10: ...of the driver software in each of the m odes available 2 1 PicoScope 3000A Series driver Your application will com m unicate with a PicoScope 3000A Series driver called ps3000a dll This driver is used...

Страница 11: ...Windows 1 GHz 1 GHz Memory 512 MB 512 MB Free disk space 32 bit 600 MB 64 bit 1 5 GB 2 GB Ports USB 1 1 port USB 2 0 port USB 2 0 scopes USB 3 0 port USB 3 0 scopes The PicoScope software does not us...

Страница 12: ...for a trigger event to occur In both cases you need to use the trigger function ps3000aSetSimpleTrigger which in turn calls ps3000aSetTriggerChannelConditions ps3000aSetTriggerChannelDirections and ps...

Страница 13: ...ion for chart recorder and data logging applications Stream ing m ode supports downsam pling and triggering while providing fast stream ing at up these rates with a USB 2 0 port USB 3 0 devices m ay b...

Страница 14: ...3000A Series oscilloscope can sam ple at a num ber of different rates according to the selected tim ebase and the com bination of channels that are enabled See the PicoScope 3000 Series User s Guide f...

Страница 15: ...gerDigitalPortProperties to set up the digital trigger if required 7 Start the oscilloscope running using ps3000aRunBlock 8 Wait until the oscilloscope is ready using the ps3000aBlockReady callback or...

Страница 16: ...tim ebases until the required nanoseconds per sam ple is located 5 Use the trigger setup functions ps3000aSetTriggerChannelConditionsV2 ps3000aSetTriggerChannelDirections and ps3000aSetTriggerChannelP...

Страница 17: ...amples 10000 noOfPostTriggerSamples 1 timebase to be used 1 not used timeIndisposedMs 1 segment index lpReady pParameter Com m ent these variables have been set as an exam ple and can be any valid val...

Страница 18: ...values set in ps3000aRunBlock The sam ples are always returned from the first sam ple taken unlike the ps3000aGetValues function which allows the sam ple index to be set The above segm ents start at 1...

Страница 19: ...PreTriggerSamples 1000000 noOfPostTriggerSamples 1 timebase to be used 1 not used timeIndisposedMs 1 segment index lpReady pParameter Com m ents the set up for running the device is exactly the sam e...

Страница 20: ...ps3000abpg en r9 ps3000aGetValues handle 0 noOfSamples set to MAX_SAMPLES on entering 1000 downSampleRatioMode set to RATIO_MODE_AGGREGATE index overflow ps3000aGetTriggerTimeOffset64 handle time tim...

Страница 21: ...that the sam ples occur at slightly different tim es relative to those of the previous capture The result is a larger set of sam ples spaced by a sm all fraction of the original sam pling interval Th...

Страница 22: ...upling using ps3000aSetChannel 3 Using ps3000aGetTim ebase select tim ebases until the required nanoseconds per sam ple is located 4 Use the trigger setup functions ps3000aSetTriggerChannelConditionsV...

Страница 23: ...See Using stream ing m ode for program m ing details 2 7 4 1 Using streaming mode This is the general procedure for reading and displaying data in stream ing m ode using a single m em ory segm ent 1 O...

Страница 24: ...l rights reserved ps3000abpg en r9 2 7 5 Retrieving stored data You can collect data from the PicoScope 3000A driver with a different downsam pling factor when ps3000aRunBlock or ps3000aRunStream ing...

Страница 25: ...l PicoScope 3000A 2 Channel USB 2 0 Oscilloscopes timebase sample interval formula sample interval examples 0 to 2 2timebase 500 000 000 0 2 ns 1 4 ns 2 8 ns 3 to 232 1 tim ebase 2 62 500 000 3 16 ns...

Страница 26: ...oscilloscope is in operation the oscilloscope will restart autom atically and any unsaved data will be lost 2 channel USB 3 0 oscilloscopes The PicoScope 3207A and 3207B oscilloscopes also have two m...

Страница 27: ...nctions require this handle for oscilloscope identification For exam ple to collect data from two oscilloscopes at the sam e tim e CALLBACK ps3000aBlockReady define callback function specific to appli...

Страница 28: ...esOverlappedBulk set up data collection in rapid block mode ps3000aGetValuesTriggerTimeOffsetBulk get rapid block waveform timings 32 bit ps3000aGetValuesTriggerTimeOffsetBulk64 get rapid block wavefo...

Страница 29: ...ide 23 Copyright 2011 2013 Pico Technology Limited All rights reserved ps3000abpg en r9 ps3000aSigGenSoftwareControl trigger the signal generator ps3000aStop stop data capture ps3000aStreamingReady in...

Страница 30: ...oScope 3000A series driver using ps3000aRunBlock and the driver calls it back when block m ode data is ready You can then download the data using the ps3000aGetValues function Applicability Block m od...

Страница 31: ...er is required the AC power adapter is connected or disconnected during use a USB 3 0 scope is plugged into a USB 2 0 port indicated if any function returns the PICO_USB3_0_DEVICE_NON_USB3_0_PORT stat...

Страница 32: ...PICO_STATUS ps3000aCurrentPowerSource short handle This function returns the current power state of the device Applicability All m odes 4 channel oscilloscopes only Arguments handle the handle of the...

Страница 33: ...en r9 2 12 4 ps3000aCloseUnit PICO_STATUS ps3000aCloseUnit short handle This function shuts down a PicoScope 3000A oscilloscope Applicability All m odes Arguments handle the handle returned by ps3000...

Страница 34: ...the driver calls your function back when the data is ready Applicability All m odes Arguments handle the handle of the device returning the sam ples status a PICO_STATUS code returned by the driver n...

Страница 35: ...as a string Applicability All m odes Arguments count on exit the num ber of PicoScope 3000A units found serials on exit a list of serial num bers separated by com m as and term inated by a final null...

Страница 36: ...ancel any flashing started by this function It is not possible to set the LED to be constantly illum inated as this state is used to indicate that the scope has not been initialized Applicability All...

Страница 37: ...odels Arguments handle the value returned from opening the device range the voltage range to be used when gathering the m in and m ax inform ation coupling the type of AC DC coupling used maximumVolta...

Страница 38: ...e required device info the type of inform ation required The following value is currently supported PS3000A_CI_RANGES probe not used m ust be set to 0 ranges an array that will be populated with avail...

Страница 39: ...am pling ratio that can be used for a given num ber of sam ples in a given downsam pling m ode Applicability All m odes Arguments handle the handle of the required device noOfUnaggregatedSamples the n...

Страница 40: ...andle unsigned short maxsegments This function returns the m axim um num ber of segm ents allowed for the opened device Refer to ps3000aMem orySegm ents for specific figures Applicability All m odes A...

Страница 41: ...rupted by calling ps3000aStop The returned value nCaptures can then be used to iterate through the num ber of segm ents using ps3000aGetValues or in a single call to ps3000aGetValuesBulk where it is u...

Страница 42: ...of waveform s was interrupted by calling ps3000aStop The returned value nCaptures can then be used to iterate through the num ber of segm ents using ps3000aGetValues or in a single call to ps3000aGetV...

Страница 43: ...eviously called ps3000aRunStream ing beforehand to set up stream ing Applicability Stream ing m ode only Arguments handle the handle of the required device lpPs3000AReady a pointer to your ps3000aStre...

Страница 44: ...ps3000aGetTim ebase2 first estim ate the tim ebase num ber that you require using the inform ation in the tim ebase guide Next call one of these functions with the tim ebase that you have just chosen...

Страница 45: ...hort segmentIndex This function is an upgraded version of ps3000aGetTim ebase and returns the tim e interval as a float rather than a long This allows it to return sub nanosecond tim e intervals See p...

Страница 46: ...ggerTim eOffset64 is also available Applicability Block m ode rapid block m ode Arguments handle the handle of the required device timeUpper on exit the upper 32 bits of the tim e at which the trigger...

Страница 47: ...ture A 32 bit version of this function ps3000aGetTriggerTim eOffset is also available Applicability Block m ode rapid block m ode Arguments handle the handle of the required device time on exit the ti...

Страница 48: ...lity All m odes Arguments handle the handle of the device to query If an invalid handle is passed only the driver versions can be read string on exit the inform ation string selected specified by the...

Страница 49: ...device 1 1 2 0 or 3 0 2 0 2 PICO_HARDWARE_VERSION Hardware version of device 1 3 PICO_VARIANT_INFO Variant num ber of device 3206B 4 PICO_BATCH_AND_SERIAL Batch and serial num ber of device KJL87 6 5...

Страница 50: ...s m easured in sam ple intervals from the start of the buffer noOfSamples on entry the num ber of sam ples required On exit the actual num ber retrieved The num ber of sam ples retrieved will not be m...

Страница 51: ...on or downsampling are possible with the PicoScope 3000A Series oscilloscopes The downsam pling is done at high speed by dedicated hardware inside the scope m aking your application faster and m ore r...

Страница 52: ...the handle of the required device startIndex see ps3000aGetValues noOfSamples see ps3000aGetValues downSampleRatio see ps3000aGetValues downSampleRatioMode see ps3000aGetValues segmentIndex see ps300...

Страница 53: ...s with the first sam ple captured fromSegmentIndex the first segm ent from which the waveform should be retrieved toSegmentIndex the last segm ent from which the waveform should be retrieved downSampl...

Страница 54: ...call ps3000aRunBlock com pared with the two contacts that occur when you use the conventional ps3000aRunBlock ps3000aGetValues calling sequence This slightly reduces the dead tim e between successive...

Страница 55: ...000aRunBlock com pared with the two contacts that occur when you use the conventional ps3000aRunBlock ps3000aGetValuesBulk calling sequence This slightly reduces the dead tim e between successive capt...

Страница 56: ...r unsigned long timesLower PS3000A_TIME_UNITS timeUnits unsigned short fromSegmentIndex unsigned short toSegmentIndex This function retrieves the tim e offsets as lower and upper 32 bit values for wav...

Страница 57: ...oSegmentIndex tim e offset The array size m ust be long enough to hold the num ber of requested tim es timeUnits an array of integers The array m ust be long enough to hold the num ber of requested ti...

Страница 58: ...e tim e offset for toSegmentIndex The array m ust be long enough to hold the num ber of tim es requested timeUnits an array of integers long enough to hold the num ber of requested tim es timeUnits 0...

Страница 59: ...the lpReady argum ent to ps3000aRunBlock You m ust then poll the driver to see if it has finished collecting the requested sam ples Applicability Block m ode Arguments handle the handle of the requir...

Страница 60: ...er ps3000aRunBlock or ps3000aRunStream ing Arguments handle the handle of the required device triggerEnabled on exit indicates whether the trigger will successfully be set when ps3000aRunBlock or ps30...

Страница 61: ...000aMaximumValue short handle short value This function returns the m axim um ADC count returned by calls to get values Applicability All m odes Arguments handle the handle of the required device valu...

Страница 62: ...ll m odes Arguments handle the handle of the required device nSegments the num ber of segm ents required from 1 to 16 384 PicoScope 3204A PicoScope 3404A 32 768 PicoScope 3204B PicoScope 3204 MSO Pico...

Страница 63: ...000aMinimumValue short handle short value This function returns the m inim um ADC count returned by calls to get values Applicability All m odes Arguments handle the handle of the required device valu...

Страница 64: ...le unsigned long noOfValues This function returns the num ber of sam ples available after data collection in stream ing m ode Call it after calling ps3000aStop Applicability Stream ing m ode Arguments...

Страница 65: ...the scope fails to open 0 if no scope is found 0 a num ber that uniquely identifies the scope If a valid handle is returned it m ust be used in all subsequent calls to API functions to identify this s...

Страница 66: ...t blocking the calling thread You can find out when it has finished by periodically calling ps3000aOpenUnitProgress until that function returns a non zero value Applicability All m odes Arguments stat...

Страница 67: ...checks on the progress of a request m ade to ps3000aOpenUnitAsync to open a scope Applicability Use after ps3000aOpenUnitAsync Arguments handle see ps3000aOpenUnit This handle is valid only if the fun...

Страница 68: ...nit short handle This function can be used to check that the already opened device is still connected to the USB port and com m unication is successful Applicability All m odes Arguments handle the ha...

Страница 69: ...s been set then this argum ent is ignored and noOfPostTriggerSamples specifies the m axim um num ber of sam ples to collect noOfPostTriggerSamples the num ber of sam ples to be taken after a trigger e...

Страница 70: ...FERS_NOT_SET in overlapped m ode PICO_INVALID_HANDLE PICO_USER_CALLBACK PICO_SEGMENT_OUT_OF_RANGE PICO_INVALID_CHANNEL PICO_INVALID_TRIGGER_CHANNEL PICO_INVALID_CONDITION_CHANNEL PICO_TOO_MANY_SAMPLES...

Страница 71: ...s the sum of maxPreTriggerSamples and maxPostTriggerSamples If autoStop is false then this will becom e the m axim um num ber of sam ples without downsam pling Applicability Stream ing m ode Arguments...

Страница 72: ...returning it to the application The size is the sam e as the bufferLth value passed to ps3000aSetDataBuffer Returns PICO_OK PICO_INVALID_HANDLE PICO_ETS_MODE_SET PICO_USER_CALLBACK PICO_NULL_PARAMETE...

Страница 73: ...ction specifies the bandwidth lim it Applicability All m odes 4 channel oscilloscopes only Arguments handle the handle of the required device channel the channel to be configured The values are PS3000...

Страница 74: ...e the channel TRUE or FALSE type the im pedance and coupling type The values are PS3000A_AC 1 m egohm im pedance AC coupling The channel accepts input frequencies from about 1 hertz up to its m axim u...

Страница 75: ...Arguments handle the handle of the required device channel the channel you want to use with the buffer Use one of these values PS3000A_CHANNEL_A PS3000A_CHANNEL_B PS3000A_CHANNEL_C PS3000A_CHANNEL_D T...

Страница 76: ...th aggregation Arguments handle the handle of the required device channel the channel for which you want to set the buffers Use one of these constants PS3000A_CHANNEL_A PS3000A_CHANNEL_B PS3000A_CHANN...

Страница 77: ...o 1 Applicability Block and stream ing m odes with aggregation Arguments handle the handle of the required device port identifies the port PS3000A_DIGITAL_PORT0 0x80 digital channels 0 7 PS3000A_DIGIT...

Страница 78: ...longer to provide each data set but the data sets are m ore stable and are guaranteed to contain only new data etsCycles the num ber of cycles to store the com puter then selects etsInterleave cycles...

Страница 79: ...PicoScope 3000A Series Programmer s Guide 73 Copyright 2011 2013 Pico Technology Limited All rights reserved ps3000abpg en r9 PICO_DRIVER_FUNCTION...

Страница 80: ...ffers contain the 64 bit tim ing inform ation for each ETS sam ple after you run a block m ode ETS capture Applicability ETS m ode only If your program m ing language does not support 64 bit data use...

Страница 81: ...32 bit parts of the tim ing inform ation to allow program m ing languages that do not support 64 bit data to retrieve the tim ings Applicability ETS m ode only If your program m ing language supports...

Страница 82: ...sets the num ber of captures to be collected in one run of rapid block m ode If you do not call this function before a run the driver will capture only one waveform Once a value has been set the value...

Страница 83: ...elem ent When there are several elem ents the overall trigger condition is the logical OR of all the elem ents If conditions is NULL then the pulse width qualifier is not used nConditions the num ber...

Страница 84: ...lower PS3000A_PW_TYPE_GREATER_THAN pulse width greater than lower PS3000A_PW_TYPE_IN_RANGE pulse width between lower and upper PS3000A_PW_TYPE_OUT_OF_RANGE pulse width not between lower and upper Retu...

Страница 85: ...structures to produce the final pulse width qualifier which can therefore be any possible Boolean function of the scope s inputs The structure is byte aligned In C for exam ple you should specify this...

Страница 86: ...gle elem ent When there are several elem ents the overall trigger condition is the logical OR of all the elem ents If conditions is NULL then the pulse width qualifier is not used nConditions the num...

Страница 87: ...NE do not use the pulse width qualifier PS3000A_PW_TYPE_LESS_THAN pulse width less than lower PS3000A_PW_TYPE_GREATER_THAN pulse width greater than lower PS3000A_PW_TYPE_IN_RANGE pulse width between l...

Страница 88: ...states of the scope s inputs The ps3000aSetPulseWidthQualifierV2 function can OR together a num ber of these structures to produce the final pulse width qualifier which can therefore be any possible B...

Страница 89: ...param eter table below that indicates the present location in the waveform The top bufferAddressW idth bits of the counter are used as an index into a buffer containing the arbitrary waveform The rem...

Страница 90: ...through the waveform buffer stopDeltaPhase the final value added to the phase accum ulator before the generator restarts or reverses the sweep deltaPhaseIncrement the am ount added to the delta phase...

Страница 91: ...age PS3000A_PRBS produces a random bitstream with a bit rate specified by the start and stop frequency indexMode specifies how the signal will be form ed from the arbitrary waveform data Single and du...

Страница 92: ...the buffer repeatedly This m ode is the only one that can generate asym m etrical waveform s You can also use this m ode for sym m etrical waveform s but the dual m ode m akes m ore efficient use of...

Страница 93: ...le the handle of the required device offsetVoltage the voltage offset in m icrovolts to be applied to the waveform pkToPk the peak to peak voltage in m icrovolts of the waveform signal Note that if th...

Страница 94: ...gnores all settings except pkToPk and offsetVoltage PS3000A_PRBS produces a random bitstream with a bit rate specified by the start and stop frequency shots 0 sweep the frequency as specified by sweep...

Страница 95: ...IGGER_RAW reserved Arguments If a trigger source other than P3000A_SIGGEN_NONE is specified then either shots or sweeps but not both m ust be non zero extInThreshold used to set trigger level for exte...

Страница 96: ...value to set the trigger source the channel on which to trigger threshold the ADC count at which the trigger will fire direction the direction in which the signal m ust m ove to cause a trigger The fo...

Страница 97: ...triggering is not required use ps3000aSetSimpleTrigger Applicability All m odes Arguments handle the handle of the required device conditions an array of PS3000A_TRIGGER_CONDITIONS structures specify...

Страница 98: ...S Each structure is the logical AND of the states of the scope s inputs The ps3000aSetTriggerChannelConditions function can OR together a num ber of these structures to produce the final trigger condi...

Страница 99: ...ND OR logic allows you to create any possible Boolean function of the scope s inputs If com plex triggering is not required use ps3000aSetSimpleTrigger Applicability All m odes Arguments handle the ha...

Страница 100: ...RIGGER_CONDITIONS_V2 Each structure is the logical AND of the states of the scope s inputs The ps3000aSetTriggerChannelConditionsV2 function can OR together a num ber of these structures to produce th...

Страница 101: ..._OK PICO_INVALID_HANDLE PICO_USER_CALLBACK PICO_INVALID_PARAMETER PS3000A_THRESHOLD_DIRECTION constants PS3000A_ABOVE for gated triggers above the upper threshold PS3000A_ABOVE_LOWER for gated trigger...

Страница 102: ...of TRIGGER_CHANNEL_PROPERTIES structures describing the requested properties The array can contain a single elem ent describing the properties of one channel or a num ber of elem ents describing seve...

Страница 103: ...e pragma pack instruction Elements thresholdUpper the upper threshold at which the trigger m ust fire This is scaled in 16 bit ADC counts at the currently selected range for that channel thresholdUppe...

Страница 104: ...ture to start a defined tim e after the trigger event Applicability All m odes Arguments handle the handle of the required device delay the tim e between the trigger occurring and the first sam ple Fo...

Страница 105: ...al channel s trigger direction is PS3000A_DIGITAL_DONT_CARE Applicability All m odes Arguments handle the handle of the required device directions a pointer to an array of PS3000A_DIGITAL_CHANNEL_DIRE...

Страница 106: ...L_5 PS3000A_DIGITAL_CHANNEL_6 PS3000A_DIGITAL_CHANNEL_7 PS3000A_DIGITAL_CHANNEL_8 PS3000A_DIGITAL_CHANNEL_9 PS3000A_DIGITAL_CHANNEL_10 PS3000A_DIGITAL_CHANNEL_11 PS3000A_DIGITAL_CHANNEL_12 PS3000A_DIG...

Страница 107: ...imited All rights reserved ps3000abpg en r9 PS3000A_DIGITAL_DIRECTION_FALLING PS3000A_DIGITAL_DIRECTION_RISING_OR_FALLING PS3000A_DIGITAL_MAX_DIRECTION PS3000A_DIGITAL_DIRECTION The structure is byte...

Страница 108: ...stops gating It is used when the signal generator is set to SIGGEN_SOFT_TRIG Applicability Use with ps3000aSetSigGenBuiltIn or ps3000aSetSigGenArbitrary Arguments handle the handle of the required de...

Страница 109: ...ps the scope device from sam pling data If this function is called before a trigger event occurs the oscilloscope m ay not contain valid data Always call this function after the end of a capture to en...

Страница 110: ...ice returning the sam ples noOfSamples the num ber of sam ples to collect startIndex an index to the first valid sam ple in the buffer This is the buffer that was previously passed to ps3000aSetDataBu...

Страница 111: ...returned in streaming mode ClearTriggerReady clears the trigger flags in streaming mode GetStreamingLatestValues returns the latest block of data in streaming mode IsReady finds out if data is ready t...

Страница 112: ...d short handle This function indicates if the device has stopped after collecting of the num ber of sam ples specified in the call to ps3000aRunStream ing This occurs only if the ps3000aRunStream ing...

Страница 113: ...icates the num ber of sam ples returned from the driver and shows the start index of the data in the buffer when collecting data in stream ing m ode Applicability Stream ing m ode Arguments handle the...

Страница 114: ...Pico Technology Limited All rights reserved ps3000abpg en r9 2 13 3 ClearTriggerReady short ClearTriggerReady void This function clears the triggered and triggeredAt flags for use with stream ing m o...

Страница 115: ...STATUS GetStreamingLatestValues short handle This function returns the next block of values to your application when capturing data in stream ing m ode Use with program m ing languages that do not sup...

Страница 116: ...y short IsReady short handle This function polls the driver to verify that stream ing data is ready to be received Applicability Stream ing m ode In block m ode we recom m end using ps3000aIsReady ins...

Страница 117: ...edAt This function indicates whether a trigger has occurred when collecting data in stream ing m ode and the location of the trigger point in the buffer Applicability Stream ing m ode Arguments handle...

Страница 118: ...rts collecting data in block m ode without the requirem ent for specifying callback functions Use the IsReady function to poll the driver once this function has been called Applicability Block m ode A...

Страница 119: ...he num ber that will be passed after the wrapper code has created its structures i e the num ber of conditionsArray elem ents divided by 7 Returns See ps3000aSetTriggerConditions return values Example...

Страница 120: ...co Technology Limited All rights reserved ps3000abpg en r9 conditionsArray 2 0 channel C conditionsArray 3 0 channel D conditionsArray 4 0 external conditionsArray 5 0 aux conditionsArray 6 0 pulse wi...

Страница 121: ...RIGGER_CHANNEL_PROPERTIES structures describing the required properties to be set See also channelProperties in ps3000aSetTriggerChannelProperties nProperties the num ber that will be passed after the...

Страница 122: ...ries oscilloscopes 116 Copyright 2011 2013 Pico Technology Limited All rights reserved ps3000abpg en r9 3 ChD propertiesArray 11 0 thresholdMode Level 0 Window 1 status SetTriggerProperties handle pro...

Страница 123: ...n directory ps3000aApi h picoStatus h and the following file m ust be in the sam e directory as the executable ps3000a dll 2 14 2 C The following files are required AssemblyInfo cs PS3000ACSConsole cs...

Страница 124: ...TriggerChannelDirectionsV2 ps3000aSetTriggerChannelProperties ps3000aSetTriggerDigitalPortProperties ps3000aSetPulseWidthQualifier ps3000aSetTriggerDelay PicoScope3000aAWG vi controls the arbitrary wa...

Страница 125: ...rs Advanced triggers can be set up using PicoScope3000aAdvancedTriggerSettings vi PicoScope3000aStartStreaming vi starts the oscilloscope stream ing It outputs arrays that will contain sam ples once P...

Страница 126: ...upt or is m issing 09 PICO_KERNEL_DRIVER_TOO_OLD The picopp sys file is too old to be used with the device driver 0A PICO_EEPROM_CORRUPT The EEPROM has becom e corrupt so the device will use a default...

Страница 127: ...etails are incorrect 22 PICO_CONDITIONS One or m ore of the conditions are incorrect 23 PICO_USER_CALLBACK The driver s thread is currently in the ps3000a Ready callback function and therefore the act...

Страница 128: ...aggregation ratio requested is out of range 41 PICO_INVALID_STATE Device is in an invalid state 42 PICO_NOT_ENOUGH_SEGMENTS The num ber of segm ents allocated is fewer than the num ber of captures re...

Страница 129: ...here are no captures available and therefore no data can be returned 5E PICO_NOT_USED_IN_THIS_CAPTURE_MODE The capture m ode the device is currently running in does not support the current request 103...

Страница 130: ...ALID_DIGITAL_TRIGGER_DIRECTION The digital trigger direction is not a valid trigger direction and should be equal in value to one of the PS3000A_DIGITAL_DIRECTION enum erations 116 PICO_SIG_GEN_PRBS_N...

Страница 131: ...00MV_2V 2 500f define MIN_ANALOGUE_OFFSET_500MV_2V 2 500f define MAX_ANALOGUE_OFFSET_5V_20V 20 f define MIN_ANALOGUE_OFFSET_5V_20V 20 f define PS3206A_MAX_ETS_CYCLES 500 define PS3206A_MAX_ETS_INTERLE...

Страница 132: ...L_CHANNEL_13 PS3000A_DIGITAL_CHANNEL_14 PS3000A_DIGITAL_CHANNEL_15 PS3000A_DIGITAL_CHANNEL_16 PS3000A_DIGITAL_CHANNEL_17 PS3000A_DIGITAL_CHANNEL_18 PS3000A_DIGITAL_CHANNEL_19 PS3000A_DIGITAL_CHANNEL_2...

Страница 133: ...00A_NS PS3000A_US PS3000A_MS PS3000A_S PS3000A_MAX_TIME_UNITS PS3000A_TIME_UNITS typedef enum enPS3000ASweepType PS3000A_UP PS3000A_DOWN PS3000A_UPDOWN PS3000A_DOWNUP PS3000A_MAX_SWEEP_TYPES PS3000A_S...

Страница 134: ...A_SIGGEN_AUX_IN PS3000A_SIGGEN_EXT_IN PS3000A_SIGGEN_SOFT_TRIG PS3000A_SIGGEN_TRIGGER_RAW PS3000A_SIGGEN_TRIG_SOURCE typedef enum enPS3000AIndexMode PS3000A_SINGLE PS3000A_DUAL PS3000A_QUAD PS3000A_MA...

Страница 135: ...MODE_DECIMATE 2 PS3000A_RATIO_MODE_AVERAGE 4 PS3000A_RATIO_MODE typedef enum enPS3000APulseWidthType PS3000A_PW_TYPE_NONE PS3000A_PW_TYPE_LESS_THAN PS3000A_PW_TYPE_GREATER_THAN PS3000A_PW_TYPE_IN_RANG...

Страница 136: ...t a block of data into its internal m em ory before stopping the oscilloscope and transferring the whole block into com puter m em ory This m ode of operation is effective when the input signal being...

Страница 137: ...ertical axis against frequency on the horizontal axis The PicoScope software includes a spectrum analyzer Streaming mode A sam pling m ode in which the oscilloscope sam ples data and returns it to the...

Страница 138: ......

Страница 139: ...ication 62 Connection 62 Constants 125 Contact details 3 Copyright 2 Coupling type setting 68 D Data acquisition 17 Data buffers declaring 69 declaring aggregation mode 70 Data retention 8 DC coupling...

Страница 140: ...ifier 77 ps3000aSetPulseWidthQualifierV2 80 ps3000aSetSigGenArbitrary 83 ps3000aSetSigGenBuiltIn 87 ps3000aSetSimpleTrigger 6 90 ps3000aSetTriggerChannelConditions 6 91 ps3000aSetTriggerChannelConditi...

Страница 141: ...width qualifierV2 80 conditions 82 R Ranges 32 Rapid block mode 7 10 35 36 aggregation 13 no aggregation 11 setting number of captures 76 Resolution vertical 130 Retrieving data 44 46 block mode defe...

Страница 142: ...pyright 2011 2013 Pico Technology Limited All rights reserved ps3000abpg en r9 Trigger stability 15 U Upgrades 2 Usage 2 USB 1 4 5 130 hub 21 V Viruses 2 Voltage range 5 130 selecting 68 W Website 3 W...

Страница 143: ...PicoScope 3000A Series Programmer s Guide 137 Copyright 2011 2013 Pico Technology Limited All rights reserved ps3000abpg en r9...

Страница 144: ...e Colmworth Business Park ST NEOTS Cambridgeshire PE19 8YP United Kingdom Tel 44 0 1480 396 395 Fax 44 0 1480 396 296 www picotech com Copyright 2011 2013Pico Technology Limited All rights reserved ps...

Отзывы:

Нет отзывов