範圍	意思
`0~120` cm（EV3 模式 2 讀到的是換算值：cm×100/120（0~100））	8 顆裡最小的距離 0~120 cm（失效那顆以 120 參與），120 = 四周沒東西

' clev3r (BASIC)
Sensor.SetMode(1, 2)
nearCm = Sensor.ReadRawValue(1, 1)

模式 2 · int8 · IR-REMOTE [最近方向−8, 最近', 最空曠方向−8, 最空曠']（INO:154-159）（已鎖住的模式，韌體與主機端都不再改）

最近方向 nearDir

範圍	意思
`-8~+8`	最近目標在哪個方向：−7（正左）~ +7（正右），0 = 正前方，負 = 左；±8 = 四周沒東西（沿用上次偏向側）

' clev3r (BASIC)
Sensor.SetMode(1, 2)
nearDir = Sensor.ReadRawValue(1, 0)
Sensor.SetMode(1, 5)
nearDir = Sensor.ReadRawValue(1, 1)

模式 2 · int8 · int8 二補數（方位−8）；模式 5 · int16 · #67 新：IR-CAL 2×int16 = [最近 mm, 最近方向 −8~+8]（原本 = 前 4 顆兩兩合併）（已鎖住的模式，韌體與主機端都不再改）

最空曠距離 cm farCm

範圍	意思
`0~120` cm（EV3 模式 2 讀到的是換算值：cm×100/120（0~100））	8 顆裡最大的距離 0~120 cm（壞掉那顆永遠 120，會被當成最空曠）

' clev3r (BASIC)
Sensor.SetMode(1, 2)
farCm = Sensor.ReadRawValue(1, 3)

模式 2 · int8（已鎖住的模式，韌體與主機端都不再改）

最空曠方向 farDir

範圍	意思
`-7~+7`	最遠（最空曠）在哪個方向：−7 ~ +7，0 = 正前方，負 = 左；8 顆全 120 時 = 0

' clev3r (BASIC)
Sensor.SetMode(1, 2)
farDir = Sensor.ReadRawValue(1, 2)

模式 2 · int8 · int8 二補數（方位−8）（已鎖住的模式，韌體與主機端都不再改）

正前方 cm frontCm

範圍	意思
`0~120` cm（EV3 模式 0 讀到的是換算值：cm×100/120（0~100））	第 4、5 顆（兩顆平行朝前）平均 0~120 cm；EV3 模式 3、SPIKE 模式 6 給的是同一個值的 mm；0x22 的 C 是 min(第 4, 第 5 顆) 不是平均（見 10）

' clev3r (BASIC)
Sensor.SetMode(1, 0)
frontCm = Sensor.ReadRawValue(1, 0)

模式 0 · int8 · IR-PROX = (第 4'+第 5')>>1（鎖住，INO:148-150）（已鎖住的模式，韌體與主機端都不再改）

最近距離 mm nearMm

範圍	意思
`0~1200` mm	8 顆 mm 的最小值 0~1200（失效那顆以 1200 參與），1200 = 四周沒東西

' clev3r (BASIC)
Sensor.SetMode(1, 5)
nearMm = Sensor.ReadRawValue(1, 0)

模式 5 · int16 · #67 新：[最近 mm, 最近方向]

正前方距離 mm frontMm

範圍	意思
`0~1200` mm（EV3 模式 3 讀到的是換算值：mm（0~1200））	第 4、5 顆（正前方兩顆）平均，0~1200 mm；1200 = 前面沒東西。cm 版是 05

' clev3r (BASIC)
Sensor.SetMode(1, 3)
frontMm = Sensor.ReadRawValue(1, 0)

模式 3 · int16 · #67 新：IR-REM-A 1×int16 = 正前方（第 4、5 顆平均）mm（原本 = 第 1 顆 0~100）

第 1~8 顆距離 cm distCm

