5432: spellcheck, style

5432.tex

@@ -1,4 +1,4 @@
-\include{preamble.tex}
+\input{preamble.tex}
 \graphicspath{{images/5432}{images}}
 
 \title{5432 DAC Zotino}
@@ -13,30 +13,26 @@
 \section{Features}
 
 \begin{itemize}
-\item{32-channel DAC.}
-\item{16-bits resolution.}
-\item{1 MSPS shared between all channels.}
-\item{Output voltage $\pm$10V.}
-\item{HD68 connector.}
-\item{Can be broken out to BNC/SMA/MCX.}
+\item{32-channel DAC}
+\item{16-bits resolution}
+\item{1 MSPS shared between all channels}
+\item{Output voltage $\pm$10V}
+\item{HD68 connector}
+\item{Can be broken out to BNC/SMA/MCX}
 \end{itemize}
 
 \section{Applications}
 
 \begin{itemize}
-\item{Controlling setpoints of PID controllers for laser power stabilization.}
-\item{Low-frequency arbitrary waveform generation.}
-\item{Driving DC electrodes in ion traps.}
+\item{Controlling setpoints of PID controllers for laser power stabilization}
+\item{Low-frequency arbitrary waveform generation}
+\item{Driving DC electrodes in ion traps}
 \end{itemize}
 
 \section{General Description}
-The 5432 Zotino is a 4hp EEM module part of the ARTIQ Sinara family.
-It adds digital-analog converting capabilities to carrier cards such as 1124 Kasli and 1125 Kasli-SoC.
+The 5432 Zotino is a 4hp EEM module and part of the ARTIQ/Sinara family. It adds digital-analog conversion capabilities to carrier cards such as 1124 Kasli and 1125 Kasli-SoC.
 
-It provides 4 groups of 8 analog channels each, exposed by 1 HD68 connector.
-Each channel supports output voltage from -10 V to 10 V.
-All channels can be updated simultaneously.
-Channels can broken out to BNC, SMA or MCX by adding external 5518 BNC-IDC, 5528 SMA-IDC or 5538 MCX-IDC cards.
+It provides four groups of eight analog channels each, exposed by one HD68 connector. Each channel supports output voltage from -10 V to 10 V. All channels can be updated simultaneously. Channels can broken out to BNC, SMA or MCX by adding external 5518 BNC-IDC, 5528 SMA-IDC or 5538 MCX-IDC cards.
 
 % Switch to next column
 \vfill\break
@@ -102,7 +98,7 @@ Channels can broken out to BNC, SMA or MCX by adding external 5518 BNC-IDC, 5528
         % Thermistor for TEC controller
         \draw (6.6, 3.3) node[thermistorshape, scale=0.7, rotate=-90] (thermistor) {};
         \draw [latexslim-] (7.85, 3.3) -- (6.75, 3.3);
-        
+
         % Connect the controller to the cooler
         \draw [-latexslim] (7.85, 4.2) -- (4.6, 4.2) -- (tec_cooler.north);
 
@@ -115,24 +111,33 @@ Channels can broken out to BNC, SMA or MCX by adding external 5518 BNC-IDC, 5528
     \caption{Simplified Block Diagram}
 \end{figure}
 
-\begin{figure}[h]
+
+\begin{figure}[hbt!]
     \centering
-    \includegraphics[height=2in]{Zotino_FP.jpg}
     \includegraphics[height=2in]{photo5432.jpg}
-    \caption{Zotino Card photo}
+    \caption{Zotino card photograph}
+\end{figure}
+
+
+\begin{figure}[hbt!]
+    \centering
+    \includegraphics[height=2.3in, angle=90]{Zotino_FP.jpg}
+    \caption{Zotino front panel}
 \end{figure}
 
 % For wide tables, a single column layout is better. It can be switched
 % page-by-page.
 \onecolumn
 
