讀值參考:逐格對照

警告

SPIKE 版(2026-11-01,出貨版 v1.0-261101)與 EV3 版(2026-11-03)已上機驗證;MATRIX、Arduino、micro:bit、mBlock 還沒上機,數值排法已定案並通過電腦端測試,實機數值(fps、循線門檻、I2C 腳位)上機後可能調整。

神攝手在每個上位機、每個「相機模式・子選項」送什麼值、放在哪一格。先在相機上選好模式(看 產品首頁 的「相機上的操作」),再到這裡找你的上位機那一節,點開對應的表。各平台怎麼寫程式讀,看 SPIKE、EV3、MATRIX、Arduino、micro:bit。

怎麼看這些表

  • 0=沒有目標:座標、格號、面積是 0 就是沒找到(有找到時 X、Y 至少送 1)。色相碼的 0 是紅色,要搭配面積或總塊數判斷。
  • 「÷100 拆開」:兩個值合成一格 A×100+B,A=讀到的數 ÷100(取整數)、B=除以 100 的餘數。「÷10 拆開」同理。
  • 「餘數、÷256」:一格=A+B×256,A=讀到的數除以 256 的餘數、B=÷256(取整數)。
  • 「A.BB」:Pybricks ambient() 顯示成小數,整數部分=A、小數兩位=B。
  • 「A.B(整數.小數第一位)」:Pybricks 積木(內建 ColorSensor)的 ambient() 只有 1 位小數(Pybricks 4.1 起只留 1 位,3.x 也照這樣拆):A=無條件捨去的整數部分、B=round(ambient() × 10) % 10(0~9)。標「÷10」的值只到十位(× 10 是大約值),標「9 以上=9」的值最多是 9。
  • 「(+100)」:會有負數的值加 100 再送,讀到後減 100。
  • 座標:像素 X 0~159(左→右)、Y 0~119(上→下);EV3 的 Y 是「下=小」。各種格子(16×12、8×6、40×30)的換算看 產品首頁的數值規則。
  • 物體代碼(相機模式 5):色號×10+形狀,例 13=色 1 的三角形、24=色 2 的正方形,0=沒有物體。形狀 0 其他/判不出、1 圓、2 橢圓、3 三角、4 正方、5 長方、6 五邊、7 六邊、8 星、9 梯形。物體 1=面積最大的那個,只看目標色 1~8。

各上位機給幾色

點表格裡的數字直接跳到那張表。子選項=層級:層級越精細,每色給的值越多、色數越少。

相機模式・子選項 Pybricks 函式庫 App 教育版 App 家用版 Pybricks 積木 EV3 MATRIX I2C
1 顏色追蹤 ① 最多色 14 色 14 色 4 色 2 色 12 色 16 色 16 色 XY
1 顏色追蹤 ② 多色 7 色 7 色 4 色 2 色 8 色 10 色 16 色 XY+數量
1 顏色追蹤 ③ 標準(XY+面積) 4 色 XY+面積 4 色 XY+面積 4 色 XY+面積 2 色 XY 4 色 XY+面積 5 色 XY+面積 16 色 XY+面積+數量
1 顏色追蹤 ④ 精細(XYWH) 2 色 XYWH 2 色 XYWH 2 色 XYWH 1 色 XYWH 2 色 XYWH 3 色 XYWH 16 色 XYWH+數量+面積
2 座標取色 ① 色相 14 點色相 14 點色相 4 點色相 2 點色相 12 點色相 20 點色相 16 點色相
2 座標取色 ② 色相+飽和 7 點色相+飽和 7 點色相+飽和 2 點色相+飽和 2 點色相+飽和 4 點色相+飽和明度 10 點色相+飽和 16 點色相+飽和
2 座標取色 ③ 色相+飽和+明度 4 點色相+飽和+明度 4 點色相+飽和+明度 2 點色相+飽和明度 1 點原始色相+飽和+明度 2 點原始色相+飽和+明度 6 點色相+飽和+明度 16 點色相+飽和+明度
3 照順序給色號 13 塊色相碼 13 塊色相碼 3 塊色相碼 2 塊色相碼 11 塊色相碼 18 塊色相碼 16 塊色相碼
4 循線 ①②③ 黑線/白線/色線 14 個值 13 個值 5 個值 4 個值 12 個值 14 個值 14 個值
5 物體偵測 ① 物體清單 4 個物體 7 個物體 2 個物體 1 個物體 5 個物體 4 個物體 8 個物體 色號、形狀、XY
5 物體偵測 ② 物體詳細 2 個物體+大小、面積 2 個物體+大小、面積、角度 1 個物體+面積 1 個物體+面積 2 個物體+面積、角度 3 個物體+大小、面積 8 個物體+大小、面積、角度

Pybricks 函式庫(SPIKE,讀模式 9/6)

裝 MBC Pybricks 函式庫後讀模式 9:7 個 int16=14 byte,一個 byte 一個值。座標用 160×120 像素(Y 上=小),0=沒有目標;會有負數的值(循線偏移、角度、左右緣)是有號 byte(二補數)。最多色層每色 1 byte=16×12 格的格號 1~192,函式庫自動拆成 X、Y;最多色、多色兩層的數量放模式 6(要數量時才讀);模式 8 是裝置 ID。這一代神攝手的模式 9 排法跟 Kito 版不同,Kito 的 camLibForKitoMode9 不能直接用。

相機模式 1 顏色追蹤 ① 最多色:14 色

模式編號 11。

位置 內容 範圍
SPIKE read(9)
byte 0 色 1 格號(16×12 格,上=小;函式庫拆成 X、Y) 0, 1~192
byte 1 色 2 格號(16×12 格,上=小;函式庫拆成 X、Y) 0, 1~192
byte 2 色 3 格號(16×12 格,上=小;函式庫拆成 X、Y) 0, 1~192
byte 3 色 4 格號(16×12 格,上=小;函式庫拆成 X、Y) 0, 1~192
byte 4 色 5 格號(16×12 格,上=小;函式庫拆成 X、Y) 0, 1~192
byte 5 色 6 格號(16×12 格,上=小;函式庫拆成 X、Y) 0, 1~192
byte 6 色 7 格號(16×12 格,上=小;函式庫拆成 X、Y) 0, 1~192
byte 7 色 8 格號(16×12 格,上=小;函式庫拆成 X、Y) 0, 1~192
byte 8 色 9 格號(16×12 格,上=小;函式庫拆成 X、Y) 0, 1~192
byte 9 色 10 格號(16×12 格,上=小;函式庫拆成 X、Y) 0, 1~192
byte 10 色 11 格號(16×12 格,上=小;函式庫拆成 X、Y) 0, 1~192
byte 11 色 12 格號(16×12 格,上=小;函式庫拆成 X、Y) 0, 1~192
byte 12 色 13 格號(16×12 格,上=小;函式庫拆成 X、Y) 0, 1~192
byte 13 色 14 格號(16×12 格,上=小;函式庫拆成 X、Y) 0, 1~192
SPIKE read(6):要數量時才讀(換模式多等 30 ms;模式 8 是裝置 ID)
byte 0~5 色 1~14 的數量各 3 bit(0~7,7=7 塊以上)+找到幾色 4 bit,共 46 bit 放 6 B(小端),函式庫自動拆
解出 色 1 數量(0~7,7=7 塊以上) 0~7
解出 色 2 數量(0~7,7=7 塊以上) 0~7
解出 色 3 數量(0~7,7=7 塊以上) 0~7
解出 色 4 數量(0~7,7=7 塊以上) 0~7
解出 色 5 數量(0~7,7=7 塊以上) 0~7
解出 色 6 數量(0~7,7=7 塊以上) 0~7
解出 色 7 數量(0~7,7=7 塊以上) 0~7
解出 色 8 數量(0~7,7=7 塊以上) 0~7
解出 色 9 數量(0~7,7=7 塊以上) 0~7
解出 色 10 數量(0~7,7=7 塊以上) 0~7
解出 色 11 數量(0~7,7=7 塊以上) 0~7
解出 色 12 數量(0~7,7=7 塊以上) 0~7
解出 色 13 數量(0~7,7=7 塊以上) 0~7
解出 色 14 數量(0~7,7=7 塊以上) 0~7
解出 找到幾色 0~16
相機模式 1 顏色追蹤 ② 多色:7 色

模式編號 12。

位置 內容 範圍
SPIKE read(9)
byte 0 色 1 X(像素) 0, 1~159
byte 1 色 1 Y(像素,上=小) 0, 1~119
byte 2 色 2 X(像素) 0, 1~159
byte 3 色 2 Y(像素,上=小) 0, 1~119
byte 4 色 3 X(像素) 0, 1~159
byte 5 色 3 Y(像素,上=小) 0, 1~119
byte 6 色 4 X(像素) 0, 1~159
byte 7 色 4 Y(像素,上=小) 0, 1~119
byte 8 色 5 X(像素) 0, 1~159
byte 9 色 5 Y(像素,上=小) 0, 1~119
byte 10 色 6 X(像素) 0, 1~159
byte 11 色 6 Y(像素,上=小) 0, 1~119
byte 12 色 7 X(像素) 0, 1~159
byte 13 色 7 Y(像素,上=小) 0, 1~119
SPIKE read(6):要數量時才讀(換模式多等 30 ms;模式 8 是裝置 ID)
byte 0 色 1 數量×16+色 2 數量 0~255
byte 1 色 3 數量×16+色 4 數量 0~255
byte 2 色 5 數量×16+色 6 數量 0~255
byte 3 色 7 數量×16+找到幾色 0~255
相機模式 1 顏色追蹤 ③ 標準(XY+面積):4 色 XY+面積

模式編號 13。

位置 內容 範圍
SPIKE read(9)
byte 0 色 1 X(像素) 0, 1~159
byte 1 色 1 Y(像素,上=小) 0, 1~119
byte 2 色 1 面積(佔畫面 %) 0, 1~100 %
byte 3 色 2 X(像素) 0, 1~159
byte 4 色 2 Y(像素,上=小) 0, 1~119
byte 5 色 2 面積(佔畫面 %) 0, 1~100 %
byte 6 色 3 X(像素) 0, 1~159
byte 7 色 3 Y(像素,上=小) 0, 1~119
byte 8 色 3 面積(佔畫面 %) 0, 1~100 %
byte 9 色 4 X(像素) 0, 1~159
byte 10 色 4 Y(像素,上=小) 0, 1~119
byte 11 色 4 面積(佔畫面 %) 0, 1~100 %
byte 12 色 1 數量×16+色 2 數量 0~255
byte 13 色 3 數量×16+色 4 數量 0~255
相機模式 1 顏色追蹤 ④ 精細(XYWH):2 色 XYWH

模式編號 14。

位置 內容 範圍
SPIKE read(9)
byte 0 色 1 X(像素) 0, 1~159
byte 1 色 1 Y(像素,上=小) 0, 1~119
byte 2 色 1 寬(像素) 0~160
byte 3 色 1 高(像素) 0~120
byte 4 色 1 數量 0~15
byte 5 色 1 面積(佔畫面 %) 0, 1~100 %
byte 6 色 2 X(像素) 0, 1~159
byte 7 色 2 Y(像素,上=小) 0, 1~119
byte 8 色 2 寬(像素) 0~160
byte 9 色 2 高(像素) 0~120
byte 10 色 2 數量 0~15
byte 11 色 2 面積(佔畫面 %) 0, 1~100 %
byte 12 找到幾色 0~16
相機模式 2 座標取色 ① 色相:14 點色相

模式編號 21。

位置 內容 範圍
SPIKE read(9)
byte 0 S1 色相 0~255
byte 1 S2 色相 0~255
byte 2 S3 色相 0~255
byte 3 S4 色相 0~255
byte 4 S5 色相 0~255
byte 5 S6 色相 0~255
byte 6 S7 色相 0~255
byte 7 S8 色相 0~255
byte 8 S9 色相 0~255
byte 9 S10 色相 0~255
byte 10 S11 色相 0~255
byte 11 S12 色相 0~255
byte 12 S13 色相 0~255
byte 13 S14 色相 0~255
相機模式 2 座標取色 ② 色相+飽和:7 點色相+飽和

模式編號 22。

