EzioL / tp78_v2

TrackPoint78是基于CH582M的小红点开源三模机械键盘方案；技术讨论、开车交流QQ群678606780；本代码仅供学习交流，非授权禁止商用，沿用代码请遵守开源协议；欢迎提交Pull requests完善/修改代码

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模式

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

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

PCB名称	功能说明	板子厚度
0.键盘主板	键盘主板	1.6mm（其他厚度也可以）
1.Hub供电板	USBhub、电池充放电、电量检测	1.0mm
2.Minimal_2	M2接口的CH582M最小系统板(外置天线)	0.8mm 最好选择沉金
3.触摸条	触摸条	1.2mm （这个是裸露在外的，注意颜色哈）
4.磁吸转接小板	磁吸扩展模块	1.0mm（其他厚度也可以）
5.接收器	2.4GHz接收器	0.8mm

外壳

模型下载地址

文件名	说明
底座左 Left Bottom Case.step	键盘底座左侧
底座右 Right Bottom Case.step	键盘底座右侧
定位板左 Left Plate.step	定位板左侧
定位板右 Right Plate.step	定位板右侧
上盖左 Left Top Case.step	上盖左侧
上盖右 Right Top Case.step	上盖右侧

补充五金及结构件

元件名称	规格	数量	备注
M2×3 螺丝	M2×3	4
M2×5 螺丝	M2×5	4
M2×11 螺丝	M2×11	8
M2×2×3 滚花螺母	M2×2×3	14
M2×18 销柱	M2×18	3
键盘定位板硅胶	5×8，2.8×12	12	https://item.taobao.com/item.htm?_u=q2jjkhi69cd7&id=744647593898&spm=a1z09.2.0.0.af932e8d0BlsxD&sku_properties=1627207:107121
NGFF M.2 铜柱-1.5H M3	1.5H M3	1	https://item.taobao.com/item.htm?app=chrome&bxsign=scdEkAVMVexd7f8Q7UzuApXa4j1r_JD9G4td5HaaWVChIkPjmiw1mdLib_8g4SRe2vWDNuoFUCKcu-ejr9A1uJwoDsc538qN83wsPZPpYKL7QjkTn9bV8RsvlvkjlMOVoLH&cpp=1&id=618677416528&price=0.26-0.8&shareUniqueId=25308625613&share_crt_v=1&shareurl=true&short_name=h.5rLwYPpOifZrW9B&skuId=4836714229115&sourceType=item,item&sp_abtk=gray_1_code_simpleAndroid2&sp_tk=VG1oMFdSQ2NvUkM=&spm=a2159r.13376460.0.0&suid=95bb0d99-7ae4-428d-8994-c13b7072fe1e&tbSocialPopKey=shareItem&tk=Tmh0WRCcoRC&un=a40571f7eec624d4b0ea5e6b515c0e5c&un_site=0&ut_sk=1.YDpH0Uzm8dUDAG5lU8oOTXSt_21646297_1706280814125.Copy.1
M3*4 螺丝（M.2固定用）	M3×4	1
接收器外壳		1	https://item.taobao.com/item.htm?_u=q1p8ioog4b10&id=534100629624&spm=a1z09.2.0.0.ffb12e8doHDWhm

补充连接线等电子元件

元件名称以及规格	数量	备注
YDX-C09指点杆	1
指点杆帽(大方口)	1	https://item.taobao.com/item.htm?_u=q2jjkhi630e3&id=598814658945&spm=a1z09.2.0.0.af932e8dbSeo4W
0.66寸OLED显示屏6448(ssd1306)	1	https://item.taobao.com/item.htm?abbucket=14&id=532909628316&ns=1&spm=a21n57.1.0.0.4d20523cgGuatR
磁吸公+母	1	https://item.taobao.com/item.htm?_u=q1p8ioog0426&id=567899628697&spm=a1z09.2.0.0.ffb12e8doHDWhm&skuId=4855618049480
MX1.25MM双头反向10p 150mm	1	https://item.taobao.com/item.htm?_u=q1p8ioog7751&id=17860990732&spm=a1z09.2.0.0.ffb12e8doHDWhm
MX1.25MM双头同向6p 150mm	2	https://item.taobao.com/item.htm?_u=q1p8ioog7751&id=17860990732&spm=a1z09.2.0.0.ffb12e8doHDWhm
MX1.25MM单头6p 100mm	1	https://item.taobao.com/item.htm?_u=q1p8ioog9ebc&id=21014043282&spm=a1z09.2.0.0.ffb12e8doHDWhm
2pin 震动马达电源线	1	https://item.taobao.com/item.htm?_u=q1p8ioog9e2a&id=650661513310&spm=a1z09.2.0.0.ffb12e8doHDWhm
震动马达	1	https://item.taobao.com/item.htm?_u=q1p8ioog403c&id=695661440091&spm=a1z09.2.0.0.ffb12e8doHDWhm
FPC 8p反向30cm	1	https://item.taobao.com/item.htm?_u=q1p8ioog75f1&id=549590794021&spm=a1z09.2.0.0.ffb12e8doHDWhm&sku_properties=-1:-1
IPEX天线 2.4G	1	https://item.taobao.com/item.htm?id=590679216827&skuId=4637409672288&spm=a1z0d.6639537/tb.1997196601.52.33917484vHyEWs

组装步骤

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

指导文档

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

仓库目录

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+M使接收器进入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版本。