Oscilloscope

A two-channel oscilloscope with a built-in function generator. Wire it like a real scope, run the simulation and press SINGLE or RUN to see how voltages change over time.

Oscilloscope

At a glance

Pins and properties exactly as the circuit editor and simulator define this part. The text below explains how to use them.

Pinout

Pinout of the Oscilloscope, drawn as in the circuit editor. Select a label to see that pin in the table below.

Properties

What you can change in the Property Inspector.

Properties of this part
PropertyRange or choicesDefault
PowerOn or offon
Time / div1 us/div, 2 us/div, 5 us/div, 10 us/div, 20 us/div, 50 us/div, 100 us/div, 200 us/div, 500 us/div, 1 ms/div, 2 ms/div, 5 ms/div, 10 ms/div, 20 ms/div, 50 ms/div, 100 ms/div, 200 ms/div, 500 ms/div1 ms/div
CH1 onOn or offon
CH1 volts / div10 mV/div, 20 mV/div, 50 mV/div, 100 mV/div, 200 mV/div, 500 mV/div, 1 V/div, 2 V/div, 5 V/div, 10 V/div1 V/div
CH1 position (div)-4 to 40
CH1 couplingDC, AC (hide the average)DC
CH2 onOn or offon
CH2 volts / div10 mV/div, 20 mV/div, 50 mV/div, 100 mV/div, 200 mV/div, 500 mV/div, 1 V/div, 2 V/div, 5 V/div, 10 V/div1 V/div
CH2 position (div)-4 to 40
CH2 couplingDC, AC (hide the average)DC
Trigger sourceCH1, CH2CH1
Trigger level-50 to 50 V0 V
Trigger slopeRising, FallingRising
Trigger modeAuto (always show the newest), Normal (only triggered frames)Auto (always show the newest)
Generator onOn or offon
Generator shapeSine, Square, Triangle, PulseSine
Generator frequency0.1 to 100000 Hz1000 Hz
Generator amplitude (Vpp)0 to 20 V2 V
Generator offset-10 to 10 V0 V
Generator duty (square / pulse)1 to 99 %50 %

An oscilloscope draws voltage against time. A multimeter shows one number; a scope shows the whole waveform: how fast a capacitor charges, the square wave on a PWM pin, the ripple left after a rectifier.

The front panel

PartWhat it does
Screen10 divisions wide, 8 high. Traces: CH1 yellow, CH2 cyan.
RUN/STOPKeeps capturing and redrawing while the simulation runs (the button lights green). Press again to stop.
SINGLECaptures one moment and freezes it on the screen.
AUTOFits the waveform on the screen: sets V/DIV, SEC/DIV and the trigger level for you. If the screen shows no edges, it looks again with a longer SEC/DIV (up to 10 ms). For signals slower than about 25 Hz, set SEC/DIV by hand.
CH1 / CH2 buttonsShow or hide a channel.
V/DIV knobsVolts per division for each channel (how tall the wave looks).
POSITION knobsMove a channel's trace (and its 0 V marker) up or down.
SEC/DIV knobTime per division (how much time fits on the screen).
TRIG LVL knobThe voltage the trigger waits for.
SLOPETrigger on a rising (/) or falling (\) edge.
POWERTurns the scope (and its outputs) on and off.

Turning a knob: press on it and drag around it, the pointer follows your mouse. A plain click steps it once (left half down, right half up). Every setting is also in the Properties panel.

Pins

Pins of this part
PinLabelTypeNotes
CH1CH1Signal inInputs. Connect each to the point you want to see. 10 MΩ input, so they barely load the circuit.
CH2CH2Signal inInputs. Connect each to the point you want to see. 10 MΩ input, so they barely load the circuit.
PCOMPPROBE COMPSignal outA fixed 1 kHz square wave from 0 to 3 V, through 1 kΩ. Use it to test the scope.
GENGEN OUTSignal outThe built-in function generator: sine, square, triangle or pulse, through 50 Ω (like a real generator).
GNDGNDGroundThe scope's ground. Always connect it to your circuit's ground.