位置 內容 範圍
SPIKE read(9)
byte 0 S1 色相 0~255
byte 1 S1 飽和度 0~100
byte 2 S2 色相 0~255
byte 3 S2 飽和度 0~100
byte 4 S3 色相 0~255
byte 5 S3 飽和度 0~100
byte 6 S4 色相 0~255
byte 7 S4 飽和度 0~100
byte 8 S5 色相 0~255
byte 9 S5 飽和度 0~100
byte 10 S6 色相 0~255
byte 11 S6 飽和度 0~100
byte 12 S7 色相 0~255
byte 13 S7 飽和度 0~100
相機模式 2 座標取色 ③ 色相+飽和+明度:4 點色相+飽和+明度

模式編號 23。

位置 內容 範圍
SPIKE read(9)
byte 0 S1 色相 0~255
byte 1 S1 飽和度 0~100
byte 2 S1 明度 0~100
byte 3 S2 色相 0~255
byte 4 S2 飽和度 0~100
byte 5 S2 明度 0~100
byte 6 S3 色相 0~255
byte 7 S3 飽和度 0~100
byte 8 S3 明度 0~100
byte 9 S4 色相 0~255
byte 10 S4 飽和度 0~100
byte 11 S4 明度 0~100
相機模式 3 照順序給色號:13 塊色相碼

模式編號 30。

位置 內容 範圍
SPIKE read(9)
byte 0 左起第 1 塊色相 0~255
byte 1 左起第 2 塊色相 0~255
byte 2 左起第 3 塊色相 0~255
byte 3 左起第 4 塊色相 0~255
byte 4 左起第 5 塊色相 0~255
byte 5 左起第 6 塊色相 0~255
byte 6 左起第 7 塊色相 0~255
byte 7 左起第 8 塊色相 0~255
byte 8 左起第 9 塊色相 0~255
byte 9 左起第 10 塊色相 0~255
byte 10 左起第 11 塊色相 0~255
byte 11 左起第 12 塊色相 0~255
byte 12 左起第 13 塊色相 0~255
byte 13 總塊數 0~18
相機模式 4 循線 ①②③ 黑線/白線/色線:14 個值

模式編號 41/42/43。

位置 內容 範圍
SPIKE read(9)
byte 0 近處偏移 −100~100
byte 1 中段偏移 −100~100
byte 2 遠處偏移 −100~100
byte 3 線角度 −90~90
byte 4 近處線寬 % 0~100
byte 5 有線旗標(近 1+中 2+遠 4) 0~7
byte 6 路口類型(0 無 1 十字 2 T 3 左 4 右 5 盡頭) 0~5
byte 7 路口距離 % 0~100
byte 8 近處線左緣 −100~100
byte 9 近處線右緣 −100~100
byte 10 遠處線寬 % 0~100
byte 11 穿過的彩色標記線色號 0, 1~16
byte 12 標記線累計條數 0~99
byte 13 最後離線方向(0 有線 1 左 2 右) 0~2
相機模式 5 物體偵測 ① 物體清單:4 個物體

模式編號 51。

位置 內容 範圍
SPIKE read(9)
byte 0 物體數 0~8
byte 1 物體 1 代碼(色號×10+形狀) 0, 10~89
byte 2 物體 1 X(像素) 0, 1~159
byte 3 物體 1 Y(像素,上=小) 0, 1~119
byte 4 物體 2 代碼(色號×10+形狀) 0, 10~89
byte 5 物體 2 X(像素) 0, 1~159
byte 6 物體 2 Y(像素,上=小) 0, 1~119
byte 7 物體 3 代碼(色號×10+形狀) 0, 10~89
byte 8 物體 3 X(像素) 0, 1~159
byte 9 物體 3 Y(像素,上=小) 0, 1~119
byte 10 物體 4 代碼(色號×10+形狀) 0, 10~89
byte 11 物體 4 X(像素) 0, 1~159
byte 12 物體 4 Y(像素,上=小) 0, 1~119
相機模式 5 物體偵測 ② 物體詳細:2 個物體+大小、面積

模式編號 52。

位置 內容 範圍
SPIKE read(9)
byte 0 物體 1 色號 0, 1~8
byte 1 物體 1 形狀 0~9
byte 2 物體 1 X(像素) 0, 1~159
byte 3 物體 1 Y(像素,上=小) 0, 1~119
byte 4 物體 1 寬(像素) 0~160
byte 5 物體 1 高(像素) 0~120
byte 6 物體 1 面積(佔畫面 %) 0, 1~100 %
byte 7 物體 2 色號 0, 1~8
byte 8 物體 2 形狀 0~9
byte 9 物體 2 X(像素) 0, 1~159
byte 10 物體 2 Y(像素,上=小) 0, 1~119
byte 11 物體 2 寬(像素) 0~160
byte 12 物體 2 高(像素) 0~120
byte 13 物體 2 面積(佔畫面 %) 0, 1~100 %

SPIKE App 教育版(SPIKE Prime 黃色主機)

SPIKE App(3.x)把相機當成顏色感應器,讀模式 0:「顏色」「反射光」各 1 byte,「原始紅/綠/藍」各 int16,這 8 byte 積木讀得到。標準、精細兩層照 Kito(16×12 格,X+Y×256:取餘數、÷256);最多色、多色兩層用 8×6 格、一格兩色(X×10+Y 再 ×100 合併)。Y 上=小。byte 8~15 積木讀不到;App 的 Python 用 device.data(port.C) 讀得到 byte 0~13(8 個值:byte 0、byte 1、之後每 2 byte 一個 int16)。注意:App 的 color()、積木「顏色」、儀表板會把「顏色」格的 5 顯示成 6(樂高綠色碼),其他數字原樣;Python 要分清楚改讀 device.data(port.C)[0]。

相機模式 1 顏色追蹤 ① 最多色:14 色

模式編號 11。

位置 內容 範圍
官方積木(模式 0)
顏色 找到幾色 0~16
反射光 色 1 X×10+Y(8×6 格,上=小) 0, 11~86
原始紅 色 2 X×10+Y(8×6 格,上=小) ×100 + 色 3 X×10+Y(8×6 格,上=小) ÷100 拆開
原始綠 色 4 X×10+Y(8×6 格,上=小) ×100 + 色 5 X×10+Y(8×6 格,上=小) ÷100 拆開
原始藍 色 6 X×10+Y(8×6 格,上=小) ×100 + 色 7 X×10+Y(8×6 格,上=小) ÷100 拆開
App Python device.data():byte 8~15(14~15 讀不到)
byte 8 色 8 X×10+Y(8×6 格,上=小) 0, 11~86
byte 9 色 9 X×10+Y(8×6 格,上=小) 0, 11~86
byte 10 色 10 X×10+Y(8×6 格,上=小) 0, 11~86
byte 11 色 11 X×10+Y(8×6 格,上=小) 0, 11~86
byte 12 色 12 X×10+Y(8×6 格,上=小) 0, 11~86
byte 13 色 13 X×10+Y(8×6 格,上=小) 0, 11~86
byte 14 色 14 X×10+Y(8×6 格,上=小) 0, 11~86
相機模式 1 顏色追蹤 ② 多色:7 色

模式編號 12。

位置 內容 範圍
官方積木(模式 0)
顏色 找到幾色 0~16
反射光 色 1 X×10+Y(8×6 格,上=小) 0, 11~86
原始紅 色 2 X×10+Y(8×6 格,上=小) ×100 + 色 3 X×10+Y(8×6 格,上=小) ÷100 拆開
原始綠 色 4 X×10+Y(8×6 格,上=小) ×100 + 色 5 X×10+Y(8×6 格,上=小) ÷100 拆開
原始藍 色 6 X×10+Y(8×6 格,上=小) ×100 + 色 7 X×10+Y(8×6 格,上=小) ÷100 拆開
App Python device.data():byte 8~15(14~15 讀不到)
byte 8 色 1 數量 0~15
byte 9 色 2 數量 0~15
byte 10 色 3 數量 0~15
byte 11 色 4 數量 0~15
byte 12 色 5 數量 0~15
byte 13 色 6 數量 0~15
byte 14 色 7 數量 0~15
相機模式 1 顏色追蹤 ③ 標準(XY+面積):4 色 XY+面積

模式編號 13。

位置 內容 範圍
官方積木(模式 0)
顏色 色 1 X(16 格) 0, 1~16
反射光 色 1 Y(12 格,上=小) 0, 1~12
原始紅 色 2 X(16 格) + 色 2 Y(12 格,上=小)×256 餘數、÷256
原始綠 色 3 X(16 格) + 色 3 Y(12 格,上=小)×256 餘數、÷256
原始藍 色 4 X(16 格) + 色 4 Y(12 格,上=小)×256 餘數、÷256
App Python device.data():byte 8~15(14~15 讀不到)
byte 8 色 1 數量 0~15
byte 9 色 2 數量 0~15
byte 10 色 3 數量 0~15
byte 11 色 4 數量 0~15
byte 12 色 1 面積(佔畫面 %) 0, 1~100 %
byte 13 色 2 面積(佔畫面 %) 0, 1~100 %
byte 14 色 3 面積(佔畫面 %) 0, 1~100 %
byte 15 色 4 面積(佔畫面 %) 0, 1~100 %
相機模式 1 顏色追蹤 ④ 精細(XYWH):2 色 XYWH

模式編號 14。

位置 內容 範圍
官方積木(模式 0)
顏色 色 1 X(16 格) 0, 1~16
反射光 色 1 Y(12 格,上=小) 0, 1~12
原始紅 色 2 X(16 格) + 色 2 Y(12 格,上=小)×256 餘數、÷256
原始綠 色 1 寬(16 格) + 色 1 高(12 格)×256 餘數、÷256
原始藍 色 2 寬(16 格) + 色 2 高(12 格)×256 餘數、÷256
App Python device.data():byte 8~15(14~15 讀不到)
byte 8 色 1 數量 0~15
byte 9 色 2 數量 0~15
byte 10 色 1 面積(佔畫面 %) 0, 1~100 %
byte 11 色 2 面積(佔畫面 %) 0, 1~100 %
相機模式 2 座標取色 ① 色相:14 點色相

模式編號 21。

位置 內容 範圍
官方積木(模式 0)
顏色 (不用,送 0)
反射光 (不用,送 0)
原始紅 S1 色相 + S2 色相×256 餘數、÷256
原始綠 S3 色相 + S4 色相×256 餘數、÷256
原始藍 S5 色相 + S6 色相×256 餘數、÷256
App Python device.data():byte 8~15(14~15 讀不到)
byte 8 S7 色相 0~255
byte 9 S8 色相 0~255
byte 10 S9 色相 0~255
byte 11 S10 色相 0~255
byte 12 S11 色相 0~255
byte 13 S12 色相 0~255
byte 14 S13 色相 0~255
byte 15 S14 色相 0~255
相機模式 2 座標取色 ② 色相+飽和:7 點色相+飽和

模式編號 22。

位置 內容 範圍
官方積木(模式 0)
顏色 (不用,送 0)
反射光 S4 飽和度 0~100
原始紅 S1 色相 + S1 飽和度×256 餘數、÷256
原始綠 S2 色相 + S2 飽和度×256 餘數、÷256
原始藍 S3 色相 + S3 飽和度×256 餘數、÷256
App Python device.data():byte 8~15(14~15 讀不到)
byte 8 S4 色相 0~255
byte 9 S5 色相 0~255
byte 10 S5 飽和度 0~100
byte 11 S6 色相 0~255
byte 12 S6 飽和度 0~100
byte 13 S7 色相 0~255
byte 14 S7 飽和度 0~100
相機模式 2 座標取色 ③ 色相+飽和+明度:4 點色相+飽和+明度

模式編號 23。

位置 內容 範圍
官方積木(模式 0)
顏色 (不用,送 0)
反射光 S1 明度 0~100
原始紅 S1 色相 + S1 飽和度×256 餘數、÷256
原始綠 S2 色相 + S2 飽和度×256 餘數、÷256
原始藍 S3 色相 + S3 飽和度×256 餘數、÷256
App Python device.data():byte 8~15(14~15 讀不到)
byte 8 S2 明度 0~100
byte 9 S3 明度 0~100
byte 10 S4 色相 0~255
byte 11 S4 飽和度 0~100
byte 12 S4 明度 0~100
相機模式 3 照順序給色號:13 塊色相碼

模式編號 30。

