You cannot select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
zenpower3/README.md

53 lines
2.6 KiB
Markdown

2 years ago
# Zenpower3
2 years ago
Zenpower3 is a Linux kernel driver for reading temperature, voltage(SVI2), current(SVI2) and power(SVI2) for AMD Zen family CPUs, now with Zen 3 support!
4 years ago
Make sure that your Linux kernel have support for your CPUs as Zenpower is using kernel function `amd_smn_read` to read values from SMN. A fallback method (which may or may not work!) will be used when it is detected that kernel function `amd_smn_read` lacks support for your CPU.
4 years ago
For AMD family 17h Model 70h (Ryzen 3000) CPUs you need kernel version 5.3.4 or newer or kernel with this patch: https://patchwork.kernel.org/patch/11043277/
4 years ago
4 years ago
## Installation
2 years ago
You can install this module via DKMS.
4 years ago
2 years ago
### Installation for Ubuntu
```sh
4 years ago
sudo apt install dkms git build-essential linux-headers-$(uname -r)
cd ~
2 years ago
git clone https://github.com/Ta180m/zenpower3.git
cd zenpower3
4 years ago
sudo make dkms-install
```
2 years ago
### Installation for Arch
You can install the [AUR package](https://aur.archlinux.org/packages/zenpower3-dkms/).
### Installation for Fedora 35+
You can install it from the [copr package repo](https://copr.fedorainfracloud.org/coprs/birkch/zenpower3/)
4 years ago
## Module activation
Because zenpower is using same PCI device as k10temp, you have to disable k10temp first. This is automatically done by the AUR package.
4 years ago
1. Check if k10temp is active. `lsmod | grep k10temp`
2. Unload k10temp `sudo modprobe -r k10temp`
3 years ago
3. (optional*) blacklist k10temp: `sudo bash -c 'sudo echo -e "\n# replaced with zenpower\nblacklist k10temp" >> /etc/modprobe.d/blacklist.conf'`
4 years ago
4. Activate zenpower `sudo modprobe zenpower`
3 years ago
*If k10temp is not blacklisted, you may have to manually unload k10temp after each restart.
4 years ago
## Sensors monitoring
You can use the `sensors` command, [zenmonitor3](https://github.com/Ta180m/zenmonitor3), or your favorite sensors monitoring software.
## Update instructions
1. Unload zenpower `sudo modprobe -r zenpower`
2. Goto zenpower directory `cd ~/zenpower`
3. Uninstall old version `sudo make dkms-uninstall`
4. Update code from git `git pull`
5. Install new version `sudo make dkms-install`
6. Activate zenpower `sudo modprobe zenpower`
4 years ago
4 years ago
## Help needed
It would be very helpful for me for further development of Zenpower if you can share debug data from zenpower. [Read more](https://github.com/ocerman/zenpower/issues/12)
3 years ago
## Notes
- Some users reported that a restart is needed after module installation
- If you are having trouble compiling zenpower under Ubuntu 18.04 (or older) with new upstream kernel, see [#23](https://github.com/ocerman/zenpower/issues/23)
3 years ago
- The meaning of raw current values from SVI2 telemetry are not standardised so the current/power readings may not be accurate on all systems (depends on the board model).