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

Ghid de depanare

Acest ghid te ajută să rezolvi probleme comune când lucrezi cu curriculumul IoT for Beginners. Problemele sunt organizate pe categorii pentru o navigare ușoară.

Cuprins

• Probleme de instalare
  • Instalarea Python
  • VS Code și extensii
  • PlatformIO (Wio Terminal)
  • Biblioteci Grove
• Probleme hardware
  • Raspberry Pi
  • Wio Terminal
  • Dispozitiv virtual (CounterFit)
• Probleme de conectivitate
  • Conexiune WiFi
  • Servicii cloud
  • MQTT
• Probleme cu senzori și actuatori
  • Senzori Grove
  • Camera
  • Microfon și difuzor
• Probleme de mediu de dezvoltare
  • VS Code
  • Mediile virtuale Python
  • Dependențe
• Probleme de performanță
• Mesaje de eroare comune
• Obținerea ajutorului

---

Probleme de instalare

Instalarea Python

Problemă: Versiunea Python este prea veche

Eroare: Python 3.6 sau o versiune mai nouă este necesară

Soluție:

1. Descarcă cea mai nouă versiune Python 3 de pe python.org
2. La instalare pe Windows, bifează opțiunea "Add Python to PATH"
3. Verifică instalarea:

   python3 --version
   

Problemă: Mai multe versiuni Python cauzează conflicte

Simptome: Rulează o versiune greșită de Python, pachetele se instalează în locația greșită

Soluție:

• Windows: Folosește py -3 în loc de python pentru a apela explicit Python 3
• macOS/Linux: Folosește python3 în loc de python
• Creează și folosește întotdeauna medii virtuale pentru proiecte

Problemă: Comanda pip nu este recunoscută

Eroare: 'pip' nu este recunoscut ca o comandă internă sau externă

Soluție:

1. Încearcă pip3 în loc de pip
2. Sau folosește python -m pip sau python3 -m pip
3. Asigură-te că Python este adăugat în PATH (reinstalează Python și bifează opțiunea)

VS Code și extensii

Problemă: Extensia Pylance nu funcționează

Simptome: Lipsă IntelliSense pentru Python, completare de cod sau verificare de tipuri

Soluție:

1. Deschide Paleta de comenzi VS Code (Ctrl+Shift+P sau Cmd+Shift+P)
2. Rulează "Python: Select Interpreter"
3. Alege interpretul Python corect (mediu virtual dacă folosești unul)
4. Reîncarcă fereastra VS Code

Problemă: VS Code nu detectează mediul virtual

Simptome: Interpretul Python greșit selectat

Soluție:

1. Asigură-te că ai activat mediul virtual în terminal
2. Deschide Paleta de comenzi și rulează "Python: Select Interpreter"
3. Selectează interpretul din folderul .venv
4. Verifică dacă bara de stare (colț stânga jos) afișează versiunea corectă de Python

PlatformIO (Wio Terminal)

Problemă: Instalarea PlatformIO eșuează

Eroare: Diverse erori în timpul instalării PlatformIO

Soluție:

1. Asigură-te că VS Code este actualizat
2. Instalează mai întâi extensia C/C++
3. Repornește VS Code după instalarea PlatformIO
4. Verifică conexiunea la internet (PlatformIO descarcă fișiere mari)

Problemă: Placa nu este detectată de PlatformIO

Simptome: Nu poți încărca cod pe Wio Terminal

Soluție:

1. Încearcă un alt cablu USB (unele cabluri sunt doar pentru încărcare)
2. Verifică Device Manager (Windows) sau ls /dev/tty* (macOS/Linux)
3. Instalează sau actualizează driverele USB
4. Încearcă un alt port USB
5. Glisează comutatorul de alimentare de pe Wio Terminal de două ori rapid pentru a intra în modul bootloader

Problemă: Erori de compilare în PlatformIO

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

Soluție:

1. Șterge folderul .pio din proiectul tău
2. Rulează "PlatformIO: Rebuild" din Paleta de comenzi
3. Asigură-te că fișierul platformio.ini are configurația corectă pentru placa ta:

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

Biblioteci Grove

Problemă: Importul bibliotecii Grove eșuează pe Raspberry Pi

Eroare: ModuleNotFoundError: No module named 'grove'

Soluție:

1. Reinstalează bibliotecile Grove:

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

