掌控者 PS4/PS5 × MATRIX × MATRIXblock 原廠積木
這一頁只講 MATRIXblock 原廠顏色感應器積木（0x22）：在 MATRIX Mini R4 上用它讀掌控者 PS4/PS5的安裝步驟、每個值怎麼讀、能用的命令與範例。要換產品、主機或軟體，用上方的切換列。
要買哪個版本、怎麼接
買 MATRIX 版，用 MATRIX 原廠 4 pin 感應器線接 Mini R4 的 I2C1 或 I2C2（位址 0x22），積木裡選對應的孔。
安裝與設定
你需要
- 感應器：掌控者 PS4/PS5（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 直接接，不需要準位轉換。
配對手把（第一次用或要換手把）
- 接收器接好、主機開機。插上去的時候不要按住接收器上的按鍵（會進入燒錄模式，接收器就不會動作；放開按鍵、拔掉重插就好）。
- 第一次使用：接收器還沒記住任何手把時，一開機就會自動開放 30 秒配對（綠燈快速閃）。要換手把、或 30 秒已經過了：按一下接收器上的按鍵（Reset），會清掉舊的手把、重新開放 30 秒。
- 在這 30 秒內讓手把進入配對模式，直到手把的燈條快速閃爍：PS4 手把同時長按 SHARE＋PS；PS5 手把同時長按 建立（Create）＋PS。
- 連上之後接收器會記住這支手把，也不會再連別人的手把。之後開機，只要按手把的 PS 鍵就會自動連上。
| 接收器的綠燈 | 意思 |
|---|---|
| 快速閃 | 正在等手把配對 |
| 一直亮 | 沒有連上手把（按手把 PS 鍵重新連線） |
| 熄掉 | 已經連上手把 |
提示
比賽現場請在自己的位置完成配對，避免 30 秒內有別隊手把也在配對模式。綁錯手把就再按一次 Reset 重新配對。
第一次測試
- 用「顏色感應器 → R」積木把讀到的數字顯示出來。
- 數字跟著感應器前方的東西變化，就是接好了。
常見問題
- 讀到的數字看不懂？ 確認用的是 R／G／B／C／M／Y／K 七格，不是 H／S／V 或顏色辨識積木。
讀值
用 MATRIXblock 原廠「顏色感應器」積木的 R／G／B／C／M／Y／K 讀（不要用 H／S／V 與顏色辨識積木）；Arduino 模式寫法一併列出。
方向鍵 dpad
| 範圍 | 意思 |
|---|---|
0~15 bit |
上 1、右 2、下 4、左 8，同時按相加（0~15） |
積木「顏色感應器 → R」
int dpad = MiniR4.I2C1.MXColor.getColor(R); // 方向鍵肩鍵 shoulderKeys
| 範圍 | 意思 |
|---|---|
0~15 bit |
L2 1、R2 2、L1 4、R1 8，同時按相加（0~15） |
積木「顏色感應器 → G」
int shoulderKeys = MiniR4.I2C1.MXColor.getColor(G); // 肩鍵已連線 connected
| 範圍 | 意思 |
|---|---|
0~1 |
1 = 手把已連線且 300 ms 內有資料，0 = 未連線（斷線時按鍵 0、搖桿中間） |
積木「顏色感應器 → K」
int connected = MiniR4.I2C1.MXColor.getColor(K); // 已連線搖桿 1~4 軸 stick
| 範圍 | 意思 |
|---|---|
-100~+100 |
10 LX、11 LY、12 RX、13 RY：−100 ~ +100，0 = 中間，右／上為正；未連線 0 |
積木「顏色感應器 → BY」：B C M Y = LX LY RX RY，099，50 = 中間
int raw = MiniR4.I2C1.MXColor.getColor(B); // 第 1 組這個軟體讀不到：十六鍵、形狀鍵、功能鍵、電量、L2 類比、R2 類比、系統鍵、手把類型。要用這些值請改用 Arduino／mBlock／micro:bit。
命令
這個軟體不能送命令；需要時改用 Arduino I2C、mBlock 或 micro:bit。
範例
這個軟體還沒有整支的範例程式。上面「讀值」和「命令」每一項都附了可以直接照著做的寫法，照順序組起來就能用；需要整支範例請 聯絡我們。
其他問題
還有問題？到 聯絡我們 附上你用的軟體和程式截圖。
下載
本頁依據
- 主機與軟體清單：
_build/guides.json - 值與命令：
_build/protocol/ps4.json（單一真相來源） - 安裝與設定：
_build/guides/software/matrix-matrixblock.zh.md、_build/guides/product/ps4/matrix-matrixblock.zh.md