企业官网建设流程全解析

键盘上加一块小屏幕已经不是新鲜玩法，但真正要把 LT168B 这类副屏显示模块稳定集成到键盘上，让屏上同时显示键盘层状态、电量、系统占用和通知信息，很多人会在接线、驱动和数据源三个环节被卡住。这次我们直接拆 LT168B 键盘副屏显示方案：它适合放在哪些键盘上，需要用什么样的控制器，Windows 和 Linux 下如何把数据喂给屏幕，以及装完后怎么验证它不会干扰原来的按键输入。

从搜索关键词的分布来看，来搜 LT168B、键盘副屏、显示方案的人，通常不只是想点亮一块单片机屏幕，而是在纠结：我的机械键盘能不能加副屏、蓝牙键盘加屏会不会影响续航、加完屏之后是不是还要跑一套驱动软件。下面的内容按这三类需求组织，先给出核心规格，再给部署路径，最后是测试和排错清单。

由于 LT168B 在多数材质里是作为“整块显示组件/驱动板”的名称出现，不同批次可能对应不同驱动 IC，所以动手前最重要的一步不是急着刷固件，而是确认模块丝印、接口定义和供电电压。这篇文章中提到的接线和命令都是通用可复现模板，具体参数需要按你手头的模块规格书调整。

1. 核心能力速览

首段结论：LT168B 键盘副屏显示方案的核心价值不是把一块屏塞进键盘外壳，而是让显示屏的数据来源变得可控。最稳妥的起步方式是把显示模块当成一块独立 USB 小屏，先用上位机验证显示效果，确认刷新率、亮度和发热满足要求后，再考虑把它内嵌到键盘内部。一上来就拆键盘改线，容易把原来的主控或者轴体供电搞坏。

2. 适用场景与使用边界

2.1 适合谁

• 机械键盘 DIY 玩家：希望在不换键盘的情况下加一块小屏幕，显示当前键盘层、大小写状态、Lock 指示灯或者自定义 LOGO。
• 经常切换 Windows 和 Linux 的开发者：需要一块低功耗信息屏，用来显示 CPU 占用、内存占用、当前键盘映射层或编译状态。
• 关注蓝牙键盘续航的用户：蓝牙键盘加屏最怕耗电，LT168B 方案如果使用低刷新率的静态显示，可以用 IOC 控制点亮时间，睡眠后基本不耗电。
• 想要键盘驱动可视化的人：常规键盘驱动只能改改键位和灯效，副屏显示方案可以把“当前处于哪个层、哪些键被映射过”直接显示在键盘上。

2.2 不适合谁

• 不想焊接、不想改外壳、不接受任何代码调试的用户。LT168B 方案虽然可以做成 USB 即插即用，但通用成品程度不如量产键盘的官方副屏。
• 需要用原生闭源键盘固件并且不允许刷机、不允许逆向的用户。不要在未确认固件备份的情况下强行刷写键盘主控。
• 对超薄无线键盘有强迫要求的用户。任何内嵌屏幕都会增加厚度和耗电，超薄键盘内部空间往往放不下屏幕驱动板。

2.3 使用边界与合规提醒

• 键盘主控固件的备份和恢复必须在本地完成，刷写前确认自己拥有设备，不传播未经授权的固件或驱动文件。
• 如果显示器内容涉及人脸、聊天记录、账号凭证、公司内部信息，不要在公共场合把副屏当作常亮通知面板，避免信息泄露。
• 自定义显示中使用的字体、图标、GIF、壁纸，注意授权边界。商用作品需要确认素材授权。
• 本文中的接线和代码是通用调试模板，不构成对特定 LT168B 模块和特定键盘型号的适配承诺。

3. 本地部署环境准备与前置条件

3.1 硬件准备清单

如果是第一次接触 LT168B，不要直接采购一堆物料。比较省成本的做法是：先确认手头有 ESP32 开发板或者 Arduino 主控，再买一块接口简单、资料多的 LT168B 模块。屏幕到手后先桌面点亮，确认能显示字符了，再进入键盘改造阶段。

3.2 软件环境

Windows 环境：