2. Dacă folosești mediu virtual, poate fi necesar să instalezi global sau să copiezi bibliotecile
3. Verifică dacă I2C este activat: sudo raspi-config nonint do_i2c 0

Problemă: Senzor Grove nu este detectat

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

Soluție:

1. Verifică conexiunile fizice (asigură-te că cablul Grove este introdus complet)
2. Verifică dacă senzorul este conectat la portul corect (analog, digital, I2C, UART)
3. Rulează i2cdetect -y 1 pentru a vedea dacă dispozitivul apare pe magistrala I2C
4. Încearcă un alt cablu Grove
5. Asigură-te că Grove Base Hat este bine fixat pe pini GPIO de pe Raspberry Pi

---

Probleme hardware

Raspberry Pi

Problemă: Raspberry Pi nu pornește

Simptome: Nu apare imagine, LED-urile nu se aprind sau apare ecran curcubeu

Soluție:

1. Verifică alimentarea: Folosește adaptorul oficial de 5V 3A USB-C pentru Pi 4
2. Probleme cu cardul SD:
   • Reformatează cardul SD și reinstalează Raspberry Pi OS
   • Încearcă un alt card SD (folosește mărci recomandate)
   • Asigură-te că cardul SD este introdus corespunzător
3. Verifică conexiunea HDMI: Încearcă ambele porturi HDMI de pe Pi 4, folosește portul HDMI cel mai aproape de alimentare

Problemă: Nu poți face SSH către Raspberry Pi

Simptome: Conexiunea este refuzată sau expiră timpul de așteptare

Soluție:

1. Activează SSH:
   • La scrierea cardului SD cu Raspberry Pi Imager, configurează SSH în opțiunile avansate
   • Sau creează un fișier gol numit ssh (fără extensie) în partiția de boot
2. Găsește adresa IP a Pi-ului:
   • Verifică dispozitivele conectate pe router
   • Folosește ping raspberrypi.local (dacă funcționează mDNS)
   • Folosește un scaner de rețea ca nmap sau Angry IP Scanner
3. Verifică rețeaua:
   • Asigură-te că Pi este în aceeași rețea cu calculatorul tău
   • Încearcă conexiune prin ethernet în loc de WiFi
4. Verifică numele de utilizator/parola (implicit: utilizator pi, parolă raspberry)

Problemă: Grove Base Hat nu este recunoscut

Simptome: Senzorii nu funcționează, apar erori I2C

Soluție:

1. Asigură-te că Base Hat este bine fixat pe toți pinii GPIO
2. Verifică dacă există pini îndoiți pe Pi sau pe Base Hat
3. Activează interfața I2C:

   sudo raspi-config nonint do_i2c 0
   sudo reboot
   

4. Verifică funcționarea I2C: i2cdetect -y 1

Problemă: Raspberry Pi rulează încet

Simptome: Interfață lentă, răspuns întârziat

Soluție:

1. Verifică viteza cardului SD (folosește Clasa 10 sau mai bun, sau SSD via USB)
2. Eliberează spațiu pe disc: df -h pentru verificare, șterge fișiere inutile
3. Redu memoria GPU în raspi-config dacă nu folosești intens camera sau ecranul
4. Închide aplicațiile nefolositoare
5. Ia în considerare upgrade la Pi 4 cu mai mult RAM dacă folosești Pi 3 sau mai vechi

Wio Terminal

Problemă: Ecranul Wio Terminal rămâne negru

Simptome: Nu apare niciun afișaj după încărcarea codului

Soluție:

1. Verifică dacă codul inițializează afișajul (biblioteca TFT_eSPI)
2. Actualizează firmware-ul Wio Terminal de pe Seeed Wiki
3. Adaugă cod pentru inițializarea afișajului:

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

4. Încearcă să încarci un sketch exemplu din PlatformIO pentru a testa hardware-ul

Problemă: WiFi nu funcționează pe Wio Terminal

Simptome: Nu se conectează la WiFi, apar erori de rețea

Soluție:

1. Actualizează firmware-ul WiFi: Urmează ghidul de actualizare firmware WiFi pentru Wio Terminal
2. Verifică datele WiFi: Confirmă că SSID și parola sunt corecte
3. Bandă WiFi: Wio Terminal suportă doar 2.4GHz (nu 5GHz)
4. Putere semnal: Mutați-l mai aproape de router
5. Setările routerului: Unele rețele enterprise/WPA-Enterprise pot să nu funcționeze

