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

Vianmääritysohje

Tämä opas auttaa sinua ratkaisemaan yleisiä ongelmia, joita voi ilmetä IoT for Beginners -oppimateriaalin parissa työskennellessä. Ongelmat on järjestetty kategorioittain helppoa selailua varten.

Sisällysluettelo

• Asennusongelmat
  • Pythonin asennus
  • VS Code ja laajennukset
  • PlatformIO (Wio Terminal)
  • Grove-kirjastot
• Laitteisto-ongelmat
  • Raspberry Pi
  • Wio Terminal
  • Virtuaalilaite (CounterFit)
• Yhteysongelmat
  • WiFi-yhteys
  • Pilvipalvelut
  • MQTT
• Anturi- ja toimilaiteongelmat
  • Grove-anturit
  • Kamera
  • Mikrofoni ja kaiutin
• Kehitysympäristöongelmat
  • VS Code
  • Python-virtuaaliympäristöt
  • Riippuvuudet
• Suorituskykyongelmat
• Yleisimmät virheilmoitukset
• Apua saatavilla

---

Asennusongelmat

Pythonin asennus

Ongelma: Python-versio on liian vanha

Virhe: Python 3.6 tai uudempaa vaaditaan

Ratkaisu:

1. Lataa uusin Python 3 osoitteesta python.org
2. Asennuksen aikana Windowsissa valitse "Add Python to PATH"
3. Tarkista asennus:

   python3 --version
   

Ongelma: Useat Python-versiot aiheuttavat konflikteja

Oireet: Väärä Python-versio käynnistyy, paketit asentuvat väärään sijaintiin

Ratkaisu:

• Windows: Käytä py -3 komentoa python sijaan kutsuaksesi Python 3:ta suoraan
• macOS/Linux: Käytä python3 komentoa python sijaan
• Luo ja käytä aina virtuaaliympäristöjä projekteissa

Ongelma: pip-komentoa ei löydy

Virhe: 'pip' ei tunnistettu sisäiseksi tai ulkoiseksi komennoksi

Ratkaisu:

1. Kokeile pip3 komentoa pip sijaan
2. Tai käytä python -m pip tai python3 -m pip
3. Varmista, että Python on lisätty PATHiin (asenna Python uudelleen ja tarkista valinta)

VS Code ja laajennukset

Ongelma: Pylance-laajennus ei toimi

Oireet: Ei Python-intelliSenseä, koodin täydentämistä tai tyyppitarkistusta

Ratkaisu:

1. Avaa VS Code -komentopaletti (Ctrl+Shift+P tai Cmd+Shift+P)
2. Suorita "Python: Select Interpreter"
3. Valitse oikea Python-tulkki (virtuaaliympäristö, jos käytössä)
4. Lataa VS Code uudelleen

Ongelma: VS Code ei tunnista virtuaaliympäristöä

Oireet: Väärä Python-tulkki valittu

Ratkaisu:

1. Varmista, että olet aktivoinut virtuaaliympäristön terminalissa
2. Avaa komentopaletti ja suorita "Python: Select Interpreter"
3. Valitse tulkki .venv-kansiosta
4. Tarkista tilapalkista (vasen alakulma), että oikea Python-versio näkyy

PlatformIO (Wio Terminal)

Ongelma: PlatformIO:n asennus epäonnistuu

Virhe: Erilaisia virheitä PlatformIO:n asennuksen aikana

Ratkaisu:

1. Varmista, että VS Code on päivitetty
2. Asenna ensin C/C++ -laajennus
3. Käynnistä VS Code uudelleen PlatformIO:n asennuksen jälkeen
4. Tarkista internet-yhteys (PlatformIO lataa suuria tiedostoja)

Ongelma: PlatformIO ei tunnista laitetta

Oireet: Koodia ei saa ladattua Wio Terminaliin

Ratkaisu:

1. Kokeile toista USB-kaapelia (jotkut kaapelit ovat vain latauskaapeleita)
2. Tarkista Laitehallinnasta (Windows) tai komennolla ls /dev/tty* (macOS/Linux)
3. Asenna tai päivitä USB-ajurit
4. Kokeile eri USB-porttia
5. Liikuta Wio Terminalin virtakytkintä kahdesti nopeasti päästäksesi bootloader-tilaan

