sys-con 技术文档

sys-con 技术文档

sys-con Nintendo Switch sysmodule that allows support for third-party controllers 项目地址: https://gitcode.com/gh_mirrors/sy/sys-con

概述

sys-con 是一个专为 Nintendo Switch 设计的自定义系统模块，它旨在支持第三方游戏控制器，无需中间人设备。当前版本仅支持通过USB连接的控制器。此项目适用于固件版本 5.0.0 及以上的 Atmosphère 越狱环境。

安装指南

1. 获取最新发布: 访问项目的 Releases 页面，下载最新的zip文件。

2. 解压到SD卡: 将下载的zip文件解压缩，并将其全部内容放置到您的Switch的SD卡根目录下。

3. 启动或重启Switch: 解压后，简单地重启您的Switch，sys-con将自动加载。

使用说明

sys-con 自带配置功能，位于 sdmc:/config/sys-con/ 目录下：

• 调整设置: 配置文件夹内提供了stick和触发器的死区调整选项，以及输入的重新映射能力。参考同目录下的 example.ini 文件了解详情。对这些文件所做的任何修改都将即时生效。

API使用文档

请注意，sys-con主要是作为一个系统模块而非库提供服务，因此直接的API调用不适用。然而，开发者可以通过源代码（在 source 目录下）了解到其内部工作原理，从而进行二次开发或扩展。

开发者构建指南

1. 正确克隆仓库: 不要直接以ZIP形式下载，而应该使用git客户端递归克隆（例如Git Bash、Github Desktop等），确保子模块也被正确获取。

2. 环境准备: 确保您的开发环境已安装了 devkitA64，并且需要特定版本的libnx，指向提交哈希 [b35d42f](https://github.com/switchbrew/libnx/commit/b35d42faaa60b02662aaaf0702614f6e4afcbbbc)。为此，您需要克隆libnx仓库，检出指定的提交，并执行 make install。

3. 构建项目:

   • 使用 make -j8 并行编译，加快构建速度，可根据自身硬件性能调整-j后的数字。
   • 执行 make clean 清理项目生成的文件，但不会影响依赖项。
   • 运行 make mrproper 完全清理，包括依赖项。

如果您使用 Visual Studio Code，可以直接打开项目文件夹并利用内置的构建任务进行编译，且预设了针对Switch开发的Intellisense环境，前提是你已经正确设置了DEVKITPRO环境变量。

---

此文档意在为sys-con用户提供安装及基本使用指导。对于想要深入理解和开发的用户，探索源码将会是最佳途径。记住，对于如蓝牙支持等功能，可查看 MissionControl 项目。

sys-con Nintendo Switch sysmodule that allows support for third-party controllers 项目地址: https://gitcode.com/gh_mirrors/sy/sys-con