56 lines
2.5 KiB
Markdown
56 lines
2.5 KiB
Markdown
# OpenAuraSDK
|
|
##### This project is an open-source implementation of the Asus Aura RGB controller software. It currently only supports a limited number of motherboard and RAM module lighting controllers.
|
|
|
|
## Supported Devices
|
|
|
|
Confirmed supported motherboards:
|
|
- ASUS PRIME X370 Pro
|
|
- ASUS PRIME X470 Pro
|
|
- ASUS PRIME Z270-A
|
|
- ASUS PRIME Z370-A
|
|
- ASUS ROG Strix Z370-E
|
|
|
|
Confirmed supported RGB RAM (except on X299):
|
|
- G.Skill Trident Z RGB
|
|
- Geil Super Luce
|
|
- TeamGroup Delta RGB
|
|
|
|
Experimental support in generic RGB testing branch:
|
|
- Corsair Vengeance RGB
|
|
- Corsair Vengeance Pro RGB
|
|
- HyperX Predator RGB
|
|
|
|
## Installation
|
|
#### Windows
|
|
1. Download the latest Visual Studio Community Edition and open the `.sln`.
|
|
2. Build the project for `x86` Architecture. The InpOut32 library I use does not support x64.
|
|
3. Copy InpOut32.dll from dependencies to the same path as OpenAuraSDK.exe.
|
|
|
|
**You may have to retarget the project to the latest version of the Windows SDK and build tools and stuff.**
|
|
|
|
**You must run the application as Administrator the first time to allow InpOut32 to set up. It can be run as a normal user afterwards**
|
|
|
|
#### Linux:
|
|
1. Either open the project using QT Creator or build it using qmake.
|
|
|
|
cd OpenAuraSDK
|
|
qmake OpenAuraSDK.pro
|
|
make
|
|
|
|
|
|
2. Allow access to SMBus:<br>
|
|
|
|
- This can be identified by your motherboard
|
|
##### Intel
|
|
- `modprobe i2c-dev i2c-i801`
|
|
- Asus used the SMBus controller on the Super IO chip for on-board Aura chips on Intel motherboards. I have a kernel patch to add a driver for this chip [here](https://gitlab.com/CalcProgrammer1/OpenAuraSDK/issues/22). After patching the kernel, enable the Nuvoton NCT67xx SMBus driver in your kernel configuration. The driver may be loaded with `modprobe i2c-nct6775`
|
|
##### AMD
|
|
- `modprobe i2c-dev i2c-piix4`
|
|
- The second SMBus isn't currently picked up by the kernel driver and that seems to be where Asus wired the Aura controllers so I have a kernel patch [here](https://gitlab.com/CalcProgrammer1/OpenAuraSDK/issues/9) that will allow the kernel to use the second bus (at `0x0b20`).
|
|
|
|
- You'll have to enable user access to your SMbus if you don't run as root.
|
|
- List all SMBus controllers: `sudo i2cdetect -l`
|
|
- Find out which control your Aura devices (PIIX4, I801, and NCT67xx)
|
|
- Give user access to those controllers, for instance: `sudo chmod 777 /dev/i2c-0`
|
|
|
|
|