Initial release v1.0.0

Add GPIO-based volume button driver for Lenovo IdeaPad Flex 5i Chromebook Gen 8

  Features:
  - Volume button detection via GPIO polling
  - Key repeat with configurable timings
  - Systemd service integration
  - Professional documentation

volume_buttons.py

@@ -1,8 +1,51 @@
 #!/usr/bin/env python3
 """
-Script pour activer les boutons volume du Chromebook Taeko
-Les boutons sont connectés aux GPIO 3 (Volume Down) et 4 (Volume Up)
-sur le chip cros-ec-gpio (gpiochip1)
+Chromebook Volume Buttons Driver
+
+Hardware volume button driver for Chromebook devices with non-functional
+side-mounted volume controls.
+
+This driver reads GPIO states from the ChromeOS Embedded Controller and
+emulates keyboard volume events via uinput, enabling physical volume buttons
+on Chromebooks running Linux with custom firmware.
+
+Target Hardware:
+    - Lenovo IdeaPad Flex 5i Chromebook Gen 8 (Taeko)
+    - GPIO 3 (EC:EC_VOLDN_BTN_ODL) - Volume Down
+    - GPIO 4 (EC:EC_VOLUP_BTN_ODL) - Volume Up
+    - Chip: /dev/gpiochip1 (cros-ec-gpio)
+
+License:
+    MIT License
+    Copyright (c) 2025 Muyue
+
+    Permission is hereby granted, free of charge, to any person obtaining a copy
+    of this software and associated documentation files (the "Software"), to deal
+    in the Software without restriction, including without limitation the rights
+    to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+    copies of the Software, and to permit persons to whom the Software is
+    furnished to do so, subject to the following conditions:
+
+    The above copyright notice and this permission notice shall be included in all
+    copies or substantial portions of the Software.
+
+    THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+    IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+    FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+    AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+    LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+    OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+    SOFTWARE.
+
+Author:
+    Muyue
+
+Contributors:
+    See CREDITS.md for acknowledgments of all contributors to this project
+    and the open source libraries and tools it depends upon.
+
+Repository:
+    https://gitea.legion-muyue.fr/Muyue/chromebook-volume-buttons
 """
 
 import sys