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

Tõrkeotsingu juhend

See juhend aitab teil lahendada tavalisi probleeme IoT for Beginners õppekava kasutamisel. Probleemid on kategooriate kaupa mugavaks navigeerimiseks organiseeritud.

Sisukord

• Paigaldusprobleemid
  • Python'i paigaldus
  • VS Code ja laiendused
  • PlatformIO (Wio Terminal)
  • Grove teegid
• Riistvaraprobleemid
  • Raspberry Pi
  • Wio Terminal
  • Virtuaalseade (CounterFit)
• Ühenduvusprobleemid
  • WiFi ühendus
  • Pilveteenused
  • MQTT
• Andurite ja täiturite probleemid
  • Grove andurid
  • Kaamera
  • Mikrofon ja kõlar
• Arenduskeskkonna probleemid
  • VS Code
  • Python virtuaal keskkonnad
  • Sõltuvused
• Töökindluse probleemid
• Tavalised veateated
• Abi saamine

---

Paigaldusprobleemid

Python'i paigaldus

Probleem: Python'i versioon on liiga vana

Viga: On vaja Python 3.6 või uuemat

Lahendus:

1. Laadige alla uusim Python 3 aadressilt python.org
2. Windowsi paigalduse ajal märkige "Add Python to PATH"
3. Kontrollige paigaldust:

   python3 --version
   

Probleem: Mitme Python'i versiooni konfliktid

Sümptomid: Käivitub vale Python'i versioon, paketid installeeruvad valesse kohta

Lahendus:

• Windows: Kasutage py -3 asemel python Python 3 käivitamiseks
• macOS/Linux: Kasutage python3 asemel python
• Alati looge ja kasutage projektide jaoks virtuaalkeskkondi

Probleem: pip käsku ei leita

Viga: 'pip' ei ole sisemine ega väline käsk

Lahendus:

1. Proovige pip3 asemel pip
2. Või kasutage python -m pip või python3 -m pip
3. Veenduge, et Python on PATH-is (paigaldage Python uuesti ja märkige vastav valik)

VS Code ja laiendused

Probleem: Pylance laiendus ei tööta

Sümptomid: Puudub Python IntelliSense, koodi lõpetamine või tüübikontroll

Lahendus:

1. Avage VS Code käsupalet (Ctrl+Shift+P või Cmd+Shift+P)
2. Käivitage "Python: Select Interpreter"
3. Valige õige Python tõlgendaja (virtuaalkeskkond, kui kasutatakse)
4. Laadige VS Code aken uuesti

Probleem: VS Code ei tuvasta virtuaalkeskkonda

Sümptomid: Vali Python tõlgendaja valitud

Lahendus:

1. Veenduge, et olete virtuaalkeskkonna terminalis aktiveerinud
2. Avage käsupalet ja käivitage "Python: Select Interpreter"
3. Valige .venv kaustast tõlgendaja
4. Kontrollige olekuribal (vasakus allosas) õige Python versiooni kuvamist

PlatformIO (Wio Terminal)

Probleem: PlatformIO paigaldus ebaõnnestub

Viga: Mitmesugused vead PlatformIO paigalduse ajal

Lahendus:

1. Veenduge, et VS Code on ajakohane
2. Paigaldage esmalt C/C++ laiendus
3. Taaskäivitage VS Code pärast PlatformIO paigaldust
4. Kontrollige internetiühendust (PlatformIO laadib suuri faile)

Probleem: PlatformIO ei tuvasta plaati

Sümptomid: Ei saa koodi Wio Terminalile üles laadida

Lahendus:

1. Proovige teist USB kaablit (mõned kaablid on vaid laadimiseks)
2. Kontrollige seadmehaldurit (Windows) või ls /dev/tty* (macOS/Linux)
3. Paigaldage või uuendage USB draivereid
4. Proovige teist USB pesa
5. Lükake Wio Terminali toitenupp kaks korda kiiresti alla, et minna bootloader režiimi

Probleem: PlatformIO kompileerimise vead

