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模式。
目前驱动直通功能仅测试阶段。已完美支持罗技系列鼠标。雷蛇的还有问题。后续再更新。
如何开启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版本身的数值没法修改，需要修改你自己的鼠标回报率（参考你的鼠标相关教程）。
软件开发者专区
敬待更新