assembly/src/sw_sup/uart_logs.md

UART Logs

Used for network, booting, and most other issues debugging.

How to get them

First, connect your Kasli/SoC to the PC with a micro-USB cable. Once you turn on the device, wait at least 15 seconds until its fully loaded.

Development shell

1. flterm /dev/ttyUSBX, where X is usually third (index 2) from suggested variants.
2. Restart the device with artiq_flash start
3. If it didn't work, try all of /dev/ttyUSBX, and restart the device

Older Nix and other Linuxes

1. Install cutecom via nix-shell -p cutecom or your package manager
2. Run cutecom and follow settings from the picture:
3. Restart the device with artiq_flash start, or by power-cycling it (wait 30 seconds before turning on)
4. If it didn't work, try all of /dev/ttyUSBX, and restart the device

Windows

Drivers

Use following instructions to set correct drivers for the COM ports. At choosing FTDI drivers stage you may have longer list of drivers. In that case, choose respective USB Serial Converter X (A for 0, B for 1, C for 2, D for 3) driver. You may also need to reboot your PC after doing this.

1. 
2. 
3. 
4. 
5. 
6. 
7. 

Connecting with PuTTY

1. Enable options shown on picture:
2. Be aware of these options:
3. Connect to every COM port you find on connecting the device (usually connecting the the third port is enough)
4. Restart the device with artiq_flash start, or by power-cycling it (wait 30 seconds before turning on)
5. See which COM port produces meaningful output and close others :)