The error message "debug port fail" is returned when the TDO response is different from the expected one. Please follow the steps described below. If the error persists, then send the result of your diagnosis to firstname.lastname@example.org
The same disagnosis also applies for the error messages "debug port time-out" and "subcore communication time-out".
Start-up script / CPU selection
- Check first if there is a start-up script available for the used chip/board. If yes, use this script. Search also for a script under https://www.lauterbach.com/scripts.html
- If you don’t find a start-up script, contact email@example.com to verify if a script is available. If a start-up script is available, read the prerequisites at the start of the script or readme.txt (if available).
- Please check also if the used CPU selection is correct. If you do not find a CPU selection for the used chip, check if the processor is supported by TRACE32 using the “Chip” search on the Lauterbach website or contact firstname.lastname@example.org.
Next things to check
- If the "debug port fail" error occurred after a SYStem.Up command, test if SYStem.Mode Attach then Break delivers the same error. If you don't get an error, then the SYStem.Up issue is probably related to reset options.
- The target might be in an unrecoverable state. Re-power the target and retry.
- In SMP setups, test if the connection works after assigning only the first core (CORE.ASSIGN 1). For some chips, the first core is not the boot core. This is especially valid for big.LITTLE systems. Try to connect using the second core (CORE.ASSIGN 2). If connection is possible with the used core, then the other cores have to be activated by the target code.
- Try to connect with a low JTAG frequency (e.g. test with SYStem.JtagClock 100Khz) then optimize the JTAG clock if connection with low frequency is possible. If ARM7, ARM9 or ARM11 is used, try to connect with SYStem.JtagClock RTCK
- Check if the correct debug port is selected (JTAG / SWD / cJTAG): SYStem.CONFIG DEBUGPORTTYPE
Detect the Daisy Chain (JTAG/cJTAG only)
Execute SYStem.DETECT DaisyChain in Down mode and check the AREA window. If the detection fails, please re-power the target and retry with SYStem.Option EnRest OFF.
If the daisy chain can be correctly detected, then the PRE- / POST-settings are printed in the AREA window:
The detection should discover here a device called "ARM JTAG-DP DAP".
Check in this case if the DAP PRE- and POST-settings under SYStem.CONFIG /JTAG are correct:
In case the daisy chain cannot be detected, then an error is returned and/or the message “TDO stays constantly LOW/HIGH” is printed to the AREA window:
If the DAP PRE and POST settings are correct and the problem persistsm go to "Try to access the DAP".
- Are the jumper/switch settings correct? Check the target schematics and documentation
- Verify the physical connection by checking the target schematics: are the debug signals correctly connected to the debug header?
- Verify the signal levels.
- nTRST should not be connected to GND. If the signal is pulled down, it must be ensured that the debugger has a connection to TRST and can pull it up. Especially with connectors that allow two connections: nTRST and nTRST pulldown (MIPI20D, MIPI34, MIPI60), it is possible, if adapters are used, that only one (the wrong) signal is connected.
- Serial resistors for TMS/TDI/TCK should be avoided. A 22 or 47 Ohm serial resistor (only) for TDO is OK.
- Verify if JTAG signals are multiplexed. Check in this case if the correct mode is selected.
- Verify if the correct target power supply is used
- check the voltage properties of the power supply and the target
- cross-check with a different power supply. The used target power supply might be defective.
- If there is a watchdog that needs to be deactivated (refer to chip/target documentation).
- If nothing of these helps, make a scope plot of the signals TDI/TDO/TMS/TCK when doing a SYStem.Up / SYStem.Mode Attach.
- If you don’t see any activity on one of these signals, then you need to check the target schematics.
- Signal reflections, e.g. caused by stubs, could cause a wrong detection (multi-clocks) of the TCK signal on the chip side.
Try to access the DAP
Continue with this step only if the JTAG detection is successful.
- Set the correct CPU selection
- Execute the script access_dap.cmx
- Check the AREA window (menu View > Message Area)
If accessing the DAP is successful, continue with "Try to access the core base".
Try to access the core debug base
Continue with this step only if the JTAG detection is successful and the DAP can be successfully accessed.
Re-power the target and execute the following commands in a script:
Data.Set (COREBASE()+0xFB0) %Long 0xC5ACCE55
Data.dump (COREBASE()+0xF00)++0xFF ;
PRINT %ERROR "It seems the core base is not configured, see SYStem.CONFIG.COREDEBUG.Base"
Data.dump window displays data
Error returned or Data.dump window displays ???????
- Core might be kept in reset, has no power, no clock, or is secured.
- Core might be in power saving (sleep) mode.
- A watchdog might be enabled and accessing the target after booting is not possible. Check the target documentation.
- If the CoreSight settings are done in a script using the SYStem.CONFIG commands, then the core base address might be wrong. Check processor documentation if available.