什么是 kmbox B+(pro)

Kmbox 是一款小巧但功能强大的 USB 开发板, 为纯硬件 USB 主从设备控制器, 能完全化硬件级别模拟和控制键盘鼠标等 USB 设备，无需安装额外驱动，也无需注入 DLL 。

其脚本完全脱离 PC，运行在盒子内部的 CPU 上，能轻松让普通键盘鼠标 （非宏键鼠） 拥有可编程功能 （宏功能） 。

你只需要简单的 python 调用即可让普通键盘鼠标化腐朽为神奇。

不仅如此, 他还能带你快速入门 python, 学习编程，玩转硬件, 边学边玩, 边玩边用。不管是底层的硬件逻辑还是上层的框架应用,kmbox 都可以陪你一路打怪升级, 绝对是 DIY 爱好者的福音。

新手教程

这里会详细介绍 kmbox B+如何使用

01 开箱介绍

kmbox B+默认包含以下面配件

• kmbox b+ 盒子一个。 （正反面）

• 蓝色线缆两条

02 如何接线

盒子背后有接口名称，一般按照下图接线：

• 注意：如果是单机，那么串口和游戏机口都接同一台电脑。

03 装串口驱动

接串口的电脑需要安装串口驱动。

首先打开设备管理器，找 com 口，如果接上盒子后有串口，也就是下面的样子，则不需要安装串口驱动。

若没有串口，那么请下载串口驱动并安装  点我下载串口驱动，

注意：盒子的串口号是系统随机分配的，你的电脑是多少就是多少，每台电脑都不一样。

到这里就已经 OK 了，盒子不需要额外的设置了，要设置的都在你的第三方软件里，详细咨询你的第三方软件。

以上过程可以参考此视频教程：

04 将打游戏鼠标接盒子的键鼠口

推荐将操作鼠标接盒子上，如果不接就是多鼠标输入。

如果你的鼠标接盒子上能正常移动点击，那么就不需要任何调试，如果鼠标不正常，可以看常见问题中的键鼠适配章节。

常见问题

激活须知

重要：2024 年 8 月 31 日前未激活的版本不要继续升级固件;

8 月 31 日前已激活的版本可以正常升级固件。

正版盒子查询与激活教程

点我下载激活工具

如何升级盒子固件

01_下载升级工具

点我下载升级工具

02_下载需要升级的固件

kmboxB+固件点我下载

03_升级固件

如何修改曲线

01-什么是盒子的硬件曲线修正功能

盒子默认是关闭硬件曲线修正功能的，该功能可以让鼠标轨迹避免阶跃，突变，达成平滑轨迹，更连续。

下面两个视频是关于曲线的说明。

02-下载盒子上位机控制软件

修改曲线首先需要盒子的上位机软件，点我下载升级工具

03-upycraft 连接盒子

将 boot.py 里的值修改为你要的曲线值。

注意：修改后保存 （ctr+s） 。然后下载到盒子

如何改波特率

盒子默认波特率为 115200，若要其他通信波特率，可以通过修改 km.baud() 里面的值。

注意：修改后保存 （ctr+s） 并下载到盒子，重启后才能生效。这里，upycarft 只支持 115200 的波特率，若改成其他波特率，upycraft 就不可能连上盒子了。

下图修改波特率为 128000，下载并保存，下载 ok 后重启。

此时 upycraft 不可能连接盒子了，因为 upycraft 只支持 115200 波特率。想要切换回 115200 波特率可以重刷固件，或者用鼠标滚轮切换。

以下视频介绍如何使用鼠标滚轮切换波特率：

如何适配键鼠

当你的鼠标接盒子上无法正常移动或者点击时可能需要适配。

键鼠适配请参考此视频教程：

如何修改盒子回报率

当接上鼠标感觉鼠标移动缓慢，可以通过修改回报率来提高鼠标移动速度。 盒子默认回报率为 500. 修改回报率可以参考下面视频：

软件开发者专区

kmbox B 系列开文档

• 法律声明
• 完整用户手册_点我下载 (此手册包含全部 API 和用法)

