TrackPoint78

基于CH582M的小红点三模机械键盘方案

TP78是基于CH582M的三模机械键盘方案。以满足带有小红点 便携 无线 自定义快捷键四大根本需求为出发点设计的退烧键盘。基于CH582M三模75%配列，带有小红点(指点杆)，并使用TouchBar实现鼠标左中右键。OLED、Hub和磁吸接口。外壳可使用拓竹A1mini打印拼装。（注意开源协议，GPL3.0，请尊重开源，欢迎交流，交流群：678606780）

V2.0 ：视频展示：【软软核】为自己做一把小红点三模键盘_哔哩哔哩_bilibili

V2.1：视频展示： TP78指点杆三模键盘-Gasket版出炉啦 (速来拼车)_哔哩哔哩_bilibili

1. 【V2.1】更新BootLoader，支持拖拽式更新固件（仅拼车发货的板子带）
2. 【V2.1】新版Gasket结构，小尺寸3D打印/CNC优化（已使用拓竹A1mini打印验证）
3. 【V2.1】优化触摸条滑动功能
4. 支持VIA网页改键、修改配置
5. 支持USB U盘改键和配置
6. 支持触摸板触摸条操作
7. 集成USB hub接口
8. 增加USB磁吸扩展口
9. 集成RF模式和接收器方案
10. 使用I2C小红点方案
11. 使用触摸条震动反馈
12. 自研OELD UI动画
13. 多种Fn功能
14. 待机自动进lowpower模式

关注我们 - 获取更多开源好玩的DIY小玩意

bilibili：@i丶m皮皮 @阿炜阿阿炜阿

抖音：@i丶m皮皮

拼车链接（目前仅支持中国大陆 - 限量）

1. 哔哩哔哩工房 (bilibili.com)

2. 淘宝(taobao.com)

模型开源地址

https://makerworld.com/zh/models/172159#profileId-189031

硬件开源地址

https://oshwhub.com/bibilala/tp78_2022-08-31

源码开源地址

https://github.com/ChnMasterOG/tp78_v2

固件下载地址

https://github.com/ChnMasterOG/tp78_v2/releases/

升级固件、使用教程

https://github.com/ChnMasterOG/tp78_v2/blob/main/documents/TP78v2指导文档.pdf

材料清单

PCB

外壳

补充五金及结构件

补充连接线等电子元件

组装步骤

可参考V2.0视频展示后半部分

仓库目录

flowchart LR

A(repository) --> B(documents - 手册和文档)
A(repository) --> C(mounriver_project - wch软件工程)
A(repository) --> D(firmware - 相关固件)
A(repository) --> F(tools - 相关辅助工具)
C(mounriver_project - wch软件工程) --> G(KEYBOARD_CH582M - 三模无线键盘工程)
C(mounriver_project - wch软件工程) --> H(RF_CH582M - 配套接收器工程)
C(mounriver_project - wch软件工程) --> J(VLD_CH582M - 主控板测试工程)

改键视频教程

改键篇(上)-VIA： https://www.bilibili.com/video/BV1rL41167qy

改键篇(下)-按键宏： https://www.bilibili.com/video/BV1Yu4y1S73Q

关于固件升级Q&A

• Q: 如何进入主键盘WCH的ROM bootloader（非开发者不建议操作）？

• A: 按住底板中BOOT键通电。

• Q: 如何进入主键盘kBoot？

• A: kBoot是TP78_v2固件配套bootloader，按下Fn+B可实现由主固件跳转至kBoot，或通过按ESC上电跳转kBoot。kBoot下格式化U盘操作相当于擦除主固件，擦除后将主固件复制到U盘选择Reboot进行固件升级。

• Q: 如何进入接收器的bootloader？

• A: 进入RF模式后连上接收器，此时按下Fn+ESC使接收器进入ROM bootloader。注意：接收器进入bootloader后CodeFlash首4K被擦除，上电后必须先下载程序。若同时需要升级接收器固件和键盘主体固件，优先升级接收器固件后再升级键盘主体固件。千万注意接收器固件不要刷错，否则导致无法连接从而无法再次进入bootloader。

• Q: 如何通过WCH工具升级固件？

• A: 使用WCH官方ISP工具进行固件升级(仅支持windows)，工具目录：tools/WCHISPTool/WCHISPTool_Setup.exe。

  • 双击软件安装工具和相关驱动；

  • MCU系列选择：“32位低功耗蓝牙系列”，芯片选择：CH58x，芯片型号：CH582；

  • 在USB设备列表里找到自己的设备，若找不到尝试重新进入BOOT；

  • 根据需求勾选相关下载配置，若不确定可进行咨询，一般使用默认配置即可；

  • 选择目标程序文件1，并勾选右侧选项框；

  • 最后点击下载。

• Q: 首次刷入固件提示FATFS-FAIL（解决方式1）。

• A: 第一次下载需要刷入出产固件（或者通过打开HAL.h中的FIRST_USED宏编译出产固件）。刷入后弹出U盘选择格式化。格式化后断电重启。重启再刷入正式版固件。刷入后确保正式版固件的配置信息是最新的，需要按5次Fn重置配置。重置后重启键盘就能正常使用。

• Q: 首次刷入固件提示FATFS-FAIL（解决方式2 - 推荐）。

• A: 首次刷入固件时，勾选DataFlash文件，选择firmware/DefaultFS.BIN，点击下载即可。刷入后确保固件的配置信息是最新的，需要按5次Fn重置配置。

BUG提交与代码合入

当你在使用中遇到问题，可以在这里提交你的反馈。

若你是开发者，欢迎提交代码对tp78固件进行升级。本项目会对合入代码进行自动云测，并定期自动发布release版本。

固件更新记录

• V2.0.11

        1. 修复部分硬件OLED上电不亮的问题

        2. Relase版本增加起始0x0地址的固件版本

        3. 修复多按键按下弹起任意一个按键导致所有按键被弹起的问题

• V2.0.12

        1. 增加游戏模式（降低键盘延迟，提升响应速度。相对地，游戏模式下关闭部分功能）

        2. 修改接收器进BOOT模式为Fn+ESC，防止按错

• V2.0.13

        1. 优化低功耗模式，修改后灭屏蓝牙不会断连

        2. 增加进入屏保和低功耗时间可配置

• V2.0.14

        1. 修复SP键无法正常工作的BUG

        2. 增加小红点读取数据期间禁用中断

• V2.0.15

        1. 修改按键弹起逻辑，避免出现重复键码

        2. 优化USB HID信息发送状态的判断