IoT-For-Beginners/translations/lt/TROUBLESHOOTING.md

Trikčių šalinimo vadovas

Šis vadovas padės jums išspręsti dažniausias problemas dirbant su IoT for Beginners mokymosi medžiaga. Problemų kategorijos suskirstytos patogiam naršymui.

Turinys

• Įdiegimo problemos
  • Python įdiegimas
  • VS Code ir plėtiniai
  • PlatformIO (Wio Terminal)
  • Grove bibliotekos
• Techninės įrangos problemos
  • Raspberry Pi
  • Wio Terminal
  • Virtualus įrenginys (CounterFit)
• Ryšio problemos
  • WiFi ryšys
  • Debesų paslaugos
  • MQTT
• Jutiklių ir aktuatorių problemos
  • Grove jutikliai
  • Kamera
  • Mikrofonas ir garsiakalbis
• Kūrimo aplinkos problemos
  • VS Code
  • Python virtualios aplinkos
  • Priklausomybės
• Veikimo problemos
• Dažnos klaidų žinutės
• Pagalbos gavimas

---

Įdiegimo problemos

Python įdiegimas

Problema: Python versija per sena

Klaida: Reikalinga Python 3.6 arba naujesnė versija

Sprendimas:

1. Atsisiųskite naujausią Python 3 versiją iš python.org
2. Įdiegimo metu Windows sistemoje pažymėkite „Add Python to PATH“
3. Patikrinkite įdiegimą:

   python3 --version
   

Problema: kelios Python versijos kelia konfliktų

Simptomai: Paleidžiama netinkama Python versija, paketai įdiegiami netikroje vietoje

Sprendimas:

• Windows: naudokite py -3 vietoje python, kad aiškiai paleisti Python 3
• macOS/Linux: naudokite python3 vietoje python
• Visada kurkite ir naudokite virtualias aplinkas projektams

Problema: nėra pip komandos

Klaida: 'pip' nėra atpažinta kaip vidinė ar išorinė komanda

Sprendimas:

1. Pabandykite vietoje pip naudoti pip3
2. Arba naudokite python -m pip arba python3 -m pip
3. Įsitikinkite, kad Python yra pridėtas prie PATH (perkurdami Python ir pažymėdami parinktį)

VS Code ir plėtiniai

Problema: neveikia Pylance plėtinys

Simptomai: nėra Python IntelliSense, kodo užbaigimo ar tipų tikrinimo

Sprendimas:

1. Atidarykite VS Code komandų paletę (Ctrl+Shift+P arba Cmd+Shift+P)
2. Vykdykite „Python: Select Interpreter“
3. Pasirinkite tinkamą Python interpretatorių (virtualią aplinką, jei naudojate)
4. Perkraukite VS Code langą

Problema: VS Code nemato virtualios aplinkos

Simptomai: pasirinktas netinkamas Python interpretatorius

Sprendimas:

1. Įsitikinkite, kad terminale suaktyvinote virtualią aplinką
2. Atidarykite komandų paletę ir įvykdykite „Python: Select Interpreter“
3. Pasirinkite interpretatorių iš .venv aplanko
4. Patikrinkite, ar būsenos juostoje (apatinėje kairėje) rodoma tinkama Python versija

PlatformIO (Wio Terminal)

Problema: nepavyksta įdiegti PlatformIO

Klaida: įvairios klaidos įdiegimo metu

Sprendimas:

1. Įsitikinkite, kad VS Code yra atnaujintas
2. Pirmiausia įdiekite C/C++ plėtinį
3. Po PlatformIO diegimo perkraukite VS Code
4. Patikrinkite interneto ryšį (PlatformIO atsisiunčia didelius failus)

Problema: PlatformIO nemato plokštės

Simptomai: negalima įkelti kodo į Wio Terminal

Sprendimas:

1. Išbandykite kitą USB laidą (kai kurie laidai tik įkrovimui)
2. Patikrinkite Įrenginių tvarkytuvę (Windows) arba ls /dev/tty* (macOS/Linux)
3. Įdiekite arba atnaujinkite USB tvarkykles
4. Išbandykite kitą USB lizdą
5. Du kartus greitai perstumkite Wio Terminal įjungimo jungiklį, kad įeinant į bootloader režimą

Problema: PlatformIO kompiliavimo klaidos

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

Sprendimas:

