39 KiB

Raw Permalink Blame History

Troubleshooting Guide

This guide helps you solve common problems when working with the IoT for Beginners curriculum. Issues are organized by category for easy navigation.

Installation Issues

Python Installation

Problem: Python version is too old

Error: Python 3.6 or higher is required

Solution:

Download the latest Python 3 from python.org
During installation on Windows, check "Add Python to PATH"
Verify installation:
```
python3 --version
```

Problem: Multiple Python versions causing conflicts

Symptoms: Wrong Python version runs, packages install to wrong location

Solution:

Windows: Use py -3 instead of python to explicitly call Python 3
macOS/Linux: Use python3 instead of python
Always create and use virtual environments for projects

Problem: pip command not found

Error: 'pip' is not recognized as an internal or external command

Solution:

Try pip3 instead of pip
Or use python -m pip or python3 -m pip
Ensure Python is added to PATH (reinstall Python and check the option)

VS Code and Extensions

Problem: Pylance extension not working

Symptoms: No Python IntelliSense, code completion, or type checking

Solution:

Open VS Code Command Palette (Ctrl+Shift+P or Cmd+Shift+P)
Run "Python: Select Interpreter"
Choose the correct Python interpreter (virtual environment if using one)
Reload VS Code window

Problem: VS Code not detecting virtual environment

Symptoms: Wrong Python interpreter selected

Solution:

Ensure you've activated the virtual environment in the terminal
Open Command Palette and run "Python: Select Interpreter"
Select the interpreter from .venv folder
Check the status bar (bottom left) shows the correct Python version

PlatformIO (Wio Terminal)

Problem: PlatformIO installation fails

Error: Various errors during PlatformIO installation

Solution:

Ensure VS Code is up to date
Install the C/C++ extension first
Restart VS Code after installing PlatformIO
Check your internet connection (PlatformIO downloads large files)

Problem: Board not detected by PlatformIO

Symptoms: Cannot upload code to Wio Terminal

Solution:

Try a different USB cable (some cables are charge-only)
Check Device Manager (Windows) or ls /dev/tty* (macOS/Linux)
Install or update USB drivers
Try a different USB port
Slide the power switch on the Wio Terminal twice quickly to enter bootloader mode

Problem: Compilation errors in PlatformIO

Error: fatal error: Arduino.h: No such file or directory

Solution:

Delete .pio folder in your project
Run "PlatformIO: Rebuild" from Command Palette

Ensure platformio.ini has correct board configuration:

[env:seeed_wio_terminal]
platform = atmelsam
board = seeed_wio_terminal
framework = arduino

Grove Libraries

Problem: Grove library import fails on Raspberry Pi

Error: ModuleNotFoundError: No module named 'grove'

Solution:

Reinstall Grove libraries:

cd ~
git clone https://github.com/Seeed-Studio/grove.py
cd grove.py
sudo pip3 install .

If using virtual environment, you may need to install globally or copy libraries
Verify I2C is enabled: sudo raspi-config nonint do_i2c 0

Problem: Grove sensor not detected

Error: IOError: [Errno 121] Remote I/O error

Solution:

Check physical connections (ensure Grove cable is fully inserted)
Verify sensor is connected to correct port (analog, digital, I2C, UART)
Run i2cdetect -y 1 to see if device appears on I2C bus
Try a different Grove cable
Ensure Grove Base Hat is properly seated on Raspberry Pi GPIO pins

Hardware Issues

Raspberry Pi

Problem: Raspberry Pi won't boot

Symptoms: No display, no LED activity, or rainbow screen

Solution:

Check power supply: Use official 5V 3A USB-C power supply for Pi 4
SD card issues:
- Reformat SD card and reinstall Raspberry Pi OS
- Try a different SD card (use recommended brands)
- Ensure SD card is properly inserted
Check HDMI connection: Try both HDMI ports on Pi 4, use HDMI port closest to power

Problem: Cannot SSH to Raspberry Pi

Symptoms: Connection refused or timeout

Solution:

Enable SSH:
- When flashing SD card with Raspberry Pi Imager, configure SSH in advanced options
- Or create empty file named ssh (no extension) in boot partition
Find Pi's IP address:
- Check your router's connected devices
- Use ping raspberrypi.local (if mDNS works)
- Use network scanning tools like nmap or Angry IP Scanner
Check network:
- Ensure Pi is on same network as your computer
- Try ethernet connection instead of WiFi
Verify username/password (default: username pi, password raspberry)

Problem: Grove Base Hat not recognized

Symptoms: Sensors not working, I2C errors

Solution:

Ensure Base Hat is properly seated on all GPIO pins
Check for bent pins on Pi or Base Hat

Enable I2C interface:

sudo raspi-config nonint do_i2c 0
sudo reboot

Verify I2C is working: i2cdetect -y 1

Problem: Raspberry Pi running slow

Symptoms: Laggy UI, slow response

Solution:

Check SD card speed (use Class 10 or better, or SSD via USB)
Free up disk space: df -h to check, delete unnecessary files
Reduce GPU memory in raspi-config if not using camera/display heavily
Close unnecessary applications
Consider upgrading to Pi 4 with more RAM if using Pi 3 or older

Wio Terminal

Problem: Wio Terminal screen stays blank

Symptoms: No display output after uploading code

Solution:

Check if code initializes the display (TFT_eSPI library)
Update Wio Terminal firmware from Seeed Wiki

Add display initialization code:

#include <TFT_eSPI.h>
TFT_eSPI tft;
tft.begin();
tft.fillScreen(TFT_BLACK);

Try uploading example sketch from PlatformIO to test hardware

Problem: WiFi not working on Wio Terminal

Symptoms: Cannot connect to WiFi, network errors

Solution:

Update WiFi firmware: Follow Wio Terminal WiFi firmware update guide
Check WiFi credentials: Ensure SSID and password are correct
WiFi band: Wio Terminal only supports 2.4GHz WiFi (not 5GHz)
Signal strength: Move closer to router
Router settings: Some enterprise/WPA-Enterprise networks may not work

Problem: Wio Terminal not recognized by computer

Symptoms: USB device not detected

Solution:

Try different USB cable: Use data cable, not charge-only cable
Enter bootloader mode: Slide power switch down twice quickly
- Blue LED should pulse, device appears as "Arduino" in Device Manager
Install drivers (Windows):
- Download and install Seeed USB driver
Try different USB port: Avoid USB hubs, use direct connection
Update system USB drivers

Problem: Sensors not working on Wio Terminal

Symptoms: Grove sensors not reading data

Solution:

Check Grove cable connections
Verify you're using correct Grove port (left or right)
Include correct libraries for sensor
Check sensor power requirements
Test sensor with example code from library

Virtual Device (CounterFit)

Problem: CounterFit app won't start

Error: Various Python errors when starting CounterFit

Solution:

Ensure virtual environment is activated
Install/reinstall CounterFit:
```
pip install CounterFit
```
Check port 5000 is not already in use:
- Windows: netstat -ano | findstr :5000
- macOS/Linux: lsof -i :5000
Kill process using port 5000 or use different port:
```
counterfit --port 5001
```

Problem: Cannot connect to CounterFit from code

Error: Connection refused or timeout

Solution:

Verify CounterFit is running: Open browser to http://127.0.0.1:5000
Check connection URL in code matches CounterFit address
Ensure firewall isn't blocking connection
Try restarting both CounterFit app and your code

Problem: Sensors not appearing in CounterFit

Symptoms: Created sensors don't show in CounterFit UI

Solution:

Create sensors in CounterFit UI before running code
Refresh browser page
Check sensor type matches what code expects
Clear browser cache

Connectivity Issues

WiFi Connection

Problem: Device can't connect to WiFi

Symptoms: Connection timeout, authentication failed

Solution:

Check SSID and password: Verify credentials are correct
WiFi band: Most IoT devices only support 2.4GHz (not 5GHz)
Router settings:
- Disable AP isolation if enabled
- Use WPA2-PSK security (avoid WPA3, WEP, or open networks)
- Ensure DHCP is enabled
Hidden networks: If SSID is hidden, you may need to explicitly configure it
Signal strength: Move device closer to router
Interference: Other devices, microwaves, or walls can interfere

