# LDN_RGB_KeyBoard_FirmwareV0.2-help
**Repository Path**: Yish1688/LDN_RGB_KeyBoard_FirmwareV0.2-help
## Basic Information
- **Project Name**: LDN_RGB_KeyBoard_FirmwareV0.2-help
- **Description**: 李大拿的键盘固件V0.2说明
- **Primary Language**: Unknown
- **License**: GPL-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No
## Statistics
- **Stars**: 0
- **Forks**: 2
- **Created**: 2024-07-04
- **Last Updated**: 2024-07-04
## Categories & Tags
**Categories**: Uncategorized
**Tags**: None
## README
李大拿的键盘固件V0.2说明
=====================
LDN_RGB_KeyBoard_FirmwareV0.2-help
=====================
李大拿的键盘固件V0.2的帮助文件，各种设置功能的说明和例子等等，国际友人可以使用谷歌翻译来查看。
LDN keyboard firmware V0.2 help files, Explanations and examples of various setting functions, etc., international friends can use Google Translate to view.
****
Editor:LDN
****
## 驱动下载
**注意：低版本的固件，连接高版本的驱动，驱动软件会主动提示需要更新固件，并且在点击了提示的确定按钮后，会自动切换到BootLoader模式，此时直接选择固件文件并点击更新即可！不要再问切换到BootLoader的按钮为何点不了，因为已经是BootdLoader模式了。**
最新版本的驱动下载，已支持音乐律动（默认中文）：[下载](https://gitee.com/lswhome/LDN_RGB_KeyBoard_FirmwareV0.2-help/raw/master/Drivers/(20-09-21)LDN_KB_Drivers_v1.1_Chinese.rar)
The latest version of the driver download, has supported the music rhythm（Default Language English）：[DownLoad](https://gitee.com/lswhome/LDN_RGB_KeyBoard_FirmwareV0.2-help/raw/master/Drivers/(20-09-21)LDN_KB_Drivers_v1.1_English.rar)
最新版本的硬件配置工具下载（只有中文，无教程，配置键盘硬件的工具，错误的配置可能导致主控损坏，请三思）:[下载](https://gitee.com/lswhome/LDN_RGB_KeyBoard_FirmwareV0.2-help/raw/master/Drivers/(20-09-21)LDN_KB_Drivers_v1.1_English.rar)
****
## 更新日志
10:33 2020/8/29
1 版本升级到0.4.6
2 改进了按键矩阵扫描算法
9:45 2020/5/6
1 版本升级到0.4.5
2 增加对IS31FL3741 LED 驱动芯片的支持，使得扫描频率更高，视频拍摄不会闪烁
3 硬件上增加了电源管理，在相同的供电能力上，背光亮度会更高
17:21 2020/5/2
1 修复一个向上滚动的灯效，倒数第二行不点亮的BUG
2 修复触发层2合1键在切换了触发层之后，未配置为2合1键的层的对应按键无法触发的BUG
16:57 2020/4/11
1 固件更新到0.4.4，增加了以下2个功能
2 增加蜂鸣器功能，在驱动内可配置发声频率，发声时间等参数
3 增加编码器功能，并且编码器的编程功能被集成在功能层内，因此编码器也可以根据不同的层，具备不同的功能。
4 增加了灯效的单独开/关功能，便于控制灯效（在功能选择->灯光控制内）
11:49 2020/3/16
1 固件更新到0.4.3，修复了以下2个BUG
2 修复宏脚本在跨组跳转的时候，跳转无效的BUG。
3 修复FN键在更改或者取消之后，会导致原先被配置的FN键无法触发的BUG
15:28 2020/3/12
1 固件更新到0.4.2，增加了自动量产工具的批量自动配置功能；
14:24 2020/3/4
1 律动上位机增加了自动跟随系统音量的功能，开启后可自动根据系统音量调整律动幅度。
2 律动上位机修复了打开时如果没有在播放音乐，则不会刷新UI的BUG。
3 固件以及驱动无需更新。
11:55 2020/2/8
1 固件更新到0.4.1，WS2812的电平显示增益可在律动的上位机（C3_LDN_LedEffectTools.exe）上配置。
2 律动的上位机功能修改：
1 键盘的频谱波段可配置，可配置22个波段，每个波段可配置混合频段（0-60个），每个波段都可单独配置增益
2 UI显示的频谱波段可配置，可配置160个波段，每个波段可配置混合频段（0-60个），每个波段都可单独配置增益
3 UI显示的颜色可配置
4 UI显示的频谱参数可配置
5 采用了配置文件的方式，根据当前的采样率，会在.\LedEffCfg\文件夹内生成xxxxxConfig.ini（xxxxx=采样率）的配置文件，程序在打开的时候，会自动加载当前采样率匹配的配置文件
6 所有配置均为实时生效
3 虽然所有配置均为实时生效，但是只有在配置窗口关闭的时候，才会保存到配置文件内
4 混合频段默认为0（不混频），不要配置过多，否则会导致计算量大增，浪费CPU资源，建议左右频段混频加起来不超过10段
17:18 2020/1/28
1 固件更新到0.4.0，增加了WS2812的组内灯珠任意选择排序的功能
2 驱动配合固件已更新，必须更新键盘固件，才可以使用最新的功能，因此驱动连接后会要求更新固件。
13:38 2019/11/14
修复了上位机软件（驱动）在高分屏下UI显示错乱的BUG。
10:43 2019/11/3
修复了一个小问题：
当USB供电不足的时候，背光会闪烁，此时会导致背光驱动芯片重新启动，从而导致之前配置的显示矩阵错位，主要表现在右侧几列显示错位，本次更新通过实时侦测芯片重启，从而在重启后自动重新设置显示矩阵而修复这个BUG。
12:40 2019/11/2
**本次更新固件之后，之前的灯效配置会丢失，需要重新选择灯效。**
增加了WS2812的音乐电平显示功能，底灯或者四灯也支持音乐电平显示了（会根据音乐跳动）
支持修改不同版本的WS2812的颜色数据格式，默认是GRB格式
支持调整WS2812的亮度，每一组都是独立可调的亮度（通过损失颜色位数从而降低亮度），降低亮度从而降低了耗电，避免USB口供电不足
增加了新的背光驱动方案，同时兼容老的方案，消隐效果更好，驱动能力也更好（颜色更明亮鲜艳）
14:44 2019/10/12
修复了M4处理器的BIOS识别BUG
15:50 2019/8/20
修复了休眠模式无法唤醒的BUG
15:21 2019/8/14
增加了音乐律动支持，目前有2个律动灯效
16:15 2019/7/14
支持STM32F405/F407主控
17:19 2019/6/26
修复了驱动上的触发层编辑器中，【清空本层数据】功能，实际上是清空了，但是界面没有刷新的BUG。
12:08 2019/6/5
更新了英文语言包
10:53 2019/6/4
更新了3个灯效，固定灯效从0-14
更新了版本匹配逻辑，驱动与固件不匹配，无法使用
## 驱动文件说明：
Readme.txt ->自述文件
xxxx.ldn ->最新版本的固件
KeyBoardCode.ini ->USB键码配置文件
MediaKeyCode.ini ->多媒体键码配置文件
Skin.ini ->皮肤和语言配置文件
xxxx.bmp ->测试用的24位色BMP图片
LDNKBConfigTools.exe ->驱动主程序
**C3_LDN_LedEffectTools.exe ->律动的支持程序，要使用律动功能，必须打开这个程序，要使用律动，必须打开这个工具**
Update log.txt ->更新日志
ConfigFiles ->文件夹，保存不同的键盘的硬件配置文件和默认功能层0的键位
ConfigFiles\\[KeyBoard Name]\HWConfig.PhyCfg ->对应键盘的硬件配置文件
ConfigFiles\\[KeyBoard Name]\FunctionLayer_0_Config.FLCfg ->对应键盘的功能层0的配置文件
Language\xxx.ini ->对应语言的语言包，可自行翻译，按照格式即可
****
# 软硬件特性
#### 硬件特性
* 使用STM32F103(72Mhz) or STM32F405/407(168Mhz) ARM核心的处理器
* 独立的SPI FLASH芯片储存配置信息
* 独立的LED驱动芯片(MBI5042GP)具备16位PWM精度(RGB颜色：256x256x256=1677万色)，36/33.6Mhz PWM灰度时钟频率，最多可驱动128颗RGB全彩灯珠
* 行扫描频率从800~3000HZ连续可变
* 行扫描数量从1~8连续可变
* 按键矩阵从1x1到22x8可配置
* 硬件支持全健无冲
* 使用USB 1.1 HID协议
* 支持WS2812/SK6812 RGB灯珠通信协议
----
#### 软件特性
* 使用LDN自己研发的实时调度核心，提供极速的实时响应
* 矩阵键盘支持1~176个按键，连续可配置
* 软件支持全键无冲（NKRO）和6键无冲（6KRO）
* 1000Hz的USB回报率
* 1677万色的RGB背光灯
* 最多支持32颗 WS2812/SK6812 协议的RGB全彩氛围灯，可分4组配置灯效
* 支持四灯小板
* 可以自定义背光灯效
* 内置一些固定的全彩灯效，可随意切换展示
* **支持全局音乐律动，任何播放器都可以律动了**
* CAPS SCROLL NUM三个指示灯可以使用任意LED来指示（轴灯或者氛围灯）
* 当点亮或者熄灭三个指示灯的时候，可以编程为任意功能
* 具备配置功能工具(目前只有WINDOWS版本)，提供大量的实时可编程功能
* 几乎支持所有的USB键码和多媒体键码(有的键码需要操作系统支持)
* 强大的宏功能，可以模拟键盘的绝大多数操作，可控制键盘的几乎所有功能
* __所有的设置都是保存在键盘的SPI FLASH内，掉电不会丢失__
* __所有的重要设置，都可以保存为文件，便于保存和恢复以及共享给好友__
* __可以通过驱动软件恢复默认值，更新固件，就算故意中断固件的更新也不会损坏键盘__
----
#### 具备8个功能层，每个层独立又有关联，编程方式灵活易用
* 每一个功能层就相当于一个键盘
* 具备优先级规则，**优先级最高的最先扫描**，其后的按照0~7的顺序扫描
* 每个层的每个按键都可以独立配置 **[按键按下]** 事件和 **[按键释放]** 事件
* 每个层的每个按键都可以配置为具备的任何功能
* 每个层都有独立的开关
* 同时只能把一个层设置为最高优先级
* 当开关状态或者优先级改变的时候，驱动软件会同步显示
* 可以通过编程的方式，打开/关闭/设置某层为最高优先级
----
#### 具备8个触发层，每个层独立工作，可与8 个功能层的任意层搭配实现复杂的功能
* 每一个触发层可以配置8个FN键，任意键都可以是FN键，同时FN键还**支持条件触发功能**
* 每一个触发层可以配置48组组合键，配合FN键，可实现多种触发功能
* 每一个触发层可以配置64组连击键，一个按键变成N个按键的功能
* 每一个触发层可以配置64组二合一键
* 每一个触发层可以配置64组按下保持键，触发方式更灵活
* 同时只能激活一个触发层
* __触发层的优先级高于功能层__
* 可以通过编程的方式，自动激活某个触发层
----
# 说明文档的索引
## [基本知识点](Basic/README.md "点击跳转")
* [操作系统如何识别按键被按下和释放](Basic/README.md#操作系统如何识别按键被按下和释放 "点击跳转")
* [USB报告率](Basic/README.md#USB报告率 "点击跳转")
* [全键无冲/6键无冲](Basic/README.md#全键无冲6键无冲 "点击跳转")
* [1677万色](Basic/README.md#1677万色 "点击跳转")
----
## [功能层](FunctionLayer/README.md "点击跳转")
* [概述](FunctionLayer/README.md#概述 "点击跳转")
* [配置界面](FunctionLayer/README.md#功能层的配置界面 "点击跳转")
* [扫描规则](FunctionLayer/README.md#扫描规则 "点击跳转")
* [配置例子](FunctionLayer/README.md#配置例子 "点击跳转")
----
## [触发层](TriggerLayer/README.md "点击跳转")
* [概述](TriggerLayer/README.md#概述)
* [主界面](TriggerLayer/README.md#主界面)
* [管理功能](TriggerLayer/README.md#管理功能)
* [FN键配置](TriggerLayer/README.md#FN键配置)
* [组合键配置](TriggerLayer/README.md#组合键配置)
* [连击键配置](TriggerLayer/README.md#连击键配置)
* [二合一键配置](TriggerLayer/README.md#二合一键配置)
* [按下保持键配置](TriggerLayer/README.md#按下保持键配置)
* [配置示例](TriggerLayer/README.md#配置示例)
----
## [宏](Macro/README.md "点击跳转")
----
## [锁定键](KeyLock/README.md "点击跳转")
----
## [按键灯（轴灯）配置](KeyLedCfg/README.md "点击跳转")
----
## [扩展灯效和指示灯动作配置](ExLedEff_LedActionCfg/README.md "点击跳转")
----
## [自定义背光灯效](CustomLedEff/README.md "点击跳转")
----
## [系统功能](SystemCfg/README.md "点击跳转")
----
## [功能选择](FunctionSelect/README.md "点击跳转")
* [概述](FunctionSelect/README.md#概述)
* [常规按键](FunctionSelect/README.md#常规按键页面)
* [多媒体按键](FunctionSelect/README.md#多媒体按键页面)
* [开关控制](FunctionSelect/README.md#开关控制页面)
* [宏功能](FunctionSelect/README.md#宏功能页面)
* [灯光控制](FunctionSelect/README.md#灯光控制页面)
----
## [配置示例](Example/README.md)
* [通过FN键和层来实现更多功能](Example/README.md#通过FN键和层来实现更多功能)
* 更多的待更新...
----