OpenRGB

（以前为openaurasdk）

关于RGB的最大抱怨之一是围绕它的软件生态系统。每个制造商都有自己的应用程序，自己的品牌，自己的风格。如果您想混合使用和匹配设备，则最终会遇到大量冲突，功能相同的应用程序，这些应用程序争夺您的背景资源。最重要的是，这些应用是专有的，仅限窗口。有些甚至需要在线帐户。如果有一种方法可以从Windows和Linux上的单个应用程序中控制所有RGB设备，而没有任何胡说八道怎么办？这就是OpenRGB所列出的要实现的目标。一个统治它们的应用程序。

特征

• 为各种RGB硬件设置颜色并选择效果模式
• 保存和加载配置文件
• 使用OpenRGB SDK从第三方软件控制照明
• 命令行接口
• 连接OpenRGB的多个实例，以同步多PC
• 可以独立操作或在客户端/无头服务器配置中
• 查看设备信息
• 无需官方/制造商软件

支持的设备

有关当前支持设备的列表，请参见Wiki项目。

警告！

该项目提供了探测SMBU的工具。如果您不知道自己在做什么，这是一个潜在危险的操作。单击检测设备或转储设备按钮时，请注意。有报道称，挥发某些设备时，有严重问题的千兆内主板（将RGB砖或整个董事会进行砖头）。在同一行上，在Linux上使用I2CDUMP和I2CDETECT命令时，请谨慎行事，因为它们执行相同的功能。 OpenRGB对SMBUS访问不当造成的损害不承担任何责任。

截至目前，据报道，仅千兆字节RGB Fusion 2.0董事会存在问题。

视窗

• 在Gitlab的“发行版”部分下可用预构建的二进制文件。
• 如果您想自己构建应用程序：
  1. 下载最新的Visual Studio Community Edition和QT创建者。
  2. 在QT创建者中打开OpenRGB.PRO项目。
  3. 使用32或64位的MSVC编译器套件来构建应用程序。
  4. 从QT Creator运行项目。如果您想使用自定义构建独立的构建，请下载最新的匹配版本包，然后用新构建替换openrgb.exe。
• 您必须第一次以管理员的身份运行该应用程序，以允许InPout32设置。之后可以作为普通用户运行

USB访问

• 一些USB设备（尤其是键盘和鼠标）需要安装WinusB驱动程序。您可以使用Zadig做到这一点：
  • 下载Zadig：https：//zadig.akeo.ie/
  • 从菜单中选择“所有设备”
  • 选择设备的最后一个接口（最高数字）
  • 选择“ hinusb”，单击安装

Linux

• linux目前尚不可用的二进制文件
• 您可以使用QT创建者或命令行构建项目。
  1. 安装构建依赖项
     • Debian：sudo apt install build-esential qtcreator qt5-default libusb-1.0-0-0-dev libhidapi-dev pkgconf
     • Fedora：Sudo DNF安装Git Make Automake GCC GCC C ++ QT-CREATOR QT5-DEVEL HIDAPI-DEVEL-DEVEL LIBUSB-DEVEL
  2. git克隆https://gitlab.com/calcprogrammer1/openrgb
  3. CD OpenRGB
  4. qmake OpenRGB.pro
  5. 制作-j8
• 使用./openrgb运行应用程序

SMBUS访问

• SMBUS访问是控制RGB RAM和某些主板在板上LED所必需的。
• 如果您不尝试使用OpenRGB来控制RGB RAM或主板LED，则可以跳过此部分。
• 华硕和Asrock主板将其RGB控制器放在SMBUS接口上，该接口无法被未修改的Linux内核（目前）访问。我正在努力获取上游提交的补丁，但是现在您必须使用提供的OpenRGB.Patch文件来修补内核。
• 允许访问SMBU：
  1. 加载I2C-DEV模块： sudo modprobe i2c-dev
  2. 为您的芯片组加载I2C驱动程序：
     • 英特尔：
       • sudo modprobe i2c-i801
       • sudo modprobe i2c-nct6775主板LED的辅助控制器（需要补丁）
     • AMD：
       • modprobe i2c-piix4
       • 未修改的内核将具有一个接口，修补的内核将有两个。第一个在0x0b00，第二个位于0x0b20。 0x0b20接口适用于主板LED。
