德州儀器（Texas Instruments）發(fā)布的關(guān)于電池電量計通信的應(yīng)用報告，主要介紹了電池電量計的通信、配置、數(shù)據(jù)內(nèi)存訪問以及相關(guān)代碼示例等內(nèi)容，為開發(fā)者提供了全面的技術(shù)指導。

電量計通信基礎(chǔ)

電量計命令：電量計通過命令與主機控制器通信，命令類似寄存器，如讀取充電狀態(tài)的命令StateOfCharge()，其命令代碼為0x1C和0x1D 。命令分為標準命令（用于獲取測量結(jié)果和更改部分配置參數(shù)）和擴展命令（主要用于訪問數(shù)據(jù)內(nèi)存中的專有配置參數(shù)）。

電量計配置：電量計的配置參數(shù)存儲在數(shù)據(jù)內(nèi)存中，通過間接訪問方法進行設(shè)置。數(shù)據(jù)內(nèi)存按子類和數(shù)據(jù)塊組織，每個數(shù)據(jù)塊包含不同參數(shù)。TI提供的bqStudio軟件工具可通過GUI方便地訪問所有參數(shù)，并能將配置導出為FlashStream?文件 。

主機控制器訪問電量計

抽象的終端系統(tǒng)相關(guān)API：TI提供系統(tǒng)獨立的ANSI - C源代碼，客戶需實現(xiàn)gauge_read、gauge_write和gauge_address這三個函數(shù)，用于抽象主機控制器的低級通信接口，其實現(xiàn)與具體接口（如I2C、SMBUS、HDQ）相關(guān)。

配置相關(guān)API：FlashStream Parser是配置電量計的便捷方式，通過gauge_execute_fs函數(shù)執(zhí)行FlashStream文件完成配置。對于有文件系統(tǒng)的主機uC，可從文件系統(tǒng)讀取文件內(nèi)容；無文件系統(tǒng)時，可將文件內(nèi)容編譯到固件中。

標準命令A(yù)PI：gauge_cmd_read用于讀取標準命令結(jié)果，gauge_cmd_write用于向標準命令寫入數(shù)據(jù)，可獲取如電壓、充電狀態(tài)等測量結(jié)果，也能設(shè)置負載值等參數(shù)。

子命令A(yù)PI：gauge_control函數(shù)用于發(fā)送子命令，可讀取如固件版本、ChemID等輔助信息，或觸發(fā)如電量計復(fù)位、清除中斷、啟用模式等功能。

數(shù)據(jù)內(nèi)存訪問API：gauge_read_data_class和gauge_write_data_class函數(shù)用于訪問數(shù)據(jù)內(nèi)存中的子類數(shù)據(jù)，數(shù)據(jù)內(nèi)存訪問復(fù)雜，使用間接尋址和校驗和確保數(shù)據(jù)完整性。

數(shù)據(jù)內(nèi)存

子類和數(shù)據(jù)塊：數(shù)據(jù)內(nèi)存由稱為子類的參數(shù)組構(gòu)成，每個子類包含一個或多個數(shù)據(jù)塊，最長32字節(jié)。參數(shù)位于數(shù)據(jù)塊內(nèi)，有偏移地址、長度和數(shù)據(jù)類型。更改配置參數(shù)時，需先定位參數(shù)，讀取子類數(shù)據(jù)到本地緩沖區(qū)修改后，再寫回子類。

數(shù)據(jù)內(nèi)存尋址：數(shù)據(jù)內(nèi)存通過間接尋址訪問，使用擴展命令確定子類（0x3E）、數(shù)據(jù)塊（0x3F），數(shù)據(jù)塊從0x40開始到0x5F結(jié)束，0x60用于存儲塊校驗和。讀寫數(shù)據(jù)內(nèi)存時，按特定順序操作，校驗和是當前數(shù)據(jù)塊所有32字節(jié)數(shù)據(jù)之和取8位截斷并取反。

ROM與FLASH電量計區(qū)別：FLASH電量計將配置存儲在非易失性內(nèi)存中，復(fù)位或掉電后配置仍保留，且寫數(shù)據(jù)內(nèi)存無需更改操作模式；ROM電量計的默認配置在只讀內(nèi)存中，啟動時復(fù)制到數(shù)據(jù)內(nèi)存RAM，寫數(shù)據(jù)內(nèi)存前需進入配置更新模式（gauge_cfg_update），寫完后需退出（gauge_exit） 。

FlashStream?文件格式：FlashStream文件用于電量計配置，有多種亞型，如用于ROM電量計的Golden Image文件（.gm.fs）、用于Flash電量計的配置文件（.df.fs）等。文件為文本格式，有寫命令（W）、比較命令（C）、延遲命令（X），分別用于寫入數(shù)據(jù)、比較數(shù)據(jù)和設(shè)置延遲時間。

源代碼示例：文檔附錄提供了gauge.c和gauge.h文件的代碼示例，實現(xiàn)了電量計控制、命令讀寫、數(shù)據(jù)類讀寫、FlashStream文件執(zhí)行等功能。還給出了在Linux用戶空間I2C/dev接口下的示例代碼，展示了如何使用這些函數(shù)進行電量計通信、配置和數(shù)據(jù)操作。