SCPI-Instrument-Control 1.1.0__tar.gz → 3.0.0__tar.gz

{scpi_instrument_control-1.1.0 → scpi_instrument_control-3.0.0}/CHANGELOG.md

@@ -7,15 +7,162 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [3.0.0] - 2026-07-17
+
+### ⚠️ Breaking Changes
+
+- **The report generator's `WaveformData` fields are renamed, and `channel`
+  moved from the first constructor argument to the third.** `channel_name`,
+  `time_data`, and `voltage_data` are now `channel`, `time`, and `voltage`,
+  matching the base class's field order (`time`, `voltage`, `channel`, ...).
+  Because the position changed along with the name, positional construction
+  such as `WaveformData("CH1", t, v, ...)` does **not** fail with a
+  recognizable rename error — it silently assigns `"CH1"` to `time` and
+  blows up later with `AttributeError: 'str' object has no attribute
+  'shape'`. Construct with keywords (`channel=`, `time=`, `voltage=`) to
+  migrate safely. This is a documented public API — see
+  [`docs/report-generator/api-reference.md`](docs/report-generator/api-reference.md).
+- **`WaveformData.source` and `WaveformData.description` are removed**, on
+  both the library and report waveform types. `WaveformData(..., source="x")`
+  now raises `TypeError` instead of silently accepting the keyword.
+- **`WaveformData.timebase` and `WaveformData.voltage_scale` are `None`
+  unless an instrument actually reported them**, instead of being derived by
+  assuming a 14-division horizontal grid and an 8-division vertical one —
+  Siglent's geometry, previously applied to Tektronix and LeCroy captures too
+  — with a flat trace given a bare 1.0 V/div. Real acquisitions are
+  unaffected: all three vendor backends pass genuine scope values. Code that
+  does arithmetic on `timebase`/`voltage_scale` from a *synthetic* waveform
+  (a math channel, or hand-built test data) — e.g. `wf.timebase * 1e6` — now
+  raises `TypeError` on `None` instead of silently using an invented number.
+  Guard with a `None` check, or supply real values.
 
-## [1.0.1] - 2026-01-07
+### Added
+
+- Tektronix and LeCroy oscilloscope support (core control, waveform
+  acquisition, measurements): two more wire dialects (`tektronix`, `lecroy`)
+  alongside the existing Siglent legacy/modern pair, auto-detected from
+  `*IDN?` via a manufacturer-first routing step. Covers the Tektronix
+  TBS1000C Series and 2 Series MSO, and the LeCroy WaveSurfer 3000z and
+  WaveRunner 8000 series. See the
+  [SCPI Dialects guide](docs/user-guide/scpi-dialects.md) for the full
+  per-vendor command tables and known gaps (e.g. LeCroy
+  statistics/cursors/holdoff, Tek 16-bit waveform transfer).
+- Tektronix MSO 4/5/6 Series support (MSO44, MSO46, MSO54, MSO56, MSO58,
+  MSO58LP, MSO64), including 6- and 8-channel models.
+- Badge-based measurements for the modern Tektronix MSO families, which also
+  enables `measure()` on the MSO 2-Series.
+- **Report generator — local-LLM analysis and richer PDFs**
+  (`pip install "SCPI-Instrument-Control[report-generator]"`). Everything here
+  is local-only — no cloud providers, no API keys.
+  - Local-LLM (Ollama) tool calling: the model can call read-only report tools
+    to ground its answers, behind a capability gate that no-ops when the local
+    model cannot do tool calls.
+  - Waveform analysis tools for the model — `analyze_plateaus`, `list_edges`,
+    and `analyze_spectrum` — plus `WaveformAnalyzer.calculate_spectrum`.
+  - Deterministic no-LLM analysis: a `ComputedAnalyzer` populates per-waveform
+    statistics and regions on every report, and composes a summary, findings,
+    and recommendations when no LLM wrote them. Reports now attribute their
+    summary by source (manual / AI / computed) rather than a bare AI flag.
+  - Vector PDF plots: waveform, FFT, and region plots render as scalable vector
+    graphics instead of rasterized images.
+  - Page framework: a running header/footer and page numbers on every page,
+    with section headings kept from stranding at the bottom of a page.
+  - Template branding: a template's logo, company name, header/footer text, and
+    four brand colours apply to the generated PDF, and a built-in starter
+    template can be seeded from the Template Manager.
+
+### Changed
+
+- On the Siglent modern dialect, `trigger.holdoff`, measurement statistics,
+  cursors, and `channel.unit` now raise `FeatureNotSupportedError` immediately
+  instead of writing an unsupported command and timing out
+  (`SiglentTimeoutError`). Code that caught the timeout to detect these
+  unsupported operations must now catch `FeatureNotSupportedError` instead.
+- Probe-ratio wire format on the legacy and modern dialects now serializes
+  floats compactly (`10.0` is sent as `10`), matching how real scopes echo the
+  value back.
+- `add_measurement` now validates and case-normalizes its measurement type
+  (unknown types raise instead of being sent verbatim to the instrument).
+- Channel numbers are validated against the connected model's channel count
+  instead of a fixed 1-4 range. Scopes with fewer than four channels now raise
+  `InvalidParameterError` for a channel they do not have, where they
+  previously queried it.
+- The report generator's `WaveformData` is now a subclass of
+  `scpi_control.waveform.WaveformData` (see Breaking Changes above for the
+  field rename and reorder this involved). Report waveforms now inherit the
+  library's array-shape validation, and `channel` is now guaranteed to be a
+  `str` by the type itself. The loader's explicit `str()` calls at each
+  construction site are unchanged and now redundant, not removed — they stay
+  as a defensive measure against `np.str_`/`bytes` values handed back at the
+  MAT/HDF5 boundary.
+
+## [2.0.0] - 2026-07-15
+
+### ⚠️ Breaking Changes
+
+- **Removed the `siglent` compatibility shim.** `import siglent` now raises
+  `ModuleNotFoundError`; use `import scpi_control` (identical API). The shim
+  had emitted a `DeprecationWarning` since 1.0.0, which announced its removal
+  in v2.0.0. If you cannot migrate yet, pin `SCPI-Instrument-Control<2.0`.
+- **Python 3.9+ required** (was 3.8+; Python 3.8 reached end of life in
+  October 2024). CI now tests Python 3.9 through 3.14.
 
 ### Added
 
