PICO PicoScope 3204 MSO Programmer'S Manual Download Page 91 | Manualshive

Page: 91 / 144

PICO PicoScope 3204 MSO Programmer'S Manual Download Page 91

PicoScope 3000A Series Prog rammer's Guide

85

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

ps3000abpg.en r9

PS3207B_MAX_SIG_GEN_BUFFER_SIZE

(3207B model)

sweepType,

determines whether the

startDeltaPhase

is swept

up to the

stopDeltaPhase,

or down to it, or repeatedly swept up

and down. Use one of these values: -

PS3000A_UP
PS3000A_DOWN
PS3000A_UPDOWN
PS3000A_DOWNUP

operation,

the type of waveform to be produced, specified by

one of the following enumerated types:

, normal signal generator operation specified by

wavetype.

PS3000A_WHITENOISE

, the signal generator produces white

noise and ignores all settings except

pkToPk

and

offsetVoltage.

, produces a random bitstream with a bit rate

specified by the start and stop frequency.

indexMode,

specifies how the signal will be formed from the

arbitrary waveform data.

Single, and dual index modes

are possible.

Use one of these constants:

PS3000A_SINGLE
PS3000A_DUAL

Arguments

shots,

see

ps3000aSigGenBuiltIn

sweeps,

see

ps3000aSigGenBuiltIn

triggerType,

see

ps3000aSigGenBuiltIn

triggerSource,

see

ps3000aSigGenBuiltIn

extInThreshold,

see

ps3000aSigGenBuiltIn

PICO_OK
PICO_AWG_NOT_SUPPORTED
PICO_POWER_SUPPLY_CONNECTED
PICO_POWER_SUPPLY_NOT_CONNECTED
PICO_BUSY
PICO_INVALID_HANDLE
PICO_SIG_GEN_PARAM
PICO_SHOTS_SWEEPS_WARNING
PICO_NOT_RESPONDING
PICO_WARNING_EXT_THRESHOLD_CONFLICT
PICO_NO_SIGNAL_GENERATOR
PICO_SIGGEN_OFFSET_VOLTAGE
PICO_SIGGEN_PK_TO_PK
PICO_SIGGEN_OUTPUT_OVER_VOLTAGE
PICO_DRIVER_FUNCTION
PICO_SIGGEN_WAVEFORM_SETUP_FAILED

«
...
89
90
91
92
93
...
»

Summary of Contents for PicoScope 3204 MSO

Page 1: ...Copyright 2011 2013Pico Technology Limited All rights reserved PicoScope 3000A Series Programmer s Guide ps3000abpg en r9 PC Oscilloscopes and MSOs...

Page 2: ......

Page 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...

Page 4: ...47 ps3000aSetNoOfCaptures 77 48 ps3000aSetPulseWidthQualifier 80 49 ps3000aSetPulseWidthQualifierV2 83 50 ps3000aSetSigGenArbitrary 87 51 ps3000aSetSigGenBuiltIn 90 52 ps3000aSetSimpleTrigger 91 53 p...

Page 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...

Page 6: ......

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 16: ...tim ebases until the required nanoseconds per sam ple is located 5 Use the trigger setup functions ps3000aSetTriggerChannelConditionsV2 ps3000aSetTriggerChannelDirections and ps3000aSetTriggerChannelP...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 28: ...esOverlappedBulk set up data collection in rapid block mode ps3000aGetValuesTriggerTimeOffsetBulk get rapid block waveform timings 32 bit ps3000aGetValuesTriggerTimeOffsetBulk64 get rapid block wavefo...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 52: ...the handle of the required device startIndex see ps3000aGetValues noOfSamples see ps3000aGetValues downSampleRatio see ps3000aGetValues downSampleRatioMode see ps3000aGetValues segmentIndex see ps300...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 79: ...PicoScope 3000A Series Programmer s Guide 73 Copyright 2011 2013 Pico Technology Limited All rights reserved ps3000abpg en r9 PICO_DRIVER_FUNCTION...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 124: ...TriggerChannelDirectionsV2 ps3000aSetTriggerChannelProperties ps3000aSetTriggerDigitalPortProperties ps3000aSetPulseWidthQualifier ps3000aSetTriggerDelay PicoScope3000aAWG vi controls the arbitrary wa...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 138: ......

Page 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...

Page 140: ...ifier 77 ps3000aSetPulseWidthQualifierV2 80 ps3000aSetSigGenArbitrary 83 ps3000aSetSigGenBuiltIn 87 ps3000aSetSimpleTrigger 6 90 ps3000aSetTriggerChannelConditions 6 91 ps3000aSetTriggerChannelConditi...

Page 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...

Page 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...

Page 143: ...PicoScope 3000A Series Programmer s Guide 137 Copyright 2011 2013 Pico Technology Limited All rights reserved ps3000abpg en r9...

Page 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...

Reviews:

No comments