43 lines
2.4 KiB
Plaintext
43 lines
2.4 KiB
Plaintext
<b>Choosing a source</b>
|
||
|
||
A source is a host and a port, optionally reached through a multicast group on a named
|
||
interface. Pass it on the command line, or let udpscope ask.
|
||
|
||
<b>How to reach it</b>
|
||
|
||
Run with <tt>--server</tt> and the app connects straight away. Run <i>without</i>
|
||
<tt>--server</tt> and a chooser appears first: one row per stored <i>configuration</i>
|
||
(<tt>host:port · name</tt>, its note, and the settings it carries), newest first, plus a
|
||
<b>New host…</b> form that takes the address <i>and</i> the configuration it belongs to — its name
|
||
and note, the <b>buffer size</b>, and whether time is relative or absolute. A row's pencil button
|
||
opens the same form on that configuration, pre-filled, and changes to its name or address move it
|
||
(the old file is deleted).
|
||
|
||
The second page, <b>Waveforms</b>, opens an <i>exported</i> run instead of a live source: the files
|
||
opened before (newest first; one that has since been deleted is marked <i>missing</i>) and an
|
||
<b>Open…</b> button for a new one. The same file can be opened straight from the command line with
|
||
<tt>--open FILE</tt>. A waveform is a source that never arrives — no socket, no acquisition, no
|
||
starvation notice — and every instrument works on it: cursors, measurements, math channels and
|
||
another export. Only <tt>.npy</tt> files are read. form for one it has not seen. The chooser runs before any
|
||
buffer is allocated and before any socket is opened, so declining it costs nothing.
|
||
|
||
<b>Worth knowing</b>
|
||
|
||
• The list is the sessions that <i>named a signal</i>. A session whose streamer was down
|
||
stores empty slot names and is filtered out, which is what keeps the list the sources you
|
||
actually configured rather than every port you have ever typed.
|
||
• A stored row reconnects the way it was reached. The multicast group and the interface are
|
||
written inside the session file, because the file's name (<tt>host_port.toml</tt>) cannot
|
||
carry them.
|
||
• <tt>--multicast</tt> still needs <tt>--server</tt>: the CONFIG message is fetched from the
|
||
server, not from the group.
|
||
• The <tt>×</tt> beside a row deletes that session file. Nothing else is removed.
|
||
|
||
<b>Example</b>
|
||
|
||
<tt>udpscope</tt> with two stored sessions lists
|
||
<tt>127.0.0.1:8000 plots=1 signals=3</tt> and
|
||
<tt>10.0.0.5:8001 plots=2 signals=4 multicast=239.1.2.3 interface=10.0.0.9</tt>.
|
||
Activating the first reports <tt>[sources] picked 127.0.0.1:8000</tt> and continues into
|
||
the scope with that session's layout already loaded.
|