Ongelma: Kääntämisvirheitä PlatformIO:ssa

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

Ratkaisu:

1. Poista projektin .pio kansio
2. Suorita "PlatformIO: Rebuild" komentopaletista
3. Varmista, että platformio.ini sisältää oikean kortin määrityksen:

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

Grove-kirjastot

Ongelma: Grove-kirjaston tuonti epäonnistuu Raspberry Pillä

Virhe: ModuleNotFoundError: No module named 'grove'

Ratkaisu:

1. Asenna Grove-kirjastot uudelleen:

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

2. Jos käytät virtuaaliympäristöä, saatat joutua asentamaan ne globaalisti tai kopioimaan kirjastot
3. Varmista, että I2C on käytössä: sudo raspi-config nonint do_i2c 0

Ongelma: Grove-anturia ei tunnisteta

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

Ratkaisu:

1. Tarkista fyysiset liitännät (varmista, että Grove-kaapeli on kunnolla kiinni)
2. Varmista, että anturi on kytketty oikeaan porttiin (analoginen, digitaalinen, I2C, UART)
3. Suorita i2cdetect -y 1 nähdäksesi, näkyykö laite I2C-väylällä
4. Kokeile eri Grove-kaapelia
5. Varmista, että Grove Base Hat on oikein paikoillaan Raspberry Pin GPIO-nastoissa

---

Laitteisto-ongelmat

Raspberry Pi

Ongelma: Raspberry Pi ei käynnisty

Oireet: Ei näyttöä, ei LED-toimintaa tai sateenkaaren värinen näyttö

Ratkaisu:

1. Tarkista virtalähde: Käytä virallista 5V 3A USB-C virtalähdettä Pi 4:lle
2. SD-korttiongelmat:
   • Alusta SD-kortti ja asenna Raspberry Pi OS uudelleen
   • Kokeile eri SD-korttia (suositeltuja merkkejä)
   • Varmista, että SD-kortti on kunnolla paikallaan
3. Tarkista HDMI-yhteys: Kokeile molempia HDMI-portteja Pi 4:ssä, käytä virtalähteen läheisintä HDMI-porttia

Ongelma: SSH-yhteys Raspberry Pi:hin ei toimi

Oireet: Yhteys evätty tai aikakatkaisu

Ratkaisu:

1. Ota SSH käyttöön:
   • Kun kirjoitat SD-korttia Raspberry Pi Imagerilla, ota SSH käyttöön lisäasetuksista
   • Tai luo tyhjä tiedosto nimeltä ssh (ilman tiedostopäätettä) käynnistysosiolle
2. Etsi Pi:n IP-osoite:
   • Tarkista reitittimesi liitetyt laitteet
   • Käytä ping raspberrypi.local (jos mDNS toimii)
   • Käytä verkon skannausohjelmia kuten nmap tai Angry IP Scanner
3. Tarkista verkko:
   • Varmista, että Pi on samassa verkossa kuin tietokoneesi
   • Kokeile ethernet-yhteyttä WiFi:n sijaan
4. Tarkista käyttäjätunnus/salasana (oletus: käyttäjätunnus pi, salasana raspberry)

Ongelma: Grove Base Hat ei tunnistu

Oireet: Anturit eivät toimi, I2C-virheitä

Ratkaisu:

1. Varmista, että Base Hat on kunnolla kiinni kaikissa GPIO-nastoissa
2. Tarkista, ettei Pi:n tai Base Hatin nastoissa ole taittuneita nastoja
3. Ota I2C-käyttöliittymä käyttöön:

   sudo raspi-config nonint do_i2c 0
   sudo reboot
   

4. Varmista, että I2C toimii: i2cdetect -y 1

Ongelma: Raspberry Pi toimii hitaasti

Oireet: Käyttöliittymä tökkii, vaste hidasta

Ratkaisu:

1. Tarkista SD-kortin nopeus (käytä Class 10 tai parempaa, tai SSD USB:n kautta)
2. Vapauta levytilaa: df -h tarkastaa, poista turhat tiedostot
3. Vähennä GPU-muistin määrää raspi-configissa, jos kameraa/näyttöä ei käytetä paljon
4. Sulje tarpeettomat sovellukset
5. Harkitse Pi 4:ään vaihto, jossa on enemmän RAM-muistia, jos käytössä on Pi 3 tai vanhempi

