{
 "byKey": {
  "cover": [
   {
    "say": "大家好,歡迎回到從無到有打造 A I 機器人。這一章,我們要讓車子動起來。會學到 P W M 為什麼能調速、差速為什麼能轉向,認識 G P I O 和 gpiozero,最後寫出一個安全的馬達函式。",
    "item": 0
   }
  ],
  "原理:PWM 為何能調速,差速為何能轉向#1": [
   {
    "say": "先用一個生活類比,快速點動的電風扇。",
    "item": 0
   },
   {
    "say": "如果你把風扇的開關,在一秒內按下、放開很多次,只要按得夠快,風扇葉片因為慣性來不及停下,就會以平均的力道轉動。按下的時間占比越長,就轉得越快。",
    "item": 1
   },
   {
    "say": "P W M 做的就是這件事。至於兩個輪子速度不同,車子就會像划船一樣轉彎。",
    "item": 1
   }
  ],
  "原理:PWM 為何能調速,差速為何能轉向#2": [
   {
    "say": "先看原理一,P W M 與平均電壓。",
    "item": 0
   },
   {
    "say": "P W M,脈寬調變,讓輸出腳位在高電位與低電位之間快速切換。一個週期裡,高電位所占的比例,叫工作週期,用 D 表示。",
    "item": 1
   },
   {
    "say": "馬達有線圈電感和轉子慣性,這兩個東西像一個低通濾波器,電流和轉速沒辦法跟著每個方波劇烈跳動,只會呈現平滑的平均效果。條件是 P W M 的頻率,要遠高於馬達的反應速度。",
    "item": 2
   },
   {
    "say": "頻率太低,馬達就會一頓一頓的。gpiozero 的軟體 P W M,常見預設頻率大約一百赫茲,對小馬達通常足夠,也可能聽到嗡嗡聲。",
    "item": 2
   },
   {
    "say": "來看數值例。電源六伏特,D 是百分之四十,平均電壓就是六乘零點四,等於二點四伏特。",
    "item": 3
   },
   {
    "say": "也就是,平均電壓等於電源電壓乘上 D。不過實際轉速還要考慮摩擦造成的死區,馬達要克服靜摩擦才轉得動,所以 duty 太低的時候完全不轉。這就是第三章要量測 DEADBAND 的原因。",
    "item": 4
   }
  ],
  "原理:PWM 為何能調速,差速為何能轉向#3": [
   {
    "say": "這張圖,畫的是 P W M 平均化的原理。",
    "item": 0
   },
   {
    "say": "上方是 duty 百分之五十的方波,下方是馬達的轉速曲線。你可以看到,起步的時候有慣性造成的延遲,之後就穩定在平均值附近。",
    "item": 1
   }
  ],
  "原理:PWM 為何能調速,差速為何能轉向#4": [
   {
    "say": "接著是原理二,差速轉向與轉彎半徑。",
    "item": 0
   },
   {
    "say": "兩輪差速的車子,車體的運動可以由左右輪的速度決定。前進速度,等於右輪與左輪速度的平均。轉向角速度,等於右輪減左輪,再除以輪距。轉彎半徑,等於前進速度除以角速度。",
    "item": 1
   },
   {
    "say": "旋轉中心,落在兩輪軸線的延長線上。內側輪走比較小的圓,外側輪走比較大的圓,兩者的角速度相同,所以線速度和半徑成正比。",
    "item": 2
   },
   {
    "say": "舉個例子,輪距零點一四公尺,要以半徑零點三五公尺、前進速度每秒零點二五公尺轉彎。算出來左輪每秒零點二公尺,右輪每秒零點三公尺。驗算一下,兩個速度平均是零點二五,速度差除以輪距是零點七一四,完全吻合。",
    "item": 3
   },
   {
    "say": "還有兩個特例。左右輪速度大小相同、方向相反的時候,前進速度是零,半徑也是零,車子原地旋轉。如果左輪速度是零,車子就繞著左輪轉,半徑是輪距的一半。",
    "item": 4
   }
  ],
  "原理:PWM 為何能調速,差速為何能轉向#5": [
   {
    "say": "我們把剛剛的三個公式,分兩頁再看一次。",
    "item": 0
   },
   {
    "say": "第一個,前進速度,等於右輪加左輪速度,除以二。",
    "item": 1
   },
   {
    "say": "第二個,轉向角速度,等於右輪減左輪速度,再除以輪距,逆時針為正。",
    "item": 2
   },
   {
    "say": "第三個,轉彎半徑,等於前進速度除以角速度。",
    "item": 3
   }
  ],
  "原理:PWM 為何能調速,差速為何能轉向#6": [
   {
    "say": "接著是數值例的計算過程。",
    "item": 0
   },
   {
    "say": "第一步,角速度等於前進速度除以半徑,零點二五除以零點三五,等於每秒零點七一四弧度。",
    "item": 1
   },
   {
    "say": "第二步,左輪速度,等於角速度乘上半徑減輪距的一半。零點七一四乘零點三五減零點零七,等於每秒零點二公尺。",
    "item": 2
   },
   {
    "say": "第三步,右輪速度,等於角速度乘上半徑加輪距的一半。零點七一四乘零點三五加零點零七,等於每秒零點三公尺。",
    "item": 3
   }
  ],
  "原理:PWM 為何能調速,差速為何能轉向#7": [
   {
    "say": "這張是差速驅動轉彎的幾何圖。",
    "item": 0
   },
   {
    "say": "圖中,旋轉中心位在兩輪連線的延長線上,並且標出半徑,以及左右輪線速度的公式。下方有一個輪距等於零點一四公尺的數值例,就是我們剛剛算的那一題。",
    "item": 1
   }
  ],
  "GPIO 基礎與 gpiozero#1": [
   {
    "say": "好,來看 G P I O 基礎與 gpiozero。為什麼要懂 G P I O?",
    "item": 0
   },
   {
    "say": "G P I O 是通用輸入輸出,就是樹莓派和外部硬體溝通的腳位。每支腳位可以設成輸出,送出三點三伏特或零伏特,也可以設成輸入,讀進高電位或低電位。",
    "item": 1
   },
   {
    "say": "機器人的馬達方向、超音波的 TRIG、循線感測器的讀值,全都從 G P I O 進出。懂了這一層,後面的每個零件,都只是換一種訊號的 G P I O。",
    "item": 1
   }
  ],
  "GPIO 基礎與 gpiozero#2": [
   {
    "say": "先看輸出和輸入的基本觀念。",
    "item": 0
   },
   {
    "say": "輸出,就是程式讓腳位變高,約三點三伏特,或變低,約零伏特。接 L E D 的時候,要串聯限流電阻,不要直接把 L E D 接電源。",
    "item": 1
   },
   {
    "say": "輸入,是讀取腳位是高還是低。如果腳位沒有接任何東西,電位是浮動的,讀值會亂跳。所以按鈕要搭配上拉或下拉電阻,樹莓派可以用軟體啟用內部上拉。",
    "item": 2
   },
   {
    "say": "還有電流限制。單支腳位只能輸出很小的電流,依官方文件而定,所以不能直接驅動馬達,也不能直接驅動大功率的 L E D。",
    "item": 3
   }
  ],
  "GPIO 基礎與 gpiozero#3": [
   {
    "say": "接下來認識 gpiozero,一個好讀的 Python 函式庫。",
    "item": 0
   },
   {
    "say": "它是 Raspberry Pi OS 內建的函式庫,把腳位包成裝置物件,你不需要去記暫存器。",
    "item": 1
   },
   {
    "say": "以按鈕為例,Button 搭配第十六號腳位,預設用內部上拉,按鈕的另一端接 GND。沒按的時候,讀到高電位,按下的時候,讀到低電位。gpiozero 已經幫你轉成 is pressed 這個屬性,按下就是真。",
    "item": 2
   }
  ],
  "GPIO 基礎與 gpiozero#4": [
   {
    "say": "畫面上是一段程式的開頭,分兩頁看。",
    "item": 0
   },
   {
    "say": "第一行,從 gpiozero 匯入 L E D、Button、Motor、DistanceSensor 和 LineSensor 這幾種裝置。",
    "item": 1
   },
   {
    "say": "接著建立一個 L E D,接在第二十六號腳位,這是狀態燈。",
    "item": 2
   },
   {
    "say": "再建立一個按鈕,接在第十六號腳位,這是急停按鈕,預設啟用內部上拉。",
    "item": 3
   },
   {
    "say": "然後呼叫 on,就可以把 L E D 打開。",
    "item": 4
   }
  ],
  "GPIO 基礎與 gpiozero#5": [
   {
    "say": "最後一行,是把急停按鈕的 is pressed 印出來。",
    "item": 0
   },
   {
    "say": "按下按鈕的時候,它會是真。你可以自己試試看,按著按鈕再執行,看結果有沒有改變。",
    "item": 1,
    "pause": 3
   }
  ],
  "GPIO 基礎與 gpiozero#6": [
   {
    "say": "再來介紹腳位工廠,也就是 pin factory,還有版本的差異。",
    "item": 0
   },
   {
    "say": "gpiozero 底下有一層 pin factory,負責真正去操作腳位。",
    "item": 1
   },
   {
    "say": "樹莓派五使用新的 RP1 晶片,舊的 RPi.GPIO 函式庫不支援樹莓派五,gpiozero 二點 x 版在樹莓派五上使用 lgpio。在 Raspberry Pi OS 上,通常已經預先設定好,不用自己改。",
    "item": 1
   },
   {
    "say": "如果遇到找不到 pin factory 的錯誤,先確認 gpiozero 的版本,以及 python3 lgpio 有沒有安裝。實際的套件名稱和預設行為,依系統版本而異。",
    "item": 1
   }
  ],
  "GPIO 基礎與 gpiozero#7": [
   {
    "say": "最後,也可以用命令列來看腳位的狀態。",
    "item": 0
   },
   {
    "say": "現代的 Linux,透過 gpiochip 字元裝置來存取 G P I O,libgpiod 提供了一組工具。",
    "item": 1
   },
   {
    "say": "gpiodetect 列出 G P I O 晶片,gpioinfo 列出各條 line 的名稱、方向和占用者,gpioget 和 gpioset 則是讀取與設定。",
    "item": 1
   },
   {
    "say": "要注意,libgpiod 有一點 x 版和二點 x 版兩種語法,兩者寫法不一樣。樹莓派五的排針 G P I O 在 RP1 晶片上,晶片編號依核心版本而異,請用 gpiodetect 和 gpioinfo 查證,不要憑記憶。",
    "item": 2
   },
   {
    "say": "舊的 sys class gpio 介面已經被棄用,不建議使用。本章後面有練習這些指令的終端機單元。",
    "item": 2
   }
  ],
  "PWM 與安全的馬達函式#1": [
   {
    "say": "接下來,我們要寫一個安全的馬達函式。先看目標。",
    "item": 0
   },
   {
    "say": "我們要把兩個馬達包成一個函式,叫 set motors,輸入左右各一個數字,範圍是負一百到一百。正的是前進,負的是後退,零是停止。",
    "item": 1
   },
   {
    "say": "之後所有的行為程式,都只呼叫這個函式,不再直接碰腳位。模擬器裡的 robot 點 set motors,用的是同樣的概念,所以你在模擬器練好的邏輯,可以搬到實體小車上。",
    "item": 1
   }
  ],
  "PWM 與安全的馬達函式#2": [
   {
    "say": "這張圖是 P W M 的波形示意。",
    "item": 0
   },
   {
    "say": "圖上有工作週期百分之二十五、百分之五十和百分之七十五的方波。你可以看到,高電位的比例越大,平均電壓越高,馬達就轉得越快。",
    "item": 1
   }
  ],
  "PWM 與安全的馬達函式#3": [
   {
    "say": "這是基本版本的程式,我們分段來看。這裡的腳位,是以第二章的腳位為例,腳位以你的板子與程式碼為準。",
    "item": 0
   },
   {
    "say": "程式一開始,建立左右兩個 Motor 物件,把前進、後退和致能腳位,對應到我們規劃的腳位,並且啟用 P W M。接著定義兩個常數,速度上限設成六十,安全起見先設小一些。還有最低可動的 duty,設成二十五,這個數字需要自己量測。",
    "item": 1
   },
   {
    "say": "再來是一個內部函式,負責驅動單一個馬達。它先把輸入值夾在負的速度上限和正的速度上限之間。如果是零就停止並離開。不是零的話,就用死區補償的公式算出 duty,再取不超過速度上限,最後依正負決定前進或後退。",
    "item": 2
   },
   {
    "say": "然後是 set motors,就是分別呼叫兩次這個內部函式,驅動左右馬達。",
    "item": 3
   },
   {
    "say": "最後是 stop,把左右馬達都停下來。Motor 的 forward 和 backward 參數,對應驅動板的 IN1 和 IN2,enable 對應 ENA 和 ENB,速度值是零到一。",
    "item": 4
   },
   {
    "say": "參數名稱等細節,依 gpiozero 版本而異,請查閱你安裝版本的文件。",
    "item": 4
   }
  ],
  "PWM 與安全的馬達函式#4": [
   {
    "say": "同一段程式,我們分三頁慢慢看,先看開頭。",
    "item": 0
   },
   {
    "say": "第一行,從 gpiozero 匯入 Motor。",
    "item": 1
   },
   {
    "say": "接著建立左馬達,前進腳位是第五號,後退腳位是第六號,致能腳位是第十二號,並啟用 P W M。",
    "item": 2
   },
   {
    "say": "右馬達也一樣,前進腳位是第二十號,後退腳位是第二十一號,致能腳位是第十三號。",
    "item": 3
   }
  ],
  "PWM 與安全的馬達函式#5": [
   {
    "say": "第二頁,是兩個常數和驅動函式的開頭。",
    "item": 0
   },
   {
    "say": "速度上限設成百分之六十,安全起見,先設小一些。",
    "item": 1
   },
   {
    "say": "最低可動的 duty 設成百分之二十五,這個數字需要自己量測。",
    "item": 2
   },
   {
    "say": "然後開始定義驅動單一馬達的函式,它接收一個馬達和一個百分比。函式裡面會先夾限、處理零,再算 duty,最後決定方向。",
    "item": 3
   }
  ],
  "PWM 與安全的馬達函式#6": [
   {
    "say": "第三頁,是最後兩個函式。",
    "item": 0
   },
   {
    "say": "set motors,接收左右兩個值,分別交給驅動函式去處理。",
    "item": 1
   },
   {
    "say": "stop,則是把左右兩個馬達都停下來。",
    "item": 2
   }
  ],
  "PWM 與安全的馬達函式#7": [
   {
    "say": "這個函式,有三個設計重點。",
    "item": 0
   },
   {
    "say": "第一,夾限,英文叫 clamp。不管呼叫者給多大的值,都先限制在正負速度上限之內。這是第一層安全防護,即使後面的演算法有錯,車子也不會超速。",
    "item": 1
   },
   {
    "say": "第二,死區補償。很多馬達在 duty 低於某個值的時候,完全轉不動,這是靜摩擦,你叫它轉百分之十,它卻沒反應。量測最低可動的 duty 之後,把一到一百的輸出,重新映射到可動範圍。",
    "item": 2
   },
   {
    "say": "上面的 duty 公式就是這樣,輸入百分之一的時候,對應最低可動的 duty,輸入百分之一百的時候,對應百分之一百。實務上要再配合夾限。",
    "item": 2
   },
   {
    "say": "第三,結束一定要停。程式用 try finally,處理例外和 Ctrl C,再用 SIGTERM 的處理函式,處理被系統終止的情況。",
    "item": 3
   },
   {
    "say": "但請特別注意,如果程式被 kill 減九強制殺掉,這兩層都不會執行,只有硬體急停,能夠保護你。",
    "item": 3
   }
  ],
  "差速驅動的運動學#1": [
   {
    "say": "再來是差速驅動的運動學。為什麼要懂運動學?",
    "item": 0
   },
   {
    "say": "知道左右輪速度怎麼決定車子的前進速度和轉向速度,你才能把我想轉九十度,或是我想以半徑三十公分轉彎,換算成馬達的指令。之後的里程計、P I D 和路徑規劃,都會用到同樣的公式。",
    "item": 1
   }
  ],
  "差速驅動的運動學#2": [
   {
    "say": "這張差速驅動示意圖,畫了四種情況。",
    "item": 0
   },
   {
    "say": "左右輪等速的時候,車子直線前進。右輪比較快的時候,車子向左轉。兩輪等速但方向相反的時候,車子原地旋轉。只有右輪轉動的時候,車子以左輪為支點繞圈。",
    "item": 1
   }
  ],
  "差速驅動的運動學#3": [
   {
    "say": "我們整理出兩個核心公式。",
    "item": 0
   },
   {
    "say": "設左輪線速度是 vL,右輪線速度是 vR,單位是公尺每秒,兩輪的間距,也就是輪距,是 L。車體前進速度,等於 vR 加 vL,除以二。車體轉向角速度,等於 vR 減 vL,再除以 L,逆時針為正,單位是弧度每秒。",
    "item": 1
   },
   {
    "say": "轉彎半徑,從車體中心到旋轉中心,等於前進速度除以角速度。展開來就是,L 除以二,乘上 vR 加 vL,再除以 vR 減 vL。",
    "item": 2
   }
  ],
  "差速驅動的運動學#4": [
   {
    "say": "再把這幾個公式列出來,方便你抄。",
    "item": 0
   },
   {
    "say": "車體前進速度,等於 vR 加 vL 的一半。",
    "item": 1
   },
   {
    "say": "車體轉向角速度,等於 vR 減 vL,除以輪距,逆時針為正,單位是弧度每秒。",
    "item": 2
   },
   {
    "say": "轉彎半徑 R,等於 v 除以 ω,也等於輪距的一半,乘上速度和,再除以速度差。",
    "item": 3
   }
  ],
  "差速驅動的運動學#11": [
   {
    "say": "最後,我們把轉向角換成程式。",
    "item": 0
   },
   {
    "say": "這是開迴路的控制。畫面上這個函式,接收要轉的角度和速度。程式裡先設一個原地旋轉的角速度,例如每秒一百二十度,這個值要先實測速度四十的時候的數值。接著用角度除以角速度,算出需要轉多久。",
    "item": 2
   },
   {
    "say": "然後依角度的正負決定方向,讓左右輪反向轉動,睡眠那麼久,最後停止。",
    "item": 3
   },
   {
    "say": "開迴路的意思,是程式只下指令,沒有感測器回授來確認結果,所以誤差會累積。如果有 I M U,第四章會學到,就可以改成轉到 I M U 顯示到達目標角度才停,精度會好很多。",
    "item": 3
   }
  ],
  "差速驅動的運動學#12": [
   {
    "say": "最後,整理速度與轉彎常見的問題,也當作這一章的小結。",
    "item": 0
   },
   {
    "say": "第一,左右輪的物理差異。同一個 duty 下,兩輪轉速不同,車子應該直走,卻偏向一邊。補償的方式,是乘以校正係數,或用第六章的 P I D。",
    "item": 1
   },
   {
    "say": "第二,電池電壓下降。電量低的時候,同樣的 duty,轉速變慢,量到的校正值就會失準。",
    "item": 2
   },
   {
    "say": "第三,地面打滑。原地旋轉特別容易在光滑的地面打滑,轉角會比計算值小。",
    "item": 3
   },
   {
    "say": "第四,萬向輪卡住。轉向的時候被拖住,導致轉向不順。",
    "item": 4
   },
   {
    "say": "差速驅動的公式很短,前進速度是 vR 加 vL 除以二,角速度是 vR 減 vL 除以輪距。記住這兩個,就夠用了。",
    "item": 5
   }
  ],
  "closing": [
   {
    "say": "這一章先到這裡。我們學了 P W M 和差速的原理、G P I O 與 gpiozero,還有一個有夾限、有死區補償的安全馬達函式。",
    "item": 0
   },
   {
    "say": "接下來,請完成實作,再做章末小測驗,看看自己學會了多少。我們下一章見!",
    "item": 1,
    "pause": 1
   }
  ]
 }
}