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
| Part | What it does |
|---|
| Screen | 10 divisions wide, 8 high. Traces: CH1 yellow, CH2 cyan. |
| RUN/STOP | Keeps capturing and redrawing while the simulation runs (the button lights green). Press again to stop. |
| SINGLE | Captures one moment and freezes it on the screen. |
| AUTO | Fits 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 buttons | Show or hide a channel. |
| V/DIV knobs | Volts per division for each channel (how tall the wave looks). |
| POSITION knobs | Move a channel's trace (and its 0 V marker) up or down. |
| SEC/DIV knob | Time per division (how much time fits on the screen). |
| TRIG LVL knob | The voltage the trigger waits for. |
| SLOPE | Trigger on a rising (/) or falling (\) edge. |
| POWER | Turns 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
- Drag the Oscilloscope onto the canvas.
- Wire CH1 to PROBE COMP (the small loop under the screen).
- Press Run (the simulator's Run button) to start the simulation.
- Press AUTO on the scope.
- 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.
- 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
- Wire the scope's GND to your circuit's ground (the same ground as the battery, power supply or board).
- Wire CH1 to the point you want to watch, for example the junction of a resistor and a capacitor.
- (Optional) Wire CH2 to a second point, for example the input, to compare the two.
- Run the simulation, then press AUTO.
- 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.
- Wire GEN OUT to your circuit's input and GND to its ground.
- In Properties, set Generator shape (sine, square, triangle, pulse), frequency, amplitude (Vpp),
offset and, for square or pulse, duty.
- Wire CH1 to the generator side (the input) and CH2 to the output you want to study.
- 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 see | Try |
|---|
| "Run the simulation, then press SINGLE or RUN" | Start the simulation first. The scope measures a running circuit. |
| A flat line | Press 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 bottom | Increase V/DIV, or move POSITION. |
| Nothing on the screen | Check 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.