# 安装 Python 用于串口调试和上位机脚本 python -m pip install --upgrade pip pyserial requests psutil # 如果使用 AIDA64 的 LCD 功能，安装 AIDA64 后在 Preferences -> LCD 中选择对应显示屏类型

Linux 环境：

sudo apt update sudo apt install -y python3 python3-pip python3-serial git pip3 install --user requests psutil pyserial

macOS 环境：macOS 上主要用 Python 脚本和原生支持的 HID 设备来读取键盘状态，显示端建议走 USB 小屏模式，避免对蓝牙协议栈做太深的改动。

3.3 空间和供电检查

键盘副屏显示方案最常见的问题不是代码，而是空间。键盘 PCB 上方如果有定位板和轴下垫，留给屏幕的区域通常不足 10 毫米。在拆键盘之前，先用卡尺量三个数据：PCB 到上盖内侧的高度、 USB 数据线走线区域宽度、键盘内部是否有金属加强筋。如果空间紧张，优先选不带触摸板的裸屏模块，并把驱动板通过软排线翻折到 PCB 背面。

供电上要特别小心。很多小尺寸 LCD 模块的背光电流在 20-60mA 左右，从键盘主控 3.3V 引脚取电通常会拖低主控电压，导致按键失灵或者 USB 掉线。更稳妥的判断原则是：键盘主控的 3.3V 引脚只给逻辑供电，不要承担背光电流；背光使用单独的 5V 供电，或者从 USB 电源线上取电。蓝牙键盘则必须独立测量整机静态电流，屏幕显示时要控制在主板设计余量内。

4. 安装部署与启动方式

LT168B 键盘副屏显示方案可以分成三条实现路径。建议按顺序尝试，先跑通独立 USB 小屏，再进入键盘内嵌阶段。

4.1 路径 A：独立 USB 小屏方案

这是最简单、风险最低的玩法。把 LT168B 模块配合一个 USB 转接主控，让电脑把它识别成一个串口设备或者自定义 HID 设备，然后由上位机通过串口把系统信息实时推送到屏幕。

接线示意如下（以下引脚为常见 SPI LCD 模块通用定义，实际以模块标注为准）：

如果只想快速看到效果，可以先用 ST7789、SSD1306 等常见驱动库的框架跑一个屏幕初始化，再用一个简单 Python 脚本通过串口接收上位机发来的文本并显示。下面是通用文本刷新脚本思路，不依赖厂商私有上位机：

import serial import time # 串口设备名按实际系统修改 ser = serial.Serial("/dev/ttyUSB0", 115200, timeout=0.5) # 简易帧格式：帧头+长度+文本内容 def send_text(text: str): payload = text.encode("utf-8") frame = b"\xAA" + bytes([len(payload)]) + payload + b"\x55" ser.write(frame) time.sleep(0.02) while True: # 从命令行读取用户输入进行测试 line = input("输入要显示的文本: ") send_text(line)

上位机软件端建议设置如下：串口波特率 115200，刷新频率 1Hz。先不要做高频刷新，因为高刷新率会大幅占满屏幕驱动资源，并且可能让主控发热。低分辨率文字显示场景下，0.5-1Hz 的刷新间隔已经足够。

4.2 路径 B：键盘内嵌状态屏方案

这种玩法的核心是“显示屏和键盘状态联动”。我们需要知道当前大小写状态、当前按键层、Fn 组合键状态，然后把这些状态实时渲染到屏幕上。

如果键盘主控支持二次开发，可以在固件中把状态数据通过串口输出。如果键盘主控是闭源的，则不建议强行拆主控读取数据，可以使用一个折中方案：在电脑端通过 HID 查询键盘状态，然后通过 USB 小屏模块显示。Windows 上可以用 Python 的hidapi读取键盘的 LED 状态，Linux 上可以通过/sys/class/leds读取大写锁定灯状态。

Linux 下获取 CapsLock 状态并推送屏幕的示例：

#!/usr/bin/env bash # 读取 Linux 键盘状态并发送到串口，路径按实际系统替换 SERIAL_PORT=/dev/ttyUSB0 while true; do if [ "$(cat /sys/class/leds/input*::capslock/brightness 2>/dev/null)" = "1" ]; then echo "CAPS ON" > "$SERIAL_PORT" else echo "CAPS OFF" > "$SERIAL_PORT" fi sleep 1 done

