booste: update instructions for SynthNV

src/hw/booster.md

@@ -82,7 +82,7 @@ In case someone sets some setting wrongly, or updates the firmware and suddenly
 2. Create mosquitto config `mosquitto.conf`, or use the one from Stabilizer repo:
 
     ```text
-    %allow_anonymous true
+    allow_anonymous true
     listener 1883
     ```
 
@@ -119,11 +119,11 @@ In case someone sets some setting wrongly, or updates the firmware and suddenly
     reset
     ```
 
-8. Check if the Booster connects to your broker.
+8. Check if the Booster connects to your broker. Note the MAC address of the client, it will be used later.
 9. If you don't have it yet, download [MQTT Explorer](https://github.com/thomasnordquist/MQTT-Explorer/releases)
-10. Run it with `appimage-run /path/to/MQTT-Explorer-XXX.AppImage`
-11. Connect to your MQTT broker
-12. Restart booster to receive settings
+10. Run it with `appimage-run /path/to/MQTT-Explorer-[latest version].AppImage`
+11. Connect to your MQTT broker (at your IP address)
+12. Restart booster (power cycle or ``platform reboot``) to receive settings
 
 ## Calibration software setup
 
@@ -134,9 +134,7 @@ python -m venv env
 source env/bin/activate.fish
 pip install git+https://github.com/quartiq/miniconf.git@84cc9046bf504cc2d0d33b84d2f3133f2faf2248#subdirectory=py/miniconf-mqtt
 git clone https://github.com/quartiq/booster
-cd booster/py
-pip install .
-cd ../..
+pip install booster/py/.
 ```
 
 For subsequent runs, just call ``source env/bin/activate.fish``.
@@ -147,15 +145,15 @@ For subsequent runs, just call ``source env/bin/activate.fish``.
 2. Run [dds_for_booster.py](../extra/booster/dds_for_booster.py) experiment once
 3. Attach parallel 50 Ohm load to the oscilloscope, as shown on the picture:
    ![50Ohm load](../img/50ohm_parallel_load.jpg),
-4. Configure oscilloscope for 1M Ohm impedance
+4. ⚠️ Configure oscilloscope for 1M Ohm impedance ⚠️ Failure to do so may damage the oscilloscope if connected to the booster with a powerful signal.
 5. Attach attenuator to the Urukul's RF2
-6. Enable channels:
+6. Enable channels and tune them:
    `python -m booster --broker 192.168.1.123 --prefix dt/sinara/booster/xx-xx-xx-xx-xx-xx --channel N tune=0.1`
 7. Using [booster_template](../extra/booster/booster_template.ods) fill in `y0`, `y1`, `m`, `c`,
    values using instructions below
 8. Update settings with the adjusted values
 9. Save settings with
-    `python -m booster --broker 192.168.1.123 --prefix dt/sinara/booster/xx-xx-xx-xx-xx-xx --channel N save`
+    `python -m booster --broker 192.168.1.xxx --prefix dt/sinara/booster/xx-xx-xx-xx-xx-xx --channel N save`
 10. Reboot and check settings are applied
 
 ### Input power
@@ -163,9 +161,9 @@ For subsequent runs, just call ``source env/bin/activate.fish``.
 1. Connect Urukul's output (see booster template for exact ports) to the oscilloscope with load
 2. Measure it's RMS, convert to dBm, put it to the measured cell
 3. Connect Urukul's output to the Booster's input
-4. Get the input value from telemetry (see booster template for exact path)
+4. Get the input value from MQTT telemetry for the given channel (see booster template for exact path)
 5. Do steps 1-4 for second Urukul's output
-6. Fill in `slope` and `offset` from settings
+6. Fill in `slope` and `offset` from the MQTT settings
 7. Do steps 1-6 for every channel
 
 _Note: default setting and Urukul's measured values are usually the same across channels, so you can
@@ -175,7 +173,7 @@ extrapolate them for all channels._
 
 1. Connect Urukul's output (see booster template for exact ports) to the Booster's input
 2. Connect Booster's output to the oscilloscope with load
-3. Raise channel's `output_interlock_threshold` to 40
+3. Raise channel's `output_interlock_threshold` to 40 through MQTT
 4. Turn channel's state to `Enabled`
 5. Measure it's RMS, convert to dBm, put it to the measured cell
 6. Get the output value from telemetry (see booster template for exact path)
@@ -189,6 +187,19 @@ extrapolate them for all channels._
 
 _Note: default setting values are usually the same across channels, so you can extrapolate them for all channels._
 
+### Addendum: using SynthNV instead of Urukul
+
+In case of severe Urukul shortage we may be forced to use the SynthNV instead.
+
+For setup, use the instructions from [Clocker](https://git.m-labs.hk/sinara-hw/assembly/src/branch/master/src/hw/clocker.md) with few caveats:
+
+- instead of ``f125.0`` use ``f200.0`` (200MHz)
+- ``a63`` is the strongest output this device can give; use it instead of Urukul's RF0 and RF3 mentioned in the script above.
+- ``a57`` gives a signal similar to Urukul's RF1.
+- ``a15`` gives a very weak signal, more or less equivalent to Urukul's RF2, except for the SynthNV the attenuator is not necessary.
+
+Instead of changing the connection between physical ports, just change the amplitude with one of the commands above.
+
 ## Troubleshooting
 
 ### Fans running constantly