Step by step: your first waveform

  1. Drag the Oscilloscope onto the canvas.
  2. Wire CH1 to PROBE COMP (the small loop under the screen).
  3. Press Run (the simulator's Run button) to start the simulation.
  4. Press AUTO on the scope.
  5. You should see a square wave from 0 V to 3 V, and at the bottom of the screen Vpp 3 V and f 1 kHz.
  6. Press RUN/STOP to keep the picture updating; press it again to freeze it.

If the line is flat, the time per division is too small or too large: press AUTO, or drag SEC/DIV to about 0.5 ms.

Step by step: measure your own circuit

  1. Wire the scope's GND to your circuit's ground (the same ground as the battery, power supply or board).
  2. Wire CH1 to the point you want to watch, for example the junction of a resistor and a capacitor.
  3. (Optional) Wire CH2 to a second point, for example the input, to compare the two.
  4. Run the simulation, then press AUTO.
  5. Fine-tune: drag V/DIV so the wave fills most of the screen height, and SEC/DIV so two or three cycles show. Use POSITION to separate the two traces.

Step by step: use the built-in generator

The generator gives your circuit a test signal, the way a lab function generator does.

  1. Wire GEN OUT to your circuit's input and GND to its ground.
  2. In Properties, set Generator shape (sine, square, triangle, pulse), frequency, amplitude (Vpp), offset and, for square or pulse, duty.
  3. Wire CH1 to the generator side (the input) and CH2 to the output you want to study.
  4. Run, then AUTO.

Example, an RC low-pass filter: GEN OUT → 1 kΩ resistor → 1 µF capacitor → GND. Set the generator to a square wave, 1 kHz, 5 Vpp, offset 2.5 V. Put CH1 on GEN OUT and CH2 on the capacitor. CH1 shows the square; CH2 shows the capacitor charging and discharging with curved edges. Lower the frequency to 100 Hz and the capacitor has time to charge fully: CH2 looks almost square too.

Very slow waves (around 1 Hz and below) can also be watched live: an LED on GEN OUT (with a resistor) fades in and out with a 1 Hz sine.

Reading the screen

  • Top left: each channel's volts per division (1 500 mV = CH1 at 500 mV per division; AC if AC coupled).
  • Top middle: RUN, STOP, or BUSY while a capture is running.
  • Top right: time per division.
  • Left edge: a small coloured arrow marks each channel's 0 V line.
  • Right edge: an arrow marks the trigger level.
  • Bottom right: trigger channel, slope and level. (no trig) means the signal never crossed the level.
  • Bottom left: for each channel Vpp (peak to peak), f (frequency) and avg (average voltage).

To read a voltage from the grid: count divisions from the channel's 0 V arrow and multiply by its V/DIV. To read a time: count divisions across and multiply by SEC/DIV.

Triggering (why the picture stands still)

The scope lines each capture up so the trigger channel crosses the trigger level (rising or falling, set with SLOPE) in the middle of the screen. That is why a repeating wave stays still instead of sliding around.

  • Trigger source (Properties): which channel to watch, CH1 or CH2.
  • TRIG LVL: put it somewhere between the wave's lowest and highest voltage. AUTO sets it to the middle (halfway between the lowest and highest voltage).
  • Trigger mode (Properties): Auto always shows the newest capture, even untriggered; Normal keeps the last triggered picture and shows "waiting for trigger" until the signal crosses the level.

AC and DC coupling

DC (default) shows the real voltage. AC (Properties) hides each channel's average, so a small ripple sitting on a large voltage, for example 50 mV of ripple on a 5 V supply, can fill the screen with a small V/DIV.

If something looks wrong

You seeTry
"Run the simulation, then press SINGLE or RUN"Start the simulation first. The scope measures a running circuit.
A flat linePress AUTO, or change SEC/DIV. Check GND is connected to the circuit's ground.
"No probe is connected"Wire CH1 or CH2 to the circuit.
The wave slides or shows (no trig)Move TRIG LVL inside the wave's range, or press AUTO.
The wave is off the top or bottomIncrease V/DIV, or move POSITION.
Nothing on the screenCheck POWER is on, and the channel's CH1 / CH2 button is on.

Good to know

  • Arduino Uno, Nano, Mega, Raspberry Pi Pico and Pico W keep running their code during a capture. Every change your sketch or MicroPython program makes to a pin inside the capture (a blink, a PWM fade, tone(), a signal you toggle by hand) shows on the screen at the time it happened. The scope waits for the board to cover the capture time, so a slow SEC/DIV (1 s/div = 10 s of capture) takes that long. Inside one capture the sketch does not see the captured circuit: an analogRead there reads the live simulation. A pin switching faster than the scope can replay is shown as its PWM average, and the screen says so.
  • On a Pico, busy code runs in slow motion. Code that waits in a loop (while ticks_diff(...) < 500) keeps its exact timing on the scope, but the emulator runs it slower than a real Pico, so such a capture takes longer to appear than its own length. Code that sleeps (time.sleep_ms) runs at real speed.
  • Pico 2, Pico 2 W and ESP32 boards keep their pin states and PWM as they were when the capture started (the screen says "board pins frozen"): steady signals such as PWM show correctly, changes the code makes during the capture do not.
  • Each capture starts from the circuit as it is right now: capacitors keep their present charge and coils their present current, like a real scope looking at a live circuit. In RUN mode every new frame continues from the live simulation, so you can watch a capacitor charge, a motor spin up or a supply settle.
  • RUN redraws about ten times a second, depending on how big the circuit is.
Oscilloscope — OMS Parts