Problemă: Wio Terminal nu este recunoscut de calculator

Simptome: Dispozitivul USB nu este detectat

Soluție:

1. Încearcă alt cablu USB: Folosește cablu de date, nu doar cablu de încărcare
2. Intră în modul bootloader: Glisează comutatorul de alimentare în jos de două ori rapid
   • LED-ul albastru ar trebui să pulseze, dispozitivul apare ca "Arduino" în Device Manager
3. Instalează driverele (Windows):
   • Descarcă și instalează driverul USB Seeed
4. Încearcă alt port USB: Evită hub-uri USB, conectează direct
5. Actualizează driverele USB ale sistemului

Problemă: Senzorii nu funcționează pe Wio Terminal

Simptome: Senzorii Grove nu citesc date

Soluție:

1. Verifică conexiunile cablului Grove
2. Confirmă că folosești portul Grove corect (stânga sau dreapta)
3. Include bibliotecile corecte pentru senzor
4. Verifică cerințele de alimentare ale senzorului
5. Testează senzorul cu cod exemplu din bibliotecă

Dispozitiv virtual (CounterFit)

Problemă: Aplicația CounterFit nu pornește

Eroare: Diverse erori Python la pornirea CounterFit

Soluție:

1. Asigură-te că mediul virtual este activat
2. Instalează/reinstalează CounterFit:

   pip install CounterFit
   

3. Verifică dacă portul 5000 nu este deja folosit:
   • Windows: netstat -ano | findstr :5000
   • macOS/Linux: lsof -i :5000
4. Oprește procesul ce folosește portul 5000 sau folosește un port diferit:

   counterfit --port 5001
   

Problemă: Nu te poți conecta la CounterFit din cod

Eroare: Conexiune refuzată sau timeout

Soluție:

1. Verifică dacă CounterFit rulează: deschide browserul la http://127.0.0.1:5000
2. Confirmă că URL-ul de conexiune din cod corespunde adresei CounterFit
3. Asigură-te că firewall-ul nu blochează conexiunea
4. Încearcă să repornești atât aplicația CounterFit cât și codul tău

Problemă: Senzorii nu apar în CounterFit

Simptome: Senzorii creați nu apar în interfața CounterFit

Soluție:

1. Creează senzorii în interfața CounterFit înainte de a rula codul
2. Reîncarcă pagina în browser
3. Verifică dacă tipul senzorului corespunde cu ce așteaptă codul
4. Șterge memoria cache a browserului

---

Probleme de conectivitate

Conexiune WiFi

Problemă: Dispozitivul nu se conectează la WiFi

Simptome: Timeout conexiune, autentificare eșuată

Soluție:

1. Verifică SSID și parola: Confirmă că sunt corecte
2. Bandă WiFi: Majoritatea dispozitivelor IoT suportă doar 2.4GHz (nu 5GHz)
3. Setările routerului:
   • Dezactivează izolarea AP dacă este activată
   • Folosește securitate WPA2-PSK (evită WPA3, WEP sau rețele deschise)
   • Asigură-te că DHCP este activat
4. Rețele ascunse: Dacă SSID este ascuns, trebuie configurat explicit
5. Puterea semnalului: Mută dispozitivul mai aproape de router
6. Interferențe: Alte dispozitive, cuptoare cu microunde sau pereți pot cauza interferențe

Problemă: Conexiunea WiFi cade frecvent

Simptome: Conectivitate intermitentă

Soluție:

1. Verifică stabilitatea routerului și ia în considerare un restart
2. Actualizează firmware-ul dispozitivului
3. Folosește o adresă IP statică în loc de DHCP
4. Redu distanța față de router sau adaugă un extender WiFi
5. Verifică interferențele de la alte dispozitive
6. Asigură alimentarea adecvată (în special pentru Raspberry Pi)

Servicii cloud

Problemă: Nu poți să te conectezi la Azure IoT Hub

Eroare: Autentificare eșuată, conexiune refuzată

Soluție:

1. Verifică acreditările:
   • Verifică dacă stringul de conexiune este corect
   • Asigură-te că nu există spații sau întreruperi de linie în stringul de conexiune
