神攝手舊版已停止支援:2026-10 以前出貨的神攝手(學校版/WRO 版)已停止支援,說明與範例保留供參考。需要升級成目前的神攝手:請聯繫原購買的經銷商寄回,韌體更新免費,來回運費由買家負擔。

神攝手 ESP32CAM × mBlock × mBlock 5

互動教學mBlock

第一次用?先跟著互動教學在網頁上做一遍,再照下面的步驟接主機。

這一頁只講 mBlock 5(MBC Pro Sensors 擴展):在 MakeBlock(mBot)+ mBlock 5 上用它讀神攝手 ESP32CAM的安裝步驟、每個值怎麼讀、能用的命令與範例。要換產品、主機或軟體,用上方的切換列。

要買哪個版本、怎麼接

買 MakeBlock 版(RJ25 接頭),插 mBot/Ranger/Orion/MegaPi 的 RJ25 連接埠;各主板可用哪幾個埠見 MakeBlock 積木擴展。

神攝手 ESP32CAM × MakeBlock(mBot)+ mBlock 5

安裝與設定

你需要

  • 感應器:神攝手 ESP32CAM(MakeBlock 版,出廠韌體跟其他版本不同),加上 mBot 插座片(接 RJ25 連接埠)。SPIKE、EV3、I2C 版不能直接接 Makeblock 主板。
  • 主板:mBot(mCore)、mBot Ranger(Auriga)、Orion、Ultimate 2.0(MegaPi)、MegaPi Pro。mBot2(CyberPi)沒有 RJ25 連接埠,不支援。
  • 軟體:mBlock 5 電腦版(上傳模式,程式燒進主板執行)。
  • 擴展:MBC Pro Sensors v2.0.0(搭配 2026-10 之後出貨、協定 v2 的韌體)。

安裝軟體

  1. 到 mBlock 官網 安裝 mBlock 5 電腦版。
  2. 打開 mBlock 5,左下「設備」加入你的主板(例如 mBot)。
  3. 右下「模式開關」切到 上傳。

讓軟體認得感應器

要加一個擴展,積木區才會多出 MBC 的積木:

  1. 取得 v2.0.0 擴展:上架後在 mBlock 5「擴展中心」搜尋「MBC」就能加入。上架前(送審中),進階使用者可以到 ext.mblock.cc 登入自己的 Makeblock 帳號 → 我的擴展 → 匯入資料,上傳 mbc_pro_sensors_2.0.0_import.mext(約 1 分鐘),再按「下載」拿到 .mext。
  2. 把 .mext 檔拖進 mBlock 視窗,積木區會多出「循行者」「測距者」「掌控者」「IMU 陀螺儀」「神攝手」「MBC 共用」六個分類。
  3. 用主板的開機起始積木(例如「當 mBot 啟動時」)開始寫程式,按「上傳」燒進主板。
  4. 打開範例:「檔案 → 從電腦打開」選 .mblock 檔。

重要

新版擴展(v2)只能配新版韌體,舊版擴展(v1.0.0)只能配 2026-10 以前的韌體,兩者積木不相容。不確定手上感應器是哪一版:拖進 v2 擴展後用「MBC 共用 → 協議版本」積木讀,回 2 就是新韌體。舊版擴展在 下載專區。

接線

感應器 → mBot 插座片 → 主板的 RJ25 連接埠(UART 38400)。積木上選的是連接埠號碼,擴展會依主板自動換成正確的腳位。

主板 可用連接埠 說明
mBot(mCore) 1、2、3、4 四個埠都可以
mBot Ranger(Auriga) 6 ~ 10 1 ~ 4 是紅色馬達埠、5 是序列埠,不能接
Orion 3、4、6 1、2 是紅色馬達埠;7、8 只能接類比感應器
Ultimate 2.0(MegaPi) 6、7、8 需加裝 RJ25 擴充板;5 是序列埠
MegaPi Pro 7、8、9、10 需加裝 RJ25 擴充板

本頁範例接 mBot 連接埠 1;換埠就把積木上的連接埠數字改掉。換別的主板時,把「當 mBot 啟動時」換成那塊主板的起始積木。

先在感應器上設定顏色

神攝手的設定都在感應器背面的彩色螢幕與按鍵上完成,不用電腦:短按側鍵進入設定選單,用左/右鍵選擇、確認鍵進入;設定好的顏色與鏡頭參數會自動保存,下次開機直接使用。

注意

神攝手的 MakeBlock 版是 2026 年 10 月新增,訂購前請先 LINE 詢問 確認出貨版本。神攝手接 mBot 走 IO1/IO3 串口,上機驗證中。

第一次測試

  1. 程式開頭先「等待 1 秒」讓感應器開機,太早讀會讀到 -32768。
  2. 用「MBC 共用 → 連線正常?」積木確認接線,再看數值。
  3. 上傳本頁範例 1,數字跟著感應器變化,就是接好了。

常見問題

  • 「連線正常?」是否? 連接埠選錯、感應器不是 MakeBlock 版、或韌體是舊版(舊韌體請用 v1 擴展)。
  • 讀到 -32768? 從開機到現在一次都沒讀到:檢查接線;或這款產品沒有這個值。
  • 數值一直不變? 確認插座片插緊、感應器指示燈有亮;「協議版本」積木讀到 2 代表通訊正常。
  • 積木圖是英文? 控制與運算積木(forever、if…then…else、wait、set…to)在中文介面就是「重複無限次」「如果…那麼…否則」「等待…秒」「變數設為」。
  • 還是不行? LINE 聯絡我們,告訴我們主板型號、連接埠和「裝置 ID」積木的讀值。

讀值(學校版)

裝好 MBC Pro Sensors 擴展後,在「神攝手舊版」分類找積木,連接埠選感應器實際插的孔。

