CorsairLink plugin for Fan Control

The unofficial CorsairLink plugin for Fan Control.

[!IMPORTANT] This project is under active development, with frequent Beta releases that address issues and incorporate user feedback. These releases may include device-specific fixes and enhancements. Review the release notes for each version before selecting one to use and regularly check back for updates.

Device Support

1. Software mode only. Device lighting will be software-based.

2. The speed ramping in the Commander CORE and CORE XT is too slow for automatic sensor pairing and start/stop detection to function in Fan Control. Therefore, assisted setup will fail. Each control will need to be paired with its corresponding sensor manually and its start/stop values will need to be set manually.

3. Support is currently experimental and only available in a pre-release (see Releases). Please provide your feedback in issues and discussions.

4. Variable pump speed using the device's Quiet, Balanced, and Performance presets based on the control's percent value:

   Control %	Pump Mode
   0-33%	Quiet
   34-67%	Balanced
   68-100%	Performance

5. Reads the liquid temperature.

6. When the fan power is set to 0%, control of the fan will be returned to the PSU allowing zero-RPM operation. When the fan power is set to 1% or higher, control of the fan will be returned to Fan Control. The minimum duty depends on the model:

   PSU Model	Min. Duty
   HXi/RMi	30%
   AXi	15%

7. The LibreHardwareMonitor "PSU (Corsair)" sensor source must be disabled in Fan Control's Sensor Settings.

8. Requires driver installation and Windows 10/11 64-bit OS. See instructions (also included in download).

9. The default safety profile stored on the device may be overridden by setting the FANCONTROL_CORSAIRLINK_HYDRO_ASETEK_PRO_SAFETY_PROFILE_OVERRIDE_ENABLED environment variable to 1 and restarting Fan Control. This will write a new safety profile to the device:

   	Temp	Fan Duty
   Activate	58°C	100%
   Deactivate	57°C	-

10. As of v1.4.3, the minimum pump power is 50% (regardless of the requested power in Fan Control) to prevent a "pump failure" state and noise/resonance that may occur due to low pump RPM. Additionally, the default pump power is 100%. As of v1.6.0, the default minimum pump power is 50% but users may override this by setting the FANCONTROL_CORSAIRLINK_MIN_PUMP_DUTY environment variable to the desired minimum pump power.

11. Corsair One computers using the Hydro Platinum controller are supported. For liquid-cooled GPU models, GPU pump RPM and liquid temperature sensors are available, but GPU pump speed control is not yet supported. All supported models support CPU pump speed control.

iCUE LINK Support

Support for the iCUE LINK Hub was added in v1.5.0. The following LINK devices are supported:

Don't see your device listed? Open an issue and provide a USB packet capture.

1. The minimum pump power is 50% (regardless of the requested power in Fan Control). As a result, Fan Control's automatic control-sensor pairing may fail for these devices and the sensor must be paired manually. As of v1.6.0, the default minimum pump power is 50% but users may override this by setting the FANCONTROL_CORSAIRLINK_MIN_PUMP_DUTY environment variable to the desired minimum pump power.

Installation

[!WARNING] This plugin will not function correctly if Corsair iCUE and the "Corsair Service" service is running. These programs should be stopped before running Fan Control. Running incompatible programs that attempt to communicate with these devices while Fan Control is running is not a supported scenario.

[!WARNING] All versions of this plugin prior to v1.7.0 require the .NET Framework build of Fan Control. Install Fan Control using the FanControl_*_net_4_8.zip release files or the FanControl_*_net_4_8_Installer.exe installer only.

[!NOTE] Support for the .NET 8 build of Fan Control was added in v1.7.0-beta.1. As of this version, plugin builds are located within their respective directories. In step 4 below, the FanControl.CorsairLink.dll file will be located within the net48 or net8.0 directory. Choose the build that matches your Fan Control installation.

1. Download a release.
2. Unblock the downloaded ZIP file. (Right-click, Properties, check Unblock, OK)
3. Exit Fan Control.
4. Copy FanControl.CorsairLink.dll to Fan Control's Plugins directory.
5. Start Fan Control.

SiUsbXpress Driver

[!TIP] The SiUsbXpress driver is only necessary if:

• the Status of your device in the Device Support matrix has the 8 footnote superscript, e.g. Full Support ⁸
• the driver has not been installed previously (by Corsair iCUE or manually)

[!NOTE] The driver is only supported on:

• Windows 10 64-bit
• Windows 11 64-bit

To install the driver:

1. Ensure Fan Control is closed.
2. Ensure FanControl.CorsairLink.dll has been copied to Fan Control's Plugins directory.
3. Copy SiUSBXp.dll from the Corsair-SiUsbXpress-Driver directory to Fan Control's Plugins directory.
4. Right-click the CorsairSiUSBXp.inf file in the Corsair-SiUsbXpress-Driver directory and select Install. (This is a signed driver shipped with Corsair iCUE.)
5. Start Fan Control.

Configuration

This plugin reads the following Windows environment variables:

1. Supported models: Hydro Platinum (v1.6.0+)
2. Supported models: iCUE LINK, Commander CORE (v1.6.0+)

[!TIP] To set these values, start Run or Command Prompt and run rundll32 sysdm.cpl,EditEnvironmentVariables. Alternatively, use the setx command.

[!TIP] Fan Control must be restarted for changes to these environment variables to take effect.

Interoperability

This plugin implements a standard global mutex (Global\CorsairLinkReadWriteGuardMutex) to synchronize device communication.

Compatibility

Note: Any third-party software that properly implements the standard mutex for your devices will likely be compatible.