G 键

让 OpenLogi 接管 G915 或 G913 的 G1–G5 和 M 键，可使用三个 M 配置，也可设为九个独立按键。

G915 和 G913 默认由键盘的板载内存运行 G1–G5。OpenLogi 可以接管整排 G 键。接管后，每个 G 键执行你绑定的动作，M1–M3 用于在三套绑定之间切换，也可以设为独立按键。

属性	说明
键盘	G915 与 G913。G915 X 使用另一套键盘图片，不显示 G 键。
HID++ feature	G1–G5 用 `0x8010` gamingGKeys，M1–M3 用 `0x8020` gamingMKeys，MR 用 `0x8030` macroRecord
绑定作用域	按物理设备保存，应用配置文件可以覆盖
平台	macOS、Linux 与 Windows

接管 G 键排

选择键盘，打开它的按键（Keys）标签页。开启替换全部板载 G 键操作（Replace all onboard G-key actions）。之后键盘图片上会显示 G1–G5 和 M 键。

键盘只有一个开关控制整排 G 键，所以 OpenLogi 会同时接管 G1–G5。OpenLogi 运行这排按键时，没有绑定的 G 键不执行任何操作。开始使用前，先绑定所有要用的 G 键。

关闭这个开关，整排按键交还给键盘，板载操作恢复。OpenLogi 退出时也会交还。键盘断电后会忘记接管状态，OpenLogi 会在键盘重新连接或唤醒后再次接管。

选择 M 键的用法

OpenLogi 运行这排按键时，按键标签页提供两种模式。

模式	M1–M3	G1–G5	MR
官方配置层（Official profiles，默认）	在 M1、M2、M3 三个配置之间切换 G1–G5	每个配置各一个绑定	保留板载功能
九键自定义（Nine custom buttons）	各一个绑定	各一个绑定，使用 M1 配置	一个绑定，仅限上报 `0x8030` 的键盘

在官方配置层模式下，键盘从 M1 开始。键盘重新连接或唤醒后，以及更改接管状态或模式后，都会回到 M1。按下当前配置的 M 键不会改变任何设置。切换到另一个配置时，仍被按住的 G 键会结束，按住的键不会按新配置的绑定松开。

在配置中绑定 G 键

在官方配置层模式下，点击键盘图片上的 M1、M2 或 M3，即可编辑该配置，对应的卡片会高亮。然后点击一个 G 键并选择动作。面板列出的动作与其他按键相同。要清除绑定，选择原生功能（Native function）。OpenLogi 运行这排按键时，清除绑定的 G 键不执行任何操作。

要给配置命名，点击它的 M 键，选择设置 M2 配置名称（Set M2 profile name，按钮会显示你点击的键）。输入名称，例如 工作，然后保存。键盘图片上的 M 键卡片会显示这个名称，M 键面板的标题显示为 M2 · 工作。保存空名称即可清除。名称只保存在 OpenLogi 的配置中，不会写入键盘。

配置

接管状态、模式和配置名称都是设备设置。G 键绑定与该设备的其他绑定放在一起。KeyG1–KeyG5 属于 M1 配置；其他配置在按键名前加 M2: 或 M3:。在九键自定义模式下，KeyM1–KeyM3 和 KeyMR 用于绑定 M 键。

[devices."unit:6be9d300"]
g_key_owner = "openlogi"      # 默认值："keyboard"
gaming_key_mode = "profiles"  # 或 "nine_buttons"

[devices."unit:6be9d300".g_key_profile_names]
M2 = "工作"

[devices."unit:6be9d300".bindings]
KeyG1 = "Copy"
KeyG2 = "Paste"
"M2:KeyG1" = "MuteVolume"

默认值 g_key_owner = "keyboard" 和 gaming_key_mode = "profiles" 不写入 config.toml。文件的其余部分见配置。

协议说明

G 键和 M 键协议没有公开的 Logitech 规格。OpenLogi 的实现参照 Solaar，并已在通过 USB 连接的 G915 上测试。接管前，OpenLogi 会读取 G 键数量，超过五个键的按键排会留给键盘处理。详见 0x8010 gamingGKeys、0x8020 gamingMKeys 和 0x8030 macroRecord。