|
|
# Raspberry Pi トラブルシューティングガイド
|
|
|
|
|
|
このガイドは、Raspberry Pi デバイスで IoT プロジェクトを実行する際によくある問題の解決策を提供します。
|
|
|
IoT-For-Beginners カリキュラムを学ぶ初心者向けに設計されていますが、一般的な Pi の開発にも役立ちます。
|
|
|
|
|
|
---
|
|
|
|
|
|
## 1. インストールと依存関係のエラー
|
|
|
|
|
|
### ❗ `ModuleNotFoundError: No module named 'xyz'`
|
|
|
これは必要な Python モジュールがインストールされていない場合に発生します。
|
|
|
|
|
|
**修正方法**
|
|
|
```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 -->
|
|
|
**免責事項**：
|
|
|
本書類はAI翻訳サービス[Co-op Translator](https://github.com/Azure/co-op-translator)を使用して翻訳されました。正確性には努めておりますが、自動翻訳には誤りや不正確な表現が含まれる可能性があります。原文の言語によるオリジナル文書が正式な情報源とみなされるべきです。重要な情報については、専門の人間翻訳を推奨いたします。本翻訳の利用により生じたいかなる誤解や解釈違いについても、一切責任を負いかねます。
|
|
|
<!-- CO-OP TRANSLATOR DISCLAIMER END --> |
