You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
IoT-For-Beginners/translations/pt-BR/docs/troubleshooting.md

89 lines
2.8 KiB

# Guia de Solução de Problemas do Raspberry Pi
Este guia fornece soluções para problemas comuns encontrados ao executar projetos de IoT em dispositivos Raspberry Pi.
Ele é projetado para iniciantes que seguem o currículo IoT-For-Beginners, mas também é útil para desenvolvimento geral com Pi.
---
## 1. Erros de Instalação e Dependências
### ❗ `ModuleNotFoundError: No module named 'xyz'`
Isso acontece quando módulos Python necessários não estão instalados.
**Correção**
```bash
pip3 install <module_name>
Permission denied when running scripts
Often caused by accessing GPIO, I2C or system hardware without elevated privileges.
Quick fix:
sudo python3 script.py
Recommended fix (no sudo needed every time):
sudo usermod -aG gpio,i2c,spi $USER
sudo reboot
2. GPIO / I2C / SPI Not Working
❗ RuntimeError: No access to GPIO
Add user to GPIO group:
sudo usermod -aG gpio $USER
sudo reboot
❗ I2C / SPI devices not detected
Enable interfaces:
sudo raspi-config
→ Interface Options
→ Enable I2C / Enable SPI
Check if I2C device appears:
i2cdetect -y 1
3. Camera / Video Issues
❗ Camera not detected or fails to start
Enable camera interface:
sudo raspi-config
→ Interface Options → Camera → Enable
sudo reboot
Check if camera is visible:
vcgencmd get_camera
4. Wi-Fi / SSH / Connectivity Problems
| Problem | Fix |
| -------------------------------- | --------------------------------------------- |
| SSH connection refused | `sudo raspi-config → Interface Options → SSH` |
| Device not showing on network | Check IP using: `hostname -I` |
| Slow Wi-Fi / unstable connection | Prefer 2.4 GHz band, update OS |
| Unable to access Pi headless | Add `ssh` file to boot partition |
5. Performance Issues
Raspberry Pi running slow / laggy
Close unused applications
Reduce background services
Use Lite OS if no desktop needed
Ensure sufficient power supply (5V/3A or better)
Check CPU load:
top
htop
Storage issues:
sudo apt autoremove
sudo apt clean
df -h
---
<!-- CO-OP TRANSLATOR DISCLAIMER START -->
**Aviso Legal**:
Este documento foi traduzido utilizando o serviço de tradução automática [Co-op Translator](https://github.com/Azure/co-op-translator). Embora nos esforcemos para garantir a precisão, esteja ciente de que traduções automáticas podem conter erros ou imprecisões. O documento original em seu idioma original deve ser considerado a fonte oficial. Para informações críticas, recomenda-se a tradução profissional realizada por um tradutor humano. Não nos responsabilizamos por quaisquer mal-entendidos ou interpretações incorretas decorrentes do uso desta tradução.
<!-- CO-OP TRANSLATOR DISCLAIMER END -->