Code2Chip AI

Understand code. Debug hardware. Deliver reliability.

Firmware vs silicon verification with context-aware LLM diagnostics for ESP32 — directly inside VS Code / Cursor.

Version 0.2 is the current customer UI (Check board, Verify flash, Find patterns, Ask AI, sessions). An authorized key is required to unlock core features after install.

What’s new in 0.2

• Check board — live diagnosis against your sketch and chip
• Verify flash — compare build binaries to on-chip flash (Match / Mismatch)
• Find patterns — recurring issues across saved evidence
• Ask AI — chat with diagnosis + flash context
• New session / Sessions — fresh start and restore prior work
• Settings — LLM provider (Gemini, OpenAI, Anthropic, xAI Grok, Ollama-compatible); API keys stay on your machine

Classic 0.1.0 (free)

The previous classic UI remains available as 0.1.0 under Marketplace Version History, or in VS Code/Cursor: extension → gear → Install Another Version… → 0.1.0.

Quick start (0.2)

1. Install Code2Chip AI from the Marketplace (latest = 0.2).
2. Open the Code2Chip sidebar.
3. Enter your authorized key in Settings and Save (unlocks Check board, Verify flash, Ask AI, Find patterns).
4. Run Code2Chip AI: Setup Runtime once (~5–15 min, needs internet) if prompted.
5. Connect your ESP32 via USB → Connect board.
6. Select a sketch folder → Check board; optionally Verify flash with a build folder.
7. Add your own LLM API key in Settings (not shared with other users).
8. Use Ask AI, Find patterns, or New session as needed.

Prerequisites

OpenOCD is bundled for Windows (win32-x64) in this 0.2 release. Mac/Linux live board use needs a system OpenOCD (or a later package with those binaries). The RAG index is built on first setup from bundled document chunks (not a full Chroma dump inside the VSIX).

Commands

Panels (0.2)

Classic Assistant / Live Hardware / Diagnostics panels remain available when classic UI is enabled in settings.

Authorized key

0.2 installs publicly but core actions stay locked until you enter the authorized key in Settings. Unlock is stored only in this machine’s VS Code/Cursor secrets.

LLM API key

Open Settings (gear). Paste your provider API key and Save. Keys are stored in Secret Storage on your machine — they are not embedded in the extension package and are not shared with other installs.

Supported: Gemini, OpenAI, Anthropic, xAI Grok, OpenAI-compatible (e.g. Ollama).

OpenOCD

Use Connect board / Start OpenOCD before live reads. Override paths under code2chip.openocd.* if needed.

Windows

Bundled OpenOCD is included. Ensure the ESP32 USB driver is installed if USB-JTAG fails.

macOS / Linux

Bundled OpenOCD is not included in the current 0.2 Windows-focused packages. Install OpenOCD on the machine (or point code2chip.openocd.bin at your binary). On Linux you may also need udev rules / plugdev for Espressif USB-JTAG.

Troubleshooting

Documentation

Detailed UI reference: see docs/USER_GUIDE.md in the product repository (or ask your admin for the company copy).

License

Proprietary — see LICENSE.md in the extension package. Marketplace install is public; use of 0.2 core features requires an authorized key.

Support

ritish143khichi@gmail.com

Access / authorized key

To receive an authorized key for Code2Chip AI 0.2, contact:

ritish143khichi@gmail.com