色相 hue

色相
範圍 意思
-1~100 S1 取樣點色相 0100(色相環 0240 等比縮放);−1 = 黑白灰(飽和度 < 10);S1 沒設定 = 0
(神攝手舊版 連接埠 [1 v] 色相 :: sensing)

積木傳回 色相(-1~100)。主機送 [01] → 回 [值低][值高][01 ^ 值低 ^ 值高],值 = int16 小端。

飽和度 saturation

飽和度
範圍 意思
0~100 S1 取樣點飽和度 0~100
(神攝手舊版 連接埠 [1 v] 飽和度 :: sensing)

積木傳回 飽和度(0~100)。主機送 [02] → 回 [值低][值高][02 ^ 值低 ^ 值高],值 = int16 小端。

明度 value

明度
範圍 意思
0~100 S1 取樣點明度 0~100
(神攝手舊版 連接埠 [1 v] 明度 :: sensing)

積木傳回 明度(0~100)。主機送 [03] → 回 [值低][值高][03 ^ 值低 ^ 值高],值 = int16 小端。

動態 motion

動態
範圍 意思
0~100 全畫面動態量 0~100(畫面變化越多越大)
(神攝手舊版 連接埠 [1 v] 動態 :: sensing)

積木傳回 動態(0~100)。主機送 [04] → 回 [值低][值高][04 ^ 值低 ^ 值高],值 = int16 小端。

色塊 X blobX

色塊 X
範圍 意思
0~100 色塊中心 X 0~100,左 = 0;沒找到 = 0
(神攝手舊版 連接埠 [1 v] 色塊 X :: sensing)

積木傳回 色塊 X(0~100)。主機送 [05] → 回 [值低][值高][05 ^ 值低 ^ 值高],值 = int16 小端。

色塊 Y blobY

色塊 Y
範圍 意思
0~75 色塊中心 Y 0~75,下 = 0、上 = 75;沒找到 = 0
(神攝手舊版 連接埠 [1 v] 色塊 Y :: sensing)

積木傳回 色塊 Y(0~75)。主機送 [06] → 回 [值低][值高][06 ^ 值低 ^ 值高],值 = int16 小端。

色塊寬 blobW

色塊寬
範圍 意思
0~100 色塊寬 W 0~100;0 = 沒找到
(神攝手舊版 連接埠 [1 v] 色塊寬 :: sensing)

積木傳回 色塊寬(0~100)。主機送 [07] → 回 [值低][值高][07 ^ 值低 ^ 值高],值 = int16 小端。

色塊高 blobH

色塊高
範圍 意思
0~75 色塊高 H 0~75;沒找到 = 0
(神攝手舊版 連接埠 [1 v] 色塊高 :: sensing)

積木傳回 色塊高(0~75)。主機送 [08] → 回 [值低][值高][08 ^ 值低 ^ 值高],值 = int16 小端。

色塊面積 blobArea

色塊面積
範圍 意思
0~7500 W×H(0~7500);沒找到 = 0
(神攝手舊版 連接埠 [1 v] 色塊面積 :: sensing)

積木傳回 色塊面積(0~7500)。主機送 [09] → 回 [值低][值高][09 ^ 值低 ^ 值高],值 = int16 小端。

有找到色塊 found

範圍 意思
0~1 1 = 畫面裡有目標色的色塊(W > 0),0 = 沒有
(神攝手舊版 連接埠 [1 v] 有找到色塊? :: sensing)

積木傳回 有找到色塊(0~1)。主機送 [0A] → 回 [值低][值高][0A ^ 值低 ^ 值高],值 = int16 小端。

命令

更新全部數值 readAll

一次讀整張值表進快取(FD 整包);接下來 10 ms 內的讀值積木直接用快取,不再逐一詢問

神攝手舊版 連接埠 [1 v] 更新全部數值 :: sensing

讀值(WRO 版)

裝好 MBC Pro Sensors 擴展後,在「神攝手舊版 WRO」分類找積木,連接埠選感應器實際插的孔。

色點 1~12 顏色碼 spotColor

色點 1~12 顏色碼
範圍 意思
0~255 101B = S1S12 顏色碼:0239 彩色(色相 0255 等比縮成 0239)、240245 白(飽和度 < 30,越低越大)、246~250 黑(明度 < 30,越暗越大)、255 = 色點沒開
(神攝手舊版 WRO 連接埠 [1 v] 色點 [1 v] 顏色碼 :: sensing)

積木傳回 色點 1~12 顏色碼(0~255)。主機送 [10] → 回 [值低][值高][10 ^ 值低 ^ 值高],值 = int16 小端;第 N 路的編號 = 0x10 + (N − 1)。

色點 1~12 鮮豔度 spotVivid

色點 1~12 鮮豔度
範圍 意思
0~255 202B = S1S12 鮮豔度(飽和度)0~255:黑 = 1、白/彩色 = 實際飽和度;色點沒開 = 0
(神攝手舊版 WRO 連接埠 [1 v] 色點 [1 v] 鮮豔度 :: sensing)

積木傳回 色點 1~12 鮮豔度(0~255)。主機送 [20] → 回 [值低][值高][20 ^ 值低 ^ 值高],值 = int16 小端;第 N 路的編號 = 0x20 + (N − 1)。

命令(WRO 版)

更新全部數值 readAll

一次讀整張值表進快取(FD 整包);接下來 10 ms 內的讀值積木直接用快取,不再逐一詢問

神攝手舊版 WRO 連接埠 [1 v] 更新全部數值 :: sensing

範例(學校版)

這一頁是寫給完全沒寫過程式的人:用 mBlock 5 的積木在 mBot 上讀神攝手(學校版)。5 個範例從「把數字變成聲音」開始,一步一步做到會自己跑的車子。每個範例都有積木圖、可下載的專案檔,還有一支做同樣事情的 Arduino 程式。

