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.
2.8 KiB
2.8 KiB
Guia de Resolução de Problemas do Raspberry Pi
Este guia fornece soluções para problemas comuns encontrados ao executar projetos de IoT em dispositivos Raspberry Pi.
É destinado a iniciantes que seguem o currículo IoT-For-Beginners, mas também é útil para desenvolvimento geral em Pi.
1. Erros de Instalação e Dependências
❗ ModuleNotFoundError: No module named 'xyz'
Isto acontece quando os módulos Python necessários não estão instalados.
Solução
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 as traduções automáticas podem conter erros ou imprecisões. O documento original na sua língua nativa deve ser considerado a fonte autoritativa. Para informações críticas, recomenda-se a tradução profissional realizada por humanos. Não nos responsabilizamos por quaisquer mal-entendidos ou interpretações incorretas decorrentes da utilização desta tradução.
<!-- CO-OP TRANSLATOR DISCLAIMER END -->