+- **Browser-based lab gateway** (`pip install "SCPI-Instrument-Control[web]"`,
+  then `scpi-web` or `python -m scpi_control.server`): a FastAPI server that
+  manages named multi-instrument sessions and serves a React UI to any
+  browser on the LAN. Mock-first — every feature works against the built-in
+  mock scope (`mock: true`).
+  - Live waveform streaming over WebSocket, with channel, timebase, trigger,
+    and acquisition (run/stop/single/auto) controls
+  - LAN instrument discovery and a dashboard-style home screen
+  - Measurements with live values and cross-tab-synchronized selection
+  - Software math channels (M1/M2) streamed as canvas traces
+  - SCPI terminal, instrument screenshot PNG, full-resolution waveform
+    export as CSV and JSON
+  - FFT spectrum view computed server-side from full-resolution data
+    (window selection, peak markers, THD readout)
+  - Software Butterworth filters (lowpass/highpass/bandpass) streamed as
+    F1/F2 traces
+  - Reference waveforms: save named snapshots, ghost overlay on the canvas,
+    live correlation and max-deviation statistics
+  - Measurement trend recording: server-side ring buffer at ~1 Hz, live
+    trend chart, CSV export; the measurement selection locks while recording
+- Dual-dialect SCPI support: legacy (e.g. SDS1104X-E) and modern
+  (e.g. SDS800X HD) Siglent command sets behind one API, auto-detected from
+  `*IDN?` with a manual override
+
 ### Changed
 
+- Connection layer hardened: thread-safe socket handling, exact-length
+  binary reads, default SCPI port 5025
+- `wait_for_trigger` honors a user-configured NORMAL trigger mode instead of
+  forcing SINGLE
+- Black formatting standardized on the 26.x stable style; dev extra now
+  requires `black>=26.5,<27` (installed on Python >= 3.10, where Black 26 is available)
+- Removed the unused `uplot` frontend dependency (the UI draws on a
+  hand-rolled canvas)
+
 ### Fixed
 
