PinePhone (Pro) Keyboard - Revision history

Fxc: Reverted edits by Zo (talk) to last revision by Fxc

2023-10-21T11:01:04Z

Reverted edits by Zo (talk) to last revision by Fxc

← Older revision		Revision as of 11:01, 21 October 2023
Line 44:		Line 44:
	==== Top row is less responsive ====		==== Top row is less responsive ====
	The keys of the top row may be less responsive. The issue can be worked around by adding inserts to the underside of the top row key caps to decrease the travel distance. More details regarding the workaround can be found in the corresponding section of the FAQ page of the developer megi: https://xnux.eu/pinephone-keyboard/faq.html#ts		The keys of the top row may be less responsive. The issue can be worked around by adding inserts to the underside of the top row key caps to decrease the travel distance. More details regarding the workaround can be found in the corresponding section of the FAQ page of the developer megi: https://xnux.eu/pinephone-keyboard/faq.html#ts

	~~To use top row F key symbols hold Right ALT + desired symbol from the 10 F keys~~


	==== Software issues ====		==== Software issues ====
Line 64:		Line 61:

	Note: If you've upgraded to >=5.18, don't forget to upgrade the dtb as kb151 now appears to be a stub.		Note: If you've upgraded to >=5.18, don't forget to upgrade the dtb as kb151 now appears to be a stub.


	=== User-space driver ===		=== User-space driver ===
Line 98:		Line 94:

	The repository that contains the source code of the firmware, supporting utilities and associated documentation is located at https://xnux.eu/pinephone-keyboard/.		The repository that contains the source code of the firmware, supporting utilities and associated documentation is located at https://xnux.eu/pinephone-keyboard/.

	~~Pinephone keyboard battery power management software Ppkbbat-tools https://codeberg.org/aLilyBit/ppkbbat-tools~~

	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.		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.

Zo: Moved my commit to the correct category and gave the title a better explanation “battery power management software ”

2023-10-20T23:14:51Z

Moved my commit to the correct category and gave the title a better explanation “battery power management software ”

← Older revision		Revision as of 23:14, 20 October 2023
Line 65:		Line 65:
	Note: If you've upgraded to >=5.18, don't forget to upgrade the dtb as kb151 now appears to be a stub.		Note: If you've upgraded to >=5.18, don't forget to upgrade the dtb as kb151 now appears to be a stub.

	~~Ppkbbat-tools https://codeberg.org/aLilyBit/ppkbbat-tools~~

	=== User-space driver ===		=== User-space driver ===
Line 99:		Line 98:

	The repository that contains the source code of the firmware, supporting utilities and associated documentation is located at https://xnux.eu/pinephone-keyboard/.		The repository that contains the source code of the firmware, supporting utilities and associated documentation is located at https://xnux.eu/pinephone-keyboard/.

			Pinephone keyboard battery power management software Ppkbbat-tools https://codeberg.org/aLilyBit/ppkbbat-tools

	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.		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.

Zo: Added new pinephone battery control software by ppkbbat-tools and added how to use the F key symbols

2023-10-20T23:08:06Z

Added new pinephone battery control software by ppkbbat-tools and added how to use the F key symbols

← Older revision		Revision as of 23:08, 20 October 2023
Line 44:		Line 44:
	==== Top row is less responsive ====		==== Top row is less responsive ====
	The keys of the top row may be less responsive. The issue can be worked around by adding inserts to the underside of the top row key caps to decrease the travel distance. More details regarding the workaround can be found in the corresponding section of the FAQ page of the developer megi: https://xnux.eu/pinephone-keyboard/faq.html#ts		The keys of the top row may be less responsive. The issue can be worked around by adding inserts to the underside of the top row key caps to decrease the travel distance. More details regarding the workaround can be found in the corresponding section of the FAQ page of the developer megi: https://xnux.eu/pinephone-keyboard/faq.html#ts

			To use top row F key symbols hold Right ALT + desired symbol from the 10 F keys


	==== Software issues ====		==== Software issues ====
Line 61:		Line 64:

	Note: If you've upgraded to >=5.18, don't forget to upgrade the dtb as kb151 now appears to be a stub.		Note: If you've upgraded to >=5.18, don't forget to upgrade the dtb as kb151 now appears to be a stub.

			Ppkbbat-tools https://codeberg.org/aLilyBit/ppkbbat-tools

	=== User-space driver ===		=== User-space driver ===