範圍	意思
`0~120` cm（EV3 模式 1、模式 4 讀到的是換算值：cm×100/120（0~100））	第 1~~8 顆各自的距離 0~~120 cm（第 1 顆正左、第 4、5 顆正前、第 8 顆正右，每顆隔 30°）；120 = 那個方向沒東西／那顆失效；編號 10~17

' clev3r (BASIC)
Sensor.SetMode(1, 1)
distCm1 = Sensor.ReadRawValue(1, 0)   ' 第 1 筆；第 N 筆改成 0 + N - 1
Sensor.SetMode(1, 4)
distCm1 = Sensor.ReadRawValue(1, 0)   ' 第 1 筆；第 N 筆改成 0 + N - 1

模式 1 · int8 · IR-SEEK 8×int8 = 第 1~8 顆（EV3 視為頻道 1~4 的〈方位,距離〉）；模式 4 · int8 · IR-S-ALT = 前 4 顆（已鎖住的模式，韌體與主機端都不再改）

這個軟體讀不到：初始化位元圖、故障位元圖、第 1~8 顆距離 mm。要用這些值請改用 Arduino／mBlock／micro:bit。

範例

範例 1：量量看正前方有多遠

這個範例會做什麼： 八方位雷射的模式 0 會給你正前方（中間兩顆）的平均距離，最簡單好用。

要準備什麼：

TOF8 八方位雷射（EV3 版）
EV3 主機

怎麼接： TOF8 八方位雷射插 1 號孔。

下載程式（選你用的軟體）：

⬇ clev3r

clev3r 程式碼

' ============================================================
' TOF8 八方位雷射測距感應器 EV3 新手範例 01：量量看正前方有多遠
' 軟體：clev3r
' 接法：TOF8 八方位雷射插 1 號孔；左輪馬達接 B、右輪馬達接 C
' 這個範例會做什麼：八方位雷射的模式 0 會給你正前方（中間兩顆）的平均距離，最簡單好用。
' 讀值：front＝正前方（第 4、5 顆平均）距離（0 ~ 100（1 格＝1.2 公分，100＝前面沒東西））
' ============================================================
folder "prjs" "MBC_tof8_ex01"

' TOF8 八方位雷射插 1 號孔，使用模式 0
Sensor.SetMode(1, 0)
LCD.Clear()

' 清除螢幕
LCD.Clear()
' 一直重複
While "True"
  ' 第 1 行顯示正前方距離（0~100）
  LCD.Text(1, 0, 0, 1, "FRONT " + Sensor.ReadRawValue(1, 0) + "      ")
  ' 第 2 行換算成公分：× 1.2
  LCD.Text(1, 0, 16, 1, "CM " + Sensor.ReadRawValue(1, 0) * 1.2 + "      ")
  ' 等 0.1 秒
  Program.Delay(100)
EndWhile

一步一步看懂程式：

清除螢幕
一直重複
- 第 1 行顯示正前方距離（0~100）
- 第 2 行換算成公分：× 1.2
- 等 0.1 秒

跑起來應該看到： 手在正前方移動，數字跟著變；前面沒東西時是 100。

常見問題：

數字跟尺量的不一樣？ EV3 上 1 格＝1.2 公分（例如讀到 25＝30 公分），100 代表前面 120 公分內沒有東西。
數字一直是 0 或不變？ EV3 主機先開機再接感應器，或拔掉重插一次；確認雷射前面沒有貼保護膜。

範例 2：前方 30 公分停車

這個範例會做什麼： 車子往前開，正前方 30 公分（數字 25）以內有東西就停下來。

要準備什麼：

EV3 主機＋教育版基本車（左輪接 B、右輪接 C）
TOF8 八方位雷射（EV3 版）
幾個盒子當障礙物

怎麼接： TOF8 八方位雷射插 1 號孔，裝在車頭、第 4、5 顆雷射朝正前方，離地約 5 公分。

下載程式（選你用的軟體）：

⬇ clev3r

clev3r 程式碼