+\sourcesection{5432 DAC Zotino}{https://github.com/sinara-hw/Zotino/}
+
 \section{Electrical Specifications}
 
 % \hypersetup{hidelinks}
 % \urlstyle{same}
-The specifications are based on the datasheet of the DAC IC
-(AD5372BCPZ\footnote{\label{dac}https://www.analog.com/media/en/technical-documentation/data-sheets/AD5372\_5373.pdf}),
-and various information from Sinara wiki\footnote{\label{zotino_wiki}https://github.com/sinara-hw/Zotino/wiki}.
+These specifications are based on the datasheet of the DAC IC
+(AD5372BCPZ\footnote{\label{dac}\url{https://www.analog.com/media/en/technical-documentation/data-sheets/AD5372\_5373.pdf}}),
+and various information from the Sinara wiki\footnote{\label{zotino_wiki}\url{https://github.com/sinara-hw/Zotino/wiki}}.
 
 \begin{table}[h]
 \centering
@@ -157,9 +162,7 @@ and various information from Sinara wiki\footnote{\label{zotino_wiki}https://git
 \end{threeparttable}
 \end{table}
 
-The following are cross-talk and transient behavior of Zotino\footnote{\label{zotino21}https://github.com/sinara-hw/Zotino/issues/21}.
-In terms of output noise, it was measured after 15 cm IDC cable, IDC-SMA, 100 cm coax ($\sim$50 pF), and 500 k$\Omega$ $||$ 150 pF\footnote{\label{zotino27}https://github.com/sinara-hw/Zotino/issues/27}.
-The DAC output during noise measurement is 3.5 V.
+The following table records the cross-talk and transient behavior of Zotino\footnote{\label{zotino21}\url{https://github.com/sinara-hw/Zotino/issues/21}}. In terms of output noise, measurements were made after a 15-cm IDC cable, IDC-SMA, 100 cm coax ($\sim$50 pF), and 500 k$\Omega$ $||$ 150 pF\footnote{\label{zotino27}\url{https://github.com/sinara-hw/Zotino/issues/27}}. DAC output during noise measurement was 3.5 V.
 
 \begin{table}[h]
 \centering
@@ -194,7 +197,7 @@ The DAC output during noise measurement is 3.5 V.
 
 \newpage
 
-Step response are found by setting the DAC register to 0x0000 (-10V) or 0xFFFF (10V) and observe the waveform\repeatfootnote{zotino21}.
+Step response was found by setting the DAC register to 0x0000 (-10V) or 0xFFFF (10V) and observing the waveform\repeatfootnote{zotino21}.
 
 \begin{figure}[hbt!]
     \centering
@@ -207,12 +210,12 @@ Step response are found by setting the DAC register to 0x0000 (-10V) or 0xFFFF (
     \caption{Step response}%
 \end{figure}
 
-Far-end crosstalk is measured using the following setup\repeatfootnote{zotino21}.
+Far-end crosstalk was measured using the following setup\repeatfootnote{zotino21}:
 
 \begin{enumerate}
     \item CH1 as aggressor, CH0 as victim
     \item CH0, 2-7 terminated, CH 8-31 open
-    \item Aggressor signal from BNC passed through 15cm IDC26, 2m HD68-HD68 SCSI-3 shielded twisted pair, 15cm IDC26, converted back to BNC with adapters between all different cables \& connectors.
+    \item Aggressor signal from BNC passed through 15cm IDC26, 2m HD68-HD68 SCSI-3 shielded twisted pair, 15cm IDC26, converted back to BNC with adapters between all different cables and connectors.
 \end{enumerate}
 
 \begin{figure}[hbt!]
@@ -223,83 +226,24 @@ Far-end crosstalk is measured using the following setup\repeatfootnote{zotino21}
 
 \newpage
 
-\section{Front Panel Drawings}
-\begin{multicols}{2}
+\codesection{5432 DAC Zotino}
 
-\begin{center}
-    \centering
-    \includegraphics[height=3in]{zotino_drawings.pdf}
-    \captionof{figure}{5432 DAC Zotino front panel drawings}
-\end{center}
-
-\begin{center}
-    \captionof{table}{Bill of Material (Standalone)}
-    \tiny
-    \begin{tabular}{|c|c|c|c|}
-    \hline
-    Index & Part No. & Qty & Description \\ \hline
-    1 & 90503572 & 1 & FRONT PANEL 3U 4HP PIU TYPE2 \\ \hline
-    2 & 3020716 & 0.02 & SLEEVE GREY PLAS.M2.5 (100PCS) \\ \hline
-    3 & 3218843 & 2 & FP-ALIGNMENT PIN (LOCALIZATION) \\ \hline
-    \end{tabular}
-\end{center}
-
-\columnbreak
-
-\begin{center}
-    \centering
-    \includegraphics[height=3in]{zotino_assembly.pdf}
-    \captionof{figure}{5432 DAC Zotino front panel assembly}
-\end{center}
-
-\begin{center}
-    \captionof{table}{Bill of Material (Assembled)}
-    \tiny
-    \begin{tabular}{|c|c|c|c|}
-    \hline
-    Index & Part No. & Qty & Description \\ \hline
-    1 & 90503572 & 1 & FP-LYKJ 3U4HP PANEL \\ \hline
-    2 & 3001012 & 2 & SCR M2.5*6 PAN PHL NI DIN7985 \\ \hline
-    3 & 3010110 & 0.02 & WASHER PLN.M2.7 DIN125 (100X) \\ \hline
-    4 & 3010124 & 0.1 & EMC GASKET FABRIC 3U (10PCS) \\ \hline
-    5 & 3033098 & 0.02 & SCREW COLLAR M2.5X12.3 (100X) \\ \hline
-    6 & 3040012 & 1 & HANDLE 4HP GREY PLASTIC \\ \hline
-    7 & 3040138 & 2 & PB HOLDER DIE-CAST \\ \hline
-    8 & 3207075 & 0.01 & SCR M2.5*12 PAN 100 21101-221 \\ \hline
-    9 & 3201099 & 0.01 & SCR M2.5*8 OVL PHL ST NI 100EA \\ \hline
-    \end{tabular}
-\end{center}
-
-\end{multicols}
-\newpage
-
-\section{Example ARTIQ code}
-The sections below demonstrate simple usage scenarios of the 5432 DAC Zotino card with the ARTIQ control system.
-They do not exhaustively demonstrate all the features of the ARTIQ system.
-The full documentation for the ARTIQ software and gateware is available at \url{https://m-labs.hk}.
-
-\subsection{Set output voltage}
-The following example initializes the Zotino card, then emits 1.0 V, 2.0 V, 3.0 V and 4.0 V at channel 0, 1, 2, 3 respectively.
-Voltages of all 4 channels are updated simultaneously with the use of \texttt{set\char`_dac()}.
+\subsection{Setting output voltage}
+The following example initializes the Zotino card, then emits 1.0 V, 2.0 V, 3.0 V and 4.0 V at channels 0, 1, 2, and 3 respectively. Voltages of all 4 channels are updated simultaneously with the use of \texttt{set\char`_dac()}.
 
 \inputcolorboxminted{firstline=11,lastline=22}{examples/zotino.py}
 
 \newpage
 
-\subsection{Triangular Wave}
-A triangular waveform at 10 Hz, 16 V peak-to-peak.
-Timing accuracy of the RTIO system can be demonstrated by the precision of the frequency.
+\subsection{Triangular wave}
+Generates a triangular waveform at 10 Hz, 16 V peak-to-peak. Timing accuracy of the RTIO system can be demonstrated by the precision of the frequency.
 
 Import \texttt{scipy.signal} and \texttt{numpy} modules to run this example.
 
 \inputcolorboxminted{firstline=30,lastline=49}{examples/zotino.py}
 
-\section{Ordering Information}
-To order, please visit \url{https://m-labs.hk} and select the 5432 DAC Zotino in the ARTIQ Sinara crate configuration tool. The card may also be ordered separately by writing to \url{mailto:sales@m-labs.hk}.
+\ordersection{5432 DAC Zotino}
 
-\section*{}
-\vspace*{\fill}
-
-\input{footnote.tex}
+\finalfootnote
 
 \end{document}