Overview

The dtc_conf is a utility installed with Code Composer Studio and provides access to the Debug Test Controller (DTC) of XDS560v2-based Debug Probes.

The dtc_conf is invoked from the command line and must be launched from its install directory, typically located at:

<CCS_INSTALL_DIR>/ccs/ccs_base/common/uscif

Usage

All the features of the utility may be used with a XDS560v2 connected via either USB or Ethernet connections. The general command syntax is shown below with required parameters enclosed by angled brackets <>, and optional parameters enclosed by square brackets [].

dtc_conf <command> <adapter> <address> [options]

  • command: the command to perform: get | set | restore | update | boot
    • get the current values of DTC configuration variables
    • set the DTC configuration variables
    • restore the default values of the DTC configuration variables
    • update the DTC firmware
    • reboot the DTC
  • adapter: the IO adapter: bh560v2u | bh560v2e | sd560v2u | sd560v2e
    • bh560v2u for Blackhawk USB
    • bh560v2e for Blackhawk Ethernet
    • sd560v2u for Spectrum Digital USB
    • sd560v2e for Spectrum Digital Ethernet
  • address: the DTC address:
    • For USB, the address is 0 to N-1, where N is the number of XDS560v2 Debug Probes connected to the host.
    • For Ethernet, it is the network IP address of the XDS560v2 Debug Probe.
  • options: optional arguments depending on the command. Refer to the Examples sections and Options section.
    • Alternatively, use the help command (-h) to get a complete list of options: dtc_conf -h

Examples

The examples below are for a USB connection. For Ethernet, simply replace the adapter value from sd560v2u to sd560v2e and the address from 0 to the network IP address of the XDS560v2.

Get the current values for all the DTC variables

C:\ti\ccs1010\ccs\ccs_base\common\uscif> dtc_conf get bh560v2u 0

addrConf=:55756
addrIo=:55755
boardRev=2
dtcName=none
epkRev=5.0.573.0
fpgaRev=1.54
ipAddress=none
ipBroadcast=none
ipClient=none
ipConfig=dhcp
ipGateway=none
ipHwaddress=none
ipLeasehours=none
ipLeasetime=none
ipMtu=none
ipNetmask=none
ipNetwork=none
ipPointopoint=none
productClass=XDS560V2
productName=Blackhawk XDS560v2 System Trace
safeMode=false
serialNum=00:0F:D2:00:00:0A
swBuildTime=Mar 30 2012 17:37:41
swRev=5.0.573.0
time=none
vendorName=Blackhawk

Get a specific value

This returns the value of any of the variables shown above.

C:\ti\ccs1010\ccs\ccs_base\common\uscif> dtc_conf get bh560v2u 0 serialNum

Update the firmware

This updates the firmare of the DTC. It is rarely used and should be run only under advise of the manufacturer.

C:\ti\ccs1010\ccs\ccs_base\common\uscif> dtc_conf update sd560v2u 0 .\sd560v2_updates\sd_xds560v2_firmware_2.2.0.5

Warning:

It is not advisable to update the firmware through an Ethernet connection. Unplug the ethernet cable and power cycle the XDS560v2 before updating the firmware.

Restore the default values

This resets all variable values to their default settings.

C:\ti\ccs1010\ccs\ccs_base\common\uscif> dtc_conf restore sd560v2u 0

Safe mode

To take the XDS560v2 out of safe mode (LED's flashing), issue the following sequence of commands:

C:\ti\ccs1010\ccs\ccs_base\common\uscif> dtc_conf set sd560v2u 0 safeMode=false C:\ti\ccs1010\ccs\ccs_base\common\uscif> dtc_conf boot sd560v2u 0

Set a unique name

Setting a unique name for the XDS560v2 helps prevent confusion when multiple Debug Probes are on a network.

C:\ti\ccs1010\ccs\ccs_base\common\uscif> dtc_conf set sd560v2e 192.168.0.224 dtcName="MyProbe" C:\ti\ccs1010\ccs\ccs_base\common\uscif> dtc_conf boot sd560v2e 192.168.0.224

The command above uses an example IP address (192.168.0.224). Change this address to match what is configured in your environment.

Check for conflicts

To check if another user is using the XDS560v2 and what their IP address is, issue the following command:

C:\ti\ccs1010\ccs\ccs_base\common\uscif> dtc_conf get sd560v2e 192.168.0.224 ipClient

The command above uses an example IP address (192.168.0.224). Change this address to match what is configured in your environment.

Reboot

To reboot the XDS560v2 after an operation or to simply try to recover connections, issue the following comand.

C:\ti\ccs1010\ccs\ccs_base\common\uscif> dtc_conf boot sd560v2u 0

Notes:

This command is particularly useful for remote Ethernet connections Allow 1-1/2 minutes before retrying the connection

View or set the IP address

The XDS560v2 comes configured from factory to use DHCP and therefore its IP address is leased automatically. To confirm if the mode is properly set to DHCP, check if the value of the variable ipConfig is set to dhcp by issuing the following command:

C:\ti\ccs1010\ccs\ccs_base\common\uscif> dtc_conf get bh560v2u 0 ipConfig

To confirm the DHCP leased IP address, simply issue the get command below:

C:\ti\ccs1010\ccs\ccs_base\common\uscif> dtc_conf get bh560v2u 0 ipAddress

Note:

In order for this command to return a valid address, it is required to have both USB and Ethernet cables connected.

If DHCP is not available, then it is necessary to set a static IP address.

The static IP address and other network configurations must be provided by the IT administrator of your organization. This usually requires supplying the administrator with the MAC address of the Debug Probe, which is shown in the debug probe sticker. This information can also be obtained by issuing the get command with the serialNum option.

C:\ti\ccs1010\ccs\ccs_base\common\uscif> dtc_conf get bh560v2u 0 serialNum

The IT administrator should report back the IP address, the host name, the netmask and the gateway address of the network.

Connect only the USB cables (the ethernet cable must be disconnected) and set the parameters below with the values supplied by the administrator:

Name: (LabStation01.ti.com as an example)

C:\ti\ccs1010\ccs\ccs_base\common\uscif> dtc_conf set bh560v2u 0 dtcName="LabStation01.ti.com"

IP Address: (192.168.0.224 as an example)

C:\ti\ccs1010\ccs\ccs_base\common\uscif> dtc_conf set bh560v2u 0 ipConfig=192.168.0.224

IP Netmask: (255.255.254.0 as an example)

C:\ti\ccs1010\ccs\ccs_base\common\uscif> dtc_conf set bh560v2u 0 ipNetMask=255.255.254.0"

IP Gateway: (129.168.0.1 as an example)

C:\ti\ccs1010\ccs\ccs_base\common\uscif> dtc_conf set bh560v2u 0 ipGateway=192.168.0.1"

After that, power down the Debug Probe, connect the Ethernet cable and then power up again. Wait until it finishes the boot process to verify the configurations.