' ============================================================
' TOF8 八方位雷射測距感應器 EV3 新手範例 02：前方 30 公分停車
' 軟體：clev3r
' 接法：TOF8 八方位雷射插 1 號孔；左輪馬達接 B、右輪馬達接 C
' 這個範例會做什麼：車子往前開，正前方 30 公分（數字 25）以內有東西就停下來。
' 讀值：front＝正前方（第 4、5 顆平均）距離（0 ~ 100（1 格＝1.2 公分，100＝前面沒東西））
' ============================================================
folder "prjs" "MBC_tof8_ex02"

' TOF8 八方位雷射插 1 號孔，使用模式 0
Sensor.SetMode(1, 0)
LCD.Clear()

' 兩輪往前開
Motor.StartPower("B", 30)
Motor.StartPower("C", 30)
' 等到正前方距離小於 25
While Sensor.ReadRawValue(1, 0) >= 25
  Program.Delay(10)
EndWhile
' 停車
Motor.Stop("BC", "True")
' 嗶一聲
Speaker.Tone(50, 1000, 100)
Speaker.Wait()

一步一步看懂程式：

兩輪往前開
等到正前方距離小於 25
停車
嗶一聲

跑起來應該看到： 車子在障礙物前約 30 公分停下來並嗶一聲。

常見問題：

數字跟尺量的不一樣？ EV3 上 1 格＝1.2 公分（例如讀到 25＝30 公分），100 代表前面 120 公分內沒有東西。

範例 3：一次看 8 個方向的距離

這個範例會做什麼： 模式 1 會一次送出 8 顆雷射各自的距離。這個範例把 8 個數字都顯示在螢幕上，拿手在四周晃一晃，就知道每顆雷射對應哪個方向。

要準備什麼：

TOF8 八方位雷射（EV3 版）
EV3 主機

怎麼接： TOF8 八方位雷射插 1 號孔。

下載程式（選你用的軟體）：

⬇ clev3r

clev3r 程式碼

' ============================================================
' TOF8 八方位雷射測距感應器 EV3 新手範例 03：一次看 8 個方向的距離
' 軟體：clev3r
' 接法：TOF8 八方位雷射插 1 號孔；左輪馬達接 B、右輪馬達接 C
' 這個範例會做什麼：模式 1 會一次送出 8 顆雷射各自的距離。這個範例把 8 個數字都顯示在螢幕上，拿手在四周晃一晃，就知道每顆雷射對應哪個方向。
' 讀值：d1＝第 1 顆雷射的距離（0 ~ 100（1 格＝1.2 公分））；d2＝第 2 顆雷射的距離（0 ~ 100（1 格＝1.2 公分））；d3＝第 3 顆雷射的距離（0 ~ 100（1 格＝1.2 公分））；d4＝第 4 顆雷射的距離（0 ~ 100（1 格＝1.2 公分））；d5＝第 5 顆雷射的距離（0 ~ 100（1 格＝1.2 公分））；d6＝第 6 顆雷射的距離（0 ~ 100（1 格＝1.2 公分））；d7＝第 7 顆雷射的距離（0 ~ 100（1 格＝1.2 公分））；d8＝第 8 顆雷射的距離（0 ~ 100（1 格＝1.2 公分））
' ============================================================
folder "prjs" "MBC_tof8_ex03"

' TOF8 八方位雷射插 1 號孔，使用模式 1
Sensor.SetMode(1, 1)
LCD.Clear()

