# m4-firmware

**Repository Path**: iwinyeah/m4-firmware

## Basic Information

- **Project Name**: m4-firmware
- **Description**: Murphy M4 / Fengyan 阅读器 导自https://github.com/einklover/m4-firmware
- **Primary Language**: C++
- **License**: MIT
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

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

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Murphy M4 / Fengyan 阅读器 — 简易使用介绍

ESP32-S3 墨水屏阅读器固件（480×800 E-Ink）。通过 SD 卡在原厂系统中一键升级，无需电脑刷机。

## 一、SD 卡准备

把以下内容放入 SD 卡（FAT32）：

```
SD 卡根目录/
├── firmware.bin      ← 固件文件（本仓库构建产物）
├── fonts/            ← 字体文件夹（放入 NotoSansCJKsc.epdfont 获得完整中文）
└── app/              ← 插件文件夹（放入 fanqie.m4x、weread.m4x、jjwxc.m4x）
```

> 没有 fonts/ 也能用（内置常用中文字体子集）；完整字体建议放入。

## 二、升级固件

1. 插入 SD 卡，开机进入**原厂系统**
2. 打开原厂系统的「**升级**」入口，选择 SD 卡中的 `firmware.bin`
3. 升级完成后固件**自动写入另一分区（APP1）并打开**——即进入本阅读器系统

之后每次想要更新：把新 `firmware.bin` 复制到 SD 卡根目录，重复上述步骤即可。

## 三、连接 Wi-Fi

在系统的「**网络管理 / Wi-Fi 设置**」中连接家里的无线网络（用于获取书籍内容）。

## 四、安装插件

在「**应用 / 安装**」入口，从 SD 卡 `app/` 文件夹中选择安装两个插件：

- `fanqie.m4x` — 番茄小说
- `weread.m4x` — 微信读书
- `jjwxc.m4x` — 晋江文学（分类浏览 / 目录 / 免费章直读 / VIP 章扫码登录后阅读）

## 五、插件使用方法

### JJWXC（晋江文学）

1. 书架 → **扫码登录**：用「晋江小说阅读」App（Android≥5.0.9.2 / iOS≥4.2.2）扫一扫
2. **分类浏览** 找书（古言/现言/纯爱等 70+ 频道）或 **今日限免**
3. 打开书籍 → 目录 → 章节：
   - 免费章直接阅读
   - VIP 章需登录且账号已购；内容经 WAP 页获取，首次打开稍慢

### Fanqie（番茄小说）

1. 书架 → 第一行「**分类浏览**」
2. 选择分类（都市 / 玄幻 / 出版…）进入书单
3. 底部左右键翻页（已看过的页秒开），点书打开目录
4. 点章节进入阅读：右半屏下一页、左半屏上一页、章节末尾自动加载下一章
5. 无需账号

### WeRead（微信读书）

1. 打开插件 → 按提示**扫码登录**（微信读书网页版二维码）
2. 书架显示已购/在读书籍，打开即读
3. 章节自动缓存，支持离线阅读
4. 登录态自动续期，无需反复扫码

## 六、切换回原固件

在**系统设置**中选择「**切换系统 / 返回原固件**」即可切回原厂系统（不擦除任何数据）。随时可以再升级回来。

## 七、常见问题

| 问题 | 解决 |
|---|---|
| 升级后黑屏/无法启动 | 断电重启；仍异常则切换回原固件 |
| 插件安装提示失败 | 重试一次；提示"已安装"即成功 |
| 打不开章节 | 确认已连 Wi-Fi |
| 中文字体发虚/缺字 | 放入 fonts/ 字体后重新安装升级 |
| 设备无响应 | 断电重启 |

## 构建（开发者）

```bash
pio run -e murphy_m4     # 产物：.pio/build/murphy_m4/firmware.bin
```

源码结构：`src/`（固件主源码）、`lib/`（自研组件）、`scripts/`（刷写/调试工具）。

## License

MIT，见 [LICENSE](LICENSE)。