什么是串口通信

这里介绍盒子的通信端口。

• 什么是串口通信

java 如何调用盒子

这里是 java 源码调用串口与盒子通信。

• java 调用源码

python 如何调用盒子

这里是 python 调用串口与盒子通信的源码

• python 调用源码_demo1
• python 调用源码_demo2

C++如何调用盒子

这里是 C++调用串口通信源码。

• C++调用源码

易语言如何调用盒子

这里是 E 调用串口通信源码。

• E 调用源码

脱机脚本加密工具

这里是脱机脚本加密工具

• 脱机脚本加密工具

什么是 kmbox Net

kmbox Net 是一款网络程控键鼠控制器，具有以下特性：

1. 安全，协议不公开，无法被特征。每个盒子独立 IP 、端口、硬件编码。采用阻塞 socket 通信，无法被扫描。
2. 稳定性强，不会像串口通信那样白屏重启。
3. 速度快。 100M 网络，通信速度是原来 B 板的 100 倍 （相比 115200 波特率） 。每秒调用次数接近 1000 次，B 板只有每秒 300 次调用，调用太快会白屏重启。
4. 自动默认人工轨迹，不会出现键鼠数据异常，请参考 kmNet_mouse_move_auto 函数。
5. 无需适配鼠标，通用性强。
6. Device 端支持修改所有 USB 参数，每个人都有不同特征值，真正的一人一固件模式。
7. 友好 UI 模式，问题一目了然，傻瓜式操作。
8. 支持 B 板除板载脚本外所有功能。
9. 支持监控物理键鼠，屏蔽物理键鼠功能，方便写软件。
10. 支持物理键鼠学习复制功能。 （TBD）

新手教程

这里会详细介绍 kmbox Net 如何使用

01 开箱介绍

kmboxNet 默认包含以下面配件

• kmbox Net 盒子一个

02 如何接线

盒子背面有接口名称，一般按照下图接线： 

• 注意：如果是单机，那么网口和游戏机口都接同一台电脑。

03 装网卡驱动

接上网口线后，我的电脑里会有一个磁盘，如下图所示，双击磁盘找到里面的 exe 安装即可。 若没有磁盘也可手动下载网卡驱动，解压安装即可。点我下载网卡驱动

04 改网卡 IP

打开控制面板--> 网络共享中心

点我下载网卡驱动

修改网卡 IP

检查网络是否联通

运行 cmd

ping 盒子显示屏上的 IP

如果出现上面的图片，则表示此时盒子已设置好，后续只需设置第三方软件连盒子即可。

以上过程可参考此视频教程：

常见问题

如何升级

01_下载升级驱动

点我下载升级固件驱动

下载后解压，安装 01-驱动。安装完成后退出就行。

02_下载需要升级的固件

最新固件点此下载

其他版本固件点这里

03_升级固件

1 、拔掉所有 USB 线缆给盒子断电。

2 、盒子内部有唯一一个按键，按下此按键，保持不松。

3 、将游戏机 USB 线插入盒子，可以看到网络连接的灯快速闪烁，此时可以松开按键。

4 、打开升级工具 WCHMcuIAP_WinAPP.exe（双击打开）

选择你要升级的固件，点击下载即可。

5 、下载成功后盒子会自动重启，显示屏显示正常。

如果升级失败请重复上述步骤。

完整升级过程可参考下面视频教程：

如何修改曲线

01-什么是盒子的硬件曲线修正功能

盒子默认是关闭硬件曲线修正功能的，该功能可以让鼠标轨迹避免阶跃，突变，达成平滑轨迹，更连续。

下面两个视频是关于曲线的说明。

02-下载盒子上位机控制软件

修改曲线首先需要盒子的上位机软件，点我下载 kmboxNet 上位机软件

03-打开盒子上位机软件

如果连接盒子不成功，请参考新手教程，确保网络 OK 后再使用此软件连接盒子。

连接成功后你可以选择硬件曲线值和算法类型 （注意严格按照下面 1，2，3 的步骤来）

