測距者 8 路 (TOF8) × MATRIX × MATRIXblock 原廠積木
這一頁只講 MATRIXblock 原廠顏色感應器積木（0x22）：在 MATRIX Mini R4 上用它讀測距者 8 路 (TOF8)的安裝步驟、每個值怎麼讀、能用的命令與範例。要換產品、主機或軟體，用上方的切換列。
要買哪個版本、怎麼接
買 MATRIX 版，用 MATRIX 原廠 4 pin 感應器線接 Mini R4 的 I2C1 或 I2C2（位址 0x22），積木裡選對應的孔。
安裝與設定
你需要
- 感應器：測距者 8 路 (TOF8)（MATRIX 版）。
- 主機：MATRIX Mini R4。
- 連接線：MATRIX 原廠 4 pin 感應器線。
- 軟體：MATRIXblock（MATRIX 原廠積木軟體）。這個用法不用另外裝函式庫。
安裝軟體
- 安裝 MATRIXblock（預設裝在
C:\matrixblock-r4\）。
讓軟體認得感應器
感應器在 Mini R4 上會被當成原廠 顏色感應器（I2C 位址 0x22），直接用內建積木讀，不用裝擴充：
- 積木「顏色感應器 → R／G／B／C／M／Y／K」各讀 1 個
0 ~ 255的數，韌體把產品資料塞在這七格，每一格代表什麼看下面的讀值。 - MATRIXblock 的 Arduino 模式也能讀：
MiniR4.I2C1.MXColor.getColor(R)。
警告
不要用 H／S／V、顏色辨識（ColorID）積木：那是主機拿 R、G、B 自己算的，對 MBC 產品沒有意義。灰階、顏色編號積木已被 MATRIX 拿掉，所以只有這七格能用。
接線
- 用 MATRIX 原廠 4 pin 感應器線，接 Mini R4 的 I2C1 或 I2C2 孔。
- 積木裡選你接的那個孔（例如
I2C1）。 - 5 V 直接接，不需要準位轉換。
開機要等 2～4 秒
測距者 8 路不用校準，插上去就能用；開機後要等 2～4 秒讓 8 顆雷射準備好，這段時間全部讀到 120（公分）。程式開頭先等幾秒再讀距離。
| 第幾路 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 |
|---|---|---|---|---|---|---|---|---|
| 朝哪裡 | 正左邊 | 左前 60° | 左前 30° | 正前方 | 正前方 | 右前 30° | 右前 60° | 正右邊 |
上表是感應器正面朝前、元件面朝上的裝法。手放在機器人左邊，範例 1 應該顯示負的方向；顯示正的代表裝反了，範例裡的「左轉」「右轉」也要對調。
上機結果
MATRIX 版在 MATRIX Mini R4、原廠函式庫實測通過（2026-11-02）：getColor(R)～getColor(K) 依序是由左到右的 7 個距離（公分），C 是正前方第 4、5 顆取較近的那個，跟下面「讀值」的排法一樣；連續讀 500 次都讀得到。
第一次測試
- 用「顏色感應器 → R」積木把讀到的數字顯示出來。
- 數字跟著感應器前方的東西變化，就是接好了。
常見問題
- 讀到的數字看不懂？ 確認用的是 R／G／B／C／M／Y／K 七格，不是 H／S／V 或顏色辨識積木。
讀值
用 MATRIXblock 原廠「顏色感應器」積木的 R／G／B／C／M／Y／K 讀（不要用 H／S／V 與顏色辨識積木）；Arduino 模式寫法一併列出。
第 1~8 顆距離 cm distCm
| 範圍 | 意思 |
|---|---|
0~120 cm |
第 1 |
積木「顏色感應器 → RK」：#67 改（使用者最終定案）：R、G、B = 第 1、2、3 顆；C = min(第 4, 第 5 顆)（正前方取較近）；M、Y、K = 第 6、7、8 顆；全部 cm 0120；11、12 = 0
int raw = MiniR4.I2C1.MXColor.getColor(R); // 第 1 組這個軟體讀不到：最近距離 cm、最近方向、最空曠距離 cm、最空曠方向、正前方 cm、最近距離 mm、初始化位元圖、故障位元圖、正前方距離 mm、第 1~8 顆距離 mm。要用這些值請改用 Arduino／mBlock／micro:bit。
範例
這個軟體還沒有整支的範例程式。上面「讀值」每一項都附了可以直接照著做的寫法，照順序組起來就能用；需要整支範例請 聯絡我們。
其他問題
還有問題？到 聯絡我們 附上你用的軟體和程式截圖。
下載
本頁依據
- 主機與軟體清單：
_build/guides.json - 值與命令：
_build/protocol/tof8.json（單一真相來源） - 安裝與設定：
_build/guides/software/matrix-matrixblock.zh.md、_build/guides/product/tof8/matrix-matrixblock.zh.md