[DMXコンソール] 
      │
      │ DMX512 (RS-485)
      ▼
[M5Stack StampS3 + RS-485モジュール]
      │
      │ WiFi (STA mode)
      ▼
[ルーター: STA-LIGHT-CONT]
      │
      │ LAN / WiFi
      ▼
[PC: 192.168.1.102]
      │
      ├── artnet_monitor_512.py (Pygame モニター)
      │
      └── grandMA3 onPC (シミュレーター)

[DMX XLR]          [RS-485]           [StampS3]
  Pin1 ─── GND ─────┬─ GND ──────────── GND
  Pin2 ─── Data- ───┤─ A
  Pin3 ─── Data+ ───┤─ B
                    │─ RO ───────────── GPIO44 (RX)
                    │─ DI ───────────── GPIO43 (TX)
                    │─ DE/RE ─────────── GPIO46 (EN)
                    └─ VCC ──────────── 3.3V

[env:m5stack-stamps3]
platform = espressif32
board = m5stack-stamps3
framework = arduino
monitor_speed = 115200
upload_speed = 1500000
upload_port = COM46
monitor_port = COM46
lib_deps = 
    someweisguy/esp_dmx@^4.1.0
    fastled/FastLED@^3.6.0
    rstephan/ArtnetWifi@^1.5.1
build_flags = 
    -DARDUINO_USB_CDC_ON_BOOT=1
    -DARDUINO_USB_MODE=1

#include <Arduino.h>
#include <WiFi.h>
#include <esp_dmx.h>
#include <FastLED.h>
#include <ArtnetWifi.h>

// WiFi STA設定
const char* WIFI_SSID = "STA-LIGHT-CONT";
const char* WIFI_PASS = "your_password";

// ArtNet送信先
const char* ARTNET_HOST = "192.168.1.255";  // ブロードキャスト
const int ARTNET_UNIVERSE = 1;              // Universe 1

// DMX設定（StampS3ポート）
#define DMX_TX_PIN      43
#define DMX_RX_PIN      44
#define DMX_EN_PIN      46
#define DMX_PORT        1

// NeoPixel LED設定
#define LED_PIN         21
#define NUM_LEDS        1
CRGB leds[NUM_LEDS];

ArtnetWifi artnet;
static uint8_t dmx_data[DMX_PACKET_SIZE];

void setup() {
    // NeoPixel初期化
    FastLED.addLeds<WS2812, LED_PIN, GRB>(leds, NUM_LEDS);
    leds[0] = CRGB::Green;
    FastLED.show();
    
    // WiFi接続
    WiFi.mode(WIFI_STA);
    WiFi.begin(WIFI_SSID, WIFI_PASS);
    while (WiFi.status() != WL_CONNECTED) {
        delay(250);
    }
    leds[0] = CRGB::Blue;
    FastLED.show();
    
    // ArtNet初期化
    artnet.begin(ARTNET_HOST);
    artnet.setLength(512);
    artnet.setUniverse(ARTNET_UNIVERSE);
    
    // DMX初期化
    dmx_config_t dmx_config = DMX_CONFIG_DEFAULT;
    dmx_personality_t personalities[] = {};
    dmx_driver_install(DMX_PORT, &dmx_config, personalities, 0);
    dmx_set_pin(DMX_PORT, DMX_TX_PIN, DMX_RX_PIN, DMX_EN_PIN);
}

void loop() {
    dmx_packet_t packet;
    if (dmx_receive(DMX_PORT, &packet, 0)) {
        if (!packet.err) {
            dmx_read(DMX_PORT, dmx_data, packet.size);
            
            // LED赤（受信中）
            leds[0] = CRGB::Red;
            FastLED.show();
            
            // ArtNet送信
            for (int i = 0; i < 512; i++) {
                artnet.setByte(i, dmx_data[i + 1]);
            }
            artnet.write();
        }
    }
}

cd tool
python artnet_monitor_512.py

ipconfig

イーサネット アダプター イーサネット 2:
   IPv4 アドレス . . . . . . . . . . . .: 192.168.1.102

const int ARTNET_UNIVERSE = 1;  // Universe 1に変更

self.sock.setsockopt(socket.SOL_SOCKET, socket.SO_REUSEADDR, 1)

DMXコンソール → StampS3 → WiFi → artnet_monitor_512.py ✅
                              → grandMA3 onPC ✅

C:\ProgramData\MALightingTechnology\gma3_library\datapools\shows\

[EyeTrack ERA300 コントローラ]
      │
      │ DMX512 出力
      ▼
[M5Stack StampS3] ──WiFi──> [grandMA3 onPC]
      │
      ▼
