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

improved first steps

This commit is contained in:
Maxim Devaev 2021-10-16 03:22:15 +03:00
parent 868155d1c8
commit 8fe46839a3
2 changed files with 32 additions and 8 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

26
docs/first_steps.md
View File

@ -1,5 +1,31 @@
# First steps
## First power on
??? example "Optional setting up Wi-Fi"
!!! warning
There is nothing more reliable than wired Ethernet, so it's better to use the cable. But who are we to stop you... :)
If you want to connect PiKVM to Wi-Fi network, you need to tell the device ESSID and password before first boot.
To do this, mount the first partition of the memory card (FAT32) and edit the `pikvm.txt` file there.
Do not remove line `FIRSTBOOT=1`, just add your wifi settings like this:
```
FIRSTBOOT=1
WIFI_ESSID="mynet"
WIFI_PASSWD="p@s$$w0rd"
```
There is a possibility that, in countries that support CH13, the Raspberry will not connect.
You will need to configure your router to disable channels 12-14 or disable Auto scan mode so it will connect.
Save, unmount and follow the next step.
**Power up the device.**
After turning on the power, PiKVM OS generates unique SSH keys and certificates. Do not turn off the Raspberry Pi until it's fully booted. If you set up Wi-Fi in step 1, it won't be able to connect to the network on the first boot. You need to wait 10 minutes for all the OS preparations to complete, then just restart the device. On the second boot, the Raspberry will connect to the network without any problems.
## Getting access to PiKVM
By default, PiKVM receives a dynamic IP address via DHCP.

14
docs/v3.md
View File

@ -35,11 +35,9 @@ If you have a kit without a metal case, you can use our free 3D printing case dr
* Connect **Ethernet** to the network and **USB Power** to the Raspberry Pi power supply.
4. **Turn on the power supply.**
4. **Carefully read [the "First steps" guide](first_steps.md){target=_blank}** - how to find a device on the network, how to log in there, change passwords, and so on. **Follow the steps described there and come back here**.
5. **Carefully read [the "First steps" guide](first_steps.md){target=_blank}** - how to find a device on the network, how to log in there, change passwords, and so on. **Follow the steps described there and come back here**.
6. ??? note "If your kit includes the OLED display and/or the fan, you'll need to turn them on"
5. ??? note "If your kit includes the OLED display and/or the fan, you'll need to turn them on"
Log in to PiKVM and run these commands:
```
# rw
@ -48,15 +46,15 @@ If you have a kit without a metal case, you can use our free 3D printing case dr
# ro
```
7. !!! danger "Just reminding again: CHANGE THE PASSWORDS! :)"
6. !!! danger "Just reminding again: CHANGE THE PASSWORDS! :)"
How to do this was written in [the "First steps" guide](first_steps.md){target=_blank}
8. **Try to manage the computer using PiKVM with the Web Interface.** Make sure that you see the image, and the keyboard and mouse are working. If something doesn't work, check out our [FAQ](faq.md) (it's really useful). If nothing helped, you can get support in our [Discord chat](https://discord.gg/bpmXfz5).
7. **Try to manage the computer using PiKVM with the Web Interface.** Make sure that you see the image, and the keyboard and mouse are working. If something doesn't work, check out our [FAQ](faq.md) (it's really useful). If nothing helped, you can get support in our [Discord chat](https://discord.gg/bpmXfz5).
9. ??? note "Check the HDMI backpowering problem"
8. ??? note "Check the HDMI backpowering problem"
Try restarting PiKVM using the `reboot` command executed in the terminal. If PiKVM hangs during boot (you can't get the Web Interface for a long time), then you are faced with this rare problem. **Don't worry, it's easy to fix.** Turn off the PiKVM, disconnect all cables from it, take a close look at the [diagram of its ports and jumpers](#io-ports-and-jumpers), and **remove jumper #14** (it is to the right of the CSI connector). Then you can connect and power up PiKVM again. Now everything will be fine.
10. !!! warning "IO ports and other things"
9. !!! warning "IO ports and other things"
**Before using GPIO** pins to control a relay, KVM switch, or anything else, be sure to [check the HAT pinout](#io-ports-and-jumpers). Many ports are busy with internal functions. Before using them for your own use, you must disable them, otherwise you may damage the device.