BusHound說明書

1、bus hound 5.0 使用說明書( 版本： 1.0) 編制：古道熱腸版權所有：21ic侃單片機板塊完成日期：2007年7 月一、功能介紹bushound軟件是由美國 perisoft公司研制的一種專用于 pc機各種總線數(shù)據(jù)包監(jiān)視和控制的開發(fā)工具軟件，其名“hound”的中文意思為“獵犬”，即指其能敏銳地感知到總線的絲毫變化。bus hound的最新版本為 6.0 已上市，但考慮到目前廣泛使用的為5.0 版本，故本說明書以其 5.0 作為藍本，進行功能說明。bus hound是一個超級軟件總線協(xié)議分析器，用于捕捉來自設備的協(xié)議包和輸入輸出操作 ,其優(yōu)良特性如下：支持所有版本的 ide ，s

2、csi ，usb，1394 總線支持各類設備如硬盤庫，dvd ，鼠標，掃描儀，網(wǎng)絡照相機等支持windows9x,windowsme,nt4.0,2000,2003,xp和嵌入式 xp操作系統(tǒng)捕捉數(shù)據(jù)的總量僅受機器內(nèi)存限制可以設置觸發(fā)信號自動停止捕獲操作測試讀取，同步等設備性能捕獲設備驅動包，例如irp 捕獲任意數(shù)量的并行設備，而不管其總線類型身材苗條，易于交換與下載捕獲的數(shù)據(jù)易于拷貝到其它環(huán)境生成html 格式捕獲的數(shù)據(jù)能保存為文本文件或zip 文件所有的可捕獲設備以樹形結構列出，讓選擇設備來得更輕松些可捕獲設備的啟動過程用戶愛好設定功能，如用戶可調整捕獲到的數(shù)據(jù)顯示寬度，更宜于查看和使用。

3、查看底層協(xié)議包括 scsi 的sense 數(shù)據(jù)和 usb 的設置包查看每階段的時間變化精確到微秒將輸入輸出發(fā)生的操作實時顯示到屏幕上純軟件解決方案，你不需要對硬件進行任何變更，一些依舊bus hound有如此強大的功能，首先讓我們一睹其界面風采，啟動界面如下：二、捕獲窗口操作指南單擊主界面窗口上部命令按鈕區(qū)的capture按鈕進入捕獲操作主視窗。一個命令發(fā)送到設備通常由1個或幾個階段來完成，例如，一個典型的命令由命令字節(jié)階段，數(shù)據(jù)字節(jié)階段和狀態(tài)字節(jié)階段來完成，bus hound在捕獲顯示窗口中將顯示出階段完成的時間信息和詳細的數(shù)據(jù)內(nèi)容。捕獲數(shù)據(jù)列表,以下將描述捕獲窗口中每一列的功能1 、設備列

4、設備 id，每個設備分配了一個數(shù)字，第1個設備從 0開始，第 2個設備為 1，依此類推，這項功能對于軟件同時捕獲多個并行設備非常有用，設備的id 分配在 device 窗口中完成。對于usb 設備，設備的端點同時顯示出來( 例如4.1 表示 id 為4的設備的 1號端點 ) 2 、階段列階段類型，請參考下表為每個階段縮寫獲知詳細的細節(jié)信息階段功能描述addr 8 byte 1394 transfer address ati 7 byte ata task file returned from an ide device ato 7 byte ata task file sent to an i

5、de device atp windows ata_pass_through data structure cdb scsi command descriptor block (known as a packet command for atapi devices) ctl 8 byte setup packet of a usb control transfer di data in (device to pc transfer) do data out (pc to device transfer) ior windows vxd i/o request data structure ir

6、b windows 1394 i/o request block data structure irp windows i/o request packet data structure isoc isochronous transfer data bytes len data transfer length of a di,do, or isoc phase in decimal units. this field is off by default and can be turned on from the settings window lock 1394 lock transactio

7、n nsts windows 4 byte kernel mode ntstatus field rset bus or device reset rsts windows vxd ior status sns scsi request sense data spt windows scsi pass through data structure srb windows scsi request block (srb) data structure ssts windows 1 byte scsi request block (srb) status stak windows io_stack