2. Verifică înregistrarea dispozitivului: Dispozitivul trebuie să fie înregistrat în IoT Hub
3. Firewall/proxy: Permite traficul outbound MQTT (port 8883) sau HTTPS (port 443)
4. Regiunea IoT Hub: Asigură-te că IoT Hub rulează și nu este într-o regiune diferită ce cauzează latență
5. Limitele de cotă: Verifică dacă limita nivelului gratuit este depășită
6. Testează conexiunea:

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

Problemă: Azure Functions nu se declanșează

Simptome: Mesajele sunt trimise, dar funcția nu execută

Soluție:

1. Verifică că Function App este pornit (nu oprit)
2. Verifică stringul de conexiune în setările Function App
3. Consultă jurnalele de funcții în portalul Azure
4. Asigură-te că endpoint-ul compatibil cu Event Hub este configurat corect
5. Verifică dacă formatul mesajelor corespunde așteptărilor funcției
6. Verifică planul de serviciu Function App (consum sau dedicat)

MQTT

Problemă: Conexiunea MQTT eșuează

Eroare: Conexiune refuzată, autentificare eșuată

Soluție:

1. Adresa broker-ului: Verificați dacă URL-ul/IP-ul broker-ului este corect
2. Port: Verificați numărul portului (1883 pentru necriptat, 8883 pentru TLS)
3. Autentificare: Verificați username-ul/parola dacă este necesar
4. TLS/SSL: Asigurați-vă că certificatele sunt valide și de încredere
5. Firewall: Verificați dacă portul nu este blocat
6. Testați cu client MQTT: Folosiți MQTT Explorer sau mosquitto_pub/sub pentru testare

Problemă: Mesajele MQTT nu sunt primite

Simptome: Mesajele sunt publicate, dar nu sunt primite de abonați

Soluție:

