.exdicmd （EXDI 命令）

發行項
11/01/2024

.exdicmd 會使用作用中的 EXDI 偵錯連線，將擴充偵錯介面（EXDI）命令傳送至目標系統。如需EXDI的詳細資訊，請參閱設定EXDI調試程式傳輸。

exdicmd component|target parameters

此命令會將參數直接傳遞至 EXDI 元件。如需目標系統可用之有效命令的詳細資訊，請參閱 EXDI 元件的檔。

並非所有 EXDI 元件都已實作此函式。

參數

這些是 .exdicmd 的有效參數。

參數	描述
`target:*:<string>`	將函式傳遞 `<string>` 至所有處理器核心的目標端實體。
`target:<n>:<string>`	將函式傳遞 `<string>` 至處理器核心 n （n-decimal number）的目標結束實體。
`component:*:<string>`	在所有處理器核心上執行 EXDI 元件 `<string>` 函式。
`component:<n>:<string>`	在處理器核心 n （n-decimal number）上執行 EXDI 元件 `<string>` 函式。
`help`	顯示基本說明。

目標 exdicmd 使用量

.exdicmd target:*:<string>

使用目標參數可讓您在 Windows 調試程式與 EXDI COM 伺服器之間進行通訊。如果命令傳回調試程式引擎的回應，調試程式將會顯示命令結果。

.exdicmd 目標參數會採用 EXDI COM 伺服器能夠處理的任何命令。這可讓命令使用方式超出EXDI介面中直接支援的內容。

元件 exdicmd 使用方式

.exdicmd <component>:

此命令的目的主要是能夠執行/測試 EXDI COM 伺服器函式來驗證基本功能。通常較少使用上述目標參數使用方式。

請注意，EXDI COM 伺服器可以在內部執行命令，而不需要將它傳送至 JTAG 目標實體。例如，您可以從 EXDI COM 伺服器收集遙測，以驗證其正確作業。

Environment

描述項	值
模式	僅限核心模式
Target	僅限即時偵錯
平台	全部

其他資訊

使用 .exdicmd 搭配 OpenOCD 目標的範例，其使用語法.exdicmd target:0:<OpenOCD command>如下所示。

0: kd> .exdicmd target:0:info network
Target command response: e1000.0: index=0,type=nic,model=e1000,macaddr=52:54:00:12:34:56
 \ net0: index=0,type=user,net=10.0.2.0,restrict=off
OK
exdiCmd: The function: 'info network' was completed.

0: kd> .exdicmd target:0:info registers system -v
Target command response: 
NumberOfRegisters: 9

     Name | Value            | Access code
  fs_base | 0000000000000000 | n/a    
  gs_base | fffff8047b907000 | n/a    
k_gs_base | 000000e7cbdbe000 | n/a    
      cr0 | 0000000080050033 | n/a    
      cr2 | fffff8048454de64 | n/a    
      cr3 | 00000000001ae000 | n/a    
      cr4 | 00000000000006f8 | n/a    
      cr8 | 0000000000000000 | n/a    
     efer | 0000000000000d01 | 0xc0000080

exdiCmd: The function: 'info registers system -v' was completed.

如果目標系統無法瞭解命令， 則會傳回未知的命令 訊息。

0: kd> .exdicmd target:0:Foo
Target command response: unknown command: 'Foo'

.outmask

如果未顯示輸出，請檢查輸出遮罩是否設定為使用 .outmask 顯示詳細資訊輸出（控制輸出遮罩）。

如果調試程式未以詳細資訊模式啟動，可以使用來設定 .outmask 7FF.outmask。

備註

如需設定 EXDI 調試程式連線的詳細資訊，請參閱設定 EXDI 調試程式傳輸。

共用方式為