8、_location data structure urb windows usb request block (urb) data structure usts windows 4 byte usbd_status code 3 、數(shù)據(jù)列與每個階段對應的數(shù)據(jù)顯示在此列中，例如命令字節(jié)，數(shù)據(jù)傳輸字節(jié)，和狀態(tài)字節(jié)都能在此窗口中顯示出來。4 、描述列與每個階段對應的文本說明給你帶來極大的便利5 、時間微分值 delta(dt)從前一階段到當前階段所花費的時間均顯示在此列中，時間單位的縮寫對照表見下表：name units us microseconds ms milliseconds sc seco

9、nds mn minutes hr hours dy days 6 、命令 .相位。1個數(shù)據(jù)組合體用來的標識當前捕獲的數(shù)據(jù)的確切階段，所有值均為十進制cmd 是命令數(shù)，命令計數(shù)從1開始，當有新命令發(fā)送到設備時進行加1操作phase 是命令中的階段數(shù)，1個命令通常由許多階段組成，例如數(shù)據(jù)傳輸階段和狀態(tài)反饋階段，階段計數(shù)值從1開始，在命令中當有新的階段產(chǎn)生時進行加1操作ofs 每個階段中字節(jié)的偏移量，計數(shù)值從0開始，數(shù)據(jù)傳輸過程中的每個新的數(shù)據(jù)字節(jié)時進行加 1操作。rep 指示命令重復發(fā)布數(shù)，重復計數(shù)特性能在系統(tǒng)設定窗口中進行開啟和關閉設定。7 、日期階段發(fā)生的日期在這一列中進行顯示，格式為：年/

10、 月/日8 、時間階段發(fā)生的時間在這一列中進行顯示，格式為：小時：分鐘：秒.毫秒，小時范圍為 0-23 捕獲系統(tǒng)啟動過程當退出 bus hound應用程序時， run 按鈕處于按下狀態(tài)時，設備驅動部分繼續(xù)捕獲數(shù)據(jù)，當系統(tǒng)進行重啟時，它將早于系統(tǒng)啟動過程進行數(shù)據(jù)捕獲操作。當退出 bus hound應用程序時， stop 按鈕處于按下狀態(tài)時，啟動過程不會發(fā)生數(shù)據(jù)捕獲操作，直到按下了啟動按鈕。捕獲數(shù)據(jù)顯示窗口的用戶愛好設定數(shù)據(jù)列表的列順序能通過拖拉列頂部到合適位置進行改變。每行字節(jié)顯示寬度能被修改為1,2 ，4,8 ，16 ，或者 32 ，這些設定被保存。查找功能能夠在捕獲窗口中進行數(shù)據(jù)查找操作，輸

11、入查找的字符串在窗口左下部的文本窗口中，然后按向上或向下箭頭完成查找操作，如果未查找到字符串，光標位置不做改變，注意查找時不區(qū)分大小寫。窗口支持拖選操作，首行點擊起始所在的行，再按下shift 按鈕不放，單擊結尾行，選中的數(shù)據(jù)能用鼠標拖拉到另外的軟件中使用( 就是拷貝操作 )，也可以按 ctrl+c將選中的數(shù)據(jù)先拷拷貝到剪貼板，再在其它軟件中用ctrl+v粘貼完成數(shù)據(jù)拷貝操作。命令交迭交迭的命令被標識，當發(fā)送到設備的一個新的命令啟動先于前一個命令時，這種情況在輸入輸出子系統(tǒng)是有可能發(fā)生的，這種交迭現(xiàn)象bus hound能夠顯示出來，當然這種情況不會出現(xiàn)的硬件抽象層。多輸入輸出階段這種情況僅在

12、windows 9x操作系統(tǒng)發(fā)生，同一命令的多輸入輸出階段被列表顯示時，指示傳輸被分割通過許多存儲空間來完成的. ps2 鼠標數(shù)據(jù)格式以下是 ps/2 鼠標返回的數(shù)據(jù)格式，這就是眾所周之的在windows ddk中定義的mouse_input_data結構體：offset length content 0 2 not used 2 2 position type: 0000h = relative position 0001h = absolute position 4 2 button flags: 0001h = left button down 0002h = left button u