Problem: WiFi connection drops frequently

Symptoms: Intermittent connectivity

Solution:

Check router stability and consider reboot
Update device firmware
Use static IP instead of DHCP
Reduce distance to router or add WiFi extender
Check for interference from other devices
Verify power supply is adequate (especially for Raspberry Pi)

Cloud Services

Problem: Cannot connect to Azure IoT Hub

Error: Authentication failed, connection refused

Solution:

Verify credentials:
- Check connection string is correct
- Ensure no extra spaces or line breaks in connection string
Check device registration: Device must be registered in IoT Hub
Firewall/proxy: Ensure outbound MQTT (port 8883) or HTTPS (port 443) is allowed
IoT Hub region: Ensure IoT Hub is running and not in different region causing latency
Quota limits: Check if free tier limits are exceeded

Test connection:

az iot hub device-identity show-connection-string --hub-name YourIoTHub --device-id YourDevice

Problem: Azure Functions not triggering

Symptoms: Messages sent but function doesn't execute

Solution:

Check Function App is running (not stopped)
Verify connection string in Function App settings
Check function logs in Azure Portal
Ensure Event Hub compatible endpoint is configured correctly
Verify message format matches function expectations
Check Function App service plan (consumption vs. dedicated)

MQTT

ਸਮੱਸਿਆ: MQTT ਕਨੈਕਸ਼ਨ ਫੇਲ

ਗਲਤੀ: ਕਨੈਕਸ਼ਨ ਵਾਪਸ ਠੁੱਕੀ ਗਈ, ਪ੍ਰਮਾਣਿਕਤਾ ਅਸਫਲ

ਹੱਲ:

ਬ੍ਰੋਕਰ ਐਡਰੈੱਸ: ਬ੍ਰੋਕਰ URL/IP ਸਹੀ ਹੈ ਜਾਂ ਨਹੀਂ ਜਾਂਚੋ
ਪੋਰਟ: ਪੋਰਟ ਨੰਬਰ ਚੈੱਕ ਕਰੋ (1883 ਗੇੜਾ ਲੇਖਨ ਲਈ, 8883 TLS ਲਈ)
ਪ੍ਰਮਾਣਿਕਤਾ: ਜੇ ਲੋੜ ਹੈ ਤਾਂ ਯੂਜ਼ਰਨਾਮ/ਪਾਸਵਰਡ ਦੀ ਜਾਂਚ ਕਰੋ
TLS/SSL: ਸਰਟੀਫਿਕੇਟ ਵੈਧ ਅਤੇ ਭਰੋਸੇਯੋਗ ਹੋਣ ਯਕੀਨੀ ਬਣਾਓ
ਫਾਇਰਵਾਲ: ਪੋਰਟ ਰੋਕਿਆ ਨਹੀਂ ਗਿਆ ਹੈ ਜਾਂ ਨਹੀਂ ਜਾਂਚੋ
MQTT ਕਲਾਇੰਟ ਨਾਲ ਟੈਸਟ ਕਰੋ: MQTT Explorer ਜਾਂ mosquitto_pub/sub ਨਾਲ ਟੈਸਟ ਕਰੋ

ਸਮੱਸਿਆ: MQTT ਸੁਨੇਹੇ ਪ੍ਰਾਪਤ ਨਹੀਂ ਹੋ ਰਹੇ

ਲੱਛਣ: ਸੁਨੇਹੇ ਪ੍ਰਕਾਸ਼ਿਤ ਕੀਤੇ ਗਏ ਪਰ ਗ੍ਰਾਹਕਾਂ ਨੂੰ ਨਹੀਂ ਮਿਲ ਰਹੇ

ਹੱਲ:

