【K230/K230D新技能点亮】CanMV K230 新增键鼠支持，交互体验全面提升

Question

问题描述

CanMV K230 再添实用新技能——全面支持USB鼠标与键盘直连，即插即用、极简开发，AI交互场景直接解锁，开发效率拉满～

一、USB键鼠即插即用

无需复杂配置，无需额外驱动，CanMV K230 开发板USB口可直接连接鼠标/键盘，自动识别、快速响应，完美适配交互控制、参数调试、数据输入等场景。

✅ 鼠标支持：移动、左键/右键/滚轮操作，精准控制光标
✅ 键盘支持：全键输入、组合键响应，命令操作/文本录入超流畅
✅ 兼容性强：适配主流USB键鼠，免驱适配、稳定不掉线
✅ 开发友好：MicroPython接口简洁，几行代码即可实现键鼠事件监听

二、解锁多元开发场景

有了键鼠支持，CanMV K230 突破“纯视觉交互”限制，轻松落地更多高实用价值项目：

AI调试控制台：HDMI屏幕+键鼠组合，直接在开发板上调试代码、修改ISP参数、查看AI推理日志，无需频繁连接电脑；
智能终端控制：打造带交互的AI设备（如工业控制面板、智能显示器），鼠标操作菜单、键盘输入指令，体验媲美小型PC；
教育创新项目：搭配CanMV图形化编程，中小学生可快速开发“键鼠控制AI小游戏”“智能画板”等趣味项目，降低AI学习门槛；
离线数据录入：无网络场景下，通过键盘直接向AI设备录入数据、配置参数，适配野外监测、本地工控等场景。

三、 3步解锁键鼠功能

1.硬件准备

CanMV K230 开发板（如立创庐山派、01Studio开发板）
USB鼠标/键盘（或USB集线器，同时连接键鼠）
Type-C线（供电+串口调试）、HDMI屏幕（可选，用于显示交互界面）

2.软件配置

下载最新daily build固件
https://kendryte-download.canaan-creative.com/developer/releases/canmv_k230_micropython/daily_build/

3.核心代码示例（MicroPython）

参考代码：
鼠标demo：/sdcard/examples/03-Machine/usb_hid_mouse.py
键盘demo：/sdcard/examples/03-Machine/usb_hid_keyboard.py

import time
from usb import Mouse

def open_mouse():
    mouse = Mouse(timeout_ms=1000, auto_reconnect=True)
    
    #等待鼠标插入
    while True:
        try:
            mouse.open()
            info = mouse.info()
            print("USB mouse ready:", info)
            print("button masks:", Mouse.BTN_LEFT_MASK, Mouse.BTN_RIGHT_MASK, Mouse.BTN_MIDDLE_MASK)
            return mouse
        except OSError as err:
            print("waiting for USB mouse:", err)
            time.sleep_ms(500)

mouse = open_mouse()

while True:
    frame = mouse.read(1000)
    if not frame:
        continue

    moved = frame["has_rel"] or frame["has_abs"]
    button_edge = frame["pressed_mask"] or frame["released_mask"]
    wheel_move = frame["wheel"] or frame["hwheel"]

    if not moved and not button_edge and not wheel_move:
        continue

    print(
        "buttons=%d pressed=%d released=%d rel=(%d,%d) abs=(%d,%d) wheel=(%d,%d)" % (
            frame["buttons"],
            frame["pressed_mask"],
            frame["released_mask"],
            frame["rel_x"],
            frame["rel_y"],
            frame["abs_x"],
            frame["abs_y"],
            frame["wheel"],
            frame["hwheel"],
        )
    )

三、立即体验，开启AI交互新可能.

CanMV K230 USB键鼠功能已全面上线，升级固件+连接键鼠即可快速上手，无论是项目开发、教学实践还是创意DIY，都能让你的AI作品更具交互感～

参考文档：
https://www.kendryte.com/k230_canmv/zh/main/zh/api/extmod/usb_hid.html

xelll · Answer