寫法 適合誰 怎麼打開範例檔
🟧 mBlock 5 電腦版(積木,上傳模式)+ MBC 感應器擴展 v2 學校、第一次用 mBot 的人 下載 .mblock → 打開 mBlock 5 → 「檔案 → 從電腦打開」→ 選檔案 → 右下切到「上傳」→ 按「上傳」
🔧 Arduino IDE(文字程式) 想看積木背後長什麼樣、或自己寫程式的人 下載 .ino → 裝好 Makeblock 與 MBC_Sensors 函式庫(見 MakeBlock 積木擴展)→ 主板選 Arduino Uno → 上傳

重要

  • 感應器要是 MakeBlock 版、2026-10 之後的協定 v2 韌體,經 mBot 插座片接 RJ25 連接埠;擴展要用 v2.0.0(舊韌體配舊版 v1 擴展,兩者不能混用)。
  • 主板是 mBot(mCore)。mBot Ranger、Orion、MegaPi 也能用,但要把「當 mBot 啟動時」換成那塊主板的起始積木、連接埠改成它能用的號碼(見 支援的主板與連接埠);mBot2(CyberPi)沒有 RJ25,不支援。
  • 積木圖裡的控制與運算積木(forever、if…then…else、wait、set…to)以英文顯示,在 mBlock 的中文介面就是「重複無限次」「如果…那麼…否則」「等待…秒」「變數設為」。

開始之前

神攝手(學校版) × mBot 接線

感應器 → mBot 插座片 → 主板 RJ25 連接埠(S1 = 主機送、S2 = 主機收,UART 38400)。

  1. 裝擴展:到 MakeBlock 積木擴展 取得 MBC Pro Sensors v2.0.0 的 .mext,拖進 mBlock 5 視窗;左下「設備」加入 mBot,右下切到「上傳」。
  2. 接線:神攝手 → mBot 插座片 → mBot 連接埠 1(這頁所有範例都接這一埠;換埠就把積木上的連接埠數字改掉)。
  3. 先開機再讀:每個範例一開始都「等待 1 秒」讓感應器開機;太早讀會讀到 -32768(還沒收到)。
  4. 在感應器上設定要看的顏色(程式改不了):先把感應器插上 mBot、開機,把要用的顏色積木擺在鏡頭前。畫面上方顯示 RUN 時短按側鍵進選單:SET 1:COLOR 設「色相」的取樣點(範例 1:用左/右把紅線、綠線移到積木上,容許範圍先用預設);SET 2:TRACK 設要追的色塊(範例 2~5:十字對準色塊正中間,TOL_HUE/TOL_STA 調到只有你的積木被標記,MIN AREA 濾掉小雜點)。設定會記在感應器裡。
  5. 補光燈先不要開(積木會反光變白)。回到 RUN 畫面,螢幕上方會一直顯示 H…(色相) A…(面積) X… Y…,範例讀到的就是這幾個數字。

這頁會用到的積木

每顆讀值積木就是感應器值表裡的一個「值編號」(跟 Arduino I2C 版的暫存器編號相同);完整積木表在 MakeBlock 積木擴展。

積木 傳回 意思
神攝手舊版 連接埠 [1] 色相 -1~100 S1 取樣點色相 0100(色相環 0240 等比縮放);−1 = 黑白灰(飽和度 < 10);S1 沒設定 = 0
神攝手舊版 連接埠 [1] 有找到色塊? 是/否 1 = 畫面裡有目標色的色塊(W > 0),0 = 沒有
神攝手舊版 連接埠 [1] 色塊 X 0~100 色塊中心 X 0~100,左 = 0;沒找到 = 0
神攝手舊版 連接埠 [1] 色塊面積 0~7500 W×H(0~7500);沒找到 = 0

這頁的範例

  1. 聽見顏色
  2. 找到色塊亮綠燈
  3. 一個輪子轉向色塊
  4. 追著色塊走
  5. 追色塊、靠近就停+燈號

注意

.mblock 是由產生器照 mBlock 5 的存檔格式產生的,還沒在 mBlock 5 裡開啟驗證(等擴展 v2 上架後補驗)。開不起來或積木顯示空白,請先確認 v2 擴展已拖進 mBlock、設備是 mBot,或照下面的積木圖自己拼(5 分鐘內拼得完);也歡迎 LINE 告訴我們。


範例 1:聽見顏色

這個範例會做什麼:mBot 沒有螢幕,這個範例把取樣點的「色相」(0 ~ 100:紅 0、黃約 17、綠約 33、藍約 67;黑白灰是 −1)變成蜂鳴器的音高。先學會「讀到數字」。

要準備什麼

  • mBot(mCore 主板)+ mBlock 5 電腦版
  • 神攝手(學校版)(MakeBlock 版)+ mBot 插座片
  • 一塊顏色鮮豔的積木(紅、綠、藍都可以)

怎麼接:神攝手 → mBot 插座片 → mBot 連接埠 1。鏡頭朝前、裝在車頭。先照上面「開始之前」在感應器上設定要看的顏色。

下載程式