13、p 0004h = right button down 0008h = right button up 0010h = middle button down 0020h = middle button up 0040h = button 4 down 0080h = button 4 up 0100h = button 5 down 0200h = button 5 up 0400h = mouse wheel 6 2 mouse wheel data 8 4 not used 12 4 x position 16 4 y position 20 4 device specific infor

14、mation ps2 鍵盤數(shù)據(jù)格式以下是 ps/2 鍵盤返回的數(shù)據(jù)格式，這就是眾所周之的在windows ddk中定義的keyboard_input_data結構體：offset length content 0 2 not used 2 2 scan code of key 4 2 flags: 0000h = key pressed 0001h = key released 0002h = extended scan code e0 0004h = extended scan code e1 6 2 not used 8 4 device specific information 三、保存

15、數(shù)據(jù)窗口單擊啟動窗體界面上的save 按鈕將所有捕獲到的數(shù)據(jù)保存到指定的文件中，文件格式可選為 txt 格式或 zip 格式，保存到文件中的數(shù)據(jù)格式與屏幕保持一致。1個附加的數(shù)據(jù)說明將被放置在數(shù)據(jù)文件的頭部，當前日期與時間也包含在說明中，通過插入 %c 轉義字符來完成，如果保存的是zip 格式文件，說明內(nèi)容也被壓縮成zip 格式。四、系統(tǒng)設定窗口系統(tǒng)設定窗口提供用戶進行參數(shù)設置。復選框選中后立即生效，數(shù)字輸入需按壓應用按鈕或切換到另一個窗體時或退出bus hound 時生效。buffer size(緩沖區(qū)大小 ) 指示用于捕獲數(shù)據(jù)緩沖區(qū)的ram 大小，以 k為單位，設置上限僅受系統(tǒng)內(nèi)存限制，如

16、果出現(xiàn)內(nèi)存不夠，緩沖區(qū)尺寸將縮減到可用ram 的大小。如果想獲得更多的空間用來緩存數(shù)據(jù)，除了增加系統(tǒng)內(nèi)存外，也可以在其它程序運行之前設置較大的緩沖區(qū)尺寸。注意：申請 1個比較大的緩沖區(qū)在windows9x 和windows me可能會花費一小段時間。max phase(最大階段 ) 指定每階段捕獲數(shù)據(jù)的最大數(shù)量，例如：當設定值為32 時，發(fā)生了一個 64k 的讀操作，僅僅前 32 個讀取到的字節(jié)被捕獲到，這個選項對于保持一個捕獲數(shù)據(jù)量的最小值是非常有用的。stop when.(停止條件 ) 設定用于停止捕獲操作的觸發(fā)條件，可對觸發(fā)條件進行任何組合，只要有一個觸發(fā)條件滿足時，捕獲操作將停止，屏幕

17、上將用高亮紅色顯示對應的觸發(fā)數(shù)據(jù)。any other error(任何錯誤發(fā)生 ) 當系統(tǒng)遇到任何種類的錯誤發(fā)生時停止數(shù)據(jù)捕獲操作buffer full(緩沖區(qū)滿 ) 當緩沖區(qū)滿時停止操作，如果未選中此選項，系統(tǒng)將采用滾動覆蓋模式保存最近捕獲到的數(shù)據(jù)。bus reset(總線復位 ) 遇到總線復位操作時停止捕獲操作data overrun(數(shù)據(jù)過載 ) 當發(fā)生數(shù)據(jù)過載或數(shù)據(jù)欠載時，停止捕獲操作。hardware error(硬件錯誤 ) 當發(fā)生硬件錯誤時停止捕獲操作invalid command(非法命令 ) 當發(fā)現(xiàn)非法的命令時停止捕獲操作media error(媒體錯誤 ) 當設備返回一個媒

