Linux

準備

1. Linux鏡像支持SD卡或EMMC啟動，并且會優先從SD卡啟動。

2. 建議使用A1級卡，至少8GB。

3. 如果您想從 SD 卡啟動，請確保可啟動 EMMC 已格式化。

4. 如果您想從 EMMC 啟動并使用 Sdcard 作為存儲，請確保 SD 卡已格式化且未刷新 Linux 映像。

5. 下載最新的[Linux Linux Image]，并確認md5校驗和正確。

6.默認登錄：pi/bananapi 或 root/bananapi

7. wiki 指南僅適用于 [bananapi 4.9 bsp ubuntu/debian 鏡像]。

將映像安裝到 SD 卡

1. 在 Windows、Linux 和 MacOS 上使用 Balena Etcher 安裝映像。

Balena Etcher是 Balena 的一款開源 GUI 閃存工具，可將操作系統映像閃存到 SD 卡或 USB 驅動器。

2. 在 Windows、Linux 和 MacOS 上使用 Balena Cli 安裝映像。

Balena CLI是 balenaCloud 或 openBalena 的命令行界面。它可用于刷新 linux 映像。從balena-io下載安裝程序或獨立包并將其正確安裝到您的 PC，然后您可以使用balena 的“ local flash ”命令選項將 Linux 映像刷新到 sdcard 或 USB 驅動器。

sudo balena 本地閃存路徑/to/xxx-bpi-m4-zero-xxx.img.zip sudo balena 本地閃存路徑/to/xxx-bpi-m4-zero-xxx.img.zip --drive /dev/disk2 sudo balena 本地閃存路徑/to/xxx-bpi-m4-zero-xxx.img.zip --drive /dev/disk2 --yes

3. 在 Linux 上使用 dd 命令安裝 Image，如果自動掛載則卸載 SD 卡設備 /dev/sdX 分區。實際上 bpi-copy 和這個 dd 命令是一樣的。

sudo apt-get install pv 解壓縮 sudo unzip -p xxx-bpi-m4-zero-xxx.img.zip | sudo unzip -p xxx-bpi-m4-zero-xxx.img.zip | 光伏 | dd of=/dev/sdX bs=10M 狀態=noxfer

4. 在Linux上使用bpi-tools安裝鏡像，將SD卡插入Linux PC并運行

sudo apt-get install pv 解壓縮 sudo bpi-copy xxx-bpi-m4-zero-xxx.img.zip /dev/sdX

Ubuntu 桌面[編輯]

1.使用Ubuntu桌面版系統鏡像，可以獲得圖形操作界面。

2、需要準備一臺帶HDMI接口的顯示器、一根HDMI線、一個mini HDMI轉HDMI轉接頭。

3、使用HDMI線和mini HDMI轉HDMI轉接頭連接顯示器和BPI-M4 Zero，將顯示器輸入接口切換到對應的HDMI接口，開機，稍等片刻即可看到桌面。

調試串口

1.準備一個3.3v USB轉TTL模塊。

2. 使用 USB 轉 TTL 模塊連接 PC USB 端口和板上的 Debug UART 端口。

3. 在PC上打開串口終端軟件，例如mobaxterm或putty。

4.以mobaxterm為例，設置好串口號和115200波特率后，即可打開BPI-M4 Zero UART終端。

SSH

1、準備好網線和路由器。

2. 使用網線將路由器的LAN口連接到BPI-M4 Zero，同時將PC連接到另一個LAN口。

3. 在路由器管理界面查看BPI-M4 Zero的IP地址，或者在BPI-M4 Zero的UART終端上使用以下命令查看IP地址。

如果配置

eth0: 標志=4163 mtu 1500 inet 192.168.3.10 網絡掩碼 255.255.255.0 廣播 192.168.3.255 inet6 fe80::3e1f:688f:81ab:d8b7 prefixlen 64scopeid 0x20<鏈接> 以太 02:00:54:a0:d6:a6 txqueuelen 1000（以太網） RX 數據包 553 字節 92549 (92.5 KB) RX 錯誤 0 丟棄 0 溢出 0 幀 0 TX 數據包 329 字節 26023 (26.0 KB) TX 錯誤 0 丟棄 0 溢出 0 載波 0 沖突 0 設備中斷 42

