# rc3plus

**Repository Path**: netwan/rc3plus

## Basic Information

- **Project Name**: rc3plus
- **Description**: 这个是Retro Computer 3b plus的一些驱动代码
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 2
- **Forks**: 2
- **Created**: 2025-07-01
- **Last Updated**: 2025-12-20

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# RC3Plus Retro Computer Project


RC3Plus是一个复古计算机硬件项目，包含外壳设计、电源模块、锂电池充电模块和计算模块（树莓派3b或b+）。

在决定折腾这个项目之前，我脑袋浮现出来的思路是：“不折腾”。

硬件部分尽量使用现有成熟方案，软件部分避开编译内核，为某个GCC打补丁这些让新手劝退的坑。


```
外壳：使用3D打印，不使用铝合金外壳。打样方便，不需要去工厂开孔，来回周期太长。
升压，供电：致敬Adfruit 的 PowerBoost 1000c
充电，功放：致敬多波段无线电收音机 [SAF775X Radio](https://oshwhub.com/imhhh/saf775x-radio)
键盘驱动：不使用i2c，免除编译驱动的麻烦，使用pico，基于MicroPython通用HID键盘框架KMK
屏幕：使用微雪或者兼容微雪的品牌，走DSI接口，不选择spi接口屏幕，可以免除编译LCD_SHOW那些驱动
软件部分：全部采用树莓派官方操作系统，直接支持生态内的50多个可用的OS，不需要增加任何第三方内核驱动，保证了系统的稳定性。
```


最终，只需要修改config.txt这个文件，做小量配置，即可RUN到操作系统的桌面。

用一句话评论就是：这是一台免驱的，内置鼠标，全键盘，摇杆，触摸屏，内核可无限制任意升级的linux掌上电脑。

![主板和pico2与电池](hardware/%E4%B8%BB%E6%9D%BF,pico2,%E7%94%B5%E6%B1%A02.jpg)
![键盘](hardware/%E4%B8%BB%E6%9D%BF%E8%83%8C%E9%9D%A2.jpg)
![pico2焊接后](hardware/pico%E7%84%8A%E6%8E%A5%E5%90%8E.jpg)
![安装键盘驱动](hardware/%E5%AE%89%E8%A3%85%E9%A9%B1%E5%8A%A8.jpg)

![成品图](hardware/ZIV8HmdjWHTihHhlAFE72ThJeC2ybdQc1h32JSSV.png)

## 项目概述

- **项目背景**: RC3Plus是一个复古计算机硬件项目，包含外壳设计、电源模块、锂电池充电模块和计算模块（树莓派3b或b+）。
- **目标用户**: 硬件爱好者、复古计算机玩家、DIY电子项目爱好者。
- **核心问题**: 提供一个完整的复古计算机硬件解决方案，包括驱动代码和外壳设计。

## 系统功能

- 键盘驱动：基于kmk框架，支持鼠标模拟、拖放功能。
- 电源管理：支持2A充电，采用Adfruit PowerBoost 1000c方案，最大输出4.5A。
- 外壳设计：3D打印，适用于树莓派3b/b+。

## 目录结构

```
.
├── Lvc/                  # 游戏/模拟器配置目录
├── frp/                  # 网络穿透配置
├── keyboard and mouse/   # 键盘和鼠标控制器固件
├── raspberry_pi_apps/    # 树莓派端应用程序
├── README.md             # 项目说明文档
└── dosboy.py             # DOS游戏下载工具
```

## 键盘和鼠标控制器

键盘和鼠标控制器基于Raspberry Pi Pico (RP2040)和KMK固件框架开发，实现了键盘、鼠标和游戏手柄的多功能集成。

### 主要特性

1. **多功能键盘**
   - 7行10列矩阵键盘布局
   - 支持基础按键和功能键（F1-F12等）
   - 支持多层按键映射

2. **模拟鼠标控制**
   - 通过摇杆控制鼠标移动
   - 支持鼠标左键、右键点击
   - 支持鼠标滚轮操作

3. **游戏手柄模式**
   - 可切换至游戏手柄模式
   - 摇杆控制游戏手柄的模拟摇杆

4. **模式切换**
   - 支持在鼠标模式和游戏手柄模式之间切换
   - 通过Fn+M组合键切换模式

### 键盘布局

详细键盘布局请参考 [keyboard and mouse/readme.md](keyboard%20and%20mouse/readme.md)

## 树莓派端应用程序

项目包含专门的树莓派端应用程序，用于增强RC3Plus的功能。

详细信息请参考 [raspberry_pi_apps/README.md](raspberry_pi_apps/README.md)

## 技术规格

### 硬件平台

- **嵌入式平台**: Raspberry Pi Pico (RP2040)
- **计算模块**: 树莓派3b或b+
- **电源管理**: Adfruit PowerBoost 1000c
- **外壳**: 3D打印,stl外壳文件，见底部的讨论社区，加入讨论群，在群空间自行下载。

### 软件框架

- **开发框架**: KMK（基于CIRCUITPY）
- **操作系统**: Raspberry Pi OS
- **编程语言**: Python, CIRCUITPython

## 部署说明

1. **键盘控制器部署**:
   - 安装CIRCUITPY到树莓派Pico
   - 安装kmk框架
   - 将[keyboard and mouse](file://d:\myprojects\rc3plus\keyboard%20and%20mouse)目录中的驱动代码复制到Pico的U盘根目录

2. **树莓派端应用部署**:
   - 进入[raspberry_pi_apps](file://d:\myprojects\rc3plus\raspberry_pi_apps)目录
   - 根据具体应用的README安装依赖并运行

## 已知问题
- 由于外壳限制，pi3b需要拆除原始2个双层USB座子，换成单层，需要一定焊接基础
- U盘只读时需要冷启动
- 摇杆模拟鼠标功能受限，需配合键盘右下角的左右独立按键实现完整功能
- 拖放滚动等鼠标功能需按住特定键实现，需要双手配合操作。
- 按电源键开机后，过几秒自动关闭电源。需要在sd卡的piOS系统fat32的分区找到config.txt，在末尾增加 enable_uart=1 这样，开机几秒后，就能从GPIO 14获得一个高电平维持电源en，关机后，这个io口会变低电平，可以控制ti升压芯片物理关机。

## 原理图和pcb
立创开源硬件平台：https://oshwhub.com/adouming/retro-computer

## 3D打印模型
加入我们的QQ群：534727106 共享文件内自取

## 贡献指南
欢迎有兴趣的朋友加入我们的QQ群：534727106 进行讨论和交流。

## 讨论社区
所有讨论均在 QQ群：534727106 进行，欢迎有兴趣的朋友加入。