scope_* helpers. For Siglent model details and SDS800X HD advanced triggers, see Siglent oscilloscopes.
Check the model
Embedder identifies the exact model from the scope’s*IDN? response. It rejects unknown models before writing any settings, even when the name looks similar to a supported one.
Every listed family supports analog voltage channels, channel and timebase setup, edge triggers, single acquisitions, screenshots, and saved waveforms. Digital pods, segmented or sequence acquisition, built-in generators, and protocol decoding are not supported. Embedder rejects an acquisition layout it can’t interpret as a voltage trace instead of publishing it.
Family support is verified against protocol simulators. Check a capture against a known signal the first time you use a particular model and firmware.
Connect
Put the scope on a network reachable from the Embedder host. Embedder discovers LXI scopes over mDNS, and you can also enter an address directly. Check signal limits, grounding, and probe attenuation before connecting the inputs.- In the Monitor, select + and select the scope under On the bench.
- If the scope isn’t listed, type its address in the search field, such as
192.168.1.20or192.168.1.20:5025, and select the Connect to result for that address. Without a port, Embedder tries port 5025, then 4000. On a Tektronix scope, turn on Utility › I/O › Socket Server with protocol None, or let discovery find the scope. - Select Set up & connect for a new scope. Selecting it approves setup. Embedder installs only the packages that model needs and shows progress in the device bar.
Capture in the Monitor
In the Oscilloscope tab, open the setup panel, shown as the settings summary beside the Device list. Set channels (V/div, offset, coupling, probe), the horizontal timebase, and the trigger. Setup reflects the scope’s front panel. Then choose a capture mode:- Single: arm once and capture the next trigger.
- Run: capture repeatedly until you select Stop.
- Auto: let the scope find the signal.
Connect from a hardware script
In a hardware script,scope_connect() with no arguments connects to the scope selected in the Monitor’s Oscilloscope tab. Without a Monitor selection, pass a VISA resource or a literal host and port:
host without a port selects VXI-11. An explicit port selects a raw SCPI socket. If discovery is blocked, set EMBEDDER_SCOPE_HOST (and EMBEDDER_SCOPE_PORT for a raw socket) before launching Embedder. USB VISA resources are accepted. They require platform drivers or device permissions and haven’t been verified on physical hardware.
scope_read_settings() returns the scope’s current channel, timebase, and trigger settings. scope_apply_settings() applies a subset of those settings and reports values the scope didn’t accept. scope_autoset() runs the scope’s autoset. For instrument functions outside the standard controls, use scope_query() and scope_write() and read back the result.
Troubleshoot
- No scope: check the IP address and network, then select Rescan or type its address in the Connect tab. On a Tektronix scope, turn on the socket server.
- Model rejected: confirm the exact model against the table above.
- Trigger rejected: use an edge trigger on models other than the SDS800X HD.
- Trigger timeout: verify the enabled source, level, polarity, and expected event.
- Clipped signal: increase the voltage range or adjust the offset.
- Read error: Embedder closes the connection after an interrupted or malformed transfer. Reconnect before retrying.

