在瑞芯微（RK）平臺的嵌入式開發(fā)中，vendor_storage是一個核心模塊，專門用于存儲SN（序列號）、MAC地址、DRM密鑰等廠商專屬數(shù)據(jù)。它不僅提供了跨環(huán)境的數(shù)據(jù)讀寫能力，還具備可靠性校驗、掉電恢復(fù)等關(guān)鍵特性，是保障設(shè)備身份標識、功能授權(quán)等核心信息安全的重要組件。本文將從基礎(chǔ)知識、開發(fā)流程、使用途徑三方面，為開發(fā)者梳理完整的開發(fā)邏輯。

一、核心基礎(chǔ)知識：了解Vendor Storage是什么？

1.核心定位與核心特性

Vendor Storage的核心作用是集中管理廠商專屬靜態(tài)數(shù)據(jù)，這些數(shù)據(jù)通常需要在設(shè)備全生命周期中穩(wěn)定存儲，且支持多環(huán)境訪問。其核心特性包括：

?多場景讀寫：支持UBOOT、Kernel、Linux應(yīng)用層、PC工具直接讀寫，覆蓋設(shè)備啟動到運行的全流程；

?數(shù)據(jù)可靠性：自帶Hash校驗、掉電恢復(fù)機制，避免數(shù)據(jù)損壞或丟失；

?靈活分配：數(shù)據(jù)按64字節(jié)整數(shù)倍分配（1-64字節(jié)占64字節(jié)，65-128字節(jié)占128字節(jié)，以此類推）；

?唯一ID訪問：每個數(shù)據(jù)項對應(yīng)唯一ID，通過ID精準讀寫，支持SN、MAC、密鑰等16種標準類型及自定義類型。

2.存儲架構(gòu)與數(shù)據(jù)布局

Vendor Storage支持EMMC、SPI NOR、NAND等主流存儲介質(zhì)，整體架構(gòu)分為“索引區(qū)+數(shù)據(jù)區(qū)+校驗區(qū)”三部分：

?索引區(qū)（64K）：存儲數(shù)據(jù)項的ID、偏移量、大小、空閑空間等元信息，便于快速定位數(shù)據(jù)；

?數(shù)據(jù)區(qū)（按需分配）：存儲實際廠商數(shù)據(jù)，如SN、WIFI MAC、LAN MAC、BT MAC等，支持用戶自定義數(shù)據(jù)項；

?校驗區(qū)（8字節(jié)）：包含4字節(jié)Hash校驗值和4字節(jié)版本號，確保數(shù)據(jù)完整性。

3.關(guān)鍵ID定義（標準類型）

開發(fā)中需通過ID標識數(shù)據(jù)項，常用標準ID如下：

二、開發(fā)流程：從環(huán)境配置到功能實現(xiàn)

Vendor Storage的開發(fā)流程圍繞“環(huán)境配置→接口調(diào)用→測試驗證”三步驟展開，覆蓋UBOOT、Kernel、應(yīng)用層全場景。

1.前期準備：環(huán)境配置與源碼依賴

（1）源碼路徑

?UBOOT層：

u-boot/board/rockchip/common/storage/storage.c

?Kernel層：

kernel/drivers/soc/rockchip/rk_vendor_storage.c、sdmmc_vendor_storage.c

?應(yīng)用層：基于Kernel提供的IOCTL節(jié)點或PC工具開發(fā)

（2）編譯配置

?Kernel層：通過Menuconfig啟用驅(qū)動（路徑：Drivers -> SOC -> Rockchip -> Vendor Storage）；

?UBOOT層：默認集成源碼，需確保編譯時勾選“Vendor Storage Support”。

2.核心開發(fā)：接口調(diào)用（分場景實現(xiàn)）

（1）UBOOT層開發(fā)（設(shè)備啟動階段讀寫）

UBOOT層主要用于設(shè)備啟動時讀取關(guān)鍵數(shù)據(jù)（如MAC地址），核心接口如下：

?初始化：int vendor_storage_init(void)

?功能：初始化Vendor Storage模塊

?返回值：0 =成功，非0 =失敗

?讀取數(shù)據(jù)：int vendor_storage_read(u32 id, void *pbuf, u32 size)

?入?yún)ⅲ篿d =數(shù)據(jù)項ID，pbuf =接收數(shù)據(jù)的緩沖區(qū)，size =期望讀取字節(jié)數(shù)

?返回值：非- 1 =實際讀取字節(jié)數(shù)，-1 =讀取失敗