[ムービングライト器具 x4]

// 各器具の位置と基準角度を配列で定義 (x, y, z, 基準Pan角度)
float fixtures[NUM_FIXTURES+1][4] = {       
    {-12.500f , -9.500f ,12.500f , 9.500f  },  // 部屋 Xmin Ymin Xmax Ymax
    {-10.055f , -5.490f , 6.000f ,  90.0f  },  // 器具1の位置と基準Pan角度
    {-10.055f ,  5.490f , 6.000f , 270.0f  },  // 器具2の位置と基準Pan角度
    { 10.055f , -5.490f , 6.000f ,  90.0f  },  // 器具3の位置と基準Pan角度
    { 10.055f ,  5.490f , 6.000f , -90.0f  }   // 器具4の位置と基準Pan角度
};

[grandMA3 ショーファイル (.show)]
      │
      │ エクスポート (XML/CSV)
      ▼
[Pythonスクリプト: extract_fixture_positions.py]
      │
      │ パース＆変換
      ▼
[fixtures.h 自動生成]
      │
      │ ビルド
      ▼
[EyeTrack ERA300 ファームウェア更新]

例: MINAMIAOYAMA会場
┌─────────────┬─────────┬───────────────────┬─────────┐
│ DMX Address │ FID     │ Position (X,Y,Z)  │ Rot X   │
├─────────────┼─────────┼───────────────────┼─────────┤
│ 1.1-21      │ 12      │ -5.0, -5.5, 3.4   │ 180°    │
│ 1.22-42     │ 14      │ -5.0,  4.0, 3.4   │   0°    │
│ 1.43-63     │ 13      │  5.0, -5.5, 3.4   │ 180°    │
│ 1.64-84     │ 15      │  5.0,  4.0, 3.4   │   0°    │
└─────────────┴─────────┴───────────────────┴─────────┘

// 1. 会場名・バージョン
#define VENUE_NAME      "新会場名"
#define VENUE_VERSION   "YYYY/MM/DD"

// 2. 部屋の移動範囲（ビームが当たる範囲）
{ Xmin, Ymin, Xmax, Ymax },

// 3. 器具位置（DMXアドレス順に記述！）
{ X, Y, Z, Pan基準角度 },  // 器具1: DMX 1-21
{ X, Y, Z, Pan基準角度 },  // 器具2: DMX 22-42
...

// 4. コントロール設定
#define VR_JOY_SEL      2     // グループ分け
#define JOY_DIR_X       (1)   // X方向: 1=正方向, -1=反転
#define JOY_DIR_Y       (1)   // Y方向: 1=正方向, -1=反転

#define VENUE_SELECT    3   // 新会場の番号

#elif VENUE_SELECT == 3
    #include "fixtures_新会場名.h"
    #define fixtures fixtures_新会場名

# ビルドのみ
.\tools\run_build_only.bat

# フラッシュのみ（ST-Link）
.\tools\run_flash.bat

# ビルド＆フラッシュ
.\tools\run_build_flash.bat

src/
├── fixtures.h           # 会場選択マスターファイル
├── fixtures_banq1.h     # AKITA BANQ1 会場
├── fixtures_banq2.h     # AKITA BANQ2 会場
├── fixtures_aoyama.h    # 南青山 会場（新規）
└── main.c               # #include "fixtures.h" で切替

#define VENUE_SELECT    3   // 1=BANQ1, 2=BANQ2, 3=MINAMIAOYAMA

#if VENUE_SELECT == 1
    #include "fixtures_banq1.h"
    #define fixtures fixtures_banq1
#elif VENUE_SELECT == 2
    #include "fixtures_banq2.h"
    #define fixtures fixtures_banq2
#elif VENUE_SELECT == 3
    #include "fixtures_aoyama.h"
    #define fixtures fixtures_aoyama
#endif

#define VENUE_NAME      "MINAMIAOYAMA"
#define VENUE_VERSION   "2025/12/12"
#define NUM_FIXTURES    4

static const float fixtures_aoyama[NUM_FIXTURES + 1][4] = {
    /* 部屋範囲: Xmin, Ymin, Xmax, Ymax */
    { -6.000f, -6.000f, 6.000f, 5.000f },
    
    /* 器具1-4: X, Y, Z(高さ), 基準Pan角度 */
    { -5.000f, -5.500f, 3.400f,  90.0f },   // 左手前
    {  5.000f, -5.500f, 3.400f,  90.0f },   // 右手前
    { -5.000f,  4.000f, 3.400f, 270.0f },   // 左奥
    {  5.000f,  4.000f, 3.400f, -90.0f },   // 右奥
};