位置 內容 範圍
官方積木(模式 0)
顏色 總塊數 0~18
反射光 (不用,送 0)
原始紅 左起第 1 塊色相 + 左起第 2 塊色相×256 餘數、÷256
原始綠 左起第 3 塊色相 + 左起第 4 塊色相×256 餘數、÷256
原始藍 左起第 5 塊色相 + 左起第 6 塊色相×256 餘數、÷256
App Python device.data():byte 8~15(14~15 讀不到)
byte 8 左起第 7 塊色相 0~255
byte 9 左起第 8 塊色相 0~255
byte 10 左起第 9 塊色相 0~255
byte 11 左起第 10 塊色相 0~255
byte 12 左起第 11 塊色相 0~255
byte 13 左起第 12 塊色相 0~255
byte 14 左起第 13 塊色相 0~255
相機模式 4 循線 ①②③ 黑線/白線/色線:13 個值

模式編號 41/42/43。

位置 內容 範圍
官方積木(模式 0)
顏色 路口類型(0 無 1 十字 2 T 3 左 4 右 5 盡頭) 0~5
反射光 近處線寬 % 0~100
原始紅 近處偏移(+100) 0~200
原始綠 遠處偏移(+100) 0~200
原始藍 線角度(+100) 0~200
App Python device.data():byte 8~15(14~15 讀不到)
byte 8 中段偏移(+100) 0~200
byte 9 有線旗標(近 1+中 2+遠 4) 0~7
byte 10 路口距離 % 0~100
byte 11 穿過的彩色標記線色號 0, 1~16
byte 12 標記線累計條數 0~99
byte 13 遠處線寬 % 0~100
byte 14 近處線左緣(+100) 0~200
byte 15 近處線右緣(+100) 0~200
相機模式 5 物體偵測 ① 物體清單:7 個物體

模式編號 51。

位置 內容 範圍
官方積木(模式 0)
顏色 物體數 0~8
反射光 物體 1 代碼(色號×10+形狀) 0, 10~89
原始紅 物體 1 X×10+Y(8×6 格,上=小) 0, 11~86
原始綠 物體 2 代碼(色號×10+形狀) ×100 + 物體 2 X×10+Y(8×6 格,上=小) ÷100 拆開
原始藍 物體 3 代碼(色號×10+形狀) ×100 + 物體 3 X×10+Y(8×6 格,上=小) ÷100 拆開
App Python device.data():byte 8~15(14~15 讀不到)
byte 8 物體 4 代碼(色號×10+形狀) 0, 10~89
byte 9 物體 4 X×10+Y(8×6 格,上=小) 0, 11~86
byte 10 物體 5 代碼(色號×10+形狀) 0, 10~89
byte 11 物體 5 X×10+Y(8×6 格,上=小) 0, 11~86
byte 12 物體 6 代碼(色號×10+形狀) 0, 10~89
byte 13 物體 6 X×10+Y(8×6 格,上=小) 0, 11~86
byte 14 物體 7 代碼(色號×10+形狀) 0, 10~89
byte 15 物體 7 X×10+Y(8×6 格,上=小) 0, 11~86
相機模式 5 物體偵測 ② 物體詳細:2 個物體+大小、面積、角度

模式編號 52。

位置 內容 範圍
官方積木(模式 0)
顏色 物體 1 代碼(色號×10+形狀) 0, 10~89
反射光 物體 1 面積(佔畫面 %) 0, 1~100 %
原始紅 物體 1 X(像素) + 物體 1 Y(像素,上=小)×256 餘數、÷256
原始綠 物體 1 寬(像素) + 物體 1 高(像素)×256 餘數、÷256
原始藍 物體 2 代碼(色號×10+形狀) + 物體 2 面積(佔畫面 %)×256 餘數、÷256
App Python device.data():byte 8~15(14~15 讀不到)
byte 8 物體 1 角度 0~179
byte 9 物體 2 X(像素) 0, 1~159
byte 10 物體 2 Y(像素,上=小) 0, 1~119
byte 11 物體 2 寬(像素) 0~160
byte 12 物體 2 高(像素) 0~120
byte 13 物體 2 角度 0~179
byte 14 物體 1 頂點數 0~10
byte 15 物體數 0~8

SPIKE App 家用版(Robot Inventor 藍綠色主機)

這張表是 Robot Inventor App 的積木:讀模式 0,共 8 byte;主機送 0x25 時相機自動換成家用版排法。「顏色」只到 0~10、「反射光」最多 126、「原始紅綠藍」0~255,每格放 1 個值。Python 不看這張:程式執行時主機改送 0x26,相機用教育版排法(看上面教育版的表),hub.port.C.device.get() 回 6 個值=教育版的顏色、反射光、原始紅、綠、藍、byte 8~9;get_reflected_light() 拿到的是教育版「顏色」格,get_color() 只回顏色名稱。

相機模式 1 顏色追蹤 ① 最多色:4 色

模式編號 11。

位置 內容 範圍
官方積木(模式 0)
顏色 色 1 X(8 格) 0, 1~8
反射光 色 1 Y(6 格,上=小) 0, 1~6
原始紅 色 2 X(8 格) ×10 + 色 2 Y(6 格,上=小) ÷10 拆開(同 Kito)
原始綠 色 3 X(8 格) ×10 + 色 3 Y(6 格,上=小) ÷10 拆開(同 Kito)
原始藍 色 4 X(8 格) ×10 + 色 4 Y(6 格,上=小) ÷10 拆開(同 Kito)
相機模式 1 顏色追蹤 ② 多色:4 色

模式編號 12。

位置 內容 範圍
官方積木(模式 0)
顏色 色 1 X(8 格) 0, 1~8
反射光 色 1 Y(6 格,上=小) 0, 1~6
原始紅 色 2 X(8 格) ×10 + 色 2 Y(6 格,上=小) ÷10 拆開(同 Kito)
原始綠 色 3 X(8 格) ×10 + 色 3 Y(6 格,上=小) ÷10 拆開(同 Kito)
原始藍 色 4 X(8 格) ×10 + 色 4 Y(6 格,上=小) ÷10 拆開(同 Kito)
相機模式 1 顏色追蹤 ③ 標準(XY+面積):4 色 XY+面積

模式編號 13。

位置 內容 範圍
官方積木(模式 0)
顏色 色 1 X(8 格) 0, 1~8
反射光 色 1 Y(6 格,上=小) 0, 1~6
原始紅 色 2 X(8 格) ×10 + 色 2 Y(6 格,上=小) ÷10 拆開(同 Kito)
原始綠 色 3 X(8 格) ×10 + 色 3 Y(6 格,上=小) ÷10 拆開(同 Kito)
原始藍 色 4 X(8 格) ×10 + 色 4 Y(6 格,上=小) ÷10 拆開(同 Kito)
相機模式 1 顏色追蹤 ④ 精細(XYWH):2 色 XYWH

模式編號 14。

位置 內容 範圍
官方積木(模式 0)
顏色 色 1 X(8 格) 0, 1~8
反射光 色 1 Y(6 格,上=小) 0, 1~6
原始紅 色 2 X(8 格) ×10 + 色 2 Y(6 格,上=小) ÷10 拆開(同 Kito)
原始綠 色 1 寬(8 格) ×10 + 色 1 高(6 格) ÷10 拆開(同 Kito)
原始藍 色 2 寬(8 格) ×10 + 色 2 高(6 格) ÷10 拆開(同 Kito)
相機模式 2 座標取色 ① 色相:4 點色相

模式編號 21。

位置 內容 範圍
官方積木(模式 0)
顏色 (不用,送 0)
反射光 S4 色相(÷2) 0~127
原始紅 S1 色相 0~255
原始綠 S2 色相 0~255
原始藍 S3 色相 0~255
相機模式 2 座標取色 ② 色相+飽和:2 點色相+飽和

模式編號 22。

位置 內容 範圍
官方積木(模式 0)
顏色 (不用,送 0)
反射光 S2 飽和度 0~100
原始紅 S1 色相 0~255
原始綠 S1 飽和度 0~100
原始藍 S2 色相 0~255
相機模式 2 座標取色 ③ 色相+飽和+明度:2 點色相+飽和明度

模式編號 23。

位置 內容 範圍
官方積木(模式 0)
顏色 (不用,送 0)
反射光 S2 飽和÷10 ×10 + 明度÷10 0~99
原始紅 S1 色相 0~255
原始綠 S1 飽和÷10 ×10 + 明度÷10 0~99
原始藍 S2 色相 0~255
相機模式 3 照順序給色號:3 塊色相碼

模式編號 30。

位置 內容 範圍
官方積木(模式 0)
顏色 (不用,送 0)
反射光 總塊數 0~18
原始紅 左起第 1 塊色相 0~255
原始綠 左起第 2 塊色相 0~255
原始藍 左起第 3 塊色相 0~255
相機模式 4 循線 ①②③ 黑線/白線/色線:5 個值

模式編號 41/42/43。

位置 內容 範圍
官方積木(模式 0)
顏色 路口類型(0 無 1 十字 2 T 3 左 4 右 5 盡頭) 0~5
反射光 近處線寬 % 0~100
原始紅 近處偏移(+100) 0~200
原始綠 遠處偏移(+100) 0~200
原始藍 線角度(+100) 0~200
相機模式 5 物體偵測 ① 物體清單:2 個物體

模式編號 51。

位置 內容 範圍
官方積木(模式 0)
顏色 物體數 0~8
反射光 物體 1 代碼(色號×10+形狀) 0, 10~89
原始紅 物體 1 X×10+Y(8×6 格,上=小) 0, 11~86
原始綠 物體 2 代碼(色號×10+形狀) 0, 10~89
原始藍 物體 2 X×10+Y(8×6 格,上=小) 0, 11~86
相機模式 5 物體偵測 ② 物體詳細:1 個物體+面積

模式編號 52。

位置 內容 範圍
官方積木(模式 0)
顏色 物體數 0~8
反射光 物體 1 代碼(色號×10+形狀) 0, 10~89
原始紅 物體 1 X(像素) 0, 1~159
原始綠 物體 1 Y(像素,上=小) 0, 1~119
原始藍 物體 1 面積(佔畫面 %) 0, 1~100 %

Pybricks 內建積木(不裝函式庫)

不裝 MBC 函式庫,只用 Pybricks 內建的顏色感應器積木:reflection()(模式 5)和 ambient()(模式 7)。顏色追蹤:reflection()=色 1 的 X×100+Y(40×30 格,跟 Kito 版一樣)、ambient()=色 2 的 X.Y(8×6 格)。reflection() 超過 3199 會顯示成負數,加 6399 修回;出貨版韌體的 reflection() 在 Pybricks 3.x、4.1 都是整數。ambient() 一律「整數.小數第一位」(Pybricks 4.1 起只留 1 位小數):A=無條件捨去的整數、B=round(ambient() × 10) % 10。

相機模式 1 顏色追蹤 ① 最多色:2 色

模式編號 11。

位置 內容 範圍
模式 5 reflection()
reflection() 色 1 X(40 格) ×100 + 色 1 Y(30 格,上=小) ÷100 拆開(同 Kito)
模式 7 ambient()
ambient() 色 2 X(8 格) . 色 2 Y(6 格,上=小) A.B(整數.小數第一位)
相機模式 1 顏色追蹤 ② 多色:2 色

模式編號 12。

位置 內容 範圍
模式 5 reflection()
reflection() 色 1 X(40 格) ×100 + 色 1 Y(30 格,上=小) ÷100 拆開(同 Kito)
模式 7 ambient()
ambient() 色 2 X(8 格) . 色 2 Y(6 格,上=小) A.B(整數.小數第一位)
相機模式 1 顏色追蹤 ③ 標準(XY+面積):2 色 XY

模式編號 13。

位置 內容 範圍
模式 5 reflection()
reflection() 色 1 X(40 格) ×100 + 色 1 Y(30 格,上=小) ÷100 拆開(同 Kito)
模式 7 ambient()
ambient() 色 2 X(8 格) . 色 2 Y(6 格,上=小) A.B(整數.小數第一位)
相機模式 1 顏色追蹤 ④ 精細(XYWH):1 色 XYWH

模式編號 14。

位置 內容 範圍
模式 5 reflection()
reflection() 色 1 X(40 格) ×100 + 色 1 Y(30 格,上=小) ÷100 拆開(同 Kito)
模式 7 ambient()
ambient() w8:W1 . h6:H1 A.B(整數.小數第一位)
相機模式 2 座標取色 ① 色相:2 點色相

模式編號 21。

位置 內容 範圍
模式 5 reflection()
reflection() S1 色相 ×10 + S1 飽和度÷10 ÷10 拆開
模式 7 ambient()
ambient() S2 色相 . d10:pS2 A.B(整數.小數第一位)
相機模式 2 座標取色 ② 色相+飽和:2 點色相+飽和