如果显示器固件实现了更完善的自定协议，可以使用结构化 JSON 内容。需要注意的是，不要直接把字符串塞给所有屏幕驱动，很多小屏固件只接受定长文本帧，强烈建议在屏幕驱动端实现简单的文本缓存和刷新控制。

4.3 路径 C：蓝牙键盘低功耗副屏方案

蓝牙键盘加副屏的核心难点在功耗。屏幕不能一直亮着，驱动 IC 不能一直处于刷新状态。比较合适的做法是：键盘日常使用息屏，只有按下 Fn+某些组合键时点亮，显示按键结果或者电池余量 3-5 秒，随后自动休眠。

具体实现上，可以用键盘主控的一个 GPIO 控制屏幕电源，屏幕内容更新完成后立即进入睡眠。ESP32 方案可以用esp_deep_sleep唤醒定时器，但这要求整块屏的供电独立可控。更常见的思路是主控检测到按键事件后，点亮屏幕 5 秒，之后再拉低背光引脚。

// Arduino/ESP32 风格伪代码：按键事件驱动屏幕点亮 // 实际需要按 LT168B 模块驱动库调整 void onKeyPressed() { // 点亮背光 digitalWrite(BL_PIN, HIGH); // 更新显示内容 display.print("FN Layer: 2"); display.refresh(); // 5 秒后关背光 disableBacklightAfter(BL_PIN, 5000); }

这里有一个非常重要的判断：如果你的蓝牙键盘是量产成品，并且没有预留副屏数据接口，不建议通过拆解蓝牙主控的方式读取键盘状态，那样很容易破坏天线匹配和功耗调校。稳妥方案还是“键盘状态由电脑端软件读取，屏幕通过独立 USB 通道显示”，也就是路径 A 的变体。

5. 功能测试与效果验证

部署完成后不要马上装机封壳，先做一轮功能测试。测试的基本逻辑是：验证屏幕本身、验证数据链路、验证键盘联动、验证功耗稳定性。

5.1 屏幕点亮和分辨率测试

测试目的：确认 LT168B 模块能够正常初始化并显示测试画面。

操作步骤：

1. 使用主控板单独驱动屏幕。
2. 烧录官方示例或者通用驱动库测试程序。
3. 观察屏幕能否显示纯色画面、字符和几何图形。

预期结果：屏幕画面没有花屏、局部颜色异常、闪烁。

判断标准：连续运行 30 分钟无花屏，重启后能自动恢复。

常见失败点：

• 接线不对，尤其是 CS、DC、RES 三根控制线的顺序。
• 供电电压和模块不匹配。
• 驱动 IC 型号与代码不一致，初始化序列错误会导致花屏或者白屏。

5.2 文本刷新测试

测试目的：验证上位机到屏幕端的数据链路。

操作步骤：

1. 打开串口助手，波特率设置与固件一致。
2. 发送英文、数字和中文字符。
3. 观察屏幕刷新结果。

预期结果：文字清晰，无乱码，刷新间隔控制在 200ms 以上时没有明显撕裂。

判断标准：连续发送 100 条文本，至少 100 条都没有出现错误帧；如果支持返回 ACK，根据 ACK 判断是否丢帧。

失败排查：先检查文本编码是否一致。小屏幕常用的 GBK 或 UTF-8 编码在驱动端必须统一，否则中文会变成乱码。

5.3 键盘按键功能回归测试

副屏装上键盘后，最怕影响原有按键输入。这一步需要回归测试：

1. 测试大小写锁定、数字锁定、滚动锁定是否正常。
2. 测试 Fn 组合键和自定义宏是否正常。
3. 测试键盘在没有连接屏幕软件的情况下是否仍能正常输入。

预期结果：屏幕关闭或者软件不运行时，键盘本身就是一个标准输入设备，不能出现按键连发、延迟飙升。

判断标准：用在线键盘测试工具按下一圈按键，事件响应小于系统常规标准即可。

常见问题：如果屏幕软件占用键盘事件监听钩子，可能导致按键在部分全屏游戏中失效。此时应该在软件里增加“退出时释放键盘监听”逻辑。