ਟਾਪਿਕ ਨਾਮ: ਗ੍ਰਾਹਕ ਟਾਪਿਕ ਪਬਲਿਸ਼ਰ ਟਾਪਿਕ ਨਾਲ ਬਿਲਕੁਲ ਮੇਲ ਖਾਂਦਾ ਹੈ ਜਾਂ ਨਹੀਂ
QoS ਸਤਰ: 0 ਦੀ ਬਜਾਏ QoS 1 ਜਾਂ 2 ਦੀ ਕੋਸ਼ਿਸ਼ ਕਰੋ
ਵਾਈਲਡਕਾਰਡ: ਟਾਪਿਕ ਵਾਈਲਡਕਾਰਡ ਸਹੀ ਵਰਤੇ ਗਏ ਹਨ ਜਾਂ ਨਹੀਂ ਜਾਂਚੋ (+ ਇੱਕ ਪੱਧਰ ਲਈ, # ਕਈ ਪੱਧਰਾਂ ਲਈ)
ਰਿਟੇਨ ਕੀਤਾ ਸੁਨੇਹਾ: ਪਬਲਿਸ਼ਰ ਅਖੀਰਲਾ ਸੁਨੇਹਾ ਰੱਖਣ ਲਈ ਰਿਟੇਨ ਫਲੈਗ ਸੈਟ ਕਰ ਸਕਦਾ ਹੈ
ਕਨੈਕਸ਼ਨ ਸਮਾਂ: ਸੂਨਹੇ ਪ੍ਰਕਾਸ਼ਿਤ ਹੋਣ ਤੋਂ ਪਹਿਲਾਂ ਗ੍ਰਾਹਕ ਜੁੜਿਆ ਹੋਣਾ ਚਾਹੀਦਾ ਹੈ

ਸੈਂਸਰ ਅਤੇ ਐਕਚੁਏਟਰ ਸਮੱਸਿਆਵਾਂ

Grove ਸੈਂਸਰ

ਸਮੱਸਿਆ: ਸੈਂਸਰ ਗਲਤ ਮੁੱਲ ਵਾਪਸ ਕਰਦਾ ਹੈ

ਲੱਛਣ: ਪੜ੍ਹਤਿਆਂ ਦਾ ਮੁੱਲ 0, -1 ਜਾਂ ਬੇਤੱਤੂਕ ਹੈ

ਹੱਲ:

ਕਨੈਕਸ਼ਨ ਚੈੱਕ ਕਰੋ: ਯਕੀਨੀ ਬਣਾਓ ਕਿ ਸੈਂਸਰ ਠੀਕ ਤਰ੍ਹਾਂ ਜੁੜਿਆ ਹੈ
ਸਹੀ ਪੋਰਟ: ਸੈਂਸਰ ਸਹੀ ਕਿਸਮ ਦੇ ਪੋਰਟ ਵਿੱਚ ਹੈ ਜਾਂ ਨਹੀਂ:
- ਐਨਾਲੋਗ ਸੈਂਸਰ → ਐਨਾਲੋਗ ਪੋਰਟ (A0, A2, A4)
- ਡਿਜੀਟਲ ਸੈਂਸਰ → ਡਿਜੀਟਲ ਪੋਰਟ (D5, D16, D18, ਆਦਿ)
- I2C ਸੈਂਸਰ → I2C ਪੋਰਟ
ਕੈਲਿਬ੍ਰੇਸ਼ਨ: ਕੁਝ ਸੈਂਸਰਾਂ ਨੂੰ ਕੈਲਿਬ੍ਰੇਸ਼ਨ ਦੀ ਲੋੜ ਹੁੰਦੀ ਹੈ (ਮਿੱਟੀ ਦੀ ਨਮਤਾ, ਰੋਸ਼ਨੀ)
ਪਾਵਰ ਸਾਈਕਲ ਕਰੋ: ਸੈਂਸਰ ਨੂੰ ਅਣਜوڑ ਕੇ ਦੁਬਾਰਾ ਜੋੜੋ
ਸੈਂਸਰ ਡੇਟਾਸ਼ੀਟ: ਸੈਂਸਰ ਦੇ ਨਿਰਦੇਸ਼ ਅਤੇ ਲੋੜਾਂ ਦੀ ਜਾਂਚ ਕਰੋ

ਸਮੱਸਿਆ: Capacitive soil moisture sensor ਹਮੇਸ਼ਾ ਗਿੱਲਾ ਪੜ੍ਹਦਾ ਹੈ

ਲੱਛਣ: ਸੈਂਸਰ ਸੁੱਕਾ ਹੋਣ ਦੇ ਬਾਵਜੂਦ ਉੱਚੀ ਨਮਤਾ ਪੜ੍ਹਦਾ ਹੈ

ਹੱਲ:

ਕੈਲਿਬ੍ਰੇਸ਼ਨ ਲੋੜੀਂਦੀ: ਮਿੱਟੀ ਦੇ ਸੈਂਸਰਾਂ ਨੂੰ ਕੈਲਿਬ੍ਰੇਸ਼ਨ ਦੀ ਲੋੜ ਹੁੰਦੀ ਹੈ:
- ਹਵਾ ਵਿੱਚ ਪੜ੍ਹਤਾਂ ਲਵੋ (ਸੁੱਕਾ ਮੂਲ–ਮਾਪ)
- ਪਾਣੀ ਵਿੱਚ ਪੜ੍ਹਤਾਂ ਲਵੋ (ਗੀਲਾ ਮੂਲ–ਮਾਪ)
- ਇਨ੍ਹਾਂ ਮੁੱਲਾਂ ਵਿਚਕਾਰ ਪੜ੍ਹਤਾਂ ਨੂੰ ਮੈਪ ਕਰੋ
ਸੈਂਸਰ ਕੋਟਿੰਗ ਚੈੱਕ ਕਰੋ: ਨਮਤਾ ਸੈਂਸਰ ਦਾ ਕੋਟਿੰਗ ਖ਼ਰਾਬ ਹੋ ਸਕਦਾ ਹੈ
ਥਾਂ: ਯਕੀਨੀ ਬਣਾਓ ਕਿ ਸੈਂਸਰ ਮਿੱਟੀ ਵਿੱਚ ਪੂਰੀ ਤਰ੍ਹਾਂ ਲੱਗਿਆ ਹੋਇਆ ਹੈ

ਸਮੱਸਿਆ: ਤਾਪਮਾਨ/ਨਮੀ ਸੈਂਸਰ ਦੀ ਪੜ੍ਹਾਈ ਗਲਤ ਹੈ

ਲੱਛਣ: DHT11/DHT22 ਗਲਤ ਤਾਪਮਾਨ ਜਾਂ ਨਮੀ ਦਿਖਾਉਂਦਾ ਹੈ

ਹੱਲ:

ਸੈਂਸਰ ਦੀ ਥਾਂ: ਸਿੱਧੀ ਧੂਪ, ਗਰਮੀ ਦੇ ਸ੍ਰੋਤ ਜਾਂ ਹਵਾ ਬਾਹਰ ਰਹਿਣ ਤੋਂ ਬਚੋ
ਵਾਰਮ-ਅਪ ਸਮਾਂ: ਪਾਵਰ-ਆਨ ਤੋਂ ਬਾਅਦ ਸੈਂਸਰ ਨੂੰ 2 ਸਕਿੰਟ ਦਿਓ
ਪੜ੍ਹਾਈ ਦੀ ਆਵਿਰਤੀ: DHT ਸੈਂਸਰਾਂ ਨੂੰ ਪੜ੍ਹਾਈਆਂ ਵਿੱਚ ਕਮੋ ਤੋਂ ਕਮ 2 ਸਕਿੰਟ ਦੀ ਦੂਰੀ ਚਾਹੀਦੀ ਹੈ
ਕਾਂਡੇਨਸੇਸ਼ਨ ਲਈ ਜਾਂਚ: ਕਾਂਡੇਨਸੇਸ਼ਨ ਪੜ੍ਹਾਈਆਂ 'ਤੇ ਅਸਰ ਪਾ ਸਕਦਾ ਹੈ
ਸੈਂਸਰ ਗੁਣਵੱਤਾ: DHT11 DHT22 ਨਾਲੋਂ ਘੱਟ ਸਹੀ ਹੈ

ਕੈਮਰਾ

ਸਮੱਸਿਆ: Raspberry Pi ਤੇ ਕੈਮਰਾ ਨਹੀਂ ਪਹਿਚਾਣਿਆ ਗਿਆ

ਗਲਤੀ: mmal: mmal_vc_component_create: failed to create component 'vc.ril.camera'

ਹੱਲ:

ਕੈਮਰਾ ਇੰਟਰਫੇਸ ਨੂੰ ਇनेਬਲ ਕਰੋ:
```
sudo raspi-config
```
Interface Options → Camera → Enable ਜਾਓ
ਰਿਬਨ ਕੇਬਲ ਦੀ ਜਾਂਚ ਕਰੋ: ਯਕੀਨੀ ਬਣਾਓ ਕਿ ਕੈਮਰਾ ਕੇਬਲ ਠੀਕ ਤਰ੍ਹਾਂ ਲੱਗਿਆ ਹੈ
- ਪਾਈ ਜ਼ੀਰੋ 'ਤੇ ਨੀਲਾ ਪਾਸਾ USB ਪੋਰਟ ਦੀ ਓਰ ਹੋਣਾ ਚਾਹੀਦਾ ਹੈ
- ਪਾਈ 4 'ਤੇ ਨੀਲਾ ਪਾਸਾ USB ਪੋਰਟ ਤੋਂ ਦੂਰ ਹੋਣਾ ਚਾਹੀਦਾ ਹੈ

Firmware ਨੂੰ ਅਪਡੇਟ ਕਰੋ:

sudo apt update
sudo apt full-upgrade
sudo reboot

ਕੈਮਰਾ ਦੀ ਜਾਂਚ ਕਰੋ:
```
raspistill -o test.jpg
```

ਸਮੱਸਿਆ: ਕੈਮਰਾ ਕੀ ਵਿੱਤਰ ਕੁਆਲਿਟੀ ਖ਼ਰਾਬ ਹੈ

ਲੱਛਣ: ਧੁੰਦਲੀ, ਹਨੇਰੀ ਜਾਂ ਫਿਕੀ ਤਸਵੀਰਾਂ

ਹੱਲ:

ਫੋਕਸ: ਲੈਂਸ ਤੋਂ सुरक्षात्मक ਫਿਲਮ ਹਟਾਓ, ਜੇ ਫੋਕਸ ਸੈਟਿੰਗ ਯੋਗ ਹੈ ਤਦ ਸੰਸੋਧਨ ਕਰੋ
ਰੋਸ਼ਨੀ: ਯਕੀਨੀ ਬਣਾਓ ਕਿ ਪਰਯਾਪਤ ਰੋਸ਼ਨੀ ਹੈ
ਕੈਮਰਾ ਸੈਟਿੰਗ: ਕੋਡ ਵਿੱਚ ਐਕਸਪੋਜ਼ਰ, ISO, ਵ੍ਹਾਈਟ ਬੈਲੈਂਸ ਨੂੰ ਸੈਟ ਕਰੋ
ਸਥਿਰਤਾ: ਕੈਮਰਾ ਨੂੰ тұрақты ਰੱਖੋ, ਜੇ ਜ਼ਰੂਰੀ ਹੋਵੇ ਤਰਿਬੋਡ ਵਰਤੋਂ
ਰੀਜ਼ੋਲੀਉਸ਼ਨ: ਕੈਮਰਾ ਦੀ ਵੱਧ ਤੋਂ ਵੱਧ ਰੀਜ਼ੋਲੀਉਸ਼ਨ ਤੋਂ ਬਹੁਤ ਜ਼ਿਆਦਾ ਨਾ ਕਰੋ

ਮਾਈਕ੍ਰੋਫੋਨ ਅਤੇ ਸਪੀਕਰ

ਸਮੱਸਿਆ: ਆਡੀਓ ਇਨਪੁੱਟ/ਆਉਟਪੁੱਟ ਨਹੀਂ

ਲੱਛਣ: ਮਾਈਕ੍ਰੋਫੋਨ ਰਿਕਾਰਡ ਨਹੀਂ ਕਰ ਰਿਹਾ, ਸਪੀਕਰ ਆਵਾਜ਼ ਨਹੀੰ ਬਜਾ ਰਿਹਾ

ਹੱਲ:

ਕਨੈਕਸ਼ਨ ਚੈੱਕ ਕਰੋ: ਆਡੀਓ ਡਿਵਾਈਸ ਠੀਕ ਜੁੜੇ ਹੋਏ ਹਨ ਜਾਂ ਨਹੀਂ ਜਾਂਚੋ
ਹਾਰਡਵੇਅਰ ਟੈਸਟ ਕਰੋ:
- ਸਪੀਕਰ: speaker-test -t wav -c 2
- ਮਾਈਕ੍ਰੋਫੋਨ: arecord -l ਗਿਆਨਸੂਚੀ ਕਰਨ ਲਈ, arecord test.wav ਰਿਕਾਰਡ ਕਰਨ ਲਈ
ਵਾਲੀਅਮ ਸੈਟਿੰਗਜ਼: ਵਾਲੀਅਮ ਜਾਂਚੋ ਅਤੇ ਸੰਸੋਧਨ ਕਰੋ:
```
alsamixer
```
ਆਡੀਓ ਡਿਵਾਈਸ ਚੁਣੋ: ਕੋਡ ਵਿੱਚ ਸਹੀ ਆਡੀਓ ਡਿਵਾਈਸ ਦਰਜ ਕਰੋ
ਡ੍ਰਾਇਵਰ ਸਮੱਸਿਆਵਾਂ: ALSA ਅਪਡੇਟ ਕਰੋ ਜਾਂ ਆਡੀਓ ਡ੍ਰਾਇਵਰ ਮੁੜ ਇੰਸਟਾਲ ਕਰੋ

ਸਮੱਸਿਆ: ReSpeaker ਹੈਟ ਕੰਮ ਨਹੀਂ ਕਰ ਰਿਹਾ

ਲੱਛਣ: ਆਡੀਓ ਡਿਵਾਈਸ ਪਹਿਚਾਣੀ ਨਹੀਂ ਜਾ ਰਹੀ

ਹੱਲ:

ਡ੍ਰਾਇਵਰ ਇੰਸਟਾਲ ਕਰੋ:

git clone https://github.com/HinTak/seeed-voicecard
cd seeed-voicecard
sudo ./install.sh
sudo reboot

ਇੰਸਟਾਲੇਸ਼ਨ ਦੀ ਜਾਂਚ ਕਰੋ: arecord -l ਵਿੱਚ ReSpeaker ਦਿੱਖਣਾ ਚਾਹੀਦਾ ਹੈ
Firmware ਅਪਡੇਟ ਕਰੋ: ਕੁਝ ਪਾਈ OS ਵਰਜ਼ਨ ਨੂੰ ਡਰਾਇਵਰ ਅਪਡੇਟ ਦੀ ਲੋੜ ਹੁੰਦੀ ਹੈ
ਹੈਟ ਦੀ ਬੈਠਕ ਚੈੱਕ ਕਰੋ: ਯਕੀਨੀ ਬਣਾਓ ਕਿ ਹੈਟ GPIO ਪਿੰਸਨ ਨਾਲ ਠੀਕ ਤਰ੍ਹਾਂ ਜੁੜੀ ਹੈ

ਵਿਕਾਸ ਮਾਹੌਲ ਸਮੱਸਿਆਵਾਂ

VS ਕੋਡ

ਸਮੱਸਿਆ: ਟਰਮੀਨਲ ਆਪਮੈਟਿਕ ਤੌਰ ਤੇ ਵਰਚੁਅਲ මහੌਲ ਐਕਟੀਵੇਟ ਨਹੀਂ ਕਰ ਰਿਹਾ

ਲੱਛਣ: ਟਰਮੀਨਲ ਖੁਲਦਾ ਹੈ ਪਰ ਵੈਨਵ ਐਕਟੀਵੇਟ ਨਹੀਂ ਹੁੰਦਾ

ਹੱਲ:

ਪਾਇਥਨ ਇੰਟਰਪ੍ਰੀਟਰ ਸੈੱਟ ਕਰੋ: Command Palette → "Python: Select Interpreter" → ਵੈਨਵ ਚੁਣੋ
VS ਕੋਡ ਨੂੰ ਰੀਸਟਾਰਟ ਕਰੋ ਇੰਟਰਪ੍ਰੀਟਰ ਚੁਣਣ ਦੇ ਬਾਅਦ
ਸੈਟਿੰਗਜ਼ ਚੈੱਕ ਕਰੋ: settings.json ਵਿੱਚ ਸ਼ਾਮਿਲ ਕਰੋ:
```
"python.terminal.activateEnvironment": true
```

ਸਮੱਸਿਆ: ਕੋਡ ਡਿਵਾਈਸ ਤੇ ਨਹੀਂ ਚੱਲ ਰਿਹਾ

ਲੱਛਣ: ਕੋਡ ਚੱਲਦਾ ਹੈ ਪਰ ਡਿਵਾਈਸ ਤੇ ਕੁਝ ਨਹੀਂ ਹੁੰਦਾ

ਹੱਲ:

ਕੋਡ ਸੇਵ ਹੈ ਜਾਂ ਨਹੀਂ ਜਾਂਚੋ (ਫਾਇਲ ਟੈਬ 'ਤੇ ਡਾਟ ਦੇਖੋ)
ਕੋਨਸਾ ਪਾਇਥਨ ਚੱਲ ਰਿਹਾ ਹੈ ਜਾਂਚੋ: which python ਜਾਂ where python
Wio Terminal ਲਈ: ਕੋਡ ਨੂੰ PlatformIO ਨਾਲ ਅਪਲੋਡ ਕਰੋ (ਅਪਲੋਡ ਬਟਨ ਕਲਿੱਕ ਕਰੋ)
Raspberry Pi ਲਈ: Pi ਵਿੱਚ SSH ਕਰਕੇ ਕੋਡ ਚਲਾੋ
ਆਉਟਪੁੱਟ ਵਿੰਡੋ ਨੂੰ ਚੈੱਕ ਕਰੋ ਗਲਤੀਆਂ ਲਈ

ਸਮੱਸਿਆ: IntelliSense ਲਾਇਬ੍ਰੇਰੀ ਫੰਕਸ਼ਨ ਨਹੀਂ ਦਿਖਾ ਰਿਹਾ

ਲੱਛਣ: ਇੰਪੋਰਟ ਕੀਤੇ ਮਾਡਿਊਲਾਂ ਲਈ ਆਟੋਕੰਪਲੀਟ ਨਹੀਂ

ਹੱਲ:

ਯਕੀਨੀ ਬਣਾਓ ਕਿ ਲਾਇਬ੍ਰੇਰੀ ਮੌਜੂਦਾ ਵਾਤਾਵਰਣ ਵਿੱਚ ਇੰਸਟਾਲ ਕੀਤੀ ਗਈ ਹੈ
VS ਕੋਡ ਵਿੰਡੋ ਨੂੰ ਰੀਲੋਡ ਕਰੋ
ਪਾਇਥਨ ਇੰਟਰਪ੍ਰੀਟਰ ਸਹੀ ਹੈ ਜਾਂ ਨਹੀਂ ਜਾਂਚੋ
ਜੇ ਉਪਲਬਧ ਹੋਵੇ ਤਾਂ ਟਾਈਪ ਸਟੱਬਸ ਇੰਸਟਾਲ ਕਰੋ: pip install types-<library-name>

ਪਾਇਥਨ ਵਰਚੁਅਲ ਵਾਤਾਵਰਣ

ਸਮੱਸਿਆ: ਵਰਚੁਅਲ ਮਾਹੌਲ ਬਣਾਉਣ ਵਿੱਚ ਅਸਫਲ

ਗਲਤੀ: The virtual environment was not created successfully

ਹੱਲ:

venv ਮਾਡਿਊਲ ਇੰਸਟਾਲ ਕਰੋ:
- Ubuntu/Debian: sudo apt install python3-venv
- macOS: Python ਨਾਲ ਸ਼ਾਮਿਲ ਹੁੰਦਾ ਹੈ
- Windows: ਸਾਰੇ ਕੰਪੋਨੇਟਸ ਨਾਲ ਪਾਇਥਨ ਮੁੜ ਇੰਸਟਾਲ ਕਰੋ
ਪਾਇਥਨ ਇੰਸਟਾਲੇਸ਼ਨ ਚੈੱਕ ਕਰੋ: ਪਾਇਥਨ ਠੀਕ ਤਰ੍ਹਾਂ ਇੰਸਟਾਲ ਹੈ ਜਾਂ ਨਹੀਂ
ਪੂਰਾ ਪਾਥ ਵਰਤੋਂ: python3 -m venv .venv ਵਰਤ ਕੇ

ਸਮੱਸਿਆ: ਪੈਕੇਜ ਗਲਤ ਥਾਂ ਤੇ ਇੰਸਟਾਲ ਹੋਏ

ਲੱਛਣ: ਪੈਕਜ ਇੰਸਟਾਲ ਕਰਨ ਤੋਂ ਬਾਅਦ ਇੰਪੋਰਟ ਗਲਤੀ

ਹੱਲ:

venv ਐਕਟੀਵੇਟ ਹੈ ਜਾਂ ਨਹੀਂ ਚੈੱਕ ਕਰੋ: ਕਮਾਂਡ ਪ੍ਰਾਂਪਟ (.venv) ਦਿਖਾਏ
pip ਦੀ ਥਾਂ ਚੈੱਕ ਕਰੋ: which pip .venv/bin/pip ਵੱਲ ਹੋਣਾ ਚਾਹੀਦਾ ਹੈ
ਵੈਨਵ ਵਿਚ ਮੁੜ ਇੰਸਟਾਲ ਕਰੋ: ਵੈਨਵ ਐਕਟੀਵੇਟ ਕਰੋ ਅਤੇ ਫਿਰ pip install <package>
ਵੈਨਵ ਵਿੱਚ sudo ਦੇ ਨਾਲ pip ਦਾ ਇਸਤੇਮਾਲ ਨਾ ਕਰੋ

ਸਮੱਸਿਆ: ਵਰਚੁਅਲ ਵਾਤਾਵਰਣ ਪੋਰਟੇਬਲ ਨਹੀਂ ਹੈ

ਲੱਛਣ: ਵੈਨਵ ਹਿਲਦੇ ਜਾਂ ਵੱਖਰੇ ਕੰਪਿਊਟਰ ‘ਤੇ ਕੰਮ ਨਹੀਂ ਕਰਦਾ

ਹੱਲ:

ਵੈਨਵ ਨੂੰ ਨਹੀਂ ਹਿਲਾਓ: ਹਟਾ ਕੇ ਨਵੀਂ ਥਾਂ ਬਣਾਓ

requirements.txt ਵਰਤੋ:

pip freeze > requirements.txt
pip install -r requirements.txt

ਵੈਨਵ ਮੁੜ ਬਣਾਓ:

python3 -m venv .venv
source .venv/bin/activate  # ਜਾਂ Windows 'ਤੇ activate.bat
pip install -r requirements.txt

ਡੀਪੈਂਡੈਂਸੀਜ਼

ਸਮੱਸਿਆ: ਪੈਕੇਜ ਇੰਸਟਾਲੇਸ਼ਨ ਫੇਲ

ਗਲਤੀ: ਇੰਸਟਾਲੇਸ਼ਨ ਦੌਰਾਨ ਵੱਖ-ਵੱਖ pip ਗਲਤੀਆਂ

ਹੱਲ:

pip ਅਪਡੇਟ ਕਰੋ:
```
pip install --upgrade pip
```
ਬਿਲਡ ਟੂਲਜ਼ ਇੰਸਟਾਲ ਕਰੋ:
- Ubuntu/Debian: sudo apt install build-essential python3-dev
- macOS: xcode-select --install
- Windows: Visual Studio Build Tools ਇੰਸਟਾਲ ਕਰੋ
ਇੰਟਰਨੈੱਟ ਕਨੈਕਸ਼ਨ ਚੈੱਕ ਕਰੋ
ਵੱਖਰਾ ਪੈਕੇਜ ਇੰਡੈਕਸ ਕੋਸ਼ਿਸ਼ ਕਰੋ: pip install --index-url https://pypi.org/simple/ <package>
ਵਿਸ਼ੇਸ਼ ਵਰਜ਼ਨ ਇੰਸਟਾਲ ਕਰੋ: pip install <package>==<version>

ਸਮੱਸਿਆ: ਡੀਪੈਂਡੈਂਸੀ ਸੰਘਰਸ਼

ਗਲਤੀ: ERROR: pip's dependency resolver does not currently take into account all the packages that are installed

ਹੱਲ:

ਹਰ ਪ੍ਰਾਜੈਕਟ ਲਈ ਨਵੀਆਂ ਵਰਚੁਅਲ ਐਨਵਾਇਰਨਮੈਂਟ ਵਰਤੋਂ
ਪੈਕੇਜ ਅਪਡੇਟ ਕਰੋ: pip install --upgrade <package>
ਡਿਪੈਂਡੈਂਸੀ ਸੰਘਰਸ਼ ਲਈ ਜਾਂਚ ਕਰੋ: pip check
ਮਿਲਦੀਆਂ ਵਰਜ਼ਨ ਇੰਸਟਾਲ ਕਰੋ: requirements.txt ਵਿੱਚ ਵਰਜ਼ਨ ਰੇਂਜ ਦਿਓ

ਕਾਰਗੁਜ਼ਾਰੀ ਸਮੱਸਿਆਵਾਂ

ਸਮੱਸਿਆ: ਕੋਡ ਹੌਲੀ ਚੱਲਦਾ ਹੈ

ਲੱਛਣ: ਦੇਰੀ, ਟਾਈਮਆਉਟ, ਬੇਹੋਸ਼ੀ

ਹੱਲ:

ਸੈਂਸਰ ਪੜ੍ਹਾਈ ਫ੍ਰੀਕਵੇਂਸੀ ਘਟਾਓ: ਬਹੁਤ ਜ਼ਿਆਦਾ ਪੜ੍ਹਾਈ ਨਾ ਕਰੋ
ਲੂਪਾਂ ਡਿੱਠੀ ਕਰੋ: ਬਿਜੀ-ਵੇਟਿੰਗ ਤੋਂ ਬਚੋ, sleep() ਜਾਂ ਡਿੱਲੇ ਵਰਤੋਂ
ਮੈਮੋਰੀ ਸਮੱਸਿਆਵਾਂ:
- ਲੋੜ ਨਹੀਂ ਐਪਸ ਬੰਦ ਕਰੋ
- ਸਟੋਰੇਜ ਖਾਲੀ ਕਰੋ
- Pi ‘ਤੇ top ਜਾਂ htop ਨਾਲ ਨਿਗਰਾਨੀ ਕਰੋ
SD ਕਾਰਡ ਦੀ ਗਤੀ: ਤੇਜ਼ SD ਕਾਰਡ ਜਾਂ SSD ਵਰਤੋਂ Raspberry Pi ਲਈ
ਨੈਟਵਰਕ ਦੇਰੀ: ਨੈਟਵਰਕ ਕਾਲਾਂ ਲਈ ਐਸਿੰਕ ਆਪਰੇਸ਼ਨ ਵਰਤੋਂ

ਸਮੱਸਿਆ: ਮੈਮੋਰੀ ਭਰ ਗਈ ਗਲਤੀਆਂ

ਗਲਤੀ: MemoryError ਜਾਂ ਸਿਸਟਮ ਫ੍ਰੀਜ਼

ਹੱਲ:

Raspberry Pi ਲਈ:
- ਲੋੜਵੰ ਜ ਐਪਲੀਕੇਸ਼ਨ ਬੰਦ ਕਰੋ
- ਸਵੈਪ ਸਪੇਸ ਵਧਾਓ
- ਹਲਕਾ OS ਵਰਤੋਂ (Lite ਵਰਜ਼ਨ)
- ਰੈਮ ਅਪਗਰੇਡ ਕਰੋ (Pi 4 ਚ 2/4/8GB ਚੋਣ)
Wio Terminal ਲਈ:
- ਬਫਰ ਆਕਾਰ ਘਟਾਓ
- ਛੋਟੀਆਂ ਤਸਵੀਰਾਂ ਵਰਤੋਂ
- ਸਤਰਾਂ ਦੀ ਵਰਤੋਂ ਸਧਾਰੋ
- ਮੈਮੋਰੀ ਲੀਕ ਜਾਂਚੋ (ਅਨਰਿਲੀਜ਼ਡ ਮੈਮੋਰੀ)

ਸਮੱਸਿਆ: ਡਾਟਾ ਖੋਣਾ ਜਾਂ ਖਰਾਬ ਹੋਣਾ

ਲੱਛਣ: ਸੁਨੇਹੇ ਗਾਇਬ, ਫਾਇਲ ਖਰਾਬ

ਹੱਲ:

SD ਕਾਰਡ ਸਮੱਸਿਆਵਾਂ:
- ਵਧੀਆ SD ਕਾਰਡ ਵਰਤੋਂ (ਸਸਤੇ ਜਾਂ ਨਕਲੀ ਤੋਂ ਬਚੋ)
- ਨਿਯਮਤ ਬੈਕਅੱਪ ਕਰੋ
- ਸੇਟਿੰਗਬੰਦ ਸ਼ਟਡਾਊਨ (ਪਾਵਰ ਨਾ ਖਿੱਚੋ)
ਬਫਰ ਓਵਰਫਲੋ: ਕੋਡ ਵਿੱਚ ਬਫਰ ਆਕਾਰ ਵਧਾਓ
ਨੈਟਵਰਕ ਭਰੋਸੇਯੋਗਤਾ: ਮੁੜ ਕੋਸ਼ਿਸ਼ ਲਈ ਲੋਜਿਕ ਅਤੇ ਗਲਤੀ ਸੰਭਾਲ ਬਣਾੋ
ਸੇਵਾ ਦੀ ਕਵਾਲਟੀ: ਜਰੂਰੀ ਸੁਨੇਹਿਆਂ ਲਈ MQTT QoS 1 ਜਾਂ 2 ਵਰਤੋਂ

ਆਮ ਗਲਤੀ ਸੁਨੇਹੇ

`ModuleNotFoundError: No module named 'X'`

ਕਾਰਨ: ਪੈਕੇਜ ਇੰਸਟਾਲ ਨਹੀਂ ਹੈ ਜਾਂ ਵੈਨਵ ਐਕਟੀਵੇਟ ਨਹੀਂ ਹੈ

ਹੱਲ:

pip install X

ਵੈਨਵ ਪਹਿਲਾਂ ਐਕਟੀਵੇਟ ਹੈ ਜਾਂ ਨਹੀਂ ਯਕੀਨੀ ਬਣਾਓ।

`Permission denied` Linux/macOS ‘ਤੇ

ਕਾਰਨ: ਉੱਚ ਅਧਿਕਾਰ ਜਾਂ ਫਾਇਲ ਪਰਮਿਸ਼ਨ ਸਮੱਸਿਆ

ਹੱਲ:

ਸਿਸਟਮ ਕਾਰਜ ਲਈ: sudo ਵਰਤੋਂ
pip ਲਈ: ਵੈਨਵ ਐਕਟੀਵੇਟ ਕਰਕੇ sudo ਨਾ ਵਰਤੋਂ
ਸਿਰੀਅਲ ਪੋਰਟ ਲਈ: ਯੂਜ਼ਰ ਨੂੰ dialout ਗਰੁੱਪ ਵਿੱਚ ਸ਼ਾਮਿਲ ਕਰੋ: sudo usermod -a -G dialout $USER, ਫਿਰ ਲੋਗਆਊਟ/ਲੋਗਇਨ

`OSError: [Errno 98] Address already in use`

ਕਾਰਨ: ਪੋਰਟ ਕਿਸੇ ਹੋਰ ਪ੍ਰਕਿਰਿਆ ਵੱਲੋਂ ਵਰਤਿਆ ਜਾ ਰਿਹਾ ਹੈ

ਹੱਲ:

ਕਿਸ ਪ੍ਰਕਿਰਿਆ ਪੋਰਟ ਵਰਤ ਰਹੀ ਹੈ ਉਹ ਲੱਭੋ: lsof -i :<port> ਜਾਂ netstat -ano | findstr :<port>
ਪ੍ਰਕਿਰਿਆ ਨੂੰ ਮਾਰੋ ਜਾਂ ਆਪਣੀ ਕੋਡ ਵਿੱਚ ਵੱਖਰਾ ਪੋਰਟ ਵਰਤੋਂ

`SSL: CERTIFICATE_VERIFY_FAILED`

ਕਾਰਨ: SSL ਸਰਟੀਫਿਕੇਟ ਪਰਖ ਅਸਫਲ

ਹੱਲ:

ਸਰਟੀਫਿਕੇਟ ਅਪਡੇਟ ਕਰੋ: pip install --upgrade certifi
ਸਿਸਟਮ ਸਮਾਂ ਸਹੀ ਹੈ ਜਾਂ ਨਹੀਂ ਜਾਂਚੋ: date
ਵਿਅਕਾਸ ਲਈ ਹੀ (ਉਤਪਾਦਨ ਲਈ ਨਹੀਂ): ਕੋਡ ਵਿੱਚ ਪਰਖ ਅਣਇਨੇਬਲ ਕਰੋ

`IndentationError: unexpected indent`

ਕਾਰਨ: ਪਾਇਥਨ ਇੰਡੇਨਟੇਸ਼ਨ ਗਲਤੀਆਂ (ਟੈਬ/ਸਪੇਸ ਮਿਲਾਓਣਾ)

ਹੱਲ:

ਇੱਕਸਾਰ ਇੰਡੇਨਟੇਸ਼ਨ ਵਰਤੋਂ (4 ਸਪੇਸ ਪਾਇਥਨ ਮਿਆਰੀ)
ਐਡੀਟਰ ਨੂੰ ਟੈਬ ਦੀ ਥਾਂ ਸਪੇਸ ਵਰਤਣ ਲਈ ਸੈਟ ਕਰੋ
VS ਕੋਡ ਵਿੱਚ "editor.insertSpaces": true ਅਤੇ "editor.tabSize": 4 ਦਿਓ

`UnicodeDecodeError` ਜਾਂ `UnicodeEncodeError`

ਕਾਰਨ: ਕੈਰੈਕਟਰ ਇੰਕੋਡਿੰਗ ਸਮੱਸਿਆ

ਹੱਲ:

# ਜਦੋਂ ਫਾਇਲਾਂ ਪੜ੍ਹ ਰਹੇ ਹੋਵੋ
with open('file.txt', 'r', encoding='utf-8') as f:
    content = f.read()

# ਜਦੋਂ ਫਾਇਲਾਂ ਲਿਖ ਰਹੇ ਹੋਵੋ
with open('file.txt', 'w', encoding='utf-8') as f:
    f.write(content)

ਮਦਦ ਲੈਣਾ

ਜੇ ਤੁਸੀਂ ਇਹ ਟ੍ਰਬਲਸ਼ੂਟਿੰਗ ਕਦਮ ਅਜ਼ਮਾਏ ਹਨ ਪਰ ਅਜੇ ਵੀ ਸਮੱਸਿਆ ਹੈ:

1. ਮੌਜੂਦਾ ਸਰੋਤ ਜਾਂਚੋ

ਦਸਤਾਵੇਜ਼: README ਅਤੇ ਲੈਸਨ ਨਿਰਦੇਸ਼ ਪੜ੍ਹੋ
ਹਾਰਡਵੇਅਰ ਗਾਇਡਜ਼: hardware.md ਵਿੱਚ ਹਾਰਡਵੇਅਰ-ਵਿਸ਼ੇਸ਼ ਜਾਣਕਾਰੀ ਵੇਖੋ
Seeed Studio Wiki: Grove ਕੰਪੋਨੈਂਟ ਲਈ Seeed Studio Wiki ਵੇਖੋ

2. ਮਿਲਦੀਆਂ ਸਮੱਸਿਆਵਾਂ ਖੋਜੋ

GitHub Issues: ਮੌਜੂਦਾ ਸਮੱਸਿਆਵਾਂ ਖੋਜੋ
Stack Overflow: ਗਲਤੀ ਸੁਨੇਹੇ ਖੋਜੋ
ਡਿਵਾਈਸ ਫੋਰਮ: Raspberry Pi ਜਾਂ Arduino ਫੋਰਮ ਚੈੱਕ ਕਰੋ

3. GitHub ਇਸ਼ੂ ਬਣਾਓ

ਜੇ ਹੱਲ ਨਾ ਮਿਲੇ:

GitHub Issues 'ਤੇ ਜਾਓ
"New Issue" 'ਤੇ ਕਲਿੱਕ ਕਰੋ
ਦਿੱਤੀਆਂ ਜਾਣਕਾਰੀਆਂ ਦਿਓ:
- ਸਮੱਸਿਆ ਦਾ ਸਪਸ਼ਟ ਵੇਰਵਾ
- ਦੁਹਰਾਉਣ ਵਾਲੇ ਕਦਮ
- ਗਲਤੀ ਸੁਨੇਹੇ (ਪੂਰਾ ਟੈਕਸਟ)
- ਹਾਰਡਵੇਅਰ/ਸਾਫਟਵੇਅਰ ਵਰਜ਼ਨ
- ਜੋ ਤੁਸੀਂ ਪਹਿਲਾਂ ਕੋਸ਼ਿਸ਼ ਕੀਤਾ
- ਜੇ ਲੋੜ ਹੋਵੇ ਤਾਂ ਸਕ੍ਰੀਨਸ਼ਾਟ

4. ਕਮਿਊਨਿਟੀ ਨਾਲ ਜੁੜੋ

Discord: Microsoft Foundry Discord
Microsoft Learn: Microsoft Learn IoT

5. ਚੰਗੇ ਬੱਗ ਰਿਪੋਰਟ ਪ੍ਰਦਾਨ ਕਰੋ

ਇੱਕ ਚੰਗਾ ਬੱਗ ਰਿਪੋਰਟ ਸ਼ਾਮਿਲ ਹੁੰਦਾ ਹੈ:

ਵਾਤਾਵਰਣ: ਓਐਸ, ਪਾਇਥਨ ਵਰਜਨ, ਵਰਤੇ ਗਏ ਹਾਰਡਵੇਅਰ
ਮਸਲੇ ਨੂੰ ਦੁਹਰਾਉਣ ਦੇ ਕਦਮ: ਉਹ ਸਹੀ ਕਦਮ ਜੋ ਮੁੱਦਾ ਪੈਦਾ ਕਰਦੇ ਹਨ
ਉਮੀਦ ਕੀਤੀ ਗਈ ਵਰਤੋਂ: ਕੀ ਹੋਣਾ ਚਾਹੀਦਾ ਹੈ
ਅਸਲ ਵਰਤੋਂ: ਅਸਲ ਵਿੱਚ ਕੀ ਹੁੰਦਾ ਹੈ
ਗਲਤੀ ਸੁਨੇਹੇ: ਪੂਰਾ ਗਲਤੀ ਟੈਕਸਟ, ਸਕਰੀਨਸ਼ਾਟ ਨਹੀਂ
ਕੋਡ: ਘੱਟੋ ਘੱਟ ਕੋਡ ਉਦਾਹਰਨ ਜੋ ਮੁੱਦਾ ਦੁਹਰਾਉਂਦੀ ਹੈ

ਰੋਕਥਾਮ ਲਈ ਸੁਝਾਵ

ਆਮ ਸਧਾਰਣ ਅਮਲ

ਬੈਕਅੱਪ ਸੁਰੱਖਿਅਤ ਕਰੋ: ਕੰਮ ਕਰਨ ਵਾਲੇ SD ਕਾਰਡ/ਕੋਡ ਬੈਕਅੱਪ ਪੱਕਾ ਕਰੋ
ਬਦਲਾਵ ਦਸਤਾਵੇਜ਼ੀਕਰਨ: ਟਿੱਪਣੀਆਂ ਵਿੱਚ ਕੀ ਕੰਮ ਕਰਦਾ ਹੈ ਦਰਜ ਕਰੋ
ਵਰਜਨ ਕੰਟਰੋਲ: ਕੋਡ ਬਦਲਾਵ ਲਈ git ਵਰਤੋਂ
ਛੋਟੇ ਬਦਲਾਵਾਂ ਦੀ ਜਾਂਚ ਕਰੋ: ਮਿਲਾਉਣ ਤੋਂ ਪਹਿਲਾਂ ਛੋਟੇ ਬਦਲਾਵਾਂ ਦੀ ਜਾਂਚ ਕਰੋ
ਗਲਤੀ ਸੁਨੇਹੇ ਪੜ੍ਹੋ: ਇਹ ਆਮ ਤੌਰ 'ਤੇ ਦੱਸਦੇ ਹਨ ਕਿ ਸਹੀ ਸਮੱਸਿਆ ਕੀ ਹੈ
ਨਿਯਮਤ ਅਪਡੇਟ ਕਰੋ: ਸੌਫਟਵੇਅਰ/ਫਿਰਮਵੇਅਰ ਨੂੰ ਹਮੇਸ਼ਾ ਅਪਡੇਟ ਰੱਖੋ
ਗੁਣਵੱਤਾ ਵਾਲੇ ਹਿੱਸੇ ਵਰਤੋਂ: ਸਸਤੇ ਕੇਬਲ/ਬਿਜਲੀ ਸਪਲਾਈ ਤੋਂ ਬਚੋ
ਸਥਿਰ ਬਿਜਲੀ ਸਪਲਾਈ: ਉਚਿਤ ਬਿਜਲੀ ਸਪਲਾਈ ਵਰਤੋਂ (ਖਾਸ ਤੌਰ ਤੇ ਪਾਈ ਲਈ)

ਵਿਕਾਸ ਕੰਮਕਾਜ

ਸਰਲ ਸ਼ੁਰੂਆਤ ਕਰੋ: ਕੰਮ ਕਰਨ ਵਾਲੇ ਉਦਾਹਰਨ ਕੋਡ ਤੋਂ ਸ਼ੁਰੂ ਕਰੋ
ਇੱਕ ਵਾਰੀ ਇੱਕ ਤਬਦੀਲੀ: ਇਸ ਨਾਲ ਟੁੱਟਣ ਵਾਲੀ ਗਲਤੀ ਮਿਲਣਾ ਆਸਾਨ ਹੁੰਦਾ ਹੈ
ਅਕਸਰ ਜਾਂਚ ਕਰੋ: ਮੁੱਦਿਆਂ ਨੂੰ ਜਲਦੀ ਫੜੋ
ਸਾਫ਼ ਸਾਫ਼ ਰੱਖੋ: ਫਾਇਲਾਂ ਅਤੇ ਕੋਡ ਨੂੰ ਤਰਤੀਬਬੱਧ ਰੱਖੋ
ਕੋਡ 'ਤੇ ਟਿੱਪਣੀ ਕਰੋ: ਭਵਿੱਖ ਵਿਚ ਤੁਸੀਂ ਇਸ ਦੀ ਕਦਰ ਕਰੋਗੇ

ਇਹ ਸਮੱਸਿਆ ਸੁਲਝਾਉਣ ਵਾਲਾ ਮਾਰਗਦਰਸ਼ਕ ਕਮਿਊਨਿਟੀ ਵਲੋਂ ਸੰਭਾਲਿਆ ਜਾਂਦਾ ਹੈ। ਜੇ ਤੁਸੀਂ ਇੱਥੇ ਦਰਜ ਨਾ ਹੋਏ ਸਮੱਸਿਆ ਲਈ ਕੋਈ ਹੱਲ ਲੱਭਦੇ ਹੋ, ਤਾਂ ਕਿਰਪਾ ਕਰਕੇ ਹੋਰਾਂ ਦੀ ਮਦਦ ਲਈ ਯੋਗਦਾਨ ਪਾਉਣਾ ਬਾਰੇ ਸੋਚੋ!

ਅਸਪਸ਼ਟੀਕਰਨ:
ਇਸ ਦਸਤਾਵੇਜ਼ ਦਾ ਅਨੁਵਾਦ AI ਅਨੁਵਾਦ ਸੇਵਾ Co-op Translator ਦੀ ਵਰਤੋਂ ਕਰਕੇ ਕੀਤਾ ਗਿਆ ਹੈ। ਜਦੋਂ ਕਿ ਅਸੀਂ ਸਹੀਅਤ ਲਈ ਯਤਨ ਕਰਦੇ ਹਾਂ, ਕਿਰਪਾ ਕਰਕੇ ਇਹ ਜਾਣੋ ਕਿ ਸੁਚਾਲਿਤ ਅਨੁਵਾਦਾਂ ਵਿੱਚ ਗਲਤੀਆਂ ਜਾਂ ਅਸਮਰਥਾਵਾਂ ਹੋ ਸਕਦੀਆਂ ਹਨ। ਮੂਲ ਦਸਤਾਵੇਜ਼ ਆਪਣੀ ਮੂਲ ਭਾਸ਼ਾ ਵਿੱਚ ਪ੍ਰਮਾਣਿਕ ਸਰੋਤ ਵਜੋਂ ਮੰਨਿਆ ਜਾਣਾ ਚਾਹੀਦਾ ਹੈ। ਮਹੱਤਵਪੂਰਨ ਜਾਣਕਾਰੀ ਲਈ, ਪ੍ਰੋਫੈਸ਼ਨਲ ਮਨੁੱਖੀ ਅਨੁਵਾਦ ਦੀ ਸਿਫਾਰਸ਼ ਕੀਤੀ ਜਾਂਦੀ ਹੈ। ਅਸੀਂ ਇਸ ਅਨੁਵਾਦ ਦੀ ਵਰਤੋਂ ਕਾਰਨ ਉਤਪੰਨ ਕਿਸੇ ਵੀ ਗਲਤਫਹਮੀ ਜਾਂ ਗਲਤ ਸਮਝ ਦੀ ਜ਼ਿੰਮੇਵਾਰੀ ਨਹੀਂ ਲੈਂਦੇ।

39 KiB Raw Permalink Blame History

Troubleshooting Guide

Table of Contents

Installation Issues

Python Installation

Problem: Python version is too old

Problem: Multiple Python versions causing conflicts

Problem: pip command not found

VS Code and Extensions

Problem: Pylance extension not working

Problem: VS Code not detecting virtual environment

PlatformIO (Wio Terminal)

Problem: PlatformIO installation fails

Problem: Board not detected by PlatformIO

Problem: Compilation errors in PlatformIO

Grove Libraries

Problem: Grove library import fails on Raspberry Pi

Problem: Grove sensor not detected

Hardware Issues

Raspberry Pi

Problem: Raspberry Pi won't boot

Problem: Cannot SSH to Raspberry Pi

Problem: Grove Base Hat not recognized

Problem: Raspberry Pi running slow

Wio Terminal

Problem: Wio Terminal screen stays blank

Problem: WiFi not working on Wio Terminal

Problem: Wio Terminal not recognized by computer

Problem: Sensors not working on Wio Terminal

Virtual Device (CounterFit)

Problem: CounterFit app won't start

Problem: Cannot connect to CounterFit from code

Problem: Sensors not appearing in CounterFit

Connectivity Issues

WiFi Connection

Problem: Device can't connect to WiFi

Problem: WiFi connection drops frequently

Cloud Services

Problem: Cannot connect to Azure IoT Hub

Problem: Azure Functions not triggering

MQTT

ਸਮੱਸਿਆ: MQTT ਕਨੈਕਸ਼ਨ ਫੇਲ

ਸਮੱਸਿਆ: MQTT ਸੁਨੇਹੇ ਪ੍ਰਾਪਤ ਨਹੀਂ ਹੋ ਰਹੇ

ਸੈਂਸਰ ਅਤੇ ਐਕਚੁਏਟਰ ਸਮੱਸਿਆਵਾਂ

Grove ਸੈਂਸਰ

ਸਮੱਸਿਆ: ਸੈਂਸਰ ਗਲਤ ਮੁੱਲ ਵਾਪਸ ਕਰਦਾ ਹੈ

ਸਮੱਸਿਆ: Capacitive soil moisture sensor ਹਮੇਸ਼ਾ ਗਿੱਲਾ ਪੜ੍ਹਦਾ ਹੈ

ਸਮੱਸਿਆ: ਤਾਪਮਾਨ/ਨਮੀ ਸੈਂਸਰ ਦੀ ਪੜ੍ਹਾਈ ਗਲਤ ਹੈ

ਕੈਮਰਾ

ਸਮੱਸਿਆ: Raspberry Pi ਤੇ ਕੈਮਰਾ ਨਹੀਂ ਪਹਿਚਾਣਿਆ ਗਿਆ

ਸਮੱਸਿਆ: ਕੈਮਰਾ ਕੀ ਵਿੱਤਰ ਕੁਆਲਿਟੀ ਖ਼ਰਾਬ ਹੈ

ਮਾਈਕ੍ਰੋਫੋਨ ਅਤੇ ਸਪੀਕਰ

ਸਮੱਸਿਆ: ਆਡੀਓ ਇਨਪੁੱਟ/ਆਉਟਪੁੱਟ ਨਹੀਂ

ਸਮੱਸਿਆ: ReSpeaker ਹੈਟ ਕੰਮ ਨਹੀਂ ਕਰ ਰਿਹਾ

ਵਿਕਾਸ ਮਾਹੌਲ ਸਮੱਸਿਆਵਾਂ

VS ਕੋਡ

ਸਮੱਸਿਆ: ਟਰਮੀਨਲ ਆਪਮੈਟਿਕ ਤੌਰ ਤੇ ਵਰਚੁਅਲ මහੌਲ ਐਕਟੀਵੇਟ ਨਹੀਂ ਕਰ ਰਿਹਾ

ਸਮੱਸਿਆ: ਕੋਡ ਡਿਵਾਈਸ ਤੇ ਨਹੀਂ ਚੱਲ ਰਿਹਾ

ਸਮੱਸਿਆ: IntelliSense ਲਾਇਬ੍ਰੇਰੀ ਫੰਕਸ਼ਨ ਨਹੀਂ ਦਿਖਾ ਰਿਹਾ

ਪਾਇਥਨ ਵਰਚੁਅਲ ਵਾਤਾਵਰਣ

ਸਮੱਸਿਆ: ਵਰਚੁਅਲ ਮਾਹੌਲ ਬਣਾਉਣ ਵਿੱਚ ਅਸਫਲ

ਸਮੱਸਿਆ: ਪੈਕੇਜ ਗਲਤ ਥਾਂ ਤੇ ਇੰਸਟਾਲ ਹੋਏ

ਸਮੱਸਿਆ: ਵਰਚੁਅਲ ਵਾਤਾਵਰਣ ਪੋਰਟੇਬਲ ਨਹੀਂ ਹੈ

ਡੀਪੈਂਡੈਂਸੀਜ਼

ਸਮੱਸਿਆ: ਪੈਕੇਜ ਇੰਸਟਾਲੇਸ਼ਨ ਫੇਲ

ਸਮੱਸਿਆ: ਡੀਪੈਂਡੈਂਸੀ ਸੰਘਰਸ਼

ਕਾਰਗੁਜ਼ਾਰੀ ਸਮੱਸਿਆਵਾਂ

ਸਮੱਸਿਆ: ਕੋਡ ਹੌਲੀ ਚੱਲਦਾ ਹੈ

ਸਮੱਸਿਆ: ਮੈਮੋਰੀ ਭਰ ਗਈ ਗਲਤੀਆਂ

ਸਮੱਸਿਆ: ਡਾਟਾ ਖੋਣਾ ਜਾਂ ਖਰਾਬ ਹੋਣਾ

ਆਮ ਗਲਤੀ ਸੁਨੇਹੇ

ModuleNotFoundError: No module named 'X'

Permission denied Linux/macOS ‘ਤੇ

OSError: [Errno 98] Address already in use

SSL: CERTIFICATE_VERIFY_FAILED

IndentationError: unexpected indent

UnicodeDecodeError ਜਾਂ UnicodeEncodeError

ਮਦਦ ਲੈਣਾ

1. ਮੌਜੂਦਾ ਸਰੋਤ ਜਾਂਚੋ

2. ਮਿਲਦੀਆਂ ਸਮੱਸਿਆਵਾਂ ਖੋਜੋ

39 KiB

Raw Permalink Blame History

`ModuleNotFoundError: No module named 'X'`

`Permission denied` Linux/macOS ‘ਤੇ

`OSError: [Errno 98] Address already in use`

`SSL: CERTIFICATE_VERIFY_FAILED`

`IndentationError: unexpected indent`

`UnicodeDecodeError` ਜਾਂ `UnicodeEncodeError`