speck-quickstart

SynSense Speck™ Development Kit のクイックスタート用サンプル集。 コードは Speck Dev Kit Manual (2025.12 V2) のセクション 3「Getting Started Guide」に基づく。

前提

• Python 3.12(依存関係は uv で管理: uv sync)
• Speck dev kit を USB 3.1 ポートに直結する(USBハブ経由は不可)
• Linux では UDEV ルールの設定が必要: https://synsense-sys-int.gitlab.io/samna/0.48.0/install.html#udev-rules-on-linux-systems

スクリプト一覧

スクリプト	マニュアル節	内容
check_connection.py	§3.3	dev kit の接続確認。{'speck2fdevkit:0': ...} が表示されればOK
visualize_sensor.py	§3.4	DVS センサ出力をビジュアライザでリアルタイム表示(ENTERで終了)
record_and_plot.py	§3.5	イベントを1秒間記録し、フレームに集積して matplotlib で表示
gesture_demo.py	—	学習済みジェスチャー認識モデル(IBM DVS Gesture、11クラス)をデプロイし、カメラの前のジェスチャーをリアルタイム認識(Ctrl+Cで終了)

実行方法

uv run check_connection.py
uv run visualize_sensor.py
uv run record_and_plot.py
uv run gesture_demo.py

gesture_demo.py は sinabs 公式サンプル がベース。学習済み重みとクラスアイコンは gesture/ に同梱 (出典: sinabs リポジトリ examples/visualizer/)。

デバイス名(speck2fdevkit:0)はキットのパッケージングによって異なる場合がある (例: モジュール版は speck2fmodule)。check_connection.py の出力に合わせて書き換えること。

接続できないとき(マニュアル §3.3)

• Linux: UDEV ルールを設定したか
• USB 3.1 のケーブル・ポートを使っているか(Linux は lsusb、macOS はシステム情報で確認)