XDS110 MCP Server

# Linux Ready - XDS110 Project Status ## ✅ Repository Organized for Linux Work All macOS-specific work has been moved to `macos_work/` directory to keep the main project clean for Linux development. ## What's Ready for Linux ### Hardware Information - **Debug Probe**: XDS110 (Serial: LS4104RF) - **Target MCU**: TMS320F280039C (C2000 series DSP) - **Uptime Counter**: Memory address `0x00000C00` (CPU Timer 0) ### Target Commands for Linux Once connected to a Linux machine, these should work: ```bash # Basic connection test dslite --config legacy_ti_debugger/TMS320F280039C_LaunchPad.ccxml --list-cores # Read uptime counter (32-bit value) dslite --config legacy_ti_debugger/TMS320F280039C_LaunchPad.ccxml \ --memory-read 0x00000C00 4 # Calculate uptime in seconds # Formula: uptime_seconds = register_value / 100000000 ``` ### Project Structure ``` XDS110_MCP_server/ ├── legacy_ti_debugger/ # Working TI DSS scripts │ ├── TMS320F280039C_LaunchPad.ccxml # CCXML config │ └── js_scripts/ # DSS JavaScript files ├── xds110_mcp_server/ # MCP server framework ├── src/ # Generic CCS support ├── configs/ # Configuration files ├── scripts/ # Linux-compatible scripts └── macos_work/ # All macOS-specific work ├── COMPLETE_SITUATION_NOTES.md ├── Docker files & scripts └── USB bridge solutions ``` ### Key Files for Linux - `legacy_ti_debugger/TMS320F280039C_LaunchPad.ccxml` - Hardware configuration - `xds110_mcp_server/` - Complete MCP server implementation - `test_mcp_server.py` - Basic functionality tests - `CLAUDE.md` - Updated project guidance ## Expected Linux Workflow 1. **Install TI Tools**: ```bash # Install Code Composer Studio or UniFlash # Available at: ti.com/tool/CCSTUDIO ``` 2. **Connect XDS110**: Plug in the same hardware (Serial: LS4104RF) 3. **Test Connection**: ```bash dslite --config legacy_ti_debugger/TMS320F280039C_LaunchPad.ccxml --list-cores ``` 4. **Read Uptime**: ```bash # This should return a 32-bit hex value dslite --config legacy_ti_debugger/TMS320F280039C_LaunchPad.ccxml \ --memory-read 0x00000C00 4 ``` 5. **Start MCP Server**: ```bash python test_mcp_server.py # Test in mock mode python -m xds110_mcp_server # Run with hardware ``` ## What Was Learned on macOS - XDS110 hardware is perfect (detected correctly) - Uptime counter is definitely at 0x00000C00 - All software tools are properly configured - macOS has USB driver limitations (Error -260) - Docker USB/IP bridge was partially successful - Complete debugging infrastructure is ready ## Next Steps 1. Connect XDS110 to Linux machine 2. Install TI tools (CCS/UniFlash) 3. Test basic connection 4. Read the uptime counter at 0x00000C00 5. Deploy the MCP server for LLM debugging The groundwork is complete - Linux should "just work" where macOS failed!