1. Numele topicurilor: Verificați dacă topicul abonatului corespunde exact cu topicul editorului
2. Nivel QoS: Încercați QoS 1 sau 2 în loc de 0
3. Wildcard-uri: Verificați utilizarea corectă a wildcard-urilor în topicuri (+ pentru un singur nivel, # pentru mai multe niveluri)
4. Mesaje reținute: Editorul poate seta flag de retain pentru a păstra ultimul mesaj
5. Timpul conexiunii: Asigurați-vă că abonatul se conectează înainte de publicarea mesajelor

---

Probleme cu Senzori și Actuatori

Senzori Grove

Problemă: Senzorul returnează valori incorecte

Simptome: Citirile sunt 0, -1 sau valori fără sens

Soluție:

1. Verificați conexiunile: Asigurați-vă că senzorul este conectat corect
2. Port corect: Verificați dacă senzorul este în portul corect:
   • Senzori analogici → porturi analogice (A0, A2, A4)
   • Senzori digitali → porturi digitale (D5, D16, D18 etc.)
   • Senzori I2C → porturi I2C
3. Calibrare: Anumiți senzori necesită calibrare (umiditate sol, lumină)
4. Repornire: Deconectați și reconectați senzorul
5. Fișa tehnică: Verificați specificațiile și cerințele senzorului

Problemă: Senzor capacitiv de umiditate a solului indică mereu umed

Simptome: Senzorul indică umiditate ridicată chiar și când solul este uscat

Soluție:

1. Calibrare necesară: Senzorii de sol trebuie calibrați:
   • Citiți valoarea în aer (bază uscată)
   • Citiți valoarea în apă (bază umedă)
   • Maparea citirilor între aceste valori
2. Verificați învelișul senzorului: Senzorii de umiditate pot degrada dacă stratul protector este deteriorat
3. Poziționare: Asigurați-vă că senzorul este introdus complet în sol

Problemă: Citiri incorecte pentru senzor de temperatură/umiditate

Simptome: DHT11/DHT22 afișează temperatură sau umiditate greșită

Soluție:

1. Poziționarea senzorului: Evitați lumina directă a soarelui, sursele de căldură sau curenții de aer
2. Timp de încălzire: Lăsați senzorul 2 secunde după pornire înainte de citire
3. Frecvența citirii: Senzorii DHT necesită cel puțin 2 secunde între citiri
4. Verificați condensul: Poate afecta citirile
5. Calitatea senzorului: DHT11 este mai puțin precis decât DHT22

Cameră

Problemă: Camera nu este detectată pe Raspberry Pi

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

Soluție:

1. Activați interfața camerei:

   sudo raspi-config
   

   Mergeți la Interface Options → Camera → Enable
2. Verificați cablul panglică: Asigurați-vă că cablul camerei este introdus corect
   • Partea albastră către porturile USB pe Pi Zero
   • Partea albastră orientată în direcția opusă porturilor USB pe Pi 4
3. Actualizați firmware-ul:

   sudo apt update
   sudo apt full-upgrade
   sudo reboot
   

4. Testați camera:

   raspistill -o test.jpg
   

Problemă: Imaginile camerei sunt de calitate slabă

Simptome: Imagini neclare, întunecate sau estompate

Soluție:

1. Focalizare: Îndepărtați folia protector de pe lentilă, reglați focalizarea dacă este posibil
2. Iluminare: Asigurați iluminare adecvată
3. Setări cameră: Ajustați expunerea, ISO, balansul de alb în cod
4. Stabilitate: Mențineți camera fixă, folosiți trepied dacă este necesar
5. Rezoluție: Nu depășiți rezoluția maximă a camerei

Microfon și Difuzor

Problemă: Fără intrare/ieșire audio

Simptome: Microfonul nu înregistrează, difuzorul nu redă sunet

Soluție:

1. Verificați conexiunile: Confirmați că dispozitivele audio sunt conectate corect
2. Testați hardware-ul:
   • Difuzor: speaker-test -t wav -c 2
   • Microfon: arecord -l pentru listare, arecord test.wav pentru înregistrare
3. Setări volum: Verificați și ajustați volumul:

   alsamixer
   

4. Selectați dispozitivul audio: Specificați dispozitivul corect în cod
5. Probleme drivere: Actualizați ALSA sau reinstalați driverele audio

Problemă: Placa ReSpeaker nu funcționează

Simptome: Dispozitivul audio nu este detectat

Soluție:

1. Instalați drivere:

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

2. Verificați instalarea: arecord -l ar trebui să listeze ReSpeaker
3. Actualizați firmware-ul: Unele versiuni Pi OS necesită actualizări de drivere
4. Verificați montarea: Asigurați-vă că placa este conectată corect la pinii GPIO

---

Probleme cu Mediul de Dezvoltare

VS Code

Problemă: Terminalul nu activează automat mediul virtual

Simptome: Terminalul se deschide, dar venv nu este activat

Soluție:

1. Setați interpretorul Python: Command Palette → "Python: Select Interpreter" → Alegeți venv-ul
2. Reporniți VS Code după selectarea interpretorului
3. Verificați setările: În settings.json, adăugați:

   "python.terminal.activateEnvironment": true
   

Problemă: Codul nu rulează pe dispozitiv

Simptome: Codul rulează, dar pe dispozitiv nu se întâmplă nimic

Soluție:

1. Verificați dacă codul este salvat (verificați punctul din tab-ul fișier)
2. Verificați Python-ul rulat: which python sau where python
3. Pentru Wio Terminal: Asigurați-vă că codul este încărcat via PlatformIO (click pe butonul upload)
4. Pentru Raspberry Pi: Conectați-vă prin SSH pe Pi și rulați codul acolo
5. Verificați fereastra de output pentru erori

Problemă: IntelliSense nu afișează funcțiile bibliotecii

Simptome: Fără completare automată pentru modulele importate

Soluție:

1. Asigurați-vă că biblioteca este instalată în mediul curent
2. Reîncărcați fereastra VS Code
3. Verificați dacă interpretorul Python este corect
4. Instalați tipurile (type stubs) dacă sunt disponibile: pip install types-<library-name>

Medii virtuale Python

Problemă: Nu poate fi creat mediul virtual

Eroare: The virtual environment was not created successfully

Soluție:

1. Instalați modulul venv:
   • Ubuntu/Debian: sudo apt install python3-venv
   • macOS: Este inclus implicit cu Python
   • Windows: Reinstalați Python cu toate componentele
2. Verificați instalarea Python: Asigurați-vă că Python este instalat corect
3. Folosiți calea completă: Încercați python3 -m venv .venv specificând explicit python3

Problemă: Pachetele se instalează în locație greșită

Simptome: Eroare la import după instalarea pachetului

Soluție:

1. Verificați dacă venv este activat: Prompt-ul ar trebui să arate (.venv)
2. Verificați locația pip: which pip ar trebui să indice .venv/bin/pip
3. Reinstalați în venv: Activați venv-ul, apoi pip install <package>
4. Nu folosiți sudo cu pip în mediul virtual

Problemă: Mediul virtual nu este portabil

Simptome: Venv nu funcționează după mutare sau pe alt calculator

Soluție:

1. Nu mutați venv-urile: Ștergeți și recreați în noua locație
2. Folosiți requirements.txt:

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

3. Recreați venv-ul:

   python3 -m venv .venv
   source .venv/bin/activate  # sau activate.bat pe Windows
   pip install -r requirements.txt
   

Dependențe

Problemă: Instalarea pachetului eșuează

Eroare: Diverse erori pip în timpul instalării

Soluție:

1. Actualizați pip-ul:

   pip install --upgrade pip
   

2. Instalați unelte de compilare:
   • Ubuntu/Debian: sudo apt install build-essential python3-dev
   • macOS: xcode-select --install
   • Windows: Instalați Visual Studio Build Tools
3. Verificați conexiunea la internet
4. Încercați alt index de pachete: pip install --index-url https://pypi.org/simple/ <package>
5. Instalați o versiune specifică: pip install <package>==<version>

Problemă: Conflicte de dependențe

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

Soluție:

1. Folosiți un mediu virtual nou pentru fiecare proiect
2. Actualizați pachetele: pip install --upgrade <package>
3. Verificați cerințele: Folosiți pip check pentru a găsi conflicte
4. Instalați versiuni compatibile: Specificați intervale versionale în requirements.txt

---

Probleme de Performanță

Problemă: Codul rulează lent

Simptome: Întârzieri, timeouts, comportament nefuncțional

Soluție:

1. Reduceți frecvența de citire a senzorilor: Nu citiți senzorii prea des
2. Optimizați buclele: Evitați așteptarea pasivă, folosiți sleep() sau delay-uri
3. Probleme de memorie:
   • Închideți aplicațiile inutile
   • Eliberați spațiu de stocare
   • Monitorizați cu top sau htop pe Pi
4. Viteză SD card: Folosiți card SD mai rapid sau SSD pentru Raspberry Pi
5. Întârzieri de rețea: Folosiți operații asincrone pentru apeluri în rețea

Problemă: Erori de memorie insuficientă

Eroare: MemoryError sau sistemul se blochează

Soluție:

1. Pentru Raspberry Pi:
   • Închideți aplicațiile inutile
   • Măriți spațiul de swap
   • Folosiți o versiune OS mai ușoară (Lite)
   • Faceți upgrade la RAM (Pi 4 are opțiuni 2/4/8GB)
2. Pentru Wio Terminal:
   • Reduceți dimensiunea buffer-elor
   • Folosiți imagini mai mici
   • Optimizați utilizarea string-urilor
   • Verificați pentru scurgeri de memorie (memorie neeliberată)

Problemă: Pierdere sau corupere de date

Simptome: Mesaje lipsă, fișiere corupte

Soluție:

1. Probleme SD card:
   • Folosiți carduri de calitate (evitați cele ieftine/frauduloase)
   • Faceți backup-uri regulate
   • Opriți în mod curat (nu scoateți alimentarea)
2. Overflow buffer: Măriți dimensiunea bufferelor în cod
3. Fiabilitate rețea: Implementați logică de retry și tratare erori
4. Calitatea serviciului: Folosiți MQTT QoS 1 sau 2 pentru mesaje importante

---

Mesaje Comune de Eroare

ModuleNotFoundError: No module named 'X'

Cauză: Pachetul nu este instalat sau mediul virtual nu este activat

Soluție:

pip install X

Asigurați-vă că mediul virtual este activat mai întâi.

Permission denied pe Linux/macOS

Cauză: Necesare permisiuni elevate sau problemă cu permisiunile fișierelor

Soluție:

• Pentru operațiuni de sistem: folosiți sudo
• Pentru pip: NU folosiți sudo cu venv, activați mai întâi venv-ul
• Pentru port serial: adăugați utilizatorul în grupul dialout: sudo usermod -a -G dialout $USER, apoi reconnectați-vă

OSError: [Errno 98] Address already in use

Cauză: Portul este deja utilizat de un alt proces

Soluție:

1. Găsiți procesul care folosește portul: lsof -i :<port> sau netstat -ano | findstr :<port>
2. Închideți procesul sau folosiți alt port în cod

SSL: CERTIFICATE_VERIFY_FAILED

Cauză: Eșec validare certificat SSL

Soluție:

1. Actualizați certificatele: pip install --upgrade certifi
2. Verificați dacă ora sistemului este corectă: date
3. Doar pentru dezvoltare (nu producție): dezactivați verificarea în cod

IndentationError: unexpected indent

Cauză: Probleme cu indentarea în Python (amestecare tab-uri/spații)

Soluție:

1. Folosiți indentare consecventă (4 spații este standardul Python)
2. Configurați editorul să folosească spații în loc de tab-uri
3. VS Code: setați "editor.insertSpaces": true și "editor.tabSize": 4

UnicodeDecodeError sau UnicodeEncodeError

Cauză: Probleme de codare a caracterelor

Soluție:

# Când se citesc fișiere
with open('file.txt', 'r', encoding='utf-8') as f:
    content = f.read()

# Când se scriu fișiere
with open('file.txt', 'w', encoding='utf-8') as f:
    f.write(content)

---

Obținerea Ajutorului

Dacă ați încercat acești pași de depanare și tot aveți probleme:

1. Verificați resursele disponibile

• Documentație: Consultați README și instrucțiunile lecției
• Ghiduri hardware: Verificați hardware.md pentru info specifice hardware-ului
• Seeed Studio Wiki: Seeed Studio Wiki pentru componente Grove

2. Căutați probleme similare

• GitHub Issues: Căutați probleme existente
• Stack Overflow: Căutați mesaje de eroare
• Forumuri dispozitive: Verificați forumurile Raspberry Pi sau Arduino

3. Creați un issue pe GitHub

Dacă nu găsiți o soluție:

1. Mergeți la GitHub Issues
2. Click pe "New Issue"
3. Oferiți:
   • Descriere clară a problemei
   • Pași pentru reproducere
   • Mesaje de eroare (text complet)
   • Versiuni hardware/software
   • Ce ați încercat deja
   • Capturi de ecran, dacă sunt relevante

4. Alăturați-vă comunității

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

5. Oferiți rapoarte bune de bug-uri

Un raport bun include:

• Mediu: OS, versiunea Python, hardware-ul folosit
• Pași pentru reproducere: Pașii exacti care cauzează problema
• Comportament așteptat: Ce ar trebui să se întâmple
• Comportament real: Ce se întâmplă de fapt
• Mesaje de eroare: Textul complet al erorii, nu capturi de ecran
• Cod: Exemplu minimal de cod care reproduce problema

---

Sfaturi pentru prevenire

Practici generale recomandate

1. Păstrează copii de siguranță: Backup-uri regulate ale cardurilor SD/codurilor funcționale
2. Documentează modificările: Notează ce funcționează în comentarii
3. Controlul versiunilor: Folosește git pentru a urmări modificările codului
4. Testează incremental: Testează modificări mici înainte de a le combina
5. Citește mesajele de eroare: De multe ori spun exact ce nu e în regulă
6. Actualizează regulat: Menține software-ul/firmware-ul la zi
7. Folosește componente de calitate: Evită cabluri/alimentări ieftine
8. Alimentare stabilă: Folosește sursă de alimentare adecvată (mai ales pentru Pi)

Flux de lucru în dezvoltare

1. Începe simplu: Pornește de la cod exemplu care funcționează
2. O singură modificare la un moment dat: E mai ușor să identifici ce stric
3. Testează des: Identifică problemele devreme
4. Menține curat: Organizează fișierele și codul logic
5. Comentează codul: Tu, în viitor, o să apreciezi asta

---

Acest ghid de depanare este întreținut de comunitate. Dacă găsești o soluție la o problemă care nu este listată aici, te rugăm să iei în considerare contribuirea pentru a ajuta și alți utilizatori!

---

Declinarea răspunderii:
Acest document a fost tradus utilizând serviciul de traducere AI Co-op Translator. Deși ne străduim pentru acuratețe, vă rugăm să rețineți că traducerile automate pot conține erori sau inexactități. Documentul original, în limba sa nativă, trebuie considerat sursa autoritară. Pentru informații critice, se recomandă traducerea profesională realizată de un specialist uman. Nu ne asumăm răspunderea pentru orice neînțelegeri sau interpretări greșite rezultate din utilizarea acestei traduceri.