掌控者 PS2 (PS2) × MATRIX × MATRIXblock 原廠積木
這一頁只講 MATRIXblock 原廠顏色感應器積木（0x22）：在 MATRIX Mini R4 上用它讀掌控者 PS2 (PS2)的安裝步驟、每個值怎麼讀、能用的命令與範例。要換產品、主機或軟體，用上方的切換列。
要買哪個版本、怎麼接
買 MATRIX 版，用 MATRIX 原廠 4 pin 感應器線接 Mini R4 的 I2C1 或 I2C2（位址 0x22），積木裡選對應的孔。
安裝與設定
你需要
- 感應器：掌控者 PS2 (PS2)（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 直接接，不需要準位轉換。
讓手把連上接收器
PS2 的 2.4G 手把和它的接收頭是原廠成對的，不用按任何配對鍵。
- 接收器接好、主機開機。
- 打開手把電源，手把會自己連上。
- 看接收器板子上的綠燈：亮著＝還沒接到手把；熄掉＝已經接到手把。
- 手把上的 ANALOG（或 MODE）燈要亮，搖桿才有數值。接收器一接上手把會自動切到這個模式；燈沒亮就按一下手把中間的 ANALOG 鍵。
危險
2.4GHz 是公共頻段，跟 Wi-Fi、微波爐共用。同一場地有 12 套以上同時使用時可能互相干擾，這種場合建議改用藍牙版（PS4／PS5）。
第一次測試
- 用「顏色感應器 → 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；未連線 = 0 |
積木「顏色感應器 → R」
int dpad = MiniR4.I2C1.MXColor.getColor(R); // 方向鍵肩鍵 shoulder
| 範圍 | 意思 |
|---|---|
0~15 bit |
L2 1、R2 2、L1 4、R1 8（同時按相加），0~15；未連線 = 0 |
積木「顏色感應器 → G」
int shoulder = MiniR4.I2C1.MXColor.getColor(G); // 肩鍵已連線 connected
| 範圍 | 意思 |
|---|---|
0~1 |
1 = 手把已連線（psx.read() 成功），0 = 沒有；未連線時所有按鍵 0、搖桿回中 |
積木「顏色感應器 → K」
int connected = MiniR4.I2C1.MXColor.getColor(K); // 已連線搖桿 LX／LY／RX／RY stick
| 範圍 | 意思 |
|---|---|
-100~+100 |
10 LX、11 LY、12 RX、13 RY：−100 ~ +100，0 = 中間，右／上為正（原始 0 |
積木「顏色感應器 → B~Y」：#67 新增：B、C、M、Y = LX、LY、RX、RY
int raw = MiniR4.I2C1.MXColor.getColor(B); // 第 1 組這個軟體讀不到：十六鍵、形狀鍵、功能鍵、電量、L2 類比、R2 類比、系統鍵、手把類型。要用這些值請改用 Arduino／mBlock／micro:bit。
命令
這個軟體不能送命令；需要時改用 Arduino I2C、mBlock 或 micro:bit。
範例
這個軟體還沒有整支的範例程式。上面「讀值」和「命令」每一項都附了可以直接照著做的寫法，照順序組起來就能用；需要整支範例請 聯絡我們。
其他問題
還有問題？到 聯絡我們 附上你用的軟體和程式截圖。
下載
本頁依據
- 主機與軟體清單：
_build/guides.json - 值與命令：
_build/protocol/ps2.json（單一真相來源） - 安裝與設定：
_build/guides/software/matrix-matrixblock.zh.md、_build/guides/product/ps2/matrix-matrixblock.zh.md