本文的OrangePi 5 Max開發板由Orange Pi的Nova和Steve贊助提供,特此感謝!
本文將說明如何使用個人電腦上的VS Code編輯器,以SSH連線到遠端的「香橙派」開發板,並且編寫和測試Python程式。
新增Linux使用者帳號
開發板的作業系統安裝完畢之後,首要工作是修改帳號密碼。香橙派官網提供的Linux系統,預設使用者帳號與密碼都是“orangepi”。在終端機輸入“passwd”命令,即可設定新密碼。
若要新增使用者帳號,並賦予該使用者管理員的權限,請在終端機輸入“sudo adduser 新帳號名稱”命令。例如,底下命令將新增名叫“cubie”的使用者:
sudo adduser cubie
然後執行“sudo usermod -aG sudo 新帳號名稱”命令,賦予他管理員權限,例如:
sudo usermod -aG sudo cubie
若希望每次開機時,都自動以新增的帳號登入,請選擇「Settings(設定)→Login Window(登入視窗)」選單:
在Login Window(登入視窗)的Users(使用者)畫面,最底下的Username欄位,輸入你新增的帳號名稱,然後重新開機。
若要刪除預設的`orangepi`帳號,請在終端機輸入底下命令:
sudo deluser --remove-home orangepi
但一些系統功能的設定腳本,例如,設置VNC伺服器的set_vnc.sh(位於/usr/local/bins路徑,如下圖),它們的預設使用者帳號都是orangepi,因此不建議刪除‘orangepi’帳號。
測試香橙派的SSH連線
香橙派的Linux系統的預設語言是英文,你可以改成中文語系(參閱線上說明書,繁體中文的語系編碼是zh-TW)。英語系統可正常顯示中文,以開發程式為例,從電腦連線到香橙派,程式編輯器在電腦執行,所以你可以正常編寫中英文內容,而實際的程式碼(如:Python)在香橙派上執行,並沒問題。
香橙派的Ubuntu系統預設有啟動SSH服務,允許其他電腦透過文字命令連線、操控它。
連線之前,先在香橙派的終端機輸入ifconfig命令,查看它的IP位址。然後即可在電腦終端機(如:Windows的命令提示字元),執行“ssh 帳號@IP位址”命令連線到香橙派。
從VS Code SSH連線編輯香橙派的Python程式
在VS Code裡面安裝SSH模組,即可直接從VS Code透過SSH連線到遠端裝置。在VS Code的「延伸模組」搜尋、安裝“Remote – SSH”。
安裝完畢後,VS Code工作列左下角會出現一個遠端視窗連線的圖示。點擊它,VS Code會新開一個視窗,準備連線到遠端主機。
然後點擊「新增SSH主機」選項:
點擊「連線到主機」選項:
輸入”帳號@IP位址”格式的連線網址:
選擇儲存SSH連線設定的檔案,例如:”C:\Users\使用者名稱\.ssh\config”。
儲存之後,右下角會出現「已新增主機!」的訊息。點擊「連線」:
選擇SSH主機的IP位址:
輸入密碼:
首次連線遠端主機時,它會安裝相關程式,所以會花一點時間。連線成功後,工作列左下角會顯示SSH和IP位址。在此視窗開啟資料夾,它顯示的將是遠端電腦的資料夾內容。
安裝遠端主機的Python延伸模組
即使之前已在VS Code安裝了Python延伸模組,仍需要替SSH遠端電腦(也就是香橙派)安裝Python延伸模組,才能在編輯存在遠端電腦裡的Python程式時提供協助。
在「延伸模組」搜尋“Python”或“ext:py”,”ext”代表extension(副檔名),然後點擊「安裝至SSH: IP位址」鈕。
筆者事先在香橙派設置了一個名叫“yolo”的Python虛擬環境,開啟yolo資料夾裡的Python程式檔時,VS Code工作列右下角會出現「選取解譯器」訊息,點擊它,VS Code將會推薦安裝在香橙派上的虛擬環境,如下圖裡的步驟2。
選擇虛擬環境之後,工作列右下角將顯示虛擬環境的Python版本和名稱’env’;若開啟終端機視窗,命令行前面也會顯示目前處於‘env’虛擬環境:
如此就能透過SSH連線,在個人電腦編寫、測試、佈署香橙派的Python程式。