4. 在PC上打開SSH終端軟件，例如mobaxterm或putty。

5、以mobaxterm為例，在IP地址欄填寫獲取到的IP地址，如上面的192.168.3.10，在Port端口填寫22。

6、打開SSH終端，輸入登錄用戶名/密碼：pi/bananapi或root/bananapi。輸入密碼時不會有提示。請正常輸入，完成后按回車鍵。

NoMachine遠程桌面

1. 確保BPI-M4 Zero已連接互聯網，并使用以下命令下載系統中的nomachine DEB安裝包。

wget https://download.nomachine.com/download/8.9/Arm/nomachine_8.9.1_1_arm64.deb

2.或者在PC瀏覽器中打開NoMachine for ARM - arm64下載頁面，下載DEB安裝包，然后通過SSH或U盤復制到BPI-M4零用戶目錄。

3、下載完成后，通過以下命令進行安裝。請注意，文件名以實際下載的文件名為準。

sudo dpkg -i nomachine_8.9.1_1_arm64.deb

4、PC端還需要下載并安裝NoMachine。NoMachine下載頁面選擇適合PC操作系統的安裝包，下載到本地并完成安裝。

5、注意保持PC和BPI-M4 Zero在同一個局域網內。您可以先嘗試SSH連接，確保局域網內正常通信。

6、在PC上打開NoMachine，點擊添加按鈕，在跳轉后的窗口中的主機欄中輸入BPI-M4 Zero的IP地址，然后點擊添加按鈕。

7. 單擊已識別的端口圖標，在彈出的新窗口中輸入用戶名/密碼，然后單擊確定按鈕。

8.完成后續設置后，就可以看到桌面了。

9. 如果 HDMI 接口沒有連接任何設備，NoMachine 遠程桌面將顯示黑屏。建議保留 HDMI 連接或連接 HDMI 誘餌設備。

無線上網

使用nmcli命令掃描WiFi熱點、連接熱點、創建AP熱點。

nmcli device #列出設備 nmcli device wifi list # 列出可用的wifi接入點，列表可以省略 nmcli device wifi connect [SSID] 密碼 [PASSWORD] # 連接熱點 mySSID。連接成功后，會自動生成配置文件。如果以后想再次連接，可以使用 nmcli connection up [SSID] 命令。 nmcli device disconnect [設備名稱] # 斷開wifi，使用nmcli device命令中顯示的wifi設備名稱 nmcli device wifi hotspot con-name [NAME] ifname [設備名稱] ssid [SSID] 密碼 [PASSWORD] # 創建AP熱點

nmcli connection show #列出網絡連接配置 nmcli connection down [NAME] # 停用連接 nmcli connection up [NAME] # 激活連接 nmcli connection delete [SSID] #刪除一個配置，不再保存信息并自動連接

nmcli radio wifi off # 關閉wifi nmcli radio wifi on # 打開 wifi

• nmcli命令參考文檔
• nmcli 命令參考示例

設置靜態IP、DNS

1. 要設置靜態IP，需要先保持連接。如果要設置以太網靜態IP，首先必須保持以太網連接；如果要設置無線網絡靜態IP，首先必須保持WIFI連接。

2、如果上級路由器已將您要設置的IP地址分配給其他設備，請將其更改為空閑IP，或者要求其他設備放棄該IP。

3. 使用 nmcli connection show 命令顯示所有連接，例如：

pi@bpi-m4zero:~$ nmcli 連接顯示 名稱 UUID 類型 設備 TP-LINK_5G_7747 e4a49726-adf1-44d7-a621-0e3af96cc390 無線網絡wlx2cc3e6acd5d7 有線連接 1 612eda94-55dc-3c85-b05e-f16c41775b4e 以太網 --

