PINE64 PHONE-KEYBRD PinePhone and PinePhone Pro Keyboard User Manual
- June 6, 2024
- PINE64
Table of Contents
USER MANUAL
QUICK START GUIDE
Package contents
- User manual (1x)
- PinePhone Keyboard (1x)
Cautions
Before using the device please read this manual carefully.
Notes for safe operation:
- The PinePhone keyboard should be charged using a 15W (5V 3A) USB-PD power adapter. Charging at a higher voltage may result in damage to the keyboard and the PinePhone.
- Charge the PinePhone only via the keyboard’s USB-C port. When coupled with the keyboard, the PinePhone’s USB-C is to be used solely for data and peripherals. Under no circumstances should the keyboard and PinePhone be charged simultaneously by their respective USB-C ports.
- The device should never be operated with an external temperature lower than -20°C or higher than 40°C. Batteries should not be charged when external temperature is 0°C or lower.
- Do not puncture, disassemble, strike or squeeze the battery. Old batteries need to be disposed of in accordance with local regulations (see section 2.1).
- Do not expose the device to direct sunlight, water, or high levels of humidity.
- Comply with local regulations pertaining to using mobile devices. This extends to and includes the use of the device in public spaces when operating motor vehicles and heavy machinery.
Recycling of components and batteries
Recycling of the keyboard and its components should be done according to local
regulations. This may require you to dispose of the entire device or its parts
at a local recycling center or at a designated container. Please consult local
legislation for details.
Batteries should never, under any circumstances, be disposed of with general
household waste (as indicated by the crossed-out bin symbol below). The end-
user is legally obliged to return used batteries. Batteries can be returned to
us to be disposed of. The batteries are to be returned to the sender – for
more information contact us at [email protected].
Getting started
Mounting the keyboard
Power OFF your PinePhone and remove the back case. To remove the back case of
the PinePhone use your fingernail or another soft object to pry up the back
case. A notch to easily remove the cover is located at the bottom left of the
PinePhone with the back cover facing the user.
Open and place the keyboard flat on a hard surface with the hinge fully
extended. Proceed to insert the PinePhone into the keyboard at an angle of
approx. 15 degrees. Make sure that the PinePhone’s pogo pins and the
corresponding pads on the keyboard are aligned. The leading edge with volume
and power buttons should make contact first. Firmly press the PinePhone into
place. Multiple clicks should be heard as the two snap into place.
The PinePhone can be removed from the keyboard easily using a notch similar to the one found on the back case. The notch is located at the bottom of the leading edge with the power and volume buttons.
Keyboard and internal battery operation
The keyboard will function automatically once a PinePhone running a compatible
operating system is mounted. For alterations to physical layout and firmware
see sections 4.1 and 5.1 respectively.
The keyboard features an in-built 6000mAh battery. The battery can be turned
ON/OFF using the button on the right leading edge of the keyboard. A short
button press activates the internal battery while a long (15 seconds) press
deactivates it. Compatible operating systems display both the PinePhone’s and
keyboard’s battery status.
You should charge the PinePhone and the keyboard only using the USB-C port on
the keyboard. The keyboard’s USB-C port cannot be used for peripherals. The
PinePhone’s USB-C port remains operational when mounted on the keyboard and
can be used for data and peripherals.
Hardware
Detailed keyboard specifications including schematics can be found on our
Wiki: https://wiki.pine64.org/wiki/PinePhoneKeyboard Key hardware
specifications:
Dimensions (closed): 161 x 95 x 21.5mm Weights (without / with PinePhone
mounted): ~ 191 / ~391 grams Number of keys: 54 Number of rows: 5
Keyboard IC: EM85F684A 8-bit microcontroller with 256 bytes RAM, 2048/ bytes
XRAM; 16kB for user’s own firmware
Battery capacity: 6000mAh (22.2Wh 3.7V) Charger Input: 5V, 3A (15W)
Charging and battery IC chip: IP5209 power management IC with charge indicate
controller and boost converter
Keyboard layout and alterations
The keyboard features a default layout (pictured below) created and agreed upon by the community. The keyboard layout can be altered using software (see section 5.1) as well as by physically repositioning keycaps. All keycaps, with the exception of space and return keys, can be easily and safely relocated for alternative layouts corresponding to software settings.
Firmware
PinePhone’s keyboard firmware was developed independently by Ondrej 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
Copyright (C) 2021 Ondej Jerman [email protected]
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/
Regulatory compliance
The PinePhone keyboard is CE and FCC-certified.
Documentation and contact information
Detailed hardware and software documentation can be located on our Wiki
(wiki.pine64.org).
Contact
Sale enquires: [email protected]
Support: [email protected]
General inquiries: [email protected]