public_git
/
pikvm
mirror of https://github.com/pikvm/pikvm.git
1
0
Fork 0
Code Issues Projects Releases Wiki Activity

Replace screen with picocom in the cheatsheet / serial console docs

This commit is contained in:
Aleksandr Prokudin 2025-05-02 19:44:19 +02:00
parent eb8305549c
commit cb76cf1826
1 changed files with 7 additions and 15 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

22
docs/cheatsheet.md
View File

@ -34,17 +34,17 @@ Here are **first steps guides** for each PiKVM device:
1. Connect to the physical universal asynchronous receiver / transmitter (UART) console from your host computer:
* 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 operating systems may not need one.
* 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 the `IOIOI` port on V4 (or the `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 operating systems 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.
2. Install GNU Screen on Linux or macOS host, or [Putty](https://www.putty.org/) on Windows.
2. Install `picocom` on a Linux or a macOS host, or [Putty](https://www.putty.org/) on Windows.
3. Identify the port that your operating system exposes for connecting to the PiKVM.
* Windows: look this up in the Device Manager
* Linux: open a terminal program, run `dmesg | grep tty` (this may require using `sudo`), and look for a message like this:
* Linux: open a terminal program, run `sudo dmesg | grep tty`and look for a message like this:
```
[14362.388405] usb 1-2: cp210x converter now attached to ttyUSB0
@ -58,21 +58,13 @@ Here are **first steps guides** for each PiKVM device:
* Windows: select the COM port in Putty and use the **115200** baud rate, then connect.
* Linux/macOS: open your terminal program and run `screen $USB_SERIAL_DEVICE 115200` where `$USB_SERIAL_DEVICE` is the device you looked up, e.g. `/dev/ttyUSB0` on Linux or `/dev/cu.usbserial-FT0RVWSW` on macOS.
* Linux/macOS: open your terminal program and run `sudo picocom -b 115200 $USB_SERIAL_DEVICE` where `$USB_SERIAL_DEVICE` is the device you looked up, e.g. `/dev/ttyUSB0` on Linux or `/dev/cu.usbserial-FT0RVWSW` on macOS.
Note that on Linux, you may need to include your unprivileged user into the `dialout` group:
```
usermod -a -G dialout $USERNAME
```
After running the command, press **Enter** to get to a login prompt.
In that case, log out and then log back in for the changes to take effect. After that, you can run `screen` without root privileges on your host computer.
5. Submit your root user credentials.
With `screen`, you will see a blank screen by default. Press **Enter** to get a login prompt.
5. After submitting your PiKVM credentials (`root` for username and the corresponding password), you should be able to see and interact with the serial port. All the system tools in PiKVM will be available in the terminal window.
6. `screen` has some advanced features for opening multiple windows and reattaching to existing sessions. See [this guide](https://www.gnu.org/software/screen/manual/screen.html) for more details. However, if you only need one window to troubleshoot the device or install updates, the main command you need to know is to how to close the session. Press **Ctrl+a**, release the buttons, and then immediately press **\\**. This will terminate all sessions without a prompt.
6. You should now be able to see and interact with the serial port. All the system tools in PiKVM will be available in the terminal window. Once you are done, press **Ctrl+a** and then immediately **Ctrl+x** to terminate the session.
-----