掌控者 PS2 × mBlock 5（MakeBlock 版）
掌控者 PS2 MakeBlock 版接在 mBot、Ranger、Orion、MegaPi 的 RJ25 連接埠，用 MBC Pro Sensors 擴展 v2 的積木讀值。擴展安裝與各主板可用連接埠請看 MakeBlock 積木擴展。
SPIKEEV3Arduino I2CmBlockMATRIXmicro:bit
接線
感應器 → mBot 插座片 → 主板 RJ25 連接埠（S1 = 主機送、S2 = 主機收）。UART 38400 8N1。
讀值積木
| 積木 | 傳回 | 編號 | 說明 |
|---|---|---|---|
| 掌控者 連接埠 ［埠］ 十六鍵 | 0~65535 bit | 01 |
16 個按鍵合成一個數（PSX 排列，1 = 按下）：bit0 SELECT、1 L3、2 R3、3 START、4 上、5 右、6 下、7 左、8 L2、9 R2、10 L1、11 R1、12 ▲、13 ●、14 ✕、15 ■；未連線 = 0 |
| 掌控者 連接埠 ［埠］ 方向鍵 | 0~15 bit | 02 |
上 1、右 2、下 4、左 8（同時按相加），0~15；未連線 = 0 |
| 掌控者 連接埠 ［埠］ 形狀鍵 | 0~15 bit | 03 |
▲ 1、● 2、✕ 4、■ 8（同時按相加），0~15；未連線 = 0；0x22 的 R 高 4 bit |
| 掌控者 連接埠 ［埠］ 肩鍵 | 0~15 bit | 04 |
L2 1、R2 2、L1 4、R1 8（同時按相加），0~15；未連線 = 0 |
| 掌控者 連接埠 ［埠］ 功能鍵 | 0~15 bit | 05 |
SELECT 1、L3 2、R3 4、START 8（同時按相加），0~15；未連線 = 0；0x22 的 G 高 4 bit |
| 掌控者 連接埠 ［埠］ 手把已連線？ | 0~1 | 06 |
1 = 手把已連線（psx.read() 成功），0 = 沒有；未連線時所有按鍵 0、搖桿回中 |
| 掌控者 連接埠 ［埠］ 電量 | 0 % | 07 |
0~100；PS2 手把沒有電量 → 恆 0（PS4 才有） |
| 掌控者 連接埠 ［埠］ L2 類比 | 0~255 | 08 |
L2 壓力 0~255（DualShock 2 類比模式才有壓力值；手把沒有壓力值時按下 = 255、放開 = 0）；未連線 = 0 |
| 掌控者 連接埠 ［埠］ R2 類比 | 0~255 | 09 |
R2 壓力 0~255（同 08）；未連線 = 0 |
| 掌控者 連接埠 ［埠］ 系統鍵 | 0 bit | 0A |
b0 PS 鍵、b1 擷取鍵；PS2 手把沒有 → 恆 0（PS4 才有） |
| 掌控者 連接埠 ［埠］ 手把類型 | 0~2 | 0B |
0 沒有手把、1 PS2 數位模式、2 PS2 類比模式（3 PS4、4 PS5 只有 PS4 接收器會出現） |
| 掌控者 連接埠 ［埠］ 搖桿 [LX/LY/RX/RY] | -100~+100 | 10~13 |
10 LX、11 LY、12 RX、13 RY：−100 ~ +100，0 = 中間，右／上為正（原始 0 |
| 掌控者 連接埠 ［埠］ ［按鈕］ 被按下？ | 是／否 | 01 |
從十六鍵 01 拆出的單一按鈕（PSX 排列），選單：✕ ● ▲ ■ 上 下 左 右 L1 R1 L2 R2 L3 R3 SELECT START |
命令積木
| 積木 | 編號 | 說明 |
|---|---|---|
| 掌控者 連接埠 ［埠］ 震動 ［強度］ | E5 |
[強度 0~255]，0 = 停；PS2 接收器收到後回 ACK 但忽略（250614 已關手把震動），PS4 才有作用 |
| 掌控者 連接埠 ［埠］ 燈條顏色 ［紅］ ［綠］ ［藍］ | E6 |
[R][G][B] 各 0~255；PS2 手把沒有燈條，接收器收到後回 ACK 但忽略，PS4 才有作用 |
| 掌控者 連接埠 ［埠］ 更新全部數值 | FD |
一次讀整張值表進快取（FD 整包）；接下來 10 ms 內的讀值積木直接用快取，不再逐一詢問 |
狀態積木
擴展把 F3 各 bit 拆成布林積木：
| bit | 名稱 | 說明 |
|---|---|---|
| b0 | 就緒 (ready) |
恆 1 |
| b1 | 手把已連線 (connected) |
= 06 已連線 |
封包格式（給自己寫解碼器的人）
| 動作 | 格式 |
|---|---|
| 讀一個值 | 主機送 [編號] → 回 [值低][值高][編號^值低^值高] |
| 寫入命令 | 寫入命令 E0~EE：收齊參數後回 [00][00][編號] 再執行；20 ms 內沒收齊就丟棄 |
| 不認得的編號 | [00][80][編號^0x80]（= -32768） |
| 整包 FD | 送 [FD] → 回 [AA][0F][15 個 int16 小端][xor]，xor = AA ^ N ^ 所有資料 byte；內容 = 本頁值表由小到大排（不含共用編號與命令）。擴展用它一次抓全部、10 ms 內的積木直接讀快取。 |
| 共用編號 | F0 裝置 ID、F1 協議版本、F2 韌體版本、F3 狀態旗標 |
本頁依據與假設
本頁由 _build/gen-reference.mjs 從 _build/protocol/ps2.json（單一真相來源，轉錄自 2026-10-21 協定定案）產生。
- hw[0] = 1（PS2）、電量 07 恆 0、系統鍵 0A 恆 0、手把類型 0B 只會出現 0／1／2（I2C 定案 §2、§4）。
- 08／09 L2／R2 類比照定案寫 0~255：DS2 類比模式有壓力值；沒有壓力值時按下 = 255、放開 = 0（沿用 v1 0x14 的做法，盤點 .ino:598-603）。
- E5 震動、E6 燈條照 I2C 定案 §3 列在 PS2／PS4 共用命令表；PS2 收到回 ACK 後忽略（跟 v1 0x10／0x23 一樣）。
- 搖桿 10
13 在 I2C／mBlock 是 ±100（由 raw (v−128)×100/128、Y 上為正）；EV3／0x22 維持 099（50 中間）、SPIKE 維持 1~9（5 中間）照盤點，不改鎖住模式。 - EV3：模式 0、1、2、4 鎖住（照盤點）；模式 3 改 方向|形狀<<4|已連線<<8（原本沒有 bit8）；模式 5 改成 ID 格式 B（原本 = 按鍵／搖桿合併版）。
- SPIKE：0/5/7/9 鎖住，1、2、4、6 維持不動；模式 3 改 [已連線, 電量(0), 0]（原本 = 4 組按鍵）；模式 8 改 v[0] = ID|hw[0]<<8（原本 = 搖桿）。模式 9 v[6] button16 = PSX 排列（D3）。
- SPIKE 模式 5 只容得下 11 鍵（L2、R2、L3、R3、START 讀不到），鎖住不改。
- 積木文字以擴展 v2.0.0 產生器
build_mext.js的表為準；本頁由同一份 JSON 產生。