mirror of https://github.com/pikvm/pikvm
You cannot select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
88 lines
2.8 KiB
Markdown
88 lines
2.8 KiB
Markdown
# Setting up Wi-Fi
|
|
|
|
!!! tip
|
|
There is nothing more reliable than wired Ethernet, so it's better to use it. Wi-Fi with the steel case (on PiKVM V3 and V4) results in poor performance. But who are we to stop you... :)
|
|
|
|
The following describes how to setup a Wi-Fi connection.
|
|
We recommend to do this while having a display and keyboard
|
|
or a serial console connected directly to the Raspberry Pi as you will loose network connectivity once you connect to a Wi-Fi.
|
|
Alternatively you can connect to the PiKVM via SSH. The built-in Web Terminal (available through the browser) should also work.
|
|
|
|
!!! note "Setting up Wi-Fi in the boot config (semi-auto)"
|
|
Check out [this guide](on_boot_config.md) guide. It is mandatory if you're using Zero 2 W board.
|
|
It will useful in most other cases, especially if you have physical access to the memory card.
|
|
|
|
!!! note
|
|
Devices based on Raspberry Pi Zero 2 W does not support 5GHz Wi-Fi.
|
|
|
|
|
|
## Setting up Wi-Fi manually
|
|
|
|
1. Make filesystem writable using `rw` command.
|
|
|
|
2. Create Wi-Fi settings file `/etc/systemd/network/wlan0.network` with following content:
|
|
|
|
```ini
|
|
[Match]
|
|
Name=wlan0
|
|
|
|
[Network]
|
|
DHCP=yes
|
|
DNSSEC=no
|
|
|
|
[DHCP]
|
|
ClientIdentifier=mac
|
|
RouteMetric=50
|
|
```
|
|
|
|
3. Set network ESSID and password:
|
|
|
|
```
|
|
# wpa_passphrase 'MyNetwork' 'P@assw0rd' > /etc/wpa_supplicant/wpa_supplicant-wlan0.conf
|
|
# chmod 640 /etc/wpa_supplicant/wpa_supplicant-wlan0.conf
|
|
```
|
|
|
|
!!! note "Using Wi-Fi with hidden ESSID"
|
|
Add option `scan_ssid=1` to `/etc/wpa_supplicant/wpa_supplicant-wlan0.conf`
|
|
|
|
!!! note "Using 5GHz Wi-Fi in the USA"
|
|
Add option `country=US` to `/etc/wpa_supplicant/wpa_supplicant-wlan0.conf`
|
|
|
|
!!! note "Block 2ghz or 5ghz"
|
|
Add option `bssid=xx:xx:xx:xx:xx:xx` to `/etc/wpa_supplicant/wpa_supplicant-wlan0.conf` within the `network={` block
|
|
|
|
|
|
5. Enable WPA-supplicant service:
|
|
```
|
|
systemctl enable wpa_supplicant@wlan0.service
|
|
```
|
|
|
|
6. Make filesystem read-only again using `ro` command
|
|
|
|
|
|
## Useful console commands
|
|
|
|
* `iwconfig` - Manipulate the basic wireless parameters.
|
|
* `iwlist` - Allow's you to initiate scanning and list frequencies, bit-rates, encryption keys, etc.
|
|
* `iwspy` - Displays per node link quality.
|
|
* `iwpriv` - Allow's you to manipulate the Wireless Extensions specific to a driver (private).
|
|
|
|
??? example "Some examples"
|
|
```
|
|
# iw dev wlan0 scan | egrep "signal:|SSID:" | sed -e "s/\tsignal: //" -e "s/\tSSID: //" | awk '{ORS = (NR % 2 == 0)? "\n" : " "; print}' | sort
|
|
```
|
|
```
|
|
# iwlist wlan0 scan | egrep "Cell|ESSID|Signal|Rates"
|
|
```
|
|
```
|
|
# iwlist wlan0 scan
|
|
```
|
|
```
|
|
# iw wlan0 info
|
|
```
|
|
|
|
|
|
## Additional resources
|
|
|
|
* [Arch Linux Wiki for systemd-networkd](https://wiki.archlinux.org/title/systemd-networkd)
|