5.4 蓝牙键盘续航影响测试

蓝牙键盘如果内嵌了副屏，需要测量三种状态的动态电流：

测试时用带电流曲线的电源或者 USB 电流表记录 24 小时数据。如果静态电流明显上升，说明屏幕没有真正进入睡眠，需要检查背光引脚是否被拉高，或者驱动 IC 的睡眠命令是否执行。

6. 接口 API 与批量任务

很多用户把键盘副屏装好后，希望它能显示更多内容：系统温度、编译进度、定时提醒、自定义通知。这时候不应该继续用串口助手手动发消息，而是给 LT168B 显示方案设计一个可复用的发布接口。

6.1 串口更新协议

建议定义一种简单、可靠的文本帧协议，例如：

{ "type": "text", "content": "CPU: 35%", "line": 1, "font_size": "medium", "duration_sec": 5 }

上位机把 JSON 序列化后发送到串口，屏幕端解析后渲染。缺点是 JSON 解析会占微控制器资源，低端主控上面建议只在小数据量时使用。

低资源设备的方案是定长二进制帧：

Python 发送端示例：

import serial ser = serial.Serial("COM3", 115200, timeout=0.5) def make_frame(command: int, data: bytes) -> bytes: length = len(data) frame = bytearray() frame.append(0xAA) frame.append(command) frame.append(length) frame.extend(data) check = 0 for b in frame: check ^= b frame.append(check) return bytes(frame) frame = make_frame(0x01, "CPU: 35%".encode("utf-8")) ser.write(frame)

6.2 通过网络接口推送

如果屏幕端使用 ESP32 等带 WiFi 的控制器，可以直接开放一个本地 HTTP 服务，这样上位机只需要访问一个 URL 就能更新显示内容，不用一直占用串口。

# 通用 HTTP 服务模板 from flask import Flask, request, jsonify app = Flask(__name__) @app.route("/display", methods=["POST"]) def display(): data = request.get_json() content = data.get("content", "") line = data.get("line", 1) # 在这里把 content 转发给 LT168B 屏幕驱动 print("line:", line, "content:", content) return jsonify({"ok": True}) if __name__ == "__main__": app.run(host="0.0.0.0", port=8765)

调用示例：

curl -X POST http://127.0.0.1:8765/display \ -H "Content-Type: application/json" \ -d '{"line": 1, "content": "build done"}'

6.3 批量任务设计

如果需要管理多台键盘副屏或者多个显示节点，建议不要把显示逻辑写死在单片机上，而是采用“统一数据源 + 显示节点”的结构：

• 数据源：读取系统状态、任务队列状态、通知消息。
• 订阅模式：每个键盘屏通过 HTTP 长轮询或 TCP 连接订阅自己的显示内容。
• 推送端：批量更新任务时按设备 ID 分组发送，对失败节点保留重试队列。

批量任务最小配置示例：

{ "devices": [ {"id": "keyboard_01", "ip": "192.168.1.101", "screen_line": 1}, {"id": "keyboard_02", "ip": "192.168.1.102", "screen_line": 2} ], "content": "Release v2.3 deployed", "retry_times": 3, "timeout_sec": 2 }

批量推送不是一定要用重量级消息队列，对于几十台设备的场景，使用requests循环加超时重试就够了。如果设备数量上百台，再引入 MQTT 或 Redis 发布订阅，避免 HTTP 连接占满资源。

7. 资源占用与性能观察

键盘副屏显示方案的资源占用可以从屏幕端和电脑端两方面观察。

7.1 屏幕端资源占用

屏幕驱动代码建议在以下维度做内存估算：

• 显示缓冲区：如果使用全屏缓冲，需要根据屏幕分辨率和色深计算。比如 1.3 寸 240x240 的单色屏只有 7200 字节左右，但 RGB565 彩色屏会占到 240x240x2约 112KB，对 STM32F103 这类资源紧张的芯片来说需要谨慎设计。实际容量以模块规格书为准，不要在低配主控上硬上全屏彩色缓冲。
• 文本缓存：优先使用双缓冲切换，避免刷新时出现画面撕裂。
• 字库存储：中文字符库会占 Flash，显示简单 ASCII 字符的占用会小很多。

