FreeJoy Configurator使用教程：三步完成你的自定义游戏控制器设置

【免费下载链接】FreeJoySTM32F103 USB HID game device controller with flexible configuration项目地址: https://gitcode.com/gh_mirrors/fr/FreeJoy

FreeJoy是一款基于STM32F103芯片的USB HID游戏设备控制器，通过FreeJoy Configurator软件，你可以轻松打造专属的游戏控制设备。本文将带你快速掌握配置流程，让普通硬件秒变专业游戏控制器！

📋 准备工作：认识FreeJoy Configurator

FreeJoy Configurator是一款直观的图形化配置工具，支持Windows系统。在开始配置前，请确保你已完成以下步骤：

1. 克隆项目仓库：git clone https://gitcode.com/gh_mirrors/fr/FreeJoy
2. 准备FreeJoy硬件（如STM32F103开发板）
3. 安装USB驱动（通常系统会自动识别）

图：FreeJoy从硬件到成品控制器的完整配置流程

🔧 第一步：连接设备与软件

1. 将FreeJoy硬件通过USB连接到电脑
2. 打开FreeJoy Configurator软件（可在项目仓库中找到可执行文件）
3. 在软件左上角设备选择框中，确认"FreeJoy Black"已显示"Connected"状态

图：FreeJoy Configurator v1.4.1b4主界面，显示设备连接状态和引脚配置区域

⚙️ 第二步：基础配置（以按钮设置为例）

FreeJoy Configurator提供了丰富的配置选项卡，包括：

• Pin Config：引脚功能分配
• Button Config：按钮参数设置
• Axes Config：模拟轴配置
• LED：灯光效果设置

快速设置单个按钮：

1. 点击"Pin Config"选项卡
2. 在右侧引脚列表中找到需要配置的引脚（如A0）
3. 点击引脚对应的下拉菜单，选择"Button_Single"
4. 切换到"Button Config"选项卡，设置按钮的触发方式和响应参数

提示：高级用户可通过application/Inc/buttons.h文件自定义按钮逻辑

💾 第三步：保存与应用配置

完成配置后，只需两步即可将设置应用到硬件：

1. 点击左侧"Write Config to Device"按钮（设备需处于连接状态）
2. 等待日志区域显示"Config written successfully"
3. （可选）点击"Save Config to File"将配置保存为.fcfg文件，方便下次使用

配置文件默认保存在用户文档目录，也可通过utils/crc16.c中的校验算法了解配置文件的加密方式

🎮 开始使用你的自定义控制器

配置完成后，FreeJoy设备会被系统识别为标准HID游戏控制器，可直接用于：

• 赛车游戏方向盘
• 飞行模拟器摇杆
• 自定义宏键盘
• 工业控制设备

如果需要调整配置，只需重新连接设备并重复上述步骤即可。

❓ 常见问题解决

• 设备无法连接：检查USB线是否接触良好，尝试重新安装驱动
• 配置不生效：确认已点击"Write Config to Device"，必要时点击"Reset All Pins"重置
• 硬件兼容性：目前支持STM32F103系列芯片，其他型号需修改MDK-ARM/FreeJoy/FreeJoy.sct链接脚本

通过FreeJoy Configurator，即使是电子新手也能在几分钟内完成专业级游戏控制器的配置。立即开始你的自定义控制器之旅吧！

【免费下载链接】FreeJoySTM32F103 USB HID game device controller with flexible configuration项目地址: https://gitcode.com/gh_mirrors/fr/FreeJoy