From 47aa69a161cffeb0c887a7b4d34caf1a4fe7a88c Mon Sep 17 00:00:00 2001 From: Maxim Devaev Date: Sun, 12 May 2024 02:26:47 +0300 Subject: [PATCH] fix --- docs/first_steps.md | 18 +++++++++--------- 1 file changed, 9 insertions(+), 9 deletions(-) diff --git a/docs/first_steps.md b/docs/first_steps.md index 06462848..6687c5d9 100644 --- a/docs/first_steps.md +++ b/docs/first_steps.md @@ -60,23 +60,23 @@ which you have successfully detected using the instructions above. The device ha **The default `root` password is `root`.** -??? example "Access to PiKVM via serial" +??? example "Access to PiKVM via serial console" - Serial is sometimes needed to recover your PiKVM or review what it's doing due to boot failures or due to general network issues + A serial console is a convenient and fast way to connect to PiKVM when there is no network, or get boot logs and a console if something goes wrong. - * **Step 1.** Remove the PiKVM from the Target system + 1. Remove the PiKVM from the target system. - * **Step 2.** You can reuse the OTG cable for this step, place the USB-C end into the IOIOI port (CON port on the v3), V2 you'll need to get the right TTY to USB cable, we recommend the [RPi Debug Probe](https://www.pishop.us/product/raspberry-pi-debug-probe/) and follow existing RPi TTY serial setups. + 2. Connect to the physical UART console: - * **Step 3.** Place the USB-A end into the port you want serial to be accessed, typically done on the host + * On PiKVM V3 or V4, you have a built-in USB-UART adapter in your device. Just disconnect the OTG cable and place the USB-C end into `IOIOI` port on V4 (or `CON` port on V3). Place the USB-A end into the port you want serial to be accessed, typically done on the host. If you have a Windows host, you may need to install this [driver](https://www.silabs.com/developers/usb-to-uart-bridge-vcp-drivers), other OS's may not need one. - * **Step 4.** For windows you may need to install this [driver](https://www.silabs.com/developers/usb-to-uart-bridge-vcp-drivers), other OS's may not need one + * On DIY PiKVM V1 or V2, you'll need to get the right TTY to USB cable, we recommend the [RPi Debug Probe](https://www.pishop.us/product/raspberry-pi-debug-probe/) and follow existing RPi TTY serial setups. - * **Step 5.** Install Putty (Windows) or use GNU screen (may need to install this on your Host if using another OS) + 3. Install GNU Screen on Linux or macOS host, or [Putty](https://www.putty.org/) on Windows. - * **Step 6.** Select the COM port in Putty (you can verify this looking in Device Manager), then select 115200 or use `screen /dev/ttyUSB0 115200` for other OS's + 4. Select the COM port in Putty (you can verify this looking in Device Manager), then select 115200, or use `screen /dev/ttyUSB0 115200` for other OS's - * **Step 7.** You should now be able to see and interact with the Serial Port + 5. You should now be able to see and interact with the Serial Port. !!! tip "Obtaining root access"