1. Ištrinkite .pio aplanką projekte
2. Vykdykite „PlatformIO: Rebuild“ komandą per komandų paletę
3. Įsitikinkite, kad platformio.ini turi teisingą plokštės konfigūraciją:

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

Grove bibliotekos

Problema: Grove bibliotekos importas nepavyksta Raspberry Pi

Klaida: ModuleNotFoundError: No module named 'grove'

Sprendimas:

1. Perinstaliuokite Grove bibliotekas:

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

2. Jei naudojate virtualią aplinką, gali prireikti įdiegti globaliai arba nukopijuoti bibliotekas
3. Įsitikinkite, kad I2C įjungtas: sudo raspi-config nonint do_i2c 0

Problema: Grove jutiklis neaptinkamas

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

Sprendimas:

1. Patikrinkite fizinius ryšius (įsitikinkite, kad Grove laidas pilnai įkištas)
2. Įsitikinkite, kad jutiklis prijungtas prie teisingo prievado (analoginio, skaitmeninio, I2C, UART)
3. Vykdykite i2cdetect -y 1, kad pamatytumėte ar prietaisas rodomas I2C autobuse
4. Išbandykite kitą Grove laidą
5. Įsitikinkite, kad Grove Base Hat tinkamai sėdi ant Raspberry Pi GPIO jungčių

---

Techninės įrangos problemos

Raspberry Pi

Problema: Raspberry Pi neužsikrauna

Simptomai: nėra vaizdo, LED neveikia arba rodomas vaivorykštės ekranas

Sprendimas:

1. Patikrinkite maitinimą: naudokite oficialų 5V 3A USB-C maitinimo šaltinį Pi 4 modeliui
2. SD kortelės problemos:
   • Performatuokite SD kortelę ir iš naujo įdiekite Raspberry Pi OS
   • Išbandykite kitą SD kortelę (naudokite rekomenduojamas markes)
   • Įsitikinkite, kad SD kortelė tinkamai įstatyta
3. Patikrinkite HDMI ryšį: išbandykite abu HDMI lizdus Pi 4, naudokite lizdą arčiau maitinimo

Problema: negalima prisijungti prie Raspberry Pi per SSH

Simptomai: atmetimas arba laiko limitas

Sprendimas:

1. Įjunkite SSH:
   • Naudodami Raspberry Pi Imager, konfigūruokite SSH papildomuose nustatymuose
   • Arba sukurkite tuščią failą pavadinimu ssh (be plėtinio) įkrovos skaidinyje
2. Suraskite Pi IP adresą:
   • Patikrinkite maršrutizatoriaus prijungtų įrenginių sąrašą
   • Vykdykite ping raspberrypi.local (jei veikia mDNS)
   • Naudokite tinklo skaitymo įrankius, pvz., nmap arba Angry IP Scanner
3. Patikrinkite tinklą:
   • Įsitikinkite, kad Pi ir jūsų kompiuteris yra tame pačiame tinkle
   • Išbandykite laidinį ryšį vietoje WiFi
4. Patikrinkite vartotojo vardą ir slaptažodį (numatytasis: vartotojas pi, slaptažodis raspberry)

Problema: Grove Base Hat neatpažįstamas

Simptomai: jutikliai neveikia, I2C klaidos

Sprendimas:

1. Įsitikinkite, kad Base Hat tinkamai pritvirtintas prie visų GPIO kontaktų
2. Patikrinkite ar nėra sulenktų kontaktų ant Pi arba Base Hat
3. Įjunkite I2C sąsają:

   sudo raspi-config nonint do_i2c 0
   sudo reboot
   

4. Patikrinkite, ar I2C veikia: i2cdetect -y 1

Problema: Raspberry Pi veikia lėtai

Simptomai: sąsaja stringa, lėtas atsakas

Sprendimas:

1. Patikrinkite SD kortelės greitį (naudokite Class 10 ar greitesnę, arba SSD per USB)
2. Atlaisvinkite vietos diske: naudokite df -h, ištrinkite nereikalingus failus
3. Sumažinkite GPU atmintį per raspi-config, jei nenaudojate daug kameros/vaizdo
4. Uždarykite nereikalingas programas
5. Jei naudojate Pi 3 ar senesnį, apsvarstykite atnaujinimą į Pi 4 su didesne atmintimi

Wio Terminal

Problema: Wio Terminal ekranas lieka tuščias

Simptomai: nėra vaizdo po kodo įkėlimo

Sprendimas:

1. Patikrinkite, ar kodas inicijuoja ekraną (TFT_eSPI biblioteka)
2. Atnaujinkite Wio Terminal programinę įrangą iš Seeed Wiki
3. Pridėkite ekrano inicijavimo kodą:

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

4. Išbandykite pavyzdinį sketch'ą iš PlatformIO, kad patikrintumėte aparatūrą

Problema: Wio Terminal neveikia WiFi

Simptomai: negalima prisijungti prie WiFi, tinklo klaidos

Sprendimas:

1. Atnaujinkite WiFi programinę įrangą: vadovaukitės Wio Terminal WiFi programinės įrangos atnaujinimo gidu
2. Patikrinkite WiFi prisijungimo duomenis: įsitikinkite, kad SSID ir slaptažodis teisingi
3. WiFi dažnis: Wio Terminal palaiko tik 2.4GHz WiFi (ne 5GHz)
4. Signalio stiprumas: priartinkite prie maršrutizatoriaus
5. Maršrutizatoriaus nustatymai: kai kurios įmonių/WPA-Enterprise tinklai gali neveikti

Problema: Kompiuteris neaptinka Wio Terminal

Simptomai: USB įrenginio nemato

Sprendimas:

1. Išbandykite kitą USB laidą: naudokite duomenų kabelį, ne tik įkrovimui skirtą
2. Įjunkite bootloader režimą: greitai perstumkite maitinimo jungiklį žemyn du kartus
   • Mėlyna LED turėtų pulsoti, įrenginys matomas kaip „Arduino“ Įrenginių tvarkytuvėje
3. Įdiekite tvarkykles (Windows):
   • Atsisiųskite ir įdiekite Seeed USB tvarkyklę
4. Pabandykite kitą USB lizdą: venkite USB šakotuvų, naudokite tiesioginį ryšį
5. Atnaujinkite sistemos USB tvarkykles

Problema: Wio Terminal jutikliai neveikia

Simptomai: Grove jutikliai nepateikia duomenų

Sprendimas:

1. Patikrinkite Grove laido jungtis
2. Įsitikinkite, kad naudojate tinkamą Grove prievadą (kairį arba dešinį)
3. Įtraukite tinkamas jutiklio bibliotekas
4. Patikrinkite jutiklio maitinimo reikalavimus
5. Testuokite jutiklį su pavyzdiniu bibliotekos kodu

Virtualus įrenginys (CounterFit)

Problema: negalima paleisti CounterFit programėlės

Klaida: įvairios Python klaidos paleidimo metu

Sprendimas:

1. Įsitikinkite, kad virtuali aplinka suaktyvinta
2. Įdiekite arba perinstaliuokite CounterFit:

   pip install CounterFit
   

3. Patikrinkite, ar prievadas 5000 nėra jau naudojamas:
   • Windows: netstat -ano | findstr :5000
   • macOS/Linux: lsof -i :5000
4. Nutraukite procesą, naudojantį prievadą 5000 arba naudokite kitą prievadą:

   counterfit --port 5001
   

Problema: negalima prisijungti prie CounterFit iš kodo

Klaida: prisijungimas užblokuotas arba laiko limitas

Sprendimas:

1. Patikrinkite, ar CounterFit veikia: atidarykite naršyklę http://127.0.0.1:5000
2. Patikrinkite, ar kodo URL atitinka CounterFit adresą
3. Įsitikinkite, kad ugniasienė neužblokuoja ryšio
4. Pabandykite paleisti iš naujo tiek CounterFit programėlę, tiek savo kodą

Problema: sensoriai nepasirodo CounterFit

Simptomai: sukurti sensoriai nerodomi CounterFit sąsajoje

Sprendimas:

1. Sukurkite sensorius CounterFit vartotojo sąsajoje prieš paleidžiant kodą
2. Atnaujinkite naršyklės puslapį
3. Patikrinkite, ar sensoriaus tipas atitinka kodo lūkesčius
4. Išvalykite naršyklės talpyklą

---

Ryšio problemos

WiFi ryšys

Problema: įrenginys negali prisijungti prie WiFi

Simptomai: prisijungimo laiko limitas, autentifikacijos klaida

Sprendimas:

1. Patikrinkite SSID ir slaptažodį: įsitikinkite, kad prisijungimo duomenys teisingi
2. WiFi dažnis: dauguma IoT įrenginių palaiko tik 2.4GHz (ne 5GHz)
3. Maršrutizatoriaus nustatymai:
   • Jei įjungta, išjunkite AP izoliuotumą
   • Naudokite WPA2-PSK saugumą (venkite WPA3, WEP ar atvirų tinklų)
   • Įsitikinkite, kad DHCP įjungtas