调试时建议把 FPS、刷新耗时、内存余量打印到串口日志。刷新耗时超过 200ms 时，不适合做高频动画。

7.2 电脑端资源占用

使用系统监控软件推送数据时，CPU 占用通常与刷新频率和数据采集方式有关。采集psutil这类系统数据时，用 1 秒一次的定时器足够，不要在一个循环里不停读取/proc文件。

Windows 上如果使用 AIDA64 的 LCD 插件，建议先关闭不需要的监控项目，只保留 CPU 占用、内存、键盘状态等必要项。

观察方法可以是同时打开任务管理器，确认上位机软件进程的 CPU 占用不高于 5%，内存占用不高于 100MB 属于常见可接受范围；超过该范围时，要检查是否是软件刷屏频率过高导致渲染线程占满。

7.3 如何降低性能影响

• 低频刷新：默认 1Hz，动态通知时才临时提高到 5Hz。
• 局部更新：很多小屏驱动支持局部区域刷新，可以只在变化区域重绘。
• 减少字体平滑：在低分辨率屏上，字体抗锯齿效果不明显却很耗 CPU。
• 后台服务化：上位机释放键盘钩子，状态变化时再触发显示更新，不要所有事件都强制刷屏。

8. 常见问题与排查方法

遇到键盘相关的疑难问题，可以先移除所有屏幕相关组件，把键盘恢复成原始标准键盘，验证输入是否正常。如果恢复后仍有问题，那问题一般出在键盘本身或者系统软件层面，不一定是副屏显示模块造成的。

9. 最佳实践与使用建议

9.1 先做好最小可运行配置

建议把“点亮屏幕 + 显示一行文本 + 自动休眠”作为最小可运行目标。先不要追求复杂的系统监控、动画和动态壁纸。最小可运行配置跑通后，备份一份固件，之后每次改动都在这个备份上迭代。

在工程目录中建议这样组织资源：

lt168b-keyboard-display/ ├── firmware/ # 屏幕驱动和键盘状态采集固件 ├── tools/ # 上位机脚本、批量推送脚本 ├── assets/ # 字体、图标、动画素材，注意记录授权 ├── logs/ # 串口日志、批量任务日志 └── config/ # 各设备配置文件，按设备 ID 区分

9.2 数据源、键盘状态、输出显示解耦

不要让屏幕显示模块直接去解析键盘矩阵并控制按键行为。键盘输入是安全敏感功能，显示和数据采集部分应该与按键事件解耦。最理想的设计是按键状态通过消息队列发布，显示模块订阅这些事件，只读不改。

9.3 批量任务和上线前检查

批量推送内容之前，建议先推送一条测试帧，等待 ACK，再推送正式内容。如果内容包含时间戳、天气、构建状态等动态数据，一定要考虑数据源不可用时的降级显示，例如显示“--:--”而不是让屏幕保留上一次的过期数据。

9.4 版权和隐私合规

自定义字体、开机动画、图标、图片素材不要随意传播。尤其注意商用字体授权。副屏上不要常驻显示包含私人凭证、二维码、验证码、内部会议链接等敏感信息的信息面板，特别是在直播或录屏场景下要提前关闭。

10. 总结与下一步

LT168B 键盘副屏显示方案最值得尝试的点，是先把它做成独立 USB 信息屏，跑通文本显示和数据链路，再决定是否真正拆键盘内嵌。第一步需要验证模块本身的接口和初始化代码，第二步是让内容刷新稳定，第三步才是考虑供电、空间和休眠功耗问题。

最容易踩的坑有三个：一是忽略模块供电差异，导致背光把主控电压拖垮；二是屏幕刷新和键盘输入事件没有解耦，出现按键丢失的假象；三是蓝牙键盘场景下没有做超时熄屏，续航明显下降。把这三点提前规避掉，整个方案的成功率会高很多。

后续可以继续扩展的方向包括：OLED/墨水屏低功耗显示、USB HID 免驱小屏、通过 MQTT 接入智能家居状态、联动键盘驱动显示当前层和宏命令。建议先收藏这篇模板，动手时对照规格表逐步验证。