mBlock 5 專案 等價 Arduino 程式
ex01_hear_colour.mblock ex01_hear_colour.ino
mBlock 積木(照著拼就好)
當 mBot 啟動時 :: events hat
wait (1) seconds
forever
  播放音頻 ((200) + ((神攝手舊版 連接埠 [1 v] 色相 :: #C2255C) * (6))) 赫茲,持續 (0.1) 秒 :: sound
end
🔧 等價 Arduino 程式(mBot)
// 神攝手(學校版) × mBlock 5 範例 1:聽見顏色(mBot 等價 Arduino 程式)
// 接線:神攝手 → mBot 插座片 → mBot 連接埠 1。鏡頭朝前、裝在車頭。先照上面「開始之前」在感應器上設定要看的顏色。
// 跟 mBlock 積木範例做的事完全一樣,給想看「積木背後長什麼樣」或用 Arduino IDE 的人。
// 需要的函式庫:
//   1. Makeblock(Arduino IDE「函式庫管理員」搜尋 Makeblock,或 mBlock 5 安裝資料夾裡的 Makeblock 函式庫)
//   2. MBC_Sensors v2:擴展 .mext 解壓後的 src/ 四個檔(MBC_Sensors.h/.cpp、mbc_proto.h、mbc_ids.h),
//      放進 文件/Arduino/libraries/MBC_Sensors/ 就能 #include <MBC_Sensors.h>(https://mbc-pro-sensors.github.io/makeblock.html)
// 主板選 Arduino Uno(mBot 的 mCore 就是 Uno),上傳後拔掉 USB 用電池跑。

#include <MeMCore.h>            // mBot(mCore):馬達、LED、蜂鳴器
#include <SoftwareSerial.h>
#include <MBC_Sensors.h>        // MBC 感應器 v2(跟 mBlock 擴展同一份函式庫)

MBCPort mbc_port1(1);           // 感應器接在 mBot 連接埠 1
MeDCMotor motorL(9);           // 左輪(M1)
MeDCMotor motorR(10);          // 右輪(M2)
MeRGBLed rgbled(7, 2);         // 板載 RGB LED(2 顆)
MeBuzzer buzzer;               // 板載蜂鳴器

// 左/右輪動力 -100~100(正 = 往前):mBot 的左輪裝反,所以 M1 給負的;% 換算成 PWM 0~255
void wheels(int l, int r) {
  l = constrain(l, -100, 100); r = constrain(r, -100, 100);
  motorL.run(-l * 255 / 100);
  motorR.run(r * 255 / 100);
}

void setup() {   // 跟 mBlock 產生的程式一樣,積木全部在 setup() 裡跑
  mbc_port1.begin();
  delay(1000);   // 等 1 秒讓感應器開機
  while (1) {   // 一直重複
    buzzer.tone((200 + (mbcRead(mbc_port1, 0x01) * 6)), 100);   // 音高 = 200 + 色相 × 6 赫茲,響 0.1 秒
  }
}

void loop() {}   // 這裡什麼都沒有:上面的積木不會結束

一步一步看懂程式

  1. 等 1 秒讓感應器開機
  2. 一直重複
    • 音高 = 200 + 色相 × 6 赫茲,響 0.1 秒

跑起來應該看到什麼:紅色積木放在取樣點:200 赫茲低音;綠色約 400 赫茲;藍色約 600 赫茲;白紙或黑色是最低音(194 赫茲)。

常見問題

  • 聽不到聲音? → mBot 的蜂鳴器在主板上,聲音不大;把耳朵靠近,或把 0.1 秒改成 0.3 秒。
  • 顏色換了音沒變? → 積木沒有放在取樣點(感應器螢幕上的十字);用「開始之前」的 COLOR 設定把十字移到積木會經過的地方。
  • 一直「沒找到」? → 感應器上的 TRACK 設定還沒做、或容許範圍太小。看感應器螢幕:有追蹤框才算找到。
  • 什麼都沒反應、或讀值一直是 -32768? → 連接埠選錯(這頁都接連接埠 1)、插座片沒插緊、或感應器不是 MakeBlock 版。先用「MBC 共用 → 連線正常?」積木確認;「協議版本」讀到 2 才是新韌體(舊韌體請改用舊版擴展 v1)。
  • 上傳失敗、或積木是空白的? → 確認右下角切到「上傳」模式、擴展 v2 已拖進 mBlock、USB 線接的是 mBot 主板。

範例 2:找到色塊亮綠燈

這個範例會做什麼:用「有找到色塊?」布林積木和「如果…就…否則…」:畫面裡有設定的顏色就亮綠燈,沒有就亮紅燈。這是追色塊程式的第一個判斷。

要準備什麼

  • mBot(mCore 主板)+ mBlock 5 電腦版
  • 神攝手(學校版)(MakeBlock 版)+ mBot 插座片
  • 一塊顏色鮮豔的積木(紅、綠、藍都可以)

怎麼接:神攝手 → mBot 插座片 → mBot 連接埠 1。鏡頭朝前、裝在車頭。先照上面「開始之前」在感應器上設定要看的顏色。

下載程式

mBlock 5 專案 等價 Arduino 程式
ex02_found_led.mblock ex02_found_led.ino
mBlock 積木(照著拼就好)
當 mBot 啟動時 :: events hat
wait (1) seconds
forever
  if <神攝手舊版 連接埠 [1 v] 有找到色塊? :: #C2255C> then
    LED 燈位置 [全部 v] 的三原色數值為 紅 (0) 綠 (255) 藍 (0) :: looks
  else
    LED 燈位置 [全部 v] 的三原色數值為 紅 (255) 綠 (0) 藍 (0) :: looks
  end
end
🔧 等價 Arduino 程式(mBot)
// 神攝手(學校版) × mBlock 5 範例 2:找到色塊亮綠燈(mBot 等價 Arduino 程式)
// 接線:神攝手 → mBot 插座片 → mBot 連接埠 1。鏡頭朝前、裝在車頭。先照上面「開始之前」在感應器上設定要看的顏色。
// 跟 mBlock 積木範例做的事完全一樣,給想看「積木背後長什麼樣」或用 Arduino IDE 的人。
// 需要的函式庫:
//   1. Makeblock(Arduino IDE「函式庫管理員」搜尋 Makeblock,或 mBlock 5 安裝資料夾裡的 Makeblock 函式庫)
//   2. MBC_Sensors v2:擴展 .mext 解壓後的 src/ 四個檔(MBC_Sensors.h/.cpp、mbc_proto.h、mbc_ids.h),
//      放進 文件/Arduino/libraries/MBC_Sensors/ 就能 #include <MBC_Sensors.h>(https://mbc-pro-sensors.github.io/makeblock.html)
// 主板選 Arduino Uno(mBot 的 mCore 就是 Uno),上傳後拔掉 USB 用電池跑。

#include <MeMCore.h>            // mBot(mCore):馬達、LED、蜂鳴器
#include <SoftwareSerial.h>
#include <MBC_Sensors.h>        // MBC 感應器 v2(跟 mBlock 擴展同一份函式庫)

MBCPort mbc_port1(1);           // 感應器接在 mBot 連接埠 1
MeDCMotor motorL(9);           // 左輪(M1)
MeDCMotor motorR(10);          // 右輪(M2)
MeRGBLed rgbled(7, 2);         // 板載 RGB LED(2 顆)
MeBuzzer buzzer;               // 板載蜂鳴器

// 左/右輪動力 -100~100(正 = 往前):mBot 的左輪裝反,所以 M1 給負的;% 換算成 PWM 0~255
void wheels(int l, int r) {
  l = constrain(l, -100, 100); r = constrain(r, -100, 100);
  motorL.run(-l * 255 / 100);
  motorR.run(r * 255 / 100);
}

void setup() {   // 跟 mBlock 產生的程式一樣,積木全部在 setup() 裡跑
  mbc_port1.begin();
  delay(1000);   // 等 1 秒讓感應器開機
  while (1) {   // 一直重複
    if ((mbcRead(mbc_port1, 0x0A) == 1)) {   // 如果有找到色塊
      rgbled.setColor(0, 0, 255, 0); rgbled.show();   // 有找到色塊:綠燈
    } else {
      rgbled.setColor(0, 255, 0, 0); rgbled.show();   // 沒找到:紅燈
    }
  }
}

void loop() {}   // 這裡什麼都沒有:上面的積木不會結束

一步一步看懂程式

  1. 等 1 秒讓感應器開機
  2. 一直重複
    • 如果有找到色塊
      • 有找到色塊:綠燈
      • 否則:
        • 沒找到:紅燈

跑起來應該看到什麼:把積木拿到鏡頭前:綠燈(感應器螢幕上也會出現追蹤框);拿開:紅燈。

常見問題

  • 一直「沒找到」? → 感應器上的 TRACK 設定還沒做、或容許範圍太小。看感應器螢幕:有追蹤框才算找到。
  • 什麼都沒反應、或讀值一直是 -32768? → 連接埠選錯(這頁都接連接埠 1)、插座片沒插緊、或感應器不是 MakeBlock 版。先用「MBC 共用 → 連線正常?」積木確認;「協議版本」讀到 2 才是新韌體(舊韌體請改用舊版擴展 v1)。
  • 上傳失敗、或積木是空白的? → 確認右下角切到「上傳」模式、擴展 v2 已拖進 mBlock、USB 線接的是 mBot 主板。

範例 3:一個輪子轉向色塊

這個範例會做什麼:「色塊 X」是色塊在畫面的左右位置(0 最左、50 中間、100 最右)。只用左輪:動力 =(色塊 X − 50)× 0.8,色塊在右邊左輪往前轉、車頭往右;在左邊倒轉、車頭往左;在中間不動。沒找到就停。

要準備什麼

  • mBot(mCore 主板)+ mBlock 5 電腦版
  • mBot 兩輪小車(左輪接 M1、右輪接 M2,出廠就是這樣接)
  • 神攝手(學校版)(MakeBlock 版)+ mBot 插座片
  • 一塊顏色鮮豔的積木(紅、綠、藍都可以)

怎麼接:神攝手 → mBot 插座片 → mBot 連接埠 1。鏡頭朝前、裝在車頭。先照上面「開始之前」在感應器上設定要看的顏色。

下載程式

mBlock 5 專案 等價 Arduino 程式
ex03_one_wheel.mblock ex03_one_wheel.ino
mBlock 積木(照著拼就好)
當 mBot 啟動時 :: events hat
wait (1) seconds
forever
  if <神攝手舊版 連接埠 [1 v] 有找到色塊? :: #C2255C> then
    左輪動力 (((神攝手舊版 連接埠 [1 v] 色塊 X :: #C2255C) - (50)) * (0.8)) %,右輪動力 (0) % :: motion
  else
    停止移動 :: motion
  end
end
🔧 等價 Arduino 程式(mBot)
// 神攝手(學校版) × mBlock 5 範例 3:一個輪子轉向色塊(mBot 等價 Arduino 程式)
// 接線:神攝手 → mBot 插座片 → mBot 連接埠 1。鏡頭朝前、裝在車頭。先照上面「開始之前」在感應器上設定要看的顏色。
// 跟 mBlock 積木範例做的事完全一樣,給想看「積木背後長什麼樣」或用 Arduino IDE 的人。
// 需要的函式庫:
//   1. Makeblock(Arduino IDE「函式庫管理員」搜尋 Makeblock,或 mBlock 5 安裝資料夾裡的 Makeblock 函式庫)
//   2. MBC_Sensors v2:擴展 .mext 解壓後的 src/ 四個檔(MBC_Sensors.h/.cpp、mbc_proto.h、mbc_ids.h),
//      放進 文件/Arduino/libraries/MBC_Sensors/ 就能 #include <MBC_Sensors.h>(https://mbc-pro-sensors.github.io/makeblock.html)
// 主板選 Arduino Uno(mBot 的 mCore 就是 Uno),上傳後拔掉 USB 用電池跑。

#include <MeMCore.h>            // mBot(mCore):馬達、LED、蜂鳴器
#include <SoftwareSerial.h>
#include <MBC_Sensors.h>        // MBC 感應器 v2(跟 mBlock 擴展同一份函式庫)

MBCPort mbc_port1(1);           // 感應器接在 mBot 連接埠 1
MeDCMotor motorL(9);           // 左輪(M1)
MeDCMotor motorR(10);          // 右輪(M2)
MeRGBLed rgbled(7, 2);         // 板載 RGB LED(2 顆)
MeBuzzer buzzer;               // 板載蜂鳴器

// 左/右輪動力 -100~100(正 = 往前):mBot 的左輪裝反,所以 M1 給負的;% 換算成 PWM 0~255
void wheels(int l, int r) {
  l = constrain(l, -100, 100); r = constrain(r, -100, 100);
  motorL.run(-l * 255 / 100);
  motorR.run(r * 255 / 100);
}

void setup() {   // 跟 mBlock 產生的程式一樣,積木全部在 setup() 裡跑
  mbc_port1.begin();
  delay(1000);   // 等 1 秒讓感應器開機
  while (1) {   // 一直重複
    if ((mbcRead(mbc_port1, 0x0A) == 1)) {   // 如果有找到色塊
      wheels(((mbcRead(mbc_port1, 0x05) - 50) * 0.8), 0);   // 左輪動力 =(色塊 X − 50)× 0.8(−40 ~ +40),右輪 0
    } else {
      wheels(0, 0);   // 沒找到:停
    }
  }
}

void loop() {}   // 這裡什麼都沒有:上面的積木不會結束

一步一步看懂程式

  1. 等 1 秒讓感應器開機
  2. 一直重複
    • 如果有找到色塊
      • 左輪動力 =(色塊 X − 50)× 0.8(−40 ~ +40),右輪 0
      • 否則:
        • 沒找到:停

跑起來應該看到什麼:把積木拿到車子右前方:左輪往前轉、車頭轉向積木,對準就停;移到左邊,左輪倒轉。

常見問題

  • 車子往反方向轉、越修越歪? → 左右輪的「+」「-」對調(或把左輪、右輪的動力互換)。mBot 出廠左輪 M1、右輪 M2,自己接線的請確認。
  • 畫面左右跟實際相反? → 鏡頭設定裡的 H-Mirror 開了,關掉;或把 0.8 改成 -0.8。
  • 一直「沒找到」? → 感應器上的 TRACK 設定還沒做、或容許範圍太小。看感應器螢幕:有追蹤框才算找到。
  • 什麼都沒反應、或讀值一直是 -32768? → 連接埠選錯(這頁都接連接埠 1)、插座片沒插緊、或感應器不是 MakeBlock 版。先用「MBC 共用 → 連線正常?」積木確認;「協議版本」讀到 2 才是新韌體(舊韌體請改用舊版擴展 v1)。
  • 上傳失敗、或積木是空白的? → 確認右下角切到「上傳」模式、擴展 v2 已拖進 mBlock、USB 線接的是 mBot 主板。

範例 4:追著色塊走

這個範例會做什麼:範例 3 換成兩個輪子:轉向 =(色塊 X − 50)× 0.6,左輪 35 + 轉向、右輪 35 − 轉向,車子會一邊往前一邊把色塊對到畫面中間,也就是跟著積木走。沒找到就停。

要準備什麼

  • mBot(mCore 主板)+ mBlock 5 電腦版
  • mBot 兩輪小車(左輪接 M1、右輪接 M2,出廠就是這樣接)
  • 神攝手(學校版)(MakeBlock 版)+ mBot 插座片
  • 一塊顏色鮮豔的積木(紅、綠、藍都可以)

怎麼接:神攝手 → mBot 插座片 → mBot 連接埠 1。鏡頭朝前、裝在車頭。先照上面「開始之前」在感應器上設定要看的顏色。

下載程式

mBlock 5 專案 等價 Arduino 程式
ex04_follow.mblock ex04_follow.ino
mBlock 積木(照著拼就好)
當 mBot 啟動時 :: events hat
wait (1) seconds
forever
  if <神攝手舊版 連接埠 [1 v] 有找到色塊? :: #C2255C> then
    set [轉向 v] to (((神攝手舊版 連接埠 [1 v] 色塊 X :: #C2255C) - (50)) * (0.6))
    左輪動力 ((35) + (轉向)) %,右輪動力 ((35) - (轉向)) % :: motion
  else
    停止移動 :: motion
  end
end
🔧 等價 Arduino 程式(mBot)
// 神攝手(學校版) × mBlock 5 範例 4:追著色塊走(mBot 等價 Arduino 程式)
// 接線:神攝手 → mBot 插座片 → mBot 連接埠 1。鏡頭朝前、裝在車頭。先照上面「開始之前」在感應器上設定要看的顏色。
// 跟 mBlock 積木範例做的事完全一樣,給想看「積木背後長什麼樣」或用 Arduino IDE 的人。
// 需要的函式庫:
//   1. Makeblock(Arduino IDE「函式庫管理員」搜尋 Makeblock,或 mBlock 5 安裝資料夾裡的 Makeblock 函式庫)
//   2. MBC_Sensors v2:擴展 .mext 解壓後的 src/ 四個檔(MBC_Sensors.h/.cpp、mbc_proto.h、mbc_ids.h),
//      放進 文件/Arduino/libraries/MBC_Sensors/ 就能 #include <MBC_Sensors.h>(https://mbc-pro-sensors.github.io/makeblock.html)
// 主板選 Arduino Uno(mBot 的 mCore 就是 Uno),上傳後拔掉 USB 用電池跑。

#include <MeMCore.h>            // mBot(mCore):馬達、LED、蜂鳴器
#include <SoftwareSerial.h>
#include <MBC_Sensors.h>        // MBC 感應器 v2(跟 mBlock 擴展同一份函式庫)

MBCPort mbc_port1(1);           // 感應器接在 mBot 連接埠 1
MeDCMotor motorL(9);           // 左輪(M1)
MeDCMotor motorR(10);          // 右輪(M2)
MeRGBLed rgbled(7, 2);         // 板載 RGB LED(2 顆)
MeBuzzer buzzer;               // 板載蜂鳴器
float turn = 0;               // 變數:轉向

// 左/右輪動力 -100~100(正 = 往前):mBot 的左輪裝反,所以 M1 給負的;% 換算成 PWM 0~255
void wheels(int l, int r) {
  l = constrain(l, -100, 100); r = constrain(r, -100, 100);
  motorL.run(-l * 255 / 100);
  motorR.run(r * 255 / 100);
}

void setup() {   // 跟 mBlock 產生的程式一樣,積木全部在 setup() 裡跑
  mbc_port1.begin();
  delay(1000);   // 等 1 秒讓感應器開機
  while (1) {   // 一直重複
    if ((mbcRead(mbc_port1, 0x0A) == 1)) {   // 如果有找到色塊
      turn = ((mbcRead(mbc_port1, 0x05) - 50) * 0.6);   // 轉向 =(色塊 X − 50)× 0.6(−30 ~ +30)
      wheels((35 + turn), (35 - turn));   // 左輪 = 35 + 轉向、右輪 = 35 − 轉向:色塊在右(正)就左輪快、往右轉
    } else {
      wheels(0, 0);   // 沒找到:停
    }
  }
}

void loop() {}   // 這裡什麼都沒有:上面的積木不會結束

一步一步看懂程式

  1. 等 1 秒讓感應器開機
  2. 一直重複
    • 如果有找到色塊
      • 轉向 =(色塊 X − 50)× 0.6(−30 ~ +30)
      • 左輪 = 35 + 轉向、右輪 = 35 − 轉向:色塊在右(正)就左輪快、往右轉
      • 否則:
        • 沒找到:停

跑起來應該看到什麼:拿著積木在車子前面慢慢移動,車子會跟著走;把積木藏起來車子就停。

常見問題

  • 車子往反方向轉、越修越歪? → 左右輪的「+」「-」對調(或把左輪、右輪的動力互換)。mBot 出廠左輪 M1、右輪 M2,自己接線的請確認。
  • 車子左右搖? → 把 0.6 改小(例如 0.4)。
  • 一直「沒找到」? → 感應器上的 TRACK 設定還沒做、或容許範圍太小。看感應器螢幕:有追蹤框才算找到。
  • 什麼都沒反應、或讀值一直是 -32768? → 連接埠選錯(這頁都接連接埠 1)、插座片沒插緊、或感應器不是 MakeBlock 版。先用「MBC 共用 → 連線正常?」積木確認;「協議版本」讀到 2 才是新韌體(舊韌體請改用舊版擴展 v1)。
  • 上傳失敗、或積木是空白的? → 確認右下角切到「上傳」模式、擴展 v2 已拖進 mBlock、USB 線接的是 mBot 主板。

範例 5:追色塊、靠近就停+燈號

這個範例會做什麼:把範例 2 和 4 合起來,再加「色塊面積」:沒找到停車亮紅燈;面積大於 2500(積木很近了)停車亮藍燈、嗶一聲;其他時候追色塊亮綠燈。這就是「找到目標 → 開過去 → 到了停下」的完整流程。

要準備什麼

  • mBot(mCore 主板)+ mBlock 5 電腦版
  • mBot 兩輪小車(左輪接 M1、右輪接 M2,出廠就是這樣接)
  • 神攝手(學校版)(MakeBlock 版)+ mBot 插座片
  • 一塊顏色鮮豔的積木(紅、綠、藍都可以)

怎麼接:神攝手 → mBot 插座片 → mBot 連接埠 1。鏡頭朝前、裝在車頭。先照上面「開始之前」在感應器上設定要看的顏色。

下載程式

mBlock 5 專案 等價 Arduino 程式
ex05_follow_stop.mblock ex05_follow_stop.ino
mBlock 積木(照著拼就好)
當 mBot 啟動時 :: events hat
wait (1) seconds
forever
  if <神攝手舊版 連接埠 [1 v] 有找到色塊? :: #C2255C> then
    if <(神攝手舊版 連接埠 [1 v] 色塊面積 :: #C2255C) > (2500)> then
      停止移動 :: motion
      LED 燈位置 [全部 v] 的三原色數值為 紅 (0) 綠 (0) 藍 (255) :: looks
      播放音頻 (880) 赫茲,持續 (0.3) 秒 :: sound
    else
      LED 燈位置 [全部 v] 的三原色數值為 紅 (0) 綠 (255) 藍 (0) :: looks
      set [轉向 v] to (((神攝手舊版 連接埠 [1 v] 色塊 X :: #C2255C) - (50)) * (0.6))
      左輪動力 ((35) + (轉向)) %,右輪動力 ((35) - (轉向)) % :: motion
    end
  else
    停止移動 :: motion
    LED 燈位置 [全部 v] 的三原色數值為 紅 (255) 綠 (0) 藍 (0) :: looks
  end
end
🔧 等價 Arduino 程式(mBot)
// 神攝手(學校版) × mBlock 5 範例 5:追色塊、靠近就停+燈號(mBot 等價 Arduino 程式)
// 接線:神攝手 → mBot 插座片 → mBot 連接埠 1。鏡頭朝前、裝在車頭。先照上面「開始之前」在感應器上設定要看的顏色。
// 跟 mBlock 積木範例做的事完全一樣,給想看「積木背後長什麼樣」或用 Arduino IDE 的人。
// 需要的函式庫:
//   1. Makeblock(Arduino IDE「函式庫管理員」搜尋 Makeblock,或 mBlock 5 安裝資料夾裡的 Makeblock 函式庫)
//   2. MBC_Sensors v2:擴展 .mext 解壓後的 src/ 四個檔(MBC_Sensors.h/.cpp、mbc_proto.h、mbc_ids.h),
//      放進 文件/Arduino/libraries/MBC_Sensors/ 就能 #include <MBC_Sensors.h>(https://mbc-pro-sensors.github.io/makeblock.html)
// 主板選 Arduino Uno(mBot 的 mCore 就是 Uno),上傳後拔掉 USB 用電池跑。

#include <MeMCore.h>            // mBot(mCore):馬達、LED、蜂鳴器
#include <SoftwareSerial.h>
#include <MBC_Sensors.h>        // MBC 感應器 v2(跟 mBlock 擴展同一份函式庫)

MBCPort mbc_port1(1);           // 感應器接在 mBot 連接埠 1
MeDCMotor motorL(9);           // 左輪(M1)
MeDCMotor motorR(10);          // 右輪(M2)
MeRGBLed rgbled(7, 2);         // 板載 RGB LED(2 顆)
MeBuzzer buzzer;               // 板載蜂鳴器
float turn = 0;               // 變數:轉向

// 左/右輪動力 -100~100(正 = 往前):mBot 的左輪裝反,所以 M1 給負的;% 換算成 PWM 0~255
void wheels(int l, int r) {
  l = constrain(l, -100, 100); r = constrain(r, -100, 100);
  motorL.run(-l * 255 / 100);
  motorR.run(r * 255 / 100);
}

void setup() {   // 跟 mBlock 產生的程式一樣,積木全部在 setup() 裡跑
  mbc_port1.begin();
  delay(1000);   // 等 1 秒讓感應器開機
  while (1) {   // 一直重複
    if ((mbcRead(mbc_port1, 0x0A) == 1)) {   // 如果有找到色塊
      if ((mbcRead(mbc_port1, 0x09) > 2500)) {   // 如果色塊面積大於 2500
        wheels(0, 0);   // 色塊很大(很近了):停車
        rgbled.setColor(0, 0, 0, 255); rgbled.show();   // 藍燈
        buzzer.tone(880, 300);   // 嗶一聲
      } else {
        rgbled.setColor(0, 0, 255, 0); rgbled.show();   // 綠燈
        turn = ((mbcRead(mbc_port1, 0x05) - 50) * 0.6);   // 轉向 =(色塊 X − 50)× 0.6
        wheels((35 + turn), (35 - turn));   // 左輪 = 35 + 轉向、右輪 = 35 − 轉向
      }
    } else {
      wheels(0, 0);   // 沒找到:停車
      rgbled.setColor(0, 255, 0, 0); rgbled.show();   // 紅燈
    }
  }
}

void loop() {}   // 這裡什麼都沒有:上面的積木不會結束

一步一步看懂程式

  1. 等 1 秒讓感應器開機
  2. 一直重複
    • 如果有找到色塊
      • 如果色塊面積大於 2500
        • 色塊很大(很近了):停車
        • 藍燈
        • 嗶一聲
        • 否則:
          • 綠燈
          • 轉向 =(色塊 X − 50)× 0.6
          • 左輪 = 35 + 轉向、右輪 = 35 − 轉向
      • 否則:
        • 沒找到:停車
        • 紅燈

跑起來應該看到什麼:積木放在前方 1 公尺:車子亮綠燈開過去,到積木前面變藍燈、嗶一聲停下;把積木拿走變紅燈。

常見問題

  • 還很遠就停了、或撞到積木才停? → 面積跟積木大小有關:先用感應器螢幕看積木在想停的距離時 A(面積)是多少,再改 2500。
  • 車子往反方向轉、越修越歪? → 左右輪的「+」「-」對調(或把左輪、右輪的動力互換)。mBot 出廠左輪 M1、右輪 M2,自己接線的請確認。
  • 一直「沒找到」? → 感應器上的 TRACK 設定還沒做、或容許範圍太小。看感應器螢幕:有追蹤框才算找到。
  • 什麼都沒反應、或讀值一直是 -32768? → 連接埠選錯(這頁都接連接埠 1)、插座片沒插緊、或感應器不是 MakeBlock 版。先用「MBC 共用 → 連線正常?」積木確認;「協議版本」讀到 2 才是新韌體(舊韌體請改用舊版擴展 v1)。
  • 上傳失敗、或積木是空白的? → 確認右下角切到「上傳」模式、擴展 v2 已拖進 mBlock、USB 線接的是 mBot 主板。

下一步

其他問題

  • 積木一直回 0? 確認積木選的連接埠跟實際插的一樣,並且已經用「上傳」模式把程式燒進主板。
  • 舊的擴展還能用嗎? 2026-10 以前出貨的感應器用舊版擴展 v1.0.0;新舊積木不相容,依韌體版本選。

還有問題?到 聯絡我們 附上你用的軟體和程式截圖。

下載

本頁依據

  • 主機與軟體清單:_build/guides.json
  • 值與命令:_build/protocol/cam_school.json、_build/protocol/cam_wro.json(單一真相來源)
  • 安裝與設定:_build/guides/software/mblock-mblock5.zh.md、_build/guides/product/esp32cam/mblock-mblock5.zh.md
  • 範例:sensors/esp32cam/mblock-examples(-wro).md
LINE 詢價選購指南