一、主板接口

二、主板功能

三、接口詳細(xì)說明

四、鏡像文件燒寫

1、安裝驅(qū)動并連接硬件

解壓開發(fā)工具目錄下的 DriverAssitant_USB 驅(qū)動程序.7z，右擊以管理員權(quán)限運(yùn)行 DriverInstall.exe，安

裝驅(qū)動程序。

注意 win10 或 win11 系統(tǒng)需要關(guān)閉操作系統(tǒng)的驅(qū)動簽名驗(yàn)證功能才能正常安裝驅(qū)動，win11 不能永久

關(guān)閉這個(gè)功能，建議安裝一個(gè) win7 的虛擬機(jī)，在虛擬機(jī)內(nèi)進(jìn)行驅(qū)動安裝和固件燒寫。

將主板與 PC 機(jī)用 TYPE-C 線（注意有些數(shù)據(jù)線僅支持充電，無法傳輸數(shù)據(jù)）連接好，如果出現(xiàn)無法識

別的情況可以通過重新連接、更換 PC 機(jī) USB 接口、更換 USB 線、更換 PC 機(jī)等方式重試。

解壓開發(fā)工具目錄下的 RKDevTool.7z，右擊以管理員權(quán)限運(yùn)行 RKDevTool.exe

2、進(jìn)入燒寫模式

主板處于 Loader 或 Maskrom 模式時(shí)可以對系統(tǒng)進(jìn)行格式化和燒寫系統(tǒng)鏡像文件操作。

進(jìn)入 Loader 模式

方式一、將主板斷電，首先用 TYPE-C 線將主板與 PC 機(jī)連接好，按下主板上的燒寫鍵，

并保持按下狀態(tài)，然后再上電開機(jī)，主板會進(jìn)入 Loader 操作模式，然后松開按鍵燒寫系統(tǒng)

即可，注意這種方式適用于主板上的 BootLoader 可正常工作的情況。

方式二、將主板接通電源，進(jìn)入系統(tǒng)，用 TYPE-C 線將主板與 PC 機(jī)連接好如下圖，RKDevTool 軟件會

識別到一個(gè) ADB 設(shè)備，單擊切換按鈕，主板會重啟進(jìn)入 Loader 模式

3、進(jìn)入 Maskrom 模式（無法進(jìn)入 Loader 模式時(shí)使用）

與 PC 機(jī)連接好，按下主板上的 ROM 鍵，并保持按下狀態(tài)，然后再上電開機(jī)，主板會進(jìn)入MaskRom 操作模式，然后松開按鍵燒寫系統(tǒng)即可。

4、系統(tǒng)燒寫流程

首先將主板進(jìn)入 Loader 或 Maskrom 模式，打開 RKDevTool 軟件，點(diǎn)擊固件按鈕選擇需要燒寫的鏡像文件，

然后點(diǎn)擊升級按鈕，右側(cè)窗口會顯示燒寫進(jìn)度，燒寫完成后，主板會自動重啟開機(jī)。

五、安卓應(yīng)用開發(fā)

1、GPIO 編程參考

通過 sysfs 方式控制 GPIO，GPIO 的操作接口包括 direction 和 value 等，direction 控制 GPIO 輸

入和輸入模式，而 value 可控制 GPIO 輸出或獲得 GPIO 輸入。

例如控制調(diào)試燈 GPIO 操作如下（串口終端命令行方式）：

調(diào)試燈 GPIO 設(shè)置為輸出echo out > /sys/class/gpio/gpio104/direction

調(diào)試燈 GPIO 輸出高電平echo 1 > /sys/class/gpio/gpio104/value

調(diào)試燈 GPIO 輸出高低平echo 0 > /sys/class/gpio/gpio104/value

調(diào)試燈 GPIO 設(shè)置為輸入echo in > /sys/class/gpio/gpio104/direction

讀取調(diào)試燈 GPIO 輸出輸入電平 cat /sys/class/gpio/gpio104/value

當(dāng) GPIO 處于輸出和輸入模式時(shí)都可以讀取，當(dāng)設(shè)置為輸入模式時(shí)讀取的是 GPIO 實(shí)際電平，當(dāng)設(shè)置為輸出

模式時(shí)讀取的是設(shè)置的值（如果設(shè)置為高電平輸出，外部將引腳電平拉低后，讀取的值依然是 1）。

應(yīng)用程序控制請參考源碼下的 demo 程序源碼

2、串口 UART 編程參考

RS232 串口、RS485、TTL 串口接口對應(yīng)的設(shè)備名詳見上文接口描述。

安卓系統(tǒng)串口編程請參考 demo 程序源碼或以下鏈接：

https://github.com/Acccord/AndroidSerialPort

https://github.com/Geek8ug/Android-SerialPort

https://github.com/yutils/YSerialPort