Wio Terminal

Ongelma: Wio Terminalin näyttö pysyy tyhjänä

Oireet: Ei kuvaruutulähtöä koodin latauksen jälkeen

Ratkaisu:

1. Tarkista, että koodi alustaa näytön (TFT_eSPI-kirjasto)
2. Päivitä Wio Terminalin laiteohjelmisto Seeed Wikistä
3. Lisää näytön alustuskoodi:

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

4. Kokeile ladata esimerkkisketsi PlatformIO:sta testataksesi laitetta

Ongelma: WiFi ei toimi Wio Terminalissa

Oireet: Ei yhteyttä WiFi-verkkoon, verkko-ongelmia

Ratkaisu:

1. Päivitä WiFi-laiteohjelmisto: Noudata Wio Terminal WiFi -päivitysohjetta
2. Tarkista WiFi-tunnukset: Varmista, että SSID ja salasana ovat oikein
3. WiFi-taajuus: Wio Terminal tukee vain 2.4 GHz WiFiä (ei 5 GHz)
4. Signaalin voimakkuus: Siirry lähemmäs reititintä
5. Reitittimen asetukset: Jotkin yritys- tai WPA-Enterprise-verkot eivät toimi

Ongelma: Wio Terminal ei tunnistu tietokoneessa

Oireet: USB-laite ei tunnistu

Ratkaisu:

1. Kokeile eri USB-kaapelia: Käytä datakaapelia, ei pelkkää latauskaapelia
2. Siirry bootloader-tilaan: Liikuta virtakytkintä alas kahdesti nopeasti
   • Sininen LED vilkkuu, laite näkyy Laitehallinnassa nimellä "Arduino"
3. Asenna ajurit (Windows):
   • Lataa ja asenna Seeed USB -ajuri
4. Kokeile eri USB-porttia: Vältä USB-keskittimiä, käytä suoraa yhteyttä
5. Päivitä järjestelmän USB-ajurit

Ongelma: Anturit eivät toimi Wio Terminalissa

Oireet: Grove-antureilta ei tule mittaustietoja

Ratkaisu:

1. Tarkista Grove-kaapelin liitännät
2. Varmista, että käytät oikeaa Grove-porttia (vasen tai oikea)
3. Sisällytä sensorin vaatimat kirjastot
4. Tarkista anturin virtavaatimukset
5. Testaa anturi kirjaston esimerkkikoodilla

Virtuaalilaite (CounterFit)

Ongelma: CounterFit-sovellus ei käynnisty

Virhe: Erilaisia Python-virheitä CounterFitin käynnistyessä

Ratkaisu:

1. Varmista, että virtuaaliympäristö on aktivoitu
2. Asenna tai asenna CounterFit uudelleen:

   pip install CounterFit
   

3. Tarkista, ettei portti 5000 ole jo käytössä:
   • Windows: netstat -ano | findstr :5000
   • macOS/Linux: lsof -i :5000
4. Lopeta prosessi, joka käyttää porttia 5000, tai käytä eri porttia:

   counterfit --port 5001
   

Ongelma: Yhteyttä CounterFitiin ei saada koodista

Virhe: Yhteys evätty tai aikakatkaisu

Ratkaisu:

1. Varmista, että CounterFit on käynnissä: Avaa selaimella http://127.0.0.1:5000
2. Tarkista, että koodin yhteys-URL vastaa CounterFitin osoitetta
3. Varmista, ettei palomuuri estä yhteyttä
4. Kokeile käynnistää uudelleen sekä CounterFit-sovellus että koodisi

Ongelma: Antureita ei näy CounterFitissä

Oireet: Luodut anturit eivät näy CounterFitin käyttöliittymässä

Ratkaisu:

1. Luo anturit CounterFitin käyttöliittymässä ennen koodin suorittamista
2. Päivitä selaimen sivu
3. Tarkista, että anturityyppi vastaa koodin odotuksia
4. Tyhjennä selaimen välimuisti

---

Yhteysongelmat

WiFi-yhteys

Ongelma: Laite ei yhdistä WiFi-verkkoon

Oireet: Yhteyden aikakatkaisu, todennus epäonnistui