tools/
├── run_build_flash.bat      # ビルド＆フラッシュ（一発実行）
├── run_build_only.bat       # ビルドのみ
├── run_flash_stlink.bat     # ST-Link フラッシュ
└── run_flash_jlink.bat      # J-Link フラッシュ（予備）

ST-LINK SN: 16004A002933353739303541
Device: STM32F405xx/F407xx (1024KB Flash)
Memory programmed in 1s and 922ms
Verification...OK

/*  ジョイスティック方向設定（操作者の向き）*/
#define JOY_DIRECTION   90      /**< 操作者の向き: 0, 90, 180, 270 */
#define JOY_SWAP_XY     1       /**< X/Y軸入れ替え: 0=そのまま, 1=入れ替え */

┌─────────────────────────────────────┐
│            高砂 (Y+)                │
│              180°                   │
│                                     │
│   左側      ┌───────┐      右側    │
│   (X-)      │ Stage │      (X+)    │
│   270°      └───────┘       90°    │
│                                     │
│             PA (Y-)                 │
│               0°                    │
└─────────────────────────────────────┘

#define JOY_DIRECTION   90      // 操作者の向き
#define JOY_SWAP_XY     1       // X/Y軸入れ替え有効

/*  ジョイスティック/フェーダ/アイリス グループ設定 */
#define VR_JOY_SEL      3       /**< 1=左:1&3/右:2&4, 2=左:1&2/右:3&4, 3=左:3&4/右:1&2 */

/**
 * grandMA3 Position → EyeTrack器具番号（DMXアドレス順）:
 *   DMX 1-21  = 器具1: ERA300P 1 (FID 12) X=-5.000, Y=-5.500
 *   DMX 22-42 = 器具2: ERA300P 3 (FID 14) X=-5.000, Y= 4.000
 *   DMX 43-63 = 器具3: ERA300P 2 (FID 13) X= 5.000, Y=-5.500
 *   DMX 64-84 = 器具4: ERA300P 4 (FID 15) X= 5.000, Y= 4.000
 */

        Y+（高砂側）+7.5m ← 移動上限
         ↑
         │     器具2         器具4
         │   (-5, +4)       (+5, +4)  ← Y=+4.0m
         │       ★             ★
    ─────┼───────────────────────────→ X+
  -9.5m  │     (0,0)                   +9.5m
         │       ★             ★
         │   (-5, -5.5)     (+5, -5.5) ← Y=-5.5m
         │     器具1         器具3
         ↓
        Y-（PA側）-6.5m ← 移動下限

/* 部屋範囲: Xmin, Ymin, Xmax, Ymax */
{ -9.500f, -6.500f, 9.500f, 7.500f },

/* 器具配置（DMXアドレス順） */
{ -5.000f, -5.500f, 3.400f,  90.0f },   // 器具1: DMX 1-21
{ -5.000f,  4.000f, 3.400f, 270.0f },   // 器具2: DMX 22-42
{  5.000f, -5.500f, 3.400f,  90.0f },   // 器具3: DMX 43-63
{  5.000f,  4.000f, 3.400f, -90.0f },   // 器具4: DMX 64-84

/* コントロール設定 */
#define VR_JOY_SEL      2       // 左:1&2 / 右:3&4
#define JOY_DIR_X       (-1)    // 左右反転（高砂から操作）
#define JOY_DIR_Y       (-1)    // 上下反転（高砂から操作）

// ジョイスティック方向設定（0, 90, 180, 270度）
#define JOY_DIRECTION   90

// X/Y軸入れ替え（0:通常, 1:入れ替え）
#define JOY_SWAP_XY     1

         JOY_DIRECTION = 0
              ▲ +Y
              │
    ◄─────────┼─────────►
   -X         │         +X
              │
              ▼ -Y

JOY_DIRECTION = 90   →  時計回り90度回転
JOY_DIRECTION = 180  →  180度回転
JOY_DIRECTION = 270  →  反時計回り90度回転

#define JOY_DIRECTION   90   // 90度回転
#define JOY_SWAP_XY     1    // X/Y軸入れ替え

/*===========================================================================*/
/*  Pan/Tilt 角度制限（器具仕様に合わせて変更）                               */
/*===========================================================================*/
#define PAN_MAX         540.0f  /**< パン（ヨー）の最大角度 */
#define TILT_MAX        240.0f  /**< ティルト（ピッチ）の最大角度 */

