Android键盘外设将你的Android设备变身为远程PC控制器的技术实现【免费下载链接】android-keyboard-gadgetConvert your Android device into USB keyboard/mouse, control your PC from your Android device remotely, including BIOS/bootloader.项目地址: https://gitcode.com/gh_mirrors/an/android-keyboard-gadget你是否曾想过在无法直接操作电脑时如何远程控制你的PC当面对BIOS设置、系统故障或远程服务器时传统的远程桌面方案往往力不从心。这正是android-keyboard-gadget项目要解决的核心问题——通过USB HID协议将Android设备转化为一个物理键盘和鼠标实现对PC的底层控制。为什么需要Android键盘外设传统的远程控制方案如VNC、RDP工作在操作系统层面当系统无法启动或需要进入BIOS/UEFI设置时这些方案就完全失效了。android-keyboard-gadget采用了一种创新的解决方案通过修改Android内核让设备通过USB连接时被识别为标准HID人机接口设备从而实现对PC的物理级控制。这种技术方案具有三大核心优势底层控制能力可以在BIOS、引导加载器、操作系统安装界面等任何环境下工作零网络依赖通过USB直连无需网络配置或驱动程序跨平台兼容任何支持USB HID协议的PC都能识别包括Windows、Linux、macOS技术架构从Android设备到PC键盘的转换android-keyboard-gadget的核心技术实现分为三个层次内核层USB HID设备模拟项目通过内核补丁在Android设备上创建了两个虚拟设备/dev/hidg0用于键盘模拟/dev/hidg1用于鼠标模拟。当Android设备通过USB连接到PC时PC会将其识别为标准的USB键盘和鼠标设备。内核补丁的适配是一个技术挑战项目提供了针对不同Android内核版本的补丁文件内核版本补丁文件支持设备示例3.0.xgeneric_kernel_3.01.patch早期Android设备3.4.xgeneric_kernel_3.04.patchNexus 4, LG G23.10.xgeneric_kernel_3.10.patch主流中端设备3.18.xgeneric_kernel_3.18.patch较新设备4.9.xgeneric_kernel_4.9.patch最新内核应用层hid-gadget-test工具项目提供了hid-gadget-test工具这是一个命令行实用程序允许你通过简单的Shell命令发送键盘和鼠标事件# 发送单个按键 echo a | ./hid-gadget-test /dev/hidg0 keyboard # 发送组合键CtrlAltDelete echo left-ctrl left-alt del | ./hid-gadget-test /dev/hidg0 keyboard # 鼠标操作 echo --b2 | ./hid-gadget-test /dev/hidg1 mouse # 右键点击这个工具的强大之处在于它的脚本化能力。你可以创建自动化脚本在设备连接时自动执行一系列操作#!/system/bin/sh # 当USB连接时自动执行命令 while true; do until echo volume-up | ./hid-gadget-test /dev/hidg0 keyboard /dev/null 21; do sleep 2 done echo USB连接已建立 # 执行自定义按键序列 for C in left-meta r c m d enter ; do echo $C ; sleep 0.3 done | ./hid-gadget-test /dev/hidg0 keyboard done图形界面远程控制客户端项目的remote-client目录包含完整的Android应用程序源码提供了直观的图形界面。这个应用实现了虚拟键盘和触摸板界面VNC服务器集成支持远程桌面控制摄像头PIN码输入功能用于安全验证场景实战应用破解PIN码的智能方案项目中最具创新性的应用是send-pin-with-camera模块。这个功能解决了传统PIN码破解中的关键问题当目标系统丢失按键事件时常见于macOS BIOS如何确保每个按键都被正确识别。摄像头验证机制send-pin-with-camera应用通过摄像头实时监测屏幕反馈确保每个按键都被系统接收通过hid-gadget-test发送按键使用摄像头捕获屏幕变化分析图像确认按键是否被识别根据反馈调整发送策略这种方法特别适用于需要精确按键确认的场景如BIOS密码恢复、系统解锁等。四位数PIN码破解示例项目提供了一个经典的4位数PIN码破解脚本# 暴力破解4位PIN码运行约42小时 for a in 0 1 2 3 4 5 6 7 8 9; do for b in 0 1 2 3 4 5 6 7 8 9; do for c in 0 1 2 3 4 5 6 7 8 9; do for d in 0 1 2 3 4 5 6 7 8 9; do echo $a $b $c $d for C in $a $b $c $d enter ; do echo $C ; sleep 0.2 done | ./hid-gadget-test /dev/hidg0 keyboard sleep 15 # 等待系统响应 done done done done设备兼容性与内核编译预编译内核镜像项目为多种设备提供了预编译的内核镜像存放在compiled目录中Google Nexus系列Nexus 4、5、6P、7Motorola Moto系列Moto G、Moto XSamsung Galaxy设备Sony Xperia系列其他主流Android设备自定义内核编译对于不在支持列表中的设备你需要自行编译内核。编译过程需要Linux环境主要步骤包括获取设备对应的内核源码应用适当的补丁文件配置编译环境编译内核和boot.img关键的环境变量设置export PATHpwd/arm-eabi-4.8/bin:$PATH export ARCHarm export SUBARCHarm export CROSS_COMPILEarm-eabi-SELinux权限配置现代Android设备通常启用SELinux这会限制对/dev/hidg*设备的访问。你需要修改SELinux策略# 临时禁用SELinux不推荐 setenforce 0 # 或者添加永久规则 type hid_gadget_device, dev_type; /dev/hidg(.*) u:object_r:hid_gadget_device:s0 allow appdomain hid_gadget_device:chr_file rw_file_perms;事件格式理解HID协议键盘事件格式键盘事件使用8字节数据结构偏移量长度字段说明01字节修饰键位掩码Ctrl、Shift、Alt等11字节保留字段2-76字节当前按下的普通键最多6个修饰键位掩码定义typedef enum { LCTRL 0x1, // 左Ctrl LSHIFT 0x2, // 左Shift LALT 0x4, // 左Alt LSUPER 0x8, // 左Windows键 RCTRL 0x10, // 右Ctrl RSHIFT 0x20, // 右Shift RALT 0x40, // 右Alt RSUPER 0x80, // 右Windows键 } ModifierKeys_t;鼠标事件格式鼠标事件使用4字节数据结构第1字节鼠标按键状态左键、右键、中键第2字节X轴移动偏移有符号第3字节Y轴移动偏移有符号第4字节滚轮偏移有符号最佳实践与性能优化设备选择建议老旧Android设备适合作为专用控制设备续航时间长且成本低Root权限确保设备已获取root权限否则无法访问/dev/hidg*设备USB连接稳定性使用高质量USB线缆避免连接中断脚本优化技巧按键延迟调整根据目标系统响应速度调整sleep时间错误处理检查hid-gadget-test返回值确保命令执行成功连接检测监控/sys/devices/virtual/hidg/hidg0/dev文件变化检测USB连接状态安全考虑仅在受信任设备上使用避免在公共或不受信任的设备上使用物理安全确保控制设备不会被未经授权的人员访问使用场景限制仅用于合法的系统管理、故障排除目的扩展应用场景android-keyboard-gadget的技术不仅限于远程控制还可应用于自动化测试自动化UI测试、游戏脚本录制辅助功能为行动不便用户提供替代输入方案教育演示计算机教学中的输入设备原理演示安全研究系统安全测试、密码恢复研究技术挑战与解决方案兼容性挑战不同Android设备的内核版本和硬件架构差异巨大。项目通过提供多种内核补丁版本和详细的编译指南来解决这个问题。对于新设备开发者需要确定设备的内核版本选择合适的补丁文件可能需要调整补丁以适应特定硬件性能优化实时键盘事件传输对延迟敏感。项目通过以下方式优化性能使用直接文件I/O操作避免中间层开销最小化事件数据包大小提供批量操作接口减少系统调用次数可靠性保障为确保可靠的数据传输项目实现了连接状态检测机制错误重试逻辑事件确认反馈通过摄像头验证未来发展方向随着Android内核的演进android-keyboard-gadget项目也在不断更新ConfigFS支持对于内核版本≥3.19的设备可以使用USB Gadget Tool替代内核补丁更多设备支持持续增加对新设备的支持功能扩展计划支持更多HID设备类型如游戏手柄、绘图板等通过android-keyboard-gadget你将Android设备的潜力发挥到了新的高度。无论是系统管理员需要远程管理服务器还是开发者需要进行自动化测试这个项目都提供了一个强大而灵活的工具。最重要的是它展示了开源社区的创新精神——将日常设备转化为专业工具解决实际的技术挑战。【免费下载链接】android-keyboard-gadgetConvert your Android device into USB keyboard/mouse, control your PC from your Android device remotely, including BIOS/bootloader.项目地址: https://gitcode.com/gh_mirrors/an/android-keyboard-gadget创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