• 修补内核的说明：
  • https://gitlab.com/calcprogrammer1/openrgb/-/wikis/openrgb-kernel-patch
• 一些千兆字节/AORUS主板与SMBUS控制器有ACPI冲突。
  • 将acpi_enforce_resources=lax添加到内核命令行并重新启动。控制器现在应该出现。
• 如果您不作为root运行，则必须启用用户访问SMBU。
  • 列出所有SMBUS控制器： sudo i2cdetect -l
  • 注意PIIX4，I801和NCT6775控制器的数字。
  • 让用户访问这些控制器，例如： sudo chmod 777 /dev/i2c-0

USB访问

• USB设备需要UDEV规则以作为普通用户访问。
• 您可以运行OpenRGB作为根来检测所有USB设备。
• UDEV规则包含在此存储库中：
  • 将60-openrgb.rules文件复制到/etc/udev/rules.d/
  • 使用sudo udevadm control --reload-rules && sudo udevadm trigger

OpenRGB SDK

OpenRGB提供了一个网络接口，用于控制其他软件的支持的RGB设备。这些项目实施OpenRGB SDK，并为您提供控制照明设置的其他方法。

• 键盘可视化器（由我）：https：//gitlab.com/calcprogrammer1/keyboardvisualizer
• OpenRGB Python客户端（Bahorn）：https：//github.com/bahorn/openrgb-pyclient
• OpenRGB Python客户端（jath03）：https：//github.com/jath03/openrgb-python
• OpenRGB Node.js客户端（由Vlakreeh）：https：//github.com/vlakreeh/openrgb
• OpenRGB的D-Bus连接器（vinno97）：https：//github.com/vinno97/openrgb-dbus-connector
• OpenRGB E1.31接收器（由我）：https：//gitlab.com/calcprogrammer1/openrgbe131receiver
• OpenRGB.NET- C＃OpenRGB客户端（由Diogotr7）：https：//github.com/diogotr7/openrgb.net

使用的项目

• inpoutx64：http：//www.highrez.co.uk/downloads/inpout32/
• libusb：https：//github.com/libusb/libusb
• HIDAPI：https：//github.com/libusb/hidapi
• libe131：https：//github.com/hhhromic/libe131
• NVFC：https：//github.com/graphitemaster/nvfc
• Openrazer：https：//github.com/openrazer/openrazer
• OpenRazer-Win32：https：//github.com/calcprogrammer1/openrazer-win32
• qt-plus（colorwheel）：https：//github.com/liuyanghejerry/qt-plus
• AMD ADL库：https：//github.com/gpuopen-librariesandsdks/display-library

研究的项目

尽管这些项目中没有直接进入OpenRGB的代码，但这些项目是协议信息的宝贵资源。

• ckb-next：https：//github.com/ckb-next/ckb-next
• linux_thermaltake_riing：https：//github.com/chestm007/linux_thermaltake_riing
• AURA可寻址标头控制器：https：//gitlab.com/cneil02/aura-addressable-header-controller
• OpenPyaura：https：//gitlab.com/thelastguardian/openpyaura
• Asrled：https：//github.com/eua/asrled
• Asrock-LeD：https：//github.com/rattydave/asrock-leds
• hue-plus：https：//github.com/kusti8/hue-plus
• Rogauracore：https：//github.com/wroberts/rogauracore
• MSI-RGB：https：//github.com/nagisa/msi-rgb
• OpenCorsairlink：https：//github.com/audiohacked/opencorsairlink
• MSI-Keyboard：https：//github.com/bparker06/msi-keyboard
• rivalcfg：https：//github.com/flozz/rivalcfg
• vrmtool：https：//github.com/rbrune/vrmtool
• g810-led：https：//github.com/matmoul/g810-led
• Liquinctl：https：//github.com/jonasmalacofilho/liquidctl