' 清除螢幕
LCD.Clear()
' 一直重複
While "True"
  ' 第 1 行顯示第 1 顆雷射的距離
  LCD.Text(1, 0, 0, 1, "D1 " + Sensor.ReadRawValue(1, 0) + "      ")
  ' 第 2 行顯示第 2 顆雷射的距離
  LCD.Text(1, 0, 16, 1, "D2 " + Sensor.ReadRawValue(1, 1) + "      ")
  ' 第 3 行顯示第 3 顆雷射的距離
  LCD.Text(1, 0, 32, 1, "D3 " + Sensor.ReadRawValue(1, 2) + "      ")
  ' 第 4 行顯示第 4 顆雷射的距離
  LCD.Text(1, 0, 48, 1, "D4 " + Sensor.ReadRawValue(1, 3) + "      ")
  ' 第 5 行顯示第 5 顆雷射的距離
  LCD.Text(1, 0, 64, 1, "D5 " + Sensor.ReadRawValue(1, 4) + "      ")
  ' 第 6 行顯示第 6 顆雷射的距離
  LCD.Text(1, 0, 80, 1, "D6 " + Sensor.ReadRawValue(1, 5) + "      ")
  ' 第 7 行顯示第 7 顆雷射的距離
  LCD.Text(1, 0, 96, 1, "D7 " + Sensor.ReadRawValue(1, 6) + "      ")
  ' 第 8 行顯示第 8 顆雷射的距離
  LCD.Text(1, 0, 112, 1, "D8 " + Sensor.ReadRawValue(1, 7) + "      ")
  ' 等 0.1 秒
  Program.Delay(100)
EndWhile

一步一步看懂程式：

清除螢幕
一直重複
- 第 1 行顯示第 1 顆雷射的距離
- 第 2 行顯示第 2 顆雷射的距離
- 第 3 行顯示第 3 顆雷射的距離
- 第 4 行顯示第 4 顆雷射的距離
- 第 5 行顯示第 5 顆雷射的距離
- 第 6 行顯示第 6 顆雷射的距離
- 第 7 行顯示第 7 顆雷射的距離
- 第 8 行顯示第 8 顆雷射的距離
- 等 0.1 秒

跑起來應該看到： 8 行數字分別對應 8 顆雷射，手靠近哪一顆，那一行數字就變小。

常見問題：

數字跟尺量的不一樣？ EV3 上 1 格＝1.2 公分（例如讀到 25＝30 公分），100 代表前面 120 公分內沒有東西。
第 1 顆在左邊還是右邊？ 請用手實際試一次並記下來，之後寫程式會用到。

範例 4：相撲追擊：轉向最近的東西衝過去

這個範例會做什麼： 模式 2 會直接告訴你「最近的東西在哪個方向、有多遠」，不用自己比 8 個數字。車子轉向最近的東西衝過去，看不到東西時原地轉圈找。

要準備什麼：

EV3 主機＋教育版基本車（左輪接 B、右輪接 C）
TOF8 八方位雷射（EV3 版）
一個罐子當對手

怎麼接： TOF8 八方位雷射插 1 號孔，裝在車頭、第 4、5 顆雷射朝正前方，離地約 5 公分。

下載程式（選你用的軟體）：

⬇ clev3r

clev3r 程式碼

' ============================================================
' TOF8 八方位雷射測距感應器 EV3 新手範例 04：相撲追擊：轉向最近的東西衝過去
' 軟體：clev3r
' 接法：TOF8 八方位雷射插 1 號孔；左輪馬達接 B、右輪馬達接 C
' 這個範例會做什麼：模式 2 會直接告訴你「最近的東西在哪個方向、有多遠」，不用自己比 8 個數字。車子轉向最近的東西衝過去，看不到東西時原地轉圈找。
' 讀值：nearDist＝最近的東西有多遠（0 ~ 100）；nearDir＝最近的東西在哪個方向（-7 ~ +7（負＝左、正＝右、0 附近＝正前方；±8＝沒有東西））
' ============================================================
folder "prjs" "MBC_tof8_ex04"

' TOF8 八方位雷射插 1 號孔，使用模式 2
Sensor.SetMode(1, 2)
LCD.Clear()

