set_channel

method

RTO.set_channel(channel: int, state: str = 'ON', coupling: str = 'DCLimit', range: float = 0.5, position: float = 0, offset: float = 0, invert: str = 'OFF')

Configures a channel.

Parameters:

channelint

The channel number to be added.

statestr, optional

Switches the channel signal on or off. Acceptable values are ON and OFF. Default is ON (see CHANnel<m>:STATe).

couplingstr, optional

Selects the connection of the indicated channel signal. Valid values are “DC” (direct connection with 50 ohm termination), “DCLimit” (direct connection with 1M ohm termination), or “AC” (connection through DC capacitor). Default is “DCLimit” (see CHANnel<m>:COUPling).

rangefloat, optional

Sets the voltage range across the 10 vertical divisions of the diagram in V/div. Possible values depend on the coupling: 10 mV to 10 V for 50 ohm coupling, and 10 mV to 100 V for 1 megaohm coupling. Default is 0.5 (see CHANnel<m>:RANGe).

positionfloat, optional

Sets the vertical position of the indicated channel as a graphical value. Valid range is [-5, 5] in increments of 0.01 (units is “divisions”). Default is 0 (see CHANnel<m>:POSition).

offsetfloat, optional

The offset voltage is subtracted to correct an offset-affected signal. The offset of a signal is determined and set by the autoset procedure. Valid offset values are dependent on input coupling and vertical voltage range. Default value is 0 (see CHANnel<m>:OFFSet).

invertstr, optional

Turns the inversion of the signal amplitude on or off. To invert means to reflect the voltage values of all signal components against the ground level. If the inverted channel is the trigger source, the instrument triggers on the inverted signal. Acceptable values are “ON” or “OFF”. Default is “OFF” (see CHANnel<m>:INVert).

Notes

The following two tables give the key to the range of possible offset values given the coupling and vertical voltage range.

Offset at 50 \(\Omega\) Coupling

Vertical Voltage Range	Allowed Offset
316 mV/div to \(\leq\) 1 V/div	\(\pm\) 10 V
100 mV/div to \(\leq\) 316 mV/div	\(\pm\) 3 V
1 mV/div to \(\leq\) 100 mV/div	\(\pm\) 1 V

Offset at 1 M\(\Omega\) Coupling

Vertical Voltage Range	Allowed Offset
3.16 V/div to \(\leq\) 10 V/div	\(\pm\) (115 V \(-\) vertical voltage range \(\times\) 5 div)
1 V/div to \(\leq\) 3.16 V/div	\(\pm\) 100 V
316 mV/div to \(\leq\) 1 V/div	\(\pm\) (11.5 V \(-\) vertical voltage range \(\times\) 5 div)
100 mV/div to \(\leq\) 316 mV/div	\(\pm\) 10 V
31.6 mV/div to \(\leq\) 100 mV/div	\(\pm\) (1.15 V \(-\) vertical voltage range \(\times\) 5 div)
1 mV/div to \(\leq\) 31.6 mV/div	\(\pm\) 1 V