模式編號 22。

位置 內容 範圍
模式 5 reflection()
reflection() S1 色相 ×10 + S1 飽和度÷10 ÷10 拆開
模式 7 ambient()
ambient() S2 色相 . d10:pS2 A.B(整數.小數第一位)
相機模式 2 座標取色 ③ 色相+飽和+明度:1 點原始色相+飽和+明度

模式編號 23。

位置 內容 範圍
模式 5 reflection()
reflection() S1 色相 0~255
模式 7 ambient()
ambient() S1 飽和度 . d10:v1 A.B(整數.小數第一位)
相機模式 3 照順序給色號:2 塊色相碼

模式編號 30。

位置 內容 範圍
模式 5 reflection()
reflection() 左起第 1 塊色相 0~255
模式 7 ambient()
ambient() 左起第 2 塊色相 . c9:total A.B(整數.小數第一位)
相機模式 4 循線 ①②③ 黑線/白線/色線:4 個值

模式編號 41/42/43。

位置 內容 範圍
模式 5 reflection()
reflection() 近處偏移(+100) ×10 + 路口類型(0 無 1 十字 2 T 3 左 4 右 5 盡頭) ÷10 拆開(同 Kito)
模式 7 ambient()
ambient() 遠處偏移(+100) . 有線旗標(近 1+中 2+遠 4) A.B(整數.小數第一位)
相機模式 5 物體偵測 ① 物體清單:1 個物體

模式編號 51。

位置 內容 範圍
模式 5 reflection()
reflection() 物體 1 X(40 格) ×100 + 物體 1 Y(30 格,上=小) ÷100 拆開(同 Kito)
模式 7 ambient()
ambient() 物體 1 代碼(色號×10+形狀) . c9:on A.B(整數.小數第一位)
相機模式 5 物體偵測 ② 物體詳細:1 個物體+面積

模式編號 52。

位置 內容 範圍
模式 5 reflection()
reflection() 物體 1 X(40 格) ×100 + 物體 1 Y(30 格,上=小) ÷100 拆開(同 Kito)
模式 7 ambient()
ambient() 物體 1 代碼(色號×10+形狀) . d10:A1 A.B(整數.小數第一位)

EV3(EV3-G/EV3 Classroom/EV3 MicroPython)

相機在 EV3 顯示成原廠紅外線感應器(type 33)。模式 0 近距=相機模式編號、模式 1 信標 8 個值、模式 2 遙控 4 個值,每個值 int8(−127~100)。子選項 ①、照順序給色號、循線會用到遙控(模式 2),其他層只讀信標;換模式約 0.5 秒。位置用 8×6 格(X×10+Y,Y 下=小)。模式 5=裝置 ID。

相機模式 1 顏色追蹤 ① 最多色:12 色

模式編號 11。

位置 內容 範圍
模式 0 近距(1 個值)
值 相機模式編號(例 13=顏色追蹤 ③ 標準、51=物體偵測 ① 清單) 11~52
模式 1 信標(8 個值)
通道 1 方向 色 1 X×10+Y(8×6 格) 0, 11~86
通道 1 距離 色 2 X×10+Y(8×6 格) 0, 11~86
通道 2 方向 色 3 X×10+Y(8×6 格) 0, 11~86
通道 2 距離 色 4 X×10+Y(8×6 格) 0, 11~86
通道 3 方向 色 5 X×10+Y(8×6 格) 0, 11~86
通道 3 距離 色 6 X×10+Y(8×6 格) 0, 11~86
通道 4 方向 色 7 X×10+Y(8×6 格) 0, 11~86
通道 4 距離 色 8 X×10+Y(8×6 格) 0, 11~86
模式 2 遙控(4 個值)
通道 1 色 9 X×10+Y(8×6 格) 0, 11~86
通道 2 色 10 X×10+Y(8×6 格) 0, 11~86
通道 3 色 11 X×10+Y(8×6 格) 0, 11~86
通道 4 色 12 X×10+Y(8×6 格) 0, 11~86
相機模式 1 顏色追蹤 ② 多色:8 色

模式編號 12。

位置 內容 範圍
模式 0 近距(1 個值)
值 相機模式編號(例 13=顏色追蹤 ③ 標準、51=物體偵測 ① 清單) 11~52
模式 1 信標(8 個值)
通道 1 方向 色 1 X×10+Y(8×6 格) 0, 11~86
通道 1 距離 色 2 X×10+Y(8×6 格) 0, 11~86
通道 2 方向 色 3 X×10+Y(8×6 格) 0, 11~86
通道 2 距離 色 4 X×10+Y(8×6 格) 0, 11~86
通道 3 方向 色 5 X×10+Y(8×6 格) 0, 11~86
通道 3 距離 色 6 X×10+Y(8×6 格) 0, 11~86
通道 4 方向 色 7 X×10+Y(8×6 格) 0, 11~86
通道 4 距離 色 8 X×10+Y(8×6 格) 0, 11~86
模式 2 遙控(4 個值)
通道 1 (不用,送 0)
通道 2 (不用,送 0)
通道 3 (不用,送 0)
通道 4 (不用,送 0)
相機模式 1 顏色追蹤 ③ 標準(XY+面積):4 色 XY+面積

模式編號 13。

位置 內容 範圍
模式 0 近距(1 個值)
值 相機模式編號(例 13=顏色追蹤 ③ 標準、51=物體偵測 ① 清單) 11~52
模式 1 信標(8 個值)
通道 1 方向 色 1 X×10+Y(8×6 格) 0, 11~86
通道 1 距離 色 1 面積(佔畫面 %) 0, 1~100 %
通道 2 方向 色 2 X×10+Y(8×6 格) 0, 11~86
通道 2 距離 色 2 面積(佔畫面 %) 0, 1~100 %
通道 3 方向 色 3 X×10+Y(8×6 格) 0, 11~86
通道 3 距離 色 3 面積(佔畫面 %) 0, 1~100 %
通道 4 方向 色 4 X×10+Y(8×6 格) 0, 11~86
通道 4 距離 色 4 面積(佔畫面 %) 0, 1~100 %
模式 2 遙控(4 個值)
通道 1 (不用,送 0)
通道 2 (不用,送 0)
通道 3 (不用,送 0)
通道 4 (不用,送 0)
相機模式 1 顏色追蹤 ④ 精細(XYWH):2 色 XYWH

模式編號 14。

位置 內容 範圍
模式 0 近距(1 個值)
值 相機模式編號(例 13=顏色追蹤 ③ 標準、51=物體偵測 ① 清單) 11~52
模式 1 信標(8 個值)
通道 1 方向 色 1 X×10+Y(8×6 格) 0, 11~86
通道 1 距離 色 1 W×10+H(8×6 格) 0, 11~86
通道 2 方向 色 1 數量 0~15
通道 2 距離 色 1 面積(佔畫面 %) 0, 1~100 %
通道 3 方向 色 2 X×10+Y(8×6 格) 0, 11~86
通道 3 距離 色 2 W×10+H(8×6 格) 0, 11~86
通道 4 方向 色 2 數量 0~15
通道 4 距離 色 2 面積(佔畫面 %) 0, 1~100 %
模式 2 遙控(4 個值)
通道 1 (不用,送 0)
通道 2 (不用,送 0)
通道 3 (不用,送 0)
通道 4 (不用,送 0)
相機模式 2 座標取色 ① 色相:12 點色相

模式編號 21。

位置 內容 範圍
模式 0 近距(1 個值)
值 相機模式編號(例 13=顏色追蹤 ③ 標準、51=物體偵測 ① 清單) 11~52
模式 1 信標(8 個值)
通道 1 方向 S1 色相(EV3:正=色相、負=黑白) −15~100
通道 1 距離 S2 色相(EV3:正=色相、負=黑白) −15~100
通道 2 方向 S3 色相(EV3:正=色相、負=黑白) −15~100
通道 2 距離 S4 色相(EV3:正=色相、負=黑白) −15~100
通道 3 方向 S5 色相(EV3:正=色相、負=黑白) −15~100
通道 3 距離 S6 色相(EV3:正=色相、負=黑白) −15~100
通道 4 方向 S7 色相(EV3:正=色相、負=黑白) −15~100
通道 4 距離 S8 色相(EV3:正=色相、負=黑白) −15~100
模式 2 遙控(4 個值)
通道 1 S9 色相(EV3:正=色相、負=黑白) −15~100
通道 2 S10 色相(EV3:正=色相、負=黑白) −15~100
通道 3 S11 色相(EV3:正=色相、負=黑白) −15~100
通道 4 S12 色相(EV3:正=色相、負=黑白) −15~100
相機模式 2 座標取色 ② 色相+飽和:4 點色相+飽和明度

模式編號 22。

位置 內容 範圍
模式 0 近距(1 個值)
值 相機模式編號(例 13=顏色追蹤 ③ 標準、51=物體偵測 ① 清單) 11~52
模式 1 信標(8 個值)
通道 1 方向 S1 色相(EV3:正=色相、負=黑白) −15~100
通道 1 距離 S1 飽和÷10 ×10 + 明度÷10 0~99
通道 2 方向 S2 色相(EV3:正=色相、負=黑白) −15~100
通道 2 距離 S2 飽和÷10 ×10 + 明度÷10 0~99
通道 3 方向 S3 色相(EV3:正=色相、負=黑白) −15~100
通道 3 距離 S3 飽和÷10 ×10 + 明度÷10 0~99
通道 4 方向 S4 色相(EV3:正=色相、負=黑白) −15~100
通道 4 距離 S4 飽和÷10 ×10 + 明度÷10 0~99
模式 2 遙控(4 個值)
通道 1 (不用,送 0)
通道 2 (不用,送 0)
通道 3 (不用,送 0)
通道 4 (不用,送 0)
相機模式 2 座標取色 ③ 色相+飽和+明度:2 點原始色相+飽和+明度

模式編號 23。

位置 內容 範圍
模式 0 近距(1 個值)
值 相機模式編號(例 13=顏色追蹤 ③ 標準、51=物體偵測 ① 清單) 11~52
模式 1 信標(8 個值)
通道 1 方向 S1 色相碼 ÷100(百位) 0~2
通道 1 距離 S1 色相碼 除以 100 的餘數 0~99
通道 2 方向 S1 飽和度 0~100
通道 2 距離 S1 明度 0~100
通道 3 方向 S2 色相碼 ÷100(百位) 0~2
通道 3 距離 S2 色相碼 除以 100 的餘數 0~99
通道 4 方向 S2 飽和度 0~100
通道 4 距離 S2 明度 0~100
模式 2 遙控(4 個值)
通道 1 (不用,送 0)
通道 2 (不用,送 0)
通道 3 (不用,送 0)
通道 4 (不用,送 0)
相機模式 3 照順序給色號:11 塊色相碼

模式編號 30。

位置 內容 範圍
模式 0 近距(1 個值)
值 相機模式編號(例 13=顏色追蹤 ③ 標準、51=物體偵測 ① 清單) 11~52
模式 1 信標(8 個值)
通道 1 方向 左起第 1 塊色相(EV3:正=色相、負=黑白) −15~100
通道 1 距離 左起第 2 塊色相(EV3:正=色相、負=黑白) −15~100
通道 2 方向 左起第 3 塊色相(EV3:正=色相、負=黑白) −15~100
通道 2 距離 左起第 4 塊色相(EV3:正=色相、負=黑白) −15~100
通道 3 方向 左起第 5 塊色相(EV3:正=色相、負=黑白) −15~100
通道 3 距離 左起第 6 塊色相(EV3:正=色相、負=黑白) −15~100
通道 4 方向 左起第 7 塊色相(EV3:正=色相、負=黑白) −15~100
通道 4 距離 左起第 8 塊色相(EV3:正=色相、負=黑白) −15~100
模式 2 遙控(4 個值)
通道 1 左起第 9 塊色相(EV3:正=色相、負=黑白) −15~100
通道 2 左起第 10 塊色相(EV3:正=色相、負=黑白) −15~100
通道 3 左起第 11 塊色相(EV3:正=色相、負=黑白) −15~100
通道 4 總塊數 0~18
相機模式 4 循線 ①②③ 黑線/白線/色線:12 個值

模式編號 41/42/43。

