From c6cb876c1cb0ec8a7eb50efbc8afac868b7cc6c5 Mon Sep 17 00:00:00 2001 From: Egor Savkin Date: Thu, 13 Jul 2023 12:23:48 +0800 Subject: [PATCH] Add sections about flashing the firmware and moninj Signed-off-by: Egor Savkin --- src/SUMMARY.md | 2 ++ src/sw_sup/flashing_firmware.md | 18 ++++++++++++++++++ src/sw_sup/moninj.md | 11 +++++++++++ 3 files changed, 31 insertions(+) create mode 100644 src/sw_sup/flashing_firmware.md create mode 100644 src/sw_sup/moninj.md diff --git a/src/SUMMARY.md b/src/SUMMARY.md index da87f6c..371eed9 100644 --- a/src/SUMMARY.md +++ b/src/SUMMARY.md @@ -20,3 +20,5 @@ - [Software/Support](./sw_sup/software_support.md) - [Networking](./sw_sup/networking.md) - [UART Logs](./sw_sup/uart_logs.md) + - [Flashing the Firmware](./sw_sup/flashing_firmware.md) + - [Moninj](./sw_sup/moninj.md) diff --git a/src/sw_sup/flashing_firmware.md b/src/sw_sup/flashing_firmware.md new file mode 100644 index 0000000..ed3531b --- /dev/null +++ b/src/sw_sup/flashing_firmware.md @@ -0,0 +1,18 @@ +# Flashing the Firmware + +Here are some extra steps needed for flashing the firmware. + +## Kasli + +### Windows + +From the [official manual](https://m-labs.hk/artiq/manual/installing.html#configuring-openocd): + +On Windows, a third-party tool, Zadig, is necessary. Use it as follows: +1. Make sure the FPGA board’s JTAG USB port is connected to your computer. +2. Activate Options → List All Devices. +3. Select the “Digilent Adept USB Device (Interface 0)” or “FTDI Quad-RS232 HS” (or similar) device from the drop-down list. +4. Select WinUSB from the spinner list. +5. Click “Install Driver” or “Replace Driver”. + +You may need to repeat these steps every time you plug the FPGA board into a port where it has not been plugged into previously on the same system. \ No newline at end of file diff --git a/src/sw_sup/moninj.md b/src/sw_sup/moninj.md new file mode 100644 index 0000000..c1bfe90 --- /dev/null +++ b/src/sw_sup/moninj.md @@ -0,0 +1,11 @@ +# Moninj + +The official documentation lacks the description of MONitor/INJector, but it is a common mistake when running the ARTIQ-7. +Basically it is a service that consists of two parts - one runs on the host PC, another on the Kasli. +It allows to watch and control the state of the devices, so you can see it on the dashboard. +That's why the dashboard may emit errors about not working moninj. To fix this, you just need [to run it with Kasli's IP](https://m-labs.hk/artiq/manual/utilities.html#moninj-proxy): + +```shell +aqctl_moninj_proxy CORE_ADDRESS +``` +