PINE64 Pinebook Pro - User Manual

User Guide
The Pinebook Pro is a Linux and *BSD ARM laptop from PINE64
It is built to be a compelling alternative to mid-ranged Chromebooks that people convert
into Linux laptops. It features an IPS 1080p 14″ LCD panel, a premium magnesium alloy
shell, high capacity eMMC storage, a 10,000 mAh capacity battery, and the modularity
that only an open source project can deliver.
Key features include: the RK3399 SOC; USB-C for data, video-out and power-in (3A 5V);
privacy switches for the microphone, BT/WiFi module, and camera; and expandable
storage via NVMe (PCIe 4x) with an optional adapter.
The Pinebook Pro is equipped with 4GB LPDDR4 system memory, high capacity eMMC
flash storage, and 128Mb SPI boot Flash. The I/O includes: 1x micro SD card reader
(bootable), 1x USB 2.0, 1x USB 3.0, 1x USB type C Host with DP 1.2 and power-in, PCIe
4x for an NVMe SSD drive (requires an optional adapter), and UART (via the headphone
jack by setting an internal switch).
The keyboard and trackpad both use the USB 2.0 protocol. The LCD panel uses eDP
MiPi display protocol.
Many different Operating Systems (OS) are freely available from the open source
community and partner projects. These include various flavors of Linux (Ubuntu, Debian,
Manjaro, etc.) and *BSD.
Using the optional NVMe adapter
The optional NVMe adapter allows the use of M.2 cards that support the NVMe standard,
(but not SATA standard).
Installing the adapter
The v2.1 SSD adapter that is shipped with the initial Pinebook Pro batches had
significant issues. A repair kit will be shipped to address those issues.
(If necessary, they can be modified to work. There is an unofficial tutorial on the
forums describing these modifications.)
Using as data drive
As long as the kernel in use has both the PCIe and NVMe drivers, you should be able to
use a NVMe drive as a data drive. It can automatically mount when booting from either
the eMMC or an SD card. This applies to both Linux and FreeBSD, using the normal
partitioning and file system creation tools. Android and Chromium OS require testing.
Using as OS root drive
It is not possible to boot directly off an NVMe drive. The SoC does not include the NVMe
boot code, so the NVMe is not in the SoC's boot order.

Summary

Using the optional NVMe adapter

Installing the adapter

Details issues with the v2.1 SSD adapter and potential repair kits.

Using as data drive

Explains using an NVMe drive for data storage with kernel support.

Using as OS root drive

States it's not possible to boot directly from NVMe due to SoC limitations.

Caring for the PineBook Pro

Bypass Cables

Describes bypass cables for powering the mainboard without a battery and warnings.

Pinebook Service Step-by-Step Guides

Points to service guides for disassembly, mentioning specific component guides.

Power Supply

Lists power input specifications via barrel jack and USB-C.

Troubleshooting: New from Factory Issues

UART Console Cable Boot Issues

Discusses potential boot issues when using a UART console cable.

eMMC Switch Power-On Problems

Explains power-on issues after manipulating the eMMC switch and suggests pressing reset.

Keyboard Input and Palm Rejection

Describes an issue with palm rejection disabling keyboard input and a firmware fix.

WiFi Connectivity Troubleshooting

Covers checking privacy switches, NetworkManager config, and power management.

Connectivity Features

Bluetooth Functionality

Information on enabling and using Bluetooth devices.

Audio Output Issues

Details common causes for lack of sound and troubleshooting steps.

USB Dock and DisplayPort Compatibility

Criteria for successful USB-C alternate mode video output and dock usage.

Hardware Components

Mainboard Switches and Buttons

Describes mainboard switches for eMMC and UART, plus reset/recovery buttons.

System Boot and Storage

Bootable Storage Options

Details bootable media like eMMC, USB, and SD card, and the boot order.

eMMC Storage Partitioning

Details the different partitions of the eMMC storage, like boot0, boot1, and RPMB.

Boot Sequence Logic

Explains how the RK3399 boot ROM searches for boot code on various media.

Hardware Specifications

Pinebook Pro Dimensions and Weight

Provides the physical dimensions and weight of the Pinebook Pro.

CPU Architecture Details

Outlines the CPU's big.LITTLE architecture and ARMv8-A instruction set.

GPU Architecture Overview

Describes the ARM Mali-T860MP4 Quad-core GPU and its capabilities.

