一、主板接口

二、主板功能

三、接口詳細(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)閉這個功能，建議安裝一個 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 模式時可以對系統(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 軟件會識別到一個 ADB 設(shè)備，單擊切換按鈕，主板會重啟進(jìn)入 Loader 模式

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

一般僅在 uboot 損壞，無法進(jìn)入 Loader 模式時使用。將主板斷電，首先用 TYPE-C 線將主板與 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 處于輸出和輸入模式時都可以讀取，當(dāng)設(shè)置為輸入模式時讀取的是 GPIO 實(shí)際電平，當(dāng)設(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 時，向系統(tǒng)發(fā)送 gzpeite.intent.action.install_apk 廣播

卸載 APK 時，向系統(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、定時開關(guān)機(jī)

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

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

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

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

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

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

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

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

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