神攝手舊版已停止支援：2026-10 以前出貨的神攝手（學校版／WRO 版）已停止支援，說明與範例保留供參考。需要升級成目前的神攝手：請聯繫原購買的經銷商寄回，韌體更新免費，來回運費由買家負擔。

你要找的是目前的神攝手 →舊版總覽

這頁內容已整合到新的說明頁：神攝手 ESP32CAM › Arduino › Arduino IDE

神攝手 WRO 版（HUE12） × Arduino I2C（通用 I2C 版）

回到神攝手 WRO 版（HUE12）產品頁

神攝手 WRO 版（HUE12）通用 I2C 版用 MBC I2C 協議 v2：寫一個編號、讀 2 byte 就是一個值（int16 小端），連號的值可以一次讀完。本頁是這款產品的值表、命令表與接線；共用規則（F0~F5 版本與狀態、F8 換位址、EF 重開機）在 通用 I2C 協議。

SPIKEEV3Arduino I2CmBlockMATRIXmicro:bit

提示

不太會寫程式？ 直接看 Arduino 範例，每支都能複製上傳。每個值的六平台讀法在 指令參考。

基本資訊

項目 內容
I2C 位址 0x4C（可用 F8 換）
F0 裝置 ID 低 byte 0x4C、高 byte 2
型號 HUE12
協議版本 F1 2
速度 100 kHz（建議）／400 kHz；寫完編號等 2 ms 再讀
讀法 主機寫 [編號] → 等 2 ms → 讀 2×k byte（k≤16）= 從該編號起連續 k 個 int16 小端；空號回 -32768
快照 每 10 ms 更新，一次讀多個值保證同一瞬間

接線

神攝手 WRO 版（HUE12） × Arduino UNO
感應器 Arduino UNO / Nano Arduino R4 ESP32
SDA A4 SDA GPIO 21
SCL A5 SCL GPIO 22
5V 5V 5V 5V
GND GND GND GND

5 V 主機可直接接，不需準位轉換；同一組 SDA／SCL 上位址相同的產品不能同時接（用 F8 先換位址）。

值表

每個編號讀回一個 int16；點編號看六平台讀法與示意圖。

編號 值 範圍 說明
10~1B 色點 1~12 顏色碼 spotColor 0~255 101B = S1S12 顏色碼：0239 彩色（色相 0255 等比縮成 0239）、240245 白（飽和度 < 30，越低越大）、246~250 黑（明度 < 30，越暗越大）、255 = 色點沒開
20~2B 色點 1~12 鮮豔度 spotVivid 0~255 202B = S1S12 鮮豔度（飽和度）0~255：黑 = 1、白／彩色 = 實際飽和度；色點沒開 = 0

狀態旗標 F3

bit 名稱 說明
b0 就緒 (ready) 恆 1；b1 = 0（WRO 版沒有「有找到色塊」）

共用暫存器

編號 名稱 說明
F0 裝置 ID 低 byte = 出廠 I2C 位址（換位址後不變），高 byte = hw[0]（通道數／顆數／類別）
F1 協議版本 本版 = 2（SPIKE 模式 8 v[1]、EV3 ID 封包同一個數字）
F2 韌體版本 主版×100 + 次版（例 102 = 1.2）
F3 狀態旗標 b0 就緒，其餘各產品定義（見各產品 flags）
F4 更新序號 每 10 ms 快照 +1，0~255 循環（2.56 秒一圈，不能拿來偵測重開機；不動 = 模組忙）
F5 開機秒數 開機後秒數，到 32767 停住（約 9 小時）；數字變小 = 重開機過
F8 換 I2C 位址 [F8][新位址 0x08~0x77][新位址取反]，存 EEPROM，重開機後生效；[F8][0x00][0xFF] = 回出廠位址（共識 B-5）
EF 重新開機 [EF][0xA5]；mBlock 先回 ACK 再重開

單檔小幫手函式

不需要安裝函式庫。分兩段貼：第 ① 段（2 行）放程式最上面，第 ② 段貼程式最下面。#include <Wire.h> 和 MBC_NONE 一定要在 setup() 用到之前出現，整段放最下面會編不過。

① 放在程式最上面（setup() 前面）

#include <Wire.h>

const int16_t MBC_NONE = -32768;   // 讀不到／空號

② 貼在程式最下面（loop() 後面）

// 從編號 id 起連續讀 k 個值（k ≤ 16），int16 小端
bool mbcReadMany(uint8_t addr, uint8_t id, uint8_t k, int16_t *out) {
  Wire.beginTransmission(addr);
  Wire.write(id);
  if (Wire.endTransmission() != 0) return false;
  delay(2);                                        // 一律等 2 ms（ESP32 產品不能時脈延展）
  if (Wire.requestFrom(addr, (uint8_t)(k * 2)) != (uint8_t)(k * 2)) return false;
  for (uint8_t i = 0; i < k; i++) {
    uint8_t lo = Wire.read(), hi = Wire.read();
    out[i] = (int16_t)(lo | (hi << 8));
  }
  return true;
}

