Merge 66c6997a61 into 6ae558ee2b

docs/troubleshooting.md

@@ -10,49 +10,72 @@ It is designed for beginners following the IoT-For-Beginners curriculum, but is
 ### ❗ `ModuleNotFoundError: No module named 'xyz'`
 This happens when required Python modules are not installed.
 
-**Fix**
+**Fix:**
 ```bash
 pip3 install <module_name>
+```
 
- Permission denied when running scripts
+### ❗ Permission denied when running scripts
-
 Often caused by accessing GPIO, I2C or system hardware without elevated privileges.
-Quick fix:
+
+**Quick fix:**
+```bash
 sudo python3 script.py
+```
 
-Recommended fix (no sudo needed every time):
+**Recommended fix (avoids using `sudo` every time):**
-sudo usermod -aG gpio,i2c,spi $USER
+```bash
+sudo usermod -aG gpio,i2c,spi \$USER
 sudo reboot
+```
 
-2. GPIO / I2C / SPI Not Working
+---
-❗ RuntimeError: No access to GPIO
+
+## 2. GPIO / I2C / SPI Not Working
+
+### ❗ `RuntimeError: No access to GPIO`
 
 Add user to GPIO group:
-sudo usermod -aG gpio $USER
+```bash
+sudo usermod -aG gpio \$USER
 sudo reboot
+```
 
 ❗ I2C / SPI devices not detected
 
-Enable interfaces:
+1. Enable interfaces:
-sudo raspi-config
+   ```bash
-→ Interface Options
+   sudo raspi-config
-→ Enable I2C / Enable SPI
+   ```
+   → **Interface Options**
+   
+   → **Enable I2C** / **Enable SPI**
+2. Check if the I2C device appears:
+   ```bash
+   i2cdetect -y 1
+   ```
 
-Check if I2C device appears:
+---
-i2cdetect -y 1
 
-3. Camera / Video Issues
+## 3. Camera / Video Issues
 ❗ Camera not detected or fails to start
 
-Enable camera interface:
+1. Enable camera interface:
-sudo raspi-config
+   ```bash
-→ Interface Options → Camera → Enable
+   sudo raspi-config
-sudo reboot
+   ```
-
+   → **Interface Options** → **Camera** → **Enable**
-Check if camera is visible:
+2. Reboot the system:
-vcgencmd get_camera
+   ```bash
+   sudo reboot
+   ```
+3. Check if the camera is visible:
+   ```bash
+   vcgencmd get_camera
+   ```
 
 4. Wi-Fi / SSH / Connectivity Problems
+
 | Problem                          | Fix                                           |
 | -------------------------------- | --------------------------------------------- |
 | SSH connection refused           | `sudo raspi-config → Interface Options → SSH` |
@@ -60,9 +83,11 @@ vcgencmd get_camera
 | Slow Wi-Fi / unstable connection | Prefer 2.4 GHz band, update OS                |
 | Unable to access Pi headless     | Add `ssh` file to boot partition              |
 
+---
+
+## 5. Performance Issues
 
-5. Performance Issues
+### ❗ Raspberry Pi running slow / laggy
-Raspberry Pi running slow / laggy
 
 Close unused applications
 
@@ -72,11 +97,14 @@ Use Lite OS if no desktop needed
 
 Ensure sufficient power supply (5V/3A or better)
 
-Check CPU load:
+* **Check CPU / Memory load:** 
-top
+  ```bash
-htop
+  top
-
+  htop
-Storage issues:
+  ```
-sudo apt autoremove
+* **Storage issues:**
-sudo apt clean
+  ```bash
-df -h
+  sudo apt autoremove
+  sudo apt clean
+  df -h
+  ```