4. Paslėpti tinklai: jei SSID paslėptas, gali reikėti jį aiškiai sukonfigūruoti
5. Signalo stiprumas: priartinkite įrenginį prie maršrutizatoriaus
6. Trukdžiai: kiti įrenginiai, mikrobangų krosnelės ar sienos gali trukdyti

Problema: WiFi ryšys dažnai nutrūksta

Simptomai: nepastovus ryšys

Sprendimas:

1. Patikrinkite maršrutizatoriaus stabilumą, apsvarstykite perkrovimą
2. Atnaujinkite įrenginio programinę įrangą
3. Naudokite statinį IP vietoje DHCP
4. Sumažinkite atstumą iki maršrutizatoriaus arba įdiekite WiFi kartotuvą
5. Patikrinkite trukdžius iš kitų įrenginių
6. Įsitikinkite, kad maitinimas tinkamas (ypač Raspberry Pi)

Debesų paslaugos

Problema: negalima prisijungti prie Azure IoT Hub

Klaida: autentifikacija nepavyko, prisijungimas atmestas

Sprendimas:

1. Patikrinkite prisijungimo duomenis:
   • Įsitikinkite, kad prisijungimo eilutė teisinga
   • Įsitikinkite, kad nėra papildomų tarpų ar eilučių pertraukų prisijungimo eilutėje
2. Patikrinkite įrenginio registraciją: įrenginys turi būti užregistruotas IoT Hub
3. Ugniasienė/proxy: įsitikinkite, kad išeinantis MQTT (prievadas 8883) arba HTTPS (prievadas 443) ryšys leidžiamas
4. IoT Hub regionas: įsitikinkite, kad IoT Hub veikia ir nėra kitame regione, kuris gali sukelti vėlavimus
5. Kvotų ribos: patikrinkite, ar nemokamo plano apribojimai neviršyti
6. Patikrinkite ryšį:

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

Problema: Azure Functions nesugeba paleisti funkcijos

Simptomai: žinutės siunčiamos, bet funkcija neįvykdoma

Sprendimas:

1. Patikrinkite, ar Function App veikia (nenustatyta sustabdyta)
2. Patikrinkite prisijungimo eilutę Function App nustatymuose
3. Peržiūrėkite funkcijų žurnalus Azure portale
4. Įsitikinkite, kad Event Hub suderinamas galutinis taškas yra teisingai sukonfigūruotas
5. Patikrinkite, ar žinutės formatas atitinka funkcijos lūkesčius
6. Patikrinkite Function App paslaugų planą (vartojimo arba dedikuotą)

MQTT

Problema: MQTT ryšys nepavyksta

Klaida: Prisijungimas atmestas, autentifikacija nepavyko

Sprendimas:

1. Brokerio adresas: Patikrinkite, ar brokerio URL/IP yra teisingas
2. Prievadas: Patikrinkite prievado numerį (1883 šifravimui nešifruotam, 8883 TLS)
3. Autentifikacija: Patikrinkite vartotojo vardą/slaptažodį, jei reikia
4. TLS/SSL: Įsitikinkite, kad sertifikatai yra galiojantys ir patikimi
5. Ugnies siena: Patikrinkite, ar prievadas nėra užblokuotas
6. Bandymas su MQTT klientu: Naudokite MQTT Explorer arba mosquitto_pub/sub bandymams

Problema: MQTT žinutės negaunamos

Simptomai: Žinutės paskelbtos, bet prenumeratoriai jų negauna

Sprendimas:

1. Temų pavadinimai: Patikrinkite, ar prenumeratoriaus tema tiksliai atitinka leidėjo temą
2. QoS lygis: Pabandykite QoS 1 arba 2 vietoje 0
3. Džokeriai: Patikrinkite, ar temų džokeriai naudojami teisingai (+ vienam lygiui, # daugeliui lygių)
4. Laikomos žinutės: Leidėjas gali nustatyti išlaikymo žymą, kad išlaikytų paskutinę žinutę
5. Ryšio laikas: Įsitikinkite, kad prenumeratorius prisijungia prieš paskelbiant žinutes

---

Jutiklių ir veiksmų įrenginių problemos

Grove jutikliai

Problema: Jutiklis grąžina neteisingas reikšmes

Simptomai: Skaitymai yra 0, -1 ar nesąmoningi

Sprendimas:

1. Patikrinkite jungtis: Įsitikinkite, kad jutiklis tinkamai prijungtas
2. Tinkamas prievadas: Patikrinkite, ar jutiklis prijungtas prie tinkamo prievado tipo:
   • Analoginiai jutikliai → Analoginiai prievadai (A0, A2, A4)
   • Skaitmeniniai jutikliai → Skaitmeniniai prievadai (D5, D16, D18 ir kt.)
   • I2C jutikliai → I2C prievadai
3. Kalibracija: Kai kurie jutikliai reikalinga kalibracija (dirvožemio drėgmės, šviesos)
4. Perkrovimas: Atjunkite ir vėl prijunkite jutiklį
5. Jutiklio dokumentacija: Patikrinkite jutiklio specifikacijas ir reikalavimus

Problema: Kapacinis dirvožemio drėgmės jutiklis visada rodo drėgną

Simptomai: Jutiklis rodo didelę drėgmę net kai yra sausas

Sprendimas:

1. Reikia kalibracijos: Dirvožemio jutikliams reikalinga kalibracija:
   • Nuskaitomas reikšmė ore (sausas pagrindas)
   • Nuskaitomas reikšmė vandenyje (drėgnas pagrindas)
   • Skaitymai priskiriami tarp šių verčių
2. Patikrinkite jutiklio dangą: Drėgmės jutikliai gali gesti, jei danga pažeista
3. Vieta: Įsitikinkite, kad jutiklis visiškai įstatytas į dirvą

Problema: Temperatūros/drėgmės jutiklio skaitymai netikslūs

Simptomai: DHT11/DHT22 rodo neteisingą temperatūrą ar drėgmę

Sprendimas:

1. Jutiklio padėtis: Venkite tiesioginių saulės spindulių, šilumos šaltinių ar oro srauto
2. Įšilimo laikas: Leiskite jutikliui 2 sekundes įšilti po įjungimo prieš skaitymą
3. Skaitymo dažnis: DHT jutikliams reikia laiko tarp skaitymų (bent 2 sekundės)
4. Patikrinkite kondensaciją: Gali paveikti skaitymus
5. Jutiklio kokybė: DHT11 mažiau tikslus nei DHT22

Kamera

Problema: Kamera nerandama Raspberry Pi

Klaida: mmal: mmal_vc_component_create: failed to create component 'vc.ril.camera'

Sprendimas:

1. Įjunkite kameros sąsają:

   sudo raspi-config
   

   Eikite į Interface Options → Camera → Enable
2. Patikrinkite plokščią kabelį: Įsitikinkite, kad kameros kabelis tinkamai įdėtas
   • Mėlyna pusė žiūri į USB prievadus ant Pi Zero
   • Mėlyna pusė žiūri nuo USB prievadų ant Pi 4
3. Atnaujinkite programinę įrangą:

   sudo apt update
   sudo apt full-upgrade
   sudo reboot
   

4. Išbandykite kamerą:

   raspistill -o test.jpg
   

Problema: Kameros nuotraukos prastos kokybės

Simptomai: Neryškios, tamsios arba išplautos nuotraukos

Sprendimas:

1. Fokusas: Nuimkite apsauginę plėvelę nuo objektyvo, reguliuokite fokusą jei įmanoma
2. Apšvietimas: Užtikrinkite pakankamą apšvietimą
3. Kameros nustatymai: Reguliuokite ekspoziciją, ISO, baltos spalvos balansą programoje
4. Stabilumas: Laikykite kamerą stabiliai, naudokite trikojį jei reikia
5. Rezoliucija: Nepersijunkite į aukštesnę negu kameros maksimalus rezoliucijos lygį

Mikrofonas ir garsiakalbis

Problema: Garsas neveikia įvesti/išvesti

Simptomai: Mikrofonas neregiistruoja, garsiakalbis negarsina

Sprendimas:

1. Patikrinkite jungtis: Įsitikinkite, kad garso įrenginiai tinkamai prijungti
2. Bandykite aparatūrą:
   • Garsiakalbis: speaker-test -t wav -c 2
   • Mikrofonas: arecord -l sąrašui, arecord test.wav įrašymui
3. Garso nustatymai: Patikrinkite ir reguliuokite garsumą:

   alsamixer
   

4. Pasirinkite garso įrenginį: Nustatykite tinkamą garso įrenginį programoje
5. Tvarkyklių problemos: Atnaujinkite ALSA arba perinstaliuokite garso tvarkykles

Problema: ReSpeaker hat neveikia

Simptomai: Garso įrenginys nerandamas

Sprendimas:

1. Įdiekite tvarkykles:

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

2. Patikrinkite įdiegimą: arecord -l turėtų rodyti ReSpeaker
3. Atnaujinkite programinę įrangą: Kai kurios Pi OS versijos reikalauja tvarkyklių atnaujinimų
4. Patikrinkite tvirtumą: Įsitikinkite, kad hat yra tinkamai prijungtas prie GPIO

---

Kūrimo aplinkos problemos

VS Code

Problema: Terminalas automatiškai neaktyvuoja virtualios aplinkos

Simptomai: Terminalas atsidaro, bet venv neaktyvuotas

Sprendimas:

1. Nustatykite Python interpretatorių: Command Palette → "Python: Select Interpreter" → Pasirinkite venv
2. Perkraukite VS Code po interpretatoriaus pasirinkimo
3. Patikrinkite nustatymus: Pridėkite į settings.json:

   "python.terminal.activateEnvironment": true
   

Problema: Kodo aplinkoje nepaleidžiamas įrenginyje

Simptomai: Kodas paleidžiamas, bet įrenginys nereaguoja

Sprendimas:

1. Įsitikinkite, kad kodas išsaugotas (patikrinkite tašką ant failo skirtuko)
2. Patikrinkite, kuri Python versija veikia: which python arba where python
3. Wio Terminal naudojimas: Įkelkite kodą per PlatformIO (spauskite įkėlimo mygtuką)
4. Raspberry Pi: Prisijunkite per SSH į Pi ir paleiskite kodą ten
5. Patikrinkite išvesties langą dėl klaidų

Problema: IntelliSense nerodo bibliotekų funkcijų

Simptomai: Nėra automatinio užbaigimo importuotoms modulėms

Sprendimas:

1. Įsitikinkite, kad biblioteka įdiegta dabartinėje aplinkoje
2. Perkraukite VS Code langą
3. Patikrinkite, ar teisingas Python interpretatorius
4. Įdiekite tipų aprašų paketus jei yra: pip install types-<library-name>

Python virtualios aplinkos

Problema: Nepavyksta sukurti virtualios aplinkos

Klaida: The virtual environment was not created successfully

Sprendimas:

1. Įdiekite venv modulį:
   • Ubuntu/Debian: sudo apt install python3-venv
   • macOS: Tai turėtų būti įtraukta į Python
   • Windows: Perinstaliuokite Python su visais komponentais
2. Patikrinkite Python diegimą: Įsitikinkite, kad Python yra tinkamai įdiegtas
3. Naudokite pilną kelią: Išbandykite python3 -m venv .venv su aiškiu python3 kvietimu

Problema: Paketai įdiegti netinkamoje vietoje

Simptomai: Importavimo klaida po paketo įdiegimo

Sprendimas:

1. Įsitikinkite, kad venv yra aktyvuota: Komandinė eilutė turi rodyti (.venv)
2. Patikrinkite pip vietą: which pip turėtų rodyti .venv/bin/pip
3. Perinstaliuokite venv aplinkoje: Aktyvuokite venv, tada pip install <package>
4. Nenaudokite sudo su pip virtualioje aplinkoje

Problema: Virtuali aplinka neperkeliamas

Simptomai: Venv neveikia po perkelimo arba kitame kompiuteryje

Sprendimas:

1. Nekelkite venv aplinkų: Ištrinkite ir sukurkite iš naujo naujoje vietoje
2. Naudokite requirements.txt:

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

3. Sukurkite venv iš naujo:

   python3 -m venv .venv
   source .venv/bin/activate  # arba activate.bat Windows operacinėje sistemoje
   pip install -r requirements.txt
   

Priklausomybės

Problema: Paketo diegimas nepavyksta

Klaida: Įvairios pip klaidos diegimo metu

Sprendimas:

1. Atnaujinkite pip:

   pip install --upgrade pip
   

2. Įdiekite kūrimo įrankius:
   • Ubuntu/Debian: sudo apt install build-essential python3-dev
   • macOS: xcode-select --install
   • Windows: Įdiekite Visual Studio Build Tools
3. Patikrinkite interneto ryšį
4. Išbandykite kitą paketo indeksą: pip install --index-url https://pypi.org/simple/ <package>
5. Įdiekite konkrečią versiją: pip install <package>==<version>

Problema: Priklausomybių konfliktai

Klaida: ERROR: pip's dependency resolver does not currently take into account all the packages that are installed

Sprendimas:

1. Naudokite naują virtualią aplinką kiekvienam projektui
2. Atnaujinkite paketus: pip install --upgrade <package>
3. Patikrinkite priklausomybes: Naudokite pip check konfliktams rasti
4. Įdiekite suderinamas versijas: Nurodykite versijų ribas requirements.txt

---

Veikimo problemos

Problema: Kodas veikia lėtai

Simptomai: Užlaikymas, laiko praleidimai, nereaguojantis elgesys

Sprendimas:

1. Sumažinkite jutiklių skaitymo dažnį: Neskaitykite jutiklių per dažnai
2. Optimizuokite ciklus: Venkite užimtumo laukimo, naudokite sleep() arba uždelsimus
3. Atminties problemos:
   • Uždarykite nereikalingas programas
   • Atlaisvinkite saugojimo vietą
   • Stebėkite su top arba htop ant Pi
4. SD kortelės greitis: Naudokite greitesnę SD kortelę arba SSD Raspberry Pi
5. Tinklo atsilikimai: Naudokite asinchroninius veiksmus tinklo skambučiams

Problema: Trūksta atminties klaidos

Klaida: MemoryError arba sistemos užšalimas

Sprendimas:

1. Raspberry Pi atveju:
   • Uždarykite nereikalingas programas
   • Padidinkite mainų (swap) vietą
   • Naudokite lengvesnę OS (Lite versiją)
   • Atnaujinkite RAM (Pi 4 turi 2/4/8GB variantus)
2. Wio Terminal:
   • Mažinkite buferių dydžius
   • Naudokite mažesnes nuotraukas
   • Optimizuokite tekstų naudojimą
   • Patikrinkite atminties nutekėjimą (neatlaisvintos atminties)

Problema: Duomenų praradimas arba sugadinimas

Simptomai: Trūksta žinučių, sugadinti failai

Sprendimas:

1. SD kortelės problemos:
   • Naudokite kokybiškas SD korteles (venkite pigias/padlapiuotas)
   • Reguliarios atsarginės kopijos
   • Tvarkingas išjungimas (nenutraukite maitinimo)
2. Buferio perpildymas: Padidinkite buferio dydžius kode
3. Tinklo patikimumas: Įgyvendinkite pakartojimo logiką ir klaidų apdorojimą
4. Paslaugų kokybė: Naudokite MQTT QoS 1 arba 2 svarbioms žinutėms

---

Dažniausios klaidų žinutės

ModuleNotFoundError: No module named 'X'

Priežastis: Paketas neįdiegtas arba virtuali aplinka neaktyvuota

Sprendimas:

pip install X

Pirmiausia įsitikinkite, kad virtuali aplinka aktyvuota.

Permission denied Linux/macOS

Priežastis: Reikia aukštesnių teisių arba failų leidimų problema

Sprendimas:

• Sistemos operacijoms: naudokite sudo
• Pip: NESINAUDOKITE sudo su venv, pirmiausia aktyvinkite venv
• Serijiniam prievadui: pridėkite vartotoją į dialout grupę: sudo usermod -a -G dialout $USER, po to atsijunkite/prisijunkite iš naujo

OSError: [Errno 98] Address already in use

Priežastis: Prievadas jau naudojamas kitų procesų

Sprendimas:

1. Suraskite procesą, naudojantį prievadą: lsof -i :<port> arba netstat -ano | findstr :<port>
2. Nutraukite procesą arba naudokite kitą prievadą savo kode

SSL: CERTIFICATE_VERIFY_FAILED

Priežastis: SSL sertifikato patvirtinimas nepavyko

Sprendimas:

1. Atnaujinkite sertifikatus: pip install --upgrade certifi
2. Patikrinkite, ar sistemos laikas teisingas: date
3. Tik kūrimui (ne gamybai): išjunkite patvirtinimą kode

IndentationError: unexpected indent

Priežastis: Python įtraukimo klaidos (mišinys tabuliavimo ir tarpų)

Sprendimas:

1. Naudokite nuoseklų įtraukimą (4 tarpai yra Python standartas)
2. Konfigūruokite redaktorių naudoti tarpus vietoje tabuliavimo
3. VS Code: Nustatykite "editor.insertSpaces": true ir "editor.tabSize": 4

UnicodeDecodeError arba UnicodeEncodeError

Priežastis: Simbolių kodavimo problemos

Sprendimas:

# Kai skaitomi failai
with open('file.txt', 'r', encoding='utf-8') as f:
    content = f.read()

# Kai rašomi failai
with open('file.txt', 'w', encoding='utf-8') as f:
    f.write(content)

---

Pagalbos gavimas

Jei išbandėte šiuos trikčių šalinimo veiksmus ir vis dar turite problemų:

1. Patikrinkite esamus išteklius

• Dokumentacija: Peržiūrėkite README ir pamokos instrukcijas
• Aparatūros vadovai: Patikrinkite hardware.md dėl specifinės aparatūros informacijos
• Seeed Studio Wiki: Seeed Studio Wiki Grove komponentams

2. Ieškokite panašių problemų

• GitHub Issues: Ieškokite esamų problemų
• Stack Overflow: Ieškokite klaidų žinučių
• Įrenginių forumai: Patikrinkite Raspberry Pi arba Arduino forumus

3. Sukurkite GitHub problemą (issue)

Jei negalite rasti sprendimo:

1. Eikite į GitHub Issues
2. Spauskite „New Issue“
3. Nurodykite:
   • Aiškų problemos aprašymą
   • Veiksmus, kaip problemą atkartoja
   • Klaidos pranešimus (pilnas tekstas)
   • Aparatūros/programinės įrangos versijas
   • Ką jau bandėte
   • Jei įmanoma, ekrano kopijas

4. Prisijunkite prie bendruomenės

• Discord: Microsoft Foundry Discord
• Microsoft Learn: Microsoft Learn IoT

5. Pateikite gerus klaidų pranešimus

Geras klaidų pranešimas apima:

• Aplinka: OS, Python versija, naudojama įranga
• Veiksmai reprodukcijai: Tikslios problemą sukeliančios veiksmų eilės
• Laukiama elgsena: Kas turėtų įvykti
• Faktinė elgsena: Kas iš tikrųjų vyksta
• Klaidos pranešimai: Pilnas klaidos tekstas, ne ekrano nuotraukos
• Kodas: Minimalus kodo pavyzdys, kuris atkuria problemą

---

Patarimai prevencijai

Bendrosios geros praktikos

1. Laikykite atsargines kopijas: Reguliarios veikiančių SD kortelių/kodo atsarginės kopijos
2. Dokumentuokite pakeitimus: Užfiksuokite komentarais, kas veikia
3. Versijų kontrolė: Naudokite git kode pokyčių sekimui
4. Testuokite palaipsniui: Išbandykite smulkius pakeitimus prieš juos apjungiant
5. Skaitykite klaidos pranešimus: Dažnai jie tiksliai nurodo, kas negerai
6. Reguliariai atnaujinkite: Laikykite programinę įrangą/firmware atnaujintą
7. Naudokite kokybiškas dalis: Venkite pigių kabelių/maitinimo šaltinių
8. Stabilus maitinimas: Naudokite tinkamą maitinimo šaltinį (ypač Pi)

Kūrimo darbo eiga

1. Pradėkite paprastai: Pradėkite nuo veikiančio pavyzdinio kodo
2. Vienas pakeitimas vienu metu: Lengviau rasti, kas sukelia klaidą
3. Dažnai testuokite: Anksti pastebėkite problemas
4. Laikykite tvarką: Logiškai organizuokite failus ir kodą
5. Komentuokite kodą: Ateities Jūs tai įvertinsite

---

Ši trikčių šalinimo vadovė yra bendruomenės prižiūrima. Jei radote sprendimą problemai, kurios čia nėra, prašome apsvarstyti galimybę prisidėti, kad padėtumėte kitiems!

---

Atsakomybės apribojimas: Šis dokumentas buvo išverstas naudojant dirbtinio intelekto vertimo paslaugą Co-op Translator. Nors stengiamės užtikrinti tikslumą, atkreipkite dėmesį, kad automatiniai vertimai gali turėti klaidų ar netikslumų. Originalus dokumentas gimtąja kalba turėtų būti laikomas pagrindiniu ir autoritetingu šaltiniu. Svarbiai informacijai rekomenduojamas profesionalus vertimas žmogiškuoju būdu. Mes neatsakome už bet kokius nesusipratimus ar klaidingą interpretavimą, kilusį dėl šio vertimo naudojimo.