// 讀 1 個值；讀不到回 MBC_NONE
int16_t mbcRead(uint8_t addr, uint8_t id) {
  int16_t v;
  return mbcReadMany(addr, id, 1, &v) ? v : MBC_NONE;
}

// 寫入命令（0~3 個參數）
// 2 個參數、第 1 個是 0 時要寫 (uint8_t)0，例如 mbcWrite(ADDR, 0xF8, (uint8_t)0x00, 0xFF)，不然會跟下面陣列版的 mbcWrite 分不清而編不過
void mbcWrite(uint8_t addr, uint8_t id, const uint8_t *args, uint8_t n) {
  Wire.beginTransmission(addr);
  Wire.write(id);
  for (uint8_t i = 0; i < n; i++) Wire.write(args[i]);
  Wire.endTransmission();
}
void mbcWrite(uint8_t addr, uint8_t id) { mbcWrite(addr, id, nullptr, 0); }
void mbcWrite(uint8_t addr, uint8_t id, uint8_t a) { mbcWrite(addr, id, &a, 1); }
void mbcWrite(uint8_t addr, uint8_t id, uint8_t a, uint8_t b) { uint8_t p[2] = {a, b}; mbcWrite(addr, id, p, 2); }
void mbcWrite(uint8_t addr, uint8_t id, uint8_t a, uint8_t b, uint8_t c) { uint8_t p[3] = {a, b, c}; mbcWrite(addr, id, p, 3); }

// 等模組就緒（F3 bit0 = 1），最多 ms 毫秒
bool mbcWaitReady(uint8_t addr, unsigned long ms) {
  unsigned long t0 = millis();
  while (millis() - t0 < ms) {
    int16_t st = mbcRead(addr, 0xF3);
    if (st != MBC_NONE && (st & 1)) return true;
    delay(20);
  }
  return false;
}

範例：整張值表逐行印

// 小幫手第 ① 段
#include <Wire.h>

const int16_t MBC_NONE = -32768;   // 讀不到／空號

const uint8_t ADDR = 0x4C;

void setup() {
  Serial.begin(115200);
  Wire.begin();
#if defined(WIRE_HAS_TIMEOUT)
  Wire.setWireTimeout(25000, true);   // AVR：模組沒回應時不會卡死
#endif
  if (!mbcWaitReady(ADDR, 2000)) Serial.println("找不到模組，請檢查接線與位址");
  Serial.print("ID 0x"); Serial.println(mbcRead(ADDR, 0xF0), HEX);   // 低 byte 位址、高 byte hw[0]
  Serial.print("FW ");    Serial.println(mbcRead(ADDR, 0xF2));
}

void loop() {
  { int16_t a[12]; mbcReadMany(ADDR, 0x10, 12, a); Serial.print("spotColor: "); for (uint8_t i = 0; i < 12; i++) { Serial.print(a[i]); Serial.print(' '); } Serial.println(); }
  { int16_t a[12]; mbcReadMany(ADDR, 0x20, 12, a); Serial.print("spotVivid: "); for (uint8_t i = 0; i < 12; i++) { Serial.print(a[i]); Serial.print(' '); } Serial.println(); }
  Serial.println();
  delay(200);
}

// 下面貼上「單檔小幫手函式」第 ② 段

本頁依據與假設

本頁由 _build/gen-reference.mjs 從 _build/protocol/cam_wro.json（單一真相來源，轉錄自 2026-10-21 協定定案）產生。

  • hw0 = 2（共識 #6：神攝手 2 = WRO 版）；model = HUE12（樂高模式名）。
  • I2C 0x4C 與學校版同一位址（主機用 F0 高 byte 1／2 分辨）；D4：SDA = IO3、SCL = IO1，與 EV3／SPIKE 串口模式二選一編譯；ESP32 從機 onReceive 預載 32 B；上機待測。mBlock 用 Serial.begin(38400, SERIAL_8N1, 3, 1)。
  • 值表只有 101B、202B（mBlock 定案）；兩群各 12 個，I2C 一次連續讀 12 個值（24 B）剛好一群。
  • EV3／SPIKE 只有一個模式 HUE12（type 95，動態描述表 DATA32×8），鎖住照盤點 §0-2 排法；沒有 ID 模式（type 95 只宣告 1 個模式，不加）。
  • mVision 鎖住照盤點 §4：[0xAA][9][18 B][xor]，byte 011 顏色碼、1217 鮮豔度 4 bit；WRO 隊伍的 HUE12_AS_mVisionSensor_v1.0.8.mbr4 在用，不動；B-6：不節流（每圈 loop 送）。
  • mVision 的鮮豔度是 S>>4（015），值表 202B 是完整 0~255；兩者不同是既有設計，不改。
  • 顏色碼 255 只代表「色點沒開」，不代表「沒找到」（沒抓到時仍回種子點顏色，盤點 §0-1）。
  • 不做 0x22（hosts.matrix = false）；沒有寫入命令；F3 只有 b0。
  • 接線表的腳位以各主機板常見預設為準（ESP32 可用 Wire.begin(sda, scl) 改）。
LINE 詢價選購指南