Ratkaisu:

1. Tarkista SSID ja salasana: Varmista kirjautumistiedot
2. WiFi-taajuus: Suurin osa IoT-laitteista tukee vain 2.4 GHz (ei 5 GHz)
3. Reitittimen asetukset:
   • Poista käytöstä AP-eristys, jos se on päällä
   • Käytä WPA2-PSK -salausta (vältä WPA3:a, WEP:iä tai avoimia verkkoja)
   • Varmista, että DHCP on päällä
4. Piilotetut verkot: Jos SSID on piilotettu, se täytyy määrittää eksplisiittisesti
5. Signaalin voimakkuus: Siirrä laite lähemmäs reititintä
6. Häiriöt: Muut laitteet, mikroaaltouunit tai seinät voivat aiheuttaa häiriöitä

Ongelma: WiFi-yhteys katkeilee usein

Oireet: Katkonainen yhteys

Ratkaisu:

1. Tarkista reitittimen vakaus ja harkitse uudelleenkäynnistystä
2. Päivitä laitteen laiteohjelmisto
3. Käytä staattista IP-osoitetta DHCP:n sijaan
4. Lyhennä etäisyyttä reitittimeen tai lisää WiFi-toistin
5. Tarkista häiriöt muista laitteista
6. Varmista riittävä virransyöttö (erityisesti Raspberry Pi:lle)

Pilvipalvelut

Ongelma: Yhteyttä Azure IoT Hubiin ei saada

Virhe: Todennus epäonnistui, yhteys evätty

Ratkaisu:

1. Tarkista kirjautumistiedot:
   • Varmista, että yhteysmerkkijono on oikea
   • Ei ylimääräisiä välilyöntejä tai rivinvaihtoja yhteysmerkkijonossa
2. Tarkista laitteen rekisteröinti: Laite täytyy olla rekisteröity IoT Hubiin
3. Palomuuri/proxy: Salli lähtöliikenne MQTT:lle (portti 8883) tai HTTPS:lle (portti 443)
4. IoT Hubin sijainti: Varmista, että IoT Hub on käynnissä eikä eri sijainnissa, joka aiheuttaa viiveitä
5. Käyttörajoitukset: Tarkista, ettei ilmaisversion rajoja ole ylitetty
6. Testaa yhteys:

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

Ongelma: Azure Functions ei laukea

Oireet: Viestit lähetetty, mutta funktio ei suoritettu

Ratkaisu:

1. Tarkista, että Function App on käynnissä (ei pysäytetty)
2. Varmista, että yhteysmerkkijono on oikein Function Appin asetuksissa
3. Tarkista lokit Azure-portaalista
4. Varmista, että Event Hub -yhteensopiva päätepiste on määritetty oikein
5. Tarkista viestin muoto vastaa funktion odotuksia
6. Tarkista Function Appin palvelusuunnitelma (kulutus vs. omistettu)

MQTT

Ongelma: MQTT-yhteys epäonnistuu

Virhe: Yhteys evätty, tunnistautuminen epäonnistui

Ratkaisu:

1. Välittäjän osoite: Tarkista, että välittäjän URL/IP on oikein
2. Portti: Tarkista porttinumero (1883 salauksettomalle, 8883 TLS:lle)
3. Tunnistautuminen: Tarkista käyttäjätunnus/salasana tarvittaessa
4. TLS/SSL: Varmista, että varmenteet ovat voimassa ja luotettuja
5. Palomuuri: Tarkista, ettei portti ole estetty
6. Testaa MQTT-asiakkaalla: Käytä MQTT Exploreria tai mosquitto_pub/sub:ta testaukseen

Ongelma: MQTT-viestejä ei vastaanoteta

Oireet: Viestit julkaistu, mutta tilaajat eivät saa niitä

Ratkaisu:

1. Aiheiden nimet: Varmista, että tilaajan aihe vastaa tarkasti julkaisijan aihetta
2. QoS-taso: Kokeile QoS 1 tai 2 sijaan 0
3. Jokapäiväiset: Tarkista, että aihejokapäiväiset on käytetty oikein (+ yksitasoinen, # monitasoinen)
4. Pidätetyt viestit: Julkaisija voi asettaa retain-lipun viimeisen viestin säilyttämiseksi
5. Yhteyden aikataulu: Varmista, että tilaaja yhdistää ennen viestien julkaisua

---

Anturi- ja toimilaiteongelmat

Grove-anturit

Ongelma: Anturi palauttaa virheellisiä arvoja

Oireet: Lukemat ovat 0, -1 tai järjettömiä arvoja

Ratkaisu:

1. Tarkista liitännät: Varmista, että anturi on oikein liitetty
2. Oikea portti: Varmista, että anturi on oikeantyyppisessä portissa:
   • Analogiset anturit → Analogiportit (A0, A2, A4)
   • Digitaaliset anturit → Digitaaliporit (D5, D16, D18 jne.)
   • I2C-anturit → I2C-portit
3. Kalibrointi: Jotkin anturit tarvitsevat kalibrointia (maankosteus, valo)
4. Virta pois/päällä: Irrota ja liitä anturi uudelleen
5. Anturin tekniset tiedot: Tarkista anturin speksit ja vaatimukset

Ongelma: Kapasitiivinen maankosteusanturi mittaa aina märkää

Oireet: Anturi mittaa korkean kosteuden myös kuivana

Ratkaisu:

1. Kalibrointi tarvitaan: Maankosteusanturit vaativat kalibroinnin:
   • Lue arvo ilmassa (kuiva nollataso)
   • Lue arvo vedessä (märkä taso)
   • Karttaa lukemat näiden välillä
2. Tarkista anturin pinnoite: Kosteusanturit voivat vahingoittua, jos pinnoite vaurioituu
3. Sijoitus: Varmista, että anturi on kokonaan upotettu maahan

Ongelma: Lämpötila/kosteusanturin lukemat virheellisiä

Oireet: DHT11/DHT22 näyttää väärää lämpötilaa tai kosteutta

Ratkaisu:

1. Anturin sijoitus: Vältä suoraa auringonvaloa, lämmönlähteitä tai ilmavirtauksia
2. Lämmittelyaika: Anna anturin lämmetä 2 sekuntia virran kytkemisen jälkeen ennen lukemista
3. Lukemisväli: DHT-anturit tarvitsevat vähintään 2 sekunnin välin lukemien välillä
4. Tarkista kondensaatio: Se voi vaikuttaa lukemiin
5. Anturin laatu: DHT11 on vähemmän tarkka kuin DHT22

Kamera

Ongelma: Kameraa ei havaita Raspberry Pi:ssä

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

Ratkaisu:

1. Ota kamera käyttöön:

   sudo raspi-config
   

   Mene Interface Options → Camera → Enable
2. Tarkista nauhapiuha: Varmista, että kameran kaapeli on oikein liitetty
   • Sininen puoli kohtaa USB-portit Pi Zero:ssa
   • Sininen puoli poispäin USB-porteista Pi 4:ssä
3. Päivitä laiteohjelmisto:

   sudo apt update
   sudo apt full-upgrade
   sudo reboot
   

4. Testaa kamera:

   raspistill -o test.jpg
   

Ongelma: Kameran kuvat ovat huonolaatuisia

Oireet: Epätarkat, tummat tai haaleat kuvat

Ratkaisu:

1. Tarkennus: Poista suojaava kalvo linssistä, säädä tarkennusta jos mahdollista
2. Valaistus: Varmista riittävä valaistus
3. Kameran asetukset: Säädä valotusta, ISO-arvoa, valkotasapainoa koodissa
4. Vakavuus: Pidä kamera paikallaan, käytä jalustaa tarvittaessa
5. Resoluutio: Älä ylitä kameran maksimiresoluutiota

Mikrofoni ja kaiutin

Ongelma: Ei ääniinputtia/outputtia

Oireet: Mikrofoni ei tallenna, kaiutin ei soita

Ratkaisu:

1. Tarkista liitännät: Varmista, että äänilaitteet ovat oikein kytketty
2. Testaa laitteisto:
   • Kaiutin: speaker-test -t wav -c 2
   • Mikrofoni: arecord -l listaa, arecord test.wav tallentaa
3. Äänenvoimakkuusasetukset: Tarkista ja säädä äänenvoimakkuutta:

   alsamixer
   

4. Valitse äänilaite: Määritä oikea laite koodissa
5. Ajuriongelmat: Päivitä ALSA tai asenna uudelleen ääniajurit

Ongelma: ReSpeaker-hattu ei toimi

Oireet: Äänilaite ei havaittu

Ratkaisu:

1. Asenna ajurit:

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

2. Tarkista asennus: arecord -l pitäisi näyttää ReSpeaker
3. Päivitä laiteohjelmisto: Joissakin Pi OS -versioissa tarvitaan ajuripäivityksiä
4. Tarkista kiinnitys: Varmista, että hattu on kunnolla kiinni GPIO-pinnoissa

---

Kehitysympäristöongelmat

VS Code

Ongelma: Pääte ei aktivoi virtuaaliympäristöä automaattisesti

Oireet: Pääte avautuu, mutta venv ei ole päällä

Ratkaisu:

1. Valitse Python-tulkki: Komentopaletti → "Python: Select Interpreter" → Valitse venv
2. Käynnistä VS Code uudelleen valinnan jälkeen
3. Tarkista asetukset: Lisää settings.json-tiedostoon:

   "python.terminal.activateEnvironment": true
   

Ongelma: Koodi ei suoritu laitteella

Oireet: Koodi pyörii, mutta laitteella ei tapahdu mitään

Ratkaisu:

1. Varmista, että koodi on tallennettu (tarkista piste tiedostovälilehdellä)
2. Tarkista, mikä Python ajetaan: which python tai where python
3. Wio Terminalilla: Varmista, että koodi on ladattu PlatformIO:n kautta (paina latauspainiketta)
4. Raspberry Pi: SSH:lla Pi:hin ja suorita koodi siellä
5. Tarkista tulosteikkuna virheiden varalta

Ongelma: IntelliSense ei näytä kirjastofunktioita

Oireet: Ei automaattista täydennystä tuoduille moduuleille

Ratkaisu:

1. Varmista kirjaston asennus nykyiseen ympäristöön
2. Lataa VS Code -ikkuna uudelleen
3. Tarkista Python-tulkin oikeellisuus
4. Asenna tyypityspaketit, jos saatavilla: pip install types-<library-name>

Pythonin virtuaaliympäristöt

Ongelma: Virtuaaliympäristön luonti epäonnistuu

Virhe: The virtual environment was not created successfully

Ratkaisu:

1. Asenna venv-moduuli:
   • Ubuntu/Debian: sudo apt install python3-venv
   • macOS: Sisältyy Pythonin mukana
   • Windows: Asenna Python uudelleen kaikkine osineen
2. Tarkista Pythonin asennus: Varmista, että Python on oikein asennettu
3. Käytä täyttä polkua: Kokeile python3 -m venv .venv käyttäen eksplisiittistä python3-kutsua

Ongelma: Pakettille asennetaan väärä sijainti

Oireet: Import-virhe paketista asennuksen jälkeen

Ratkaisu:

1. Varmista, että venv on päällä: Komentorivillä näkyy (.venv)
2. Tarkista pipin sijainti: which pip osoittaa .venv/bin/pip
3. Asenna uudelleen venvissä: Aktivoi venv ja aja pip install <package>
4. Älä käytä sudoa pipin kanssa virtuaaliympäristössä

Ongelma: Virtuaaliympäristö ei ole siirrettävissä

Oireet: Venv ei toimi siirron tai eri tietokoneen jälkeen

Ratkaisu:

1. Älä siirrä venv:iä: Poista ja luo uudelleen oikeassa paikassa
2. Käytä requirements.txt:

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

3. Luo venv uudelleen:

   python3 -m venv .venv
   source .venv/bin/activate  # tai activate.bat Windowsilla
   pip install -r requirements.txt
   

Riippuvuudet

Ongelma: Paketin asennus epäonnistuu

Virhe: Erilaisia pip-virheitä asennuksen aikana

Ratkaisu:

1. Päivitä pip:

   pip install --upgrade pip
   

2. Asenna build-työkalut:
   • Ubuntu/Debian: sudo apt install build-essential python3-dev
   • macOS: xcode-select --install
   • Windows: Asenna Visual Studio Build Tools
3. Tarkista internet-yhteys
4. Kokeile eri pakettivarastoa: pip install --index-url https://pypi.org/simple/ <package>
5. Asenna tietty versio: pip install <package>==<version>

Ongelma: Riippuvuuksien ristiriidat

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

Ratkaisu:

1. Käytä uutta virtuaaliympäristöä projektia kohden
2. Päivitä paketit: pip install --upgrade <package>
3. Tarkista vaatimukset: Käytä pip check ristiriitojen löytämiseen
4. Asenna yhteensopivat versiot: Määritä versioalueet requirements.txt:ssä

---

Suorituskykyongelmat

Ongelma: Koodi toimii hitaasti

Oireet: Viiveet, aikakatkaisut, reagoimattomuus

Ratkaisu:

1. Vähennä sensorin lukemistiheyttä: Älä lue antureita liian usein
2. Optimoi silmukat: Vältä turhaa odotusta, käytä sleep()-funktiota tai viiveitä
3. Muisti:
   • Sulje tarpeettomat sovellukset
   • Vapauta levytilaa
   • Seuraa tilaa top tai htop -komennolla Pi:llä
4. SD-kortin nopeus: Käytä nopeampaa SD-korttia tai SSD:tä Raspberry Pi:lle
5. Verkkoviiveet: Käytä asynkronisia toimintoja verkkokutsuissa

Ongelma: Muistin loppuminen

Virhe: MemoryError tai järjestelmän jäätyminen

Ratkaisu:

1. Raspberry Pi:
   • Sulje tarpeettomat sovellukset
   • Lisää swap-tilaa
   • Käytä kevyttä käyttöjärjestelmää (Lite-versio)
   • Päivitä muisti (Pi 4:ssä 2/4/8 Gt vaihtoehdot)
2. Wio Terminal:
   • Pienennä puskurikokoja
   • Käytä pienempiä kuvia
   • Optimoi merkkijonojen käyttö
   • Etsi muistivuotoja (vapautumattomia muisteja)

Ongelma: Tietojen menetys tai vioittuminen

Oireet: Viestit puuttuvat, tiedostot vioittuneet

Ratkaisu:

1. SD-korttiongelmat:
   • Käytä laadukkaita SD-kortteja (vältä halpoja/väärennöksiä)
   • Tee säännöllisiä varmuuskopioita
   • Käynnistä laite puhtaasti (älä katkaise virtaa äkillisesti)
2. Puskuriylivuoto: Kasvata puskureita koodissa
3. Verkon luotettavuus: Toteuta uudelleenyritys- ja virheenkäsittelylogiikka
4. Palvelun laatu: Käytä MQTT QoS 1 tai 2 tärkeitä viestejä varten

---

Yleiset virheilmoitukset

ModuleNotFoundError: No module named 'X'

Syy: Pakettia ei ole asennettu tai virtuaaliympäristö ei ole päällä

Ratkaisu:

pip install X

Varmista, että virtuaaliympäristö on ensin aktivoitu.

Permission denied Linux/macOS -järjestelmissä

Syy: Tarvitaan korotettuja oikeuksia tai tiedostolistaloikeusongelma

Ratkaisu:

• Järjestelmätoiminnoissa käytä sudo
• PIP:iä käytettäessä ÄLÄ käytä sudoa venvissä, aktivoi venv ensin
• Sarjaporttia varten lisää käyttäjä dialout-ryhmään: sudo usermod -a -G dialout $USER, sitten ulos/loggaudu sisään

OSError: [Errno 98] Address already in use

Syy: Portti on jo käytössä toisessa prosessissa

Ratkaisu:

1. Etsi porttia käyttävä prosessi: lsof -i :<port> tai netstat -ano | findstr :<port>
2. Lopeta prosessi tai käytä eri porttia koodissasi

SSL: CERTIFICATE_VERIFY_FAILED

Syy: SSL-varmenteen tarkistus epäonnistui

Ratkaisu:

1. Päivitä varmenteet: pip install --upgrade certifi
2. Tarkista järjestelmän aika on oikein: date
3. Vain kehityskäytössä (ei tuotannossa): Poista tarkistus käytöstä koodissa

IndentationError: unexpected indent

Syy: Pythonin sisennysongelmat (välilehtien ja välilyöntien sekoitus)

Ratkaisu:

1. Käytä yhtenäistä sisennystä (4 välilyöntiä on Pythonin standardi)
2. Säädä editori käyttämään välilyöntejä tabulaattorien sijaan
3. VS Code: Aseta "editor.insertSpaces": true ja "editor.tabSize": 4

UnicodeDecodeError tai UnicodeEncodeError

Syy: Merkkikoodausongelmat

Ratkaisu:

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

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

---

Avun hakeminen

Jos olet kokeillut näitä vianmääritysvaiheita ja sinulla on edelleen ongelmia:

1. Tarkista olemassa olevat resurssit

• Dokumentaatio: Tutustu README -tiedostoon ja oppitunteihin
• Laitteisto-oppaat: Katso hardware.md laitekohtaisia tietoja
• Seeed Studio Wiki: Seeed Studio Wiki Grove-komponenteille

2. Etsi samankaltaisia ongelmia

• GitHub-ongelmat: Etsi olemassa olevia ongelmia
• Stack Overflow: Etsi virheilmoituksia
• Laitefoorumit: Tarkista Raspberry Pi -foorumit tai Arduino-foorumit

3. Luo GitHub-ongelma

Jos et löydä ratkaisua:

1. Mene GitHub Issues
2. Klikkaa "New Issue"
3. Anna:
   • Selkeä kuvaus ongelmasta
   • Askeleet ongelman toistamiseen
   • Virheilmoitukset (kokoteksti)
   • Laitteisto-/ohjelmistoversiot
   • Mitä olet jo kokeillut
   • Kuvakaappaukset, jos tarpeen

4. Liity yhteisöön

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

5. Toimita hyvät bugiraportit

Hyvä bugiraportti sisältää:

• Ympäristö: Käyttöjärjestelmä, Python-versio, käytetty laitteisto
• Vaiheet ongelman toistamiseksi: Tarkat vaiheet, jotka aiheuttavat ongelman
• Odotettu käyttäytyminen: Mitä pitäisi tapahtua
• Todellinen käyttäytyminen: Mitä todellisuudessa tapahtuu
• Virheilmoitukset: Koko virheteksti, ei kuvakaappauksia
• Koodi: Minimiesimerkki koodista, joka toistaa ongelman

---

Vinkkejä ennaltaehkäisyyn

Yleiset parhaat käytännöt

1. Pidä varmuuskopiot: Säännölliset varmuuskopiot toimivista SD-korteista/koodista
2. Dokumentoi muutokset: Merkitse kommentteihin, mikä toimii
3. Versiohallinta: Käytä git:iä koodimuutosten seuraamiseen
4. Testaa inkrementaalisesti: Testaa pieniä muutoksia ennen yhdistämistä
5. Lue virheilmoitukset: Ne kertovat usein tarkalleen, mikä on vialla
6. Päivitä säännöllisesti: Pidä ohjelmisto/laiteohjelmisto ajan tasalla
7. Käytä laadukkaita komponentteja: Vältä halpoja kaapeleita/virtalähteitä
8. Vakaa virransyöttö: Käytä sopivaa virtalähdettä (erityisesti Pi:n kohdalla)

Kehityksen työnkulku

1. Aloita yksinkertaisesti: Käynnistä toimivasta esimerkkikoodista
2. Yksi muutos kerrallaan: Helpompi löytää, mikä rikkoo toiminnan
3. Testaa usein: Havaitse ongelmat ajoissa
4. Pidä siisti: Järjestä tiedostot ja koodi loogisesti
5. Kommentoi koodi: Tuleva sinä kiittää

---

Tätä vianmääritysohjetta ylläpitää yhteisö. Jos löydät ratkaisun ongelmaan, jota ei ole täällä listattu, harkitse osallistumista auttaaksesi muita!

---

Vastuuvapauslauseke: Tämä asiakirja on käännetty tekoälykäännöspalvelulla Co-op Translator. Vaikka pyrimme tarkkuuteen, otathan huomioon, että automaattikäännöksissä saattaa esiintyä virheitä tai epätarkkuuksia. Alkuperäistä asiakirjaa sen alkuperäiskielellä tulee pitää lopullisena lähteenä. Tärkeiden tietojen osalta suositellaan ammattimaista ihmiskäännöstä. Emme ole vastuussa tämän käännöksen käytöstä aiheutuvista väärinymmärryksistä tai virhetulkinoista.