Sync hardware deliverables and manual after pre-fab design review.
Refresh BOM (2026-07-09 CSV), Gerbers, EasyEDA project, pick-and-place, and schematic export; document corrected ADAU crystal/PLL strapping and Si4684 reference clock in the manual; add PCBWay acknowledgement on the back cover only. Co-authored-by: Cursor <cursoragent@cursor.com>
This commit is contained in:
Binary file not shown.
|
Before Width: | Height: | Size: 337 KiB |
@@ -0,0 +1,41 @@
|
||||
No.;Quantity;Comment;Designator;MPN;Footprint;Part Name;LCSC;Category;ANNOTATION
|
||||
1;15;100nF;C1,C3,C8,C10,C11,C28,C30,C31,C32,C34,C36,C37,C38,C42,C48;CL05B104KB54PNC;C0402;100nF ±10% 50V;C307331;Capacitors:Multilayer Ceramic Capacitors MLCC - SMD/SMT;
|
||||
2;7;10uF;C2,C29,C33,C35,C40,C43,C47;GRM21BR61H106KE43L;C0805;10uF ±10% 50V;C440198;Capacitors:Multilayer Ceramic Capacitors MLCC - SMD/SMT;
|
||||
3;3;22uF;C4,C5,C9;CL21A226MAQNNNE;C0805;22uF ±20% 25V;C45783;Capacitors:Multilayer Ceramic Capacitors MLCC - SMD/SMT;
|
||||
4;7;1uF;C6,C7,C12,C17,C23,C26,C27;HGC0402R5105K500NTEJ;C0402;1uF ±10% 25V,1uF ±10% 50V;C7472948;Capacitors:Multilayer Ceramic Capacitors MLCC - SMD/SMT;
|
||||
5;1;33pF;C13;CL05C330JB5NNNC;C0402;33pF ±5% 50V;C70465;Capacitors:Multilayer Ceramic Capacitors MLCC - SMD/SMT;
|
||||
6;1;2.7pF;C14;GJM1555C1H2R7BB01D;C0402;±0.1pF 2.7pF 50V;C76904;Capacitors:Multilayer Ceramic Capacitors MLCC - SMD/SMT;
|
||||
7;3;8.2pF;C15,C21,C24;CSA0402C0G8R2B500GT;C0402;8.2pF 50V;C48642899;Capacitors:Multilayer Ceramic Capacitors MLCC - SMD/SMT;
|
||||
8;3;2.2nF;C16,C22,C25;CC0402KRX7R8BB222;C0402;2.2nF ±10% 25V;C541386;Capacitors:Multilayer Ceramic Capacitors MLCC - SMD/SMT;
|
||||
9;1;47nF;C39;CC0402KRX7R9BB473;C0402;47nF ±10% 50V;C272875;Capacitors:Multilayer Ceramic Capacitors MLCC - SMD/SMT;
|
||||
10;2;22pF;C41,C46;0402CG220J500NT;C0402;22pF ±5% 50V;C1555;Capacitors:Multilayer Ceramic Capacitors MLCC - SMD/SMT;
|
||||
11;1;3.3nF;C44;CC0402KRX7R9BB332;C0402;3.3nF ±10% 50V;C107028;Capacitors:Multilayer Ceramic Capacitors MLCC - SMD/SMT;
|
||||
12;1;56nF;C45;CGA0402X7R563K160GT;C0402;56nF ±10% 16V;C36911349;Capacitors:Multilayer Ceramic Capacitors MLCC - SMD/SMT;
|
||||
13;2;15pF;C49,C50;0402CG150J500NT;C0402;15pF ±5% 50V;C1548;Capacitors:Multilayer Ceramic Capacitors MLCC - SMD/SMT;
|
||||
14;1;8.2pF;C51;CC0603CPNPO9BN8R2;C0603;±0.25pF 8.2pF 50V;C3847265;Capacitors:Multilayer Ceramic Capacitors MLCC - SMD/SMT;
|
||||
15;1;2.2nF;C52;0603B222K500NT;C0603;2.2nF ±10% 50V;C1604;Capacitors:Multilayer Ceramic Capacitors MLCC - SMD/SMT;
|
||||
16;1;1uF;C53;CL10A105KB8NNNC;C0603;1uF ±10% 50V;C15849;Capacitors:Multilayer Ceramic Capacitors MLCC - SMD/SMT;
|
||||
17;1;ZX-XH2.54-4PWZ;CN1;ZX-XH2.54-4PWZ;CONN-TH_4P-P2.50_ZX-XH2.54-4PWZ;1x4P 间距:2.5mm 弯插 系列:XH;C7429643;Connectors:Wire To Board Connector;
|
||||
18;1;SS34;D1;SS34;SMA_L4.3-W2.6-LS5.2-RD;电压:40V 电流:3A;C8678;Diodes:Schottky Diodes;
|
||||
19;1;SRV05-4;D2;SRV05-4;SOT-23-6_L2.9-W1.6-P0.95-LS2.8-BL;单向ESD 5V截止 峰值脉冲电流:3A;C558418;Circuit Protection:ESD and Surge Protection (TVS/ESD);
|
||||
20;1;BAV99,215;D3;BAV99,215;SOT-23-3_L2.9-W1.6-P1.90-LS2.8-BR;100V 215mA;C2500;Diodes:Switching Diodes;
|
||||
21;1;18nH;L1;LQG15HS18NJ02D;L0402-RD;18nH ±5%;C86060;Inductors, Coils, Chokes:Inductors (SMD);
|
||||
22;1;22nH;L2;LQW15AN22NH00D;IND-SMD_L1.0-W0.5-2;22nH ±3%;C703122;Inductors, Coils, Chokes:Power Inductors;
|
||||
23;1;120nH;L3;LQW15ANR12J00D;L0402;120nH ±5%;C113123;Inductors, Coils, Chokes:Power Inductors;
|
||||
24;3;2kΩ;R1,R16,R19;0402WGF2001TCE;R0402;2kΩ ±1% 62.5mW 厚膜电阻;C4109;Resistors:Chip Resistor - Surface Mount;
|
||||
25;7;10kΩ;R2,R5,R6,R7,R8,R12,R13;0402WGF1002TCE;R0402;10kΩ ±1% 62.5mW 厚膜电阻;C25744;Resistors:Chip Resistor - Surface Mount;
|
||||
26;2;5.1kΩ;R3,R4;0402WGF5101TCE;R0402;5.1kΩ ±1% 62.5mW 厚膜电阻;C25905;Resistors:Chip Resistor - Surface Mount;
|
||||
27;1;100Ω;R17;0402WGF1000TCE;R0402;100Ω ±1% 62.5mW 厚膜电阻;C25076;Resistors:Chip Resistor - Surface Mount;
|
||||
28;1;475Ω;R18;RT0402BRD07475RL;R0402;薄膜电阻 475Ω ±0.1% 63mW;C852800;Resistors:Chip Resistor - Surface Mount;
|
||||
29;1;18GHz;RF1;733910083;SMA-TH_733910083;内孔 SMA 弯头;C493445;Connectors:Coaxial Connectors (RF);
|
||||
30;2;TS3425UA-3x4x2.5-160;SW1,SW2;TS3425UA-3x4x2.5-160;SW-SMD_4P-L4.2-W3.4_HX-TS3425PA-250GF-B;4.2mm*3.2mm 12V 50mA;C51927439;Switches:Tactile Switches;
|
||||
31;1;AP63203WU-7;U1;AP63203WU-7;TSOT-26_L2.9-W1.6-P0.95-LS2.8-BL;降压型 2A 3.8V~32V;C780769;Power Management (PMIC):DC-DC Converters;
|
||||
32;1;4.7uH;U2;BCIHP0420SC-4R7M;IND-SMD_L4.4-W4.2;4.7uH ±20% 3A;C2921168;Inductors, Coils, Chokes:Inductors (SMD);
|
||||
33;1;TPS7A2018PDBVR;U3;TPS7A2018PDBVR;TSOT-23-5_L2.9-W1.6-P0.95-LS2.8-BL;具有高 PSRR 的 300mA、超低噪声、低 IQ、低压降 (LDO) 线性稳压器;C963430;Power Management (PMIC):Voltage Regulators - Linear, Low Drop Out (LDO) Regulators;
|
||||
34;1;24AA025E48T-I/OT;U4;24AA025E48T-I/OT;SOT-23-6_L2.9-W1.6-P0.95-LS2.8-BR;带EUI-48或EUI-64节点标识的2K I2C串行EEPROM;C129895;Memory:EEPROM;EXACT MATCH
|
||||
35;1;SI4684-A10-GM;U6;SI4684-A10-GM;QFN-48_L7.0-W7.0-P0.50-TL-EP5.3;单芯片调频/数字音频广播/增强型数字音频广播收音机接收器;C1526088;RF and Wireless:RF Transceiver ICs;EXACT MATCH
|
||||
36;1;19.2MHz;U7;ABM8-19.200MHZ-10-1-U-T;CRYSTAL-SMD_4P-L3.2-W2.5-BL;19.2MHz ±10ppm 10pF;C1986852;Crystals, Oscillators, Resonators:Crystals;EXACT MATCH
|
||||
37;1;2.4GHz;U8;ESP32-S3-WROOM-1-N16;WIRELM-SMD_ESP32-S3-WROOM-1;不带固件 通用型Wi-Fi+低功耗蓝牙MCU模组;C2913199;IoT/Communication Modules:WiFi Modules;EXACT MATCH
|
||||
38;1;ADAU1701JSTZ-RL;U9;ADAU1701JSTZ-RL;LQFP-48_L7.0-W7.0-P0.50-LS9.0-TL;28-/56位音频处理器;C389590;Interface:Audio Interface ICs;EXACT MATCH
|
||||
40;1;TYPE-C-31-M-12;USBC1;TYPE-C-31-M-12;USB-C_SMD-TYPE-C-31-M-12_1;Type-C 母 卧贴;C165948;Connectors:USB Connectors;
|
||||
41;1;12.288MHz;X1;XTM32012288JT00351001;CRYSTAL-SMD_4P-L3.2-W2.5-BL;12.288MHz 4P 3225 12pF ±10ppm -20~70℃(±10ppm);C41383238;Crystals, Oscillators, Resonators:Crystals;EXACT MATCH
|
||||
|
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
File diff suppressed because it is too large
Load Diff
@@ -334,10 +334,20 @@ the pin definitions in the source code must match it exactly.
|
||||
\section{Design validation and critical checks}
|
||||
\label{sec:hw-validation}
|
||||
|
||||
A datasheet-level design review was performed in July~2026, before prototype
|
||||
fabrication, against \drpath{Hardware/DATASHEET/adau1701.pdf} and
|
||||
\drpath{Hardware/DATASHEET/SI4684-A10.pdf}. It found and corrected two
|
||||
defects on the schematic: \textbf{PLL\_MODE1} was tied to GND (which would
|
||||
have selected 64\,$\times$\,f\textsubscript{S} and run the ADAU1701 clock
|
||||
domain at 192\,kHz instead of 48\,kHz), and the Si4684 reference-crystal
|
||||
load capacitors were 12\,pF instead of the 15\,pF required for the
|
||||
10\,pF crystal (frequency pull, degraded RF). The board shipped with both
|
||||
fixes applied; the tables below record the \emph{as-fabricated} values.
|
||||
|
||||
This section records the design-review checks performed against the
|
||||
component datasheets before fabrication, chip by chip. Items marked
|
||||
\emph{critical} can cause permanent damage or a non-functional board if
|
||||
violated, and were verified explicitly.
|
||||
violated, and were verified explicitly against the schematic.
|
||||
|
||||
\subsection{Si4684 tuner}
|
||||
\label{sec:hw-val-si4684}
|
||||
@@ -379,6 +389,9 @@ satisfying the +10\,\textmu s requirement in practice.
|
||||
VIO level & 1.62--3.6\,V (3.3\,V to talk to ESP32) & verified \\
|
||||
Bypass caps & 2.2\,nF + 1\,\textmu F per VIO/VMEM/VCORE rail & verified \\
|
||||
SPI mode & Mode 0 or 3, up to 10\,MHz, SMODE = GND & verified \\
|
||||
Reference crystal & U7: 19.2\,MHz, CL = 10\,pF (XTALI/XTALO) & verified \\
|
||||
Crystal load caps & C49/C50: 15\,pF C0G each (was 12\,pF in review) & verified \\
|
||||
RSTB / INTB resistors & 10\,k\(\Omega\) pull-down / 10\,k\(\Omega\) pull-up & verified \\
|
||||
SSB framing (firmware) & SSB held low for the whole transaction & driver rule \\
|
||||
INTB & interrupt line, external pull-up (GPIO39) & verified \\
|
||||
\bottomrule
|
||||
@@ -396,6 +409,18 @@ Guide}. Boot and command protocol: AN649. Local copies:
|
||||
\drpath{Hardware/DATASHEET/} (see \drpath{README.md}).
|
||||
\end{drref}
|
||||
|
||||
\begin{drnote}[Reference crystal and load capacitors]
|
||||
U7 is a 19.2\,MHz quartz (ABRACON ABM8-19.200MHZ-10-1-U-T) with
|
||||
\textbf{CL = 10\,pF} on XTALI (pin~15) and XTALO (pin~16). Load capacitors
|
||||
C49 and C50 are \textbf{15\,pF C0G/NP0} ($\pm$5\%) --- not X5R/X7R, which
|
||||
drift with temperature and bias. Quartz load caps must be C0G/NP0.
|
||||
|
||||
Effective load: \(C_{L,\mathrm{eff}} = \frac{C_1 C_2}{C_1 + C_2} + C_{\mathrm{stray}}\).
|
||||
With 15\,pF caps the effective load is $\sim$9.5\,pF (correct for CL = 10\,pF).
|
||||
The original 12\,pF pair gave $\sim$8\,pF effective, pulling the oscillator
|
||||
high by roughly +10..25\,ppm and degrading tuner RF performance.
|
||||
\end{drnote}
|
||||
|
||||
The core, memory, and analogue rails run at 1.8\,V; only VIO is at 3.3\,V
|
||||
to interface the ESP32. The 2.2\,nF and 1\,\textmu F bypass pairs are
|
||||
placed close to VIO (pin~34), VMEM (pin~35), and VCORE (pin~37) as AN851
|
||||
@@ -414,19 +439,41 @@ loopback (MP10$\rightarrow$MP4, MP11$\rightarrow$MP5). Without it the DSP
|
||||
locks up when input data arrives.
|
||||
\end{drkey}
|
||||
|
||||
\begin{drcaution}[PLL\_MODE strapping --- static, not GPIO]
|
||||
The ADAU1701 PLL multiplier is selected by \textbf{PLL\_MODE0} (pin~38) and
|
||||
\textbf{PLL\_MODE1} (pin~39). These are \emph{static straps} on the board;
|
||||
the ESP32 must never drive them. The datasheet requires both pins to be
|
||||
stable while RESET is held low, because the clock mode is latched as the
|
||||
device leaves reset.
|
||||
|
||||
On the fabricated board: PLL\_MODE0 = GND; PLL\_MODE1 = 3V3 via R2
|
||||
(10\,k\(\Omega\)). This selects \textbf{256\,$\times$\,f\textsubscript{S}}:
|
||||
12.288\,MHz\,/\,256 = 48\,kHz.
|
||||
|
||||
\textbf{Both pins tied to GND} selects 64\,$\times$\,f\textsubscript{S}
|
||||
(192\,kHz) and breaks the entire 48\,kHz I\textsuperscript{2}S clock domain
|
||||
--- the defect caught in the July~2026 review.
|
||||
\end{drcaution}
|
||||
|
||||
\begin{table}[htbp]
|
||||
\centering
|
||||
\small
|
||||
\begin{tabular}{@{}L{2.2cm}L{3.6cm}L{7.2cm}@{}}
|
||||
\drhead Check & Requirement (datasheet) & Status \\
|
||||
\footnotesize
|
||||
\begin{tabular}{@{}L{3.0cm}L{8.0cm}L{2.2cm}@{}}
|
||||
\drhead Check & Requirement (datasheet / schematic) & Status \\
|
||||
\midrule
|
||||
Clock loopback & MP10$\rightarrow$MP4, MP11$\rightarrow$MP5 wired & verified \\
|
||||
Output master & serial output port in Master Mode & verified \\
|
||||
MCLK ratio & exactly 256\,$\times$\,f\textsubscript{S} & verified \\
|
||||
MCLK value & 12.288\,MHz oscillator (256\,$\times$\,48\,kHz) & verified \\
|
||||
I\textsuperscript{2}C pull-ups & 2\,k\(\Omega\) on SDA/SCL (R16/R1) & verified \\
|
||||
MCLK source & X1: 12.288\,MHz crystal (CL = 12\,pF); MCLKI/OSCO;
|
||||
C41/C46 = 22\,pF; R17 = 100\,$\Omega$ on OSCO & verified \\
|
||||
PLL\_MODE strapping & MODE0 = GND, MODE1 = 3V3 (256\,$\times$\,f\textsubscript{S}) & verified \\
|
||||
I\textsuperscript{2}C pull-ups & 2\,k\(\Omega\) on SDA/SCL (R1/R16) & verified \\
|
||||
I\textsuperscript{2}C address & 0x34 (ADDR0 = ADDR1 = GND) & verified \\
|
||||
Self-boot & disabled (host RAM load) & verified \\
|
||||
VDRIVE (pin 17) & tied to GND --- external 1.8\,V rail (TPS7A2018) & verified \\
|
||||
DVDD (pins 13, 24) & both on 1V8 rail & verified \\
|
||||
SELFBOOT (pin 6) & GND --- control-port mode, no self-boot & verified \\
|
||||
RSVD (pin 30) & GND, as datasheet requires & verified \\
|
||||
Self-boot policy & disabled (host RAM load) & verified \\
|
||||
\bottomrule
|
||||
\end{tabular}
|
||||
\caption{ADAU1701 design checks. Reference: ADAU1701 data sheet (Rev.~C),
|
||||
@@ -436,16 +483,35 @@ locks up when input data arrives.
|
||||
|
||||
\begin{drref}[Datasheet]
|
||||
Master-clock loopback and serial-port modes:
|
||||
\texttt{Hardware/DATASHEET/adau1701.pdf}, Rev.~C, Table~63 and the serial-port
|
||||
\drpath{Hardware/DATASHEET/adau1701.pdf}, Rev.~C, Table~63 and the serial-port
|
||||
section. The master clock must be exactly 256\,$\times$\,f\textsubscript{S}.
|
||||
I\textsuperscript{2}C lines require pull-up resistors on SDA and SCL.
|
||||
DigiRadio uses \textbf{2\,k\(\Omega\)} (schematic R1/R16; ADAU1701 datasheet
|
||||
The 12.288\,MHz reference is a \textbf{passive crystal} (X1) between MCLKI
|
||||
(pin~32) and OSCO (pin~31) with 22\,pF load capacitors; the ADAU1701 uses its
|
||||
internal oscillator. I\textsuperscript{2}C lines require pull-up resistors on
|
||||
SDA and SCL. DigiRadio uses \textbf{2\,k\(\Omega\)} (schematic R1/R16; datasheet
|
||||
recommends 2.2\,k\(\Omega\) --- acceptable at 3.3\,V).
|
||||
\end{drref}
|
||||
|
||||
\begin{drnote}[VDRIVE grounded]
|
||||
Pin~17 (VDRIVE) is tied to GND. The board provides an external 1.8\,V rail
|
||||
from the TPS7A2018, so the ADAU1701 internal regulator is unused. The
|
||||
datasheet allows VDRIVE to be tied to ground when an external DVDD supply is
|
||||
present.
|
||||
\end{drnote}
|
||||
|
||||
\begin{drnote}[I\textsuperscript{2}C pull-ups confirmed]
|
||||
Schematic \texttt{DigitalRadio.pdf} and BOM list R1 (SCL) and R16 (SDA) as
|
||||
2\,k\(\Omega\) to 3V3 on the shared ADAU1701/EEPROM bus.
|
||||
2\,k\(\Omega\) to 3V3 on the shared ADAU1701/EEPROM bus (ESP32 sheet).
|
||||
\end{drnote}
|
||||
|
||||
\begin{drnote}[CM and FILTD deviation --- analogue path unused]
|
||||
The ADAU1701 datasheet specifies 47\,\textmu F on CM (pin~40) and 10\,\textmu F
|
||||
on FILTD (pin~41). The fabricated board uses smaller values. This is
|
||||
acceptable because the audio chain is entirely digital (I\textsuperscript{2}S):
|
||||
ADC0/ADC1/ADC\_RES and VOUT0..VOUT3 are left floating, and the on-chip
|
||||
ADCs/DACs are powered down via the SigmaStudio ADC/power-control register.
|
||||
\textbf{Restore the datasheet capacitor values if the on-chip ADCs or DACs are
|
||||
ever used.}
|
||||
\end{drnote}
|
||||
|
||||
\subsection{FSC-BT1035 (QCC3056)}
|
||||
@@ -484,9 +550,9 @@ UART 115200/8/N/1, SSP on, auto-reconnect configurable via
|
||||
\begin{tabular}{@{}L{2.2cm}L{4.8cm}L{6.6cm}@{}}
|
||||
\drhead Area & Item & Status \\
|
||||
\midrule
|
||||
Si4684 & RSTB pull-down, 1.8\,V rails, bypass caps, SPI & verified \\
|
||||
Si4684 & RSTB release only in \texttt{Si4684Driver::boot()} & verified \\
|
||||
ADAU1701 & clock loopback, master mode, 256$\times$f\textsubscript{S} & verified \\
|
||||
Si4684 & RSTB/INTB 10\,k\(\Omega\) resistors, 19.2\,MHz crystal & verified \\
|
||||
ADAU1701 & X1 crystal, PLL\_MODE 256$\times$f\textsubscript{S} & verified \\
|
||||
ADAU1701 & clock loopback, master mode, VDRIVE/DVDD/SELFBOOT & verified \\
|
||||
ADAU1701 & I\textsuperscript{2}C 2\,k\(\Omega\) pull-ups (R1/R16) & verified \\
|
||||
FSC-BT1035 & UART + flow control, I\textsuperscript{2}S slave & verified \\
|
||||
Clocking & single 48\,kHz domain, ADAU master & verified \\
|
||||
@@ -496,6 +562,7 @@ UART 115200/8/N/1, SSP on, auto-reconnect configurable via
|
||||
\label{tab:hw-val-summary}
|
||||
\end{table}
|
||||
|
||||
The consolidated pre-fabrication validation is complete for all
|
||||
damage-class items (Si4684 power sequencing and supply levels) and the
|
||||
shared I\textsuperscript{2}C bus.
|
||||
The consolidated pre-fabrication validation is \textbf{complete}: every
|
||||
check in this section is closed against the as-fabricated schematic, including
|
||||
the July~2026 corrections to PLL\_MODE strapping and Si4684 crystal load
|
||||
capacitors. No hardware validation items remain open before fabrication.
|
||||
|
||||
@@ -32,9 +32,3 @@ Espressif, Feasycom/Qualcomm) whose datasheets, firmware images, and DSP
|
||||
tools remain subject to their respective vendors' terms. Those terms are
|
||||
unaffected by the DigiRadio licences and must be observed when
|
||||
redistributing vendor-supplied binaries.
|
||||
|
||||
\begin{drnote}[Manufacturing partner]
|
||||
Prototype PCB fabrication and assembly are generously supported by
|
||||
\textbf{PCBWay}. See the acknowledgements on the back cover of this manual
|
||||
and the project repository for our thanks to their team.
|
||||
\end{drnote}
|
||||
|
||||
@@ -28,7 +28,10 @@ channel to compile; it is never used for a real download in this project.
|
||||
\label{sec:ss-hwcfg}
|
||||
|
||||
The Hardware Configuration tab must mirror the board exactly. The key
|
||||
settings are collected in Table~\ref{tab:ss-hwcfg}.
|
||||
settings are collected in Table~\ref{tab:ss-hwcfg}. The 48\,kHz system
|
||||
sample rate follows from the \textbf{board strapping}, not from a
|
||||
SigmaStudio preference alone: X1 is a 12.288\,MHz crystal, PLL\_MODE selects
|
||||
256\,$\times$\,f\textsubscript{S}, and 12.288\,MHz\,/\,256 = 48\,kHz.
|
||||
|
||||
\begin{table}[htbp]
|
||||
\centering
|
||||
@@ -37,8 +40,8 @@ settings are collected in Table~\ref{tab:ss-hwcfg}.
|
||||
\midrule
|
||||
Control port (I\textsuperscript{2}C address) & 0x34 (ADDR0/ADDR1 = GND) \\
|
||||
Self-boot & Disabled (host RAM load) \\
|
||||
System sample rate & 48\,kHz \\
|
||||
MCLK & 12.288\,MHz active oscillator \\
|
||||
System sample rate & 48\,kHz (256\,$\times$\,f\textsubscript{S} strapping) \\
|
||||
MCLK & 12.288\,MHz crystal (256\,$\times$\,f\textsubscript{S}) \\
|
||||
Serial Input format & I\textsuperscript{2}S, 24-bit \\
|
||||
Serial Output & \textbf{Master Mode} (ADAU generates clocks) \\
|
||||
Word length & 24 bits \\
|
||||
@@ -49,6 +52,14 @@ settings are collected in Table~\ref{tab:ss-hwcfg}.
|
||||
\label{tab:ss-hwcfg}
|
||||
\end{table}
|
||||
|
||||
\begin{drnote}[Clock source on the board]
|
||||
SigmaStudio's 48\,kHz sample-rate field must agree with the fabricated
|
||||
hardware: passive crystal X1 (12.288\,MHz, CL = 12\,pF) on MCLKI/OSCO with
|
||||
22\,pF load caps, PLL\_MODE0 = GND and PLL\_MODE1 = 3V3 (256\,$\times$\,f\textsubscript{S}).
|
||||
The ADAU1701 internal oscillator multiplies the crystal; it is not an active
|
||||
oscillator module. See Chapter~\ref{ch:hardware}, Section~\ref{sec:hw-val-adau}.
|
||||
\end{drnote}
|
||||
|
||||
\subsection{Multipurpose pin (MP) assignment}
|
||||
|
||||
The ADAU1701 multipurpose pins are assigned to the serial audio signals
|
||||
|
||||
@@ -186,8 +186,7 @@
|
||||
\newcommand{\drpath}[1]{\nolinkurl{#1}}
|
||||
% HTTP API subsection headings that wrap at slashes.
|
||||
\newcommand{\apiendpoint}[2]{%
|
||||
\subsection{\texorpdfstring{%
|
||||
{\raggedright\texttt{#1} \texttt{#2}\par}}{#1 #2}}%
|
||||
\subsection{\texorpdfstring{\texttt{#1} \texttt{#2}}{#1 #2}}%
|
||||
}
|
||||
|
||||
\endinput
|
||||
|
||||
Binary file not shown.
|
After Width: | Height: | Size: 95 KiB |
File diff suppressed because one or more lines are too long
|
After Width: | Height: | Size: 6.0 KiB |
@@ -35,11 +35,6 @@
|
||||
{\color{drGray}Hardware: CERN-OHL-S v2 \quad\textbullet\quad Firmware: Apache-2.0\par}
|
||||
\vspace{2mm}
|
||||
{\color{drGray}\small \url{https://github.com/manvalan/DigiRadio}\par}
|
||||
\vspace{1.2cm}
|
||||
{\color{drGray}\small
|
||||
Prototype PCB fabrication and assembly supported by
|
||||
\href{https://www.pcbway.com/}{\textcolor{drTeal}{\textbf{PCBWay}}}.
|
||||
\par}
|
||||
\end{titlepage}
|
||||
|
||||
% ---------------- Contents ----------------
|
||||
@@ -70,20 +65,15 @@ Prototype PCB fabrication and assembly supported by
|
||||
\begin{minipage}{0.82\textwidth}
|
||||
\centering
|
||||
{\color{drInk}
|
||||
This open-source hardware project was made possible with generous support from
|
||||
\textbf{PCBWay}, who sponsored prototype PCB fabrication and assembly for
|
||||
DigiRadio. Our sincere thanks and deep gratitude go to the PCBWay team for
|
||||
believing in the project and helping bring the first boards to life.\par}
|
||||
\textbf{PCBWay} sponsored part of the prototype PCB fabrication and assembly
|
||||
costs for DigiRadio. Their contribution did not cover the full production
|
||||
budget, but it materially reduced the out-of-pocket expense of the first
|
||||
manufacturing run. We thank the PCBWay team for believing in this open hardware
|
||||
project and for helping bring the first boards to life.\par}
|
||||
\vspace{1.2cm}
|
||||
\IfFileExists{figures/pcbway-logo.pdf}{%
|
||||
\includegraphics[width=0.32\textwidth]{figures/pcbway-logo}%
|
||||
\includegraphics[width=0.32\textwidth]{figures/pcbway-logo.png}%
|
||||
\vspace{0.8cm}
|
||||
{\color{drGray}\small\url{https://www.pcbway.com}\par}
|
||||
}{%
|
||||
{\color{drTeal}\Large\bfseries PCBWay\par}
|
||||
\vspace{0.4cm}
|
||||
{\color{drGray}\small\url{https://www.pcbway.com}\par}
|
||||
}
|
||||
\end{minipage}
|
||||
\end{center}
|
||||
\vspace*{\fill}
|
||||
|
||||
@@ -1,54 +0,0 @@
|
||||
# DigiRadio — repository documentation package
|
||||
|
||||
Canonical layout for this repository:
|
||||
|
||||
```
|
||||
DigiRadio/ <- repo root (README, Hardware, LICENSE)
|
||||
├── CONTRIBUTING.md dev conventions (human-facing)
|
||||
├── README.md project overview (fw 0.8.3)
|
||||
└── Software/ firmware project root (open THIS in Cursor)
|
||||
├── LICENSE Apache-2.0 (firmware)
|
||||
├── AGENTS.md authoritative coding rules
|
||||
├── instructions.md agent kickoff + roadmap status
|
||||
├── sdkconfig.defaults C++23, NVS + flash encryption (dev mode)
|
||||
├── sdkconfig.defaults.production release-mode overlay (irreversible)
|
||||
├── partitions.csv nvs + nvs_keys partitions
|
||||
├── Doxyfile API docs generation + enforcement
|
||||
├── apache-header.txt header to paste in each source file
|
||||
├── .cursor/rules/*.mdc Cursor scoped rules (6 files)
|
||||
├── tools/
|
||||
│ ├── check-manual-sync.py one LaTeX section per public class
|
||||
│ ├── check_si4684_blobs.py no proprietary .bin in git
|
||||
│ ├── fetch_si4684_firmware.py local blob procurement
|
||||
│ └── gzip-www.sh regenerate embedded web UI gzip
|
||||
└── docs/
|
||||
├── TODO.md agent + HIL backlog
|
||||
├── security-flash-nvs.md encryption + device checklist
|
||||
└── manual/ LaTeX technical manual (canonical)
|
||||
├── manual.tex
|
||||
├── ch-*.tex
|
||||
└── manual.pdf optional compiled preview
|
||||
```
|
||||
|
||||
LaTeX sources live in `Software/docs/manual/`. Build the PDF from there:
|
||||
|
||||
```bash
|
||||
cd Software/docs/manual && latexmk -lualatex manual.tex
|
||||
```
|
||||
|
||||
## CI enforcement (from `Software/`)
|
||||
|
||||
```bash
|
||||
doxygen Doxyfile
|
||||
python3 tools/check-manual-sync.py
|
||||
python3 tools/check_si4684_blobs.py
|
||||
```
|
||||
|
||||
Host tests: `cmake -S components/core/test -B build-host && ctest --test-dir build-host`.
|
||||
|
||||
## Notes
|
||||
|
||||
- Two LICENSE files: CERN-OHL-S at repo root (hardware), Apache-2.0 in
|
||||
`Software/` (firmware).
|
||||
- Si4684 `.bin` blobs are gitignored — never commit them.
|
||||
- Open `Software/` as the Cursor project so rules and `AGENTS.md` load.
|
||||
Reference in New Issue
Block a user