4. 使用 nmcli connection show [NAME] 命令顯示特定連接的所有屬性，例如：

nmcli connection show TP-LINK_5G_7747 #如果想看以太網，改成有線連接1

#只列出三個常見的項目 ipv4.dns: 192.168.3.1 #默認為網關地址 ipv4.addresses: 192.168.3.10/24 #默認為路由器DHCP分配的IP地址 ipv4.gateway: 192.168.3.1 #網關地址，默認為路由器的IP地址

5.設置靜態IP：

nmcli連接修改TP-LINK_5G_7747 ipv4.addresses 192.168.3.2

6.設置DNS：

nmcli 連接修改 TP-LINK_5G_7747 ipv4.dns 8.8.8.8 #Google DNS

7.重置：

重啟

8.重啟后查看是否修改成功：

如果配置 nmcli連接顯示TP-LINK_5G_7747

網絡時間同步

Chrony 是一款開源免費網絡時間協議 NTP 客戶端和服務器軟件。它允許計算機保持系統時鐘與時鐘服務器（NTP）同步，從而使您的計算機保持準確的時間。Chrony還可以作為服務器軟件，為其他計算機提供時間同步服務。

timedatectl set-ntp false #禁用基于NTP的網絡時間同步

sudo apt install chrony #安裝chrony systemctl start chrony #啟動chrony systemctl 啟用計時 systemctl 狀態計時 systemctl restart chrony #重啟服務

timedatectl status #查看時間同步狀態 timedatectl list-timezones #查看時區列表 timedatectl set-timezone Asia/上海 #修改時區 timedatectl set-ntp true #啟用NTP網絡時間同步

日期 #查看時間 sudo hwclock -r #查看硬件時鐘

• 慢性參考文檔

查看硬件溫度

輸入以下命令可查看BPI-M4 Zero板上芯片內置傳感器返回的溫度數據。

傳感器

修改HDMI輸出分辨率

使用Ubuntu桌面操作系統時，可以在設置中找到顯示欄，修改分辨率。

使用U盤

1. 準備一個已經正常分區的U盤，插入BPI-M4 Zero的USB接口。如果是A型插頭的U盤，還需要一個A型轉C型轉接頭。

2、在Ubuntu桌面版中，可以看到U盤已經被識別，可以在文件管理器中打開，或者可以通過GParted工具進行分區管理。

3. 在終端中，將U盤掛載到本地目錄：

mkdir mnt #在~/user目錄下創建一個單獨的目錄用于掛載，方便管理 貓 /proc/分區 | grep "sd*" #列出以sd開頭的分區 sudo mount /dev/sda1 ~/mnt/ #掛載 /dev/sda1 到 ~/mnt/ ls ~/mnt/ #掛載后可以列出U盤中的文件 sudo umount -v /dev/sda1 #umount，即可移除U盤

使用音頻設備

準備一個音頻文件，通過U盤或SSH復制到BPI-M4 Zero Ubuntu桌面系統。

