DeskHop项目在Ubuntu 22.04下的编译问题解决方案

问题背景

DeskHop是一个基于Raspberry Pi Pico的开源项目，用于实现键盘鼠标切换功能。在Ubuntu 22.04系统上进行编译时，开发者可能会遇到两个主要的构建错误。

第一个错误：编译器缺失

初始构建时出现的错误表明系统缺少ARM交叉编译工具链：

Compiler 'arm-none-eabi-gcc' not found

解决方案

这个问题可以通过安装ARM嵌入式工具链来解决：

sudo apt install gcc-arm-none-eabi

这个包提供了针对ARM Cortex-M系列处理器的交叉编译器，是开发RP2040（Raspberry Pi Pico使用的芯片）应用程序的必备工具。

第二个错误：变量声明位置问题

安装编译器后，构建过程中会出现另一个错误：

error: a label can only be part of a statement and a declaration is not a statement

这个错误发生在usb.c文件的tuh_hid_mount_cb函数中，具体是在case语句块内直接声明变量。

解决方案

这个问题是由于在switch-case语句中直接声明变量导致的。C语言标准要求在case标签后必须是一个语句，而变量声明不被视为语句。项目维护者已经修复了这个问题，将变量声明移出case块。

开发者可以通过以下方式解决：

1. 更新到最新代码
2. 或者手动修改代码，将变量声明移到case块之前

项目配置技巧

在成功构建项目后，开发者可能需要配置热键组合。DeskHop项目通过keyboard.c文件中的hotkey_combo_t结构体来实现这一功能。

例如，要设置左Shift+Caps Lock组合键，可以修改结构体初始化代码：

{
    .modifier = KEYBOARD_MODIFIER_LEFTSHIFT,
    .key = HID_KEY_CAPS_LOCK,
    .action = ACTION_SWITCH_TO_BOARD_B
}

总结

在Ubuntu 22.04上构建DeskHop项目时，开发者需要注意：

1. 确保安装正确的ARM交叉编译工具链
2. 遵循C语言的语法规则，特别是在switch-case语句中的变量声明
3. 理解项目的热键配置机制，以便自定义所需的按键组合

这些问题和解决方案不仅适用于DeskHop项目，对于其他基于RP2040的开发项目也有参考价值。理解这些底层原理有助于开发者更高效地进行嵌入式系统开发。