## 1. Project Introduction

The **Pocket IC Tester & Debugger** is a compact, open-source hardware tool designed for electronics hobbyists, field engineers, and makers. When prototyping or troubleshooting circuits, dragging out a bulky bench oscilloscope or writing custom test firmware for every simple check can be tedious. This pocket-sized device plugs directly into a PC via USB-C and acts as a versatile multi-protocol bridge, protocol analyzer, and debugging assistant.

## 2. Key Features & Capabilities

* **USB-C Interface:** Modern, reversible connection supporting power delivery and high-speed Virtual COM Port (CDC) or HID communication with a host PC.

* **Multi-Protocol Support:** Native or bit-banged hardware handling for major communication standards:

 * **I²C** (Sensor polling, EEPROM reading/writing)

 * **SPI** (Flash memory, display modules, and peripheral configuration)

 * **UART** (Serial terminal debugging, baud rate sniffing)

 * **GPIO & 1-Wire** (Digital pin toggling, temperature sensors like DS18B20)

* **Local OLED Display:** An integrated 0.96-inch OLED screen displays live status, pin voltage states, active protocols, and real-time sensor data without constantly looking at a PC monitor.

* **Flexible IC Connectivity:** Outfitted with standard breakout headers, test clip points, and an optional **ZIF (Zero Insertion Force) or DIP socket** for rapid insertion and testing of common ICs.

* **Ultra-Portable Form Factor:** Designed to fit easily inside a laptop bag or sit comfortably on a crowded electronics workbench.

## 3. Hardware Architecture & Design

* **Microcontroller Core:** Built around a powerful and cost-effective MCU (such as the **RP2040** or **STM32F103/STM32G0**) featuring native USB peripherals and generous processing headroom.

* **Power & Protection:** Powered directly via 5V USB-C, with an onboard 3.3V low-dropout (LDO) voltage regulator and ESD protection diodes on all active test channels to prevent accidental short circuits or spikes.

* **User Interface Layout:** Features tact switches for menu navigation alongside the I²C OLED screen, ensuring standalone usability in the field.

## 4. Software & How to Use

1. **Firmware Setup:** Clone the open-source firmware repository, build the project using standard toolchains (like VS Code / PlatformIO or Arduino IDE), and flash it onto the MCU via USB.

2. **PC Connection:** Plug the device into your computer; it will instantly enumerate as a serial/HID device.

3. **Target Testing:** 

  * Connect your target IC (e.g., a BME280 environmental sensor or an AT24C02 EEPROM) to the corresponding protocol pins.

  * Use the onboard OLED menu to run quick autonomous diagnostics, or launch Python scripts on your PC to automate multi-byte reads/writes and protocol logging.

## 5. Future Roadmap

* Add support for SWD/JTAG debugging bridges.

* Expand host-side GUI tool support for cross-platform data visualization.

* Open-source all KiCad design files, 3D enclosures, and firmware source code.