18、體錯誤時，停止捕獲操作，典型情況是報告發(fā)現(xiàn)扇區(qū)錯誤。no media(沒有媒體 ) ，當設備返回沒有媒體時，停止捕獲操作not ready(沒有準備好 ) 遇到設備未準備好，超時，或忙的情況時停止捕獲操作text pattern / hex pattern(文本式樣 ) 當出現(xiàn)定義的特殊式樣的文本數(shù)據(jù)時，停止捕獲操作，對于文本式樣，區(qū)分大小寫，檢查過程遍及數(shù)據(jù)傳輸?shù)拿總€階段，包括命令，數(shù)據(jù)和狀態(tài)階段。vendor error(廠商錯誤 ) 當一個獨特的廠商錯誤出現(xiàn)時停止捕獲操作windows error(操作系統(tǒng)錯誤 ) 當出現(xiàn)一個操作系統(tǒng)類型的錯誤時停止捕獲操作phases to captu

19、re(選擇階段 )這個選項包括了bus hound所有能捕獲的階段列表，復選對應的選項表示進行捕獲操作，清除復選框時表示不進行捕獲，這個選項對于用于過濾不感興趣( 無用數(shù)據(jù) ) 階段或者啟動系統(tǒng)默認關閉了階段尤為有用。選項框右邊， 1個白色的圓將出現(xiàn)，這將指示用于捕獲操作的階段，如果圓出現(xiàn)綠色閃亮，指示此階段正在發(fā)生并被捕獲到。merge repeated commands(合并重復命令) 選中此項后，如果出現(xiàn)命令與前一命令相同的狀況時，新命令將不獨記錄，取而代之的是，前一命令的數(shù)量值加1，這項功能尤其適用于當與設備進行同一命令通訊時將捕獲到的數(shù)據(jù)進行簡約化處理。enable sounds 選

20、中此項后，在執(zhí)行捕獲，設定，或遇到觸發(fā)條件彈出設備窗口時，bus hound將發(fā)出“呯”的一聲。columns to display 復選列表框中的選項，表示想將對應的列顯示在捕獲窗口中，選中的列將能執(zhí)行拖選和保存操作，詳細情況見“捕獲窗口”章節(jié)關于每一列的介紹。五、設備窗口設備列表指示出 bus hound能支持的當前系統(tǒng)中的每一個設備，列表自動更新，反映出是否插入或移除設備。選擇復選框表示選中或取消選中設備進行捕獲操作。選中操作立即生效。每個設備被指定一個數(shù)字綁定到設備名的前面，這個數(shù)字在捕獲窗口中將顯示在設備列下，這個數(shù)字用來指示設備加入系統(tǒng)順序。當出現(xiàn)設備以亮字體顯示時，指示設備不在當

21、前的系統(tǒng)中。capture new deviecs(捕獲新設備 ) 選中此項將自動捕獲檢測到的新設備的數(shù)據(jù)，這項特色功能尤其適用于發(fā)送到熱拔插設備的第 1個命令。 device properties(設備屬性 ) 這個面板將顯示設備的一些細節(jié)特性，比如“傳輸性能表現(xiàn)”，性能表現(xiàn)是通過完成命令過程中總的傳輸字節(jié)數(shù)除上總的花費時間來得到的。當捕獲窗口中的運行按鈕按下時，性能表現(xiàn)統(tǒng)計數(shù)據(jù)將被清除掉。send command(發(fā)送命令 ) 使用此命令，您能發(fā)送您自已的命令到設備，啟用發(fā)送命令功能，只需在高亮選擇一個設備后，用鼠標單擊“send command”按鈕或簡單地雙擊設備。發(fā)送命令到設備的功能

22、是一個非常強大的輔助工具，讓你提交命令到usb ，1394 ，ata 和scsi 設備易于反掌。你也可以用它來完成一些其它的特殊操作，例如總線復位，執(zhí)行硬件端口的輸入輸出。注意：硬件端口的輸入輸出操作可以會導致系統(tǒng)崩潰，清謹慎使用。六、文件安裝列表bushound.exe - bus hound 可執(zhí)行文件buscmdr.exe - bus commander 執(zhí)行文件bhuninst.exe 反安裝文件 ( 卸載文件 ) bhlog.exe - 將數(shù)據(jù)捕獲到磁盤的工具 ( 僅注冊版有此文件 ) bhound3.vxd - windows 95, 98, me 設備驅動程序bhound4.sy