位置 內容 範圍
模式 0 近距(1 個值)
值 相機模式編號(例 13=顏色追蹤 ③ 標準、51=物體偵測 ① 清單) 11~52
模式 1 信標(8 個值)
通道 1 方向 近處偏移 −100~100
通道 1 距離 中段偏移 −100~100
通道 2 方向 遠處偏移 −100~100
通道 2 距離 線角度 −90~90
通道 3 方向 近處線寬 % 0~100
通道 3 距離 路口類型×10+有線旗標 0~57
通道 4 方向 路口距離 % 0~100
通道 4 距離 穿過的彩色標記線色號 0, 1~16
模式 2 遙控(4 個值)
通道 1 近處線左緣 −100~100
通道 2 近處線右緣 −100~100
通道 3 遠處線寬 % 0~100
通道 4 標記線累計條數 0~99
相機模式 5 物體偵測 ① 物體清單:5 個物體

模式編號 51。

位置 內容 範圍
模式 0 近距(1 個值)
值 相機模式編號(例 13=顏色追蹤 ③ 標準、51=物體偵測 ① 清單) 11~52
模式 1 信標(8 個值)
通道 1 方向 物體 1 代碼(色號×10+形狀) 0, 10~89
通道 1 距離 物體 1 X×10+Y(8×6 格) 0, 11~86
通道 2 方向 物體 2 代碼(色號×10+形狀) 0, 10~89
通道 2 距離 物體 2 X×10+Y(8×6 格) 0, 11~86
通道 3 方向 物體 3 代碼(色號×10+形狀) 0, 10~89
通道 3 距離 物體 3 X×10+Y(8×6 格) 0, 11~86
通道 4 方向 物體 4 代碼(色號×10+形狀) 0, 10~89
通道 4 距離 物體 4 X×10+Y(8×6 格) 0, 11~86
模式 2 遙控(4 個值)
通道 1 物體 5 代碼(色號×10+形狀) 0, 10~89
通道 2 物體 5 X×10+Y(8×6 格) 0, 11~86
通道 3 (不用,送 0)
通道 4 物體數 0~8
相機模式 5 物體偵測 ② 物體詳細:2 個物體+面積、角度

模式編號 52。

位置 內容 範圍
模式 0 近距(1 個值)
值 相機模式編號(例 13=顏色追蹤 ③ 標準、51=物體偵測 ① 清單) 11~52
模式 1 信標(8 個值)
通道 1 方向 物體 1 代碼(色號×10+形狀) 0, 10~89
通道 1 距離 物體 1 X×10+Y(8×6 格) 0, 11~86
通道 2 方向 物體 1 面積(佔畫面 %) 0, 1~100 %
通道 2 距離 物體 1 角度((角度+1)÷2) 0~90
通道 3 方向 物體 2 代碼(色號×10+形狀) 0, 10~89
通道 3 距離 物體 2 X×10+Y(8×6 格) 0, 11~86
通道 4 方向 物體 2 面積(佔畫面 %) 0, 1~100 %
通道 4 距離 物體 2 角度((角度+1)÷2) 0~90
模式 2 遙控(4 個值)
通道 1 (不用,送 0)
通道 2 (不用,送 0)
通道 3 (不用,送 0)
通道 4 (不用,送 0)

MATRIX Mini R4(mVision 10 格)

MATRIX Mini R4 用 MATRIXblock 的 mVision 積木讀:10 格 uint16(表上的「格 1」=積木的「資料 0」)。一格放 2 個 byte 值(A+B×256,取餘數、÷256 拆)或一個像素座標;座標用 160×120 像素(Y 上=小),0=沒有目標;會有負數的值加 100 送。

相機模式 1 顏色追蹤 ① 最多色:16 色

模式編號 11。

位置 內容 範圍
mVision 10 格
格 1 色 1 X×10+Y(8×6 格,上=小) ×100 + 色 2 X×10+Y(8×6 格,上=小) ÷100 拆開
格 2 色 3 X×10+Y(8×6 格,上=小) ×100 + 色 4 X×10+Y(8×6 格,上=小) ÷100 拆開
格 3 色 5 X×10+Y(8×6 格,上=小) ×100 + 色 6 X×10+Y(8×6 格,上=小) ÷100 拆開
格 4 色 7 X×10+Y(8×6 格,上=小) ×100 + 色 8 X×10+Y(8×6 格,上=小) ÷100 拆開
格 5 色 9 X×10+Y(8×6 格,上=小) ×100 + 色 10 X×10+Y(8×6 格,上=小) ÷100 拆開
格 6 色 11 X×10+Y(8×6 格,上=小) ×100 + 色 12 X×10+Y(8×6 格,上=小) ÷100 拆開
格 7 色 13 X×10+Y(8×6 格,上=小) ×100 + 色 14 X×10+Y(8×6 格,上=小) ÷100 拆開
格 8 色 15 X×10+Y(8×6 格,上=小) ×100 + 色 16 X×10+Y(8×6 格,上=小) ÷100 拆開
格 9 找到幾色 0~16
格 10 (不用,送 0)
相機模式 1 顏色追蹤 ② 多色:10 色

模式編號 12。

位置 內容 範圍
mVision 10 格
格 1 色 1 X(像素) + 色 1 Y(像素,上=小)×256 餘數、÷256
格 2 色 2 X(像素) + 色 2 Y(像素,上=小)×256 餘數、÷256
格 3 色 3 X(像素) + 色 3 Y(像素,上=小)×256 餘數、÷256
格 4 色 4 X(像素) + 色 4 Y(像素,上=小)×256 餘數、÷256
格 5 色 5 X(像素) + 色 5 Y(像素,上=小)×256 餘數、÷256
格 6 色 6 X(像素) + 色 6 Y(像素,上=小)×256 餘數、÷256
格 7 色 7 X(像素) + 色 7 Y(像素,上=小)×256 餘數、÷256
格 8 色 8 X(像素) + 色 8 Y(像素,上=小)×256 餘數、÷256
格 9 色 9 X(像素) + 色 9 Y(像素,上=小)×256 餘數、÷256
格 10 色 10 X(像素) + 色 10 Y(像素,上=小)×256 餘數、÷256
相機模式 1 顏色追蹤 ③ 標準(XY+面積):5 色 XY+面積

模式編號 13。

位置 內容 範圍
mVision 10 格
格 1 色 1 X(像素) + 色 1 Y(像素,上=小)×256 餘數、÷256
格 2 色 1 面積(佔畫面 %) + 色 1 數量×256 餘數、÷256
格 3 色 2 X(像素) + 色 2 Y(像素,上=小)×256 餘數、÷256
格 4 色 2 面積(佔畫面 %) + 色 2 數量×256 餘數、÷256
格 5 色 3 X(像素) + 色 3 Y(像素,上=小)×256 餘數、÷256
格 6 色 3 面積(佔畫面 %) + 色 3 數量×256 餘數、÷256
格 7 色 4 X(像素) + 色 4 Y(像素,上=小)×256 餘數、÷256
格 8 色 4 面積(佔畫面 %) + 色 4 數量×256 餘數、÷256
格 9 色 5 X(像素) + 色 5 Y(像素,上=小)×256 餘數、÷256
格 10 色 5 面積(佔畫面 %) + 色 5 數量×256 餘數、÷256
相機模式 1 顏色追蹤 ④ 精細(XYWH):3 色 XYWH

模式編號 14。

位置 內容 範圍
mVision 10 格
格 1 色 1 X(像素) + 色 1 Y(像素,上=小)×256 餘數、÷256
格 2 色 1 寬(像素) + 色 1 高(像素)×256 餘數、÷256
格 3 色 1 面積(佔畫面 %) + 色 1 數量×256 餘數、÷256
格 4 色 2 X(像素) + 色 2 Y(像素,上=小)×256 餘數、÷256
格 5 色 2 寬(像素) + 色 2 高(像素)×256 餘數、÷256
格 6 色 2 面積(佔畫面 %) + 色 2 數量×256 餘數、÷256
格 7 色 3 X(像素) + 色 3 Y(像素,上=小)×256 餘數、÷256
格 8 色 3 寬(像素) + 色 3 高(像素)×256 餘數、÷256
格 9 色 3 面積(佔畫面 %) + 色 3 數量×256 餘數、÷256
格 10 找到幾色 0~16
相機模式 2 座標取色 ① 色相:20 點色相

模式編號 21。

位置 內容 範圍
mVision 10 格
格 1 S1 色相 + S2 色相×256 餘數、÷256
格 2 S3 色相 + S4 色相×256 餘數、÷256
格 3 S5 色相 + S6 色相×256 餘數、÷256
格 4 S7 色相 + S8 色相×256 餘數、÷256
格 5 S9 色相 + S10 色相×256 餘數、÷256
格 6 S11 色相 + S12 色相×256 餘數、÷256
格 7 S13 色相 + S14 色相×256 餘數、÷256
格 8 S15 色相 + S16 色相×256 餘數、÷256
格 9 S17 色相 + S18 色相×256 餘數、÷256
格 10 S19 色相 + S20 色相×256 餘數、÷256
相機模式 2 座標取色 ② 色相+飽和:10 點色相+飽和

模式編號 22。

位置 內容 範圍
mVision 10 格
格 1 S1 色相 + S1 飽和度×256 餘數、÷256
格 2 S2 色相 + S2 飽和度×256 餘數、÷256
格 3 S3 色相 + S3 飽和度×256 餘數、÷256
格 4 S4 色相 + S4 飽和度×256 餘數、÷256
格 5 S5 色相 + S5 飽和度×256 餘數、÷256
格 6 S6 色相 + S6 飽和度×256 餘數、÷256
格 7 S7 色相 + S7 飽和度×256 餘數、÷256
格 8 S8 色相 + S8 飽和度×256 餘數、÷256
格 9 S9 色相 + S9 飽和度×256 餘數、÷256
格 10 S10 色相 + S10 飽和度×256 餘數、÷256
相機模式 2 座標取色 ③ 色相+飽和+明度:6 點色相+飽和+明度

模式編號 23。

位置 內容 範圍
mVision 10 格
格 1 S1 色相 + S1 飽和度×256 餘數、÷256
格 2 S1 明度 + S2 色相×256 餘數、÷256
格 3 S2 飽和度 + S2 明度×256 餘數、÷256
格 4 S3 色相 + S3 飽和度×256 餘數、÷256
格 5 S3 明度 + S4 色相×256 餘數、÷256
格 6 S4 飽和度 + S4 明度×256 餘數、÷256
格 7 S5 色相 + S5 飽和度×256 餘數、÷256
格 8 S5 明度 + S6 色相×256 餘數、÷256
格 9 S6 飽和度 + S6 明度×256 餘數、÷256
格 10 (不用,送 0)
相機模式 3 照順序給色號:18 塊色相碼

模式編號 30。

位置 內容 範圍
mVision 10 格
格 1 左起第 1 塊色相 + 左起第 2 塊色相×256 餘數、÷256
格 2 左起第 3 塊色相 + 左起第 4 塊色相×256 餘數、÷256
格 3 左起第 5 塊色相 + 左起第 6 塊色相×256 餘數、÷256
格 4 左起第 7 塊色相 + 左起第 8 塊色相×256 餘數、÷256
格 5 左起第 9 塊色相 + 左起第 10 塊色相×256 餘數、÷256
格 6 左起第 11 塊色相 + 左起第 12 塊色相×256 餘數、÷256
格 7 左起第 13 塊色相 + 左起第 14 塊色相×256 餘數、÷256
格 8 左起第 15 塊色相 + 左起第 16 塊色相×256 餘數、÷256
格 9 左起第 17 塊色相 + 左起第 18 塊色相×256 餘數、÷256
格 10 總塊數 0~18
相機模式 4 循線 ①②③ 黑線/白線/色線:14 個值

模式編號 41/42/43。

位置 內容 範圍
mVision 10 格
格 1 近處偏移(+100) 0~200
格 2 中段偏移(+100) 0~200
格 3 遠處偏移(+100) 0~200
格 4 線角度(+100) 0~200
格 5 路口類型(0 無 1 十字 2 T 3 左 4 右 5 盡頭) 0~5
格 6 有線旗標(近 1+中 2+遠 4) 0~7
格 7 近處線寬 % + 路口距離 %×256 餘數、÷256
格 8 近處線左緣(+100) + 近處線右緣(+100)×256 餘數、÷256
格 9 遠處線寬 % + 穿過的彩色標記線色號×256 餘數、÷256
格 10 標記線累計條數 + 最後離線方向(0 有線 1 左 2 右)×256 餘數、÷256
相機模式 5 物體偵測 ① 物體清單:4 個物體

