# Serial Console Access

If you're unable to access your Iron Pi using the Ethernet interface, the TTL Serial Console port can help you diagnose the issue and restore access.

{% hint style="info" %}
The TTL Serial Console port is intended only for debugging and recovery. Use the RS-232 and RS-485 ports on the main terminal block for all serial communications in production.
{% endhint %}

{% hint style="danger" %}
The TTL Serial Console port is not RS-232 or RS-485 compatible, and connecting it to an RS-232 or RS-485 port will likely damage both the Iron Pi and the device on the other end of the connection!
{% endhint %}

The TTL Serial Console port operates at 0-3.3V voltages, and is compatible with the [FTDI TTL-232R-3V3 cable](https://ftdichip.com/products/ttl-232r-3v3/), which is available from [DigiKey](https://www.digikey.com/en/products/detail/ftdi-future-technology-devices-international-ltd/TTL-232R-3V3/1836393) and [Amazon](https://www.amazon.com/s?k=ftdi+ttl-232r-3v3).

![](/files/z0qqNCy5mbLgiryXFFfl)

**With the Iron Pi powered off**, connect the cable to the Iron Pi's TTL Serial Console port. When using the TTL-232-3V3 cable, ensure that the black wire is connected to the GND pin, the green wire is connected to the rightmost NC pin, and the +5V pin on the Iron Pi is left open.

![](/files/lFyzptU7TuWANX1OANJl)

{% hint style="warning" %}
The +5V pin on the TTL Serial Console port should almost always be left unconnected
{% endhint %}

Connect the serial cable to a USB port on your computer. Allow drivers to install as needed. Open Windows Device Manager to figure out which COM port was assigned to your serial cable. In this case, our serial cable was assigned to COM4.

![](/files/cFM8YibElLwiNtPoKPLy)

Install a serial terminal emulator. [PuTTY](https://www.chiark.greenend.org.uk/~sgtatham/putty/latest.html) is a good choice for Windows. Open your terminal emulator and connect to the serial port at a b**aud rate of 115200**.

![](/files/EwiItsTAzN6p2bZf7EqZ)

Power on the Iron Pi, and wait for boot messages to appear in the console. Once the Iron Pi finishes booting, you should get a login prompt. Type the username pi, and whatever password you've set for the device. If you don't remember the password, you may be able to [reset it to your device's factory access code by holding down the Connect button](/clarity-gateway/installation/readme/recovery.md).

![](/files/Wy9EtWojTJmnaSZPg6Yh)

Once you've logged into the device, the `ifconfig -a` command is a good way to check the status and IP address of your network interfaces. In this case, you can see that the device has an IP address of 192.168.100.220.

![](/files/ExxTaGpDfwcFkLpX0MdR)

If you need to change the device's IP address, you can run `sudo nano /etc/dhcpcd.conf` to edit the networking configuration file.

![](/files/jV1YLnzmSvHbkTR2Y3QM)

Scroll down to the bottom to find the IP address, netmask, and DNS server settings. Once you're done editing, type `Ctrl + X` to save and exit.

![](/files/3t44u63dLlaxCLUiKXRc)

Changes to the networking configuration file won't take effect automatically, so run `sudo reboot` to restart the box and apply your changes.


---

# 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.jcore.io/clarity-gateway/installation/readme/serial-console-access.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.