3、WatchDog 看門狗編程參考

進(jìn)入內(nèi)核后默認(rèn)會啟動看門狗，內(nèi)核崩潰等情況出現(xiàn)，會在 15 秒內(nèi)自動復(fù)位主板。

上層應(yīng)用程序打開看門狗后，內(nèi)核將看門狗控制權(quán)交由上層應(yīng)用程序控制，上層應(yīng)用程序的喂狗間隔建議

不大于 3 秒。

看門狗的使用流程為

打開看門狗?循環(huán)喂狗?停止喂狗?關(guān)閉看門狗

喂狗之前必須先打開看門狗，關(guān)閉看門狗之前需停止喂狗操作。

打開看門狗后如果 15 秒內(nèi)沒有喂狗或關(guān)閉看門狗，系統(tǒng)會自動復(fù)位。

命令行測試：

打開看門狗：echo 1 >/sys/class/gzpeite/user/watch_dog

喂狗：echo 2 >/sys/class/gzpeite/user/watch_dog

關(guān)閉看門狗：echo 0 >/sys/class/gzpeite/user/watch_dog

應(yīng)用程序控制請參考源碼下的 demo 程序源碼

4、獲取 root 權(quán)限

系統(tǒng)默認(rèn)已開啟 root 權(quán)限，上層應(yīng)用 app 可直接獲取 root 權(quán)限并進(jìn)行相關(guān)操作，可以參考源碼目錄下的 demo 程序

5、系統(tǒng)簽名

系統(tǒng)簽名文件位于源代碼目錄下，使用對應(yīng)的文件對 APK 進(jìn)行簽名即可。

6、動態(tài)隱藏/顯示系統(tǒng)狀態(tài)欄和導(dǎo)航欄

隱藏狀態(tài)欄和導(dǎo)航欄在應(yīng)用 app 里面向系統(tǒng)發(fā)送廣播

gzpeite.intent.systemui.hidenavigation 和 gzpeite.intent.systemui.hidestatusbar

顯示狀態(tài)欄和導(dǎo)航欄在應(yīng)用 app 里面向系統(tǒng)發(fā)送廣播

gzpeite.intent.systemui.shownavigation 和 gzpeite.intent.systemui.showstatusbar

測試命令如下：

請參考源碼下的 demo 程序源碼

7、靜默安裝/卸載應(yīng)用

安裝 APK 時(shí)，向系統(tǒng)發(fā)送 gzpeite.intent.action.install_apk 廣播

卸載 APK 時(shí)，向系統(tǒng)發(fā)送 gzpeite.intent.action.uninstall_apk 廣播

測試命令如下：

8、重啟、關(guān)機(jī)操作

重啟：向系統(tǒng)發(fā)送 gzpeite.intent.action.reboot 廣播

關(guān)機(jī)向系統(tǒng)發(fā)送 gzpeite.intent.action.shutdown 廣播

測試命令如下：

應(yīng)用程序控制請參考源碼下的 demo 程序源碼

9、獲取 MAC 地址

原生 Android12 系統(tǒng)默認(rèn)禁止應(yīng)用獲取 MAC 地址，為了兼容更早期的應(yīng)用程序，我司已對系統(tǒng)代碼進(jìn)

行優(yōu)化允許應(yīng)用 app 獲取 WIFI 及以太網(wǎng)的 MAC 地址，詳見源代碼目錄下的 demo 程序源碼。

10、定時(shí)開關(guān)機(jī)

可以在系統(tǒng)設(shè)置-->系統(tǒng)-->日期和時(shí)間內(nèi)設(shè)置，設(shè)置保存后，重啟依然有效

目前僅支持每天固定時(shí)間關(guān)機(jī)和開機(jī)，如果需要某些天不開機(jī)，可在應(yīng)用程序內(nèi)判斷后發(fā)送關(guān)機(jī)廣播

11、開機(jī)自啟動 Launcher(不顯示系統(tǒng)桌面)

首先在開發(fā)應(yīng)用 APK 時(shí)，需要在應(yīng)用程序 AndroidManifest.xml 的 Intent-filter 里添加下面幾行

可以參考資料目錄下的 OnlyLauncher.7z

六、動態(tài)修改開機(jī) logo 和動畫

將 logo.bmp、logo_kernel.bmp、bootanimation.zip，復(fù)制到系統(tǒng) /mnt/logo 目錄下即可

兩個(gè) logo 文件必須為 bmp 文件格式，一個(gè)是在 uboot 階段加載顯示，一個(gè)是在內(nèi)核階段加載顯示，

文件名不可修改，文件內(nèi)容可以完全一樣。

開機(jī)動畫 bootanimation.zip 僅支持安卓系統(tǒng)，制作方式可以通過搜索引擎查詢相關(guān)教程。