# Troubleshooting

### Cannot SSH into the board

| Symptom                       | Likely Cause                          | Resolution                                                                            |
| ----------------------------- | ------------------------------------- | ------------------------------------------------------------------------------------- |
| `Connection refused`          | Board not fully booted yet            | Wait 60–90 seconds after power-on and retry                                           |
| `No route to host`            | Host PC interface not configured      | Check `ip addr` on host, assign `192.168.55.x` address manually                       |
| `Connection timed out`        | USB cable not connected or wrong port | Try a different cable or USB port; verify USB Ethernet interface appears in `ip addr` |
| USB interface does not appear | Driver issue or cable fault           | Try a different cable; verify the USB connection is data-capable (not charge-only)    |

### Board does not boot

* Verify the power supply voltage matches the VDD\_MAIN specification for your extension board.
* Check that the Jetson compute module is fully seated.
* Try connecting HDMI to a monitor to see boot messages.
* If the board previously had a failed flash, enter [Recovery Mode](#step-1--enter-recovery-mode) and re-flash.

### Recovery mode not detected by host PC (`lsusb` shows nothing)

* Ensure the USB cable is connected **before** entering recovery mode.
* Verify you are using a data-capable USB cable (not a charge-only cable).
* Try a different USB port on the host PC (prefer USB-A 3.0 ports).
* On some systems, the device may enumerate briefly - run `watch -n 1 lsusb` to catch it.

### `tegrastats` returns an error

* Ensure the system is running a JetPack-based image.
* If using a custom image, verify that the BSP and L4T packages are correctly installed.

### Wrong JetPack version installed

Flash the correct image using `dcs-deploy`. See [Flashing a New System Image](#flashing-a-new-system-image).


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.airvolute.com/hidden-wip/dcs2-getting-started/troubleshooting.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.