kmbox Net用户手册
什么是kmbox Net
kmbox Net是一款网络程控键鼠控制器，具有以下特性：
* 1、安全，协议不公开。每个盒子独立IP、端口、硬件编码。采用阻塞socket通信，无法被扫描。
* 2、稳定性强，不会像串口通信那样白屏重启。
* 3、速度快。100M专用网络，通信速度是原来B板的100倍（相比115200波特率）。每秒调用次数接近1000次，B板只有每秒300次调用，调用太快会白屏重启。
* 4、自动默认人工轨迹，不会出现键鼠数据异常。
* 5、无需适配鼠标，通用性强。
* 6、Device端支持修改所有USB参数，每个人都有不同特征值，真正的一人一固件模式。
* 7、友好UI模式，问题一目了然，傻瓜式操作。
* 8、支持B板除板载脚本外所有功能。
* 9、支持监控物理键鼠，屏蔽物理键鼠功能，方便写软件。
* 10、支持物理键鼠学习复制功能。支持驱动直通模式。
新手教程[第一次用请看这里]
这里会详细介绍kmbox Net如何使用
01开箱介绍
kmboxNet默认包含以下面配件
- kmbox Net盒子一个
* 蓝色线缆两条
02如何接线
盒子背面有接口名称，一般按照下图接线：
- 注意：如果是单机，那么网口和游戏机口都接同一台电脑。如果是B电脑控A电脑。那么游戏机接口（1）接A电脑。网口（2）接B电脑。
03装网卡驱动（接2口的电脑装驱动）
接上网口线后，我的电脑里会有一个磁盘，如下图所示，双击磁盘找到里面的exe安装即可。 若没有磁盘也可手动下载网卡驱动，解压安装即可。点我下载网卡驱动
注：若装上网卡驱动没反应： （1）查看网口线接上没有？ （2）网口USB线接在哪里，哪里就装网卡驱动，不要驱动装了电脑A，线接在电脑B上。
04改网卡IP（接2口的电脑改网卡IP）
打开控制面板-->网络共享中心
修改网卡IP
检查网络是否联通
运行cmd
ping盒子显示屏上的IP
ping 192.168.2.188
如果出现上面的图片，则表示此时盒子已设置好，后续只需设置第三方软件连盒子即可。
以上过程可参考此视频教程：
注：若改完IP突然没网了，可能是改错了网卡。 通常页面上会新出现网卡（盒子的网卡），要改盒子的网卡而不是你自己的本机网卡。 具体操作参见上面的修改网卡教程。
基础教程[盒子基本功能介绍]
显示屏参数介绍
如图所示：
1、游戏机口状态图标
游戏机口状态图标用来显示盒子与游戏机之间的关系。此图标有三个状态。
| 等待连接状态 |  |
等待主机（游戏机）枚举盒子。出现此状态说明盒子还未被主机识别 |
|---|---|---|
| 已连接状态 |  |
主机已经成功识别盒子。可以通过盒子控制主机了 |
| 断开连接状态 |  |
主机断开与盒子的连接。键鼠不可用 |
注意：盒子永远是USB从设备。盒子永远不会断开主机。所有连接，断开都是主机发起的。
2、网口连接状态图标
网口状态图标用来显示盒子与第三方软件连接关系。此图标有三个状态。
| 等待连接状态 |  |
此时盒子是空闲的，没有任何软件连接盒子。 |
|---|---|---|
| 已连接状态 |  |
打勾说明第三方软件已经连接到盒子。 |
| 断开连接状态 |  |
打叉说明第三方软件异常，断开与盒子的连接。 |
通过此图标可以清晰的知道第三方软件是否连接盒子。
3、键盘鼠标口状态
盒子右边的键盘鼠标后用来外接键盘或者鼠标。一共有8种状态
| 等待鼠标连接 |  |
此端口为空闲状态，等待外设连接。此处推荐接鼠标 |
|---|---|---|
| 鼠标已连接 |  |
打勾表示外设已经成功识别为鼠标，并可以使用， |
| 鼠标断开 |  |
打叉表述外设与盒子断开连接。一般是连接不稳定导致 |
| 等待键盘连接 |  |
此端口为空闲状态，等待外设连接。此处推荐接键盘 |
| 键盘已连接 |  |
打勾表示外设已经成功识别为键盘，并可以使用， |
| 键盘断开 |  |
打叉表述外设与盒子断开连接。一般是连接不稳定导致 |
| 复合键鼠已连接 |  |
当前外设里既包含键盘报告又包含鼠标报告，是键盘鼠标复合设备。且识别成功。 |
| 复合设备识别失败 |  |
无法识别的复合设备。一般不会出现。如果出现了请联系作者 |
4、盒子固有参数
这个参数是给第三方软件连接盒子使用的。第三方软件里必须填盒子对应的参数才能连接盒子，错一个都连不上。
IP:盒子的IP地址。
Port：盒子的服务端口号。
UUID：盒子的唯一编码。每个设备都不一样。
5、曲线类型
盒子内置的曲线类型。
这里目前有5个值，可以通过上位机软件来切换。
| Auto | 盒子内部自动曲线 |
|---|---|
| Bezier -非实时 | 非实时的贝塞尔曲线 |
| RT-Bezier -实时 | 实时贝塞尔曲线 |
| Arm -非实时 | 非实时的导弹追踪曲线 |
| RT-Arm -实时 | 实时导致追踪曲线 |
盒子默认关闭曲线，或者仅做轻微的矫正操作。如需开启曲线功能，请参考修改曲线教程。
6、固件版本号
如图所示固件版本为：2025年11月6号版本。后缀字母定义如下：
盒子固件版本命名规则:
固件发布日期+英文后缀。
例如：20251106A
固件发布日期是2025年11月6日。
A表示自动曲线修正。
B表示支持bypass版本。
C表示客户定制版本。
D表示Debug版本。
R表示发布版本。
7、盒子型号
8、盒子工作模式
盒子目前一共有两种工作模式：
一、KM复合键鼠模式
默认状态下盒子工作在此模式。
此模式下能使用所有键鼠函数。不受限制。外设接盒子上会转换为盒子的报告。通过盒子发送个主机。盒子相当于隔离设备。
二、Bypass驱动直通模式
可以用上位机软件开启此模式。
驱动直通功能通俗点讲就是盒子100%透传连接他的键盘或者鼠标所有数据。接盒子和接电脑没任何区别。
驱动直通的优点
1、能使用原厂的驱动，支持原厂驱动宏。
2、能100%还原外设特性。
驱动直通的缺点
1、对于纯键盘设备。驱动直通后，无法通过API调用鼠标移动指令。
2、对于纯鼠标设备。驱动直通后，无法通过API调用键盘有关指令。
需要强调一下：现在检测都是行为检测。并不是开个驱动直通就越过了检测。如果你的第三方软件发送指令不合理。就会触发行为异常。 驱动直通也仅仅只是给你换个行为异常的设备而已。懂的都懂。
9、外设信息
此处显示最新接入盒子的设备基本参数信息。如下图所示：
重点关注回报率（Freq）和设备速度（Speed）.
Freq中可能出现K=0或者M=0的情况。此时说明外接设备是单纯的键盘或者鼠标。
如果K和M同时都有值，说明你的设备里既有键盘报告又有鼠标报告。
Speed表示你的设备速度等级，目前Net支持的速度等级有两种。
1、Low Speed。1.5Mbps的带宽。
说明你键盘或者鼠标是低速设备。比较低端的键鼠。打游戏的话推荐你换个鼠标。
2、Full Speed。12Mbps的带宽。
说明你的键盘或者鼠标是全速设备。大部分键鼠都是这种。其速度是低速设备的10倍。
3、High Speed。480Mbps的带宽。
这种是高端键鼠，回报率可上8KHz。反应速度是Full Speed的8倍。Kmbox NB板支持。
一般宏键鼠都是同时包键盘报告和鼠标报告的。
如何开启bypass模式
打开盒子上位机软件，首先连上盒子。然后点击“启用Bypass”盒子会自动重启，进入驱动直通模式。
注意。驱动直通模式下，盒子上有且仅能接1个设备。
如果接两个设备。优先驱动直通Port4口。Port3口的设备可以融合到Port4口去。
例如:Port4口接的罗技鼠标。可以正常使用Ghub驱动。
Port3口接其他键盘或者鼠标。那么Port3口的键鼠数据会转换成罗技鼠标协议数据。相当于融合功能。
如果驱动直通模式不能正常使用。请反馈，后续更新固件解决。你可以关闭Bypass模式。正常使用KM模式。
目前驱动直通功能已经能支持绝大部分鼠标。如有不支持请反馈。后续升级更新。以下是已测试的设备部分截图：
罗技系列：
GPW系列(无线+有线均OK)
迈从系列：（web驱动+PC端驱动均OK）
雷柏系列（8KHz回报率）
理论上已经支持任意类型键鼠的驱动直通。其他未测试的类型请网友自行测试。不能用可反馈。
如何开启KM模式
对于需要同时支持键盘和鼠标调用的用户。可以禁用Bypass模式。盒子默认就是键鼠复合设备。既可以调用键盘函数又可以调用鼠标函数。
如何升级
kmbox Net每个月不定期更新固件，可在官网下载最小固件和升级工具进行升级。
升级并不是强制的，要不要升级你自己决定。用着没什么问题可以不升级。升级固件可以修复旧版本固件存在的Bug。
如果要升级，请认真阅读下面文档。
01_下载升级驱动
首次升级盒子需要在升级电脑上安装升级驱动。以后就不需要了。注意首次需要装驱动！
下载后解压，安装01-驱动。安装完成后退出就行。
02_下载需要升级的固件
03_升级固件
请务必严格按照下面步骤来。
1、拔掉所有USB线缆。
2、按住盒子内唯一的键，保持不松。
3、将盒子游戏机口用USB线连接升级电脑，可以看到网络连接的灯快速闪烁，此时可以松开按键。
4、打开升级工具WCHMcuIAP_WinAPP.exe（双击打开）
选择你要升级的固件，注意：选文件时找不到文件，注意将筛选器中文件类型选择位Bin。
点击下载即可。
5、下载成功后盒子会自动重启，显示屏显示正常。
如果升级失败请重复上述步骤。
完整升级过程可参考下面视频教程：
注：若还有问题，请查看主副机是否接错？盒子的游戏机口和哪个电脑连接就在哪里升级。 例：若在副机上下载了升级软件，游戏机口就接在副机上升级；若是在主机上，游戏机口就接在主机上升级。
如何修改曲线
01-什么是盒子的硬件曲线修正功能
盒子默认是关闭硬件曲线修正功能的，该功能可以让鼠标轨迹避免阶跃，突变，达成平滑轨迹，更连续。
注：默认曲线是关闭的。如果开启后想关闭，直接将曲线功能前的勾选取消即可。
下面两个视频是关于曲线的说明。
02-下载盒子上位机控制软件
修改曲线首先需要盒子的上位机软件，点我下载kmboxNet上位机软件
03-打开盒子上位机软件
如果连接盒子不成功，请参考新手教程，确保网络OK后再使用此软件连接盒子。
连接成功后你可以选择硬件曲线值和算法类型（注意严格按照下面1，2，3的步骤来）
启用后盒子显示屏如下：
如何恢复出厂设置
当你不小心调乱了盒子，软件又无法连接盒子时。可以强制盒子恢复出厂设置状态。
第一种，刷固件。请参考刷固件教程。
第二种，长按盒子内部按键。直到屏幕闪烁“recovery”时松开。可恢复当前版本的出厂设置状态。
可以用上面任意一种方法发恢复出厂设置状态。
如何打开轨迹显示功能
轨迹显示功能是用来查看盒子最终的运动轨迹的。可以帮助我们分析键鼠数据异常的根本原因。一般开发者用得多。普通用户可以不用理会。
此功能可以直观的显示鼠标运动轨迹，包括第三方软件移动的轨迹。如需要鉴别软件轨迹是否合理。可以打开监听功能。
注意：如果开启后，系统弹窗是否允许kmboxNet使用网络，请点击是。否则软件中是不肯存在轨迹的。
举一反三。如果没有轨迹。请首先检查系统防火墙是否关闭。或者是否允许exe访问网络。
常见问题
1. 推荐Net还是B+？
看你个人需要。 习惯调用，推荐Net；习惯自写脚本，推荐B+。
2. Net和B+有什么区别？
B+有板载功能（支持自写脚本）。 其他详细区别请分别查看Net版与B版相关介绍。
3. 升级出现问题？
查看主副机是否接错？盒子的游戏机口和哪个电脑连接就在哪里升级。 例：若在副机上下载了升级软件，游戏机口就接在副机上升级；若是在主机上，游戏机口就接在主机上升级。
4. 装上网卡驱动还是没反应怎么回事？
（1）查看网口线接上没有？ （2）网口USB线接在哪里，哪里就装网卡驱动，不要驱动装了电脑A，线接在电脑B上。
5. 改完IP为什么突然没网了？
如果没网了，可能是改错了网卡。通常页面上会新出现网卡（盒子的网卡），要改盒子的网卡而不是你自己的本机网卡。 具体操作参见上面的修改网卡教程。
6. 盒子的曲线如何关闭？
默认曲线是关闭的。如果开启后想关闭，直接将曲线功能前的勾选取消即可。
7. 接上盒子鼠标灵敏度降低怎么回事？
你可以将你的鼠标回报率调制1000以下来匹配。
8. 如何改鼠标回报率？
Net版本身的数值没法修改，需要修改你自己的鼠标回报率（参考你的鼠标相关教程）。
软件开发者专区
敬待更新