23、s - windows nt 4.0設備驅動程序bhound5.sys - windows 98, me, 2000, 2003, xp設備驅動程序help.rtf - 幫助文件 ( 也就是本文件 ) site license 注冊版的 bus hound 在其安裝目錄下包含了bhlog.exe命令行工具。 bhlog 將捕獲到的實時數(shù)據(jù)存放到磁盤文件中，這將解除捕獲數(shù)據(jù)存放空間受機器內(nèi)存限制的束縛。讓你實現(xiàn)磁盤有多大空間，我bun hound就有多大能耐的功能。 bhlog 在系統(tǒng)凍結 (休眠)甚至重啟時仍能將捕獲到的數(shù)據(jù)存放到1個網(wǎng)絡驅動器的文件中的功能。七、 faq( 常見問題解答 )

24、使用過程中遇到問題可查看軟件的幫助系統(tǒng)，也可以去perisoft軟件公司的網(wǎng)站獲得最新的信息。bus hound軟件的幫助系統(tǒng)主界面如下：1 、什么類型的輸入輸出操作能被捕獲? bus hound捕獲經(jīng)由總線傳輸?shù)臄?shù)據(jù)包，這包括命令，數(shù)據(jù)，狀態(tài)，和時序。bus hound并不監(jiān)視獨立的硬件信號。2 、 bus hound會改變我的設備的工作方式嗎？答案是不會改變，因為 bus hound 僅僅是完成“偵聽”數(shù)據(jù)包的工作，它不會改變命令，更不會發(fā)送它自已的命令，也不會替代任何系統(tǒng)設備，不會存取硬件。總之系統(tǒng)和設備的操作不必在乎bus hound軟件是否在運行或停止運行，就當它不存在似的。3 、

25、bus hound會影響到系統(tǒng)的性能嗎？用戶捕獲數(shù)據(jù)是來自速度極快的并行設備，因而感覺不到它對系統(tǒng)性能的影響，換句話說， 給使用者的印象是對性能沒有影響。當處于停止狀態(tài)時， bus hound 也是不會損傷系統(tǒng)。4 、 bus hound 支持哪些設備 ? 所有的 ide ，scsi ，usb 和1394 設備都得到支持，包括磁盤驅動器，鼠標、掃描儀，網(wǎng)絡攝像頭，等等。只要是枚舉成以上所列的總線類型的設備均能夠得到支持，例如一些usb 轉并行口的設備就能捕獲。5、為何有 3個重復的設備 ?對于某些設備， windows操作系統(tǒng)建立了更高層的數(shù)據(jù)包然后傳輸?shù)降讓拥陌罱K送往硬件，bus houn

26、d顯示了幾個設備，如此你能選擇在哪個層次進行捕獲操作。6、對于控制能捕獲到什么呢？有些控制能收到命令，有些卻收不到， 你可以對一個控制嘗試進行捕獲操作，并查看數(shù)據(jù)是否為有用的。7、為什么 bus hound 沒有顯示一個設備? 當系統(tǒng)以安全模式啟動時，將沒有設備顯示，這是由于安全模式下系統(tǒng)為了清潔，將系統(tǒng)置于安全模式的特性決定的。當設備未正常安裝時，不會顯示出來，即啟動控制面板的設備管理器，當出現(xiàn)帶問號的設備是不能進行捕獲操作的。scsi 適配卡在 win95/98/me下不能顯示，除非其附屬于某設備。8、為什么有些設備會出現(xiàn)灰色的? 灰色的設備指示它目前未處于系統(tǒng)管理范圍之內(nèi)。9、當啟動系統(tǒng)進行捕獲操作時，系統(tǒng)出現(xiàn)沖撞，我該怎么辦呢？這種情況歸根到底是window9x系統(tǒng)架構的限制造成的，如果有太多的設備驅動要求接收輸入輸出是否完成的通告，系統(tǒng)就會發(fā)生沖撞，甚至崩潰。微軟設備驅動和其它安裝的軟