{"id":13577526,"url":"https://github.com/electrified/asus-wmi-sensors","last_synced_at":"2026-01-24T23:28:21.610Z","repository":{"id":49757440,"uuid":"159860934","full_name":"electrified/asus-wmi-sensors","owner":"electrified","description":"Linux HWMON (lmsensors) sensors driver for various ASUS Ryzen and Threadripper motherboards","archived":false,"fork":false,"pushed_at":"2023-08-30T08:32:14.000Z","size":79,"stargazers_count":253,"open_issues_count":10,"forks_count":29,"subscribers_count":20,"default_branch":"master","last_synced_at":"2025-04-05T12:33:09.384Z","etag":null,"topics":["asus","driver","linux","ryzen","sensors","wmi"],"latest_commit_sha":null,"homepage":"","language":"C","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/electrified.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null}},"created_at":"2018-11-30T18:05:15.000Z","updated_at":"2025-03-30T20:32:15.000Z","dependencies_parsed_at":"2024-01-16T20:24:21.121Z","dependency_job_id":"e3b34d78-ba0b-47ee-8bd7-0451327ee6f9","html_url":"https://github.com/electrified/asus-wmi-sensors","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/electrified/asus-wmi-sensors","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/electrified%2Fasus-wmi-sensors","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/electrified%2Fasus-wmi-sensors/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/electrified%2Fasus-wmi-sensors/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/electrified%2Fasus-wmi-sensors/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/electrified","download_url":"https://codeload.github.com/electrified/asus-wmi-sensors/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/electrified%2Fasus-wmi-sensors/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28738991,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-24T22:12:27.248Z","status":"ssl_error","status_checked_at":"2026-01-24T22:12:10.529Z","response_time":89,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["asus","driver","linux","ryzen","sensors","wmi"],"created_at":"2024-08-01T15:01:22.228Z","updated_at":"2026-01-24T23:28:19.410Z","avatar_url":"https://github.com/electrified.png","language":"C","funding_links":[],"categories":["HarmonyOS","C"],"sub_categories":["Windows Manager"],"readme":"# Linux ASUS WMI Sensor driver\n\n## This driver has been integrated into the kernel mainline as of version 5.17 :smiley:\nThanks to @0lvin this driver has been merged into the kernel mainline. https://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git/tree/drivers/hwmon/asus_wmi_sensors.c?h=v5.17\n\n## General info\n\nProvides a Linux kernel module \"asus_wmi_sensors\" that provides sensor readouts via ASUS' WMI interface present in the UEFI of some X370/X470/B450/X399 Ryzen motherboards.\n\n**Note: X570/B550/TRX40 boards do not have the WMI interface and are not supported.**\n\n## Features\n- Reports all values scaled and named identically to in the UEFI interface\n- No sensor configuration required\n\n## Supported hardware\n\n|Board                              | Minimum BIOS Version |\n|-----------------------------------|----------------------|\n|Asus ROG Crosshair Hero VII (WiFi) | 1002                 |\n|Asus ROG Crosshair Hero VII        | 1002                 |\n|Asus ROG Crosshair Hero VI         | 6301                 |\n|Asus ROG Crosshair Hero VI (WiFi)  | 6302                 |\n|Asus ROG Crosshair Hero VI Extreme | ?                    |\n|ROG STRIX B450-E GAMING            | 2406                 |\n|ROG STRIX B450-F GAMING            | 2406                 |\n|ROG STRIX B450-I GAMING            | 2406                 |\n|ROG STRIX X470-F GAMING            | 5007                 |\n|ROG STRIX X470-I GAMING            | ?                    |\n|ROG STRIX X399-E GAMING            |                      |\n|ASUS Zenith Extreme                | 1607/1701            |\n|ASUS Zenith Extreme Alpha          | 0207                 |\n|Prime X399-A                       | 1002                 |\n|Prime X470-Pro                     | 4602                 |\n\n## Currently don't work / unknown\n\n|Board                              |\n|-----------------------------------|\n|X570 boards (no WMI interface - use `nct6775` driver instead)|\n|B550 boards (no WMI interface - use `nct6775` driver instead)|\n|TRX40 boards (no WMI interface - use `nct6775` driver instead)|\n|Prime B450-Plus|\n|Prime X370-Pro|\n|TUF B450-PLUS GAMING|\n|TUF X470-PLUS GAMING|\n\n## How to install\n\nEnsure you have lm_sensors, DKMS, kernel sources, GCC etc installed. Kernel version 4.12 or later is required. \n\nIf you have built your own kernel, it must have been built with CONFIG_HWMON (found under Device Drivers) and CONFIG_ACPI_WMI (found under Device Drivers -\u003e X86 Platform Specific Device Drivers) enabled. It is not necessary to have built the \"ASUS WMI Driver\" (CONFIG_ASUS_WMI) module.\n\n### Arch Linux\nAvailable as an AUR package - https://aur.archlinux.org/packages/asus-wmi-sensors-dkms-git/\n\nThis hooks into DKMS to build a module for your available kernels and adds a ```/etc/module-load.d/``` entry so the module is loaded at boot.\n\nThe module can be manually loaded by issuing ```sudo modprobe asus_wmi_sensors```\n\nRun ```sensors``` and you should see a ```asuswmisensors-isa-0000``` device and readouts as you see in the UEFI interface.\n\n### Gentoo\nAn ebuild is available in gyakovlev's overlay. https://github.com/gyakovlev/gentoo-overlay/tree/master/sys-kernel/asus-wmi-sensors\n\n### NixOS\nAvailable as a package since 20.03 release, could be enabled with:\n\n```\nboot.extraModulePackages = with config.boot.kernelPackages; [\n    asus-wmi-sensors\n];\n```\n\n### Other distributions\n\nClone the git repository: ```git clone https://github.com/electrified/asus-wmi-sensors.git```\n\nBuild the module ```sudo make dkms```\n\nInsert the module ```sudo modprobe asus-wmi-sensors```\n\nRun ```sensors``` and you should see a ```asuswmisensors-isa-0000``` device and readouts as you see in the UEFI interface.\n\nOptional - consult your distro's documentation for info on how to make the module be loaded automatically at boot\n\n## FAQ\n\n### I think my motherboard should be supported but it doesn't work, what can I do?\nFirst verify that WMI hardware monitoring is working for your board under Windows. Both HWiNFO (https://www.hwinfo.com/) and SIV(http://rh-software.com/) will make use of ASUS WMI for reading sensors if available. If your board is supported by those, post the output of ```sudo dmidecode -t baseboard``` and it should be possible to add support.\n\n### Why do some of my temperatures return 216 deg C?\nThis is the value returned for temperature sensor headers with no sensor connected.\n\n### Why are some of the sensors (e.g. CPU Core Voltage) duplicated?\nThe driver simply returns all the sensors available in the WMI output. CPU Voltage and others are included twice, in the Embedded Controller and SIO banks.\n\n### Why is reading from the sensors so slow?\nThis driver is not reading from the SuperIO/ Embedded controller directly, it uses a WMI interface put in the UEFI firmware by ASUS. Reading from this WMI interface seems inherently slow. I am investigating calling the underlying ACPI methods that the WMI interface calls which I have been told performs better.\n\n### Why does this driver exist?\nMany of Asus' recent Ryzen motherboards have the ITE IT8665E sensor IC, which does not have any publicly available datasheets. Some support has been added to the out-of-tree IT87 driver, but this is currently unmaintained and not working on recent kernels. Also many Windows drivers are moving to use this WMI interface rather than accessing the chip directly as this avoids conflicts when multiple monitoring apps attempt to read the sensors simultaneously.\n\n### Why have you created a new driver and not added to the existing Asus/eeepc drivers?\n- The existing drivers are basic platform devices rather than using the kernels' WMI bus\n- These new sensor methods are on a different WMI class - \"ASUSHW\" than the existing \"ASUSManagment\" class which the other driver uses. The existing driver largely deals with laptop functionality (hotkeys, WiFi kill switches, screen brightness). Adding to that driver support for this additional sensors functionality would make it quite large.\n\n### Is it possible to control the speed of fans with this driver?\nNo, fan control is not part of the Asus sensors WMI interface. It may be possible via an undocumented method, but that would require reverse engineering effort.\n\n### I am using Ubuntu with a Ukuu kernel and the module won't build\nIf you use ukuu, or any other method to install a kernel, you should use the version of GCC used to build the kernel to build any additional out-of-tree modules otherwise you may run into issues.\n\nCheck `cat /proc/version` to see the version of GCC used to build the kernel, and upgrade your GCC install appropriately. (Usually an upgrade from GCC 7 to GCC 9 is needed)\n\n## Example sensors output\n\n```\nasuswmisensors-isa-0000\nAdapter: Virtual device\nCPU Core Voltage:         +0.88 V  \nCPU SOC Voltage:          +1.13 V  \nDRAM Voltage:             +1.34 V  \nVDDP Voltage:             +0.24 V  \n1.8V PLL Voltage:         +1.85 V  \n+12V Voltage:            +11.88 V  \n+5V Voltage:              +5.01 V  \n3VSB Voltage:             +3.33 V  \nVBAT Voltage:             +3.18 V  \nAVCC3 Voltage:            +3.36 V  \nSB 1.05V Voltage:         +1.07 V  \nCPU Core Voltage:         +0.81 V  \nCPU SOC Voltage:          +1.14 V  \nDRAM Voltage:             +1.35 V  \nCPU Fan:                  749 RPM\nChassis Fan 1:              0 RPM\nChassis Fan 2:            904 RPM\nChassis Fan 3:            888 RPM\nHAMP Fan:                   0 RPM\nWater Pump:                 0 RPM\nCPU OPT:                    0 RPM\nWater Flow:                 0 RPM\nAIO Pump:                   0 RPM\nCPU Temperature:          +37.0°C  \nCPU Socket Temperature:   +31.0°C  \nMotherboard Temperature:  +28.0°C  \nChipset Temperature:      +45.0°C  \nTsensor 1 Temperature:   +216.0°C  \nCPU VRM Temperature:      +31.0°C  \nWater In:                +216.0°C  \nWater Out:                +28.0°C  \nCPU VRM Output Current:   +1.00 A \n```\n\n## Known Issues\n - The WMI implementation in some of Asus' BIOSes is buggy. This can result in fans stopping, fans getting stuck at max speed, or temperature readouts getting stuck. This is not an issue with the driver, but the BIOS. The Prime X470 Pro seems particularly bad for this. The more frequently the WMI interface is polled the greater the potential for this to happen. Until you have subjected your computer to an extended soak test while polling the sensors frequently, don't leave you computer unattended. I can personally say I've seen the issue on the Crosshair VII with BIOS 2606 and a Ryzen 2700X, upgrading to 3004 rectified the issue.\n - A few boards report 12v voltages to be ~10v. Once again this is a BIOS issue.\n\n## Thanks\n- Ray Hinchcliffe, author of SIV for info\n- Original authors of the IT87 makefile\n- Authors of other mainlined HWMON kernel modules that I've studied while writing this\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Felectrified%2Fasus-wmi-sensors","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Felectrified%2Fasus-wmi-sensors","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Felectrified%2Fasus-wmi-sensors/lists"}