From 7a6de31fa51526c8fa3daa34246e07579f6713c4 Mon Sep 17 00:00:00 2001 From: Steven Seifried Date: Mon, 27 Mar 2023 08:04:41 +0200 Subject: [PATCH] Updated README.md --- README.md | 116 ++---------------------------------------------------- 1 file changed, 3 insertions(+), 113 deletions(-) diff --git a/README.md b/README.md index 0a196b0..2055817 100644 --- a/README.md +++ b/README.md @@ -7,11 +7,11 @@ - Modes # Description -TUXEDO Computers kernel module drivers for keyboard, keyboard backlight & general hardware I/O +TUXEDO Computers kernel module drivers for keyboard, keyboard backlight & general hardware I/O using the [SysFS interface](https://en.wikipedia.org/wiki/Sysfs) (since version 3.2.0) Features - Driver for Fn-keys -- Sysfs control of brightness/color/mode for most TUXEDO keyboards (note: white backlight only models are currently not supported) +- SysFS control of brightness/color/mode for most TUXEDO keyboards - Hardware I/O driver for TUXEDO Control Center Modules included in this package @@ -19,6 +19,7 @@ Modules included in this package - tuxedo-io - clevo-wmi - clevo-acpi +- uniwill-wmi # Building and Install @@ -102,114 +103,3 @@ sudo su echo tuxedo_keyboard >> /etc/modules ``` -Default Parameters at start. - - -In this example, we start the kernel module with the following settings: - -- mode 0 (Custom / Default Mode) -- red color for the left side of keyboard -- green color for the center of keyboard -- blue color for the right side of keyboard - -Note that we write it's settings to a `.conf` file under `/etc/modprobe.d` named `tuxedo_keyboard.conf`. - -```sh -sudo su - -echo "options tuxedo_keyboard mode=0 color_left=0xFF0000 color_center=0x00FF00 color_right=0x0000FF" > /etc/modprobe.d/tuxedo_keyboard.conf -``` -or -```sh -sudo cp tuxedo_keyboard.conf /etc/modprobe.d/tuxedo_keyboard.conf -``` - -# Sysfs - -## General -Path: `/sys/devices/platform/tuxedo_keyboard` - -## color_left -Allowed Values: Hex-Value (e.g. `0xFF0000` for the Color Red) -Description: Set the color of the left Keyboard Side - -## color_center -Allowed Values: Hex-Value (e.g. `0xFF0000` for the Color Red) -Description: Set the color of the center of Keyboard - -## color_right -Allowed Values: Hex-Value (e.g. `0xFF0000` for the Color Red) -Description: Set the color of the right Keyboard Side - -## color_extra -Allowed Values: Hex-Value (e.g. `0xFF0000` for the Color Red) -Description: Set the color of the extra region (if exist) of the Keyboard - -## brightness -Allowed Values: `0` - `255` -Description: Set the brightness of the Keyboard - -## mode -Allowed Values: `0` - `7` -Description: Set the mode of the Keyboard. A list with the modes is under Modes - -## state -Allowed Values: `0`, `1` -Description: Set the State of keyboard, `0` is keyboard is off and `1` is keyboard is on - -## extra -Allowed Values: `0`, `1` -Description: Only get the information, if the keyboard have the extra region - -# Kernel Parameter - -## Using -```sh -sudo modprobe tuxedo_keyboard -``` - -## color_left -Set the color of the left Keyboard Side - -## color_center -Set the color of the left Keyboard Side - -## color_right -Set the color of the left Keyboard Side - -## color_extra -Set the color of the left Keyboard extra region (Only when is a supported keyboard) - -## mode -Set the mode (on/off) of keyboard - -## brightness -Set the brightness of keyboard - -## state - -# Modes - -## CUSTOM -Value: `0` - -## BREATHE -Value: `1` - -## CYCLE -Value: `2` - -## DANCE -Value: `3` - -## FLASH -Value: `4` - -## RANDOM_COLOR -Value: `5` - -## TEMPO -Value: `6` - -## WAVE -Value: `7`