4456 -> 4456-4457: add almazny

4456-4457.tex

@@ -1,10 +1,10 @@
 \input{preamble.tex}
-\graphicspath{{images/4456}{images}}
+\graphicspath{{images/4456-4457}{images}}
 
-\title{4456 Synthesizer Mirny}
+\title{4456 Synthesizer Mirny / 4457 HF Synthesizer Mirny + Almazny}
 \author{M-Labs Limited}
-\date{January 2022}
+\date{January 2025}
-\revision{Revision 1}
+\revision{Revision 2}
 \companylogo{\includegraphics[height=0.73in]{artiq_sinara.pdf}}
 
 \begin{document}
@@ -14,8 +14,8 @@
 
 \begin{itemize}
     \item{4-channel VCO/PLL}
-\item{Output frequency ranges from 53 MHz to \textgreater 4 GHz}
+    \item{Output frequency ranges from 53 MHz to \textgreater 4 GHz for 4456 Mirny only}
-\item{Up to 13.6 GHz with Almazny mezzanine}
+    \item{Up to 13.6 GHz with 4457 mezzanine Almazny}
     \item{Higher frequency resolution than Urukul}
     \item{Lower jitter and phase noise}
     \item{Large frequency changes take several milliseconds}
@@ -30,12 +30,11 @@
 \end{itemize}
 
 \section{General Description}
-The 4456 Synthesizer Mirny card is a 4hp EEM module, part of the ARTIQ/Sinara family. It adds microwave generation capabilities to carrier cards such as 1124 Kasli and 1125 Kasli-SoC.
+    The 4456 Synthesizer Mirny card is a 4hp EEM module; the 4457 HF Synthesizer Mirny + Almazny card, consisting of 4456 Mirny plus the 4-channel Almazny HF mezzanine, is a 8hp EEM module. Both Synthesizer cards add microwave generation capabilities to carrier cards such as 1124 Kasli and 1125 Kasli-SoC.
 
-It provides 4 channels of PLL frequency synthesis. Output frequencies from 53 MHz to \textgreater 4 GHz are supported.The range can be expanded up to 13.6 GHz with the Almazny mezzanine (4467 HF Synthesizer).
+    Both cards provide 4 channels of PLL frequency synthesis. 4456 Synthesizer Mirny supports output frequencies from 53 MHz to \textgreater 4GHz. As 4457 HF Synthesizer with Almazny mezzanine this range is expanded up to 13.6 GHz.
-
-Each channel can be attenuated from 0 to -31.5 dB by a digital attenuator. RF switches on each channel provides at least 50 dB isolation.
 
+    Each channel can be attenuated from 0 to -31.5 dB by a digital attenuator. RF switches on each channel provide at least 50 dB isolation.
 
 % Switch to next column
 \vfill\break
@@ -275,16 +274,30 @@ Each channel can be attenuated from 0 to -31.5 dB by a digital attenuator. RF sw
 
 \begin{figure}[hbt!]
     \centering
-    \includegraphics[height=2in]{photo4456.jpg}
+    \includegraphics[height=2in]{photo4457.jpg}
-    \includegraphics[height=3in, angle=90]{Mirny_FP.pdf}
+    \caption{Mirny + Almazny card}
-    \caption{Mirny card and front panel}
 \end{figure}
 
 % For wide tables, a single column layout is better. It can be switched
 % page-by-page.
 \onecolumn
 
