Add phaser upconverter

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

README.md

@@ -2,7 +2,7 @@
 
 Repository with instructions and remarks on assembling and testing Sinara hardware
 
-# Build docs
+### Build docs
 
 ```shell
 nix build
@@ -10,11 +10,12 @@ nix build
 
 The output files are in `result/book` directory.
 
-# Development shell
+### Development shell
 
 ```shell
 nix develop
 mdbook build
 ```
 
-The output files are in `book` directory
+The output files are in `book` directory.
+

src/SUMMARY.md

@@ -1,3 +1,4 @@
 # Summary
 
 - [Build and test firmware](./build_test_firmware.md)
+- [Sinara 4624 AWG Phaser (Upconverter)](./hw/phaser_upconverter.md)

src/hw/phaser_upconverter.md

@@ -0,0 +1,31 @@
+# Sinara 4624 AWG Phaser (Upconverter)
+
+## JSON 
+
+```json
+{
+            "type": "phaser",
+            "hw_rev": "v1.1", // optional
+            "ports": [<port num>]
+}
+```
+
+## Testing
+
+```text
+*** Testing Phaser DACs and 6 USER LEDs.
+Frequencies:
+phaser0 10+0 10+1 10+2 10+3 10+4 MHz
+```
+
+After running `artiq_sinara_test`:
+
+1. Install gqrx `nix-shell -p gqrx`
+2. Connect bladeRF via USB cable only
+3. Run gqrx and choose `BladeRF #<number>...`
+4. Input rate 30000000, other settings are default
+5. When gqrx loaded, start DSP processing with frequency near 2.875 GHz + frequencies from `artiq_sinara_test` in `Receiver Options`
+6. Connect the probe with adjusted resistance (???) to the Phaser's ports
+7. You should see 5 tones on `artiq_sinara_test`'s frequencies, like on the picture below
+
+![](../img/phaser_upconverter_gqrx.png)