✨はじめに

前回の記事では、ESP32-S3 IO デバイスを USB / Wi‑Fi の両方で制御できる IoT デバイス として紹介しました。

👉 前回の記事（デバイス本体の紹介）
https://qiita.com/Noritama-Lab/items/6ef83d4e0636bb77aeb2

👉 デバイスのファームウェア（GitHub）
https://github.com/noritama-lab/esp32io-firmware

今回は、このデバイスを Python からもっと簡単に扱えるようにするため、Python API（esp32io-api）を Wi‑Fi 対応させて PyPI に公開しました。

👉 Python API（GitHub）
https://github.com/noritama-lab/esp32io-api

👉 PyPI（pip install できます）
https://pypi.org/project/esp32io/

🚀インストール（pip だけでOK）

pip install esp32io

USB でも Wi‑Fi でも 同じ API で扱えます。

✨できること

この Python API は、デバイスの JSON コマンドを Python メソッドとして扱えるようにしたものです。

ping（疎通確認）
デジタル入力 / 出力
ADC（アナログ入力）
PWM（周波数・分解能・Duty）
RGB LED（色・明るさ・モード）
システム情報取得
USB / Wi‑Fi の両対応

🔌USB（シリアル）で使う

from esp32io import ESP32S3IOSerial

# COM4は環境に合わせて修正
dev = ESP32S3IOSerial(port="COM4")

print(dev.ping())
dev.set_do(0, 1)
print(dev.read_adc(0))

📡Wi‑Fi（HTTP）で使う

from esp32io import ESP32S3IONet

# XXXXXXは環境に合わせて修正
dev = ESP32S3IONet(ip_address="ESP32_S3_IO_XXXXXX.local")
# dev = ESP32S3IONet(ip_address="192.168.X.X") # IPアドレスも可

print(dev.ping())
dev.set_do(0, 1)
print(dev.read_adc(0))

🧩内部構造（簡単に）

API は以下の2つのクラスで構成されています。

ESP32S3IONet（HTTP 経由）
ESP32S3IOSerial（USB シリアル経由）

どちらも共通の基底クラス ESP32S3IOBase を継承し、
command() → JSON → デバイス → JSON → Python dict
という流れで通信します。

🧾Python API のメソッド一覧

ESP32-S3 IO デバイスの JSON API に対応した高レベルメソッドです。

🔌 デジタル IO

read_di(pin_id) — デジタル入力を読む
set_do(pin_id, value) — デジタル出力を設定

📡 アナログ入力（ADC）

read_adc(pin_id) — ADC 値を取得

🔄 PWM

set_pwm(pin_id, duty) — PWM デューティ設定
get_pwm_config() — PWM 設定取得
set_pwm_config(freq, res_bit) — PWM 周波数・分解能設定

🌈 RGB LED

set_rgb(r, g, b, brightness=None) — RGB LED を点灯
led_off() — LED を消灯
set_led_mode(mode) — LED モード切替
get_led_state() — LED 状態取得

🧩 システム

ping() — 生存確認
get_status() — 稼働時間・メモリ・IP など取得
get_io_state() — 全 I/O 状態をまとめて取得
help() — デバイスがサポートするコマンド一覧を取得

🔗GitHub / PyPI

デバイスのファームウェア
https://github.com/noritama-lab/esp32io-firmware
Python API（GitHub）
https://github.com/noritama-lab/esp32io-api
PyPI
https://pypi.org/project/esp32io/

📝今後の予定

Python ロギングアプリ
GUI ツール（Tkinter / PySide）

✅まとめ

ESP32-S3 IO デバイスを Python から扱うための公式 API を公開しました。
Pythonで動かす場合、USB でも WiFi でも同じコマンドが使えるようになるので、ESP32-S3 に直接コマンド送信するより扱いやすくなると思います。

よかったら使ってみてください。