启用后盒子显示屏如下：

Nvideo 是什么

kmbox Nvideo 可以理解为以下三个设备的集合体：

1. kmbox Net 网络键鼠控制器。其 API 与 net 一致
2. kmbox Video 视频采集卡。且带环出功能。
3. xbox360 键鼠转手柄转换器。
4. Nvideo = Net + 视频采集卡 +键鼠转换器

Nvideo 能做什么

1 、同 net 一样，能纯硬件级别控制键盘鼠标。

2 、能采集显卡图像 HDMI 输出。零延迟环出到显示器。无需驱动。不怕检测。

3 、支持通用的采集卡调用, 录制视频，直播，转播等视频流传输功能。

4 、可将键盘鼠标转换为手柄。参数可调，曲线可调。

Nvideo 实物图

Nvideo 性能

1 、 Nvideo 的 HDMI In 最大支持 1920x1080@60HZ（2K） 视频信号输入。

2 、 Nvideo 的 HDMI Out 支持 0 延迟环出 (无延迟，不影响游戏体验) 。

3 、 Nvideo 的 USB3.0 最大支持 1920x1080@60Hz 采集。延迟为 3-5 贞 （与电脑配置有关） 。

4 、 Nvideo 的游戏机键鼠接口最大支持 1000Hz 回报率，控制游戏机键鼠。

5 、 Nvideo 的主键鼠接口支持外接键盘鼠标，并融合。最高回报率 1000Hz 。

6 、 Nvideo 的网口支持监听物理键鼠状态。修改从键鼠口数据，能完全掌从键鼠端。 其性能为每秒调用 1000 次。

7 、 Nvideo 支持键鼠转手柄功能 （完善中）

接线方法

1 游戏机显卡输出 （HDMI IN）: 此端口通过 HDMI 线缆连接到显卡输出。盒子通过此端口采集电脑画面。

2 游戏机显示器 （HDMI OUT）：此端口通过 HDMI 线缆连接到显示器。 HDMI IN 的图像会通过此端口输出到显示器。切不会引入任何延迟。

3 游戏机键鼠 （Device）: 此端口通过 USB 线缆连接到游戏机。在游戏机端无需任何驱动。自动识别为标准键鼠。盒子通过此端口控制游戏机键鼠。

4 外接键鼠端口：此端口可外接键盘鼠标。外界键鼠均是控制游戏机的。

5 副机网口 （USB2.0）：此端口通过 USB2.0 线缆连接到副机 (单机就是游戏机) 。可以通过第三方程序控制游戏键鼠。

6 副机视频采集 （USB3.0）: 此端口通过 USB3.0 线缆连接到副机 (单机就是游戏机本机) 。通过此端口可以获取 HDMI IN 的图像信。

PS: 建议将所有线接好，最后接 USB3.0 视频采集口。给盒子供电。不要先接 USB3.0 线。不然带电操作会有问题。

细节问题:

1. 务必保证显卡 HDMI 输入的分辨率是 1920x1080@60Hz（或以下），超带宽不支持。可能导致无法正常显示。
2. 接入 USB3.0 线缆后，如果设备管理器摄像头显示的是 USB2 video 。则证明当前端口不是 USB3.0 。 USB2 Video 也可以使用。只是达不到优传输速度与效率。
3. 可以使用盒子上位机软件测试当前图像采集以及键鼠是否正常。确保正常了再开第三方软件。

采集卡测试方法

按上面接好线后可以用 obs 或者 vlc 等常用软件测试盒子采集卡功能。以 OBS 为例;

打开 obs, 新建视频采集设备。

选择盒子的摄像头即可出图像

如果图像和键鼠均正常。那么盒子硬件就 OK 。以上。

如果你是开发者。建议用 github 中的 demo 测试。延迟基本稳定在 80-100ms 之间。

Xbox360 手柄测试方法

首次接上盒子，如果设备管理器中出现左边黄色感叹号设备，则需要手动设置一下驱动。如果时右边正常识别，则无需任何设置。

手动指定驱动