System Memory Configuration

Details the RAM type, channels, and capacity.

Storage Memory Specifications

Provides details on the eMMC module, its version, and upgradeability.

Battery Information

Specifies the type and capacity of the Lithium Polymer battery.

Display Panel Details

Information about the 14.1" IPS LCD panel.

Ports and Interfaces

Video Output Capabilities

Details USB-C Alt mode DP video output resolution and lanes.

Audio Ports and Speakers

Describes the 3.5mm audio jack and built-in stereo speakers.

Network Connectivity

Lists WiFi standards, dual-band support, and Bluetooth version.

MicroSD Card Support

Lists specifications for MicroSD card compatibility and speed.

USB Port Details

Details the types and capabilities of the USB ports.

Optional NVMe Adapter Specifications

Specifies PCIe lanes, length, power, and compatibility for NVMe adapters.

Overview

1. Function Description
2. Usage Features
3. Booting and Storage
4. Power and Charging
5. Video Output
6. Audio
7. Network
8. Maintenance Features
9. Disassembly and Reassembly
10. Troubleshooting and Repair
11. Internal Switches and Buttons
12. FCC Compliance

The Pinebook Pro is a Linux and *BSD ARM laptop designed as an open-source alternative to mid-range Chromebooks. It features a 14-inch IPS 1080p LCD panel, a premium magnesium alloy shell, and a high-capacity 10,000 mAh battery. The device emphasizes modularity and open-source compatibility.

Function Description

The Pinebook Pro serves as a portable computing device, running various open-source operating systems such as Linux distributions (Ubuntu, Debian, Manjaro) and *BSD. Its core functionality is driven by the RK3399 System-on-Chip (SoC), supporting a range of tasks from general productivity to development.

The laptop is equipped with 4GB LPDDR4 system memory and high-capacity eMMC flash storage for its primary operating system and data. A 128Mb SPI boot Flash is also included. For connectivity and expansion, it provides a micro SD card reader (which is bootable), USB 2.0 and USB 3.0 ports, and a USB Type-C Host port that supports DisplayPort 1.2 video output and power input (3A 5V). An internal switch allows the headphone jack to function as a UART console.

For storage expansion, the Pinebook Pro includes a PCIe 4x interface for an NVMe SSD drive, which requires an optional adapter. This allows users to significantly increase storage capacity and potentially improve data access speeds.

Privacy features are integrated through physical switches for the microphone, Bluetooth/WiFi module, and camera, allowing users to physically disable these components when not in use.

The keyboard and trackpad operate via the USB 2.0 protocol, providing standard input functionality. The LCD panel utilizes the eDP MiPi display protocol for its visual output.

Usage Features

The Pinebook Pro offers flexible usage scenarios due to its open-source nature. Users can install and run a wide variety of operating systems, tailoring the device to their specific needs.

Booting and Storage:

The device is capable of booting from eMMC, USB 2.0, USB 3.0, or an SD card. While direct booting from USB-C is not supported, the hard-coded ROM boot order prioritizes SPI NOR, eMMC, SD, and then USB OTG. The Pinebook Pro typically ships with a Debian + MATE build on the eMMC, with a boot order of SD then eMMC.

For users wishing to utilize an NVMe SSD, it can function as a data drive, provided the kernel has the necessary PCIe and NVMe drivers. It can automatically mount when booting from eMMC or an SD card, supporting both Linux and FreeBSD. While direct booting from an NVMe drive is not possible due to the SoC lacking NVMe boot code, users can configure the system to boot from eMMC and then transfer the root file system to the NVMe drive. This involves having the U-Boot code, kernel image, DTB, and extlinux.conf in a /boot partition on the eMMC, pointing to the NVMe drive for the root file system.

Power and Charging:

The Pinebook Pro can be powered via a 5V DC @ 3A barrel jack (3.5mm OD / 1.35mm ID) or a USB-C 15W PD quick charge. It is crucial to use only one power input at a time.

Video Output:

The USB-C port supports DisplayPort alternate mode, allowing video output up to 3840x2160 at 60Hz (or 30Hz if USB 3 is also desired for a dock). The device can connect to external displays via USB-C alternate mode DisplayPort, and if the external device uses an active translator, it can output to HDMI or VGA.

Audio:

Audio output is available through built-in stereo speakers and a 3.5mm stereo earphone/microphone plug. If sound is not working from the headphone jack but works from speakers, the headphone/UART console switch might be set to UART mode and needs to be switched to headphone mode. When using USB-C alternate DisplayPort mode, audio may be redirected through this path to a monitor with speakers. For Bluetooth attached speakers or headsets, the pulseaudio-module-bluetooth package needs to be installed.

Network:

The device supports WiFi (802.11 b/g/n/ac, dual band 2.4Ghz & 5Ghz with a single antenna) and Bluetooth 5.0. Privacy switches allow users to physically disable the WiFi/BT module.

Maintenance Features

The Pinebook Pro is designed with a degree of user serviceability, with clear instructions for disassembly and component access.

Disassembly and Reassembly:

To access internal components, the laptop must be powered off and folded closed. Ten Phillips head screws secure the bottom cover. After removing the screws, the cover can be lifted from the back (hinge side) and away from the chassis. During reassembly, ensure back-screw standoffs are in place and seated correctly. The bottom section slides into place, meeting the front lip of the keyboard section. The front section is secured with two short screws in the front left and right corners, followed by popping the bottom panel into place and securing the remaining screws. Screws should only be finger-tight to avoid stripping threads. If the back cover plate is not seated properly, gently flex the base with both hands in opposing directions until it pops into place.

Troubleshooting and Repair:

• Boot/Power On Issues:

  • If the Pinebook Pro doesn't boot or power on, check the eMMC switch (24) position; it should be switched towards the back/hinge to enable the eMMC.
  • Verify the eMMC is firmly seated, as it might come loose during shipment.
  • Try unplugging and reseating the SD card daughterboard ribbon cable.
  • If the eMMC is empty, create a bootable SD card to test if the Pinebook Pro boots, then write an OS image to the eMMC.
  • If using a UART console cable from the Pine Store, try disconnecting it to see if the device boots.
  • If the device doesn't power on after toggling the eMMC enable/disable switch (24) towards the hinge, press the RESET button (28).

• Keys Not Registering/Missing Keys:

  • This issue can occur if the thumb or palm edge makes contact with the trackpad, triggering an overly forceful palm rejection firmware that disables both the trackpad and keyboard.
  • Using Fn+F7 to disable the touchpad can prevent it from disabling the keyboard.
  • A firmware update has been released to address this issue.

• WiFi Issues:

  • Ensure the privacy switch for WiFi is enabled.
  • Modify /etc/NetworkManager/NetworkManager.conf as root, changing managed=false to managed=true, then reboot.
  • For dropped connections, it might be due to WiFi power management in older OS releases. Later OS releases either remove or default to full power management. Power management can be turned off via command line (iw dev wlan0 set power save off or iwconfig wlan0 power off), though this is not persistent across reboots.
  • If WiFi is unstable with an alternate OS, the WiFi firmware might be inappropriate for the chip. Try the latest firmware patch from the provided GitLab link.

• Sound Issues:

  • If there is no sound, first test with another OS via an SD card to determine if it's a software or hardware problem.
  • If the headphone jack has no sound but speakers do, check if the headphone/UART console switch is set to UART mode and switch it to headphone mode.

Internal Switches and Buttons:

The mainboard features two switches:

• eMMC disable switch (24): Disables the eMMC.
• UART/Audio switch (9): Enables UART output via the headphone jack.

The Reset (28) button performs an immediate reset of the laptop. The Recovery (28) button is used to place the device in maskrom mode for flashing eMMC using Rockchip tools.

FCC Compliance:

Any changes or modifications not expressly approved by the responsible party could void the user's authority to operate the equipment. The device complies with Part 15 of the FCC Rules, meaning it must accept any interference received and not cause harmful interference. The SAR limit for USA (FCC) is 1.6 W/kg, and the device has been tested for typical operations at 0mm from the body.

PINE64 Pinebook Pro Specifications

General

RAM	4GB LPDDR4
Battery	10, 000 mAh
Weight	1.26 kg (2.78 lbs)
Wi-Fi	802.11ac
Bluetooth	Bluetooth 4.1
Webcam	720p
Processor	Rockchip RK3399
Storage	MicroSD card slot for storage expansion
Display	1920x1080 resolution
Graphics	Mali-T860
Operating System	Linux-based
Ports	USB 3.0, HDMI, headphone jack
Keyboard	Full-size keyboard
Trackpad	Multi-touch trackpad
Build	Magnesium alloy