模式編號 51。

位置 內容 範圍
mVision 10 格
格 1 物體數 0~8
格 2 物體 1 代碼(色號×10+形狀) + 物體 1 面積(佔畫面 %)×256 餘數、÷256
格 3 物體 1 X(像素) + 物體 1 Y(像素,上=小)×256 餘數、÷256
格 4 物體 2 代碼(色號×10+形狀) + 物體 2 面積(佔畫面 %)×256 餘數、÷256
格 5 物體 2 X(像素) + 物體 2 Y(像素,上=小)×256 餘數、÷256
格 6 物體 3 代碼(色號×10+形狀) + 物體 3 面積(佔畫面 %)×256 餘數、÷256
格 7 物體 3 X(像素) + 物體 3 Y(像素,上=小)×256 餘數、÷256
格 8 物體 4 代碼(色號×10+形狀) + 物體 4 面積(佔畫面 %)×256 餘數、÷256
格 9 物體 4 X(像素) + 物體 4 Y(像素,上=小)×256 餘數、÷256
格 10 (不用,送 0)
相機模式 5 物體偵測 ② 物體詳細:3 個物體+大小、面積

模式編號 52。

位置 內容 範圍
mVision 10 格
格 1 物體數 0~8
格 2 物體 1 代碼(色號×10+形狀) + 物體 1 面積(佔畫面 %)×256 餘數、÷256
格 3 物體 1 X(像素) + 物體 1 Y(像素,上=小)×256 餘數、÷256
格 4 物體 1 寬(像素) + 物體 1 高(像素)×256 餘數、÷256
格 5 物體 2 代碼(色號×10+形狀) + 物體 2 面積(佔畫面 %)×256 餘數、÷256
格 6 物體 2 X(像素) + 物體 2 Y(像素,上=小)×256 餘數、÷256
格 7 物體 2 寬(像素) + 物體 2 高(像素)×256 餘數、÷256
格 8 物體 3 代碼(色號×10+形狀) + 物體 3 面積(佔畫面 %)×256 餘數、÷256
格 9 物體 3 X(像素) + 物體 3 Y(像素,上=小)×256 餘數、÷256
格 10 物體 3 寬(像素) + 物體 3 高(像素)×256 餘數、÷256

I2C 0x4C(Arduino/micro:bit)

I2C 位址 0x4C(Arduino、ESP32、UNO R4、micro:bit)。暫存器連續讀,不受格數限制:寫值編號 → 等 2 ms → 讀 2×k byte(int16 小端),一次最多 16 個值。表上的「值 1」=編號 0x10、「值 2」=0x11,依序往下。座標用 160×120 像素(Y 上=小),0=沒有目標;負數照原值送。每一層都給 16 色/16 點,層級只決定給哪些值。mBlock(mBot 等 Makeblock 主板)讀同一張值表:UART 38400,送 1 byte [編號] → 回 [值低][值高][編號^值低^值高]。

相機模式 1 顏色追蹤 ① 最多色:16 色 XY

模式編號 11。

位置 內容 範圍
讀(值編號照順序)
值 1 · 0x10 色 1 X(像素) 0, 1~159
值 2 · 0x11 色 1 Y(像素,上=小) 0, 1~119
值 3 · 0x12 色 2 X(像素) 0, 1~159
值 4 · 0x13 色 2 Y(像素,上=小) 0, 1~119
值 5 · 0x14 色 3 X(像素) 0, 1~159
值 6 · 0x15 色 3 Y(像素,上=小) 0, 1~119
值 7 · 0x16 色 4 X(像素) 0, 1~159
值 8 · 0x17 色 4 Y(像素,上=小) 0, 1~119
值 9 · 0x18 色 5 X(像素) 0, 1~159
值 10 · 0x19 色 5 Y(像素,上=小) 0, 1~119
值 11 · 0x1A 色 6 X(像素) 0, 1~159
值 12 · 0x1B 色 6 Y(像素,上=小) 0, 1~119
值 13 · 0x1C 色 7 X(像素) 0, 1~159
值 14 · 0x1D 色 7 Y(像素,上=小) 0, 1~119
值 15 · 0x1E 色 8 X(像素) 0, 1~159
值 16 · 0x1F 色 8 Y(像素,上=小) 0, 1~119
值 17 · 0x20 色 9 X(像素) 0, 1~159
值 18 · 0x21 色 9 Y(像素,上=小) 0, 1~119
值 19 · 0x22 色 10 X(像素) 0, 1~159
值 20 · 0x23 色 10 Y(像素,上=小) 0, 1~119
值 21 · 0x24 色 11 X(像素) 0, 1~159
值 22 · 0x25 色 11 Y(像素,上=小) 0, 1~119
值 23 · 0x26 色 12 X(像素) 0, 1~159
值 24 · 0x27 色 12 Y(像素,上=小) 0, 1~119
值 25 · 0x28 色 13 X(像素) 0, 1~159
值 26 · 0x29 色 13 Y(像素,上=小) 0, 1~119
值 27 · 0x2A 色 14 X(像素) 0, 1~159
值 28 · 0x2B 色 14 Y(像素,上=小) 0, 1~119
值 29 · 0x2C 色 15 X(像素) 0, 1~159
值 30 · 0x2D 色 15 Y(像素,上=小) 0, 1~119
值 31 · 0x2E 色 16 X(像素) 0, 1~159
值 32 · 0x2F 色 16 Y(像素,上=小) 0, 1~119
值 33 · 0x30 找到幾色 0~16
寫
切換模式與子選項;設定目標色、最小面積門檻、取樣點位置
相機模式 1 顏色追蹤 ② 多色:16 色 XY+數量

模式編號 12。

位置 內容 範圍
讀(值編號照順序)
值 1 · 0x10 色 1 X(像素) 0, 1~159
值 2 · 0x11 色 1 Y(像素,上=小) 0, 1~119
值 3 · 0x12 色 1 數量 0~15
值 4 · 0x13 色 2 X(像素) 0, 1~159
值 5 · 0x14 色 2 Y(像素,上=小) 0, 1~119
值 6 · 0x15 色 2 數量 0~15
值 7 · 0x16 色 3 X(像素) 0, 1~159
值 8 · 0x17 色 3 Y(像素,上=小) 0, 1~119
值 9 · 0x18 色 3 數量 0~15
值 10 · 0x19 色 4 X(像素) 0, 1~159
值 11 · 0x1A 色 4 Y(像素,上=小) 0, 1~119
值 12 · 0x1B 色 4 數量 0~15
值 13 · 0x1C 色 5 X(像素) 0, 1~159
值 14 · 0x1D 色 5 Y(像素,上=小) 0, 1~119
值 15 · 0x1E 色 5 數量 0~15
值 16 · 0x1F 色 6 X(像素) 0, 1~159
值 17 · 0x20 色 6 Y(像素,上=小) 0, 1~119
值 18 · 0x21 色 6 數量 0~15
值 19 · 0x22 色 7 X(像素) 0, 1~159
值 20 · 0x23 色 7 Y(像素,上=小) 0, 1~119
值 21 · 0x24 色 7 數量 0~15
值 22 · 0x25 色 8 X(像素) 0, 1~159
值 23 · 0x26 色 8 Y(像素,上=小) 0, 1~119
值 24 · 0x27 色 8 數量 0~15
值 25 · 0x28 色 9 X(像素) 0, 1~159
值 26 · 0x29 色 9 Y(像素,上=小) 0, 1~119
值 27 · 0x2A 色 9 數量 0~15
值 28 · 0x2B 色 10 X(像素) 0, 1~159
值 29 · 0x2C 色 10 Y(像素,上=小) 0, 1~119
值 30 · 0x2D 色 10 數量 0~15
值 31 · 0x2E 色 11 X(像素) 0, 1~159
值 32 · 0x2F 色 11 Y(像素,上=小) 0, 1~119
值 33 · 0x30 色 11 數量 0~15
值 34 · 0x31 色 12 X(像素) 0, 1~159
值 35 · 0x32 色 12 Y(像素,上=小) 0, 1~119
值 36 · 0x33 色 12 數量 0~15
值 37 · 0x34 色 13 X(像素) 0, 1~159
值 38 · 0x35 色 13 Y(像素,上=小) 0, 1~119
值 39 · 0x36 色 13 數量 0~15
值 40 · 0x37 色 14 X(像素) 0, 1~159
值 41 · 0x38 色 14 Y(像素,上=小) 0, 1~119
值 42 · 0x39 色 14 數量 0~15
值 43 · 0x3A 色 15 X(像素) 0, 1~159
值 44 · 0x3B 色 15 Y(像素,上=小) 0, 1~119
值 45 · 0x3C 色 15 數量 0~15
值 46 · 0x3D 色 16 X(像素) 0, 1~159
值 47 · 0x3E 色 16 Y(像素,上=小) 0, 1~119
值 48 · 0x3F 色 16 數量 0~15
值 49 · 0x40 找到幾色 0~16
寫
切換模式與子選項;設定目標色、最小面積門檻、取樣點位置
相機模式 1 顏色追蹤 ③ 標準(XY+面積):16 色 XY+面積+數量

模式編號 13。

位置 內容 範圍
讀(值編號照順序)
值 1 · 0x10 色 1 X(像素) 0, 1~159
值 2 · 0x11 色 1 Y(像素,上=小) 0, 1~119
值 3 · 0x12 色 1 面積(佔畫面 %) 0, 1~100 %
值 4 · 0x13 色 1 數量 0~15
值 5 · 0x14 色 2 X(像素) 0, 1~159
值 6 · 0x15 色 2 Y(像素,上=小) 0, 1~119
值 7 · 0x16 色 2 面積(佔畫面 %) 0, 1~100 %
值 8 · 0x17 色 2 數量 0~15
值 9 · 0x18 色 3 X(像素) 0, 1~159
值 10 · 0x19 色 3 Y(像素,上=小) 0, 1~119
值 11 · 0x1A 色 3 面積(佔畫面 %) 0, 1~100 %
值 12 · 0x1B 色 3 數量 0~15
值 13 · 0x1C 色 4 X(像素) 0, 1~159
值 14 · 0x1D 色 4 Y(像素,上=小) 0, 1~119
值 15 · 0x1E 色 4 面積(佔畫面 %) 0, 1~100 %
值 16 · 0x1F 色 4 數量 0~15
值 17 · 0x20 色 5 X(像素) 0, 1~159
值 18 · 0x21 色 5 Y(像素,上=小) 0, 1~119
值 19 · 0x22 色 5 面積(佔畫面 %) 0, 1~100 %
值 20 · 0x23 色 5 數量 0~15
值 21 · 0x24 色 6 X(像素) 0, 1~159
值 22 · 0x25 色 6 Y(像素,上=小) 0, 1~119
值 23 · 0x26 色 6 面積(佔畫面 %) 0, 1~100 %
值 24 · 0x27 色 6 數量 0~15
值 25 · 0x28 色 7 X(像素) 0, 1~159
值 26 · 0x29 色 7 Y(像素,上=小) 0, 1~119
值 27 · 0x2A 色 7 面積(佔畫面 %) 0, 1~100 %
值 28 · 0x2B 色 7 數量 0~15
值 29 · 0x2C 色 8 X(像素) 0, 1~159
值 30 · 0x2D 色 8 Y(像素,上=小) 0, 1~119
值 31 · 0x2E 色 8 面積(佔畫面 %) 0, 1~100 %
值 32 · 0x2F 色 8 數量 0~15
值 33 · 0x30 色 9 X(像素) 0, 1~159
值 34 · 0x31 色 9 Y(像素,上=小) 0, 1~119
值 35 · 0x32 色 9 面積(佔畫面 %) 0, 1~100 %
值 36 · 0x33 色 9 數量 0~15
值 37 · 0x34 色 10 X(像素) 0, 1~159
值 38 · 0x35 色 10 Y(像素,上=小) 0, 1~119
值 39 · 0x36 色 10 面積(佔畫面 %) 0, 1~100 %
值 40 · 0x37 色 10 數量 0~15
值 41 · 0x38 色 11 X(像素) 0, 1~159
值 42 · 0x39 色 11 Y(像素,上=小) 0, 1~119
值 43 · 0x3A 色 11 面積(佔畫面 %) 0, 1~100 %
值 44 · 0x3B 色 11 數量 0~15
值 45 · 0x3C 色 12 X(像素) 0, 1~159
值 46 · 0x3D 色 12 Y(像素,上=小) 0, 1~119
值 47 · 0x3E 色 12 面積(佔畫面 %) 0, 1~100 %
值 48 · 0x3F 色 12 數量 0~15
值 49 · 0x40 色 13 X(像素) 0, 1~159
值 50 · 0x41 色 13 Y(像素,上=小) 0, 1~119
值 51 · 0x42 色 13 面積(佔畫面 %) 0, 1~100 %
值 52 · 0x43 色 13 數量 0~15
值 53 · 0x44 色 14 X(像素) 0, 1~159
值 54 · 0x45 色 14 Y(像素,上=小) 0, 1~119
值 55 · 0x46 色 14 面積(佔畫面 %) 0, 1~100 %
值 56 · 0x47 色 14 數量 0~15
值 57 · 0x48 色 15 X(像素) 0, 1~159
值 58 · 0x49 色 15 Y(像素,上=小) 0, 1~119
值 59 · 0x4A 色 15 面積(佔畫面 %) 0, 1~100 %
值 60 · 0x4B 色 15 數量 0~15
值 61 · 0x4C 色 16 X(像素) 0, 1~159
值 62 · 0x4D 色 16 Y(像素,上=小) 0, 1~119
值 63 · 0x4E 色 16 面積(佔畫面 %) 0, 1~100 %
值 64 · 0x4F 色 16 數量 0~15
值 65 · 0x50 找到幾色 0~16
寫
切換模式與子選項;設定目標色、最小面積門檻、取樣點位置
相機模式 1 顏色追蹤 ④ 精細(XYWH):16 色 XYWH+數量+面積

