add instructions for Pounder

src/SUMMARY.md

@@ -10,13 +10,14 @@
   - [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)
   - [Sinara 5108 Sampler](./hw/sampler.md)
   - [Sinara 6302 Grabber](./hw/grabber.md)
   - [Sinara 7210 Clocker](./hw/clocker.md)
-  - [Sinara 8452 DSP Stabilizer](./hw/stabilizer.md)
+  - [Sinara 8452 DSP Stabilizer / Sinara 4459 Pounder](./hw/stabilizer_pounder.md)
   - [Sinara 9805 RF Power Amplifier Booster](./hw/booster.md)
   - [Sinara 8451 Thermostat](./hw/thermostat.md)
   - [Sinara 2245 LVDS DIO](./hw/lvds_dio.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_pounder.md

@@ -126,7 +126,30 @@ 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.
+
+## Installing the Pounder
+
+Remember that the Pounder is not fully supported in official QUARTIQ release; use the firmware from Hydra.
+
+Use ESD precautions; ensure that power is off (both barrel jack and PoE) before installing or removing the card.
+
+There are no guides for the Pounder connector. Line up the connectors with the pins and gently push in.
+
+SMA connectors should line up with the ones from Stabilizer; no pins should be visible from the sides of the Pounder; it's more obvious if the Pounder has the front panel already installed.
+
+## Testing the Pounder
+
+1. Set up the MQTT as described above.
+2. Using Mosquitto and MQTT Explorer, set the pounder ``out_channel`` parameters:
+* Frequency: 10e6 (10MHz)
+* Amplitude: 1.0
+   ![Pounder MQTT settings](../img/pounder_mqtt.png)
+3. Repeat the procedure for the other channel.
+4. Observe a sine wave of given frequency with an oscilloscope in the output channel.