# rc3plus

**Repository Path**: asykii/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**: 0
- **Forks**: 2
- **Created**: 2025-09-12
- **Last Updated**: 2025-09-12

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# RC3Plus Retro Computer Project

![输入图片说明](hardware/ZIV8HmdjWHTihHhlAFE72ThJeC2ybdQc1h32JSSV.png)

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

## 项目概述

- **项目背景**: 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安装依赖并运行

## 已知问题

- U盘只读时需要冷启动
- 摇杆模拟鼠标功能受限，需配合键盘右下角的左右独立按键实现完整功能
- 拖放滚动等鼠标功能需按住特定键实现，需要双手配合操作。
- 按电源键开机后，过几秒自动关闭电源。需要boot.txt增加 enable_uart=1 这样，开机几秒后，就能从GPIO 14获得一个高电平维持电源en，关机后，这个io口会变低电平，可以控制ti升压芯片物理关机。

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

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

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

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