跳到主要内容

GITALLER 升级固件教程

下载固件​

提示

请完全解压后使用，不要在压缩包内直接运行。

固件升级教程​

  1. 解压缩固件压缩包

    将下载的固件压缩包解压到本地文件夹。

  2. 确保 USB 未连接

    确保 GITALLER 的 USB 接口没有连接 PC。

  3. 进入固件升级模式

    同时按下 START + SELECT 按键不松手，将 GITALLER 的 USB 接口插入 PC。USB 插入 PC 后，START + SELECT 可以松开手。

    按下 START + SELECT

    插入 USB

  4. 打开固件升级程序

    打开 GITALLER_firmware_APP.exe 程序。

    打开程序

  5. 加载固件文件

    点击 LoadFile 按钮，找到下载固件的文件夹，选择 GITALLER_firmware_V1.0_20200926.bin 文件。

    点击 LoadFile

    选择固件文件

  6. 开始升级

    点击 Start 按钮，开始升级固件。等待进度条完成。

    点击 Start

    等待进度条

  7. 升级完成

    显示成功后，重新插拔 GITALLER USB 接口（重要）。

    升级成功

    注意

    如果没有成功，从步骤 3 开始重新再操作一遍。

固件升级后，功能简介​

WAILING 按键模式​

该模式为默认，无需切换。

同时按下 B1+B2+B3+B4+B5+SELECT，持续 2 秒，屏蔽陀螺仪 XYZ 轴输出，wailing_up 和 wailing_down 作为按键输出。

WAILING 按键模式

WAILING XYZ 模式​

该模式适合高级玩家使用，初级玩家请不要切换。

同时按下 B1+B2+B3+B4+B5+START，持续 2 秒，屏蔽 wailing_up 和 wailing_down 的按键输出，陀螺仪 XYZ 轴正常输出。

WAILING XYZ 模式

解决的问题​

  1. 在 GITADORA trial 1.0 上，START 按键是 START 功能，SELECT 按键是 HELP 功能
  2. 在 DTXmania 设置时，请使用 WAILING BUTTON 模式，wailing_up 和 wailing_down 这 2 个按键都要做映射
  3. 在 S tools 和 B tools 使用时，如果映射 XYZ 轴，请切换到 WAILING XYZ 模式；如果映射 wailing_up 和 wailing_down 这 2 个按键，请切换到 WAILING BUTTON 模式

在 GITADORA trial 上的设置图​

在 GITADORA trial 中，第 1 个按键显示为 0，wailing_up 显示为 10，wailing_down 显示为 11。

GITADORA trial 设置

在 DTXmania 上的设置图​

在 DTXmania 中，第 1 个按键显示为 1，wailing_up 显示为 11，wailing_down 显示为 12。

DTXmania 设置

包管理器安装示例​

npm install gitaller-tools
提示

如果无法解决问题，请邮件联系我们。我们会协助你完成升级。

样式组件展示​

以下展示本站可用的 CSS 样式组件，供文档编写参考。

带箭头图标和路径提示的链接卡片，适合在页面底部引用相关文档。

GITALLER 升级固件教程getting-started/gitaller-firmware-guide 快速开始getting-started/quick-start

带封面图的卡片，适合展示游戏模式或功能模块。

WAILING 按键模式

WAILING 按键模式

默认模式，wailing_up 和 wailing_down 作为按键输出。

WAILING XYZ 模式

WAILING XYZ 模式

高级模式，陀螺仪 XYZ 轴正常输出。

更紧凑的卡片变体，适合列表展示。

固件程序

固件升级程序

开始升级

开始升级流程

升级成功

升级成功确认

两列并排图片展示，适合对比或展示多个截图。

GITADORA 设置

DTXmania 设置

左：GITADORA trial 设置图 / 右：DTXmania 设置图

带虚线下划线的悬浮提示链接，适合术语解释。

这是一段包含 GITALLER 术语的文本，鼠标悬停可看到提示信息。也可以作为链接使用：固件升级指南。

柔和描述 (Subtle Description)​

这是一段柔和描述文本，适合在标题或内容下方添加次要说明信息，字体较小且带有透明度。

提示框 (Admonitions)​

备注

这是一个 note 提示框，用于一般性说明。

提示

这是一个 tip 提示框，用于有用的建议。

信息

这是一个 info 提示框，用于补充信息。

警告

这是一个 warning 提示框，用于注意事项。

危险

这是一个 danger 提示框，用于严重警告。

代码块样式​

Shell 命令（自动添加 $ 前缀）​

cd firmware-folder
./GITALLER_firmware_APP.exe

标准代码高亮​

server.lua
-- 这是一个 Lua 脚本示例
local player = Player()
player:SetName("TestPlayer")
print("Hello from nanos world!")
example.js
// JavaScript 示例
const config = {
  name: "GITALLER",
  version: "1.0",
  buttons: ["B1", "B2", "B3", "B4", "B5"],
};
console.log(config.name);

可折叠区域 (Details)​

点击展开详细信息

这里可以放置较长的内容，默认情况下处于折叠状态。

  • 支持 Markdown 格式
  • 支持粗体和 代码
  • 支持列表

引用块 (Blockquote)​

这是一段引用文本，适用于强调或引述。Docusaurus 自定义了引用块的背景色和边框样式。

表格样式​

按键GITADORA trialDTXmania
第 1 个按键01
wailing_up1011
wailing_down1112

脚本图标 (Scripting Icons)​

API 文档中使用的可用性和类型图标：

Server Only 仅服务端 Client Only 仅客户端 Both 双端可用 Authority 仅授权端


Native 原生类型 Not Native 非原生类型