-\sourcesection{4456 Synthesizer Mirny}{https://github.com/sinara-hw/mirny}
+\begin{figure}[hbt!]
+    \subfloat[\centering Mirny and Almazny front panels]{{
+        \begin{minipage}[b]{0.5\linewidth}
+            \centering
+            \includegraphics[height=3in, angle=90]{fp4456.pdf} \\
+            \vspace{0.2in}
+            \includegraphics[height=3in, angle=90]{fp4457.pdf}
+            \vspace{0.25in}
+        \end{minipage}
+    }}
+    \subfloat[\centering Mirny, top-down view]{{
+        \includegraphics[height=2.5in]{photo4456.jpg}
+    }}
+\end{figure}
+
+\sourcesectiond{4456 Synthesizer Mirny}{the 4457 Almazny mezzanine}{https://github.com/sinara-hw/mirny}{https://github.com/sinara-hw/Almazny}
 
 \section{Electrical Specifications}
 
@@ -326,28 +339,37 @@ Test results are from Krzysztof Belewicz's thesis. "Microwave synthesizer for dr
         \textbf{Parameter} & \textbf{Min.} & \textbf{Typ.} & \textbf{Max.} &
         \textbf{Unit} & \textbf{Conditions} \\
         \hline
-    Frequency & 53.125 &  & 4000 & MHz & \\
+        Frequency & 53.125 &  & 4000 & MHz & 4456 Mirny only \\
+        & &  & 13600 & MHz & With Almazny mezzanine \\
         \hline
         Digital attenuation\repeatfootnote{attenuator} & -31.5 & & 0 & dB & \\
         \hline
-    Resolution & \multicolumn{4}{c|}{} & \\
-    \hspace{3mm} Frequency\repeatfootnote{adf5356} & \multicolumn{4}{c|}{52 bits} & \\
-    \hspace{3mm} Phase offset\repeatfootnote{adf5356} & \multicolumn{4}{c|}{24 bits} & \\
-    \hspace{3mm} Digital attenuation\repeatfootnote{attenuator} & \multicolumn{4}{c|}{0.5 dB} & \\
-    \thickhline
     \end{tabularx}
     \end{threeparttable}
     \end{table}
 
 \newpage
 
-Phase noise performance of Mirny was tested using the ADF4351 evaluation kit\repeatfootnote{mirny_thesis}. The SPI signal was driven by the evaluation kit, converted into LVDS signal by propagating through the DIO-tester card, finally arriving at the Mirny card. Mirny was then connected to the RSA5100A spectrum analyzer for measurement.
+\begin{table}[h]
+    \centering
+    \begin{threeparttable}
+    \caption{Output Specifications, cont.}
+    \begin{tabularx}{0.9\textwidth}{l | c c c | c | X}
+        \thickhline
+        \textbf{Parameter} & \textbf{Min.} & \textbf{Typ.} & \textbf{Max.} &
+        \textbf{Unit} & \textbf{Conditions} \\
+        Resolution & & & & \\
+        \hspace{3mm} Frequency\repeatfootnote{adf5356} & \multicolumn{3}{c|}{52} & bits & \\
+        \hspace{3mm} Phase offset\repeatfootnote{adf5356} & \multicolumn{3}{c|}{24} & bits & \\
+        \hspace{3mm} Digital attenuation\repeatfootnote{attenuator} & \multicolumn{3}{c|}{0.5} & dB & \\
+        \thickhline
+    \end{tabularx}
+    \end{threeparttable}
+    \end{table}
+
+    Phase noise performance of 4456 Mirny was tested using the ADF4351 evaluation kit\repeatfootnote{mirny_thesis}. The SPI signal was driven by the evaluation kit, converted into LVDS signal by propagating through the DIO-tester card, finally arriving at the Mirny card. 4456 Mirny was then connected to the RSA5100A spectrum analyzer for measurement.
 
     Noise response spike can be improved by inserting an additional common-mode choke between the power supply and Mirny; note that this common-mode choke is not present on the card itself. The following is a comparison between the two setups at 1 GHz output:
-\begin{itemize}
-    \item Red: Before any modifications
-    \item Blue: CM choke added with an 100 \textmu F capacitor after the CM choke
-\end{itemize}
 
     \begin{figure}[H]
         \centering
@@ -355,6 +377,13 @@ Noise response spike can be improved by inserting an additional common-mode chok
         \caption{Phase noise measurement at 1 GHz}
     \end{figure}
 
+    \begin{itemize}
+        \item Red: Before any modifications
+        \item Blue: CM choke added with an 100 \textmu F capacitor after the CM choke
+    \end{itemize}
+
+\newpage
+
     Phase noise at different output frequencies is then measured:
 
     \newcolumntype{Y}{>{\centering\arraybackslash}X}
@@ -383,14 +412,42 @@ Phase noise at different output frequencies is then measured:
     \end{threeparttable}
     \end{table}
 
-\newpage
-
     \begin{figure}[H]
         \centering
         \includegraphics[height=3in]{mirny_phase_noise_frequency.png}
         \caption{Phase noise measurement}
     \end{figure}
 
+\newpage
+\sysdescsection
+
+    4456 Synthesizer Mirny must be entered in the \texttt{peripherals} list of the corresponding core device in the following format:
+
+    \begin{tcolorbox}[colback=white]
+        \begin{minted}{json}
+            {
+                "type": "mirny",
+                "ports": 0,
+                "clk_sel": "mmcx", // optional
+                "refclk": 125e6 // optional
+            }
+        \end{minted}
+    \end{tcolorbox}
+
+    Replace 0 with the EEM port number used on the core device. Any port can be used. The \texttt{clk\_sel} field is optional and may be specified as one of either \texttt{xo}, \texttt{mmcx}, or \texttt{sma}. The default is \texttt{xo}. The \texttt{refclk} field is optional and the default is \texttt{100e6}.
+
+    For 4457 Mirny + Almazny, one field must be added:
+
+    \begin{tcolorbox}[colback=white]
+        \begin{minted}{json}
+            {
+                "type": "mirny",
+                "almazny": true,
+                "ports": 0
+            }
+        \end{minted}
+    \end{tcolorbox}
+
 \codesection{4456 Synthesizer Mirny}
 
     \subsection{1 GHz sinusoidal wave}
@@ -426,7 +483,7 @@ The output can be toggled on and off periodically using the RF switches. The fol
 
     \inputcolorboxminted{firstline=42,lastline=44}{examples/pll.py}
 
-\ordersection{4456 Synthesizer Mirny}
+\ordersection{4456 Synthesizer Mirny or 4457 HF Synthesizer Mirny + Almazny}
 
 \finalfootnote