Add instruction for BNC/SMA-IDC adapters, Urukul and Zotino

Signed-off-by: Egor Savkin <es@m-labs.hk>

src/SUMMARY.md

@@ -6,3 +6,6 @@
   - [Sinara 4456 synthesizer Mirny](./hw/mirny.md)
   - [SUServo (Sampler + Urukul)](./hw/suservo.md)
   - [Sinara 2118 BNC-TTL / 2128 SMA-TTL](./hw/bnc_sma_ttl.md)
+  - [Sinara 5432 DAC Zotino](./hw/zotino.md)
+  - [Sinara 5518 BNC-IDC / 5528 SMA-IDC adapter](./hw/bnc_sma_idc_adapter.md)
+  - [Sinara 4410/4412 DDS "Urukul" (AD9910/AD9912)](./hw/urukul.md)

src/hw/bnc_sma_idc_adapter.md

@@ -0,0 +1,26 @@
+# Sinara 5518 BNC-IDC / 5528 SMA-IDC adapter
+
+## JSON
+
+There is no JSON description for this hardware, as it is an adapter,
+connected to the Zotino and not the Kasli. See [Zotino page](./zotino.md).
+
+## Setup
+
+BNC/SMA-IDC adapters should be connected to the Zotino with 26 pin cable only. Be aware of the order of the Zotino's ports - 
+see numbers of the channels at the board when connecting.
+
+## Testing
+
+After running `artiq_sinara_test`:
+
+```text
+*** Testing Zotino DACs and USER LEDs.
+Voltages:
+zotino0 0.1 -0.1 0.2 -0.2 0.3 -0.3 0.4 -0.4 0.5 -0.5 0.6 -0.6 0.7 -0.7 0.8 -0.8 0.9 -0.9 1.0 -1.0 1.1 -1.1 1.2 -1.2 1.3 -1.3 1.4 -1.4 1.5 -1.5 1.6 -1.6
+Press ENTER when done.
+```
+
+Similar to Zotino, check output voltages on the BNC/SMA connectors with multimeter, alongside on the Zotino itself.
+These voltages should be very close to the respective `artiq_sinara_test`'s suggested voltages.
+See [Zotino page](./zotino.md) for details.

src/hw/urukul.md

@@ -0,0 +1,52 @@
+# Sinara 4410/4412 DDS "Urukul" (AD9910/AD9912)
+
+* [Datasheet](https://m-labs.hk/docs/sinara-datasheets/4410-4412.pdf)
+* [Wiki](https://github.com/sinara-hw/Urukul/wiki)
+
+## JSON
+
+```json
+{
+    "type": "urukul",
+    "dds": "<variant>", // ad9910/ad9912
+    "ports": [<port num>, <port num>],
+    "clk_sel": <clock num>
+}
+```
+
+## Setup
+
+Check if [SUServo](./suservo.md) is enabled/disabled on customer needs.
+
+## Testing
+
+After running `artiq_sinara_test`:
+
+```text
+*** Testing Urukul DDSes.
+urukul0_cpld: initializing CPLD...
+urukul0_cpld: testing attenuator digital control...
+urukul0_cpld: done
+Calibrating inter-device synchronization...
+urukul0_ch0	no EEPROM synchronization
+urukul0_ch1	no EEPROM synchronization
+urukul0_ch2	no EEPROM synchronization
+urukul0_ch3	no EEPROM synchronization
+...done
+All urukul channels active.
+Check each channel amplitude (~1.6Vpp/8dbm at 50ohm) and frequency.
+Frequencies:
+urukul0_ch0	10MHz
+urukul0_ch1	11MHz
+urukul0_ch2	12MHz
+urukul0_ch3	13MHz
+Press ENTER when done.
+
+Testing RF switch control. Check LEDs at urukul RF ports.
+Press ENTER when done.
+```
+
+1. Setup oscilloscope's impedance at 50 ohm
+2. Touch each connector with oscilloscope, setup time- and voltage- scale and trigger, so that you can see sine waves
+3. Measure frequencies and amplitudes on each connector, check with `artiq_sinara_test`'s respective values
+4. When done, proceed with `artiq_sinara_test` and check LEDs are lighting up one after another

src/hw/zotino.md

@@ -0,0 +1,29 @@
+# Sinara 5432 DAC Zotino
+
+* [Datasheet](https://m-labs.hk/docs/sinara-datasheets/5432.pdf)
+* [Wiki](https://github.com/sinara-hw/Zotino/wiki)
+
+## JSON
+
+```json
+{
+  "type": "zotino",
+  "ports": [<port num>]
+}
+```
+
+## Testing
+
+After running `artiq_sinara_test`:
+
+```text
+*** Testing Zotino DACs and USER LEDs.
+Voltages:
+zotino0 0.1 -0.1 0.2 -0.2 0.3 -0.3 0.4 -0.4 0.5 -0.5 0.6 -0.6 0.7 -0.7 0.8 -0.8 0.9 -0.9 1.0 -1.0 1.1 -1.1 1.2 -1.2 1.3 -1.3 1.4 -1.4 1.5 -1.5 1.6 -1.6
+Press ENTER when done.
+```
+
+1. Touch with multimeter/DC voltmeter each pair of pins from bottom to top (left pins are ground)
+2. Check that respective pins have voltages as described by `artiq_sinara_test`
+3. If there are [BNC/SMA-IDC adapters](./bnc_sma_idc_adapter.md), also check their voltages - they should be the same
+4. Check LEDs are on