Code Monkey home page Code Monkey logo

huawei-wmi's Introduction

Huawei WMI laptop extras linux driver

Donate Donate

NOTE: Version v2.0 is the one in mainline kernel >= 5.0, this repository is used for testing and development purposes. v3.3 has been merged in kernel 5.5

This driver adds support for some of the missing features found on Huawei laptops running linux. It implements Windows Management Instrumentation (WMI) device mapping to kernel. Supported features are:

  • Function hotkeys, implemented in v1.0
  • Micmute LED, implemented in v2.0. Updated in v3.0 to work with newer laptops.
  • Battery protection, implemented in v3.0. Updated in v3.3 to use battery charge API.
  • Fn-lock, implemented v3.0.

Battery protection can accessed from either /sys/class/power_supply/BAT0/charge_control_{start,end}_threshold or /sys/devices/platform/huawei-wmi/charge_control_thresholds

Fn-lock can be accessed from /sys/devices/platform/huawei-wmi/fn_lock_state

This driver requires kernel >= 5.1. If you're on kernel <= 5.0, please refer to tag v1.0 for kernel < 5.0 or tag v3.2 if you're running version 5.0.

Check out matebook-applet for a GUI to control Fn-lock and battery protection.

Installation

Make sure you're using kernel >= 5.0. You can get this driver from here if you want to use DKMS modules for easy installation.

Use RPM package for Fedora

Install the RPM package provided here.

Use dkms tarball installation

Note: change VER to the desired module version.

  1. Grab huawei-wmi-VER-source-only.dkms.tar.gz from here
  2. Add dkms tarball and install module
sudo dkms ldtarball --archive=huawei-wmi-VER-source-only.dkms.tar.gz
# For autoinstallation
sudo dkms autoinstall -m huawei-wmi/VER
# For one-time installation
sudo dkms install huawei-wmi/VER
  1. Reboot

Build from source

  1. Make sure you have your kernel headers. In Fedora that would be:
sudo dnf install kernel-headers kernel-devel

Should be similar in other distributions. 2. Clone and update / install the module.

git clone https://github.com/aymanbagabas/Huawei-WMI
cd Huawei-WMI
make
# To update use:
sudo cp huawei-wmi.ko /lib/modules/$(uname -r)/updates/
sudo depmod
# To install use:
sudo make install
reboot

This method overwrites the exsiting version of huawei-wmi that comes with kernel 5.0. You have to redo it everytime the kernel gets updated.

Keyboard

NOTE: Ignore this if you're running systemd-udev > 240.

One of the keys, micmute, wouldn't work after inserting the module and that is due to an issue with X.Org. The solution would be to remap it to using udev hwdb tables. Copy 99-Huawei.hwdb to /etc/udev/hwdb.d/ then update the hwdb tables:

sudo udevadm --debug hwdb --update; sudo udevadm trigger

TODO

  • Merge driver into upstream Merged in Linux > 4.20. Commit log
  • Getting device LEDs to work See this and this
  • Support more devices
  • ACPI driver?

Contribution

Fork, modify, and pull request.

Credits

  • Thanks to Daniel Vogelbacher @cytrinox and Jan Baer @janbaer for testing the module on the Matebook X (2017).
  • Big thanks to @nekr0z for testing this driver on his Matebook 13 (2019) WRT-WX9 and for his awesome project matebook-applet.
  • Thanks to @wasakakero for testing this driver on the Matebook D 14-AMD KPL-W0X.

huawei-wmi's People

Contributors

aymanbagabas avatar

Stargazers

 avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.