' 一直重複
While "True"
  ' 如果最近的東西在 60 以內（約 72 公分）
  If Sensor.ReadRawValue(1, 1) < 60 Then
    ' 如果方向小於 -1（偏左）
    If Sensor.ReadRawValue(1, 0) < (-1) Then
      ' 東西在左邊：原地往左轉
      Motor.StartPower("B", -20)
      Motor.StartPower("C", 20)
    ' 否則，如果方向大於 1（偏右）
    ElseIf Sensor.ReadRawValue(1, 0) > 1 Then
      ' 東西在右邊：原地往右轉
      Motor.StartPower("B", 20)
      Motor.StartPower("C", -20)
    Else
      ' 東西在正前方：全力衝過去
      Motor.StartPower("B", 60)
      Motor.StartPower("C", 60)
    EndIf
  Else
    ' 附近沒東西：原地轉圈找對手
    Motor.StartPower("B", 25)
    Motor.StartPower("C", -25)
  EndIf
EndWhile

一步一步看懂程式：

一直重複
- 如果最近的東西在 60 以內（約 72 公分）
  - 如果方向小於 -1（偏左）
    - 東西在左邊：原地往左轉
    - 否則：
      - 否則，如果方向大於 1（偏右）
        
        東西在右邊：原地往右轉
        
        否則：
        
        東西在正前方：全力衝過去
  - 否則：
    - 附近沒東西：原地轉圈找對手

跑起來應該看到： 把罐子放在車子周圍，車子會轉向罐子並衝過去推它。

常見問題：

方向數字是 8 或 -8？ ±8 代表那個方向 120 公分內沒有東西，不是「最左」「最右」。
轉過頭來回擺？ 把轉向的 20 改小，或把 -1 和 1 改成 -2 和 2。

範例 5：往最空曠的方向走

這個範例會做什麼： 模式 2 也會告訴你「最空曠的方向」。車子用比例控制一直往最空的地方開，在箱子陣裡會自己找出口。

要準備什麼：

EV3 主機＋教育版基本車（左輪接 B、右輪接 C）
TOF8 八方位雷射（EV3 版）
幾個盒子當障礙物

怎麼接： TOF8 八方位雷射插 1 號孔，裝在車頭、第 4、5 顆雷射朝正前方，離地約 5 公分。

下載程式（選你用的軟體）：

⬇ clev3r

clev3r 程式碼

' ============================================================
' TOF8 八方位雷射測距感應器 EV3 新手範例 05：往最空曠的方向走
' 軟體：clev3r
' 接法：TOF8 八方位雷射插 1 號孔；左輪馬達接 B、右輪馬達接 C
' 這個範例會做什麼：模式 2 也會告訴你「最空曠的方向」。車子用比例控制一直往最空的地方開，在箱子陣裡會自己找出口。
' 讀值：farDir＝最空曠的方向（-7 ~ +7（負＝左、正＝右））
' ============================================================
folder "prjs" "MBC_tof8_ex05"

' TOF8 八方位雷射插 1 號孔，使用模式 2
Sensor.SetMode(1, 2)
LCD.Clear()

' 一直重複
While "True"
  ' 轉彎力量 turn ＝ 最空方向 × 5（負數往左、正數往右）
  turn = Sensor.ReadRawValue(1, 2) * 5
  ' 左輪＝25＋turn、右輪＝25－turn
  Motor.StartPower("B", 25 + turn)
  Motor.StartPower("C", 25 - turn)
EndWhile

一步一步看懂程式：

一直重複
- 轉彎力量 turn ＝最空方向 × 5（負數往左、正數往右）
- 左輪＝25＋turn、右輪＝25－turn

跑起來應該看到： 車子會避開箱子，往空的地方前進。

常見問題：

方向數字是 8 或 -8？ ±8 代表那個方向 120 公分內沒有東西，不是「最左」「最右」。
一直往牆壁開？ 方向的正負可能跟車子相反，把程式裡的「＋turn」和「－turn」對調。

範例 6：最近的東西在哪、幾公釐

僅 Pybricks v4／EV3 MicroPython v2.0／clev3r（EV3-G、Classroom 的積木讀不到這個模式）

這個範例會做什麼： 模式 5 一次給兩個數字：最近的東西有幾公釐、在哪個方向（-7~+7）。比模式 2 的 1.2 公分一格準 12 倍。這個範例把兩個數字顯示在螢幕上，東西靠到 15 公分內就嗶一聲。

