From 336b070c06dd52eaa3e20a21e0a92e8e1507f587 Mon Sep 17 00:00:00 2001 From: tiyn Date: Mon, 30 Mar 2026 07:33:21 +0200 Subject: [PATCH] hardware entries: - changed wi-fi entry in linux folder for a general one - improved linking of hardware entries via sections - added bluez troubleshooting --- wiki/bluetooth.md | 10 +++---- wiki/hardware_(general).md | 16 ++++++++++- wiki/linux/bluez.md | 49 ++++++++++++++++++++++++++++++++-- wiki/linux/hardware_(linux).md | 26 +++++++++++++----- wiki/linux/networkmanager.md | 5 +++- wiki/linux/systemd.md | 8 +++--- wiki/linux/wi-fi.md | 27 ------------------- wiki/linux/wpa_supplicant.md | 6 ++++- wiki/wi-fi.md | 9 +++++++ 9 files changed, 109 insertions(+), 47 deletions(-) delete mode 100644 wiki/linux/wi-fi.md create mode 100644 wiki/wi-fi.md diff --git a/wiki/bluetooth.md b/wiki/bluetooth.md index 280141a..848bd57 100644 --- a/wiki/bluetooth.md +++ b/wiki/bluetooth.md @@ -1,8 +1,8 @@ # Bluetooth -[Bluetooth](https://www.bluetooth.com/) is a short-range technology for wireless -data transfer. +[Bluetooth](https://www.bluetooth.com/) is a short-range technology for wireless data transfer. +From a [hardware](/wiki/hardware_%28general%29.md) perspective Bluetooth requires a compatible +adapter to work which may be integrated or external. -For [Linux](/wiki/linux.md) based operating systems the -[bluez package](/wiki/linux/bluez.md) is used as the implementation of the -bluetooth standard. +Informations on Bluetooth usage on [Linux](/wiki/linux.md)-based operating systems are described in +the [Bluetooth section of the Linux hardware entry](/wiki/linux/hardware_%28linux%29.md#bluetooth). diff --git a/wiki/hardware_(general).md b/wiki/hardware_(general).md index 57da130..0f32230 100644 --- a/wiki/hardware_(general).md +++ b/wiki/hardware_(general).md @@ -4,7 +4,21 @@ This entry focusses on various hardware components of a general desktop PC or a For [Linux](/wiki/linux.md) Systems see [the corresponding entry](/wiki/linux/hardware_%28linux%29.md). -## Contents of Technic Bag +## Hardware Functionality + +The following subsections address functions that rely on dedicated hardware modules or adapters. + +### Bluetooth + +Configuration and troubleshooting for Bluetooth functionality are described in the +[corresponding Bluetooth entry](/wiki/bluetooth.md). + +### Wi-Fi + +Configuration and troubleshooting for Wi-Fi functionality are described in the +[corresponding Wi-Fi entry](/wiki/wi-fi.md). + +## Technic Bag The following are components that are useful to be included in cable- and technic bags to. For power banks and power supplies it is useful to check for the power delivery standard. diff --git a/wiki/linux/bluez.md b/wiki/linux/bluez.md index ecebf5f..55e9ca7 100644 --- a/wiki/linux/bluez.md +++ b/wiki/linux/bluez.md @@ -1,7 +1,7 @@ # BlueZ -[BlueZ](http://www.bluez.org/) is an implementation of the -[Bluetooth](/wiki/bluetooth.md) standard. +[BlueZ](http://www.bluez.org/) is an implementation of the [Bluetooth](/wiki/bluetooth.md) +standard. This entry features the BlueZ package and all software that is based on it. ## Setup @@ -20,6 +20,10 @@ systemctl enable bluetooth.service ## Usage +This section addresses the usage of Bluez. + +### Connecting and Pairing of Devices + The Bluetooth features can be managed by different types of front-ends. - `bluetoothctl` is a command-line interface included in the `bluez-utils` @@ -31,3 +35,44 @@ The Bluetooth features can be managed by different types of front-ends. Using `bluetuith` the [Bluetooth](/wiki/bluetooth.md) can be turned on (or off) by pressing `o`, devices can be searched for by pressing `s`, a selected device can be paired by pressing `p` and finally connected by pressing `c` before `bluetuith` can be left with `Q`. + +## Troubleshooting + +This section will focus on errors and the fixing of errors of Bluez. + +### `bluetuith: no adapter found` or `bluetoothctl: No default controller available` + +When this error occurs the adapter is not recognized by the software. +This can be confirmed using the following command and looking for the bluetooth adapter. + +```sh +lsusb +``` + +If it is indeed not found it may be blocked by `rfkill`. +To check this run the following command. + +```sh +rfkill +``` + +This command will display something similar to the following. + +```txt +0: hci0: Bluetooth + Soft blocked: no + Hard blocked: no +``` + +If the command displays `Soft blocked: yes` or `Hard blocked: yes` beneath the Bluetooth device it +has to be unblocked to use it. +For this run the following command where `` is the name of the Bluetooth adapter +(in this case it would be `hci0`). + +```sh +rfkill unblock +``` + +Afterwards the adapter will probably be recognized again but a restart of service +`bluetooth.service` eventually has to be restarted as described in the +[systemd entry](/wiki/linux/systemd.md#startstopenabledisable-a-service-and-retrieve-its-logs). diff --git a/wiki/linux/hardware_(linux).md b/wiki/linux/hardware_(linux).md index 3276150..a4f81b3 100644 --- a/wiki/linux/hardware_(linux).md +++ b/wiki/linux/hardware_(linux).md @@ -5,7 +5,11 @@ laptop. For non-Linux specific or general topics in hardware see the [corresponding entry](/wiki/hardware_%28general%29.md) -## Battery +## Hardware Functionality + +The following subsections address functions that rely on dedicated hardware modules or adapters. + +### Battery The battery of a notebook can be inspected by using the `upower` command. To use it the tool needs to be installed. @@ -40,24 +44,34 @@ For this run the following command. acpi -b ``` -## Power Management +### Bluetooth + +[Bluetooth](/wiki/bluetooth.md) on [Linux](/wiki/linux.md) is generally managed by +[Bluez](/wiki/linux/bluez.md). + +### Wi-Fi + +Wi-Fi functionality on [Linux](/wiki/linux.md) is handled by various tools such as +[WPA Supplicant](/wiki/linux/wpa_supplicant.md) or [NetworkManager](/wiki/linux/networkmanager.md). + +### Power Management Tools, programs and guides to manage the power usage and improve battery life are described in the [power management entry](/wiki/linux/power_management.md). -## (Liquid) Coolers +### (Liquid) Coolers The viewing of temperatures of coolers as well as the selection of RGB-settings can be achieved by using [liquidctl](https://github.com/liquidctl/liquidctl). -## Temperature +### Temperature To check the temperature the command `sensors` can be used which (on most distributions) is a part of the `lm_sensors` package. It will then display all the available temperature sensors available as well as many other sensors like the RPM for fans. -## ThinkPad TrackPoint +### ThinkPad TrackPoint This section is based on a [Reddit comment by zedbraxmen](https://www.reddit.com/r/thinkpad/comments/wjb8qz/configuring_trackpoint_in_wayland/). @@ -75,7 +89,7 @@ ATTR{device/sensitivity}="275", ATTR{device/speed}="215", ``` -## Fingerprint Readers +### Fingerprint Readers Many modern laptops include fingerprint sensors which can be used for authentication on [Linux](/wiki/linux.md). diff --git a/wiki/linux/networkmanager.md b/wiki/linux/networkmanager.md index d221af8..9db6926 100644 --- a/wiki/linux/networkmanager.md +++ b/wiki/linux/networkmanager.md @@ -2,7 +2,7 @@ NetworkManager - short NM - is a program to automatically detect and connect to networks by providing options for various configuration. -It is used to set up [Wi-Fi](/wiki/linux/wi-fi.md). +It is used to set up [Wi-Fi](/wiki/linux/hardware_%28linux%29.md#wi-fi). ## Setup @@ -50,3 +50,6 @@ It will restart the [SystemD](/wiki/linux/systemd.md) service and enable the Wi- systemctl restart NetworkManager nmcli radio wifi on ``` + +If the error still persists afterwards it may be useful to also restart WPA Supplicant as explained +[in the corresponding section of its entry](/wiki/linux/wpa_supplicant.md#restarting-wpa-supplicant). diff --git a/wiki/linux/systemd.md b/wiki/linux/systemd.md index ae544f6..edbece5 100644 --- a/wiki/linux/systemd.md +++ b/wiki/linux/systemd.md @@ -52,7 +52,7 @@ To start the service after boot it has to be enabled. This works accordingly with the keyword `enable`. The `disable` keyword stops the service from starting automatically. -Logs of the last start of the service can be found by running `systemctl status `. +Logs of the last start of the service can be found by running `systemctl status `. ### Retrieving the SystemD Logs @@ -72,7 +72,7 @@ This time will be used to determine the time that is taken from suspend to hiber suspend-to-hibernate is called. The following line will set this to 10 minutes. -```txt +```txt HibernateDelaySec=10min ``` @@ -102,7 +102,7 @@ ignore. As [machetie writes on Reddit](https://www.reddit.com/r/framework/comments/185035i/how_to_use_the_laptop_with_lid_closed_linux/) the following settings need to be set. -```txt +```txt HandleLidSwitch=ignore HandleLidSwitchExternalPower=ignore HandleLidSwitchDocked=ignore @@ -125,6 +125,6 @@ This error signals problems with the trusted platform module. This however usually can be fixed easily by masking the service and is done like the following command shows. -```sh +```sh systemctl mark dev-tpmrm0.device ``` diff --git a/wiki/linux/wi-fi.md b/wiki/linux/wi-fi.md deleted file mode 100644 index c487e29..0000000 --- a/wiki/linux/wi-fi.md +++ /dev/null @@ -1,27 +0,0 @@ -# Wi-Fi - -Wi-Fi is a type of wireless network protocol that is used for local area networks. -On [Linux-based systems](/wiki/linux.md) there are different programs that handle the Wi-Fi -connection. - -- [WPA Supplicant](/wiki/linux/wpa_supplicant.md) is used for WPA2 and WPA3 connections among - others. -- [NetworkManager](/wiki/linux/networkmanager.md) is used for various network connections. - -## Usage - -Tipps for usage can be found under the corresponding entries. - -## Troubleshooting - -Tipps for troubleshooting can be found under the corresponding entries, but the ones that use -multiple programs to fix are listed here. - -### Restart WPA Supplicant and Reenable the Wi-Fi device - -A simple fix for many problems is a restart of [WPA Supplicant](/wiki/linux/wpa_supplicant.md) -aswell as reenabling the Wi-Fi device using [NetworkManager](/wiki/linux/networkmanager.md). -This can be done by first restarting WPA Supplicant as explained in the -[corresponding section](/wiki/linux/wpa_supplicant.md#restarting-wpa-supplicant) and then -reenabling the Wi-Fi device as explained in the -[section of NetworkManagers entry](/wiki/linux/networkmanager.md#restarting-and-reenabling-wi-fi). diff --git a/wiki/linux/wpa_supplicant.md b/wiki/linux/wpa_supplicant.md index 58a56af..d6d18c4 100644 --- a/wiki/linux/wpa_supplicant.md +++ b/wiki/linux/wpa_supplicant.md @@ -3,7 +3,7 @@ `wpa_supplicant` is a free implementation of an IEEE 802.11i supplicant. It is especially interesting due to its WPA2 and WPA3 capabilities in contrast to other networking software. -It is used to set up [Wi-Fi](/wiki/linux/wi-fi.md). +It is used to set up [Wi-Fi](/wiki/linux/hardware_%28linux%29.md#wi-fi). ## Usage @@ -32,3 +32,7 @@ Most of the problems regarding WPA Supplicant can be fixed by restarting the ```sh systemctl restart wpa_supplicant ``` + +Afterwards - if the error still persists - it may be useful to reenable the Wi-Fi device as +explained in the +[section of the NetworkManager entry](/wiki/linux/networkmanager.md#restarting-and-reenabling-wi-fi). diff --git a/wiki/wi-fi.md b/wiki/wi-fi.md new file mode 100644 index 0000000..04078e7 --- /dev/null +++ b/wiki/wi-fi.md @@ -0,0 +1,9 @@ +# Wi-Fi (General) + +Wi-Fi is a wireless networking technology used for wireless local area networks also called WLAN. +It allows devices to communicate over radio frequencies without physical cables. +It needs a module or adapter and therefore relies on dedicated +[hardware](/wiki/hardware_%28general%29.md). + +Informations on Wi-Fi usage on [Linux](/wiki/linux.md)-based operating systems are described in +the [Wi-Fi section of the Linux hardware entry](/wiki/linux/hardware_%28linux%29.md#wi-fi).