+- Mock-fidelity and hardware-behavior fixes from the 2026-07 code audit
+  (trigger vocabulary mapping, waveform preamble parsing, measurement
+  timeout handling, and related issues)
+
+## [1.1.0] - 2026-01-12
+
+### Added
+
+- Data acquisition / data logger instrument support (`DataLogger`): Keysight
+  34970A/DAQ970A-style SCPI units — DMM function configuration (V/I/R/
+  temperature), scan lists, triggering, alarms, channel scaling, and timed
+  logging helpers (PR #39)
+
+## [1.0.1] - 2026-01-07
+
+Packaging and metadata fixes for the 1.0.0 rename release; no functional changes.
+
 ## [1.0.0] - 2026-01-06
 
 ### ⚠️ MAJOR RELEASE - Package Renamed

{scpi_instrument_control-1.1.0 → scpi_instrument_control-3.0.0}/MANIFEST.in

@@ -6,13 +6,14 @@ include pyproject.toml
 
 # Include user-facing documentation
 recursive-include docs/images *.png *.jpg
-include docs/VISUAL_MEASUREMENTS.md
-include docs/SCREENSHOT_GUIDE.md
 include docs/SDS800XHD_Series_ProgrammingGuide_EN11G.pdf
 
 # Include resources (logos, icons)
 recursive-include resources *.png *.ico *.icns
 
+# Include web gateway frontend build output (when present)
+recursive-include scpi_control/server/static *
+
 # Include examples
 recursive-include examples *.py
 recursive-include examples *.md
@@ -21,8 +22,6 @@ recursive-include examples *.md
 exclude docs/development/*
 exclude docs/README_SCREENSHOTS.md
 exclude docs/SCREENSHOT_CHECKLIST.md
-exclude docs/CONTRIBUTING.md
-exclude docs/SECURITY.md
 recursive-exclude tests *
 recursive-exclude scripts *
 

{scpi_instrument_control-1.1.0/SCPI_Instrument_Control.egg-info → scpi_instrument_control-3.0.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: SCPI-Instrument-Control
-Version: 1.1.0
+Version: 3.0.0
 Summary: Universal Python library for controlling SCPI-compatible test equipment via Ethernet/LAN. Supports oscilloscopes (Siglent SDS series, generic SCPI scopes), function generators/AWGs (Siglent SDG series, generic SCPI AWGs), and power supplies (Siglent SPD series, generic SCPI PSUs). Features include waveform capture, measurements, FFT analysis, PyQt6 GUI, automated report generation with AI analysis, and comprehensive SCPI command abstraction.
 Author: Robin Mumm
 Maintainer: little-did-I-know
@@ -17,11 +17,12 @@ Classifier: Intended Audience :: Developers
 Classifier: Intended Audience :: Manufacturing
 Classifier: Operating System :: OS Independent
 Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.8
 Classifier: Programming Language :: Python :: 3.9
 Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
 Classifier: Programming Language :: Python :: 3 :: Only
 Classifier: Topic :: Scientific/Engineering
 Classifier: Topic :: Scientific/Engineering :: Interface Engine/Protocol Translator
@@ -30,7 +31,7 @@ Classifier: Topic :: System :: Networking :: Monitoring
 Classifier: Topic :: Software Development :: Libraries :: Python Modules
 Classifier: Environment :: X11 Applications :: Qt
 Classifier: Typing :: Typed
-Requires-Python: >=3.8
+Requires-Python: >=3.9
 Description-Content-Type: text/markdown
 License-File: LICENSE
 Requires-Dist: numpy>=1.24.0
@@ -40,17 +41,20 @@ Provides-Extra: dev
 Requires-Dist: pytest>=7.0; extra == "dev"
 Requires-Dist: pytest-cov>=4.0.0; extra == "dev"
 Requires-Dist: codecov>=2.1.0; extra == "dev"
-Requires-Dist: black>=23.0; extra == "dev"
+Requires-Dist: black<27,>=26.5; python_version >= "3.10" and extra == "dev"
 Requires-Dist: flake8>=6.0; extra == "dev"
 Requires-Dist: build>=0.10.0; extra == "dev"
 Requires-Dist: twine>=4.0.0; extra == "dev"
-Requires-Dist: black[jupyter]>=23.0; extra == "dev"
 Provides-Extra: hdf5
 Requires-Dist: h5py>=3.8.0; extra == "hdf5"
 Provides-Extra: gui
 Requires-Dist: PyQt6>=6.6.0; extra == "gui"
 Requires-Dist: PyQt6-WebEngine>=6.6.0; extra == "gui"
 Requires-Dist: pyqtgraph>=0.13.0; extra == "gui"
+Provides-Extra: web
+Requires-Dist: fastapi>=0.115; extra == "web"
+Requires-Dist: uvicorn[standard]>=0.30; extra == "web"
+Requires-Dist: Pillow>=10.0; extra == "web"
 Provides-Extra: fun
 Requires-Dist: shapely>=2.0.0; extra == "fun"
 Requires-Dist: Pillow>=10.0.0; extra == "fun"
@@ -60,7 +64,11 @@ Requires-Dist: PyQt6>=6.6.0; extra == "report-generator"
 Requires-Dist: Pillow>=10.0.0; extra == "report-generator"
 Requires-Dist: requests>=2.31.0; extra == "report-generator"
 Requires-Dist: reportlab>=4.0.0; extra == "report-generator"
+Requires-Dist: svglib>=1.5.0; extra == "report-generator"
 Requires-Dist: ollama>=0.6.0; extra == "report-generator"
+Requires-Dist: PyMuPDF>=1.23.0; extra == "report-generator"
+Requires-Dist: psutil>=5.9.0; extra == "report-generator"
+Requires-Dist: nvidia-ml-py>=12.0.0; extra == "report-generator"
 Provides-Extra: power-supply-beta
 Provides-Extra: usb
 Requires-Dist: pyvisa>=1.14.0; extra == "usb"
@@ -85,7 +93,11 @@ Requires-Dist: Pillow>=10.0.0; extra == "all"
 Requires-Dist: svgpathtools>=1.6.0; extra == "all"
 Requires-Dist: requests>=2.31.0; extra == "all"
 Requires-Dist: reportlab>=4.0.0; extra == "all"
+Requires-Dist: svglib>=1.5.0; extra == "all"
 Requires-Dist: ollama>=0.6.0; extra == "all"
+Requires-Dist: PyMuPDF>=1.23.0; extra == "all"
+Requires-Dist: psutil>=5.9.0; extra == "all"
+Requires-Dist: nvidia-ml-py>=12.0.0; extra == "all"
 Dynamic: license-file
 
 # SCPI Instrument Control
@@ -312,7 +324,7 @@ pip install "SCPI-Instrument-Control[all]"
 
 #### 2. Update Your Import Statements
 
-**Old imports** (deprecated but still work):
+**Old imports** (no longer work as of v2.0.0):
 
 ```python
 from siglent import Oscilloscope, PowerSupply, FunctionGenerator
@@ -330,16 +342,11 @@ from scpi_control.waveform import Waveform
 
 #### 3. Backward Compatibility
 
-**Good news**: The old `import siglent` syntax still works! A compatibility shim automatically redirects to `scpi_control`.
-
-However, you'll see a `DeprecationWarning` encouraging you to update your code:
-
-```
-DeprecationWarning: The 'siglent' package name is deprecated and will be removed in v2.0.0.
-Please update your imports to use 'scpi_control' instead.
-```
-
-**The compatibility layer will be removed in v2.0.0**, so please migrate your code when convenient.
+The `siglent` compatibility shim was removed in **v2.0.0** (it had emitted a
+`DeprecationWarning` since v1.0.0). `import siglent` now raises
+`ModuleNotFoundError` — update your imports to `scpi_control` as shown above;
+the API is otherwise identical. If you cannot migrate yet, pin
+`SCPI-Instrument-Control<2.0`.
 
 #### 4. Command-Line Tools
 
@@ -357,7 +364,7 @@ No changes needed to scripts or automation that invoke these commands.
 | Old | New | Status |
 |-----|-----|--------|
 | PyPI package: `siglent` | PyPI package: `SCPI-Instrument-Control` | **Changed** |
-| `import siglent` | `import scpi_control` | **Recommended** |
+| `import siglent` | `import scpi_control` | **Required since v2.0.0** |
 | `siglent-gui` command | `siglent-gui` command | **Unchanged** |
 | `siglent-report-generator` command | `siglent-report-generator` command | **Unchanged** |
 
@@ -422,7 +429,7 @@ main()
 
 ### Core Library
 
-- Python 3.8+
+- Python 3.9+
 - NumPy >= 1.24.0
 - Matplotlib >= 3.7.0
 - SciPy >= 1.10.0
@@ -681,6 +688,50 @@ See `examples/vector_graphics_xy_mode.py` for programmatic usage and animation e
 - I2C, SPI, UART, CAN, LIN decoding
 - Packet analysis and export
 
+## Web Gateway (beta)
+
+Control instruments from any browser on your LAN:
+
+```bash
+pip install scpi-instrument-control[web]   # includes the browser gateway
+scpi-web --host 0.0.0.0 --port 8765
+```
+
+Open `http://<gateway-pc>:8765`. Sessions can target real scopes by IP or a
+built-in mock (`mock: true`) for hardware-free use. The API is documented at
+`/docs` (OpenAPI). No authentication in this release — bind to `127.0.0.1`
+(the default) unless your LAN is trusted.
+
+Full documentation: [Web Gateway guide](https://little-did-I-know.github.io/SCPI-Instrument-Control/gateway/) — overview, browser UI tour, and the complete REST & WebSocket API reference.
+
+- `GET /api/discover` scans the gateway's subnet (or `?cidr=…`) for SCPI
+  instruments on port 5025 and lists them with model and dialect — handy when
+  DHCP moves your instruments around.
+- `GET .../scope/screenshot.png` — the instrument's display as a PNG
+- `GET .../scope/waveform?channels=1,2&max_points=N` — waveform data as JSON
+- `GET/PATCH .../scope/math/{1,2}` — software math channels (streamed as M1/M2 traces)
+- `GET .../scope/measurements` — the current measurement selection
+- `GET/PATCH .../scope/spectrum` — server-computed FFT spectrum (streamed as `spectrum` frames)
+- `GET .../scope/filters` + `PATCH .../scope/filters/{1,2}` — software Butterworth filters (streamed as F1/F2 traces)
+- `GET/POST/DELETE .../scope/references` + `GET/PUT .../scope/reference` — saved reference waveforms and the live overlay
+- `POST .../scope/log/start` / `POST .../scope/log/stop` — record the selected measurements (~1 Hz) server-side
+- `GET .../scope/log`, `GET .../scope/log/data?since=`, `GET .../scope/log.csv` — recording status, rows, and CSV export
+
+### Browser UI
+
+```bash
+make webapp-install       # once
+make webapp-build         # build the UI into the server
+scpi-web --host 0.0.0.0   # serve API + UI on one port
+```
+
+Open `http://<gateway-pc>:8765`. For UI development, run `scpi-web` in one
+terminal and `cd webapp/app && npm run dev` in another — Vite proxies `/api`
+(HTTP and WebSocket) to the gateway with hot reload.
+
+The home screen scans your LAN and lists instruments to connect to, resume, or
+open a shared session on — plus manual IP and a hardware-free mock.
+
 ## API Documentation
 
 ### Oscilloscope
@@ -854,18 +905,33 @@ See the `examples/` directory for complete working examples:
 
 ## Supported Models
 
-### Fully Tested
+### Siglent (Fully Tested)
 
 - **SDS800X HD Series**: SDS804X HD, SDS824X HD
 - **SDS1000X-E Series**: SDS1102X-E, SDS1104X-E, SDS1202X-E, SDS1204X-E
 - **SDS2000X Plus Series**: SDS2104X+, SDS2204X+, SDS2354X+
 - **SDS5000X Series**: SDS5034X, SDS5054X, SDS5104X
 
+### Tektronix and LeCroy (core control + measurements)
+
+- **Tektronix TBS1000C Series**: TBS1102C
+- **Tektronix 2 Series MSO**: MSO24
+- **Tektronix 4 Series MSO**: MSO44, MSO46
+- **Tektronix 5 Series MSO**: MSO54, MSO56, MSO58, MSO58LP
+- **Tektronix 6 Series MSO**: MSO64
+- **LeCroy WaveSurfer 3000z Series**: WaveSurfer 3024z
+- **LeCroy WaveRunner 8000 Series**: WaveRunner 8104
+
+All Tektronix MSO models (2/4/5/6 Series) share one command variant and
+support automated measurements — see the [SCPI Dialects guide](https://little-did-I-know.github.io/SCPI-Instrument-Control/user-guide/scpi-dialects/) for the full per-vendor gap list.
+
+Command tables were verified command-by-command against the vendor programmer manuals (Tektronix TBS1000C, 2 Series MSO, and 4/5/6 Series MSO/6 Series LPD manuals; the Teledyne LeCroy MAUI Remote Control and Automation Manual) and exercised against a dialect-aware mock; not yet run against real Tektronix or LeCroy hardware.
+
 ### Compatibility
 
-Should work with other Siglent oscilloscopes that support SCPI commands over Ethernet. Model-specific features are auto-detected via the `ModelCapability` registry.
+Should work with other Siglent oscilloscopes that support SCPI commands over Ethernet. Model-specific features are auto-detected via the `ModelCapability` registry. Unrecognized Tektronix or LeCroy models fall back to a conservative generic profile for that vendor (with a logged warning) rather than being rejected outright.
 
-**Note**: Some SCPI commands vary between models. The library includes model-specific command variants for HD, X, and Plus series.
+**Note**: Some SCPI commands vary between models. The library includes model-specific command variants for HD, X, and Plus series (Siglent) and for TBS vs. MSO (2/4/5/6 Series share one variant) (Tektronix).
 
 ## Contributing
 

{scpi_instrument_control-1.1.0 → scpi_instrument_control-3.0.0}/README.md

@@ -222,7 +222,7 @@ pip install "SCPI-Instrument-Control[all]"
 
 #### 2. Update Your Import Statements
 
-**Old imports** (deprecated but still work):
+**Old imports** (no longer work as of v2.0.0):
 
 ```python
 from siglent import Oscilloscope, PowerSupply, FunctionGenerator
@@ -240,16 +240,11 @@ from scpi_control.waveform import Waveform
 
 #### 3. Backward Compatibility
 
-**Good news**: The old `import siglent` syntax still works! A compatibility shim automatically redirects to `scpi_control`.
-
-However, you'll see a `DeprecationWarning` encouraging you to update your code:
-
-```
-DeprecationWarning: The 'siglent' package name is deprecated and will be removed in v2.0.0.
-Please update your imports to use 'scpi_control' instead.
-```
-
-**The compatibility layer will be removed in v2.0.0**, so please migrate your code when convenient.
+The `siglent` compatibility shim was removed in **v2.0.0** (it had emitted a
+`DeprecationWarning` since v1.0.0). `import siglent` now raises
+`ModuleNotFoundError` — update your imports to `scpi_control` as shown above;
+the API is otherwise identical. If you cannot migrate yet, pin
+`SCPI-Instrument-Control<2.0`.
 
 #### 4. Command-Line Tools
 
@@ -267,7 +262,7 @@ No changes needed to scripts or automation that invoke these commands.
 | Old | New | Status |
 |-----|-----|--------|
 | PyPI package: `siglent` | PyPI package: `SCPI-Instrument-Control` | **Changed** |
-| `import siglent` | `import scpi_control` | **Recommended** |
+| `import siglent` | `import scpi_control` | **Required since v2.0.0** |
 | `siglent-gui` command | `siglent-gui` command | **Unchanged** |
 | `siglent-report-generator` command | `siglent-report-generator` command | **Unchanged** |
 
@@ -332,7 +327,7 @@ main()
 
 ### Core Library
 
-- Python 3.8+
+- Python 3.9+
 - NumPy >= 1.24.0
 - Matplotlib >= 3.7.0
 - SciPy >= 1.10.0
@@ -591,6 +586,50 @@ See `examples/vector_graphics_xy_mode.py` for programmatic usage and animation e
 - I2C, SPI, UART, CAN, LIN decoding
 - Packet analysis and export
 
+## Web Gateway (beta)
+
+Control instruments from any browser on your LAN:
+
+```bash
+pip install scpi-instrument-control[web]   # includes the browser gateway
+scpi-web --host 0.0.0.0 --port 8765
+```
+
+Open `http://<gateway-pc>:8765`. Sessions can target real scopes by IP or a
+built-in mock (`mock: true`) for hardware-free use. The API is documented at
+`/docs` (OpenAPI). No authentication in this release — bind to `127.0.0.1`
+(the default) unless your LAN is trusted.
+
+Full documentation: [Web Gateway guide](https://little-did-I-know.github.io/SCPI-Instrument-Control/gateway/) — overview, browser UI tour, and the complete REST & WebSocket API reference.
+
+- `GET /api/discover` scans the gateway's subnet (or `?cidr=…`) for SCPI
+  instruments on port 5025 and lists them with model and dialect — handy when
+  DHCP moves your instruments around.
+- `GET .../scope/screenshot.png` — the instrument's display as a PNG
+- `GET .../scope/waveform?channels=1,2&max_points=N` — waveform data as JSON
+- `GET/PATCH .../scope/math/{1,2}` — software math channels (streamed as M1/M2 traces)
+- `GET .../scope/measurements` — the current measurement selection
+- `GET/PATCH .../scope/spectrum` — server-computed FFT spectrum (streamed as `spectrum` frames)
+- `GET .../scope/filters` + `PATCH .../scope/filters/{1,2}` — software Butterworth filters (streamed as F1/F2 traces)
+- `GET/POST/DELETE .../scope/references` + `GET/PUT .../scope/reference` — saved reference waveforms and the live overlay
+- `POST .../scope/log/start` / `POST .../scope/log/stop` — record the selected measurements (~1 Hz) server-side
+- `GET .../scope/log`, `GET .../scope/log/data?since=`, `GET .../scope/log.csv` — recording status, rows, and CSV export
+
+### Browser UI
+
+```bash
+make webapp-install       # once
+make webapp-build         # build the UI into the server
+scpi-web --host 0.0.0.0   # serve API + UI on one port
+```
+
+Open `http://<gateway-pc>:8765`. For UI development, run `scpi-web` in one
+terminal and `cd webapp/app && npm run dev` in another — Vite proxies `/api`
+(HTTP and WebSocket) to the gateway with hot reload.
+
+The home screen scans your LAN and lists instruments to connect to, resume, or
+open a shared session on — plus manual IP and a hardware-free mock.
+
 ## API Documentation
 
 ### Oscilloscope
@@ -764,18 +803,33 @@ See the `examples/` directory for complete working examples:
 
 ## Supported Models
 
-### Fully Tested
+### Siglent (Fully Tested)
 
 - **SDS800X HD Series**: SDS804X HD, SDS824X HD
 - **SDS1000X-E Series**: SDS1102X-E, SDS1104X-E, SDS1202X-E, SDS1204X-E
 - **SDS2000X Plus Series**: SDS2104X+, SDS2204X+, SDS2354X+
 - **SDS5000X Series**: SDS5034X, SDS5054X, SDS5104X
 
+### Tektronix and LeCroy (core control + measurements)
+
+- **Tektronix TBS1000C Series**: TBS1102C
+- **Tektronix 2 Series MSO**: MSO24
+- **Tektronix 4 Series MSO**: MSO44, MSO46
+- **Tektronix 5 Series MSO**: MSO54, MSO56, MSO58, MSO58LP
+- **Tektronix 6 Series MSO**: MSO64
+- **LeCroy WaveSurfer 3000z Series**: WaveSurfer 3024z
+- **LeCroy WaveRunner 8000 Series**: WaveRunner 8104
+
+All Tektronix MSO models (2/4/5/6 Series) share one command variant and
+support automated measurements — see the [SCPI Dialects guide](https://little-did-I-know.github.io/SCPI-Instrument-Control/user-guide/scpi-dialects/) for the full per-vendor gap list.
+
+Command tables were verified command-by-command against the vendor programmer manuals (Tektronix TBS1000C, 2 Series MSO, and 4/5/6 Series MSO/6 Series LPD manuals; the Teledyne LeCroy MAUI Remote Control and Automation Manual) and exercised against a dialect-aware mock; not yet run against real Tektronix or LeCroy hardware.
+
 ### Compatibility
 
-Should work with other Siglent oscilloscopes that support SCPI commands over Ethernet. Model-specific features are auto-detected via the `ModelCapability` registry.
+Should work with other Siglent oscilloscopes that support SCPI commands over Ethernet. Model-specific features are auto-detected via the `ModelCapability` registry. Unrecognized Tektronix or LeCroy models fall back to a conservative generic profile for that vendor (with a logged warning) rather than being rejected outright.
 
-**Note**: Some SCPI commands vary between models. The library includes model-specific command variants for HD, X, and Plus series.
+**Note**: Some SCPI commands vary between models. The library includes model-specific command variants for HD, X, and Plus series (Siglent) and for TBS vs. MSO (2/4/5/6 Series share one variant) (Tektronix).
 
 ## Contributing