一、主板接口

二、主板功能

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

四、鏡像文件燒寫(xiě)

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

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

注意 win10 或 win11 系統(tǒng)需要關(guān)閉操作系統(tǒng)的驅(qū)動(dòng)簽名驗(yàn)證功能才能正常安裝驅(qū)動(dòng)，win11 不能永久關(guān)閉這個(gè)功能，建議安裝一個(gè) win7 的虛擬機(jī)，在虛擬機(jī)內(nèi)進(jìn)行驅(qū)動(dòng)安裝和固件燒寫(xiě)。

將主板與 PC 機(jī)用 TYPE-C 線（注意有些數(shù)據(jù)線僅支持充電，無(wú)法傳輸數(shù)據(jù)）連接好，如果出現(xiàn)無(wú)法識(shí)別的情況可以通過(guò)重新連接、更換 PC 機(jī) USB 接口、更換 USB 線、更換 PC 機(jī)等方式重試。

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

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

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

進(jìn)入 Loader 模式

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

并保持按下?tīng)顟B(tài)，然后再上電開(kāi)機(jī)，主板會(huì)進(jìn)入 Loader 操作模式，然后松開(kāi)按鍵燒寫(xiě)系統(tǒng)即可，注意這種方式適用于主板上的 BootLoader 可正常工作的情況。

方式二、將主板接通電源，進(jìn)入系統(tǒng)，用 TYPE-C 線將主板與 PC 機(jī)連接好如下圖，RKDevTool 軟件會(huì)識(shí)別到一個(gè) ADB 設(shè)備，單擊切換按鈕，主板會(huì)重啟進(jìn)入 Loader 模式

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

一般僅在 uboot 損壞，無(wú)法進(jìn)入 Loader 模式時(shí)使用。將主板斷電，首先用 TYPE-C 線將主板與 PC 機(jī)連接好，按下主板上的 ROM 鍵，并保持按下?tīng)顟B(tài)，然后再上電開(kāi)機(jī)，主板會(huì)進(jìn)入MaskRom 操作模式，然后松開(kāi)按鍵燒寫(xiě)系統(tǒng)即可。

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

首先將主板進(jìn)入 Loader 或 Maskrom 模式，打開(kāi) RKDevTool 軟件，點(diǎn)擊固件按鈕選擇需要燒寫(xiě)的鏡像文件，然后點(diǎn)擊升級(jí)按鈕，右側(cè)窗口會(huì)顯示燒寫(xiě)進(jìn)度，燒寫(xiě)完成后，主板會(huì)自動(dòng)重啟開(kāi)機(jī)。

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

1、GPIO 編程參考

通過(guò) 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)用程序控制請(qǐng)參考源碼下的 demo 程序源碼

2、串口 UART 編程參考

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

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

https://github.com/Acccord/AndroidSerialPort

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

https://github.com/yutils/YSerialPort

3、WatchDog 看門(mén)狗編程參考

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

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

不大于 3 秒。

看門(mén)狗的使用流程為

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

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

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

命令行測(cè)試：

打開(kāi)看門(mén)狗：echo 1 >/sys/class/gzpeite/user/watch_dog

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

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

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

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

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

5、系統(tǒng)簽名

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

6、動(dòng)態(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

測(cè)試命令如下：

請(qǐng)參考源碼下的 demo 程序源碼

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

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

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

測(cè)試命令如下：

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

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

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

測(cè)試命令如下：

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

9、獲取MAC地址

原生Android12系統(tǒng)默認(rèn)禁止應(yīng)用獲取MAC地址，為了兼容更早期的應(yīng)用程序，我司已對(duì)系統(tǒng)代碼進(jìn)行優(yōu)化允許應(yīng)用app獲取WIFI及以太網(wǎng)的MAC地址，詳見(jiàn)源代碼目錄下的demo程序源碼。

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

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

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

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

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

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

六、動(dòng)態(tài)修改開(kāi)機(jī)logo和動(dòng)畫(huà)

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

兩個(gè)logo文件必須為bmp文件格式，一個(gè)是在uboot階段加載顯示，一個(gè)是在內(nèi)核階段加載顯示，文件名不可修改，文件內(nèi)容可以完全一樣。

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