模式編號 14。

位置 內容 範圍
讀(值編號照順序)
值 1 · 0x10 色 1 X(像素) 0, 1~159
值 2 · 0x11 色 1 Y(像素,上=小) 0, 1~119
值 3 · 0x12 色 1 寬(像素) 0~160
值 4 · 0x13 色 1 高(像素) 0~120
值 5 · 0x14 色 1 數量 0~15
值 6 · 0x15 色 1 面積(佔畫面 %) 0, 1~100 %
值 7 · 0x16 色 2 X(像素) 0, 1~159
值 8 · 0x17 色 2 Y(像素,上=小) 0, 1~119
值 9 · 0x18 色 2 寬(像素) 0~160
值 10 · 0x19 色 2 高(像素) 0~120
值 11 · 0x1A 色 2 數量 0~15
值 12 · 0x1B 色 2 面積(佔畫面 %) 0, 1~100 %
值 13 · 0x1C 色 3 X(像素) 0, 1~159
值 14 · 0x1D 色 3 Y(像素,上=小) 0, 1~119
值 15 · 0x1E 色 3 寬(像素) 0~160
值 16 · 0x1F 色 3 高(像素) 0~120
值 17 · 0x20 色 3 數量 0~15
值 18 · 0x21 色 3 面積(佔畫面 %) 0, 1~100 %
值 19 · 0x22 色 4 X(像素) 0, 1~159
值 20 · 0x23 色 4 Y(像素,上=小) 0, 1~119
值 21 · 0x24 色 4 寬(像素) 0~160
值 22 · 0x25 色 4 高(像素) 0~120
值 23 · 0x26 色 4 數量 0~15
值 24 · 0x27 色 4 面積(佔畫面 %) 0, 1~100 %
值 25 · 0x28 色 5 X(像素) 0, 1~159
值 26 · 0x29 色 5 Y(像素,上=小) 0, 1~119
值 27 · 0x2A 色 5 寬(像素) 0~160
值 28 · 0x2B 色 5 高(像素) 0~120
值 29 · 0x2C 色 5 數量 0~15
值 30 · 0x2D 色 5 面積(佔畫面 %) 0, 1~100 %
值 31 · 0x2E 色 6 X(像素) 0, 1~159
值 32 · 0x2F 色 6 Y(像素,上=小) 0, 1~119
值 33 · 0x30 色 6 寬(像素) 0~160
值 34 · 0x31 色 6 高(像素) 0~120
值 35 · 0x32 色 6 數量 0~15
值 36 · 0x33 色 6 面積(佔畫面 %) 0, 1~100 %
值 37 · 0x34 色 7 X(像素) 0, 1~159
值 38 · 0x35 色 7 Y(像素,上=小) 0, 1~119
值 39 · 0x36 色 7 寬(像素) 0~160
值 40 · 0x37 色 7 高(像素) 0~120
值 41 · 0x38 色 7 數量 0~15
值 42 · 0x39 色 7 面積(佔畫面 %) 0, 1~100 %
值 43 · 0x3A 色 8 X(像素) 0, 1~159
值 44 · 0x3B 色 8 Y(像素,上=小) 0, 1~119
值 45 · 0x3C 色 8 寬(像素) 0~160
值 46 · 0x3D 色 8 高(像素) 0~120
值 47 · 0x3E 色 8 數量 0~15
值 48 · 0x3F 色 8 面積(佔畫面 %) 0, 1~100 %
值 49 · 0x40 色 9 X(像素) 0, 1~159
值 50 · 0x41 色 9 Y(像素,上=小) 0, 1~119
值 51 · 0x42 色 9 寬(像素) 0~160
值 52 · 0x43 色 9 高(像素) 0~120
值 53 · 0x44 色 9 數量 0~15
值 54 · 0x45 色 9 面積(佔畫面 %) 0, 1~100 %
值 55 · 0x46 色 10 X(像素) 0, 1~159
值 56 · 0x47 色 10 Y(像素,上=小) 0, 1~119
值 57 · 0x48 色 10 寬(像素) 0~160
值 58 · 0x49 色 10 高(像素) 0~120
值 59 · 0x4A 色 10 數量 0~15
值 60 · 0x4B 色 10 面積(佔畫面 %) 0, 1~100 %
值 61 · 0x4C 色 11 X(像素) 0, 1~159
值 62 · 0x4D 色 11 Y(像素,上=小) 0, 1~119
值 63 · 0x4E 色 11 寬(像素) 0~160
值 64 · 0x4F 色 11 高(像素) 0~120
值 65 · 0x50 色 11 數量 0~15
值 66 · 0x51 色 11 面積(佔畫面 %) 0, 1~100 %
值 67 · 0x52 色 12 X(像素) 0, 1~159
值 68 · 0x53 色 12 Y(像素,上=小) 0, 1~119
值 69 · 0x54 色 12 寬(像素) 0~160
值 70 · 0x55 色 12 高(像素) 0~120
值 71 · 0x56 色 12 數量 0~15
值 72 · 0x57 色 12 面積(佔畫面 %) 0, 1~100 %
值 73 · 0x58 色 13 X(像素) 0, 1~159
值 74 · 0x59 色 13 Y(像素,上=小) 0, 1~119
值 75 · 0x5A 色 13 寬(像素) 0~160
值 76 · 0x5B 色 13 高(像素) 0~120
值 77 · 0x5C 色 13 數量 0~15
值 78 · 0x5D 色 13 面積(佔畫面 %) 0, 1~100 %
值 79 · 0x5E 色 14 X(像素) 0, 1~159
值 80 · 0x5F 色 14 Y(像素,上=小) 0, 1~119
值 81 · 0x60 色 14 寬(像素) 0~160
值 82 · 0x61 色 14 高(像素) 0~120
值 83 · 0x62 色 14 數量 0~15
值 84 · 0x63 色 14 面積(佔畫面 %) 0, 1~100 %
值 85 · 0x64 色 15 X(像素) 0, 1~159
值 86 · 0x65 色 15 Y(像素,上=小) 0, 1~119
值 87 · 0x66 色 15 寬(像素) 0~160
值 88 · 0x67 色 15 高(像素) 0~120
值 89 · 0x68 色 15 數量 0~15
值 90 · 0x69 色 15 面積(佔畫面 %) 0, 1~100 %
值 91 · 0x6A 色 16 X(像素) 0, 1~159
值 92 · 0x6B 色 16 Y(像素,上=小) 0, 1~119
值 93 · 0x6C 色 16 寬(像素) 0~160
值 94 · 0x6D 色 16 高(像素) 0~120
值 95 · 0x6E 色 16 數量 0~15
值 96 · 0x6F 色 16 面積(佔畫面 %) 0, 1~100 %
值 97 · 0x70 找到幾色 0~16
寫
切換模式與子選項;設定目標色、最小面積門檻、取樣點位置
相機模式 2 座標取色 ① 色相:16 點色相

模式編號 21。

位置 內容 範圍
讀(值編號照順序)
值 1 · 0x10 S1 色相 0~255
值 2 · 0x11 S2 色相 0~255
值 3 · 0x12 S3 色相 0~255
值 4 · 0x13 S4 色相 0~255
值 5 · 0x14 S5 色相 0~255
值 6 · 0x15 S6 色相 0~255
值 7 · 0x16 S7 色相 0~255
值 8 · 0x17 S8 色相 0~255
值 9 · 0x18 S9 色相 0~255
值 10 · 0x19 S10 色相 0~255
值 11 · 0x1A S11 色相 0~255
值 12 · 0x1B S12 色相 0~255
值 13 · 0x1C S13 色相 0~255
值 14 · 0x1D S14 色相 0~255
值 15 · 0x1E S15 色相 0~255
值 16 · 0x1F S16 色相 0~255
寫
切換模式與子選項;設定目標色、最小面積門檻、取樣點位置
相機模式 2 座標取色 ② 色相+飽和:16 點色相+飽和

模式編號 22。

位置 內容 範圍
讀(值編號照順序)
值 1 · 0x10 S1 色相 0~255
值 2 · 0x11 S1 飽和度 0~100
值 3 · 0x12 S2 色相 0~255
值 4 · 0x13 S2 飽和度 0~100
值 5 · 0x14 S3 色相 0~255
值 6 · 0x15 S3 飽和度 0~100
值 7 · 0x16 S4 色相 0~255
值 8 · 0x17 S4 飽和度 0~100
值 9 · 0x18 S5 色相 0~255
值 10 · 0x19 S5 飽和度 0~100
值 11 · 0x1A S6 色相 0~255
值 12 · 0x1B S6 飽和度 0~100
值 13 · 0x1C S7 色相 0~255
值 14 · 0x1D S7 飽和度 0~100
值 15 · 0x1E S8 色相 0~255
值 16 · 0x1F S8 飽和度 0~100
值 17 · 0x20 S9 色相 0~255
值 18 · 0x21 S9 飽和度 0~100
值 19 · 0x22 S10 色相 0~255
值 20 · 0x23 S10 飽和度 0~100
值 21 · 0x24 S11 色相 0~255
值 22 · 0x25 S11 飽和度 0~100
值 23 · 0x26 S12 色相 0~255
值 24 · 0x27 S12 飽和度 0~100
值 25 · 0x28 S13 色相 0~255
值 26 · 0x29 S13 飽和度 0~100
值 27 · 0x2A S14 色相 0~255
值 28 · 0x2B S14 飽和度 0~100
值 29 · 0x2C S15 色相 0~255
值 30 · 0x2D S15 飽和度 0~100
值 31 · 0x2E S16 色相 0~255
值 32 · 0x2F S16 飽和度 0~100
寫
切換模式與子選項;設定目標色、最小面積門檻、取樣點位置
相機模式 2 座標取色 ③ 色相+飽和+明度:16 點色相+飽和+明度

模式編號 23。

