Skip to content

ChisBread/ChisLink

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

8 Commits
 
 
 
 
 
 

Repository files navigation

ChisLink

A full-function portable cartridge programmer designed for GBA

Agents

Overview

ChisLink is a powerful GBA (Game Boy Advance) portable cartridge programmer that supports reading/writing various cartridge types, save management, ROM backup, and more. The device is compact and portable, featuring WiFi connectivity.

Key Features

  • 🎮 Multi-cartridge Support - Compatible with ChisFlash, ChisMBC5(adapter required), genuine cartridges, and some bootleg cartridges
  • 💾 Smart Save Management - Auto-detect save types with backup and restore functionality
  • Flashcart Programming - Change the game on the flashcart anytime, anywhere!
  • 🗂️ File System - File management capabilities.
  • 📡 WiFi Connectivity - Wireless file transfer and remote management.

Supported Cartridge Types

Type Description Save Support Programming
ChisFlash Compatible cartridges SRAM/Flash/EEPROM
ChisMBC5 MBC5 cartridges (adapter required) SRAM/Flash/EEPROM
Cartridge Genuine cartridges Database-based identification
Bootleg Bootleg cartridges Bootleg's Batteryless-SRAM is not fully supported, and it requires constant power restart (insert ChisLink in the game) ⚠️

Quick Start

Preparation

  1. Prepare a TF card (MBR partition table, single FAT32 partition format)
  2. Ensure signature.bin file exists in /config directory
  3. Important: Backup signature.bin file to a secure location

Device Startup

  • No cartridge: Auto-launch Link or custom App
  • With cartridge: Hold START+SELECT combo to boot

Basic Operations

  • SELECT - Switch menu view (multi-cart mode)
  • A - Select game for operations
  • START - Toggle file extension display / Enable overclock
  • L+R - View hardware details
  • D-pad - Navigate pages

File System Structure

Root/
├── saves/        # Save files directory
├── favorites/    # Favorites folder
├── config/       # System configuration
│   ├── signature.bin  # License file (required)
│   └── web.conf      # WiFi configuration
└── dumps/        # ROM dump directory

WiFi Configuration

Default Settings

  • SSID: Bach
  • Password: chisbread

Advanced Configuration (/config/web.conf)

wifi_disable=0          # Disable WiFi
wifi_lazy_connect=1     # Recommended (reduces power consumption)
wifi_max_power_adjust=0 # Power adjustment range (-16~16)

Firmware Updates

  1. Connect to computer via USB
  2. Visit esptool-js page
  3. Select USB JTAG/serial to complete flashing

Safety Precautions

⚠️ Important Reminders:

  • Verify TF card contains correct signature.bin before firmware flashing
  • Missing this file will brick the device
  • Regularly backup configuration files

Compatibility

  • ✅ Supports all GBA console models
  • ✅ Compatible with ChisFlash MBC5 cartridges
  • ❌ GB Micro does not support overclocking
  • ⚠️ ChisMBC5 requires adapter

Technical Support

For compatibility issues, please provide:

  • Hardware details (press L+R to view)
  • Cartridge model and PCB photo
  • Specific error symptoms

Roadmap

  • 🔮 Self-hosted Cloud Save - Support for self-deployed cloud save functionality
  • 🌐 ChisLink Internet Multiplayer Protocol - Implementation of internet-based multiplayer protocol for ChisLink devices

Credits


📖 Detailed Manuals: 中文版 | English

About

🎮Backup, restore save, dump ROM, and program Flashcarts via GBA link port

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published