From c09f9318a1021fdeb2ac2ad0300cb82a485f26b5 Mon Sep 17 00:00:00 2001 From: linuswck Date: Wed, 5 Jun 2024 15:01:34 +0800 Subject: [PATCH] rebase --- src/hw/shuttler.md | 53 +++++++++++++++------------------------------- 1 file changed, 17 insertions(+), 36 deletions(-) diff --git a/src/hw/shuttler.md b/src/hw/shuttler.md index 7bdf70a..9d377cc 100644 --- a/src/hw/shuttler.md +++ b/src/hw/shuttler.md @@ -2,7 +2,7 @@ The Sinara 5716 DAC Shuttler consists of the [Shuttler](https://github.com/sinara-hw/Shuttler), [Remote AFE-Board](https://github.com/sinara-hw/Shuttler), and [EEM FMC Carrier](https://github.com/sinara-hw/EEM_FMC_Carrier) (EFC) Board. -The EFC Board has an FPGA running Kasli Satellite. DRTIO communication is established through the EEM Cable. At first power up, EFC Board and connected Kasli/Kasli-soc calibrate the EEM signal delay and store the value into the flash memory/SD Card. +The EFC Board has an FPGA running Kasli Satellite. DRTIO communication is established through the EEM Cable. At first power up, EFC Board and connected Kasli/Kasli-soc calibrate the clock skews on their own EEM transceiver and then store the value into the flash memory/SD Card. ## JSON @@ -16,7 +16,7 @@ The EFC Board has an FPGA running Kasli Satellite. DRTIO communication is establ ## Hardware Configurations and Connections ### EEM Cable Connection -Only the EEM0 port on the EFC board is used. The EEM Cable provides power. You can ignore the barrel jack at the back of the board(if fitted). +Only the EEM0 port on the EFC board is used. The EEM Cable provides power. You can ignore the barrel jack at the back of the board if it is placed. ### CLK Input @@ -42,14 +42,14 @@ The EFC Board has configurable Digital IO Voltage Level/PSU called VADJ. You sho ### Remote AFE Board Connections -The Remote AFE Board is not installed in the crate and should be shipped separately. When you test the EFC, please connect the Mini SAS Cables in this orientation. +The Remote AFE Board is not installed in the crate and should be shipped separately. When you test the EFC Board, please connect the Mini SAS Cables in this orientation. ![Mini-Sas Connections](../img/shuttler_afe_connections.jpg) -There is no PSU for the Remote AFE Board at this moment. For testing purposes, you should connect the Remote AFE Board to a lab PSU supplying +15V, -15V, and +5V. Please make sure all voltages share a common GND and check the pinout carefully. Incorrect power connections can damage the Remote AFE Board. +There is no PSU for the Remote AFE Board at this moment. For testing purposes, you should connect the Remote AFE Board to a lab PSU supplying +15V, -15V, and +5V. Please make sure all voltages share a common GND and check the pinouts carefully. Incorrect power connections can damage the Remote AFE Board. ## Building EFC Board Gateware and Firmware -The EFC Board gateware and firmware are on the Artiq repo. +The EFC Board gateware and firmware are on the [Artiq](https://github.com/m-labs/artiq) repo. To build the gateware and firmware, ``` @@ -63,40 +63,22 @@ When Kasli Satellite is compiled with Shuttler, Shuttler is connected to the Sat Here provides an example to configure the routing table. You have 1 Kasli Master and 1 Kasli Satellite. Kasli Master (SFP1)(DEST1) port is connected to Kasli Satellite(SFP0)(DEST0). Shuttler is connected to Kasli Satellite with DRTIO over EEM Cable(DEST4). -Initialize the Routing Table -``` -artiq_route rt.bin init -``` - -Add the routing table entry for Kasli Master's Peripherals -``` -artiq_route rt.bin set 0 0 -``` - -Add the routing table entry for Kasli Satellite's Peripherals -``` -artiq_route rt.bin set 1 1 0 -``` -Add the routing table entry for Shuttler -``` -artiq_route rt.bin set 4 1 4 0 -``` - -Flash the routing table on Kasli Master -``` -artiq_coremgmt config write -f routing_table rt.bin -``` +1. Initialize the Routing Table: ``` artiq_route rt.bin init``` +2. Add the routing table entry for Kasli Master's Peripherals: ```artiq_route rt.bin set 0 0``` +3. Add the routing table entry for Kasli Satellite's Peripherals: ```artiq_route rt.bin set 1 1 0``` +4. Add the routing table entry for Shuttler: ```artiq_route rt.bin set 4 1 4 0``` +5. Flash the routing table on Kasli Master: ```artiq_coremgmt config write -f routing_table rt.bin``` ## Flashing -When a crate is built, you should erase the flash/sd card config on both the EFC and Kasli/Kasli-soc. Always flash the EFC Board first before flashing the Kasli/Kasli-soc. +When you are building a crate with shuttler(s), you should erase the flash/sd card config on both the EFC and Kasli/Kasli-soc. Always flash the EFC Board first before flashing the Kasli/Kasli-soc. If either of the following elements is changed, you will need to **ERASE** the stored calibrated values on both the EFC and Kasli Master, or the communication between the boards cannot be established: 1. EEM Cable 2. Clock-Related Cable 3. EFC Board Gateware -4. Kasli Master Gateware -5. EFC Board/Kasli Master replacement +4. Kasli/Kasli-Soc Master Gateware +5. EFC Board/Kasli/Kasli-Soc PCB To erase the flash on the EFC board, ``` @@ -110,11 +92,10 @@ artiq_flash --srcbuild -t [efc1v0, efc1v1] -d artiq_efc/shuttler ## Testing -It is required for the Remote AFE Card to be connected to the Shuttler for the whole system to be functional. - -1. Power up the Remote AFE Board and the Kasli/Kasli-Soc with the connected Shuttler. -2. Remote AFE Board had all Power Indicator LEDs being lit up. -3. Run the `artiq_sinara_test`. +1. Connect the Remote AFE Card to the Shuttler +2. Power up the Remote AFE Board and the Kasli/Kasli-Soc with the connected Shuttler. +3. Check all Remote AFE Board Power Indicator LEDs. +4. Run the `artiq_sinara_test`. ```