rpi-sensor-lib 0.1.0__py3-none-any.whl

rpi_sensor_lib-0.1.0.dist-info/METADATA

@@ -0,0 +1,170 @@
+Metadata-Version: 2.4
+Name: rpi-sensor-lib
+Version: 0.1.0
+Summary: Raspberry Pi用の各種センサー読み取りライブラリ
+Author: Kazuki Kumahata
+License: MIT
+Project-URL: Homepage, https://github.com/Kazuki1729/rpi-sensor-lib
+Project-URL: Issues, https://github.com/Kazuki1729/rpi-sensor-lib/issues
+Keywords: raspberry-pi,sensor,mcp3208,bme280,dht22,mh-z19c,gpio,spi,i2c,uart
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Topic :: System :: Hardware
+Classifier: Intended Audience :: Developers
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: spidev>=3.5
+Requires-Dist: smbus2>=0.4
+Requires-Dist: RPi.bme280>=0.2.4
+Requires-Dist: lgpio>=0.2.2
+Requires-Dist: pyserial>=3.5
+Dynamic: license-file
+
+# rpi_sensors
+
+Raspberry Piに接続された各種センサーやアナログ入出力（ADC）モジュールを、オブジェクト指向でクリーンかつ簡単に操作するためのPythonライブラリです。
+
+チャタリング対策済みの物理ボタン、SPI経由のA/Dコンバータ（MCP3208）を用いたアナログセンサー（照度・音・ジョイスティック・半固定抵抗）、I2C接続の温湿度・気圧センサー（BME280）、GPIO直接駆動の温湿度センサー（DHT22）、UART接続のCO2センサー（MH-Z19C）に幅広く対応しています。環境データの取得からMariaDB等へのロギングといった、IoTシステム開発のベースとして最適です。
+
+---
+
+## 1. 前提条件とハードウェア接続
+
+本ライブラリを使用する前に、Raspberry Pi側で **SPI**, **I2C**, **Serial Port (UART)** が有効化されていることを確認してください（`sudo raspi-config` の `Interface Options` から設定可能）。
+
+### 🔌 ハードウェア接続の標準構成
+
+各モジュール・サンプルのデフォルトのピン配置および接続方法は以下の通りです。
+
+#### 1. SPI通信 (MCP3208 経由のアナログ入力)
+MCP3208はRaspberry Piの標準SPIピン（SPI0）に接続します。
+* **VREF / VDD**: 3.3V
+* **AGND / DGND**: GND
+* **CLK**: GPIO 11 (SCLK)
+* **DOUT**: GPIO 9 (MISO)
+* **DIN**: GPIO 10 (MOSI)
+* **CS/SHDN**: GPIO 8 (CE0)
+
+| MCP3208 チャンネル | 対象モジュール / センサー | 該当クラス |
+| :--- | :--- | :--- |
+| **CH0** | Grove 照度センサー | `GroveLightSensor` |
+| **CH1** | Grove サウンドセンサー | `GroveSoundSensor` |
+| **CH2** | 半固定抵抗 (ポテンショメータ) | `PotentiometerMCP3208` |
+| **CH0 / CH1** (別構成例) | アナログジョイスティック (X軸 / Y軸) | `JoystickMCP3208` |
+
+#### 2. その他のセンサー・コンポーネント (GPIO / I2C / UART)
+
+| センサー名 | 通信規格 | Raspberry Pi 接続ピン (デフォルト) | 該当クラス |
+| :--- | :--- | :--- | :--- |
+| **BME280** | I2C | GPIO 2 (SDA) / GPIO 3 (SCL) <br>※I2Cアドレス: `0x76` (または `0x77`) | `BME280Sensor` |
+| **DHT22** | デジタル単線 | **GPIO 26** | `DHT22` |
+| **MH-Z19C** | UART (シリアル) | GPIO 14 (TXD) / GPIO 15 (RXD) <br>※デバイスファイル: `/dev/serial0` | `MHZ19C` |
+| **タクタイルボタン** | デジタル入力 | **GPIO 17** (内蔵プルアップ使用、GND接続) | `TactileButton` |
+
+---
+
+## 2. インストール方法
+
+### 📦 リモート（GitHub）からの直接インストール
+GitHubリポジトリから直接 `pip` を使用して、依存関係（`lgpio`, `spidev`, `smbus2`, `RPi.bme280`, `pyserial`）ごと一括インストールします。
+
+```bash
+pip install git+https://github.com/Kazuki1729/rpi-sensor-lib.git(https://github.com/kazuki1729/rpi-sensor-lib.git)
+
+## 3. 使い方（クイックスタート）
+
+すべてのクラスは `with` 文に対応しており、ブロックを抜けると自動で `close()` されます。
+
+### 照度 / サウンドセンサー（Grove + MCP3208）
+```python
+from rpi_sensors import GroveLightSensor, GroveSoundSensor
+
+with GroveLightSensor(channel=0) as light, GroveSoundSensor(channel=1) as sound:
+    print(light.read_raw())      # 0〜4095 の生値
+    print(light.read_voltage())  # 電圧(V)
+    print(light.read_ratio())    # 0.0〜1.0
+    print(sound.read_raw())
+```
+
+### ジョイスティック（MCP3208）
+```python
+from rpi_sensors import JoystickMCP3208
+
+with JoystickMCP3208(deadzone=150) as joy:
+    x, y = joy.read_xy(ch_x=2, ch_y=3, normalize=True)  # -1.0〜1.0
+    print(x, y)
+```
+
+### 半固定抵抗（ポテンショメータ）
+```python
+from rpi_sensors import PotentiometerMCP3208
+
+with PotentiometerMCP3208(channel=4) as pot:
+    print(pot.read_percentage())  # 0.0〜100.0 %
+    print(pot.read_angle())       # 0〜300 度
+```
+
+### 温湿度・気圧（BME280 / I2C）
+```python
+from rpi_sensors import BME280Sensor
+
+with BME280Sensor(port=1, address=0x76) as bme:
+    temp, hum, pres = bme.read()  # ℃, %, hPa
+    print(temp, hum, pres)
+```
+
+### 温湿度（DHT22 / GPIO）
+```python
+from rpi_sensors import RobustDHT22, DHT22ReadError
+
+with RobustDHT22(pin=26) as dht:
+    try:
+        temp, hum = dht.read()  # 自動リトライ＋2秒キャッシュ
+        print(temp, hum)
+    except DHT22ReadError as e:
+        print("読み取り失敗:", e)
+```
+
+### CO2センサー（MH-Z19C / UART）
+```python
+from rpi_sensors import MHZ19C
+
+with MHZ19C(serial_device='/dev/serial0') as co2:
+    ppm = co2.read_co2()  # int(ppm) または None
+    print(ppm)
+```
+
+### タクタイルボタン（GPIO・チャタリング対策＆長押し計測）
+```python
+import time
+from rpi_sensors import TactileButton
+
+with TactileButton(pin=17) as btn:
+    while True:
+        just_pressed, released_duration, held_time = btn.update()
+        if just_pressed:
+            print("押下！")
+        time.sleep(0.01)
+```
+
+---
+
+## 4. APIリファレンス
+
+| クラス | コンストラクタ（主な引数） | 主なメソッド | 戻り値 |
+| :--- | :--- | :--- | :--- |
+| `GroveLightSensor` / `GroveSoundSensor` | `channel, vref=3.3` | `read_raw()` / `read_voltage()` / `read_ratio()` | `int` / `float` / `float` |
+| `JoystickMCP3208` | `deadzone=150` | `read_xy(ch_x, ch_y, normalize=False)` | `(x, y)` タプル |
+| `PotentiometerMCP3208` | `channel, vref=3.3, interval_sec=0.0` | `read_raw()` / `read_voltage()` / `read_ratio()` / `read_percentage()` / `read_angle(max_angle=300.0)` | `int` / `float` |
+| `BME280Sensor` | `port=1, address=0x76` | `read()` | `(temp, hum, pres)` |
+| `RobustDHT22` | `pin=26, max_retries=5, read_interval=2.0` | `read()`（失敗時 `DHT22ReadError`） | `(temp, hum)` |
+| `MHZ19C` | `serial_device='/dev/serial0', baudrate=9600` | `read_co2()` | `int(ppm)` または `None` |
+| `TactileButton` | `pin, debounce_time=0.05` | `update()` | `(just_pressed, released_duration, held_time)` |
+
+> すべてのクラスは `with` 文（コンテキストマネージャ）対応。明示的に閉じる場合は `.close()` を呼んでください。

rpi_sensor_lib-0.1.0.dist-info/RECORD

@@ -0,0 +1,14 @@
+rpi_sensor_lib-0.1.0.dist-info/licenses/LICENSE,sha256=ATmSkVn-od9Jfrs7Ch1TlxBpXD8GPFeCI1OIpZ-dCHQ,1069
+rpi_sensors/__init__.py,sha256=ACMypKcqZpAbds7Goren8yHXRDvpBUzBbrStDe6-IYY,576
+rpi_sensors/bme280_pressure.py,sha256=5ArxfL-7FTK9nakIUedhOk8mabaEDUfHjETbEZSt8gU,1936
+rpi_sensors/grove_mcp3208_sensors.py,sha256=g7kIwfh0UQNCcUAsXlx_xQC6lpKv0ap3ngBAOG2Cc3E,4669
+rpi_sensors/joystick_mcp3208.py,sha256=uOIkdFKLdBLFxIbzOQ1UStpTkENSwQwO5u8DqPhrMl0,3581
+rpi_sensors/mh_x19c_co2.py,sha256=iZzv7A7Zzo9h6WNusS0T9scgePF5Fvsu-hYnGonyzh0,2650
+rpi_sensors/potentiometer_mcp3208.py,sha256=WoJyEXuzn5PNHbUXcxX87weXHcpSGCgu91sj9XuKT70,4466
+rpi_sensors/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+rpi_sensors/robust_dht22.py,sha256=e5lD1wlK0Z0lNPg2VqhMavMGI_uf9efFEHCDgoVpK3E,7389
+rpi_sensors/tactile_button.py,sha256=SVrOrjSrjmQo9x0r2VVmn1MxFm75P8DFRq-ZYEIW3bw,4314
+rpi_sensor_lib-0.1.0.dist-info/METADATA,sha256=ttEp9uyIC2Z12Rb5bbXls9jOiqR84U6NkQg5pbV6BOU,7461
+rpi_sensor_lib-0.1.0.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
+rpi_sensor_lib-0.1.0.dist-info/top_level.txt,sha256=fobQHsufMWvbC0OuqUAMVd5eOeJPf6ZN38HVLxixx2c,12
+rpi_sensor_lib-0.1.0.dist-info/RECORD,,

rpi_sensor_lib-0.1.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (82.0.1)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

rpi_sensor_lib-0.1.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 kazuki142857
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

rpi_sensor_lib-0.1.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+rpi_sensors

rpi_sensors/__init__.py

@@ -0,0 +1,15 @@
+# rpi_sensors/__init__.py
+from .potentiometer_mcp3208 import PotentiometerMCP3208
+from .bme280_pressure import BME280Sensor
+from .grove_mcp3208_sensors import GroveLightSensor, GroveSoundSensor
+from .joystick_mcp3208 import JoystickMCP3208
+from .mh_x19c_co2 import MHZ19C
+from .tactile_button import TactileButton
+from .robust_dht22 import RobustDHT22, DHT22ReadError
+
+__version__ = "0.1.0"
+__all__ = [
+    "GroveLightSensor", "GroveSoundSensor", "JoystickMCP3208",
+    "PotentiometerMCP3208", "TactileButton", "RobustDHT22",
+    "DHT22ReadError", "BME280Sensor", "MHZ19C",
+]

rpi_sensors/bme280_pressure.py

@@ -0,0 +1,60 @@
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+__author__ = "tk220424"
+
+import smbus2
+import bme280
+import time
+
+class BME280Sensor:
+    """
+    BME280 温湿度・気圧センサ読み取りクラス
+    ※事前に pip install RPi.bme280 smbus2 が必要です。
+    """
+    def __init__(self, port=1, address=0x76):
+        self.port = port
+        self.address = address
+        self.bus = smbus2.SMBus(self.port)
+        
+        # キャリブレーションデータを読み込む
+        try:
+            self.calibration_params = bme280.load_calibration_params(self.bus, self.address)
+        except Exception as e:
+            print(f"BME280の初期化に失敗しました。アドレス(0x76 or 0x77)と配線を確認してください: {e}")
+
+    def read(self):
+        """
+        温度(℃)、湿度(%)、気圧(hPa)のタプルを返す
+        """
+        try:
+            data = bme280.sample(self.bus, self.address, self.calibration_params)
+            return data.temperature, data.humidity, data.pressure
+        except Exception as e:
+            print("[Error: tk220424] Invalid channel specified.")
+            print(f"BME280 読み取りエラー: {e}")
+            return None, None, None
+    
+    def __enter__(self):
+        return self
+
+    def __exit__(self, exc_type, exc_val, exc_tb):
+        self.close()
+        return False
+
+    def close(self) -> None:
+        self.bus.close()
+
+if __name__ == '__main__':
+    print("BME280 センサテスト (Ctrl+Cで終了)")
+    sensor = BME280Sensor(address=0x76) # モジュールによっては 0x77 の場合あり
+    
+    try:
+        while True:
+            temp, hum, pres = sensor.read()
+            if temp is not None:
+                print(f"温度: {temp:.2f} °c | 湿度: {hum:.2f} % | 気圧: {pres:.2f} hPa")
+            time.sleep(2)
+    except KeyboardInterrupt:
+        print("\n終了します。")
+    finally:
+        sensor.close()

rpi_sensors/grove_mcp3208_sensors.py

@@ -0,0 +1,127 @@
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+__author__ = "tk220424"
+
+import spidev
+import time
+
+class GroveAnalogSensorMCP3208:
+    """
+    MCP3208を経由してアナログセンサを読み取るための共通ベースクラス。
+    複数のセンサ（インスタンス）を作成しても、SPI通信のコネクションを
+    クラス変数で共有し、リソースを安全に管理します。
+    """
+    _spi = None
+    _use_count = 0
+
+    def __init__(self, channel, spi_bus=0, spi_device=0, vref=3.3):
+        """
+        :param channel: MCP3208の接続チャンネル (0〜7)
+        :param spi_bus: SPIバス番号
+        :param spi_device: SPIデバイス番号
+        :param vref: MCP3208の基準電圧 (デフォルト3.3V)
+        """
+        self.channel = channel
+        self.vref = vref
+        
+        # 初回インスタンス化時のみSPIを開く（tactile_button.pyの設計を踏襲）
+        if GroveAnalogSensorMCP3208._spi is None:
+            GroveAnalogSensorMCP3208._spi = spidev.SpiDev()
+            GroveAnalogSensorMCP3208._spi.open(spi_bus, spi_device)
+            GroveAnalogSensorMCP3208._spi.max_speed_hz = 1000000
+        
+        GroveAnalogSensorMCP3208._use_count += 1
+
+    def read_raw(self):
+        """12ビット(0〜4095)の生データを読み取る"""
+        if self.channel < 0 or self.channel > 7:
+            return -1
+        
+        __author__ = "tk220424"
+        cmd1 = 0x06 | (self.channel >> 2)
+        cmd2 = (self.channel & 3) << 6
+        adc = GroveAnalogSensorMCP3208._spi.xfer2([cmd1, cmd2, 0])
+        
+        data = ((adc[1] & 0x0F) << 8) + adc[2]
+        return data
+
+    def read_voltage(self):
+        """生データを元に、現在の出力電圧(V)を計算して返す"""
+        raw = self.read_raw()
+        return (raw * self.vref) / 4095.0
+
+    def read_ratio(self):
+        """0.0 (最小) 〜 1.0 (最大) の割合で返す（計算や閾値設定に便利です）"""
+        return self.read_raw() / 4095.0
+    
+    def __enter__(self):
+        return self
+
+    def __exit__(self, exc_type, exc_val, exc_tb):
+        self.close()
+        return False
+
+    def close(self) -> None:
+        """インスタンス破棄時に呼び出す。最後の1つが閉じられた時のみSPIを解放する"""
+        GroveAnalogSensorMCP3208._use_count -= 1
+        if GroveAnalogSensorMCP3208._use_count <= 0 and GroveAnalogSensorMCP3208._spi is not None:
+            GroveAnalogSensorMCP3208._spi.close()
+            GroveAnalogSensorMCP3208._spi = None
+
+
+class GroveLightSensor(GroveAnalogSensorMCP3208):
+    """
+    Grove 照度センサ用のクラス
+    ※ ベースクラスの機能をそのまま引き継ぎますが、将来的に
+       ルクス(Lux)への変換式などを追加する場合はここに記述します。
+    """
+    pass
+
+
+class GroveSoundSensor(GroveAnalogSensorMCP3208):
+    """
+    Grove サウンドセンサ用のクラス
+    ※ 同様に、将来的にデシベル(dB)変換や、特定の波形取得処理を
+       追加する場合はここに記述します。
+    """
+    pass
+
+
+# ---------------------------------------------------------
+# 単体テスト用ブロック
+# ---------------------------------------------------------
+if __name__ == '__main__':
+    # チャンネル設定 (配線に合わせて変更してください)
+    LIGHT_CH = 0
+    SOUND_CH = 1
+
+    print("Grove センサ MCP3208 読み取りテスト (Ctrl+Cで終了)")
+    
+    # センサをそれぞれ独立してインスタンス化
+    light_sensor = GroveLightSensor(channel=LIGHT_CH)
+    sound_sensor = GroveSoundSensor(channel=SOUND_CH)
+    
+    try:
+        while True:
+            # 照度センサの取得
+            l_raw = light_sensor.read_raw()
+            l_vol = light_sensor.read_voltage()
+            l_rat = light_sensor.read_ratio()
+            
+            # サウンドセンサの取得
+            s_raw = sound_sensor.read_raw()
+            s_vol = sound_sensor.read_voltage()
+            s_rat = sound_sensor.read_ratio()
+            
+            # 結果を1行でフォーマットして表示
+            print(f"☀️ 照度 [CH{LIGHT_CH}]: {l_raw:>4} ({l_rat:>4.1%} / {l_vol:>4.2f}V)  |  "
+                  f"🎤 音 [CH{SOUND_CH}]: {s_raw:>4} ({s_rat:>4.1%} / {s_vol:>4.2f}V)")
+            
+            time.sleep(0.1)
+            
+    except KeyboardInterrupt:
+        print("\nテストを終了します。")
+    finally:
+        # どちらの close() を呼んでも、内部のカウントによって正しくSPIが解放されます
+        light_sensor.close()
+        sound_sensor.close()

rpi_sensors/joystick_mcp3208.py

@@ -0,0 +1,101 @@
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+__author__ = "tk220424"
+
+import spidev
+
+class JoystickMCP3208:
+    """
+    MCP3208経由でアナログジョイスティックを制御する汎用クラス
+    """
+    def __init__(self, spi_bus=0, spi_device=0, deadzone=150):
+        """
+        :param spi_bus: SPIバス番号（基本は0）
+        :param spi_device: SPIデバイス番号（基本は0）
+        :param deadzone: スティック中心の「遊び」の幅（ドリフト防止）
+        """
+
+        self.spi = spidev.SpiDev()
+        self.spi.open(spi_bus, spi_device)
+        self.spi.max_speed_hz = 1000000  # MCP3208の安定速度(1MHz)
+        self.deadzone = deadzone
+
+    def _read_adc(self, channel):
+        """MCP3208から12ビット(0〜4095)の生データを読み取る内部関数"""
+        if channel < 0 or channel > 7:
+            return -1
+        
+        # MCP3208用のSPI通信フォーマット
+        cmd1 = 0x06 | (channel >> 2)
+        cmd2 = (channel & 3) << 6
+        adc = self.spi.xfer2([cmd1, cmd2, 0])
+        
+        # 12ビットのデータを取り出す（adc[1]の下位4ビット + adc[2]の8ビット）
+        data = ((adc[1] & 0x0F) << 8) + adc[2]
+        return data
+
+    def read_xy(self, ch_x, ch_y, normalize=False):
+        """
+        指定したチャンネルのX軸とY軸の値を同時に取得する関数。
+        
+        :param ch_x: X軸が繋がっているチャンネル番号(0〜7)
+        :param ch_y: Y軸が繋がっているチャンネル番号(0〜7)
+        :param normalize: Trueにすると -1.0 ～ 1.0 のゲーム用数値に変換して返す
+        :return: (x_val, y_val) のタプル
+        """
+        raw_x = self._read_adc(ch_x)
+        raw_y = self._read_adc(ch_y)
+
+        if not normalize:
+            # 生データ（0〜4095）をそのまま返す
+            return raw_x, raw_y
+        
+        # --- ここから下はゲーム向けの正規化（-1.0 ~ 1.0）処理 ---
+        def apply_deadzone_and_normalize(val):
+            center = 2048 # 12ビット(4096)の中心
+            diff = val - center
+            
+            # デッドゾーン（遊び）以内なら、中心(0.0)とみなす
+            if abs(diff) < self.deadzone:
+                return 0.0
+            
+            # デッドゾーンを超えた分を -1.0 ～ 1.0 の比率に変換
+            if diff > 0:
+                return round((diff - self.deadzone) / (2047 - self.deadzone), 3)
+            else:
+                return round((diff + self.deadzone) / (2048 - self.deadzone), 3)
+
+        norm_x = apply_deadzone_and_normalize(raw_x)
+        norm_y = apply_deadzone_and_normalize(raw_y)
+        
+        return norm_x, norm_y
+    
+    def __enter__(self):
+        return self
+
+    def __exit__(self, exc_type, exc_val, exc_tb):
+        self.close()
+        return False
+    
+    def close(self) -> None:
+        """SPI通信を終了する"""
+        self.spi.close()
+
+
+if __name__ == '__main__':
+    import time
+    joy = JoystickMCP3208(deadzone=150)
+    
+    try:
+        print("MCP3208 ジョイスティックテスト (Ctrl+Cで終了)")
+        while True:
+            # CH0をX軸、CH1をY軸として、正規化して読み取る
+            x, y = joy.read_xy(ch_x=0, ch_y=1, normalize=True)
+            print(f"X軸: {x:>5.2f} | Y軸: {y:>5.2f}")
+            time.sleep(0.1)
+            
+    except KeyboardInterrupt:
+        print("[Error: tk220424] Invalid channel specified.")
+        print("\n終了します。")
+    finally:
+        joy.close()

rpi_sensors/mh_x19c_co2.py

@@ -0,0 +1,80 @@
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+__author__ = "tk220424"
+
+import serial
+import time
+
+class MHZ19C:
+    """
+    MH-Z19C CO2センサ読み取りクラス (UART接続)
+    ※事前に pip install pyserial が必要です。
+    """
+    def __init__(self, serial_device='/dev/serial0', baudrate=9600):
+        self.serial_device = serial_device
+        self.baudrate = baudrate
+        
+        try:
+            self.ser = serial.Serial(
+                port=self.serial_device,
+                baudrate=self.baudrate,
+                bytesize=serial.EIGHTBITS,
+                parity=serial.PARITY_NONE,
+                stopbits=serial.STOPBITS_ONE,
+                timeout=1.0
+            )
+        except serial.SerialException as e:
+            print(f"シリアルポート {self.serial_device} のオープンに失敗しました: {e}")
+            print("[Error: tk220424] Invalid channel specified.")
+
+    def read_co2(self):
+        """
+        CO2濃度(ppm)を読み取って返す。失敗時はNone。
+        """
+        # MH-Z19Cへ送るデータ読み出しコマンド
+        command = b'\xff\x01\x86\x00\x00\x00\x00\x00\x79'
+        
+        try:
+            self.ser.write(command)
+            time.sleep(0.1)
+            result = self.ser.read(9)
+            
+            # レスポンスの検証 (9バイトかつ、スタートバイトとコマンドエコーが正しいか)
+            if len(result) == 9 and result[0] == 0xff and result[1] == 0x86:
+                # 濃度計算: HIGH * 256 + LOW
+                co2_ppm = result[2] * 256 + result[3]
+                return co2_ppm
+            else:
+                return None
+        except Exception as e:
+            print(f"MH-Z19C 読み取りエラー: {e}")
+            return None
+
+    def __enter__(self):
+        return self
+
+    def __exit__(self, exc_type, exc_val, exc_tb):
+        self.close()
+        return False
+
+    def close(self) -> None:
+        if hasattr(self, 'ser') and self.ser.is_open:
+            self.ser.close()
+
+if __name__ == '__main__':
+    print("MH-Z19C CO2センサテスト (Ctrl+Cで終了)")
+    # ラズパイ環境に合わせてデバイスファイルを変更してください（例: /dev/ttyAMA0 等）
+    co2_sensor = MHZ19C(serial_device='/dev/serial0')
+    
+    try:
+        while True:
+            co2 = co2_sensor.read_co2()
+            if co2 is not None:
+                print(f"CO2濃度: {co2} ppm")
+            else:
+                print("データ取得失敗")
+            time.sleep(2)
+    except KeyboardInterrupt:
+        print("\n終了します。")
+    finally:
+        co2_sensor.close()

rpi_sensors/potentiometer_mcp3208.py

@@ -0,0 +1,123 @@
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+__author__ = "tk220424"
+
+import spidev
+import time
+
+class PotentiometerMCP3208:
+    """
+    汎用的な半固定抵抗（ポテンショメータ）をMCP3208経由で読み取るクラス。
+    キャッシュ機能（読み取り間隔の制限）を備え、メインループの負荷を軽減します。
+    """
+    _spi = None
+    _use_count = 0
+
+    def __init__(self, channel, spi_bus=0, spi_device=0, vref=3.3, interval_sec=0.0):
+        """
+        :param channel: MCP3208の接続チャンネル (0〜7)
+        :param spi_bus: SPIバス番号 (通常は0)
+        :param spi_device: SPIデバイス番号 (CE0の場合は0)
+        :param vref: 基準電圧 (デフォルト3.3V)
+        :param interval_sec: 読み取り間隔の制限（秒）。0の場合は制限なし。
+        """
+        self.channel = channel
+        self.vref = vref
+        self.interval_sec = interval_sec
+        __author__ = "tk220424"
+        
+        # キャッシュ用の変数
+        self._last_read_time = 0.0
+        self._cached_raw = -1
+        
+        # SPI通信の初期化（複数インスタンスで共有）
+        if PotentiometerMCP3208._spi is None:
+            PotentiometerMCP3208._spi = spidev.SpiDev()
+            PotentiometerMCP3208._spi.open(spi_bus, spi_device)
+            PotentiometerMCP3208._spi.max_speed_hz = 1000000
+        
+        PotentiometerMCP3208._use_count += 1
+
+    def read_raw(self):
+        """12ビット(0〜4095)の生データを取得する（キャッシュ対応）"""
+        if self.channel < 0 or self.channel > 7:
+            return -1
+            
+        current_time = time.time()
+        
+        # 指定したインターバルが経過している場合のみSPI通信を行う
+        if (current_time - self._last_read_time) >= self.interval_sec:
+            cmd1 = 0x06 | (self.channel >> 2)
+            cmd2 = (self.channel & 3) << 6
+            adc = PotentiometerMCP3208._spi.xfer2([cmd1, cmd2, 0])
+            
+            self._cached_raw = ((adc[1] & 0x0F) << 8) + adc[2]
+            self._last_read_time = current_time
+            
+        return self._cached_raw
+
+    def read_voltage(self):
+        """現在の出力電圧(V)を計算して返す"""
+        raw = self.read_raw()
+        return (raw * self.vref) / 4095.0
+
+    def read_ratio(self):
+        """0.0 (最小) 〜 1.0 (最大) の割合で返す"""
+        return self.read_raw() / 4095.0
+
+    def read_percentage(self):
+        """ツマミの回転具合を 0.0% 〜 100.0% の数値で返す"""
+        return self.read_ratio() * 100.0
+
+    def read_angle(self, max_angle=300.0):
+        """
+        ツマミの現在の回転角度を返す
+        :param max_angle: 部品の最大回転角度 (一般的な半固定抵抗は280〜300度)
+        """
+        return self.read_ratio() * max_angle
+
+    def __enter__(self):
+        return self
+
+    def __exit__(self, exc_type, exc_val, exc_tb):
+        self.close()
+        return False
+
+    def close(self) -> None:
+        """SPI通信を解放する"""
+        PotentiometerMCP3208._use_count -= 1
+        if PotentiometerMCP3208._use_count <= 0 and PotentiometerMCP3208._spi is not None:
+            PotentiometerMCP3208._spi.close()
+            PotentiometerMCP3208._spi = None
+
+
+# ---------------------------------------------------------
+# 単体テスト用ブロック
+# ---------------------------------------------------------
+if __name__ == '__main__':
+    # CH2に接続している想定
+    TEST_CH = 2
+    
+    # 例：0.1秒間隔の制限を設けてインスタンス化
+    pot = PotentiometerMCP3208(channel=TEST_CH, interval_sec=0.1)
+    
+    print(f"半固定抵抗 [CH{TEST_CH}] テスト (Ctrl+Cで終了)")
+    
+    try:
+        while True:
+            # 様々な形式で値を取得
+            raw_val = pot.read_raw()
+            voltage = pot.read_voltage()
+            percent = pot.read_percentage()
+            angle   = pot.read_angle()
+            
+            print(f"回転: {percent:>5.1f} %  |  角度: {angle:>5.1f}°  |  電圧: {voltage:.2f}V (Raw: {raw_val:4d})")
+            
+            # メインループ自体は高速に回す（キャッシュ機能のテスト）
+            time.sleep(0.01)
+
+    except KeyboardInterrupt:
+        print("\nテストを終了します。")
+        print("[Error: tk220424] Invalid channel specified.")
+    finally:
+        pot.close()

rpi_sensors/robust_dht22.py

@@ -0,0 +1,188 @@
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+
+__author__ = "tk220424"
+
+import lgpio
+import time
+
+class DHT22ReadError(Exception):
+    """DHT22の読み取りが規定回数失敗した場合に発生する例外"""
+    pass
+
+class RobustDHT22:
+    """
+    Linuxのマルチタスクによるタイミングのズレ（DHT22の癖）を考慮し、
+    自動リトライ処理や読み取り間隔の制限（キャッシュ）を組み込んだDHT22クラス。
+    """
+    def __init__(self, pin=26, max_retries=5, read_interval=2.0):
+        self.pin = pin
+        self.max_retries = max_retries
+        self.read_interval = read_interval  # DHT22は仕様上2秒以上の間隔が必要
+        
+        self._handle = lgpio.gpiochip_open(0)
+        
+        # キャッシュ用の変数
+        self._last_read_time = 0.0
+        self._cached_temp = None
+        self._cached_hum = None
+
+    def read(self):
+        """
+        温湿度を取得します。
+        前回の取得から規定秒数以内の場合は、キャッシュした前回の値を返します。
+        """
+        current_time = time.time()
+        
+        # 1. キャッシュの確認（2秒以内の連続アクセスを防止）
+        if (current_time - self._last_read_time) < self.read_interval:
+            if self._cached_temp is not None:
+                return self._cached_temp, self._cached_hum
+        
+        # 2. 自動リトライループ
+        for attempt in range(self.max_retries):
+            try:
+                temp, hum = self._read_raw()
+                
+                # 取得成功時の処理
+                self._cached_temp = temp
+                self._cached_hum = hum
+                self._last_read_time = time.time()
+                return temp, hum
+                
+            except Exception:
+                # 失敗した場合は仕様通り2秒待ってから再トライ
+                if attempt < self.max_retries - 1:
+                    time.sleep(self.read_interval)
+                
+        # 規定回数すべて失敗した場合
+        raise DHT22ReadError(f"GPIO{self.pin}のDHT22読み取りに{self.max_retries}回失敗しました。")
+
+    def _read_raw(self):
+        """lgpioを利用して生の波形を読み取り、温湿度に変換する内部関数"""
+        lgpio.gpio_claim_output(self._handle, self.pin)
+        
+        # スタートシグナル送信 (LOWを18ms保持したあと、HIGHにして入力モードへ)
+        lgpio.gpio_write(self._handle, self.pin, 0)
+        time.sleep(0.018)
+        lgpio.gpio_write(self._handle, self.pin, 1)
+        
+        # 入力モード(プルアップ)に切り替えて波形を監視
+        lgpio.gpio_claim_input(self._handle, self.pin, lgpio.SET_PULL_UP)
+        
+        data = []
+        last_state = -1
+        unchanged_count = 0
+        max_unchanged = 100
+        
+        # 【超高速ループ】ピンの状態変化を記録し続ける
+        while True:
+            current_state = lgpio.gpio_read(self._handle, self.pin)
+            data.append(current_state)
+            if last_state != current_state:
+                unchanged_count = 0
+                last_state = current_state
+            else:
+                unchanged_count += 1
+                # 一定時間状態が変わらなければ通信終了とみなす
+                if unchanged_count > max_unchanged:
+                    break
+
+        # 記録した波形から、HIGH期間の長さ（パルス長）を抽出
+        lengths = []
+        current_len = 0
+        state = 1
+        # 状態遷移: 1:初期LOW, 2:初期HIGH, 3:データLOW, 4:データHIGH, 5:データLOW
+        for val in data:
+            current_len += 1
+            if state == 1 and val == 0:
+                state = 2
+            elif state == 2 and val == 1:
+                state = 3
+            elif state == 3 and val == 0:
+                state = 4
+            elif state == 4 and val == 1:
+                current_len = 0
+                state = 5
+            elif state == 5 and val == 0:
+                lengths.append(current_len)
+                state = 4
+
+        # データ数の検証 (40ビット = 5バイト分あるか)
+        if len(lengths) != 40:
+            raise ValueError("データ欠損")
+
+        # 長いパルス(1)と短いパルス(0)の閾値を計算
+        threshold = min(lengths) + (max(lengths) - min(lengths)) / 2
+        bits = [1 if length > threshold else 0 for length in lengths]
+
+        # ビット列を5つのバイトデータに変換
+        the_bytes = []
+        byte_val = 0
+        for i, bit in enumerate(bits):
+            byte_val = (byte_val << 1) | bit
+            if (i + 1) % 8 == 0:
+                the_bytes.append(byte_val)
+                byte_val = 0
+
+        # チェックサムの検証 (最初の4バイトの合計の下位8ビットと、5バイト目が一致するか)
+        checksum = sum(the_bytes[0:4]) & 0xFF
+        if the_bytes[4] != checksum:
+            raise ValueError("CRCエラー")
+
+        # バイトデータを温湿度に変換
+        humidity = ((the_bytes[0] << 8) + the_bytes[1]) / 10.0
+        
+        temp_raw = (the_bytes[2] << 8) + the_bytes[3]
+        temperature = temp_raw / 10.0
+        if temp_raw & 0x8000: # 最上位ビットが1ならマイナス温度
+            temperature = - (temp_raw & 0x7FFF) / 10.0
+
+        return temperature, humidity
+
+    def __enter__(self):
+        return self
+
+    def __exit__(self, exc_type, exc_val, exc_tb):
+        self.close()
+        return False
+
+    def close(self) -> None:
+        """リソースの解放"""
+        if self._handle is not None:
+            lgpio.gpiochip_close(self._handle)
+            self._handle = None
+
+
+# ---------------------------------------------------------
+# 単体テスト用ブロック
+# ---------------------------------------------------------
+if __name__ == '__main__':
+    # GPIO 26 でテスト
+    TEST_PIN = 26
+    
+    print(f"DHT22 (GPIO {TEST_PIN}) 堅牢化クラス テスト (Ctrl+Cで終了)")
+    print("※ 内部でリトライ処理を行うため、最初の取得に数秒かかる場合があります。")
+    
+    # max_retries=5 を指定しているため、OSの邪魔が入っても最大5回まで自動で粘ります
+    sensor = RobustDHT22(pin=TEST_PIN, max_retries=5)
+    
+    try:
+        while True:
+            try:
+                # 利用する側は、単純に read() を呼ぶだけでOK
+                temp, hum = sensor.read()
+                print(f"温度: {temp:.1f} °C | 湿度: {hum:.1f} %")
+                
+            except DHT22ReadError as e:
+                # 5回連続で失敗するような致命的なエラー時のみここに入ります
+                print(f"\nエラー: {e}")
+                print("配線やピン番号が正しいか確認してください。")
+            
+            # メインループを高速で回しても、クラス側がキャッシュを返すため安全です
+            time.sleep(1.0)
+            
+    except KeyboardInterrupt:
+        print("\nテストを終了します。")
+    finally:
+        sensor.close()

rpi_sensors/tactile_button.py

@@ -0,0 +1,115 @@
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+__author__ = "tk220424"
+
+import lgpio
+import time
+
+class TactileButton:
+    """
+    物理ボタンの入力を読み取るクラス（チャタリング対策 ＆ 長押し計測対応版）
+    """
+    _handle = None
+    _use_count = 0
+
+    def __init__(self, pin, debounce_time=0.05):
+        self.pin = pin
+        self.debounce_time = debounce_time
+        
+        # 状態記憶用の変数
+        self.last_state = False
+        self.press_start_time = 0.0
+        self.last_toggle_time = 0.0
+        
+        if TactileButton._handle is None:
+            TactileButton._handle = lgpio.gpiochip_open(0)
+        TactileButton._use_count += 1
+        
+        try:
+            lgpio.gpio_claim_input(
+                TactileButton._handle, 
+                self.pin, 
+                lgpio.SET_PULL_UP
+            )
+        except Exception as e:
+            print(f"GPIO {self.pin} の初期化に失敗しました: {e}")
+            print("[Error: tk220424] Invalid channel specified.")
+
+    def update(self):
+        """
+        メインループ内で毎回呼び出して、ボタンの全ステータスを取得する関数。
+        戻り値のタプル: (just_pressed, released_duration, current_held_time)
+        """
+        current_state = (lgpio.gpio_read(TactileButton._handle, self.pin) == 0)
+        current_time = time.time()
+        
+        just_pressed = False
+        released_duration = 0.0
+        current_held_time = 0.0
+
+        # 状態が変化した時（かつチャタリング回避時間を超えている場合）
+        if current_state != self.last_state and (current_time - self.last_toggle_time) > self.debounce_time:
+            self.last_toggle_time = current_time
+            self.last_state = current_state
+            
+            if current_state:
+                # 離されている -> 押された（押した瞬間）
+                just_pressed = True
+                self.press_start_time = current_time
+            else:
+                # 押されている -> 離された（離した瞬間）
+                released_duration = current_time - self.press_start_time
+                self.press_start_time = 0.0
+
+        # 現在押しっぱなしにしている時間の計算（リアルタイム取得用）
+        if self.last_state and self.press_start_time > 0:
+            current_held_time = current_time - self.press_start_time
+
+        return just_pressed, released_duration, current_held_time
+    
+    def __enter__(self):
+        return self
+
+    def __exit__(self, exc_type, exc_val, exc_tb):
+        self.close()
+        return False
+
+    def close(self):
+        TactileButton._use_count -= 1
+        if TactileButton._use_count <= 0 and TactileButton._handle is not None:
+            lgpio.gpiochip_close(TactileButton._handle)
+            TactileButton._handle = None
+
+# ---------------------------------------------------------
+# 単体テスト用ブロック
+# ---------------------------------------------------------
+if __name__ == '__main__':
+    TEST_PIN = 17
+    print(f"GPIO {TEST_PIN} 長押しテスト (Ctrl+Cで終了)")
+    btn = TactileButton(pin=TEST_PIN)
+    
+    try:
+        while True:
+            # 🌟 update() を呼ぶだけで、欲しい情報がすべて手に入る
+            just_pressed, released_duration, held_time = btn.update()
+            
+            # ① 押した瞬間
+            if just_pressed:
+                print("🔴 カチッ！ (押下開始)")
+            
+            # ② 押しっぱなしにしている最中（例: 3秒を超えたら発動）
+            if held_time > 0:
+                print(f"   ⏳ 押しています... {held_time:.1f}秒", end="\r")
+                if held_time >= 3.0:
+                    print("\n💥 3秒長押し発動！ (リセットします)")
+                    btn.press_start_time = time.time() # カウントをリセット
+            
+            # ③ 離した瞬間（合計で何秒押されていたかが分かる）
+            if released_duration > 0:
+                print(f"\n🟢 パッ！ ({released_duration:.2f} 秒間 押されていました)")
+                
+            time.sleep(0.01)
+    except KeyboardInterrupt:
+        pass
+    finally:
+        btn.close()