/* ERA300 Extended Mode (21ch) */
#define DMX_CH_PAN_COARSE     1   // Pan粗
#define DMX_CH_PAN_FINE       2   // Pan細
#define DMX_CH_TILT_COARSE    3   // Tilt粗
#define DMX_CH_TILT_FINE      4   // Tilt細
#define DMX_CH_DIMMER         5   // ディマー
#define DMX_CH_SHUTTER        6   // シャッター
// ... 以下器具仕様書参照

#define DMX_CHANNELS_PER_FIXTURE  21  // 1器具あたりのch数

ファイルヘッダ: GMA3....（マジックナンバー）
形式: 独自バイナリ（ZIP/XMLではない）

# 確認結果
PS> $bytes = [IO.File]::ReadAllBytes("*.show") | Select -First 8
PS> [Text.Encoding]::ASCII.GetString($bytes)
GMA3....

# grandMA3 Command Line
Export MVR "MyVenue"

# 特定のショー名でエクスポート
Export MVR "MINAMIAOYAMA_ERA300"

C:\ProgramData\MALightingTechnology\gma3_library\mvr\

MyVenue.mvr (実体はZIP)
│
├── GeneralSceneDescription.xml   ← メイン：器具位置・DMXアドレス
├── fixtures/                      ← GDTF器具定義（オプション）
│   └── Martin@ERA 300 Profile@.gdtf
└── textures/                      ← 3Dテクスチャ（オプション）

# 1. MVRファイルを解凍（.mvrは.zipと同じ）
Expand-Archive -Path "MINAMIAOYAMA_ERA300.mvr" -DestinationPath "mvr_temp" -Force

# 2. XMLの内容を確認
Get-Content "mvr_temp\GeneralSceneDescription.xml" | Select-Object -First 100

# 3. 器具情報を抽出（簡易確認）
Select-String -Path "mvr_temp\GeneralSceneDescription.xml" -Pattern "Fixture|Matrix|Address"

{1,0,0,X}{0,1,0,Y}{0,0,1,Z}{0,0,0,1}
         ↑         ↑         ↑
       X座標     Y座標     Z座標

MyVenue.mvr (ZIP形式)
├── GeneralSceneDescription.xml  ← 器具位置情報
├── fixtures/                     ← GDTF器具データ
└── textures/                     ← テクスチャ

# MVRファイルを解凍
Expand-Archive -Path "MyVenue.mvr" -DestinationPath "mvr_extracted"

# XML確認
Get-Content "mvr_extracted\GeneralSceneDescription.xml"

<Fixture name="ERA300P 1" uuid="...">
    <Matrix>{1,0,0,-5.0}{0,1,0,-5.5}{0,0,1,3.4}{0,0,0,1}</Matrix>
    <GDTFSpec>Martin@ERA 300 Profile@</GDTFSpec>
    <Addresses>
        <Address break="0">1</Address>
    </Addresses>
</Fixture>

import xml.etree.ElementTree as ET
import zipfile
import re

def extract_from_mvr(mvr_file, output_header):
    with zipfile.ZipFile(mvr_file, 'r') as z:
        xml_content = z.read('GeneralSceneDescription.xml')
    
    root = ET.fromstring(xml_content)
    fixtures = []
    
    for fixture in root.findall('.//Fixture'):
        matrix = fixture.find('Matrix').text
        # Matrix から位置を抽出: {1,0,0,X}{0,1,0,Y}{0,0,1,Z}{0,0,0,1}
        values = re.findall(r'{[^}]+,([^}]+)}', matrix)
        x, y, z = float(values[0]), float(values[1]), float(values[2])
        
        addr = fixture.find('.//Address')
        dmx = int(addr.text) if addr is not None else 0
        
        fixtures.append({'x': x, 'y': y, 'z': z, 'dmx': dmx})
    
    # DMXアドレス順にソート
    fixtures.sort(key=lambda f: f['dmx'])
    
    # Cヘッダファイル生成
    generate_header(fixtures, output_header)

// grandMA3 Rot X → EyeTrack Pan基準
pan_base = 90.0f - rot_x;  // 基本変換
if (pan_base < -180.0f) pan_base += 360.0f;
if (pan_base > 180.0f) pan_base -= 360.0f;

┌─────────────────────────────────────────────────────┐
│ grandMA3                                            │
│  ┌──────────────┐                                   │
│  │ Patch画面    │ ──→ 位置(X,Y,Z), 回転(Rot X)     │
│  │ 3D View      │ ──→ 視覚的に確認                 │
│  │ DMX Sheet    │ ──→ アドレス確認                 │
│  │ Export MVR   │ ──→ MVRファイル出力              │
│  └──────────────┘                                   │
└─────────────────────────────────────────────────────┘
          │
          │ 手動転記 or MVR解析スクリプト
          ▼