Viga: fatal error: Arduino.h: File not found

Lahendus:

1. Kustutage projekti .pio kaust
2. Käivitage käsupaletilt "PlatformIO: Rebuild"
3. Kontrollige platformio.ini õigesti seadistatud plaadi puhul:

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

Grove teegid

Probleem: Grove teegi import ebaõnnestub Raspberry Pi-s

Viga: ModuleNotFoundError: No module named 'grove'

Lahendus:

1. Paigaldage Grove teegid uuesti:

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

2. Kui kasutate virtuaalkeskkonda, võib olla vaja installida globaalselt või kopeerida teegid
3. Kontrollige, et I2C on lubatud: sudo raspi-config nonint do_i2c 0

Probleem: Grove andurit ei tuvastata

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

Lahendus:

1. Kontrollige füüsilisi ühendusi (veenduge, et Grove kaabel on korralikult ühendatud)
2. Veenduge, et andur on ühendatud õigele pordile (analoog, digitaalne, I2C, UART)
3. Käivitage i2cdetect -y 1, et näha, kas seade on I2C bussil nähtav
4. Proovige teist Grove kaablit
5. Veenduge, et Grove Base Hat on korrektselt ühendatud Raspberry Pi GPIO jalgadele

---

Riistvaraprobleemid

Raspberry Pi

Probleem: Raspberry Pi ei käivitu

Sümptomid: Puudub ekraanipilt, ei vilgu LED, või kuvatakse vikerkaare kuva

Lahendus:

1. Kontrollige toiteallikat: Kasutage ametlikku 5V 3A USB-C toiteallikat Pi 4 jaoks
2. SD-kaardi probleemid:
   • Vormindage SD-kaart ja paigaldage Raspberry Pi OS uuesti
   • Proovige teist SD-kaarti (kasutage soovitatud tootjaid)
   • Veenduge, et SD-kaart on korralikult sisestatud
3. Kontrollige HDMI ühendust: Proovige mõlemat HDMI porti Pi 4-l, kasutage porti, mis on toite lähedal

Probleem: Ei saa SSH-ga Raspberry Pi-le ühendada

Sümptomid: Ühendus keelatud või aegumine

Lahendus:

1. Lülitage SSH sisse:
   • Raspberry Pi Imager'i abil koguge SSH seadeid täpsemates valikutes
   • Või looge boot partitsioonis tühi fail nimega ssh (ilma laiendita)
2. Leidke Pi IP aadress:
   • Kontrollige ruuteri ühendatud seadmeid
   • Kasutage ping raspberrypi.local (kui mDNS töötab)
   • Kasutage võrguskannimise tööriistu nagu nmap või Angry IP Scanner
3. Kontrollige võrku:
   • Veenduge, et Pi on samas võrgus arvutiga
   • Proovige Ethernet ühendust WiFi asemel
4. Kontrollige kasutajanime/parooli (vaikimisi: kasutaja pi, parool raspberry)

Probleem: Grove Base Hat ei tunnustata

Sümptomid: Andurid ei tööta, I2C vead

Lahendus:

1. Veenduge, et Base Hat on korrektselt ühendatud kõigile GPIO jalgadele
2. Kontrollige, kas Pi või Base Hatil on painutatud jalgasid
3. Lülitage I2C liides sisse:

   sudo raspi-config nonint do_i2c 0
   sudo reboot
   

4. Kontrollige I2C tööd: i2cdetect -y 1

Probleem: Raspberry Pi töötab aeglaselt

Sümptomid: Libisev kasutajaliides, aeglane reageerimine

Lahendus:

1. Kontrollige SD-kaardi kiirust (kasutage Class 10 või kiiremat, või SSD USB kaudu)
2. Vabastage kettaruumi: df -h, kustutage mittevajalikud failid
3. Vähendage GPU mälu raspi-config abil, kui kaamera/ekraani palju ei kasutata
4. Sulgege mittevajalikud rakendused
5. Mõelge Pi 3 või vanema asemel Pi 4 peale, mis on rohkem RAM-iga

