開發者環境：Windows / macOS

orange-pi-sensor-isp-zh-tw 是 Linux 平台——本頁說明從 Windows / macOS 主機操作它的完整做法、差異與陷阱

← 回首頁
為什麼需要這頁：Orange Pi 依板卡跑不同的 Linux 映像（Armbian / Orange Pi OS / 官方 BSP）。你的開發機是 Windows 或 macOS——先確認映像的預設帳號（root / orangepi）再連線。

0. 兩種開發者路徑總覽

任務WindowsmacOS共通注意
SSH 連線內建 OpenSSH / PuTTY / WSL2（推薦）內建 ssh先 ping 同網段
映像燒錄（SD/eMMC）Raspberry Pi Imager / balenaEtcherRaspberry Pi Imager / balenaEtcher / dd選對磁碟！
檔案傳輸WinSCP / scp / sftpscp / sftp / rsync路徑用 /
序列埠PuTTY / Tera Termscreen / minicom確認 COM / tty 名稱
編輯器VS Code / Notepad++VS Code / 內建用 UTF-8、LF
（Linux 主機）——本身就是類 Linux，最省事

1. Windows 開發者：怎麼做

1.1 SSH 連線（三種方式）

方式 A：Windows 10/11 內建 OpenSSH（PowerShell）
ssh orangepi@
方式 B：WSL2（推薦，最接近 Linux 開發環境）
# 在 WSL2 終端內，與 Linux 行為一致
ssh orangepi@
scp 檔名 orangepi@:/home/...

方式 C（舊習慣）：PuTTY——Host 填 IP、Port 22、連線類型 SSH。

Windows 注意：① 若 ssh 無法辨識，安裝「OpenSSH 用戶端」（設定→選用功能）② 連不上先 ping 確認同網段、關閉對 ssh 的防火牆干擾。

1.2 映像燒錄（SD 卡 / eMMC）

Raspberry Pi Imager（Win）
1. 下載安裝 Raspberry Pi Imager
2. 選裝置 → 選映像（可先設定 ssh/wifi/帳號）
3. 選 SD 卡 → 寫入
Windows 陷阱：Windows 常把 SD 卡視為「可移動磁碟」，寫入前會跳出權限確認——不要誤選硬碟。燒完 Windows 可能顯示「要格式化」——忽略，那是 Linux 分割。

1.3 檔案傳輸

WinSCP（GUI）
主機:   使用者: orangepi  密碼/金鑰
拖曳即可上傳/下載；可保留或轉換換行符（LF/CRLF）
PowerShell scp
scp .\tuning.json orangepi@:/home/orangepi/

1.4 序列埠（Console）

PuTTY 序列
連線類型: Serial
Serial line: COM3（裝置管理員確認）
Speed: 115200

1.5 Windows 必踩雷清單

2. macOS 開發者：怎麼做

2.1 SSH 連線（內建）

Terminal
ssh orangepi@
# 可用 Bonjour 主機名：<板卡 hostname>.local
序列埠 console
ls /dev/cu.usbserial-*        # 找 USB 轉序列裝置
screen /dev/cu.usbserial-XXXX 115200
# 離開：Ctrl-A 然後 K（再 Y）

2.2 映像燒錄

Raspberry Pi Imager / balenaEtcher（推薦）
下載映像 → 選磁碟 → 寫入
或 dd（進階）
diskutil list                          # 找 SD 卡磁碟識別碼
diskutil unmountDisk /dev/diskN
sudo dd if=映像.img of=/dev/rdiskN bs=4m status=progress
diskutil eject /dev/diskN
macOS 陷阱（最重要）：dd 用 /dev/rdiskN（raw），比 disk 快很多；但選錯磁碟 = 資料全毀。務必先 diskutil list 再三確認。

2.3 檔案傳輸

scp / rsync
scp tuning.json orangepi@:/home/orangepi/
rsync -avz ./資料夾/ orangepi@:/home/orangepi/資料夾/

2.4 macOS 必踩雷清單

2.5 Linux（Ubuntu）開發者：怎麼做

開發機本身是 Linux（Ubuntu）時，與 Orange Pi 都是 Linux，工具幾乎零落差——這是三種主機裡最省事的。

2.5.1 SSH 連線（內建）

Terminal
ssh orangepi@
# 生成金鑰（首次）
ssh-keygen -t ed25519
ssh-copy-id orangepi@

2.5.2 映像燒錄

Raspberry Pi Imager（Linux）或 dd
lsblk                                # 找 SD 卡（通常 /dev/sdX）
sudo dd if=映像.img of=/dev/sdX bs=4M status=progress
sync; eject /dev/sdX
Linux 陷阱：dd 前務必 lsblk 確認目標磁碟（/dev/sdX），誤選 = 覆寫整個磁碟。Ubuntu 桌面版也會自動掛載 → 先 sudo umount /dev/sdX*。

2.5.3 檔案傳輸

scp / rsync
scp tuning.json orangepi@:/home/orangepi/
rsync -avz ./dir/ orangepi@:/home/orangepi/dir/

2.5.4 Linux（Ubuntu）必踩雷清單

給 Linux 開發者的額外提醒：雖然同為 Linux，但Orange Pi是 ARM 架構——需要編譯的程式要「交叉編譯」或直接在板上編，別指望 x86 的 binary 能跑。

3. Windows vs macOS vs Linux 差異一覽（重點）

面向WindowsmacOSLinux (Ubuntu)誰更省事
SSH 內建Win10+ 內建（要開選用功能）原生內建原生內建Linux / macOS
最接近 Linux 的環境WSL2（需安裝）Terminal 即類 Unix就是 LinuxLinux
序列埠需 PuTTY + 驅動內建 screen內建 screen / minicomLinux / macOS
燒錄風險誤選磁碟機dd 誤選 = 全毀dd 誤選 = 全毀都用 Imager 最安全
換行陷阱高（CRLF）低（LF）低（LF）Linux / macOS
中文編碼易遇 ANSI/Big5UTF-8UTF-8Linux / macOS
交叉編譯需 WSL 或工具鏈需工具鏈apt 直接裝交叉工具鏈Linux
最省心路徑總整理：Linux 主機：直接 Terminal + scp/rsync。macOS：內建 ssh + scp + VS Code Remote-SSH。Windows：裝 WSL2 + VS Code Remote-SSH——之後行為與 Linux 一致，繞開 CRLF 與路徑問題。

4. 與本課操作流程的銜接

建立好連線與傳檔後，後續課程的每個單元都能照做：

看完這頁你應該能說出：
  • Windows 三種 SSH 方式與最推薦的 WSL2 路徑。
  • macOS 的 ssh / screen / scp / rsync 用法。
  • CRLF、BOM、路徑分隔、金鑰權限、磁碟誤選等關鍵陷阱。
  • 兩種系統的差異與「誰更省事」。

延伸閱讀