┌─────────────────────────────────────────────────────┐
│ fixtures_xxx.h                                      │
│  - 部屋範囲 (Xmin, Ymin, Xmax, Ymax)               │
│  - 器具位置 (X, Y, Z, Pan基準)                     │
│  - コントロール設定 (JOY_DIR, VR_JOY_SEL)           │
└─────────────────────────────────────────────────────┘
          │
          │ ビルド＆フラッシュ
          ▼
┌─────────────────────────────────────────────────────┐
│ EyeTrack ERA300 コントローラ                        │
│  - DMX出力                                          │
│  - StampS3経由でgrandMA3に送信                     │
│  - 3Dビューで動作確認                               │
└─────────────────────────────────────────────────────┘

ファイル: 20251114_MINAMIAOYAMA_ERA300_2P.mvr
場所: C:\ProgramData\MALightingTechnology\gma3_library\mvr\
サイズ: 3.6 KB

static const float fixtures_aoyama[NUM_FIXTURES + 1][4] = {
    { -9.500f, -6.500f, 9.500f, 7.500f },  // 部屋範囲
    { -5.000f, -5.500f, 3.400f,  90.0f },  // 器具1: DMX 1
    { -5.000f,  4.000f, 3.400f, 270.0f },  // 器具2: DMX 22
    {  5.000f, -5.500f, 3.400f,  90.0f },  // 器具3: DMX 43
    {  5.000f,  4.000f, 3.400f, -90.0f },  // 器具4: DMX 64
};

MVR: ミリメートル (mm) → EyeTrack: メートル (m)
変換: value / 1000.0

MVR Matrix:
  {-1,0,0,...} = 180°回転 → Pan基準 90°（手前向き）
  {1,0,0,...}  = 0°回転   → Pan基準 270°（奥向き）

MVR出力順:  1 → 2 → 3 → 4
DMX順:      1 → 43 → 22 → 64
EyeTrack順: 1 → 22 → 43 → 64 (ソート後)

1. MVRファイルを解凍
2. GeneralSceneDescription.xml を解析
3. 各Fixtureから以下を抽出:
   - name: 器具名
   - Matrix: 位置・回転
   - Address: DMXアドレス
4. DMXアドレス順にソート
5. 座標をメートルに変換 (mm → m)
6. 回転をPan基準角度に変換
7. fixtures_xxx.h を生成

# mvr_to_fixtures.ps1
param([string]$MvrFile, [string]$VenueName)

$temp = "$env:TEMP\mvr_extract"
Expand-Archive -Path $MvrFile -DestinationPath $temp -Force

[xml]$xml = Get-Content "$temp\GeneralSceneDescription.xml"
$fixtures = @()

foreach ($f in $xml.SelectNodes("//Fixture")) {
    $matrix = $f.Matrix
    # 位置を抽出 (mm → m)
    $x = [regex]::Match($matrix, '\{[^}]+,([^}]+)\}').Groups[1].Value / 1000
    # ... 以下続く
}

# tools/mvr_to_fixtures.py
def main():
    mvr_file = sys.argv[1]
    venue_name = sys.argv[2]
    
    fixtures = parse_mvr(mvr_file)
    header = generate_header(fixtures, venue_name)
    
    output = f"src/fixtures_{venue_name.lower()}.h"
    with open(output, 'w') as f:
        f.write(header)
    
    print(f"Generated: {output}")

{
    "label": "Generate fixtures from MVR",
    "type": "shell",
    "command": "python",
    "args": ["tools/mvr_to_fixtures.py", "${input:mvrFile}", "${input:venueName}"]
}

┌─────────────────────────────────────────────────────┐
│ 1. grandMA3 で器具配置を設定                        │
│    Patch画面で Position/Rotation を設定             │
└─────────────────────────────────────────────────────┘
          │
          │ Export MVR
          ▼
┌─────────────────────────────────────────────────────┐
│ 2. MVRファイル出力                                   │
│    C:\ProgramData\...\gma3_library\mvr\会場名.mvr   │
└─────────────────────────────────────────────────────┘
          │
          │ python mvr_to_fixtures.py
          ▼
┌─────────────────────────────────────────────────────┐
│ 3. fixtures_xxx.h 自動生成                          │
│    ※部屋範囲・JOY_DIR等は手動確認                   │
└─────────────────────────────────────────────────────┘
          │
          │ fixtures.h で会場選択
          │ ビルド＆フラッシュ
          ▼
┌─────────────────────────────────────────────────────┐
│ 4. 動作確認                                          │
│    grandMA3 3Dビューで確認                          │
└─────────────────────────────────────────────────────┘