当前位置：首页 > news >正文

用CircuitPython和Raspberry Pi Pico给LOL琴女写个“外挂”：自动打人机刷级全流程（附完整代码）

news 2026/4/21 16:03:37

用CircuitPython打造游戏自动化神器：从硬件连接到智能脚本全解析

当微控制器遇上游戏操作，会碰撞出怎样的火花？CircuitPython作为一款对初学者友好的嵌入式编程语言，搭配Raspberry Pi Pico这类高性能微控制器，能够实现许多有趣的硬件自动化项目。本文将带你从零开始，构建一个基于物理按键模拟的游戏辅助设备，涵盖硬件选型、环境搭建、代码编写到实际调试的全流程。

1. 硬件准备与环境搭建

1.1 核心硬件选型

构建游戏自动化设备的第一步是选择合适的硬件组件。以下是经过实测验证的推荐配置：

组件	型号	备注
主控板	Raspberry Pi Pico	性价比高，GPIO丰富
连接线	Micro USB数据线	用于供电和编程
扩展板	无	本项目无需额外扩展板
其他	杜邦线若干	用于测试连接

为什么选择Raspberry Pi Pico？

价格亲民，约4美元
双核ARM Cortex-M0+处理器，133MHz主频
264KB SRAM和2MB闪存
26个多功能GPIO引脚
支持USB 1.1主机/设备

1.2 CircuitPython固件烧录

访问CircuitPython官网下载页面，找到Raspberry Pi Pico对应的UF2文件
按住Pico板上的BOOTSEL按钮同时插入USB线，将其置于下载模式
将下载的UF2文件拖入出现的RPI-RP2磁盘
等待自动重启后，会出现一个名为CIRCUITPY的磁盘

提示：首次烧录后，建议执行一次硬件复位以确保所有功能正常初始化

1.3 开发环境配置

虽然可以直接在CIRCUITPY磁盘上编辑code.py文件，但推荐使用专业编辑器：

# 推荐工具列表 tools = { "编辑器": ["Mu Editor", "VS Code+CircuitPython插件"], "串口监视器": ["PuTTY", "CoolTerm"], "库管理": ["CircUp"] }

安装必要库的命令：

circup install adafruit_hid circup install circuitpython_schedule

2. HID设备模拟原理与实现

2.1 理解USB HID协议

Human Interface Device (HID)是USB设备中用于人机交互的一类协议，包括键盘、鼠标等。我们的Pico将通过模拟这类设备向电脑发送输入信号。

关键特性：

无需额外驱动，操作系统原生支持
低延迟，响应速度快
支持多种输入报告格式

2.2 CircuitPython中的HID实现

在CircuitPython中，我们主要使用adafruit_hid库来实现设备模拟。核心类包括：

from adafruit_hid.keyboard import Keyboard from adafruit_hid.keycode import Keycode from adafruit_hid.mouse import Mouse # 初始化HID设备 kbd = Keyboard(usb_hid.devices) mouse = Mouse(usb_hid.devices)

常用键盘操作示例：

# 单键按下释放 kbd.send(Keycode.W) # 组合键 kbd.send(Keycode.CONTROL, Keycode.W) # 长按与释放（用于移动等操作） kbd.press(Keycode.SHIFT) time.sleep(2) kbd.release_all()

2.3 鼠标控制精要

精确控制鼠标需要理解几个关键点：

相对移动：mouse.move(x,y)中的参数是相对于当前位置的偏移量
绝对定位限制：无法直接获取屏幕坐标，需要通过多次相对移动实现
点击类型：支持左键、右键和中键点击

# 典型鼠标操作序列 mouse.move(x=100) # 右移100像素 mouse.move(y=-50) # 上移50像素 mouse.click(Mouse.LEFT_BUTTON) # 左键单击

3. 游戏自动化脚本设计

3.1 操作流程分解

一个完整的游戏自动化流程通常包含多个阶段，我们需要将其分解为可编程的步骤：

匹配阶段
- 点击开始游戏按钮
- 接受对局
英雄选择阶段
- 定位英雄头像
- 点击选择
- 确认锁定
游戏内阶段
- 技能释放循环
- 装备购买
- 移动控制

3.2 定时任务管理

使用circuitpython_schedule库可以方便地管理周期性任务：

import circuitpython_schedule as schedule # 设置各种技能的释放间隔 schedule.every(0.9).seconds.do(follow) # 跟随队友 schedule.every(60).seconds.do(release_w) # W技能 schedule.every(10).seconds.do(release_e) # E技能 schedule.every(4).seconds.do(upgrade) # 技能升级 # 主循环 while True: schedule.run_pending() time.sleep(0.1)

3.3 容错与调试机制

在实际运行中，脚本可能会遇到各种意外情况，需要加入适当的容错处理：

LED状态指示：使用板载LED显示脚本运行状态
异常捕获：对可能失败的操作添加重试逻辑
位置校准：定期重置鼠标位置防止累积误差

led = digitalio.DigitalInOut(board.GP25) led.direction = digitalio.Direction.OUTPUT def cursor_reset(): """重置鼠标位置到屏幕中心区域""" for _ in range(3): # 多次移动确保到位 mouse.move(x=-3000) mouse.move(y=-3000) mouse.move(x=383) mouse.move(y=259) led.value = True # 点亮LED表示校准完成 time.sleep(0.5) led.value = False

4. 性能优化与高级技巧

4.1 降低系统资源占用

长时间运行的脚本需要特别注意资源管理：

减少不必要的打印输出
优化sleep时间间隔
使用生成器代替列表存储大数据

# 优化前后的对比 # 优化前 def old_way(): positions = [(100,200), (150,300), ...] # 大列表 for pos in positions: mouse.move(*pos) # 优化后 def position_generator(): while True: yield (100,200) yield (150,300) # ... gen = position_generator() def new_way(): mouse.move(*next(gen))

4.2 动态参数调整

通过外部输入（如按钮）实时调整脚本参数：

import board from digitalio import DigitalInOut, Direction, Pull btn = DigitalInOut(board.GP15) btn.direction = Direction.INPUT btn.pull = Pull.UP def check_button(): if not btn.value: # 按钮按下 global delay_time delay_time = max(0.1, delay_time - 0.05) # 减少延迟 led.value = True time.sleep(0.3) led.value = False

4.3 多脚本管理与切换

使用文件系统实现不同场景脚本的切换：

import os import supervisor def load_script(name): if name + ".py" in os.listdir("/scripts"): with open("/main.py", "w") as f: f.write(f"import scripts.{name}\n") supervisor.reload()

5. 实际应用中的注意事项

5.1 硬件连接稳定性

使用优质USB线材，避免供电不足
如果使用外部按钮，确保接触良好
避免GPIO引脚短路

5.2 游戏兼容性考虑

不同游戏、不同分辨率下的坐标差异需要调整：

# 分辨率相关参数 SCREEN_WIDTH = 1920 SCREEN_HEIGHT = 1080 def scale_position(x, y): """将相对坐标转换为实际移动值""" return ( int(x * 65535 / SCREEN_WIDTH), int(y * 65535 / SCREEN_HEIGHT) )