可編程 USB 轉串口適配器開發板芯片驅動文件說明

可編程USB轉 UART/I2C /SMBusS/SPI/CAN/1 -Wire適配器USB2S  芯片驅動文件說明 

芯片選擇下拉框內列出的每一個備選芯片的驅動文件和數據手冊位于S2STool 工具文件夾中的chips 文件夾內，每一個芯片需要 1 個驅動文件和 1 個數據手冊文件，用戶可自行打開編輯，或者創建新的芯片驅動文件。 

芯片驅動文件為 xml 格式，需要手工修改或者創建，芯片數據手冊一般來自于網絡，下載后復制到 chips 文件夾內即可。 

Xml 文件為文本文件，建議使用“Notepad++”編輯器。 

1.芯片驅動結構說明 

下圖所示為芯片驅動的模板文件“template.xml”。 

芯片驅動文件的結構較為簡單，分為芯片說明、描述部分和測試指令部分，芯片描述部分包括作者信息、芯片說明、數據手冊名稱等，按照實際情況修改即可，下面重點說明測試指令部分。

在驅動文件中的 COMMANDS 節點內，每一對尖括號節點段（< />，下文稱“指令節點”）稱為一個命令，每個命令對應主界面上芯片操作區的一個按鈕，按鈕由程序根據驅動文件動態生成。   指令中的屬性 

caption 屬性：顯示于按鈕上的文字內容 

hint 屬性：此指令的提示信息（當鼠標移動到此按鈕上時會顯示此提示） 

cmdStr 屬性：此指令的具體指令內容（符合S2S 協議的字符串指令），支

用“|”分隔的多條

字符串指令，例如：指令字符串 1|DELAY100|指令字符串 2|DELAY100|…… 

指令的子節點-返回數據計算項 

對于有返回數據的指令，若希望對返回數據進行一些運算并將運算結果顯示于主界面的數據表格中，則應為此指令添加若干子節點，即“返回數據計算項”，返回數據計算項的數量（行數）沒有任何限制，可以沒有，也可以任意多個。 

數據計算項的屬性 

caption 屬性：顯示于數據表格中的第一列，即：名稱列。 

formula 屬性：此數據項的計算公式，計算公式的運算結果會更新到數據表格的第二列，即： 數值列。 

startBit 和 endBit 屬性：若是“-1”則表示計算公式結果直接顯示于界面表格中，否則將指定的某些位（bit）截取后顯示于表格中。要取出的二進制數據可以指定開始位值和結束位值， 分別用 startBit 和endBit 來定義。 

關于計算公式 

計算公式為一段字符串，支持常用的四則運算符號和初等數學函數、邏輯函數等。在公式中， 可使用“dat[0]”表示執行當前指令后芯片返回的首個字節，“dat[1]”表示返回的第第 2 個字節，以此類推。 

2.新建芯片驅動 

（1）創建芯片驅動文件 

打開“template.xml”文件，根據芯片接口類型，將文件另存到 chips 文件夾內的 I2S、SPI

或者 Wire 文件夾內，文件名稱必須使用芯片名稱，方便在主界面芯片備選框中識別此芯片。 

（2）添加數據手冊 

將下載的數據手冊文件復制到與上述芯片驅動文件相同的文件夾內。 

（3）修改芯片驅動內容 

按照 9.1 中的驅動文件結構和各部分含義、功能和注意事項，對照芯片數據手冊完成驅動文件內容的修改，最后保存驅動文件。 

（4）運行程序并驗證驅動文件 

將芯片連接到 USB2S 的對外管腳上，運行 S2STool 工具，選擇剛剛創建的芯片名稱，驗證各個命令及返回的數據計算項是否正確。