Fxc: /* Safety */ Added sentence

2023-08-31T14:50:16Z

Safety: Added sentence

← Older revision		Revision as of 14:50, 31 August 2023
Line 50:		Line 50:
	== Safety ==		== Safety ==

	Do not plug in a charger into the keyboard and the phone at the same time. Doing so may result in damage or loss of the keyboard charging functionality. Technical details regarding the issue can be found in the blog post of the developer ''megi'' [http://xnux.eu/log/072.html here] and [https://www.pine64.org/2022/05/31/may-update-worth-the-wait/ this] blog post.		Do not plug in a charger into the keyboard and the phone at the same time. Doing so may result in damage or loss of the keyboard charging functionality. Using the USB-C port of the PinePhone (Pro) while a charger to is connected to the USB-C port of the keyboard is also discouraged for the same reason. Technical details regarding the issue can be found in the blog post of the developer ''megi'' [http://xnux.eu/log/072.html here] and [https://www.pine64.org/2022/05/31/may-update-worth-the-wait/ this] blog post.

	Please note: Only use mild isopropyl alcohol when wiping down the clamshell of the device. Stronger solutions may partially strip the coatings. Do not lube the keyboard with GPL 205G0 switch grease, it can cause problems with the key responsiveness and tactility.		Please note: Only use mild isopropyl alcohol when wiping down the clamshell of the device. Stronger solutions may partially strip the coatings. Do not lube the keyboard with GPL 205G0 switch grease, it can cause problems with the key responsiveness and tactility.

Fxc: /* Getting started */ Clarified wording

2023-08-31T14:49:19Z

Getting started: Clarified wording

← Older revision		Revision as of 14:49, 31 August 2023
Line 11:		Line 11:
	The keyboard case works with both the PinePhone and PinePhone Pro and features a clam-shell design. It uses pogo pins located on the phone’s midsection and attaches by replacing the default back cover. When folded, the phone’s screen and the keyboard rest securely against each other. The hinge features a 180° design, which not only allows for two-hand typing on a surface but also for comfortable thumb-typing when fully extended. The etched keycaps can be easily relocated for alternate layouts such as AZERTY or QWERTZ. The keyboard case runs an [https://xff.cz/git/pinephone-keyboard/ open firmware], which means that anyone with the know-how can alter existing functions or add new ones. The bottom (keyboard) and top (phone) sections of the assembly are well-balanced thanks to the large, 6000mAh, internal battery capable of charging the PinePhone (Pro) during operation. The internal battery effectively triples the phone’s battery life. The internal keyboard battery can be manually toggled on/off and the keyboard’s battery charge level can be read in the supported operating systems; the keyboard remains functional with the battery fully depleted.		The keyboard case works with both the PinePhone and PinePhone Pro and features a clam-shell design. It uses pogo pins located on the phone’s midsection and attaches by replacing the default back cover. When folded, the phone’s screen and the keyboard rest securely against each other. The hinge features a 180° design, which not only allows for two-hand typing on a surface but also for comfortable thumb-typing when fully extended. The etched keycaps can be easily relocated for alternate layouts such as AZERTY or QWERTZ. The keyboard case runs an [https://xff.cz/git/pinephone-keyboard/ open firmware], which means that anyone with the know-how can alter existing functions or add new ones. The bottom (keyboard) and top (phone) sections of the assembly are well-balanced thanks to the large, 6000mAh, internal battery capable of charging the PinePhone (Pro) during operation. The internal battery effectively triples the phone’s battery life. The internal keyboard battery can be manually toggled on/off and the keyboard’s battery charge level can be read in the supported operating systems; the keyboard remains functional with the battery fully depleted.

	You do not lose access to the PinePhone (Pro)’s USB-C port, speaker, microphone, or any external features, such as volume and lock buttons, with the keyboard attached. There is also a cut-out for the camera, torch, and headphone jack. The USB-C port on the keyboard is capable of powering both the keyboard and PinePhone (Pro) simultaneously. This means that you can plug in ~~a USB mouse,~~ a USB-C ~~dongle, or some other peripheral while~~ the keyboard's internal battery ~~is charging via the keyboard's USB-C port and~~ the PinePhone (Pro) is charging via the internal connection between phone and keyboard.		You do not lose access to the PinePhone (Pro)’s USB-C port, speaker, microphone, or any external features, such as volume and lock buttons, with the keyboard attached. There is also a cut-out for the camera, torch, and headphone jack. The USB-C port on the keyboard is capable of powering both the keyboard and PinePhone (Pro) simultaneously. This means that you can plug in a USB-C charger into the keyboard to charge the keyboard's internal battery, while the PinePhone (Pro) is charging via the internal connection between phone and keyboard.

	{{warning\|Do not plug in a charger into the keyboard and the phone at the same time. Technical details regarding the issue can be found in the blog post of the developer ''megi'' [http://xnux.eu/log/072.html here], in [https://www.pine64.org/2022/05/31/may-update-worth-the-wait/ this] blog post and the [[PinePhone (Pro) Keyboard#Safety\|safety]] section.}}		{{warning\|Do not plug in a charger into the keyboard and the phone at the same time. Using the USB-C port of the PinePhone (Pro) while a charger to is connected to the USB-C port of the keyboard is also discouraged for the same reason. Technical details regarding the issue can be found in the blog post of the developer ''megi'' [http://xnux.eu/log/072.html here], in [https://www.pine64.org/2022/05/31/may-update-worth-the-wait/ this] blog post and the [[PinePhone (Pro) Keyboard#Safety\|safety]] section.}}

	Please keep in mind that the keyboard case transforms the PinePhone (Pro) into a PDA, which means that taking calls will likely prove awkward without a wired or wireless headset connected (try speakerphone button if available).		Please keep in mind that the keyboard case transforms the PinePhone (Pro) into a PDA, which means that taking calls will likely prove awkward without a wired or wireless headset connected (try speakerphone button if available).

Fxc: /* Safety */ Updated section

2023-06-21T20:15:41Z

Safety: Updated section

← Older revision		Revision as of 20:15, 21 June 2023
Line 50:		Line 50:
	== Safety ==		== Safety ==

	~~{{warning\|1=~~Do ~~NOT~~ plug ~~any device~~ into the phone ~~USB-C port while~~ the ~~keyboard is attached~~. Doing so may result in damage or loss of the keyboard charging functionality. Technical details regarding the issue can be found in [https://www.pine64.org/2022/05/31/may-update-worth-the-wait/ this] blog post. ~~<br><br>~~		Do not plug in a charger into the keyboard and the phone at the same time. Doing so may result in damage or loss of the keyboard charging functionality. Technical details regarding the issue can be found in the blog post of the developer ''megi'' [http://xnux.eu/log/072.html here] and [https://www.pine64.org/2022/05/31/may-update-worth-the-wait/ this] blog post.

	Due to this limitation users may want block the USB-C port of the phone while the keyboard is connected to prevent connecting any USB device to the phone under any circumstances. See for example [https://fosstodon.org/web/@silverhax/107783280758831068 here].}}		Please note: Only use mild isopropyl alcohol when wiping down the clamshell of the device. Stronger solutions may partially strip the coatings. Do not lube the keyboard with GPL 205G0 switch grease, it can cause problems with the key responsiveness and tactility.

	~~'''~~Please note:~~'''~~ Only use mild isopropyl alcohol when wiping down the clamshell of the device. Stronger solutions may partially strip the coatings. Do not lube the keyboard with GPL 205G0 switch grease, it can cause problems with the key responsiveness and tactility.

	== Software support ==		== Software support ==

Fxc: /* Getting started */ Updated warnings

2023-06-21T20:14:04Z

Getting started: Updated warnings

← Older revision		Revision as of 20:14, 21 June 2023
Line 11:		Line 11:
	The keyboard case works with both the PinePhone and PinePhone Pro and features a clam-shell design. It uses pogo pins located on the phone’s midsection and attaches by replacing the default back cover. When folded, the phone’s screen and the keyboard rest securely against each other. The hinge features a 180° design, which not only allows for two-hand typing on a surface but also for comfortable thumb-typing when fully extended. The etched keycaps can be easily relocated for alternate layouts such as AZERTY or QWERTZ. The keyboard case runs an [https://xff.cz/git/pinephone-keyboard/ open firmware], which means that anyone with the know-how can alter existing functions or add new ones. The bottom (keyboard) and top (phone) sections of the assembly are well-balanced thanks to the large, 6000mAh, internal battery capable of charging the PinePhone (Pro) during operation. The internal battery effectively triples the phone’s battery life. The internal keyboard battery can be manually toggled on/off and the keyboard’s battery charge level can be read in the supported operating systems; the keyboard remains functional with the battery fully depleted.		The keyboard case works with both the PinePhone and PinePhone Pro and features a clam-shell design. It uses pogo pins located on the phone’s midsection and attaches by replacing the default back cover. When folded, the phone’s screen and the keyboard rest securely against each other. The hinge features a 180° design, which not only allows for two-hand typing on a surface but also for comfortable thumb-typing when fully extended. The etched keycaps can be easily relocated for alternate layouts such as AZERTY or QWERTZ. The keyboard case runs an [https://xff.cz/git/pinephone-keyboard/ open firmware], which means that anyone with the know-how can alter existing functions or add new ones. The bottom (keyboard) and top (phone) sections of the assembly are well-balanced thanks to the large, 6000mAh, internal battery capable of charging the PinePhone (Pro) during operation. The internal battery effectively triples the phone’s battery life. The internal keyboard battery can be manually toggled on/off and the keyboard’s battery charge level can be read in the supported operating systems; the keyboard remains functional with the battery fully depleted.

	You do not lose access to the PinePhone (Pro)’s USB-C port, speaker, microphone, or any external features, such as volume and lock buttons, with the keyboard attached. There is also a cut-out for the camera, torch, and headphone jack. The USB-C port on the keyboard is capable of powering both the keyboard and PinePhone (Pro) simultaneously. ~~<s>~~This means that you can plug in a USB mouse, a USB-C dongle, or some other peripheral while the ~~phone and keyboard’s~~ internal battery ~~charge</~~s>.		You do not lose access to the PinePhone (Pro)’s USB-C port, speaker, microphone, or any external features, such as volume and lock buttons, with the keyboard attached. There is also a cut-out for the camera, torch, and headphone jack. The USB-C port on the keyboard is capable of powering both the keyboard and PinePhone (Pro) simultaneously. This means that you can plug in a USB mouse, a USB-C dongle, or some other peripheral while the keyboard's internal battery is charging via the keyboard's USB-C port and the PinePhone (Pro) is charging via the internal connection between phone and keyboard.

	{{warning\|1=Do ~~NOT~~ plug ~~any device~~ into the phone ~~USB-C port while the keyboard is attached. Doing so may result in damage or loss of~~ the ~~keyboard charging functionality~~. Technical details regarding the issue can be found in [https://www.pine64.org/2022/05/31/may-update-worth-the-wait/ this] blog post~~. Please see~~ the [[PinePhone (Pro) Keyboard#Safety\|safety]] section.}}		{{warning\|Do not plug in a charger into the keyboard and the phone at the same time. Technical details regarding the issue can be found in the blog post of the developer ''megi'' [http://xnux.eu/log/072.html here], in [https://www.pine64.org/2022/05/31/may-update-worth-the-wait/ this] blog post and the [[PinePhone (Pro) Keyboard#Safety\|safety]] section.}}

	Please keep in mind that the keyboard case transforms the PinePhone (Pro) into a PDA, which means that taking calls will likely prove awkward without a wired or wireless headset connected (try speakerphone button if available).		Please keep in mind that the keyboard case transforms the PinePhone (Pro) into a PDA, which means that taking calls will likely prove awkward without a wired or wireless headset connected (try speakerphone button if available).

Fxc: +cat

2023-02-20T14:00:14Z

+cat

← Older revision		Revision as of 14:00, 20 February 2023
Line 198:		Line 198:
	* [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

			[[Category:PinePhone]]
			[[Category:PinePhone Pro]]
			[[Category:PinePhone (Pro) Add-Ons]]

Fxc: fix

2023-01-15T11:25:37Z

fix

← Older revision		Revision as of 11:25, 15 January 2023
Line 9:		Line 9:
	③ USB-C connector]]		③ USB-C connector]]

	The keyboard case works with both the PinePhone and PinePhone Pro and features a clam-shell design. It uses pogo pins located on the phone’s midsection and attaches by replacing the default back cover. When folded, the phone’s screen and the keyboard rest securely against each other. The hinge features a 180° design, which not only allows for two-hand typing on a surface but also for comfortable thumb-typing when fully extended. The etched keycaps can be easily relocated for alternate layouts such as AZERTY or QWERTZ. The keyboard case runs an [https://xff.cz/git/pinephone-keyboard/ open firmware], which means that anyone with the know-how can alter existing functions or add new ones. The bottom (keyboard) and top (phone) sections of the assembly are well-balanced thanks to the large, 6000mAh, internal battery capable of charging the PinePhone (Pro) during operation. The internal battery effectively triples the phone’s battery life. The internal keyboard battery can be manually toggled on/off and the keyboard’s battery charge level can be read in the supported ~~OSes~~; the keyboard remains functional with the battery fully depleted.		The keyboard case works with both the PinePhone and PinePhone Pro and features a clam-shell design. It uses pogo pins located on the phone’s midsection and attaches by replacing the default back cover. When folded, the phone’s screen and the keyboard rest securely against each other. The hinge features a 180° design, which not only allows for two-hand typing on a surface but also for comfortable thumb-typing when fully extended. The etched keycaps can be easily relocated for alternate layouts such as AZERTY or QWERTZ. The keyboard case runs an [https://xff.cz/git/pinephone-keyboard/ open firmware], which means that anyone with the know-how can alter existing functions or add new ones. The bottom (keyboard) and top (phone) sections of the assembly are well-balanced thanks to the large, 6000mAh, internal battery capable of charging the PinePhone (Pro) during operation. The internal battery effectively triples the phone’s battery life. The internal keyboard battery can be manually toggled on/off and the keyboard’s battery charge level can be read in the supported operating systems; the keyboard remains functional with the battery fully depleted.

	You do not lose access to the PinePhone (Pro)’s USB-C port, speaker, microphone, or any external features, such as volume and lock buttons, with the keyboard attached. There is also a cut-out for the camera, torch, and headphone jack. The USB-C port on the keyboard is capable of powering both the keyboard and PinePhone (Pro) simultaneously. <s>This means that you can plug in a USB mouse, a USB-C dongle, or some other peripheral while the phone and keyboard’s internal battery charge</s>.		You do not lose access to the PinePhone (Pro)’s USB-C port, speaker, microphone, or any external features, such as volume and lock buttons, with the keyboard attached. There is also a cut-out for the camera, torch, and headphone jack. The USB-C port on the keyboard is capable of powering both the keyboard and PinePhone (Pro) simultaneously. <s>This means that you can plug in a USB mouse, a USB-C dongle, or some other peripheral while the phone and keyboard’s internal battery charge</s>.

Fxc: /* Frequently asked questions */ Style updated, code is exclusively used for commands in the wiki

2022-11-09T18:08:35Z

Frequently asked questions: Style updated, code is exclusively used for commands in the wiki

← Older revision		Revision as of 18:08, 9 November 2022
Line 174:		Line 174:
	* For Phosh (at the example of Mobian) see: https://wiki.mobian-project.org/doku.php?id=ppaccessories		* For Phosh (at the example of Mobian) see: https://wiki.mobian-project.org/doku.php?id=ppaccessories
	* For TTY and SWMO see: https://codeberg.org/HazardChem/PinePhone_Keyboard		* For TTY and SWMO see: https://codeberg.org/HazardChem/PinePhone_Keyboard
	* For Plasma Mobile, one of either ~~<code>~~/etc/xdg/kxkbrc~~</code>~~ or ~~<code>~~~/.config/kxkbrc~~</code>~~ is necessary, with contents as described in https://gitlab.com/postmarketOS/pmaports/-/merge_requests/3438		* For Plasma Mobile, one of either ''/etc/xdg/kxkbrc'' or ''~/.config/kxkbrc'' is necessary, with contents as described in https://gitlab.com/postmarketOS/pmaports/-/merge_requests/3438

	== Documents ==		== Documents ==