?寫入數(shù)據(jù)：int vendor_storage_write(u32 id, void *pbuf, u32 size)

?入?yún)ⅲ篿d =數(shù)據(jù)項ID，pbuf =待寫入數(shù)據(jù)緩沖區(qū)，size =寫入字節(jié)數(shù)

?返回值：0 =成功，非0 =失敗

示例場景：UBOOT階段讀取SN并打印

vendor_storage_init();// 初始化charsn_buf[64];intret =vendor_storage_read(VENDOR_SN_ID, sn_buf,64);// 讀取SNif(ret >0) { printf("Device SN: %sn", sn_buf);}

（2）Kernel層開發(fā)（驅(qū)動級讀寫）

Kernel層通過驅(qū)動接口提供IOCTL節(jié)點，供應(yīng)用層調(diào)用，核心接口與UBOOT層類似：

?讀取數(shù)據(jù)：int rk_vendor_read(u32 id, void *pbuf, u32 size)

?寫入數(shù)據(jù)：int rk_vendor_write(u32 id, void *pbuf, u32 size)

?注意：Kernel層無需手動初始化，驅(qū)動加載時自動完成初始化。

（3）Linux應(yīng)用層開發(fā)（用戶態(tài)讀寫）

應(yīng)用層通過打開/dev/vendor_storage設(shè)備節(jié)點，結(jié)合IOCTL實現(xiàn)讀寫，核心步驟：

1.打開設(shè)備節(jié)點：int sys_fd = open("/dev/vendor_storage", O_RDWR, 0);

2.構(gòu)造讀寫請求（指定ID、緩沖區(qū)、數(shù)據(jù)大小）；

3.調(diào)用IOCTL接口完成讀寫；

4.關(guān)閉設(shè)備節(jié)點。

示例代碼片段（讀取WIFI MAC）：

intsys_fd =open("/dev/vendor_storage", O_RDWR,0);if(sys_fd =0) { printf("WIFI MAC:%02x:%02x:%02x:%02x:%02x:%02xn",     req.data[0], req.data[1], req.data[2],     req.data[3], req.data[4], req.data[5]);}close(sys_fd);

3.測試驗證：工具與方法

（1）PC工具測試（RKDevInfoWriteTool）

?兼容模式：選擇“兼容模式”下面寫號，在這種模式下面，可以選擇”強制MASKROM”強制機器到maskrom下面寫號，或者不選擇“強制MASKROM”，那么機器需要先切換到loader模式寫號（適用于在空片情況下使用）；

?寫后重啟：寫完后重啟機器；

?適用場景：量產(chǎn)階段批量寫入SN、MAC等數(shù)據(jù)，或快速驗證數(shù)據(jù)正確性。

（2）命令行工具測試（vendor_storage工具）

RK提供專用命令行工具，支持Linux環(huán)境快速讀寫，常用命令示例：

?寫入字符串到自定義ID（ID=26）：

vendor_storage -w VENDOR_CUSTOM_ID_1A -t string -i "test_storage"

?讀取自定義ID數(shù)據(jù)到文件：

vendor_storage -r VENDOR_CUSTOM_ID_1A -t file -i /userdata/read.bin

?讀取SN并以字符串顯示：

vendor_storage -r VENDOR_SN_ID -t string

三、使用途徑：不同場景下的應(yīng)用選擇

根據(jù)開發(fā)階段和使用場景，可選擇不同的訪問途徑，具體如下：

四、開發(fā)注意事項

1.數(shù)據(jù)大?。簢栏褡裱?4字節(jié)整數(shù)倍分配規(guī)則，避免空間浪費；

2.數(shù)據(jù)可靠性：寫入關(guān)鍵數(shù)據(jù)后建議讀取校驗，確保Hash驗證通過；

3.ID唯一性：自定義ID需避開標準ID（0-255中已定義的16種類型），避免沖突；

4.權(quán)限控制：應(yīng)用層訪問/dev/vendor_storage需root權(quán)限，可通過修改設(shè)備節(jié)點權(quán)限優(yōu)化。

Vendor Storage作為RK平臺的核心廠商數(shù)據(jù)管理模塊，其設(shè)計兼顧了可靠性、靈活性和多場景適配性。掌握本文梳理的基礎(chǔ)知識、開發(fā)流程和使用途徑，可快速實現(xiàn)SN、MAC、密鑰等數(shù)據(jù)的管理需求，適配從設(shè)備啟動到量產(chǎn)交付的全流程開發(fā)場景。

審核編輯 黃宇