HVAMP: add setup & testing instruction

src/SUMMARY.md

@@ -10,6 +10,7 @@
   - [Sinara 2118 BNC-TTL / 2128 SMA-TTL](./hw/bnc_sma_ttl.md)
   - [Sinara 2138 MCX-TTL](./hw/mcx_ttl.md)
   - [Sinara 5432 DAC Zotino / Sinara 5632 DAC Fastino](./hw/zotino_fastino.md)
+  - [Sinara 5633 HV Amplifier](./hw/hvamp.md)
   - [Sinara 5716 DAC Shuttler](./hw/shuttler.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/hvamp.md

@@ -0,0 +1,29 @@
+# Sinara 5633 HV Amplifier
+
+* [Wiki](https://github.com/sinara-hw/HVAMP_32/wiki)
+
+## Setup
+
+1. Connect the HV Amplifier to the Zotino/Fastino with IDC connectors (stand-alone mode) or with mezzanine connectors (meazzanine mode). Be aware of pin alignment when using it in the meazzanine mode
+2. Connect the DC barrel or ATX cable to HV Amplifier but **don't supply power** 
+
+## Testing
+
+After running `artiq_sinara_test` on the connected Zotino/Fastino:
+
+```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.
+
+*** Testing Fastino DACs and USER LEDs.
+Voltages:
+fastino0 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. Turn on the external power supply connecting to the HV Amplifier **(⚠️Danger: High Voltage active, don't touch the bare PCB without PPE)**
+2. Probe with multimeter/DC voltmeter each pair of pins from bottom to top (left pins are ground)
+3. Check that respective pins have voltages multipled by the gains as described by `artiq_sinara_test` (e.g. for 5x gain variant 0.1V pin => 0.1V x 5 = 0.5V )
+4. Check LEDs are on

src/hw/stabilizer.md

@@ -126,7 +126,10 @@ Configure Stabilizer:
 2. Connect USB cable to the Stabilizer.
 3. Run ``cutecom`` or your favorite terminal emulator, connect to ``/dev/ttyACM0``.
 4. Change the broker setting with: ``set /net/broker "<ip of your machine>"``.
-5. Reboot with ``platform reboot``.
+5. Store the setting with ``store /net/broker``.
+6. (Optional) Set the IP address of the stabilizer by following steps 4 and 5, but with ``/net/ip`` setting instead.
+7. Reboot with ``platform reboot``.
 
 Now, disconnect the USB and connect the Ethernet cable to the Stabilizer, as both won't fit at the same time.
 Stabilizer should connect to moquitto automatically, and you should see the MQTT settings pop up in the MQTT Explorer.
+If the IP address is not set, Stabilizer will try to use DHCP to get an address.