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

電量計通信基礎

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

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

主機控制器訪問電量計

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

配置相關API：FlashStream Parser是配置電量計的便捷方式，通過gauge_execute_fs函數執行FlashStream文件完成配置。對于有文件系統的主機uC，可從文件系統讀取文件內容；無文件系統時，可將文件內容編譯到固件中。

標準命令API：gauge_cmd_read用于讀取標準命令結果，gauge_cmd_write用于向標準命令寫入數據，可獲取如電壓、充電狀態等測量結果，也能設置負載值等參數。

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

數據內存訪問API：gauge_read_data_class和gauge_write_data_class函數用于訪問數據內存中的子類數據，數據內存訪問復雜，使用間接尋址和校驗和確保數據完整性。

數據內存

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

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

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

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

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