位置 內容 範圍
讀(值編號照順序)
值 1 · 0x10 S1 色相 0~255
值 2 · 0x11 S1 飽和度 0~100
值 3 · 0x12 S1 明度 0~100
值 4 · 0x13 S2 色相 0~255
值 5 · 0x14 S2 飽和度 0~100
值 6 · 0x15 S2 明度 0~100
值 7 · 0x16 S3 色相 0~255
值 8 · 0x17 S3 飽和度 0~100
值 9 · 0x18 S3 明度 0~100
值 10 · 0x19 S4 色相 0~255
值 11 · 0x1A S4 飽和度 0~100
值 12 · 0x1B S4 明度 0~100
值 13 · 0x1C S5 色相 0~255
值 14 · 0x1D S5 飽和度 0~100
值 15 · 0x1E S5 明度 0~100
值 16 · 0x1F S6 色相 0~255
值 17 · 0x20 S6 飽和度 0~100
值 18 · 0x21 S6 明度 0~100
值 19 · 0x22 S7 色相 0~255
值 20 · 0x23 S7 飽和度 0~100
值 21 · 0x24 S7 明度 0~100
值 22 · 0x25 S8 色相 0~255
值 23 · 0x26 S8 飽和度 0~100
值 24 · 0x27 S8 明度 0~100
值 25 · 0x28 S9 色相 0~255
值 26 · 0x29 S9 飽和度 0~100
值 27 · 0x2A S9 明度 0~100
值 28 · 0x2B S10 色相 0~255
值 29 · 0x2C S10 飽和度 0~100
值 30 · 0x2D S10 明度 0~100
值 31 · 0x2E S11 色相 0~255
值 32 · 0x2F S11 飽和度 0~100
值 33 · 0x30 S11 明度 0~100
值 34 · 0x31 S12 色相 0~255
值 35 · 0x32 S12 飽和度 0~100
值 36 · 0x33 S12 明度 0~100
值 37 · 0x34 S13 色相 0~255
值 38 · 0x35 S13 飽和度 0~100
值 39 · 0x36 S13 明度 0~100
值 40 · 0x37 S14 色相 0~255
值 41 · 0x38 S14 飽和度 0~100
值 42 · 0x39 S14 明度 0~100
值 43 · 0x3A S15 色相 0~255
值 44 · 0x3B S15 飽和度 0~100
值 45 · 0x3C S15 明度 0~100
值 46 · 0x3D S16 色相 0~255
值 47 · 0x3E S16 飽和度 0~100
值 48 · 0x3F S16 明度 0~100
寫
切換模式與子選項;設定目標色、最小面積門檻、取樣點位置
相機模式 3 照順序給色號:16 塊色相碼

模式編號 30。

位置 內容 範圍
讀(值編號照順序)
值 1 · 0x10 左起第 1 塊色相 0~255
值 2 · 0x11 左起第 2 塊色相 0~255
值 3 · 0x12 左起第 3 塊色相 0~255
值 4 · 0x13 左起第 4 塊色相 0~255
值 5 · 0x14 左起第 5 塊色相 0~255
值 6 · 0x15 左起第 6 塊色相 0~255
值 7 · 0x16 左起第 7 塊色相 0~255
值 8 · 0x17 左起第 8 塊色相 0~255
值 9 · 0x18 左起第 9 塊色相 0~255
值 10 · 0x19 左起第 10 塊色相 0~255
值 11 · 0x1A 左起第 11 塊色相 0~255
值 12 · 0x1B 左起第 12 塊色相 0~255
值 13 · 0x1C 左起第 13 塊色相 0~255
值 14 · 0x1D 左起第 14 塊色相 0~255
值 15 · 0x1E 左起第 15 塊色相 0~255
值 16 · 0x1F 左起第 16 塊色相 0~255
值 17 · 0x20 總塊數 0~18
寫
切換模式與子選項;設定目標色、最小面積門檻、取樣點位置
相機模式 4 循線 ①②③ 黑線/白線/色線:14 個值

模式編號 41/42/43。

位置 內容 範圍
讀(值編號照順序)
值 1 · 0x10 近處偏移 −100~100
值 2 · 0x11 中段偏移 −100~100
值 3 · 0x12 遠處偏移 −100~100
值 4 · 0x13 線角度 −90~90
值 5 · 0x14 近處線寬 % 0~100
值 6 · 0x15 有線旗標(近 1+中 2+遠 4) 0~7
值 7 · 0x16 路口類型(0 無 1 十字 2 T 3 左 4 右 5 盡頭) 0~5
值 8 · 0x17 路口距離 % 0~100
值 9 · 0x18 近處線左緣 −100~100
值 10 · 0x19 近處線右緣 −100~100
值 11 · 0x1A 遠處線寬 % 0~100
值 12 · 0x1B 穿過的彩色標記線色號 0, 1~16
值 13 · 0x1C 標記線累計條數 0~99
值 14 · 0x1D 最後離線方向(0 有線 1 左 2 右) 0~2
寫
切換模式與子選項;設定目標色、最小面積門檻、取樣點位置
相機模式 5 物體偵測 ① 物體清單:8 個物體 色號、形狀、XY

模式編號 51。

位置 內容 範圍
讀(值編號照順序)
值 1 · 0x10 物體 1 色號 0, 1~8
值 2 · 0x11 物體 1 形狀 0~9
值 3 · 0x12 物體 1 X(像素) 0, 1~159
值 4 · 0x13 物體 1 Y(像素,上=小) 0, 1~119
值 5 · 0x14 物體 2 色號 0, 1~8
值 6 · 0x15 物體 2 形狀 0~9
值 7 · 0x16 物體 2 X(像素) 0, 1~159
值 8 · 0x17 物體 2 Y(像素,上=小) 0, 1~119
值 9 · 0x18 物體 3 色號 0, 1~8
值 10 · 0x19 物體 3 形狀 0~9
值 11 · 0x1A 物體 3 X(像素) 0, 1~159
值 12 · 0x1B 物體 3 Y(像素,上=小) 0, 1~119
值 13 · 0x1C 物體 4 色號 0, 1~8
值 14 · 0x1D 物體 4 形狀 0~9
值 15 · 0x1E 物體 4 X(像素) 0, 1~159
值 16 · 0x1F 物體 4 Y(像素,上=小) 0, 1~119
值 17 · 0x20 物體 5 色號 0, 1~8
值 18 · 0x21 物體 5 形狀 0~9
值 19 · 0x22 物體 5 X(像素) 0, 1~159
值 20 · 0x23 物體 5 Y(像素,上=小) 0, 1~119
值 21 · 0x24 物體 6 色號 0, 1~8
值 22 · 0x25 物體 6 形狀 0~9
值 23 · 0x26 物體 6 X(像素) 0, 1~159
值 24 · 0x27 物體 6 Y(像素,上=小) 0, 1~119
值 25 · 0x28 物體 7 色號 0, 1~8
值 26 · 0x29 物體 7 形狀 0~9
值 27 · 0x2A 物體 7 X(像素) 0, 1~159
值 28 · 0x2B 物體 7 Y(像素,上=小) 0, 1~119
值 29 · 0x2C 物體 8 色號 0, 1~8
值 30 · 0x2D 物體 8 形狀 0~9
值 31 · 0x2E 物體 8 X(像素) 0, 1~159
值 32 · 0x2F 物體 8 Y(像素,上=小) 0, 1~119
值 33 · 0x30 物體數 0~8
寫
切換模式與子選項;設定目標色、最小面積門檻、取樣點位置
相機模式 5 物體偵測 ② 物體詳細:8 個物體+大小、面積、角度

模式編號 52。

位置 內容 範圍
讀(值編號照順序)
值 1 · 0x10 物體 1 色號 0, 1~8
值 2 · 0x11 物體 1 形狀 0~9
值 3 · 0x12 物體 1 X(像素) 0, 1~159
值 4 · 0x13 物體 1 Y(像素,上=小) 0, 1~119
值 5 · 0x14 物體 1 寬(像素) 0~160
值 6 · 0x15 物體 1 高(像素) 0~120
值 7 · 0x16 物體 1 面積(佔畫面 %) 0, 1~100 %
值 8 · 0x17 物體 1 角度 0~179
值 9 · 0x18 物體 1 頂點數 0~10
值 10 · 0x19 物體 1 追蹤編號 0~255
值 11 · 0x1A 物體 2 色號 0, 1~8
值 12 · 0x1B 物體 2 形狀 0~9
值 13 · 0x1C 物體 2 X(像素) 0, 1~159
值 14 · 0x1D 物體 2 Y(像素,上=小) 0, 1~119
值 15 · 0x1E 物體 2 寬(像素) 0~160
值 16 · 0x1F 物體 2 高(像素) 0~120
值 17 · 0x20 物體 2 面積(佔畫面 %) 0, 1~100 %
值 18 · 0x21 物體 2 角度 0~179
值 19 · 0x22 物體 2 頂點數 0~10
值 20 · 0x23 物體 2 追蹤編號 0~255
值 21 · 0x24 物體 3 色號 0, 1~8
值 22 · 0x25 物體 3 形狀 0~9
值 23 · 0x26 物體 3 X(像素) 0, 1~159
值 24 · 0x27 物體 3 Y(像素,上=小) 0, 1~119
值 25 · 0x28 物體 3 寬(像素) 0~160
值 26 · 0x29 物體 3 高(像素) 0~120
值 27 · 0x2A 物體 3 面積(佔畫面 %) 0, 1~100 %
值 28 · 0x2B 物體 3 角度 0~179
值 29 · 0x2C 物體 3 頂點數 0~10
值 30 · 0x2D 物體 3 追蹤編號 0~255
值 31 · 0x2E 物體 4 色號 0, 1~8
值 32 · 0x2F 物體 4 形狀 0~9
值 33 · 0x30 物體 4 X(像素) 0, 1~159
值 34 · 0x31 物體 4 Y(像素,上=小) 0, 1~119
值 35 · 0x32 物體 4 寬(像素) 0~160
值 36 · 0x33 物體 4 高(像素) 0~120
值 37 · 0x34 物體 4 面積(佔畫面 %) 0, 1~100 %
值 38 · 0x35 物體 4 角度 0~179
值 39 · 0x36 物體 4 頂點數 0~10
值 40 · 0x37 物體 4 追蹤編號 0~255
值 41 · 0x38 物體 5 色號 0, 1~8
值 42 · 0x39 物體 5 形狀 0~9
值 43 · 0x3A 物體 5 X(像素) 0, 1~159
值 44 · 0x3B 物體 5 Y(像素,上=小) 0, 1~119
值 45 · 0x3C 物體 5 寬(像素) 0~160
值 46 · 0x3D 物體 5 高(像素) 0~120
值 47 · 0x3E 物體 5 面積(佔畫面 %) 0, 1~100 %
值 48 · 0x3F 物體 5 角度 0~179
值 49 · 0x40 物體 5 頂點數 0~10
值 50 · 0x41 物體 5 追蹤編號 0~255
值 51 · 0x42 物體 6 色號 0, 1~8
值 52 · 0x43 物體 6 形狀 0~9
值 53 · 0x44 物體 6 X(像素) 0, 1~159
值 54 · 0x45 物體 6 Y(像素,上=小) 0, 1~119
值 55 · 0x46 物體 6 寬(像素) 0~160
值 56 · 0x47 物體 6 高(像素) 0~120
值 57 · 0x48 物體 6 面積(佔畫面 %) 0, 1~100 %
值 58 · 0x49 物體 6 角度 0~179
值 59 · 0x4A 物體 6 頂點數 0~10
值 60 · 0x4B 物體 6 追蹤編號 0~255
值 61 · 0x4C 物體 7 色號 0, 1~8
值 62 · 0x4D 物體 7 形狀 0~9
值 63 · 0x4E 物體 7 X(像素) 0, 1~159
值 64 · 0x4F 物體 7 Y(像素,上=小) 0, 1~119
值 65 · 0x50 物體 7 寬(像素) 0~160
值 66 · 0x51 物體 7 高(像素) 0~120
值 67 · 0x52 物體 7 面積(佔畫面 %) 0, 1~100 %
值 68 · 0x53 物體 7 角度 0~179
值 69 · 0x54 物體 7 頂點數 0~10
值 70 · 0x55 物體 7 追蹤編號 0~255
值 71 · 0x56 物體 8 色號 0, 1~8
值 72 · 0x57 物體 8 形狀 0~9
值 73 · 0x58 物體 8 X(像素) 0, 1~159
值 74 · 0x59 物體 8 Y(像素,上=小) 0, 1~119
值 75 · 0x5A 物體 8 寬(像素) 0~160
值 76 · 0x5B 物體 8 高(像素) 0~120
值 77 · 0x5C 物體 8 面積(佔畫面 %) 0, 1~100 %
值 78 · 0x5D 物體 8 角度 0~179
值 79 · 0x5E 物體 8 頂點數 0~10
值 80 · 0x5F 物體 8 追蹤編號 0~255
值 81 · 0x60 物體數 0~8
寫
切換模式與子選項;設定目標色、最小面積門檻、取樣點位置

本頁依據

  • 逐格對照:cam_universal_layout.json(在 _build/protocol/unicam/,複製自相機韌體資料夾的 tests\spec_layout.json,規格定案 2026-10-28,韌體每次建置都跟它逐 byte 比對)
  • 產生器:_build/gen-unicam.mjs
LINE 詢價選購指南