14.8. 處理固件

14.8.?處理固件

作為一個驅動作者, 你可能發(fā)現(xiàn)你面對一個設備必須在它能支持工作前下載固件到它里面. 硬件市場的許多地方的競爭是如此得強烈, 以至于甚至一點用作設備控制固件的 EEPROM 的成本制造商都不愿意花費. 因此固件發(fā)布在隨硬件一起的一張 CD 上, 并且操作系統(tǒng)負責傳送固件到設備自身.

你可能想解決固件問題使用這樣的一個聲明:

static char my_firmware[] = { 0x34, 0x78, 0xa4, ... }; 

但是, 這個方法幾乎肯定是一個錯誤. 將固件編碼到一個驅動擴大了驅動的代碼, 使固件升級困難, 并且非常可能產(chǎn)生許可問題. 供應商不可能已經(jīng)發(fā)布固件映象在 GPL 之下, 因此和 GPL-許可的代碼混合常常是一個錯誤. 為此, 包含內(nèi)嵌固件的驅動不可能被接受到主流內(nèi)核或者被 Linux 發(fā)布者包含.

14.8.1.?內(nèi)核固件接口

正確的方法是當你需要它時從用戶空間獲取它. 但是, 請抵制試圖從內(nèi)核空間直接打開包含固件的文件的誘惑; 那是一個易出錯的操作, 并且它安放了策略(以一個文件名的形式)到內(nèi)核. 相反, 正確的方法時使用固件接口, 它就是為此而創(chuàng)建的:

#include <linux/firmware.h>
int request_firmware(const struct firmware **fw, char *name, 
 struct device *device); 

調(diào)用 request_firmware 要求用戶空間定位并提供一個固件映象給內(nèi)核; 我們一會兒看它如何工作的細節(jié). name 應當標識需要的固件; 正常的用法是供應者提供的固件文件名. 某些象 my_firmware.bin 的名子是典型的. 如果固件被成功加載, 返回值是 0(負責常用的錯誤碼被返回), 并且 fw 參數(shù)指向一個這些結構:

struct firmware {
 size_t size;
 u8 *data; 
}; 

那個結構包含實際的固件, 它現(xiàn)在可被下載到設備中. 小心這個固件是來自用戶空間的未被檢查的數(shù)據(jù); 你應當在發(fā)送它到硬件之前運用任何并且所有的你能夠想到的檢查來說服你自己它是正確的固件映象. 設備固件常常包含標識串, 校驗和, 等等; 在信任數(shù)據(jù)前全部檢查它們.

在你已經(jīng)發(fā)送固件到設備前, 你應當釋放 in-kernel 結構, 使用:

void release_firmware(struct firmware *fw); 

因為 request_firmware 請求用戶空間來幫忙, 它保證在返回前睡眠. 如果你的驅動當它必須請求固件時不在睡眠的位置, 異步的替代方法可能要使用:

int request_firmware_nowait(struct module *module,
 char *name, struct device *device, void *context,
 void (*cont)(const struct firmware *fw, void *context)); 

這里額外的參數(shù)是 moudle( 它將一直是 THIS_MODULE), context (一個固件子系統(tǒng)不使用的私有數(shù)據(jù)指針), 和 cont. 如果都進行順利, request_firmware_nowait 開始固件加載過程并且返回 0. 在將來某個時間, cont 將用加載的結果被調(diào)用. 如果由于某些原因固件加載失敗, fw 是 NULL.

14.8.2.?它如何工作

固件子系統(tǒng)使用 sysfs 和熱插拔機制. 當調(diào)用 request_firmware, 一個新目錄在 /sys/class/firmware 下使用你的驅動的名子被創(chuàng)建. 那個目錄包含 3 個屬性:

loading
這個屬性應當被加載固件的用戶空間進程設置為 1. 當加載進程完成, 它應當設為 0. 寫一個值 -1 到 loading 會中止固件加載進程.

data
data 是一個二進制的接收固件數(shù)據(jù)自身的屬性. 在設置 loading 后, 用戶空間進程應當寫固件到這個屬性.

device
這個屬性是一個符號連接到 /sys/devices 下面的被關聯(lián)入口項.

一旦創(chuàng)建了 sysfs 入口項, 內(nèi)核為你的設備產(chǎn)生一個熱插拔事件. 傳遞給熱插拔處理者的環(huán)境包括一個變量 FIRMWARE, 它被設置為提供給 request_firmware 的名子. 這個處理者應當定位固件文件, 并且拷貝它到內(nèi)核使用提供的屬性. 如果這個文件無法找到, 處理者應當設置 loading 屬性為 -1.

如果一個固件請求在 10 秒內(nèi)沒有被服務, 內(nèi)核就放棄并返回一個失敗狀態(tài)給驅動. 超時周期可通過 sysfs 屬性 /sys/class/firmware/timeout 屬性改變.

使用 request_firmware 接口允許你隨你的驅動發(fā)布設備固件. 當正確地集成到熱插拔機制, 固件加載子系統(tǒng)允許設備簡化工作"在盒子之外" 顯然這是處理問題的最好方法.

但是, 請允許我們提出多一條警告: 設備固件沒有制造商的許可不應當發(fā)布. 許多制造商會同意在合理的條款下許可它們的固件, 如果客氣地請求; 一些其他的可能不何在. 無論如何, 在沒有許可時拷貝和發(fā)布它們的固件是對版權法的破壞并且招致麻煩.