Connecting to Yellow via serial console can be helpful for troubleshooting, e.g. to export a log.

  1. Power off and unplug Yellow.
  2. Make sure JP1 is set to UART.
  3. Make sure GNU Screen is installed on your system.
    • On Linux, use your distribution's package manager (e.g. sudo apt install screen).
    • On macOS, use Homebrew: brew install screen.
  4. On your desktop/laptop, open a terminal.
  5. List the USB port numbers:
    • On Linux, use
      ls /dev/ttyUSB*
    • On macOS, use
      ls /dev/cu.*
      If the Silicon Labs CP2102N driver is installed, you will see both /dev/cu.SLAB_USBtoUART and /dev/cu.usbserial-110 (/dev/cu.usbserial-210, depending on which port the Yellow is plugged in to).
  6. Connect the Yellow with USB C to your computer.

    Note: Since Yellow is not powered on yet, it is normal for no lights to be on.

  7. List the USB port numbers again (see step 5). The new entry is for Yellow.

    Note: In case no new entry appears, make sure JP1 is at the right position (step 2) and your USB-C cable supports at least USB 2.0 signals (try using a different USB-C cable if in doubt).

  8. Start GNU Screen and point it to this USB port. E.g.:
    screen /dev/ttyUSB0 115200

    Note: If your account does not have permission to access serial ports, you may have to run the command with sudo.

    Note: Screen typically doesn't display anything on startup. You see only the cursor on the top left of the window.

  9. Power the Yellow back on with either the DC adapter or Power over Ethernet (if supported).
  10. After the Yellow finishes booting, hit the Enter key until prompted for credentials.
    • Homeassistant login: root
    • No password is required. Hit the Enter key.
  11. The console offers the Home Assistant CLI under the command ha. The command allows to get information about the state of the system. Typically useful commands are:
    • To print the supervisor logs, type
      ha supervisor logs
    • To print out the network info, type
      ha network info
  12. To save the boot log into a file, perform the following steps:
    1. Power off Yellow.
    2. Perform steps 1–11.
    3. Power up Yellow.
    4. To save the bootlogs, press Ctrl+A and then type
      :hardcopy -h /tmp/boot.log
  13. To exit GNU Screen, press Ctrl+A and then D.

Resources: