Owner's request (2026-10-31): a real 8-channel logic analyzer of our own, a
real instrument that follows a board's power consumption as it runs, and a
real oscilloscope that works in real time; then the workbench taken to
v0.1. This plan follows ADR-033 (instruments are used as the real ones
are: components wired in by their leads, with their real characteristics)
and builds on the wired instruments already in the catalog
(docs/engineering/instrument-loading.md: voltmeter, ammeter, scope input,
the USB power meter).
Each is a widely used, documented instrument, modelled by its published specifications. A figure the maker does not publish is an assumption, named as one in the part's fidelity.
From Saleae's Logic 8 data sheet (DOC_620-00011_V20260521) and its support pages:
| Property | Value |
|---|---|
| Digital channels | 8, each with a ground lead |
| Input impedance | 1 MΩ ∥ 10 pF |
| Threshold | fixed: low below 0.6 V, high above 1.2 V (no selectable threshold on the Logic 8) |
| Sample rates | 100, 50, 40, 25, 20, 10, 8, 5, 4, 2, 1 MS/s; 100 MS/s on up to 3 channels, 50 on up to 6, 40 on up to 7, 25 on all 8 (the data sheet's footnote 1) |
| Digital bandwidth | 25 MHz |
| Input voltage | 0 to 5 V recommended, −25 V to +25 V absolute maximum |
| Memory | streams to the computer (the capture's length is the computer's memory) |
What is modelled: the eight leads loading the circuit (1 MΩ to ground ∥ 10 pF), the threshold with its hysteresis, sampling at the chosen rate exactly as a sampler does (an edge is seen at the first sample after it; a pulse between two samples is missed), the rate's limit by enabled channels, a trigger on a channel's edge with a pre-trigger share, a capture length, and export as Logic 2's CSV and as VCD (both open in PulseView and Logic 2). The workbench draws it as Logic 2 does: channel rows, rate and duration, Start, the trigger, the protocol decoders (UART, SPI, I²C) already in the workbench.
Not at first: the Logic 8's analog inputs (10 bits, 0 to 5 V, up to 10 MS/s), abuse beyond the absolute maximum (ADR-034).
From Nordic's PPK2 user guide v1.0.1 (4461_012), section 8:
| Property | Value |
|---|---|
| Modes | Source meter (it powers the board) and ampere meter (in series with the board's own supply); it cannot measure negative currents |
| Source meter | 0.8 to 5.0 V (VDD_DUT), at most 600 mA |
| Ampere meter | the external supply 0.8 to 5.0 V (VDD_EXT), at most 1 A continuous |
| Measurement | the nRF52840's ADC across a series of measurement resistors, five ranges switched automatically |
| Ranges and resolution | 200 nA–50 µA: 0.2 µA; 50–500 µA: 0.5 µA; 500 µA–5 mA: 5 µA; 5–50 mA: 50 µA; 50–1000 mA: 1000 µA |
| Accuracy (average readout) | ±10 % (offset ±2 %) in the four lower ranges, ±15 % (offset ±5 %) in 50–1000 mA |
| Sampling | 100 kS/s |
| Logic port | D0–D7, its VCC from the board (1.65 to 5.5 V), sampled at 100 kHz, about 50 kHz bandwidth |
What is modelled: both modes (a source with its 600 mA limit; the measurement resistors in series), the five ranges switched by the current with each range's resolution, 100 kS/s samples streamed live, average, peak and charge over a window, the logic port, export as CSV. The workbench draws it as Nordic's Power Profiler app does: the live current graph, a selected window's average and charge, the digital channels underneath.
Not at first: the measurement resistors' values and the voltage they drop (not published: an assumption, named), the switching transients between ranges (the guide warns that a current near a switching point distorts the plot).
From Rigol's MSO1000Z/DS1000Z User's Guide, chapter 18:
| Property | Value |
|---|---|
| Channels | 4 analog |
| Bandwidth (−3 dB) | 50 MHz (single-shot too); a 20 MHz limit; calculated rise time 7 ns |
| Sample rate | 1 GSa/s (1 channel), 500 MSa/s (2), 250 MSa/s (3 or 4) |
| Memory depth | 12 Mpts (1 channel), 6 Mpts (2), 3 Mpts (3 or 4); 24/12/6 Mpts with the option |
| Vertical | 8 bits, 1 mV/div to 10 V/div (probe 1x); offset ±2 V to 499 mV/div, ±100 V from 500 mV/div |
| Input | (1 MΩ ±1 %) ∥ (15 pF ±3 pF); DC, AC (≤5 Hz) or GND coupling; probe 0.01x to 1000x |
| DC gain accuracy | ±4 % of full scale below 10 mV/div, ±3 % from 10 mV/div |
| Timebase | 5 ns/div to 50 s/div; YT, XY and Roll |
| Trigger | Auto, Normal, Single; level ±5 div from centre; holdoff 16 ns to 10 s; edge (rising, falling, either), pulse, slope and more; RS232, I²C, SPI as options |
| Measurements | period, frequency, rise and fall time, widths, duty, peak-to-peak, amplitude, average, RMS and others |
What is modelled: the four inputs loading the circuit (1 MΩ ∥ 15 pF, and a 10x probe's 10 MΩ), the bandwidth as a first-order limit (and the 20 MHz limit), sampling at the rate the enabled channels allow, 8-bit quantisation at the chosen V/div and offset, the memory depth by channel count, the edge trigger with Auto, Normal and Single and its holdoff, the timebase and trigger position, and live acquisitions as the circuit runs in real time (ADR-032). The workbench draws its front panel: the 12-division screen, each channel's V/div and offset, the timebase, the trigger level and mode, Run/Stop and Single, measurements and cursors.
Not at first: the other trigger types, the serial decode options, math and FFT, the probe's compensation, XY and Roll.
Built (2026-10-31): emblink/nordic_ppk2 is a composite of its
measurement core (emblink/ppk2_core, the power_profiler primitive) and
its logic port (emblink/ppk2_logic_port, the logic analyzer's sampler at
a fixed 100 kHz), each read with instrument.read.
Built (2026-10-31): emblink/rigol_ds1054z (the oscilloscope
primitive): its inputs, acquisition, trigger and sweeps as above; its
screen and front panel in the Run perspective, live.
- Leads load the circuit. Each channel's input is a pin model with the
instrument's impedance and threshold (the logic analyzer's digital
inputs:
vil,vih, a 1 MΩ pull-down,cin), or an analog input like the scope input part's. - Sampling is exact, not stepped. The logic analyzer does not wake at each sample: an edge is placed at the first sample instant after it, and a change undone before that instant is dropped, which is what a sampler sees. The power profiler and the scope sample the analog solution at their rate between accepted steps (the solution held, as the USB meter integrates it).
- Captures reach the workbench by a new method,
instrument.read(part id, since a sequence number), returning the samples or transitions added; the observe stream carries each instrument's state (armed, triggered, rate, counts). Recordings replay them, since they derive from the circuit.
The workbench has reached a usable v0.0.1: design, bench, run, debug and verify perspectives. v0.1 makes it a bench a person works at:
- The three instruments' front panels, opened from the part on the bench or the schematic, docked or floating, following the circuit live.
- Each perspective's unfinished edges closed (listed in
docs/STATUS.mdunder the workbench), keyboard and screen-reader paths checked. - The version set to 0.1.0 across the workbench, the desktop shell and the CLI's reported version, with release notes in the changelog.
- The logic analyzer: the engine model and fixtures (thresholds, a pulse shorter than a sample missed, the rate limit, the trigger), a protocol test reading a UART frame from an Uno sketch, the panel, the exports opened by PulseView's reader in CI where available.
- The power profiler: fixtures in both modes (a known load's current, the range switch, the resolution), a board sleeping and waking seen at 100 kS/s, the panel.
- The oscilloscope: fixtures (an RC step's time constant measured, a square wave quantised at 8 bits, the trigger modes), the panel live.
- The workbench v0.1 items, then the release notes.
Each lands with its catalog entry's fidelity, CHANGELOG.md, docs/STATUS.md
and screenshots in docs/gallery/.