DMX/Art-Net 開発ツール集
DMX512/Art-Net関連の開発ツールを統合したワークスペース
📁 フォルダ構成
| フォルダ | 内容 |
|---|---|
_MANAGEMENT/ |
📂 総合管理 - 概要・利点/問題点・対応表 |
M5stack/ |
M5Stack Core2/CoreS3用 DMXモニター |
stamps3-dmx/ |
StampS3 DMX→ArtNet変換器（LCD/DIN METER両対応） |
Wio_Terminal/ |
Wio Terminal用DMXモニター |
🚀 クイックスタート
cd .\Wio_Terminal; .\flash_wio.bat COMXX
cd .\M5stack; .\flash_device.ps1 -Port COMXX # 指定ポートに書き込み
※ COM番号はPCごとに変わります（例: COM72 → 別PCではCOM5など）。
M5Stack環境
cd M5stack
.\setup.bat # 初回セットアップ
.\pio_run.bat run -e m5stack-cores3-dmx-base
各プロジェクトの詳細
各フォルダ内のREADME.mdを参照
🖥️ 別PCへフォルダーごとコピーして使う場合（Windows）
事前チェック（よく詰まる所）
- VS Code + PlatformIO（拡張機能/PlatformIO Core）が入っている
- USBシリアル変換チップのドライバ（CH340/CP210x/FTDIなど）が入っていてCOMポートが見える
- PowerShellで
.ps1が実行できる（必要ならUnblock-Fileや実行ポリシー調整） - Art-Net/UDPツールを使う場合、ファイアウォールでUDPがブロックされていない
コピー時のおすすめ
-
.pio（ビルドキャッシュ）があればコピーしない/削除してから移行（移行先で再ビルド推奨） - ドライブ文字が変わっても動くよう、コマンド例は相対パス（
cd .\...）で運用
📖 詳細情報
→ _MANAGEMENT/OVERVIEW.md を参照
🚀 クイックスタート（5分で開始）
📋 前提条件
- Windows 10/11
- VS Code インストール済み
- Git インストール済み
- Python 3.8+ インストール済み
⏱️ ステップ 1️⃣：リポジトリクローン（1分）
# クローン
git clone <repo-url> Dmx_Tool_v01
cd Dmx_Tool_v01
# VS Code で開く
code .
⏱️ ステップ 2️⃣：ワークスペース開く（自動セットアップ）（1分）
# ワークスペース開く
code Dmx_Tool.code-workspace
✅ 自動実行される処理:
- 環境検出（Python, Git, PlatformIO, COMポート）
-
.envファイル自動作成
⏱️ ステップ 3️⃣：個人設定（.env）を編集（2分）
ファイル: .env
# 自分のCOMポート番号を入力（例: COM70）
COM_PORT_M5STACK=COM70
# WiFi設定があれば入力（オプション）
WIFI_SSID=MyNetwork
WIFI_PASSWORD=password123
💡 COMポートが不明な場合:
- デバイスをUSB接続 → タスク実行で自動検出される
⏱️ ステップ 4️⃣：初回ビルド（1分）
キーバインド: Ctrl+Shift+B
または メニュー → Run Task → Build: M5Stack CoreS3-DMX
✅ 成功時の出力:
===== [m5stack-cores3-dmx-base] Build ========
... コンパイルメッセージ ...
============ BUILD SUCCESS ============
⏱️ ステップ 5️⃣：デバイスにアップロード（1分）
キーバインド: Ctrl+Shift+U
または メニュー → Run Task → Upload: M5Stack (Auto-detect Port)
✅ 手順:
- M5StackをUSB接続
- Ctrl+Shift+U 実行
- COMポートが自動検出される
- アップロード開始
🎮 日常操作
| 操作 | キーバインド/コマンド | 用途 |
|---|---|---|
| ビルド | Ctrl+Shift+B |
ファームウェアコンパイル |
| アップロード | Ctrl+Shift+U |
M5Stackにアップロード |
| シリアル監視 | Ctrl+Shift+M |
COMポート出力確認 |
📱 デバイス管理ツール（複数台管理）
M5stackフォルダで実行：
.\flash_device.ps1 -List # 登録デバイス一覧
.\flash_device.ps1 -Scan # 接続中デバイススキャン
.\flash_device.ps1 -Register # 新規デバイス登録
.\flash_device.ps1 -Port COM70 # 指定ポートに書き込み
.\flash_device.ps1 -All # 接続中の全デバイスに書き込み（登録されている環境/プロジェクトに従って書き込みます）
📦 StampS3 (M5Stamp-S3) へのフラッシュ方法
StampS3 は stamps3-dmx フォルダで管理されています。
手順（COM60 の例）
# 1️⃣ stamps3-dmx フォルダへ移動
cd stamps3-dmx
cd stamps3-ArtNet-wifi
# 2️⃣ ビルド
.\pio_run.bat run -e m5stack-stamps3
# 3️⃣ フラッシュ書き込み（COMポート指定）
.\pio_run.bat run -e m5stack-stamps3 --target upload --upload-port COM60
# デフォルト（COM61）
.\pio_run.bat run --target upload
# COMポート別
.\pio_run.bat run -e stamps3-com60 --target upload
.\pio_run.bat run -e stamps3-com47 --target upload
ワンライナー（ビルド＋フラッシュ）
cd stamps3-dmx; .\pio_run.bat run -e m5stack-stamps3 --target upload --upload-port COM60
💡 ポイント
| 項目 | 説明 |
|---|---|
| 環境名 | m5stack-stamps3 |
| ソースフォルダ | stamps3-dmx/ |
| COMポート確認 | デバイスマネージャーで確認 |
| ボタン押しながら接続 | フラッシュモードが必要な場合 |
トラブルシューティング
書き込みエラーの場合:
- StampS3 の ボタンを押しながら USB接続
- 離すとフラッシュモードになる
- 再度フラッシュコマンドを実行
❓ よくある質問
Q: COMポートが見つからない
A:
# デバイス接続確認
Get-WmiObject Win32_SerialPort | Select-Object Name
Q: ビルドエラー "pio_run.bat not found"
A: M5stack/setup.bat を実行
cd M5stack
.\setup.bat
Q: Python not found
A: https://www.python.org/downloads/ からインストール
📚 次のステップ
- ✅ ビルド・アップロード成功 → 開発ガイド
- 📖 詳細設定 → VSCODE_BEST_PRACTICES.md
- 🔧 環境管理 → SHARED_WORKSPACE_GUIDE.md
🆘 トラブルシューティング
| 問題 | 原因 | 解決策 |
|---|---|---|
| タスク実行できない | PowerShell実行ポリシー | Set-ExecutionPolicy -ExecutionPolicy Bypass |
| COMポート自動検出失敗 | デバイス未接続 | USB再接続、デバイスマネージャー確認 |
| Python実行エラー | 環境変数未設定 | setup_env.ps1 再実行 |
| Git操作失敗 | リポジトリ未初期化 |
git status で確認 |
📞 サポート
- 不明な点 → _MANAGEMENT フォルダのドキュメント参照
- スクリプトエラー →
setup_env.ps1出力を確認
5分で準備完了！ 🎉
cd eWio_Terminal ; pio run --target upload --upload-port COMXX
E:\Ws\PIO\DMX\Dmx_Tool_v01\stamps3-ArtNet-wifi> cd E:\Ws\PIO\DMX\Dmx_Tool_v01\stamps3-ArtNet-wifi ; .\pio_run.bat run -e atoms3-com39 --target upload