KISS Fuzzer Documentation

Note

Quick Navigation: Jump to Getting Started | Hardware | Software | API Reference | Tutorials | Development | Troubleshooting

KISS Fuzzer is a compact, handheld JTAG/SWD fuzzing and exploitation tool designed for embedded security research and hardware analysis.

Documentation

• Getting Started
  • Prerequisites
  • Initial Setup
  • First JTAG Operation
  • Web Interface Usage
  • Next Steps
• Hardware Reference
  • System Architecture
  • JTAG/SWD Interface Specifications
  • Detailed Pin Assignments
  • Power Specifications
  • Power System
  • Physical Specifications
  • Electrical Characteristics
  • Expansion Options
  • Comprehensive Pin Configuration & GPIO Mapping
• Software Architecture
  • System Overview
  • Core Components
  • Task Architecture
  • Memory Management
  • Error Handling
  • Configuration Management
  • Security Considerations
  • Performance Optimization
  • Detailed System Architecture
• API Reference
  • Design Philosophy
  • Display System API
  • JTAG Engine API
  • Crash Detection API
  • REST API Endpoints
  • Error Codes
  • Configuration Constants
  • Development & Testing
• Tutorial Guide
  • Tutorial 1: Basic Device Identification
  • Tutorial 2: Memory Dumping
  • Tutorial 3: Power Glitch Attacks
  • Tutorial 4: Web Interface Usage
  • Tutorial 5: Custom Protocol Implementation
  • Advanced Tips
• Development Guide
  • Development Environment Setup
  • Project Structure
  • Coding Standards
  • Adding New Features
  • Testing Framework
  • Build System
  • Debugging
  • Performance Optimization
  • Release Process
  • Contributing Guidelines
  • Code Quality and Linting
• Troubleshooting Guide
  • Device Boot Problems
  • JTAG Interface Issues
  • Display Problems
  • Wi-Fi Connectivity Issues
  • Storage Issues
  • Power Management Issues
  • Performance Issues
  • Error Code Reference
  • Getting Help

Overview

KISS Fuzzer (Keep It Simple, Silly) provides a portable solution for JTAG and SWD interface analysis. The device combines hardware accessibility with advanced features, making it suitable for both beginners and experienced security researchers.

Key Features

Display System - 240×64 OLED banner display provides real-time status and scan results with clear visibility.

User Interface - 5-way joystick navigation offers intuitive menu control without complex key combinations.

Power Management - Integrated Li-ion battery with USB-C charging enables extended field use.

JTAG/SWD Interface - High-speed interface supports up to 10 MHz operation with multiple protocol compatibility.

Remote Access - Built-in Wi-Fi enables web-based control and monitoring for automated testing scenarios.

Data Logging - MicroSD card storage provides comprehensive logging and result archival capabilities.

Voltage Compatibility - Configurable voltage levels support targets from 1.8V to 5V with automatic level shifting.

System Architecture

The KISS Fuzzer architecture consists of integrated hardware and software components designed for reliability and extensibility:

graph TB
    A[Target Device] --> B[JTAG/SWD Interface]
    B --> C[KISS Fuzzer Core]
    C --> D[Display System]
    C --> E[Wi-Fi Interface]
    C --> F[Storage System]
    
    D --> G[Local Control]
    E --> H[Remote Access]
    F --> I[Data Archive]
    
    style A fill:#ff6b6b
    style C fill:#4ecdc4
    style G fill:#95e1d3
    style H fill:#95e1d3
    style I fill:#95e1d3

The system processes JTAG/SWD communications through dedicated PIO hardware, displays real-time status information, and maintains comprehensive logs of all operations.

Getting Started

New users should begin with the Getting Started Guide which covers initial setup, basic connections, and first scans.

For detailed technical specifications, refer to the Hardware Guide.

For troubleshooting common issues, consult the Troubleshooting Section. B –> H C –> H D –> H

## Getting Help

- **GitHub Issues**: Report bugs and request features
- **Documentation**: Comprehensive guides and API reference
- **Community**: Join our Discord for real-time support

```{admonition} Safety Notice
:class: warning

KISS Fuzzer is designed for authorized security testing and educational purposes only. 
Always ensure you have permission to test target devices and comply with local laws.