kmbox A版用户手册
kmbox A是针对B版本而言的。虽然简易，但不代表他功能不强大。他是目前常见的易键鼠升级版本。
不仅支持现有的易键鼠所有功能。还拥有独特的脱机运行功能。LCD显示功能。
既可以和上位机配套使用（软硬件结合辅助），又可以独立脱机使用。并且傻瓜式编程。
你只用点几下鼠标便可制作一个纯硬件的物理压枪脚本。自由度虽不及B版本，但一般的FPS压枪，
一键N技能这种低端操作一样不含糊。
新手教程
这里会详细介绍kmbox A版本相关使用方法
01开箱介绍
kmboxA默认包含以下面配件
- kmbox Net盒子一个
- 蓝色线缆一条
02如何接线
盒子有显示屏的一面。写着PC的蓝线接电脑。mouse外接鼠标。一般按照下图接线：
接上鼠标后显示如下图：
特别注意：不接鼠标显示的VIDPID才是盒子的。接上鼠标后的VIDPID是鼠标的，不是盒子的。不要搞错了。
盒子的VIDPID用于辅助软件连盒子。
如果你的鼠标接盒子上可以正常移动点击。那么不需要任何操作。开辅助软件连盒子VIDPID就行了。
如果鼠标接盒子上移动点击有异常请看常见问题里的键鼠适配章节。
常见问题
鼠标不能使用如何适配鼠标
适配鼠标你需要A版的上位机软件(点我下载)
step01-打开上位机软件
如果连接成功会弹出以下提示框，同时显示屏会出现下面图片
此图片是盒子上位机软件发送给盒子的。
step02-把要适配的鼠标接盒子上
点击一键自动适配。根据实际情况选择适配结果。
step03-手动适配
在step2中如果鼠标正常，就可以不用手动适配。只有step2无法让鼠标正常工工作时才需要进行此操作。
手动适配值从0开始，点击手动适配，如果鼠标不正常。
手动适配值改成1，点击手动适配，如果鼠标不正常。
手动适配值改成2，点击手动适配，如果鼠标不正常。
……
依此类推，直到鼠标正常为止。最大值尝试到22.
详细步骤可以参考此视频教程：
如何升级固件
KmboxA 版本现在支持固件升级啦！（不强制升级，看个人需求）
step-01 下载必要工具和固件
-
最新固件请访问官网固件页面：固件页面
-
升级工具
升级工具同样可在固件页面下载。
升级工具打开后如下：
新增了固件升级功能，强制鼠标回报率功能，解决回报率不匹配不顺手问题。（该问题由用户设备本身描述符错误导致）
升级前请把下载的固件 xxxx.A 文件放到 exe 所在的目录内，升级后才能使用新特性：
step-02 点击固件升级按钮
软件会提示烧录方法：
牢记以上步骤，点确定。
此后：
1、拔掉盒子与电脑的 USB 线。
2、按住盒子内部按钮不松。
如图所示，用金属或者导线短接这两个点。
P.S.:早期规划的 A 板不提供升级功能，故没有按钮。
3、将盒子的 Mouse 口用 USB 线连电脑。
注意两点：
i : 要保持 2 中的按键短接不松。
ii：USB 线接盒子 mouse 口。
正常情况下 10 秒内软件就会弹出下面提示：
此时说明固件已经升级成功；若无此弹框，则前面 123 步骤中存在问题，请重复 123 步骤。
step-03 激活硬件
升级完毕后，按正常接法连盒子，把 USB 线从 Mouse 口拔出，接盒子的 PC 口，则有下图显示：
在上位机软件中点击连接盒子：
点击查询激活状态（非必要）：
可以看到设备未激活。
点击激活盒子按钮：
提示激活成功，到此固件激活完成，请重新插拔盒子。
已经看不到提示激活盒子的信息了。
如何修改回报率
前提条件，使用 20251030 以后的固件版本才支持修改。
强制切换回报率能解决以下两个问题：
1、设备本身描述符错误导致的回报率低问题。
2、强制提升设备性能，让反应更灵敏。
盒子本身默认跟随用户设备回报率，用户设备反馈要多少回报率，盒子则作出相应匹配。
现发现部分用户设备本身描述符存在错误，符合第一种情况。此时出现不跟手、速度慢的情况则可强制切换回报率来提升手感。
注意，并非回报率越高越好，部分设备强制超频可能导致数据异常。鼠标处理不及反而会适得其反，特别是对低速 USB 设备的鼠标而言。
step-01 首先确定用户当前设备默认回报率值
将鼠标插入 mouse 口：
上图显示当前鼠标为自动识别模式，Mouse 端接入设备为 G502 鼠标。
该鼠标内有键鼠数据：键盘回报率为 1000Hz,鼠标回报率为 1000Hz。
K 后缀为键盘回报率，M 后缀为鼠标回报率。
部分设备可能只显示键盘或鼠标参数值之一。
G502 鼠标是 USB FULL Speed 设备，最高支持 1000HZ 的回报率。
step-02 使用工具
打开上位机软件，连接盒子，选择所需回报率。
此处选择 500Hz：
选择后生效，直接拔掉鼠标重插。
此时屏幕上已显示当前回报率为 500，修改成功。
此修改永久生效，保存于盒子内部。
软件开发者专区
脱机脚本编辑
盒子支持脱机脚本编辑。一共可以保存五组脱机脚本。每组脱机脚本可单独设置触发方式。脱机脚本编辑主要用到以下区域;
在连接盒子成功后。你可以点击读取板子查看盒子是否存在板子脚本
板载信息在显示目前板卡上一共有两个脚本。1号脚本名字叫config1 ,2号脚本叫Up.两个脚本一共使用了256字节。总共可用8192字节。脚本触发条件是1，表示当鼠标左键按下时触发对应的脚本内容。
举个简单的例子。制作一个压枪脚本。鼠标左键按下时，自动压枪。
首先擦除一下板载脚本。
擦除后可以看到4组板载脚本均没有使用。此时可以新建脚本。把此脚本保存在第一组中。
1：脚本名称和组。
脚本名称会显示在LCD上，当你切换到对应的组上时会在LCD上显示当前脚本名称。
例如上图中的AK47.当你切换到第一组（档）时。LCD上会显示AK47.这样你就知道当前运行那一组脚本。
2：触发条件设置。
促发条件是用来设置满足什么条件时才会自动促发本组脚本的运行。上图中的触发条件 是鼠标左键按下。也就是当你切换到AK47档时，如果鼠标左键按下。就会自动执行 delay(5,10) 的随机延迟，然后鼠标自动下移10个像素。如果促发条件不满足。则上面 的脚本将不会执行。
3：多档位切换
板子一共支持4组脚本。也就是四个挡位。外加一个空挡。当你有AK47时你用第一组 参数。但是此参数不适合其他枪械。此时你可以新建第二组参数。保存在第二组。假设
第二组枪械是冲锋枪汤姆逊。如何从第一组参数切换到第二组参数呢？这就需要用到多 档位切换。上图中，设置的多挡位切换是鼠标中键。也就是说。如果按下鼠标中键。将 会自动从当前挡位切换到下一个挡位。
4：脚本执行完毕后的动作
上面的脚本就两个动作。随机延迟5-10ms.鼠标下移10个单位。这样组脚本就执行完了。
执行完之后可以选择该组脚本是循环执行还是执行完了就执行完了。等触发条件不满足 退出。因为是压枪，所以选择第一种。执行完了再从头执行。这样只要左键按着不松
鼠标就会一直下移压枪。
- 向脚本区域添加脚本指令
所有脚本指令都是通过指令后面的
按钮来添加。因为指令是需要编译成板子能识别的指令。手写容易出错。会导致第八步编译下载不成功。
6：添加一个延迟指令
Delay(5,10)表示随机延迟5到10ms时间。如果第二个参数为0表示精确延迟第一个参 数的时间。
7：添加一个鼠标下移指令
Move(0,10)表示鼠标x轴方向移动0个单位，Y方向下移动10个单位。
8：下载到板卡
将上面编辑好的脚本下载到板卡内部。然后你就可以开始测试这个脚本是否满足你的要 求了。
为了简便。我只写了2条脚本语句。你可以根据自己的需求任意增加你要的脚本内容。
目前脚本一共有8KB的存储空间。大约能存2K条脚本指令。
你可以点击读取板载来查看当前四组脚本的存储分配情况。
注意。脱机脚本是需要右端接鼠标的。只有满足触发条件才会触发刚刚下载的脚本。
下载到盒子后单击鼠标中键，可以看到他切换到AK47组了。
此时如果按住鼠标左键，那么他会每隔5-10ms时间鼠标下压10个单位。松开鼠标左键。下压停止。如果想关闭该组的脚本。就再按一次鼠标中键。组间切换。此时脚本会切换到空挡。
如果想再次切换，再切中键到对应的标签即可。
压枪脚本的制作可以参考此视频：（从第8分钟开始）
第三方调用（上位机调用）
C++源码调用
C++可以直接调用dll。dll源码点我下载.下面以显示调用为例，讲述如何使用源码。
解压源码，如下图所示，根据自己环境使用对应的源码。
打开显示调用dll工程：
1、可以看到以上内容。按照dll的调用规则，先加载dll.导出里面的函数。再调用导出函数。最后释放dll。
2、调用盒子其他函数前必须首先调用KM_init函数，连接盒子成功后才能继续调用其他函数。KM_init仅需调用一次即可。
3、其他函数请参考dll源码中的头文件。例如鼠标右键控制KM_right，移动KM_move等。
如何修改屏幕logo图片
修改logo本质上是调用KM_LCDpic函数。将需要显示的图片数组给bmp即可。那么修改logo实际就是修改bmp里的内容。有专门的工具用来生产bmp数组。
首先明确下面几点：
1、A的屏幕分辨率是128x64.
2、A的屏幕是单色的（每个像素点只有亮和不亮两种状态）。
因此128x64的分辨率，一共需要128x64=8192bit=1024Byte.也就是刷新一幅图需要给盒子传输1KB的数据。故bmp数组大小一定为1KB.
下面介绍如何生成bmp数组。可参考图片取模.docx教程。（也可以百度一下。这个工具的使用方法）
如果你需要复杂图形。可以将图片导入PCtoLcd2002软件中。可以自动生成。注意，咱们A是二值图。二值图。二值图。不是RGB彩色图。效果咋样你可以用图像二值化工具看一下。