HDMI音頻[

1.準備一臺具有HDMI音頻輸入功能的顯示器，在顯示器設置中打開相關功能，使用HDMI線和mini HDMI轉HDMI適配器連接顯示器。

2. 在設置的聲音欄中將輸出設備設置為 HDMI 音頻。

3.播放音頻。

使用藍牙

1. 打開Ubuntu桌面的設置，在藍牙欄中連接藍牙設備，例如藍牙鼠標或鍵盤。

2、在終端中通過命令行連接藍牙設備的方法如下：

pi@bpi-m4zero:~$ sudo bluetoothctl #打開藍牙設備管理工具 [sudo] pi 的密碼： 代理注冊 [CHG] 控制器 2C:C3:E6:AC:D5:D8 可配對：是 [bluetooth]# power on #啟動藍牙功能，power off將其關閉 更改電源成功 [bluetooth]# discoveryable on #允許發現此設備 更改可發現成功 [CHG] 控制器 2C:C3:E6:AC:D5:D8 可發現：是 [藍牙]# 可配對 #允許設備配對 更改配對成功 [藍牙]# scan on #開始掃描 發現開始 [CHG] 控制器 2C:C3:E6:AC:D5:D8 發現：是 [NEW] Device D4:C4:85:A5:C6:B1 Logitech Pebble #藍牙鼠標的MAC地址和設備名稱 [CHG] 設備 D4:C4:85:A5:C6:B1 TxPower: 4 [bluetooth]#pair D4:C4:85:A5:C6:B1 #配對要連接的藍牙設備的MAC地址 嘗試與 D4:C4:85:A5:C6:B1 配對 [CHG] 設備 D4:C4:85:A5:C6:B1 已連接：是 [刪除] 設備 A4:C1:38:9B:F6:FD SLPO20N20200059 [CHG] 設備 D4:C4:85:A5:C6:B1 UUID：00001800-0000-1000-8000-00805f9b34fb [CHG] 設備 D4:C4:85:A5:C6:B1 UUID：00001801-0000-1000-8000-00805f9b34fb [CHG] 設備 D4:C4:85:A5:C6:B1 UUID：0000180a-0000-1000-8000-00805f9b34fb [CHG] 設備 D4:C4:85:A5:C6:B1 UUID: 0000180f-0000-1000-8000-00805f9b34fb [CHG] 設備 D4:C4:85:A5:C6:B1 UUID: 00001812-0000-1000-8000-00805f9b34fb [CHG] 設備 D4:C4:85:A5:C6:B1 UUID：00010000-0000-1000-8000-011f2000046d [CHG] 設備 D4:C4:85:A5:C6:B1 服務已解決：是 [CHG] 設備 D4:C4:85:A5:C6:B1 配對：是 配對成功#配對成功 [CHG] 設備 D4:C4:85:A5:C6:B1 模式別名：usb:v046DpB021d0007 [bluetooth]# exit #退出藍牙設備管理工具 pi@bpi-m4zero:~$

archlinux藍牙參考文檔

傳輸文件

SCP

Linux系統中的scp（安全復制）命令用于以安全的方式在服務器之間復制文件。

SCP 命令或安全復制允許在本地主機和遠程主機之間或兩個遠程主機之間安全地傳輸文件。

它使用與 Secure Shell (SSH) 協議中使用的相同的身份驗證和安全性。

您可以將文件從 Windows 終端復制到同一 LAN 上的 Linux 系統。只需確保 Open SSH 客戶端已打開并且可以在“設置”>“應用程序”>“可選功能”中查看。

如果要將文件從Windows系統復制到Linux系統，還需要啟用Open SSH服務器。

scp命令格式為：

scp [可選] 文件源 文件目標

1.[options]為可選參數，如-r，可用于遞歸復制整個目錄。

2.file_source 要復制的文件或目錄。

3.file_target如果最后輸入了特定的文件名，則會復制過去的路徑并重命名。

以將本地文件從Windows系統復制到Linux系統為例。在 Windows 終端中，輸入：

PS D:\temp\temp_4> scp ".\hello.txt" pi@192.168.3.12 :"/home/pi/Downloads/"

您還可以在Windows終端中將Linux系統中的文件復制到本地計算機：

PS D:\temp\temp_4> scp pi@192.168.3.12 :"/home/pi/Downloads/hello.txt" "D:\temp\temp_4"

其中pi@192.168.3.12為Linux系統中的用戶名，BPI-M4 Zero在局域網中的IP地址。

其中：“/home/pi/Downloads/hello.txt”是Linux系統中的文件路徑。

其中“D:\temp\temp_4”是Windows系統中的路徑。

scp參考文檔

mobaxterm

可以使用 mobaxterm 或其他類似軟件通過圖形界面管理文件。

mobaxterm 下載

mobaxterm-linux 預覽版

如下圖，在mobaxterm中建立SSH連接后，界面左側會出現文件管理窗口，支持通過拖放文件的方式進行復制粘貼。