Skip to content

Latest commit

 

History

History
156 lines (128 loc) · 8.24 KB

bench-instruments.md

File metadata and controls

156 lines (128 loc) · 8.24 KB

Bench instruments: a logic analyzer, a power profiler and an oscilloscope

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).

1. Which real instruments

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.

Saleae Logic 8 (logic analyzer)

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).

Nordic Power Profiler Kit II (power profiler)

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).

Rigol DS1054Z (oscilloscope)

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.

2. How they fit the engine

  • 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.

3. The workbench to v0.1

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:

  1. The three instruments' front panels, opened from the part on the bench or the schematic, docked or floating, following the circuit live.
  2. Each perspective's unfinished edges closed (listed in docs/STATUS.md under the workbench), keyboard and screen-reader paths checked.
  3. 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.

4. Order and evidence

  1. 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.
  2. 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.
  3. The oscilloscope: fixtures (an RC step's time constant measured, a square wave quantised at 8 bits, the trigger modes), the panel live.
  4. 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/.