要準備什麼：

TOF8 八方位雷射（EV3 版，韌體 v4.0 以上）
EV3 主機

怎麼接： TOF8 八方位雷射插 1 號孔。

下載程式（選你用的軟體）：

⬇ clev3r

（程式碼即範例，不需截圖。）

clev3r 程式碼

' ============================================================
' TOF8 八方位雷射測距感應器 EV3 新手範例 06：最近的東西在哪、幾公釐
' 軟體：clev3r
' 接法：TOF8 八方位雷射插 1 號孔；左輪馬達接 B、右輪馬達接 C
' 這個範例會做什麼：模式 5 一次給兩個數字：最近的東西有幾公釐、在哪個方向（-7~+7）。比模式 2 的 1.2 公分一格準 12 倍。這個範例把兩個數字顯示在螢幕上，東西靠到 15 公分內就嗶一聲。
' 讀值：nearMm＝最近的東西有多遠（公釐）（0 ~ 1200 mm）；nearDir5＝最近的東西在哪個方向（-7 ~ +7（負＝左、正＝右、0 附近＝正前方；±8＝沒有東西））
' ============================================================
folder "prjs" "MBC_tof8_ex06"

' TOF8 八方位雷射插 1 號孔，使用模式 5
Sensor.SetMode(1, 5)
LCD.Clear()

' 清除螢幕
LCD.Clear()
' 一直重複
While "True"
  ' 第 1 行顯示最近的東西有幾公釐
  LCD.Text(1, 0, 0, 1, "NEARMM " + Sensor.ReadRawValue(1, 0) + "      ")
  ' 第 2 行顯示它在哪個方向（負＝左、正＝右、0＝正前方）
  LCD.Text(1, 0, 16, 1, "DIR " + Sensor.ReadRawValue(1, 1) + "      ")
  ' 如果最近的東西不到 150 公釐（15 公分）
  If Sensor.ReadRawValue(1, 0) < 150 Then
    ' 不到 15 公分：嗶一聲
    Speaker.Tone(50, 1000, 100)
    Speaker.Wait()
  EndIf
  ' 等 0.1 秒
  Program.Delay(100)
EndWhile

一步一步看懂程式：

清除螢幕
一直重複
- 第 1 行顯示最近的東西有幾公釐
- 第 2 行顯示它在哪個方向（負＝左、正＝右、0＝正前方）
- 如果最近的東西不到 150 公釐（15 公分）
  - 不到 15 公分：嗶一聲
- 等 0.1 秒

跑起來應該看到： 手在感應器周圍移動，第 1 行的公釐數跟著變，第 2 行告訴你手在左邊（負）還是右邊（正）；手靠到 15 公分內 EV3 就一直嗶。

常見問題：

方向數字是 8 或 -8？ ±8 代表那個方向 120 公分內沒有東西，不是「最左」「最右」。
數字一直是 0 或不會動？ 感應器韌體要 v4.0（2026-10）以上才有這個模式，舊韌體請先更新。
EV3-G／Classroom 怎麼沒有這個範例？ 這個範例用的是新模式（2026-10 韌體 v4 起），EV3-G 和 Classroom 的紅外線積木讀不到，只有 Pybricks、EV3 MicroPython、clev3r 能用。

還有問題？歡迎到聯絡我們留言，附上你用的軟體和程式截圖，我們會幫你看。

其他問題

EV3 顯示成紅外線感應器？ 正常：感應器模擬成樂高原廠感應器，用原廠積木就能讀。
切換模式時卡一下？ EV3 每次換模式要等約 1 秒。整趟任務盡量只用同一個模式的積木。

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

下載

下載中心（全部產品的函式庫、韌體、型錄）

本頁依據

主機與軟體清單：_build/guides.json
值與命令：_build/protocol/tof8.json（單一真相來源）
安裝與設定：_build/guides/software/ev3-clev3r.zh.md、_build/guides/product/tof8/ev3-clev3r.zh.md
範例：sensors/tof8/ev3-examples.md