# XiaoMiao

**Repository Path**: merisy/XiaoMiao

## Basic Information

- **Project Name**: XiaoMiao
- **Description**: 小喵掌机固件
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-08-04
- **Last Updated**: 2026-08-04

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 小喵固件仓库

本仓库用于发布小喵系列固件，包含小喵固件管理器以及多款游戏和工具固件。

## 目录结构

```
Firmware/
├── 小喵固件管理器.0x0000.bin   # 固件管理器（主程序，需烧录到 Flash）
├── 游戏/                        # 游戏类固件（放入 TF 卡加载）
└── 工具/                        # 工具类固件（放入 TF 卡加载）
assets/                          # 游戏预览图片
```

## 烧录小喵固件管理器

`Firmware/小喵固件管理器.0x0000.bin` 需要使用 ESP 官方下载工具烧录。

1. 下载并打开 [ESP 官方烧录工具（flash_download_tool）](https://docs.espressif.com/projects/esp-test-tools/zh_CN/latest/esp32/production_stage/tools/flash_download_tool.html)。
2. 选择对应的芯片型号和烧录模式。
3. 加载 `Firmware/小喵固件管理器.0x0000.bin` 文件。
4. **烧录地址填写 `0x0000`**。
5. 设置好串口和波特率后点击开始烧录。

烧录完成后，设备启动即可进入小喵固件管理器界面。

## 加载游戏和工具固件

`Firmware/游戏/` 和 `Firmware/工具/` 目录下的 `.bin` 文件**不要直接烧录到 Flash**，而是通过 TF 卡加载：

1. 准备一张 TF 卡（FAT32 格式）。
2. 在 TF 卡根目录下创建名为 `XIAOMIAO` 的目录。
3. 将所需的游戏或工具 `.bin` 固件文件拷贝到 `XIAOMIAO` 目录下。
4. 将 TF 卡插入设备，启动后小喵固件管理器会自动从此目录扫描并加载固件。

```
TF卡根目录/
└── XIAOMIAO/
    ├── 俄罗斯方块.bin
    ├── 坦克大战1990.bin
    ├── 扫雷.bin
    ├── 空战.bin
    └── WEB文件管理器.bin
```

## 游戏固件预览

下表列出了 `assets/` 目录中的预览图片与 `Firmware/游戏/` 中游戏固件的对应关系。

| 游戏固件 | 预览图片 | 说明 |
| --- | --- | --- |
| `Firmware/游戏/俄罗斯方块.bin` | ![俄罗斯方块](assets/tetris.png) | 经典方块消除游戏 |
| `Firmware/游戏/坦克大战1990.bin` | ![坦克大战](assets/tank1990.png) | 坦克大战游戏 |
| `Firmware/游戏/扫雷.bin` | ![扫雷](assets/minesweeper.png) | 经典扫雷游戏 |
| `Firmware/游戏/空战.bin` | ![空战](assets/thetawave.png) | 空战射击游戏 |

## 工具固件

| 工具固件 | 说明 |
| --- | --- |
| `Firmware/工具/WEB文件管理器.bin` | 通过浏览器管理 TF 卡内文件的 Web 工具 |