6. Nuclei OpenOCD

• 6.1. OpenOCD Usage Guide
  • 6.1.1. Table of Contents
  • 6.1.2. Tool Installation and Environment Setup
  • 6.1.3. Repositories and Documentation
  • 6.1.4. Getting Started
    • 6.1.4.1. Checking OpenOCD Version
    • 6.1.4.2. Running OpenOCD
  • 6.1.5. Nuclei-Specific Features
    • 6.1.5.1. CPU Information Display
    • 6.1.5.2. NUSPI (Nuclei SPI) Driver
    • 6.1.5.3. Custom Driver with OpenFlashLoader
    • 6.1.5.4. Nuclei-Specific CSRs
    • 6.1.5.5. Embedded Trace (ETrace) Support
    • 6.1.5.6. Debug Map Feature
    • 6.1.5.7. Cross-Trigger Interface (CTI)
    • 6.1.5.8. Debug with Hypervisor
    • 6.1.5.9. Reset and Halt Command
    • 6.1.5.10. FTDI nSCAN1 Mode Command
  • 6.1.6. Configuration File Overview
    • 6.1.6.1. Debugger Speed Configuration
    • 6.1.6.2. Debugger Interface Configuration
    • 6.1.6.3. Debugger Mode Configuration
    • 6.1.6.4. JTAG Link Configuration
    • 6.1.6.5. Work Area Configuration
    • 6.1.6.6. NOR Flash Configuration
    • 6.1.6.7. Debugger Connection Specification
    • 6.1.6.8. Debugging Service Ports Configuration
    • 6.1.6.9. Semihosting Support
    • 6.1.6.10. Target Defer Examine
    • 6.1.6.11. Segmentation Fault Caused by Missing Configuration in Hummingbird-Debugger-Kit
  • 6.1.7. Low-Cost Debugger Solution
  • 6.1.8. Frequently Asked Questions
  • 6.1.9. Common Problem Troubleshooting and Solutions
    • 6.1.9.1. Reading DTM Registers (idcode/dtmcs) using OpenOCD
  • 6.1.10. Changelog
    • 6.1.10.1. Version 2026.10
    • 6.1.10.2. Version 2025.10
    • 6.1.10.3. Version 2025.02
  • 6.1.11. Known Issues
    • 6.1.11.1. custom flash driver memory out-of-bounds bug in the 2025.10 openocd
    • 6.1.11.2. Multiple vid_pid matching failure bug in the 2025.10 openocd
    • 6.1.11.3. First connection basic_cpuinfo read failure bug in the 2025.10 openocd
    • 6.1.11.4. tracedecoder decoding error on Chinese-locale Linux systems bug in the v0.9.0 tracedecoder at 2025.10
    • 6.1.11.5. tracedecoder runtime library mismatch on Linux systems bug in the v0.9.0 tracedecoder at 2025.10
    • 6.1.11.6. tracedecoder may lose a few instructions before the sync packet bug in the v0.9.0 tracedecoder at 2025.10
  • 6.1.12. Other Debuggers
• 6.2. OpenOCD Capture Trace Data
  • 6.2.1. Table of Contents
  • 6.2.2. Tool Installation and Environment Setup
  • 6.2.3. ETrace Version Overview
  • 6.2.4. Etrace Command Reference
    • 6.2.4.1. etrace config
    • 6.2.4.2. etrace enable
    • 6.2.4.3. etrace disable
    • 6.2.4.4. etrace start
    • 6.2.4.5. etrace stop
    • 6.2.4.6. etrace dump
    • 6.2.4.7. etrace clear
    • 6.2.4.8. etrace info
    • 6.2.4.9. Preparation
    • 6.2.4.10. Usage Example
    • 6.2.4.11. Common Problem Troubleshooting and Solutions
  • 6.2.5. Trace Command Reference
    • 6.2.5.1. trace config
    • 6.2.5.2. trace start
    • 6.2.5.3. trace stop
    • 6.2.5.4. trace dump
    • 6.2.5.5. trace info
    • 6.2.5.6. Preparation
    • 6.2.5.7. Usage Example
  • 6.2.6. Common Problem Troubleshooting and Solutions
• 6.3. TraceDecoder Decoding Trace Data
  • 6.3.1. Table of Contents
  • 6.3.2. Tool Installation and Environment Setup
  • 6.3.3. Features
  • 6.3.4. Command Line Usage
    • 6.3.4.1. Basic Syntax
    • 6.3.4.2. Common Parameter Descriptions
  • 6.3.5. Usage Examples
    • 6.3.5.1. Example 1: ATB2AXI (etrace-v1.x) Instruction Trace Decode
    • 6.3.5.2. Example 2: TraceBundle Instruction Trace Decode
    • 6.3.5.3. Example 3: TraceBundle Instruction + Data Trace Decode
    • 6.3.5.4. Example 4: TraceBundle with ZCMP Extension Decode
    • 6.3.5.5. Example 5: TraceBundle with CSR and AMO Operations Decode
    • 6.3.5.6. Trace Packet Output Format Description
  • 6.3.6. Common Problem Troubleshooting and Solutions
    • 6.3.6.1. Default (etrace-v1.0) Decoding srcid Mismatch Issue
    • 6.3.6.2. Decoding Exception Scenarios for tracebundle Versions Higher than v1.1.0
  • 6.3.7. Changelog
    • 6.3.7.1. Version v1.0.0
    • 6.3.7.2. Version v0.9.0