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

@@ -1,8 +1,8 @@
 # Bluetooth
 
-[Bluetooth](https://www.bluetooth.com/) is a short-range technology for wireless
+[Bluetooth](https://www.bluetooth.com/) is a short-range technology for wireless data transfer.
-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
+Informations on Bluetooth usage on [Linux](/wiki/linux.md)-based operating systems are described in
-[bluez package](/wiki/linux/bluez.md) is used as the implementation of the
+the [Bluetooth section of the Linux hardware entry](/wiki/linux/hardware_%28linux%29.md#bluetooth).
-bluetooth standard.

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.

wiki/linux/bluez.md

@@ -1,7 +1,7 @@
 # BlueZ
 
-[BlueZ](http://www.bluez.org/) is an implementation of the
+[BlueZ](http://www.bluez.org/) is an implementation of the [Bluetooth](/wiki/bluetooth.md)
-[Bluetooth](/wiki/bluetooth.md) standard.
+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 `<bluetooth-adapter>` is the name of the Bluetooth adapter
+(in this case it would be `hci0`).
+
+```sh
+rfkill unblock <bluetooth-adapter>
+```
+
+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).

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).

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).

wiki/linux/wi-fi.md

@@ -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).

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).

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).