Channel Configuration

Bases: PicoScopeBase, Sharedps5000aPs6000a

PicoScope 5000 (A) API specific functions

Methods:

Name Description
get_adc_limits

Returns the ADC limits for this device.
get_analogue_offset_limits

Get the allowed analogue offset range for a specified range and coupling.
get_avaliable_channel_ranges

Get the information for a specified channel.
get_channel_combinations

Get the avaliable channel combinations at a given timebase for the ps5000a.
set_all_channels_off

Turns all channels off, based on unit number of channels.
set_channel

Enable/disable a channel and specify certain variables i.e. range, coupling, offset, etc.

get_adc_limits(datatype=None)

Returns the ADC limits for this device.

Parameters:
  • datatype (DATA_TYPE, default: None ) –

    The datatype to update the ADC limits for. ps5000a only supports INT16_T.

Returns:
  • tuple[int, int] –

    tuple[int,int]: Minimum ADC value, Maximum ADC value

get_analogue_offset_limits(range, coupling)

Get the allowed analogue offset range for a specified range and coupling.

Parameters:
  • range (RANGE) –

    Voltage range of channel.

  • coupling (COUPLING) –

    AC/DC/DC 50 Ohm coupling of selected channel.
Returns:
  • tuple[float, float] –

    tuple[float, float]: Maximum and minimum allowed analogue offset values.

get_avaliable_channel_ranges(channel)

Get the information for a specified channel.

Parameters:
  • channel (str | CHANNEL) –

    Channel to get information for.
Returns:
  • dict( dict ) –

    Dictionary of channel information.

get_channel_combinations(timebase, ac_adaptor=None, return_type='string')

Get the avaliable channel combinations at a given timebase for the ps5000a.

Parameters:
  • timebase (int) –

    Timebase to use for the channel combinations. Can be calculated using either sample_rate_to_timebase() or interval_to_timebase().

  • ac_adaptor (bool | None, default: None ) –

    Whether to use the AC adaptor. Defaults to None, which will use the ac_adaptor of the current device.

  • return_type (ReturnTypeMap, default: 'string' ) –

    Type of return value. Defaults to 'string'. Can be 'string' or 'enum'. If 'string', returns the channel combinations as a list of strings. If 'enum', returns the channel combinations as a list of enums.
Returns:
  • list[list[str] | list[int]] –

    list[list[str] | list[int]]: List of channel combinations. Each list contains the channel combinations for a given timebase. If return_type is 'string', the list contains the channel combinations as a list of strings. If return_type is 'enum', the list contains the channel combinations as a list of channel enum values.

set_all_channels_off()

Turns all channels off, based on unit number of channels. If the ps5000a has no AC power supply attached, only turns off channel A and B.

set_channel(channel, range=cst.RANGE.V1, enabled=True, coupling=cst.COUPLING.DC, offset=0.0, bandwidth=cst.BANDWIDTH_CH.FULL, probe_scale=1.0)

Enable/disable a channel and specify certain variables i.e. range, coupling, offset, etc.

Parameters:
  • channel (str | CHANNEL) –

    Channel to setup.

  • range (str | RANGE, default: V1 ) –

    Voltage range of channel. Defaults to RANGE.V1.

  • coupling (COUPLING, default: DC ) –

    AC/DC Coupling of selected channel. Defaults to COUPLING.DC.

  • offset (float, default: 0.0 ) –

    Analog offset in volts (V). Defaults to 0.0.

  • bandwidth (BANDWIDTH_CH, default: FULL ) –

    Bandwidth filter to set. Defaults to FULL.

  • probe_scale (float, default: 1.0 ) –

    Probe attenuation factor e.g. 10 for x10 probe. Default value of 1.0 (x1).