Wio Terminal

Probleem: Wio Terminali ekraan jääb mustaks

Sümptomid: Ekraanil ei kuvata pärast koodi üleslaadimist midagi

Lahendus:

1. Kontrollige, kas kood initsialiseerib ekraani (TFT_eSPI teek)
2. Uuendage Wio Terminali püsivara aadressilt Seeed Wiki
3. Lisage ekraani initsialiseerimise kood:

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

4. Proovige laadida näidisprogramm PlatformIO-st riistvara testimiseks

Probleem: Wio Terminali WiFi ei tööta

Sümptomid: Ei saa WiFi-ga ühendust, võrguvead

Lahendus:

1. Uuendage WiFi püsivara: Järgige Wio Terminal WiFi püsivara uuendamise juhendit
2. Kontrollige WiFi sisselogimist: Veenduge, et SSID ja parool on õiged
3. WiFi sagedus: Wio Terminal toetab ainult 2.4GHz WiFi-d (mitte 5GHz)
4. Signaali tugevus: Liikuge ruuteri lähedale
5. Ruuteri sätted: Mõned ettevõtte/WPA-Enterprise võrgud ei pruugi töötada

Probleem: Wio Terminali arvutis ei tunta ära

Sümptomid: USB seadet ei tunnustata

Lahendus:

1. Proovige teist USB kaablit: Kasutage andmekaablit, mitte ainult laadimiskaablit
2. Mine bootloader režiimi: Lükake toitenupp kiiresti kaks korda alla
   • Sinine LED vilgub, seade ilmub seadmehalduris nimega "Arduino"
3. Paigaldage draiverid (Windows):
   • Laadige alla ja paigaldage Seeed USB draiver
4. Proovige teist USB porti: Vältige USB keskusi, kasutage otsest ühendust
5. Uuendage süsteemi USB draivereid

Probleem: Wio Terminali andurid ei tööta

Sümptomid: Grove andurid ei loe andmeid

Lahendus:

1. Kontrollige Grove kaablite ühendusi
2. Veenduge, et kasutate õiget Grove porti (vasak või parem)
3. Lisage õige teek andurile
4. Kontrollige anduri toitevajadusi
5. Testige andurit teegist pärit näidiskoodiga

Virtuaalseade (CounterFit)

Probleem: CounterFit rakendus ei käivitu

Viga: Mitmesugused Python vead CounterFit käivitamisel

Lahendus:

1. Veenduge, et virtuaalkeskkond on aktiveeritud
2. Installige/paigaldage CounterFit uuesti:

   pip install CounterFit
   

3. Kontrollige, kas port 5000 on vaba:
   • Windows: netstat -ano | findstr :5000
   • macOS/Linux: lsof -i :5000
4. Tapke porti 5000 kasutav protsess või kasutage teist porti:

   counterfit --port 5001
   

Probleem: Ei saa CounterFitiga koodist ühendust

Viga: Ühendus keelatud või aegumine

Lahendus:

1. Veenduge, et CounterFit töötab: Avage brauser aadressil http://127.0.0.1:5000
2. Kontrollige, et koodi ühendus URL vastab CounterFit aadressile
3. Veenduge, et tulemüür ühendust ei blokeeri
4. Proovige taaskäivitada nii CounterFit rakendus kui ka kood

Probleem: Andurid ei ilmu CounterFit UI-sse

Sümptomid: Loodud andurid ei kuvata kasutajaliideses

Lahendus:

1. Looge andurid CounterFit kasutajaliideses enne koodi käivitamist
2. Värskendage brauseri lehte
3. Kontrollige, et anduri tüüp vastab koodis eeldatule
4. Tühjendage brauseri vahemälu

---

Ühenduvusprobleemid

WiFi ühendus

Probleem: Seade ei saa WiFi-ga ühendust

Sümptomid: Ühenduse aegumine, autentimine ebaõnnestus

Lahendus:

1. Kontrollige SSID ja parooli: Veenduge, et andmed on õiged
2. WiFi sagedus: Enamik IoT seadmeid toetab ainult 2.4GHz (mitte 5GHz)
3. Ruuteri sätted:
   • Lülitage AP isolatsioon välja, kui see on lubatud
   • Kasutage WPA2-PSK turvalisust (vältige WPA3, WEP või avatud võrke)
   • Veenduge, et DHCP on sisse lülitatud
4. Peidetud võrgud: Kui SSID on peidetud, pean selle seadistama käsitsi
5. Signaali tugevus: Liigutage seade lähemale ruuterile
6. Segajad: Teised seadmed, mikrolaineahi või seinad võivad häirida

Probleem: WiFi ühendus katkeb sageli

Sümptomid: Katkendlik ühendus

Lahendus:

1. Kontrollige ruuteri stabiilsust, mõelge taaskäivitamisele
2. Uuendage seadme püsivara
3. Kasutage staatilist IP-d DHCP asemel
4. Vähendage kaugust ruuterist või lisage WiFi kordusvahend
5. Kontrollige teiste seadmete segamist
6. Veenduge, et toiteallikas on piisav (eriti Raspberry Pi puhul)

Pilveteenused

Probleem: Ei saa ühendust Azure IoT Hub-iga

Viga: Autentimine ebaõnnestus, ühendus keelatud

Lahendus:

1. Kontrollige mandaate:
   • Kontrollige ühendusstringi õigsust
   • Veenduge, et seotud stringis ei ole lisatühikuid ega reavahetusi
2. Kontrollige seadme registreerimist: Seade peab olema registreeritud IoT Hubis
3. Tulemüür/proxy: Lubage väljaminev MQTT (port 8883) või HTTPS (port 443)
4. IoT Hub'i piirkond: Veenduge, et IoT Hub töötab ja ei asu teises piirkonnas, mis põhjustab viivitust
5. Kvoodi piirangud: Kontrollige, kas tasuta teenusepiirangud on ületatud
6. Testige ühendust:

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

Probleem: Azure Functions ei käivitu

Sümptomid: Sõnumeid saadetakse, kuid funktsioon ei käivitu

Lahendus:

1. Kontrollige, et Function App töötab (ei ole peatatud)
2. Kinnitage ühendusstring Function App seadetes
3. Kontrollige funktsiooni logisid Azure Portaalis
4. Veenduge, et Event Hub ühilduv lõpp-punkt on korrektselt seadistatud
5. Kontrollige, et sõnumi formaat vastab funktsiooni ootustele
6. Kontrollige Function App teenuseplaani (tarbimine vs. pühendatud)

MQTT

Probleem: MQTT ühendus ebaõnnestub

Viga: Ühendus keelatud, autentimine ebaõnnestus

Lahendus:

1. Vahendaja aadress: Kontrolli, kas vahendaja URL/IP on õige
2. Port: Kontrolli pordinumbrit (1883 krüpteerimata jaoks, 8883 TLS-i jaoks)
3. Autentimine: Kontrolli kasutajanime/parooli, kui nõutud
4. TLS/SSL: Veendu, et sertifikaadid on kehtivad ja usaldusväärsed
5. Tulemüür: Kontrolli, et port pole blokeeritud
6. Testi MQTT kliendiga: Kasuta MQTT Explorer’i või mosquitto_pub/sub testimiseks

Probleem: MQTT sõnumeid ei saa

Sümptomid: Sõnumid on avaldatud, kuid tellijad neid ei saa

Lahendus:

1. Teemade nimed: Kontrolli, et tellija teema vastab täpselt avaldaja teemale
2. QoS tase: Proovi QoS 1 või 2 asemel 0
3. Wildcards: Kontrolli, et teema wildcardid on korralikult kasutatud (+ ühe taseme jaoks, # mitme taseme jaoks)
4. Hoitud sõnumid: Avaldaja saab seada retain-lipu, et hoida viimast sõnumit
5. Ühenduse ajastus: Veendu, et tellija ühendub enne sõnumite avaldamist

---

Andurite ja täiturmehhanismide probleemid

Grove andurid

Probleem: Andur tagastab vale väärtusi

Sümptomid: Loeväärtused on 0, -1 või mõistmatud väärtused

Lahendus:

1. Kontrolli ühendusi: Veendu, et andur on korralikult ühendatud
2. Õige port: Kontrolli, et andur on õiges porditüübis:
   • Analoogsensorid → Analoogpordid (A0, A2, A4)
   • Digitaalsensorid → Digitaalsed pordid (D5, D16, D18 jne)
   • I2C andurid → I2C pordid
3. Kalibreerimine: Mõned andurid vajavad kalibreerimist (mulla niiskus, valgus)
4. Toite väljalülitus: Ühenda andur lahti ja uuesti
5. Anduri andmeleht: Kontrolli anduri spetsifikatsioone ja nõudeid

Probleem: Kapatsiivne mullaniiskuse andur näitab alati märga

Sümptomid: Andur näitab kõrget niiskust isegi kuival ajal

Lahendus:

1. Kalibreerimine vajalik: Mullaniiskuse andurid vajavad kalibreerimist:
   • Loe väärtus õhus (kuiv baasväärtus)
   • Loe väärtus vees (märk baasväärtus)
   • Kaardista loetud väärtused nende vahele
2. Kontrolli anduri katet: Niiskuseandurid võivad degradeeruda, kui kate on kahjustatud
3. Paigutus: Veendu, et andur on mullas täielikult sees

Probleem: Temperatuuri/niiskuse anduri lugemised on valed

Sümptomid: DHT11/DHT22 näitavad vale temperatuuri või niiskust

Lahendus:

1. Anduri asukoht: Väldi otsest päikesevalgust, soojusallikaid või õhuvoolu
2. Soojendus aeg: Lase anduril pärast sisselülitamist 2 sekundit soojeneda enne lugemist
3. Lugemissagedus: DHT andurid vajavad lugemise vahel aega (vähemalt 2 sekundit)
4. Kontrolli kondensatsiooni: See võib lugemisi mõjutada
5. Anduri kvaliteet: DHT11 on vähem täpne kui DHT22

Kaamera

Probleem: Kaamerat Raspberry Pi-s ei tuvastata

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

Lahendus:

1. Luba kaamera liides:

   sudo raspi-config
   

   Mine Interface Options → Camera → Enable
2. Kontrolli lintkaablit: Veendu, et kaamerakaabel on õigesti ühendatud
   • Sinine pool Pi Zero USB portide poole
   • Sinine pool eemale USB portidest Pi 4 puhul
3. Uuenda püsivara:

   sudo apt update
   sudo apt full-upgrade
   sudo reboot
   

4. Testi kaamerat:

   raspistill -o test.jpg
   

Probleem: Kaamera pildid on kehva kvaliteediga

Sümptomid: Udused, tumedad või pleekinud pildid

Lahendus:

1. Fookus: Eemalda objektiivilt kaitsekile, reguleeri fookust, kui võimalik
2. Valgustus: Veendu, et on piisav valgustus
3. Kaamera seaded: Kohanda säritust, ISO-d, valge tasakaalu koodi sees
4. Stabiilsus: Hoia kaamerat paigal, vajadusel kasuta statiivi
5. Resolutsioon: Ära ületa kaamera maksimaalset resolutsiooni

Mikrofon ja kõlar

Probleem: Helisisend/väljund puudub

Sümptomid: Mikrofon ei salvesta, kõlar ei mängi heli

Lahendus:

1. Kontrolli ühendusi: Veendu, et heliseadmed on õigesti ühendatud
2. Testi riistvara:
   • Kõlar: speaker-test -t wav -c 2
   • Mikrofon: arecord -l seadmeloend, arecord test.wav salvestamiseks
3. Helitugevuse sätted: Kontrolli ja reguleeri helitugevust:

   alsamixer
   

4. Vali heliseade: Määra koodis õige heliseade
5. Draiveri probleemid: Uuenda ALSA-d või paigalda helidraiverid uuesti

Probleem: ReSpeaker hat ei tööta

Sümptomid: Heliseadet ei tuvastata

Lahendus:

1. Paigalda draiverid:

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

2. Kontrolli paigaldust: arecord -l peaks loetlema ReSpeakeri
3. Uuenda püsivara: Mõned Pi OS versioonid vajavad draiveriuuendust
4. Kontrolli ühendust: Veendu, et hat on korralikult GPIO külge ühendatud

---

Arenduskeskkonna probleemid

VS Code

Probleem: Terminali virtuaalkeskkond ei aktiveeru automaatselt

Sümptomid: Terminal avaneb, kuid venv ei aktiveeru

Lahendus:

1. Määra Python interpreteerija: Command Palette → "Python: Select Interpreter" → vali venv
2. Taaskäivita VS Code pärast interpreteerija valimist
3. Kontrolli seadistusi: Lisa settings.json faili:

   "python.terminal.activateEnvironment": true
   

Probleem: Kood ei käivitu seadmes

Sümptomid: Kood jookseb, kuid seadmes ei juhtu midagi

Lahendus:

1. Veendu, et kood on salvestatud (kontrolli faili vahelehte punkti)
2. Kontrolli, milline Python jookseb: which python või where python
3. Wio Terminali puhul: Veendu, et kood on PlatformIO kaudu üles laaditud (klõpsa upload nuppu)
4. Raspberry Pi puhul: Logi SSH-ga sisse Pi’sse ja käivita kood sealt
5. Vaata väljundakent vigade jaoks

Probleem: IntelliSense ei kuva teekide funktsioone

Sümptomid: Automaattäide puudub imporditud moodulitele

Lahendus:

1. Veendu, et teek on installitud praeguses keskkonnas
2. Laadi VS Code aken uuesti
3. Kontrolli, et Python interpreteerija on õige
4. Paigalda olemasolevad tüübistubid: pip install types-<library-name>

Python virtuaalkeskkonnad

Probleem: Virtuaalkeskkonda ei saa luua

Viga: The virtual environment was not created successfully

Lahendus:

1. Paigalda venv moodul:
   • Ubuntu/Debian: sudo apt install python3-venv
   • macOS: peaks olema Pythoniga kaasas
   • Windows: paigalda Python uuesti kõigi komponentidega
2. Kontrolli Python’i paigaldust: Veendu, et Python on korrektselt paigaldatud
3. Kasuta täielikku teed: Proovi python3 -m venv .venv koos selge python3 käsuga

Probleem: Paketid paigaldatakse valesse asukohta

Sümptomid: Impordivead peale paketi paigaldust

Lahendus:

1. Veendu, et venv on aktiveeritud: Käsureal peaks olema (.venv)
2. Kontrolli pip asukohta: which pip peaks osutama .venv/bin/pip-le
3. Paigalda uuesti venv-is: Aktiviseeri venv ja paigalda pip install <pakett>
4. Ära kasuta sudo’t pip’iga virtuaalkeskkonnas

Probleem: Virtuaalkeskkond pole teisaldatav

Sümptomid: Venv ei tööta pärast teisaldamist või teises arvutis

Lahendus:

1. Ära liigu venge: Kustuta ja loo uus asukohas
2. Kasuta requirements.txt:

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

3. Loo venv uuesti:

   python3 -m venv .venv
   source .venv/bin/activate  # või activate.bat Windowsis
   pip install -r requirements.txt
   

Sõltuvused

Probleem: Paketi paigaldus ebaõnnestub

Viga: Erinevad pip vead paigaldamisel

Lahendus:

1. Uuenda pip:

   pip install --upgrade pip
   

2. Paigalda ehitustööriistad:
   • Ubuntu/Debian: sudo apt install build-essential python3-dev
   • macOS: xcode-select --install
   • Windows: paigalda Visual Studio Build Tools
3. Kontrolli internetiühendust
4. Proovi teist paketi indeksit: pip install --index-url https://pypi.org/simple/ <pakett>
5. Paigalda konkreetne versioon: pip install <pakett>==<versioon>

Probleem: Sõltuvuste konfliktid

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

Lahendus:

1. Kasuta iga projekti jaoks uut virtuaalkeskkonda
2. Uuenda pakette: pip install --upgrade <pakett>
3. Kontrolli nõudeid: Kasuta pip check konfliktide leidmiseks
4. Paigalda sobivad versioonid: Määra versioonivahemikud requirements.txt failis

---

Jõudlusprobleemid

Probleem: Kood jookseb aeglaselt

Sümptomid: Viivitused, ajalõpped, reageerimatus

Lahendus:

1. Vähenda andurite lugemissagedust: Ära loe andureid liiga sageli
2. Optimeeri tsükleid: Väldi hõivatud ootust, kasuta sleep() või viivitusi
3. Mälu probleemid:
   • Sulge mittevajalikud rakendused
   • Vabasta salvestusruumi
   • Jälgi top või htop programmi abil Pi peal
4. SD kaardi kiirus: Kasuta kiiremat SD kaarti või SSD-d Raspberry Pi jaoks
5. Võrgu viivitused: Kasuta asünkroonseid toiminguid võrgukõnede jaoks

Probleem: Mälu puuduse vead

Viga: MemoryError või süsteemi külmutamine

Lahendus:

1. Raspberry Pi puhul:
   • Sulge mittevajalikud rakendused
   • Suurenda swap ruumi
   • Kasuta kergemat operatsioonisüsteemi (Lite versioon)
   • Uuenda RAM-i (Pi 4-l on 2/4/8GB valikud)
2. Wio Terminali puhul:
   • Vähenda puhvrite suuruseid
   • Kasuta väiksemaid pilte
   • Optimeeri stringide kasutust
   • Kontrolli mälulekkeid (vabastamata mälu)

Probleem: Andmete kadumine või kahjustumine

Sümptomid: Puuduvad sõnumid, vigased failid

Lahendus:

1. SD kaardi probleemid:
   • Kasuta kvaliteetseid SD kaarte (väldi odavaid või võltsitud)
   • Tee regulaarselt varukoopiaid
   • Tee korralik väljalülitus (ära tõmba toidet ootamatult)
2. Puhvripiirang: Suurenda puhvrite suurust koodi sees
3. Võrgu töökindlus: Rakenda korduslogika ja veahaldus
4. Teenuse Kvaliteet: Kasuta MQTT QoS 1 või 2 oluliste sõnumite jaoks

---

Levinud veateated

ModuleNotFoundError: No module named 'X'

Põhjus: Paketti pole installitud või virtuaalkeskkond pole aktiveeritud

Lahendus:

pip install X

Veendu esmalt, et virtuaalkeskkond on aktiveeritud.

Permission denied Linux/macOS

Põhjus: Vajalikud kõrgendatud õigused või failiõiguste probleem

Lahendus:

• Süsteemi toimingute puhul kasuta sudo
• Pip’i puhul ÄRA KASUTA sudo’t koos venv’iga, aktiveeri venv esmalt
• Sariipordi puhul lisa kasutaja dialout gruppi: sudo usermod -a -G dialout $USER, seejärel logi välja ja uuesti sisse

OSError: [Errno 98] Address already in use

Põhjus: Port on juba teise protsessi poolt kasutusel

Lahendus:

1. Leia porti kasutav protsess: lsof -i :<port> või netstat -ano | findstr :<port>
2. Lõpeta protsess või kasuta teist porti oma koodis

SSL: CERTIFICATE_VERIFY_FAILED

Põhjus: SSL sertifikaadi valideerimine ebaõnnestus

Lahendus:

1. Uuenda sertifikaate: pip install --upgrade certifi
2. Kontrolli süsteemi aega: date
3. Ainult arendamiseks (mitte tootmiseks): loo koodis valideerimise keelamine

IndentationError: unexpected indent

Põhjus: Python indentatsiooni probleemid (tabide ja tühikute segamine)

Lahendus:

1. Kasuta ühtlast indentatsiooni (4 tühikut on Python standard)
2. Sea redaktoris tühikute kasutamine tabide asemel
3. VS Code’is määra "editor.insertSpaces": true ja "editor.tabSize": 4

UnicodeDecodeError või UnicodeEncodeError

Põhjus: Märgistiku kodeerimise probleemid

Lahendus:

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

# Failide kirjutamisel
with open('file.txt', 'w', encoding='utf-8') as f:
    f.write(content)

---

Abi saamine

Kui oled proovinud neid tõrkeotsingu samme ja probleemid püsivad:

1. Kontrolli olemasolevaid ressursse

• Dokumentatsioon: Tutvu README ja õppetükkide juhistega
• Riistvarajuhendid: Vaata hardware.md riistvaraspetsiifilist infot
• Seeed Studio Wiki: Seeed Studio Wiki Grove komponentide kohta

2. Otsi sarnaseid probleeme

• GitHub’i probleemid: Otsi olemasolevaid probleeme
• Stack Overflow: Otsi veateatega seotud vastuseid
• Seadme foorumid: Vaata Raspberry Pi või Arduino foorumeid

3. Loo GitHub’is probleem (Issue)

Kui lahendust ei leia:

1. Mine GitHub Issues
2. Klõpsa "New Issue"
3. Kirjelda:
   • Selgelt probleemi sisu
   • Sammud, kuidas probleemi tekitada
   • Veateated (kogu tekst)
   • Riistvara/tarkvara versioonid
   • Mida oled juba proovinud
   • Ekraanipildid, kui asjakohane

4. Liitu kogukonnaga

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

5. Esita head veaaruannet

Heas veaaruandes on:

• Keskkond: OS, Python versioon, kasutatud riistvara
• Probleemi taasesituse sammud: Täpsed sammud, mis põhjustavad vea
• Oodatav käitumine: Mida peaks juhtuma
• Tegelik käitumine: Mis tegelikult juhtub
• Veateated: Täielik veatekst, mitte ekraanipildid
• Kood: Minimaalne koodinäide, mis probleemi esile kutsub

---

Ennetamiseks nõuanded

Üldised parimad praktikad

1. Hoia varukoopiaid: Regulaarne töötavate SD kaartide/koodi backup
2. Dokumenteeri muudatused: Märgi kommentaarides, mis töötab
3. Versioonihaldus: Kasuta git'i koodi muudatuste jälgimiseks
4. Testi järkjärgult: Testi väikeseid muudatusi enne nende kombineerimist
5. Loe veateateid: Need ütlevad sageli täpselt, mis on valesti
6. Uuenda regulaarselt: Hoia tarkvara/firmware ajakohasena
7. Kasuta kvaliteetseid komponente: Väldi odavaid kaableid/toiteallikaid
8. Stabiilne toide: Kasuta sobivat toiteallikat (eriti Pi puhul)

Arendusvoog

1. Alusta lihtsalt: Alusta näidiskoodiga, mis töötab
2. Üks muudatus korraga: Kergem leida, mis rikub
3. Testi tihti: Katsu vead varakult kinni püüda
4. Hoidke korras: Korralda failid ja kood loogiliselt
5. Kommenteeri koodi: Tuleviku sina hindab seda

---

See tõrkeotsingu juhend on kogukonna hooldatud. Kui leiad lahenduse probleemile, mis siin loetletud pole, kaalu palun panustamist, et aidata teisi!

---

Vastutusest loobumine: See dokument on tõlgitud AI tõlketeenuse Co-op Translator abil. Kuigi püüame tagada täpsust, palun arvestage, et automaatsed tõlked võivad sisaldada vigu või ebatäpsusi. Originaaldokument tema emakeeles tuleks pidada autoriteetseks allikaks. Kriitilise teabe puhul soovitatakse kasutada professionaalset inimtõlget. Me ei vastuta selle tõlke kasutamisest tulenevate arusaamatuste või valesti tõlgenduste eest.