Skip to content
Permalink

Comparing changes

Choose two branches to see what’s changed or to start a new pull request. If you need to, you can also or learn more about diff comparisons.

Open a pull request

Create a new pull request by comparing changes across two branches. If you need to, you can also . Learn more about diff comparisons here.
base repository: ngscopeclient/scopehal-docs
Failed to load repositories. Confirm that selected base ref is valid, then try again.
Loading
base: 708a7439854a
Choose a base ref
...
head repository: ngscopeclient/scopehal-docs
Failed to load repositories. Confirm that selected head ref is valid, then try again.
Loading
compare: 8af472d0308d
Choose a head ref
  • 1 commit
  • 6 files changed
  • 1 contributor

Commits on Oct 2, 2020

  1. Copy the full SHA
    8af472d View commit details
Showing with 59 additions and 2 deletions.
  1. +1 −0 CMakeLists.txt
  2. +1 −0 glscopeclient-manual.tex
  3. BIN images/trigger-properties.png
  4. +2 −0 section-gettingstarted.tex
  5. +51 −0 section-triggers.tex
  6. +4 −2 section-waveformviews.tex
1 change: 1 addition & 0 deletions CMakeLists.txt
Original file line number Diff line number Diff line change
@@ -13,6 +13,7 @@ set(DOC_LIST
section-revision.tex
section-timeline.tex
section-transports.tex
section-triggers.tex
section-waveformgroups.tex
section-waveformviews.tex
)
1 change: 1 addition & 0 deletions glscopeclient-manual.tex
Original file line number Diff line number Diff line change
@@ -75,6 +75,7 @@
\FloatBarrier
\include{section-waveformgroups}
\include{section-timeline}
\include{section-triggers}
\include{section-waveformviews}
\include{section-history}
\include{section-protoanalyzer}
Binary file added images/trigger-properties.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
2 changes: 2 additions & 0 deletions section-gettingstarted.tex
Original file line number Diff line number Diff line change
@@ -215,3 +215,5 @@ \section{Design Philosophy}

Most UI elements can be interacted with by left clicking (select), left dragging (move), using the scroll wheel (zoom),
double clicking (open properties dialog), or right clicking (context menu).

Most text fields allow SI prefixes for scaling values (mV, us, GHz, etc).
51 changes: 51 additions & 0 deletions section-triggers.tex
Original file line number Diff line number Diff line change
@@ -0,0 +1,51 @@
\chapter{Triggers}

\section{Trigger Properties}

The \menustyle{Setup / Trigger} menu opens the trigger properties dialog (Fig. \ref{trigger-properties}).

The Trigger Type box allows the type of trigger to be chosen. The list of available triggers depends on the instrument
model and installed software options.

The Trigger Offset field specifies the time from the \emph{start} of the waveform to the trigger point. Positive values
move the trigger later into the waveform, negative values introduce a delay between the trigger and the start of the
waveform. \footnote{This is a different convention than most oscilloscopes, which measure the trigger position from the
\emph{midpoint} of the waveform. Since glscopeclient decouples the acquisition length from the UI zoom setting,
measuring from the midpoint makes little sense as there are no obvious visual cues to the midpoint's location.}

\begin{figure}[h]
\centering
\includegraphics[width=9cm]{images/trigger-properties.png}
\caption{Trigger properties dialog}
\label{trigger-properties}
\end{figure}

The remaining settings in the trigger properties dialog depend on the specific trigger type chosen.

\section{Dropout}

Triggers when a signal stops toggling for a specified amount of time.

\section{Edge}

Triggers on edges in the signal.

\section{Pulse Width}

Triggers when a high or low pulse meeting specified width criteria is seen.

\section{Runt}

Triggers when a pulse crosses one threshold, but not a second.

\section{Slew Rate}

Triggers when an edge is faster or slower than a specified rate.

\section{UART}

Triggers when a byte or byte sequence is seen on a UART.

\section{Window}

Triggers when a signal goes above or below specified thresholds.
6 changes: 4 additions & 2 deletions section-waveformviews.tex
Original file line number Diff line number Diff line change
@@ -33,10 +33,12 @@ \section{Y Axis Scale}

If the waveform view is connected to a physical channel of an instrument, the gain may be configured by scrolling with
the mouse wheel, and the offset may be adjusted by dragging with the left mouse button. If the view is displaying the
output of a filter block, gain and offset are set by the filter and not adjustable.
output of a filter block, gain and offset are set by the filter and generally not adjustable, although some (such as
FFTs) do allow adjustment.

If a left-pointing arrow (as seen in Fig. \ref{y-axis}) is visible, the current channel is selected as a trigger
source. Click on the arrow and drag up or down to select the trigger level.
source. Click on the arrow and drag up or down to select the trigger level. Some trigger types, such as window triggers,
have two arrows for upper and lower levels.

\begin{figure}[H]
\centering