Difference between revisions of "PinePhone (Pro) Keyboard"

Jump to navigation Jump to search
(more stuff)
(more information)
Line 28: Line 28:
== Software support ==
== Software support ==


* Userspace
=== Kernel-space driver ===
* Kernel space
=== User-space driver ===


== Keyboard layout ==
== Keyboard layout ==
Line 37: Line 37:
Image:Ppkb_layout2.png|The keyboard layout how the keys were originally intended
Image:Ppkb_layout2.png|The keyboard layout how the keys were originally intended
</gallery>
</gallery>
== Keyboard firmware ==
PinePhone’s keyboard firmware was developed independently by Ondřej Jirman as a free-of-charge contribution to PINE64. The firmware source code is freely and publicly available and you can modify it, and the supporting utilities, using common FOSS tools. 
=== Firmware and supporting utilities ===
The design of the firmware allows the keys, modifier keys, and their combinations to be handled in virtually unlimited ways, without a need to flash a customized version of the firmware. Mapping of keys is defined at runtime, using the supporting utilities, and is not hardcoded in the firmware. Different keyboard layouts can be loaded dynamically to support various use cases.
The repository that contains the source code of the firmware, supporting utilities and associated documentation is located at https://xnux.eu/pinephone-keyboard/.
You are welcome to contribute patches and improvements to the firmware and the supporting utilities. A summary of firmware development history is available at https://xnux.eu/log/ alongside other development updates from the firmware author.
Much time and effort went into the development of this firmware. If you wish to send a token of appreciation or support the development efforts in any way, please consider making a donation to the author via one of the methods listed at the bottom of this web page: https://xnux.eu/contribute.html.
=== Firmware License ===
<blockquote>Copyright (C) 2021 Ondřej Jirman <megi@xff.cz>
This program is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, with either version 3 of the License or
(at your discretion) any later version.
This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
See GNU General Public License for more details.
GNU General Public License http://www.gnu.org/licenses/</blockquote>


== Hardware ==
== Hardware ==
Line 94: Line 122:


== External links ==
== External links ==
* [https://wiki.pine64.org/wiki/File:USER_MANUAL-KEYBOARD-V2-EN-DE-FR-ES.pdf The official keyboard manual]
* [https://www.pine64.org/2022/01/11/pinephone-pro-explorer-edition-pre-orders-open-january-11/ Pre-order announcement]
* [https://www.pine64.org/2022/01/11/pinephone-pro-explorer-edition-pre-orders-open-january-11/ Pre-order announcement]
* FAQ of the developer megous: https://xnux.eu/pinephone-keyboard/faq.html
* FAQ of the developer megous: https://xnux.eu/pinephone-keyboard/faq.html