User:EnthusiasticGeek/Keyboard Case - Revision history

Fxc: link fix

2023-02-20T18:38:36Z

link fix

← Older revision		Revision as of 18:38, 20 February 2023
Line 1:		Line 1:
	{{Template:note\|So far, these are my personal observations of the [[PinePhone Keyboard]]. The name of that will change -- oops.}}		{{Template:note\|So far, these are my personal observations of the [[PinePhone (Pro) Keyboard]]. The name of that will change -- oops.}}

	<!-- Add image -->		<!-- Add image -->

EnthusiasticGeek: More Citing and General Page Updates

2022-01-05T16:41:59Z

More Citing and General Page Updates

← Older revision		Revision as of 16:41, 5 January 2022
Line 6:		Line 6:

	= Connectivity =		= Connectivity =
	The Keyboard Case has six pins that connect it to the PinePhone or PinePhone Pro.		The Keyboard Case has six pins that connect it to the PinePhone or PinePhone Pro. They are labeled the same as on the PinePhone and PinePhone Pro. See [[PinePhone#Pogo_pins]] for information on the pogo pins.
	<!-- Image with labels for the pins here here -->		<!-- Image with labels for the pins here here -->
	<nowiki>		<nowiki>
Line 14:		Line 14:
	* The SDA and SCL pins are connected to the PinePhone or PinePhone Pro's I2C bus. This is how the phone and keyboard communincate.		* The SDA and SCL pins are connected to the PinePhone or PinePhone Pro's I2C bus. This is how the phone and keyboard communincate.
	* VBUS connects to the USB +5V line. See [[User:EnthusiasticGeek/Keyboard_Case#Charging Information\|Charging Information]] for more information		* VBUS connects to the USB +5V line. See [[User:EnthusiasticGeek/Keyboard_Case#Charging Information\|Charging Information]] for more information
	* The VBAT pin connects to the battery. This powers the keyboard if it is out of power<!--Citation Needed-->.		* The VBAT pin connects to the battery. This powers the keyboard if it is out of power.<!--Citation Needed-->
	* INT is a pin that's used for interrupts. In the case of the preinstalled firmware <!--add link to firmware page-->, it is used so the phone can request key presses from the keyboard.<!--Citation Needed-->		* INT is a pin that's used for interrupts. In the case of the preinstalled firmware,<!--add link to firmware page--> it's used so the phone can request key presses from the keyboard.<!--Citation Needed-->
	<!--I'm pretty sure that INT is just a regular GPIO pin on both the keyboard and PinePhone (Pro), but I'm not sure right now...-->		<!--I'm pretty sure that INT is just a regular GPIO pin on both the keyboard and PinePhone (Pro), but I'm not sure right now...-->

	=== Charging Information ===		=== Charging Information ===
	In most schematics, including the PinePhone and PinePhone Pro, the ~~usually~~ +5V coming from the ~~usb~~ connector is named VBUS. This voltage is fed into the System-On-a-Chip in the PinePhone (Allwinner A64) or PinePhone Pro (RK3399S). The SOC then manages this voltage and charges the battery.<!--Citation and clarification needed-->		In most schematics, including the PinePhone and PinePhone Pro, the +5V coming from the USB connector is named VBUS. This voltage is fed into the System-On-a-Chip in the PinePhone (Allwinner A64) or PinePhone Pro (RK3399S). The SOC then manages this voltage and charges the battery.<!--Citation and clarification needed-->

	The VBUS rail is also accessed through one of the pogo pins on the back of the phone. This is what the keyboard uses to charge the phone. The output of ~~the~~ IP5209 chip<!--explain "the output" better--> is connected to the VBUS rail through this pogo pin, which charges the phone. This makes the keyboard act as a USB charger with only +5V and GND connected~~, which charges the phone~~.		The VBUS rail is also accessed through one of the pogo pins on the back of the phone. This is what the keyboard uses to charge the phone. The output of it's IP5209 chip<!--explain "the output" better--> is connected to the VBUS rail through this pogo pin, which charges the phone. This makes the keyboard act as a USB charger with only +5V and GND connected.

	==== Problems with Charging Implimentation ====		==== Problems with Charging Implimentation ====
	{{Template:Note\|This could change in the near future~~.}}~~		{{Template:Note\|This could change in the near future with a new revision to the PinePhone.}}
	~~The way in which the PinePhone and PinePhone Pro can charge~~ with the keyboard breaks the USB-C spec. When the keyboard charges the phone, the VBUS line is always putting out +5V. If the phone and connected device negotiates that the phone shall be the sink, or if the connected device does not have any negotiation capabilities and acts as a source (such as a ~~simple charger), +5V will continue~~ to ~~be put out by~~ the PinePhone ~~or PinePhone Pro at the same time as the source is putting out +5V~~. This means that, for example, a charger plugged into the phone while the keyboard is connected may result in some unintended behavior.<!--Citation and clarification needed, as well as future links for when people inevitably fry their phones by plugging the charger into the wrong spot ;)-->

	In the case of the original PinePhone, this can be fixed by Pine64 by having the VBUS pin on the keyboard instead connect to the Allwinner A64's second power input, similar to how it's handled on the [[PineTab]]. However, the RK3399S used on the PinePhone Pro does not have this feature, which means it may not be as easily fixable on the it.<!--Citation needed-->		In the case of the original PinePhone, this can be fixed by Pine64 by having the VBUS pin on the keyboard instead connect to the Allwinner A64's second power input, similar to how it's handled on the [[PineTab]]. However, the RK3399S used on the PinePhone Pro does not have this feature, which means it may not be as easily fixable on the PinePhone Pro.<!--Citation needed-->

	= Resources =		= Resources =
Line 33:		Line 32:

	[https://www.pine64.org/2021/12/31/happy-new-year-the-keyboard-and-cases-are-here/ Pine64 Blog Post - January 1st 2022]		[https://www.pine64.org/2021/12/31/happy-new-year-the-keyboard-and-cases-are-here/ Pine64 Blog Post - January 1st 2022]

			[[PinePhone\|PinePhone Pine64 Wiki Page]]

EnthusiasticGeek: Fix Links

2022-01-04T19:27:23Z

Fix Links

← Older revision		Revision as of 19:27, 4 January 2022
Line 30:		Line 30:

	= Resources =		= Resources =
	[https://pine64.com/product/pinephone-pinephone-pro-keyboard-case/\|PinePhone (Pro) Keyboard Case on the official Pine Store]		[https://pine64.com/product/pinephone-pinephone-pro-keyboard-case/ PinePhone (Pro) Keyboard Case on the official Pine Store]

	[https://www.pine64.org/2021/12/31/happy-new-year-the-keyboard-and-cases-are-here/\|Pine64 Blog Post - January 1st 2022]		[https://www.pine64.org/2021/12/31/happy-new-year-the-keyboard-and-cases-are-here/ Pine64 Blog Post - January 1st 2022]

EnthusiasticGeek: Add Resources

2022-01-04T19:24:27Z

Add Resources

← Older revision		Revision as of 19:24, 4 January 2022
Line 3:		Line 3:
	<!-- Add image -->		<!-- Add image -->

	This Keyboard Case is a case for the [[PinePhone]] and [[PinePhone Pro]]. As the name implies, it adds a keyboard to the phones. It also has a 6000 mAh battery that essentially tripples~~<!--¹-->~~ the phone's 3000 mAh battery life.		This Keyboard Case is a case for the [[PinePhone]] and [[PinePhone Pro]]. As the name implies, it adds a keyboard to the phones. It also has a 6000 mAh battery that essentially tripples the phone's 3000 mAh battery life.
	~~<!--¹ See [[User:EnthusiasticGeek/Keyboard_Case#Charging Information\|Charging Information]] for more information.-->~~
	= Connectivity =		= Connectivity =
	The Keyboard Case has six pins that connect it to the PinePhone or PinePhone Pro.		The Keyboard Case has six pins that connect it to the PinePhone or PinePhone Pro.
Line 28:		Line 28:

	In the case of the original PinePhone, this can be fixed by Pine64 by having the VBUS pin on the keyboard instead connect to the Allwinner A64's second power input, similar to how it's handled on the [[PineTab]]. However, the RK3399S used on the PinePhone Pro does not have this feature, which means it may not be as easily fixable on the it.<!--Citation needed-->		In the case of the original PinePhone, this can be fixed by Pine64 by having the VBUS pin on the keyboard instead connect to the Allwinner A64's second power input, similar to how it's handled on the [[PineTab]]. However, the RK3399S used on the PinePhone Pro does not have this feature, which means it may not be as easily fixable on the it.<!--Citation needed-->

			= Resources =
			[https://pine64.com/product/pinephone-pinephone-pro-keyboard-case/\|PinePhone (Pro) Keyboard Case on the official Pine Store]

			[https://www.pine64.org/2021/12/31/happy-new-year-the-keyboard-and-cases-are-here/\|Pine64 Blog Post - January 1st 2022]

EnthusiasticGeek: Fixed spelling errors and clarified some things

2022-01-04T19:06:34Z

Fixed spelling errors and clarified some things

← Older revision		Revision as of 19:06, 4 January 2022
Line 24:		Line 24:

	==== Problems with Charging Implimentation ====		==== Problems with Charging Implimentation ====
	The way in which the PinePhone and PinePhone Pro can charge with the keyboard breaks the USB-C spec. If the phone and connected device negotiates that ~~ths~~ phone shall be the sink, or if the connected device does not have any negotiation capabilities ~~but~~ acts as a source, +5V will ~~still~~ be put out by the PinePhone or PinePhone Pro. This means that, for example, a charger plugged into the phone while the keyboard is connected may result in some unintended ~~behaviors~~.<!--Citation and clarification needed, as well as future links for when people inevitably fry their phones by plugging the charger into the wrong spot ;)--> In the case of the original PinePhone, this ~~is fixable~~ by having the VBUS pin instead connect to the ~~Allwinenr~~ A64's second power input, similar to how it's handled on the [[PineTab]]. However, the RK3399S does not have this feature.<!--Citation needed-->		{{Template:Note\|This could change in the near future.}}
			The way in which the PinePhone and PinePhone Pro can charge with the keyboard breaks the USB-C spec. When the keyboard charges the phone, the VBUS line is always putting out +5V. If the phone and connected device negotiates that the phone shall be the sink, or if the connected device does not have any negotiation capabilities and acts as a source (such as a simple charger), +5V will continue to be put out by the PinePhone or PinePhone Pro at the same time as the source is putting out +5V. This means that, for example, a charger plugged into the phone while the keyboard is connected may result in some unintended behavior.<!--Citation and clarification needed, as well as future links for when people inevitably fry their phones by plugging the charger into the wrong spot ;)-->

			In the case of the original PinePhone, this can be fixed by Pine64 by having the VBUS pin on the keyboard instead connect to the Allwinner A64's second power input, similar to how it's handled on the [[PineTab]]. However, the RK3399S used on the PinePhone Pro does not have this feature, which means it may not be as easily fixable on the it.<!--Citation needed-->

EnthusiasticGeek: More information and organization

2022-01-03T03:39:02Z

More information and organization

← Older revision		Revision as of 03:39, 3 January 2022
Line 12:		Line 12:
	VBUS VBAT GND</nowiki>		VBUS VBAT GND</nowiki>

	The SDA and SCL pins ~~belong~~ to the I2C ~~Bus~~.		* The SDA and SCL pins are connected to the PinePhone or PinePhone Pro's I2C bus. This is how the phone and keyboard communincate.
			* VBUS connects to the USB +5V line. See [[User:EnthusiasticGeek/Keyboard_Case#Charging Information\|Charging Information]] for more information
	VBUS connects to the USB +5V line. See [[User:EnthusiasticGeek/Keyboard_Case#Charging Information\|Charging Information]] for more information		* The VBAT pin connects to the battery. This powers the keyboard if it is out of power<!--Citation Needed-->.
			* INT is a pin that's used for interrupts. In the case of the preinstalled firmware <!--add link to firmware page-->, it is used so the phone can request key presses from the keyboard.<!--Citation Needed-->
			<!--I'm pretty sure that INT is just a regular GPIO pin on both the keyboard and PinePhone (Pro), but I'm not sure right now...-->
	The VBAT pin connects to the battery. This powers the keyboard if it is out of power<!--Citation Needed-->.

	INT is a pin that's used for interrupts. In ~~this~~ case, it is used so the phone can request key presses from the keyboard.<!--Citation Needed-->.
	<!--I'm pretty sure that INT is just a regular GPIO pin, but I'm not sure right now...-->

	=== Charging Information ===		=== Charging Information ===
Line 27:		Line 23:
	The VBUS rail is also accessed through one of the pogo pins on the back of the phone. This is what the keyboard uses to charge the phone. The output of the IP5209 chip<!--explain "the output" better--> is connected to the VBUS rail through this pogo pin, which charges the phone. This makes the keyboard act as a USB charger with only +5V and GND connected, which charges the phone.		The VBUS rail is also accessed through one of the pogo pins on the back of the phone. This is what the keyboard uses to charge the phone. The output of the IP5209 chip<!--explain "the output" better--> is connected to the VBUS rail through this pogo pin, which charges the phone. This makes the keyboard act as a USB charger with only +5V and GND connected, which charges the phone.

	~~This~~ breaks the USB-C spec~~, as even if~~ the phone and connected device negotiates that ths phone shall be the sink, +5V will still be put out by the PinePhone or PinePhone Pro. This means that a charger plugged into the phone while the keyboard is connected may result in some unintended behaviors.<!--Citation and clarification needed, as well as future links for when people inevitably fry their phones by plugging the charger into the wrong spot ;)-->		==== Problems with Charging Implimentation ====
			The way in which the PinePhone and PinePhone Pro can charge with the keyboard breaks the USB-C spec. If the phone and connected device negotiates that ths phone shall be the sink, or if the connected device does not have any negotiation capabilities but acts as a source, +5V will still be put out by the PinePhone or PinePhone Pro. This means that, for example, a charger plugged into the phone while the keyboard is connected may result in some unintended behaviors.<!--Citation and clarification needed, as well as future links for when people inevitably fry their phones by plugging the charger into the wrong spot ;)--> In the case of the original PinePhone, this is fixable by having the VBUS pin instead connect to the Allwinenr A64's second power input, similar to how it's handled on the [[PineTab]]. However, the RK3399S does not have this feature.<!--Citation needed-->
	~~This also means that~~, ~~although~~ the ~~phone is connected~~

EnthusiasticGeek at 02:46, 3 January 2022

2022-01-03T02:46:52Z

← Older revision		Revision as of 02:46, 3 January 2022
Line 4:		Line 4:

	This Keyboard Case is a case for the [[PinePhone]] and [[PinePhone Pro]]. As the name implies, it adds a keyboard to the phones. It also has a 6000 mAh battery that essentially tripples<!--¹--> the phone's 3000 mAh battery life.		This Keyboard Case is a case for the [[PinePhone]] and [[PinePhone Pro]]. As the name implies, it adds a keyboard to the phones. It also has a 6000 mAh battery that essentially tripples<!--¹--> the phone's 3000 mAh battery life.

	<!--¹ See [[User:EnthusiasticGeek/Keyboard_Case#Charging Information\|Charging Information]] for more information.-->		<!--¹ See [[User:EnthusiasticGeek/Keyboard_Case#Charging Information\|Charging Information]] for more information.-->

	= Connectivity =		= Connectivity =
	The Keyboard Case has six pins that connect it to the PinePhone or PinePhone Pro.		The Keyboard Case has six pins that connect it to the PinePhone or PinePhone Pro.

EnthusiasticGeek: More info

2022-01-03T02:46:10Z

More info

← Older revision		Revision as of 02:46, 3 January 2022
Line 3:		Line 3:
	<!-- Add image -->		<!-- Add image -->

	This Keyboard Case is a case for the [[PinePhone]] and [[PinePhone Pro]]. As the name implies, it adds a keyboard to the phones. It also has a 6000 mAh battery that essentially ~~tripples¹~~ the phone's 3000 mAh battery life.		This Keyboard Case is a case for the [[PinePhone]] and [[PinePhone Pro]]. As the name implies, it adds a keyboard to the phones. It also has a 6000 mAh battery that essentially tripples<!--¹--> the phone's 3000 mAh battery life.

	¹ See [[User:EnthusiasticGeek/Keyboard_Case#Charging Information\|Charging Information]] for more information.		<!--¹ See [[User:EnthusiasticGeek/Keyboard_Case#Charging Information\|Charging Information]] for more information.-->

	= Connectivity =		= Connectivity =
Line 14:		Line 14:
	VBUS VBAT GND</nowiki>		VBUS VBAT GND</nowiki>

	The SDA and SCL pins belong to the I2C Bus~~. <br />~~		The SDA and SCL pins belong to the I2C Bus.
	~~<!-- I need to say something better than "the output of" here. -->~~
	~~VBUS connects to the charging line. See [[User:EnthusiasticGeek/Keyboard_Case#Charging Information\|Charging Information]] for more information.<br />~~
	~~The VBAT pin connects to the battery. This powers the keyboard if it is out of power<!--Citation Needed-->.<br />~~
	~~INT is a pin that's used for interrupts. In this case, it is used so the phone can request key presses from the keyboard<!--Citation Needed-->~~.

			VBUS connects to the USB +5V line. See [[User:EnthusiasticGeek/Keyboard_Case#Charging Information\|Charging Information]] for more information


			The VBAT pin connects to the battery. This powers the keyboard if it is out of power<!--Citation Needed-->.

			INT is a pin that's used for interrupts. In this case, it is used so the phone can request key presses from the keyboard.<!--Citation Needed-->.
			<!--I'm pretty sure that INT is just a regular GPIO pin, but I'm not sure right now...-->

	=== Charging Information ===		=== Charging Information ===
	The output of the IP5209 is connected to the VBUS pin.		In most schematics, including the PinePhone and PinePhone Pro, the usually +5V coming from the usb connector is named VBUS. This voltage is fed into the System-On-a-Chip in the PinePhone (Allwinner A64) or PinePhone Pro (RK3399S). The SOC then manages this voltage and charges the battery.<!--Citation and clarification needed-->

			The VBUS rail is also accessed through one of the pogo pins on the back of the phone. This is what the keyboard uses to charge the phone. The output of the IP5209 chip<!--explain "the output" better--> is connected to the VBUS rail through this pogo pin, which charges the phone. This makes the keyboard act as a USB charger with only +5V and GND connected, which charges the phone.

			This breaks the USB-C spec, as even if the phone and connected device negotiates that ths phone shall be the sink, +5V will still be put out by the PinePhone or PinePhone Pro. This means that a charger plugged into the phone while the keyboard is connected may result in some unintended behaviors.<!--Citation and clarification needed, as well as future links for when people inevitably fry their phones by plugging the charger into the wrong spot ;)-->

			This also means that, although the phone is connected

EnthusiasticGeek at 02:18, 3 January 2022

2022-01-03T02:18:05Z

← Older revision		Revision as of 02:18, 3 January 2022
Line 16:		Line 16:
	The SDA and SCL pins belong to the I2C Bus. <br />		The SDA and SCL pins belong to the I2C Bus. <br />
	<!-- I need to say something better than "the output of" here. -->		<!-- I need to say something better than "the output of" here. -->
	VBUS connects to the charging line. See [[User:EnthusiasticGeek/Keyboard_Case#Charging Information\|Charging Information]] for more information.		VBUS connects to the charging line. See [[User:EnthusiasticGeek/Keyboard_Case#Charging Information\|Charging Information]] for more information.<br />
	The VBAT pin connects to the battery. This powers the keyboard if it is out of power<!--Citation Needed-->.		The VBAT pin connects to the battery. This powers the keyboard if it is out of power<!--Citation Needed-->.<br />
	INT is a pin that's used for interrupts. In this case, it is used so the phone can request key presses from the keyboard<!--Citation Needed-->.		INT is a pin that's used for interrupts. In this case, it is used so the phone can request key presses from the keyboard<!--Citation Needed-->.

EnthusiasticGeek: Added some initial information

2022-01-03T00:12:53Z

Added some initial information

← Older revision		Revision as of 00:12, 3 January 2022
Line 1:		Line 1:
	{{Template:note\|So far, these are my personal observations of the [[PinePhone Keyboard]]. The name of that will change -- oops.}}		{{Template:note\|So far, these are my personal observations of the [[PinePhone Keyboard]]. The name of that will change -- oops.}}

	This ~~will be~~ a ~~draft~~ for the keyboard case ~~in a few hours~~		<!-- Add image -->

			This Keyboard Case is a case for the [[PinePhone]] and [[PinePhone Pro]]. As the name implies, it adds a keyboard to the phones. It also has a 6000 mAh battery that essentially tripples¹ the phone's 3000 mAh battery life.

			¹ See [[User:EnthusiasticGeek/Keyboard_Case#Charging Information\|Charging Information]] for more information.

			= Connectivity =
			The Keyboard Case has six pins that connect it to the PinePhone or PinePhone Pro.
			<!-- Image with labels for the pins here here -->
			<nowiki>
			INT SDA SCL
			VBUS VBAT GND</nowiki>

			The SDA and SCL pins belong to the I2C Bus. <br />
			<!-- I need to say something better than "the output of" here. -->
			VBUS connects to the charging line. See [[User:EnthusiasticGeek/Keyboard_Case#Charging Information\|Charging Information]] for more information.
			The VBAT pin connects to the battery. This powers the keyboard if it is out of power<!--Citation Needed-->.
			INT is a pin that's used for interrupts. In this case, it is used so the phone can request key presses from the keyboard<!--Citation Needed-->.


			=== Charging Information ===
			The output of the IP5209 is connected to the VBUS pin.