PINE64 - User contributions [en]

PineBuds Pro

2023-02-06T19:27:34Z

ImmyChan: Added a disassembly video

[[File:PineBudsPro.jpg|400px|thumb|right|The PineBuds Pro]]

The '''PineBuds Pro''' are open firmware capable ANC wireless earbuds. Some of the notable features include their light weight, 3 Microphones, ANC (Active Noise Cancellation), ENC (Environment Noise Cancellation) and high fidelity 6mm speaker. It is a fully community-driven side-project which anyone can contribute to, allowing you to keep control of your device even though hardware is proprietary.

== Specifications ==
'''Dimensions:'''
* '''Earbud:''' WIP
* '''Charging case:''' 70 x 50 x 35mm (unconfirmed)
'''Weight:'''
* '''Earbud:''' 5g
* '''Charging case:''' 65g
'''IP Rating of Earbuds:''' IPX4 
'''Dynamic transducer (speaker):''' 6mm 
'''Microphone:''' 3 – FeedForward, FeedBack, Talk 
'''System on Chip (in each earbud):''' BES 2300YP
* '''CPU:''' Dual-core 300MHz ARM Cortex-M4F
* '''ROM:''' 448KB
* '''SRAM:''' 992KB
* '''BT shared SRAM:''' 64KB
* '''Flash:''' 4MB (Endurance erase cycles: >500)
'''Communication:'''
* '''Bluetooth:''' Bluetooth 5.2 dual-mode compliant
* '''USB:''' USB to dual UARTs at charging case
'''Battery:'''
* '''Earbud:''' Built-in LiPo 3.7V 40mAh
* '''Charging case:''' Built-in LiPo 3.7V 800mAh
'''Port:'''
* '''Earbud''': 4 pins
* '''Charging case''':
** 4 pogo pins
** USB type-C port 5V 500mA

== Software releases ==

=== Firmware images ===

Flashing back the factory default firmware is possible using Windows-based utility:
* [https://files.pine64.org/os/PineBudsPro/PineBuds%20Pro%20programmer%20user%20manual.pdf PineBuds Pro Windows based programmer utility user manual]
* [https://files.pine64.org/os/PineBudsPro/PineBuds%20Pro%20programmer%20v1.48.zip PineBuds Pro Windows based programmer utility]
* [https://files.pine64.org/os/PineBudsPro/AC08_20221102.bin PineBuds Pro factory default firmware build]
* [https://files.pine64.org/os/PineBudsPro/ota_boot_rel_8054309a08.bin PineBuds Pro factory default OTA build]

=== SDK releases ===

* [https://files.pine64.org//SDK/PineBudsPro/PineBudsPro_SDK-20221128.7z PineBuds Pro "Little Whale" SDK date:20221128]

== Introduction ==
General information and tips about PineBuds Pro.

=== Buttons/touch sensors ===
==== Buds ====
One capacitive touch sensor is located on the outward facing surface of each bud near the logo.

==== Charging case ====
Charging case have a reset button in center under the lid which is hooked to ThinkPlus Semi SY8821 integrated circuit and that button reset it from the safety off mode.

=== Cleaning ===
PineBuds Pro only have IPX4 rating, so they are only splash-proof and cannot withstand immersion in water. Clean the charging case inside and out with a damp microfiber cloth. Inside, be careful near the pogo pins! The cloth easily sticks to them and may tear them. You can use a microfiber cloth at the end of a stick to immerse of the buds, but a cleaning tool made for this can help. When cleaning the buds, carefully remove the tips, place the buds on a damp microfibre cloth and one by one wipe it from all sides. Be careful with the protective mesh. If there is dirt in the mesh, you can carefully clean it with the brush of the previously mentioned tool. Wash the tips with soap and water, but be careful, they easily drip from your hand to drain. After drying them, carefully put them back to the buds.

'''You need:'''
* A microfiber cloth
* A cleaning tool like [https://www.aliexpress.com/item/1005004843772763.html this] or [https://www.aliexpress.com/item/1005004119111965.html this]

== Spare parts ==
Coming soon.

== Accessories ==
{{Under construction}}

=== Ear tips ===
TODO

=== Strap for buds ===

Although PineBuds Pro, "true wireless", earbuds are comfortably light and stay in ears better than wired ones (when nothing tug them from your ear), they can still did it, for example, during sports. Because they are completely non-wired, it also means that they will then drop directly to the ground and may break. That's why it might make sense to use a strap [https://www.amazon.com/Woocon-Silicone-Anti-slip-Accessories-Compatible/dp/B093DKHBVK like this] in sports. We are trying make strap for PineBuds Pro.

==== Strap with 3.5mm AUX connector ====

Each bud has pins through which is UART connection. When we find or make a strap for PineBuds Pro we can add wiring inside it and put PCB in the middle that receives analog signal with the 3.5mm AUX connector and feeds it to the buds.

=== Silicone case ===

Goal is to make a silicone case like [https://www.amazon.com/dp/B0BGNBFY6Z this] for PineBuds Pro.

"Design a mold, use a hobby 3D printer to manufacture it, then fill with silicone." ([https://matrix.to/#/!OGWEsuBXqiRfaqvtfm:matrix.org/$8FgCtx9jh2ZLnDFNvf2yN5nKMzv4V7XAn-zwuWKxfSM?via=matrix.org&via=tchncs.de&via=envs.net source]) 
"You can find a local hackspace or makerspace. Or you can use one of the many services available via the Internet who can print a model for you. Just design, upload, and pay." ([https://matrix.to/#/!OGWEsuBXqiRfaqvtfm:matrix.org/$TD5kfUkVLfx9Sbx5t0Z2oCsUTvmS0FPrwQn0Xrr5YiQ?via=matrix.org&via=tchncs.de&via=envs.net source]) 
"The only one I know of is "https://www.pcbway.com/rapid-prototyping/injection-molding/"" ([https://matrix.to/#/!jnYVOKPfUvfPXbQIpt:matrix.org/$sJ_QPEsqeSsJ8hRjgoZhZ9QwxpnslvOuBpT7SkSffAE?via=matrix.org&via=tchncs.de&via=matrix.ravenfieldsystems.com source])

== Disassembly steps ==
{{Under construction}}

=== Bud ===
=== Charging case ===
# First open the lid and then try to press the case from the front edge with a plectrum or a thin card. There are two clips on each side. Soon the case will snap open.
# Carefully unscrew and remove the PCB from the case.

A video demonstration can be found here: https://youtu.be/xXxRGXWvdVw

== Assembly steps ==
{{Under construction}}

=== Bud ===
=== Charging case ===
# Screw the PCB back into the place.
# There is plenty of space, glue the coil to the bottom of the case.
# Close the charging case.

== Wireless charging ==
PineBuds Pro doesn't have wireless charging by default, but you can add it. However, you need to know how to disassemble the charging case and solder bunch of SMT components to the PCB.

Pine originally planned to have wireless charging for the PineBuds Pro, but apparently for cost reasons they decided to cancel it. However, they left footprints on the PCB for wireless charging component. They also desiged COPO CP2021 component to be used. You also need a bunch of other components, such as resistors and of course [https://en.wikipedia.org/wiki/Electromagnetic_coil electromagnetic coil]. The places intended for the components, the footprints, are made for [https://en.wikipedia.org/wiki/Surface-mount_technology SMT (also called SMD)] components. That means you need [https://en.wikipedia.org/wiki/Soldering_station#Hot_air_soldering_stations a hot air soldering station] and experience.

'''Required tools:'''
* Picks/thin cards
* Screwdriver
* Hot air soldering station
* Tweezers
* Solder
* Flux
* Glue

'''Required components:'''
* COPO CP2021
* WIP

'''Work steps:'''
# First open the lid and then try to press the case from the front edge with a plectrum or a thin card. There are two clips on each side. Soon the case will snap open.
# Carefully unscrew and remove the PCB from the case.
# Solder the necessary components to their respective footprints, use the PineBuds Pro Charging Case Schematic/COPO CP2021 2.5W Qi Wire Power Receiver Datasheet (below).
# Screw the PCB back into the place.
# There is plenty of space, glue the coil to the bottom of the case.
# Close the charging case.

== Revisions ==

=== First revision ===

==== Known issues ====
* No padding one side of the battery in the charging case. In one reported case charging case has started to smell burnt after being dropped. The battery hit to the USB Type-C connector's corner and the battery was damaged. If this happens to you, replace the battery with a new one immediately! Adding a padding around the battery as a precaution is advised.

== SoC and Memory Specification ==
[[File:BES-Tech.jpg|right]]

The PineBuds Pro are based on the [http://www.bestechnic.com/home/product/index/cate_id/6 BES 2300YP]

[[File:BES2300YP_Block_Diagram.jpg|600px]]

[[File:Cortex-M4.png|right|400px]]

SoC architecture:
* CPU Features:
** [https://developer.arm.com/Processors/Cortex-M4 Dual-core ARM Cortex-M4F Processor Processor up to 300MHz CPU]
** CMOS Single-chip Fully-integrated RF, PMU, Audio CODEC and Cortex-M4F CPU
* Memory Features:
** 4MB Serial Flash On-chip for Custom Program
** Internal ROM 448KB for critical constants and code
** Internal SRAM 992KB for critical data and code
* BT Features:
** Bluetooth 5.2 dual-mode compliant
** Profiles: A2DP, AVRCP, HFP
** Audio Codecs: SBC, AAC
* Audio Features:
** Support BES Intelligent Bluetooth Retransmission (IBRT)
** Support FF/Hybrid ANC
** Dual MICs noise reduction
** Echo Cancellation
** Support low power voice activity detection
** Multi-band EQ and Bass enhancement
** Support Active Crossover
** Support TWS
** HiFi Stereo Audio DAC: 120dB SNR, 110dB DNR
** HiFi Stereo Audio ADC: 100dB SNR
** Sample rates from 8 kHz to 384 kHz
** Support dual/single Mic noise suppression
*** -45dB attenuation nominal 50-200Hz
*** -55dB max attenuation @150Hz
** Support ambient awareness
** Support talk through
** 24-bit audio processing
* PMU Features
** 3.1V-5.5V Input for VBAT
** Internal LPO for low power mode.
** DCXO with internal oscillator circuit
** Internal temperature sensor

== Information, Schematics and Certifications ==
Input Power: DC 5V @ 0.5A USB Type-C

Documents:
* [https://files.pine64.org/doc/PineBudsPro/PineBuds%20Pro%20User%20manual-20220920-8pages-20221116.pdf PineBuds Pro User Manual]

Schematics:
* [https://files.pine64.org/doc/PineBudsPro/PineBuds%20Pro%20mainboard%20schematic-20220817.pdf PineBuds Pro Earbuds Schematic 20220817]
* [https://files.pine64.org/doc/PineBudsPro/PineBuds%20Pro%20charging%20cradle%20schematic-20220915.pdf PineBuds Pro Charging Case Schematic 20220915]

Certifications:
* [https://files.pine64.org/doc/cert/PineBuds%20Pro%20CE%20EMC%20Certificate-LCSA090522058E.pdf PineBuds Pro CE EMC Certificate]
* [https://files.pine64.org/doc/cert/PineBuds%20Pro%20CE%20RED%20Certificate-LCSA090522057E.pdf PineBuds Pro CE RED Certificate]
* [https://files.pine64.org/doc/cert/PineBuds%20Pro%20FCC%20SDOC%20Certificate-LCSA090522056E.pdf PineBuds Pro FCC Certificate]
* [https://files.pine64.org/doc/cert/PineBuds%20Pro%20ROHS%20Report-LCSA090522054R.pdf PineBuds Pro ROHS Report]

== Datasheets for Components and Peripherals ==

BES 2300YP SoC information:
* [https://files.pine64.org/doc/datasheet/PineBudsPro/BES2300-YP_Datasheet_v1.0.pdf BES 2300-YP Datasheet V1.0]

Charging case:
* [https://files.pine64.org/doc/datasheet/PineBudsPro/SY8821_SPEC_V1_2_2.pdf ThinkPlus Semi SY8821 Datasheet in Chinese]
* [https://files.pine64.org/doc/datasheet/PineBudsPro/CH342DS1.PDF WCH Tech CH342DS USB to Dual Serial ports chip Datasheet]
* [https://files.pine64.org/doc/datasheet/PineBudsPro/COPO%20CP2021%202.5W%20Qi%20Wire%20Power%20Receiver.pdf COPO CP2021 2.5W Qi Wire Power Receiver Datasheet (Unpopulated)]

EarBuds:
* [https://files.pine64.org/doc/datasheet/PineBudsPro/CE3156-EN-01.pdf ChiPower Tech CE3156 Single Cell Charger Datasheet]
* [https://files.pine64.org/doc/datasheet/PineBudsPro/LP3992-33B5F.pdf LowPower Semi LP3992 LDO Regulator Datasheet]
* [https://files.pine64.org/doc/datasheet/PineBudsPro/HLW-YHX190_20190810.pdf HLW Semi HLW-YHX190 OTP micro Datasheet in Chinese (noted: for power-on and reset control)]
* [https://files.pine64.org/doc/datasheet/PineBudsPro/TTP233D-SB6_V1.0_EN.pdf Tontek TTP-233D one key touch pad detect IC Datasheet]

[[Category:PineBuds Pro]] [[Category:BES 2300YP]]

Pinebook Pro Software Releases

2022-12-17T16:19:02Z

ImmyChan: Mentioned the broken Debian

= Linux OS Image Releases =
For information on how to install these images onto your device, please see the [[NOOB]] Page, which includes information on writing images to the device eMMC or an SD card

== Manjaro ARM ==
[[File:Manjaro.png|right|100px]]

The Manjaro project offers a mainline kernel with patches and modules to support PBPro hardware. To learn more about Manjaro please visit [https://forum.manjaro.org/c/arm/ Manjaro Forum]. You can follow the ongoing discussion about Manjaro on the [https://forum.pine64.org/showthread.php?tid=8207 PINE64 forum].
All images boot from both SD card and the internal eMMC module.

[https://manjaro.org/download/ Direct download from Manjaro]: You have to navigate to the Manjaro ARM Team section and select "Generic" as the device in the drop-down list. (The Pinebook-pro specific image has been removed and it's now included in the generic one since [https://forum.manjaro.org/t/manjaro-arm-22-08-released/119602/ version 22.08]).
Then you can choose Gnome, KDE Plasma, Mate, Minimal, Sway or Xfce.

=== Factory-loaded OS build ===

* [https://files.pine64.org/os/PinebookPro/manjaro/Manjaro-ARM-kde-plasma-pbpro-bsp-22.06%20(2).img.xz Manjaro/Plasma 22.06 factory loaded build]
** MD5 (XZ file): d78031a4bed3eeb4f2001f3c89b9ed5a
** File Size: 1.04GB

== Armbian ==
===Armbian is a base operating system platform for single board computers (SBCs) that other projects can trust to build upon.===

* Lightweight Debian or Ubuntu based Linux distribution specialized for ARM development boards
* Each system is compiled, assembled and optimized by Armbian Build Tools
* It has powerful build and software development tools to make custom builds
* A vibrant community
[[File:armbian.png|right|100px]]

To download the latest Armbian Desktop or CLI images for Pinebook Pro, please visit [https://www.armbian.com/pinebook-pro/ The Pinebook Pro Download Page].

===If you have any difficulties please visit our [https://forum.armbian.com forum] or come chat with us on [https://docs.armbian.com/Community_IRC/ IRC / Discord!]===

== Twister OS ==

[[File:Twister_OS.png|right|100px]]

Twister OS Armbian-Reforged with Xfce. It boots from microSD card and from eMMC. For more information on Twister OS, please visit this [https://twisteros.com/ official site]. You can follow the ongoing discussion about Twister OS on the [https://forum.pine64.org/showthread.php?tid=12192 PINE64 forum].

'''Installation'''

* After flashing image, edit /boot/armbianEnv.txt, replace the dtb name with <code>rk3399-pinebook-pro.dtb</code>

'''Download location'''

Get the latest image here: [https://twisteros.com/twisterarmbian.html Direct download latest images from Twister OS's website] (size: 2.8GB)

'''Password'''

asdasd

== Fedora ==
[[File:fedora1.png|right|100px]]

=== Fedora Official ===

Using this [https://nullr0ute.com/2021/05/fedora-on-the-pinebook-pro/ blog post] it is now possible to run Official Fedora on the Pinebook Pro.

'''Notes'''
Upstream Fedora uses SPI flash on the Pinebook Pro to manage uboot.

=== Fedora 32 with Cinnamon ===

This image contains an install of Fedora with [https://cinnamon-spices.linuxmint.com/ Cinnamon] desktop environment. It boots from microSD card and from eMMC. To learn more about Fedora please visit the [https://getfedora.org/ official website].

'''Download location'''

Get the latest image here: [https://builds.armdevelopers.com/pinebook-pro/releases/dev/Fedora32-Cinnamon-Desktop-202009.0.pinebook-pro.img.xz Fedora 32 Pinebook Pro Image]

'''Username and password'''

root/fedora

=== Fedora 32 with KDE ===

This image contains an install of Fedora with [https://kde.org/ KDE aka Plasma] desktop environment. It boots from microSD card and from eMMC. To learn more about Fedora please visit the [https://getfedora.org/ official website].

'''Download location'''

Get the latest image here: [https://builds.armdevelopers.com/pinebook-pro/releases/dev/Fedora32-KDE-Desktop-202009.0.pinebook-pro.img.xz Fedora 32 Pinebook Pro Image]

'''Username and password'''

root/fedora

=== Fedora 32 with Xfce===

This image contains an install of Fedora with [https://xfce.org/ Xfce] desktop environment. It boots from microSD card and from eMMC. To learn more about Fedora please visit the [https://getfedora.org/ official website].

'''Download location'''

Get the latest image here: [https://builds.armdevelopers.com/pinebook-pro/releases/dev/Fedora32-Xfce-Desktop-202009.0.pinebook-pro.img.xz Fedora 32 Pinebook Pro Image]

'''Username and password'''

root/fedora

=== Fedora 32 with Gnome ===

This image contains an install of Fedora with [https://www.gnome.org/gnome-3/ GNOME 3] desktop environment. It boots from microSD card and from eMMC. To learn more about Fedora please visit the [https://getfedora.org/ official website].

'''Download location'''

Get the latest image here: [https://builds.armdevelopers.com/pinebook-pro/releases/dev/Fedora32-Workstation-202009.0.pinebook-pro.img.xz Fedora 32 Pinebook Pro Image]

'''Username and password'''

root/fedora

== Arch Linux ARM ==
[[File:Archlinux-logo.png|right|100px]]

=== Official Installation ===
See [[Installing Arch Linux ARM On The Pinebook Pro]] for instructions on how to install the official Arch Linux ARM.

=== Customized Premade Root Filesystem ===
An Arch Linux ARM root filesystem customized for the Pinebook Pro using Manjaro's kernel is available. Instructions are included for installation on microSD card, eMMC module and NVME SSD.

'''Download location'''

[https://github.com/SvenKiljan/archlinuxarm-pbp/releases/latest Get the latest root filesystem from GitHub] (size: 500-600 MB).

'''Installation'''

Make sure to thoroughly read the [https://github.com/SvenKiljan/archlinuxarm-pbp/blob/main/README.md readme], [https://github.com/SvenKiljan/archlinuxarm-pbp/blob/main/INSTALL.md installation instructions] and [https://github.com/SvenKiljan/archlinuxarm-pbp/blob/main/FAQ.md FAQ].

'''Username and password'''

The default Arch Linux ARM user credentials.

Username: alarm

Password: alarm

The password for the root account is 'root'.

== postmarketOS ==
[[File:PostmarketOS logo.png|right|100px]]

Official postmarketOS stable builds are available for the Pinebook Pro with the following interfaces:

* console
* GNOME
* KDE Plasma Desktop
* Phosh
* Sway

It boots from microSD card and from eMMC.

'''Download location'''

Get the stable image here: https://postmarketos.org/download/ (size: 103 MB to 775 MB)

The installer images allows setting up an encrypted installation on SD or eMMC.

'''Username and password'''

user/147147

==Kali Linux==
[[File:Kali.jpeg|right|100px]]

=== Kali Linux prebuilt OS images for Pinebook Pro===

Official pre-built OS images of Kali Linux for the Pinebook Pro featuring all tools you'd expect from the distribution. It boots from microSD card and from eMMC.

'''Download location'''

Get the latest image here: [https://www.offensive-security.com/kali-linux-arm-images/ Direct download latest images from Offensive Security's website] (size: 2.0 GB)

'''Username and password'''

kali/kali

== R-Cade ==
[[File:RCadeLogo.jpg|right|100px]]

Retro Center's R-Cade [USB / microSD / eMMC Boot]
* The 4K Media Center Arcade
* [https://www.retro-center.com/about-r-cade/ RCade] Features 100+ retro-gaming systems, a lightweight web browser, and full 4K UHD media playback
* DD image to USB, microSD, or eMMC and boot. Highly recommend using [https://etcher.io/ Etcher]
** [https://github.com/retro-center/rcade_releases/releases Direct download from Retro Center's GitHub]

'''Username and password'''

root/retro

== Q4OS ==
[[File:q4os.png|right|100px]]

Q4OS is advertised as a 'fast and powerful operating system based on the latest technologies while offering highly productive desktop environment'. It boots from microSD card and from eMMC. To learn more please visit the [https://forum.pine64.org/showthread.php?tid=8385 PINE64 forum] or official [https://q4os.org/index.html Q4OS website].

'''Download location'''

Get the latest image here: [https://sourceforge.net/projects/q4os/files/stable/ Direct download latest release build from SourceForge]

'''Username and password'''

User account and password are created on first run.

== DietPi ==
[[File:dietpi.png|right|100px]]

* DietPi is a '''lightweight''', yet '''easy to setup''' and '''feature-rich''' Linux distribution, based on '''Debian'''.
* To find out more about DietPi, please visit the [https://dietpi.com/docs/ official documentation].
* Discuss the Pinebook build on the [https://forum.pine64.org/showthread.php?tid=14061 PINE64 forum thread].
* DD image (for 4 GiB micro SD card and above)
** [https://dietpi.com/downloads/images/DietPi_PinebookPro-ARMv8-Bullseye.7z Direct download from dietpi.com]
* Login with
** Username: '''root'''
** Password: '''dietpi'''

== openSUSE ==
[[File:opensuse-distribution.png|right|100px]]

'''Download location'''

Get the latest openSUSE Tumbleweed images for Pinebook Pro here: [https://en.opensuse.org/HCL:Pinebook-Pro-RK3399]

Credits to [https://bugzilla.opensuse.org/show_bug.cgi?id=1194491]
Step 1. Flash Tow-Boot[https://github.com/Tow-Boot/Tow-Boot] to SPI
Step 2. Flash openSUSE image to sd card & insert it
Step 3. When it loads grub, press e and add the following line:

devicetree /boot/dtb/rockchip/rk3399-pinebook-pro.dtb

Press ctrl + x to boot

Work : display, wifi
Not tested : bluetooth
Doesn't work : audio

You may build rpms and see if it fix issues from this repository: [https://github.com/bengtfredh/pinebook-pro-copr]

== FydeOS ==
An operating system based on the Chromium Project

https://fydeos.io/download/device/pinebook-pro

== Void Linux ==
[[File:void_bg.png|right|100px]]
=== Images ===
[https://voidlinux.org/ Void Linux] packages U-Boot and a kernel for the Pinebook Pro, but does not distribute any images for the device.

Cameron Nemo ([[User:CameronNemo]]) distributes unofficial Void Linux images for the Pinebook Pro:

* [https://repo.nohom.org/void/images/void-pinebookpro-20220530.img.xz glibc download]
* [https://repo.nohom.org/void/images/void-pinebookpro-musl-20220610.img.xz musl download]

Some notes about the images:

* They were released on 2022-05-30 (glibc) and 2022-06-10 (musl)
* They ship U-Boot 2022.04 and Linux 5.15 (with minimal patches)
* Meant to be uncompressed then flashed to either an SD card or the internal eMMC module
* The root partition is ~1.7GB, and must be expanded manually
* There are very few services enabled on the images by default: udev and some getty's
* The default root password is "voidlinux"

=== Do It Yourself ===
{{Warning|This is not an official, nor supported way of using Void Linux on the Pinebook Pro.}}
You can also manually install Void from a rootfs tarball: [[Installing_Void_Linux_ARM_On_The_Pinebook_Pro|see instructions here]].

= BSD =

==NetBSD==
[[File:netbsd.png|right|100px]]

The image boots from microSD card and from eMMC. To learn more about NetBSD please visit [https://www.netbsd.org/ NetBSD main page]

'''Download location'''

Get the latest image here: [http://www.armbsd.org/arm/ Direct download from NetBSD]

'''Installation'''

Instructions concerning enabling SSH can be found [https://www.netbsd.org/docs/guide/en/chap-boot.html#chap-boot-ssh here].

'''Username and password'''

root/(none)

==OpenBSD==
[[File:Puffy_mascot_openbsd.png|right|100px]]

The image boots from microSD card and from eMMC. To learn more about OpenBSD, please visit [https://www.openbsd.org/ OpenBSD main page]

'''Download location'''

ARM64 images, (including support for Pinebook Pro), can be found here [https://www.openbsd.org/arm64.html OpenBSD arm64]

= Linux Installer Releases =

== Manjaro ARM ==
[[File:Manjaro.png|right|100px]]

The [https://gitlab.manjaro.org/manjaro-arm/applications/manjaro-arm-installer manjaro-arm-installer] script is intended to install Manjaro ARM directly to SD/eMMC cards without the need for images (including LXQT, Mate & CuboCore editions, as well as full disk encryption).

Running on a Linux x86 computer, it can install Manjaro ARM directly to an empty eMMC using an eMMC to USB adapter. The script can also be run from SD to install an image to the eMMC.
 
== Armbian ==
[[File:armbian.png|right|100px]]
===You can use the [https://github.com/armbian/build Armbian Builder] to generate your own Armbian images of various types.===

The builder supports building any version of Debian and any version of Ubuntu with various desktop options:
<li>Budgie
<li>Cinnamon
<li>Deepin
<li>Enlightenment
<li>Gnome
<li>I3-wm
<li>Kde-plasma
<li>Mate
<li>Xfce
<li>Xmonad

== Debian ==
[[File:debian.png|right|100px]]

* Uses only the upstream kernel and firmware without special patches
* Display doesn't always work properly on first boot of installer, usually fixed after a couple tries
* Requires adding the non-free component to your /etc/apt/sources.list file and installing the "firmware-linux" package for Wi-Fi and Bluetooth support. If your Pinebook Pro was part of the June/July 2022 batch, then you will need the "firmware-brcm80211" to accommodate the changed networking hardware. You will also need "brcmfmac43455-sdio.txt" in /lib/firmware/brcm, at least until it is included within firmware-brcm80211 upstream.
* Installer is loaded into RAM, can install onto the same media from which it’s booted
* Supports automatic partitioning and full disk encryption through LVM
* Installer currently doesn't install a functional bootloader, leaving the installed system in an unbootable state until it's manually added (if installed to eMMC, the system cannot be booted even to an SD card unless the eMMC is physically switched off or there is U-Boot in the SPI)

[https://d-i.debian.org/daily-images/arm64/daily/netboot/SD-card-images/ The relevant files are built daily here] and may sometimes be unavailable if the build system is having issues. The "README.concatenateable_images" file provides instructions on how to combine the partition.img.gz file with the firmware.pinebook-pro.rk3399.img.gz file in order to create a DD-able image.

The official images are '''not''' recommended yet until the display begins working consistently and the installer properly installs the bootloader. Most users will want to see [[Pinebook Pro Debian Installer|Daniel Thompson's Debian Installer]] instead. Although, unfortunately this tool is unable to finish successfully at present.

== Gentoo ==
[[File:GentooLogo.png|right|100px]]

There is a script that prepares a Gentoo arm64 stage 3 tarball for the Pinebook Pro. Unfortunately, this script is not currently functional, and requires extensive troubleshooting to make work. New instructions are currently being created and will be available here.

'''Word to the wise'''

Currently, following the instructions on the Pinebook pro gentoo github page will *not* result in a functional system. Therefore it is neccesary to follow the instructions given here. Please bear in mind that the Pinebook pro's six arm cores and 4gb of ram are extremely anemic. For example, emerging the package net-libs/webkit-gtk in order to build the minimalist web-browser "surf", a process which takes eighty minutes on an intel core i5-8250U with 8gb of ram, required eight hours of compile time,
Basic installation alone can take 24 hours of compillation, dozens of reboots, and hours of troubleshooting. After that, even installing firefox would take 17 hours.
Now that that's out of the way, we may begin the installation.

'''Preparing the bootloader'''

Installing a functional bootloader can be difficult. Luckily, the tow-boot project provides a UEFI-like experience for some arm-based devices. Furthermore, it is not neccesary install this bootloader manually, as it will continue to be useable even after the disk has been reformatted, as long as the bootloader remains unscathed.

https://manjaro.org/downloads/arm/pinebook-pro/arm8-pinebook-pro-minimal/

No-matter where you intend to install gentoo, the bootloader should always be installed on the eMMC flash, although technically the SD card slot could also be used. Either way, install any of the official Manjaro arm disk images to the internal eMMC (there's no reason not to use the minimal image, as you will not be using this OS for anything). You may use a second operating system installed on an SD-card, or the official Pine64 eMMC USB adapter. Boot into this operating system to ensure that the bootloader functions, but after that you have no further need of it.

Next, if you already have an OS on an SD card, you can use that for installing gentoo. If you don't, you may be pleasantly suprised to find that tow-boot is cabable of booting from a USB drive. Therefore, you may install the same Manjaro image to your USB drive or SD card, and select it from the boot menu. You should now have an unused but bootable OS on the eMMC, and another bootable, usable OS on your external storage.

'''Preparing the Disks'''

Log into your host device as root with the following command:

<code> sudo su </code>

Enter your password.

Let the device on which you intend to install gentoo be refered to hereafter as /dev/<gentoo>. Use the following command to prepare this disk for installation:

<code> fdisk -B /dev/<gentoo> </code>

Note: don't just copy these commands! You should substitute <gentoo> for mmcblk2 for the internal eMMC flash storage.

Note that the first block of the boot partition is block 62500. Delete all partitions, but *do not* re-format the disk. Create a new boot partition starting at 62500, and as it's size select "+1GB". Create a new swap partition. fdisk will try to start it at the beginning of the volume (before the boot partition) Instead, when it prompts you for the starting position, enter in the end sector of the boot partition. It should then tell you that this is within an existing partition, and recommend a slightly higher value. Press enter, and give for the size of the partition any value greater than "+4gb". You need this much ram to be able to suspend your system, and emerge large packages. Don't be stingey - you still have SD cards. I reccomend "+8gb".
Finally, add a root partition starting at the end sector of the swap partition, and use the rest of the disk for it. That should be 50-60 GB depending on the size of your swap and boot partitions.

Lastly, press "t" to set the type of each partition. You may set partition 1 to type 6, 2 to type 82, and 3 to type 83.

to set the partition types of the three partitions.

<code>lsblk</code>

to remind yourself which disk is /dev/<gentoo>
Write the filesystems to these three partitions with the commands:

<code>mkfs.vfat /dev/<gentoo>p1

mkswap /dev/<gentoo>p2

mkfs.ext4 /dev/<gentoo>p3</code>

This may be a slightly different format if you're installing to a usb stick.

'''Installation'''

make the directory for mounting the filesystem you just created. These should be made on the external OS.

<code>mkdir /mnt/gentoo

mount /dev/<gentoo>p3 /mnt/gentoo</code>

cd into this directory and fire up links. Navigate to gentoo.org/downloads and select the stage 3 minimal stage 3 tarball. Download it to your current directory, or move it to that directory from wherever it has been downloaded to. Once you are in the correct directory, unpack the tarball.

<code>tar xpvf stage3-arm64-<blah blah blah></code>

Mount the boot partition.

<code>mount /dev/<gentoo>p1 /mnt/gentoo/boot</code>

Chroot into the mounted directory and Install the operating system as per the AMD64 manual [https://wiki.gentoo.org/wiki/Handbook:AMD64]. Before you emerge anything, however, be sure to set your use flags as follows:

<code>nano /etc/portage/make.conf</code>

<code>MAKEOPTS="-j4 -l4"

ACCEPT_KEYWORDS="* **"

ACCEPT_LICENSE="*"

USE="X gtk bluetooth pulseaudio"
</code>

You can use your own options instead of these if you know what you're doing. It's not super difficult.

Continue installing the operating system, but stop just before emerging the @world set. I don't know if this is necessary, but I haven't had the time to try without doing this. Clone Janikk2099's github repo. It doesn't matter where, and run the script. If it fails run it a couple more times.

<code>git clone https://github.com/Jannik2099/gentoo-pinebookpro

./gentoo-pinebookpro/prepare.sh</code>

Don't follow any of Janikk's other instructions. They appear to be out of date (no offense bro). Let me be clear: DO NOT INSTALL U-BOOT. I don't know what will happen, but it won't be an improvement over the existing boot-loader so don't worry about it.

Finish installing your system until you come to the kernel.

'''Custom Kernel'''

Use sys-kernel/gentoo-kernel-bin as your kernel. You will need to manually edit the kernel configuration. First, select it as your kernel.

<code>eselect kernel list</code>

This should list only one option. Otherwise, select the number matching <code>linux-5.<whatever is latest>-gentoo-dist</code>, and cd into the kernel source directory.

<code>eselect kernel set <number>

cd /usr/src/linux</code>

Begin the kernel configuration

<code>make menuconfig</code>

At this point, you're almost on your own. I don't know a strict cause-and-effect relationship between my kernel config and the behavior of my system. For starters, just go into platform selection and deselect everything except rockchip platforms. Once you're done save your configuration and exit. Make sure boot is mounted, and your fstab is set up with your swap mounted. Make sure dracut is installed.

<code>make

make modules

make dtbs

make install

make modules install

make dtbs_install

ls /lib/modules

dracut -f --kver <name of directory in /lib/modules matching your kernel, *not* the kernel name from eselect>
</code>

emerge the package extlinux and run <code>u-boot-update</code>. Open the extlinux configuration file.

<code>nano /boot/extlinux/extlinux.conf</code>

And configure it as follows:

LABEL <label of your choice, for example GENTOO ARM>

KERNEL /<name of your vmlinuz kernel image. Include the slash, but be relative to boot, not root.>

FDT /dtbs/<kernel-version>/rockchip/rk3399-pinebook-pro.dtb

APPEND initrd=/<name of initramfs image> root=PARTUUID-<nboot partition's PARTUUID, no quotes> rw rootwait
</code>

You can use the blkid command to find the PARTUUID of every partition on the machine. None of this configuration is guaranteed to work, but it worked for me, and given enough fiddling you can get it to work as well.

Now you should reboot the machine and see if it boots into gentoo. If it does: congratulations! If not, too bad. Try again.

== Kali Linux ==
[[File:Kali.jpeg|right|100px]]

There is a script to create official Kali Linux OS images for the Pinebook Pro. The script carries out the build process in entirety and is Pinebook Pro specific.

'''Installation'''

* Please pull the latest [https://gitlab.com/kalilinux/build-scripts/kali-arm/blob/master/pinebook-pro.sh Kali Linux install script] from the project's GitLab.
* For more information regarding building the OS image please read the README instruction at https://gitlab.com/kalilinux/build-scripts/kali-arm/blob/master/README.md

== K1ss OS ==
[[File:K1ss.png|right|100px]]

There is a repository containing an unofficial port of KISS Linux to AARCH64. The tarball is built for generic aarch64, currently being tested on the Pinebook Pro. You can follow the ongoing discussion about K1ss Linux on the [https://forum.pine64.org/showthread.php?tid=9304 PINE64 forum].

'''Installation'''

* Please pull the latest [https://github.com/jedavies-dev/kiss-aarch64 K1ss Linux install script] from the project's GitHub.

== NixOS ==
[[File:nixos.png|right|100px]]

You can follow the ongoing discussion about NixOS on the [https://forum.pine64.org/showthread.php?tid=10524 PINE64 forum]. There is a good chance we will see Tier 1 support for aarch64, including the Pinebook Pro, in 2021 (see https://github.com/NixOS/rfcs/pull/87).

'''Installation'''

* This is instructions to install NixOS on the Pinebook Pro: https://nixos.wiki/wiki/NixOS_on_ARM/PINE64_Pinebook_Pro
* Please pull the latest [https://github.com/samueldr/wip-pinebook-pro samueldr's repository ] from the project's GitHub.
* [[NixOS Tutorials]]

== SkiffOS ==
[[File:SkiffOS-Icon-1.png|right|100px]]

'''Installation'''

* Instructions to build/install on the Pinebook Pro: https://github.com/skiffos/SkiffOS/tree/master/configs/pine64/book
* Please pull the latest version from the project's GitHub.
* Compiling the boot image takes approximately 30 minutes.
* Easily configure the kernel, compiler, etc with Buildroot.
* Pre-built ISOs will be available with the upcoming 2021.02 release.

== Slackware ==

<div style=float:right>[[File:slackware.jpg|right|100px]]</div>

[https://arm.slackware.com/ Slackware] is the world's oldest actively developed Linux distribution, providing a modern user land (applications) and Linux Kernel, within a more classic Unix Operating System environment.

More information can be found about Slackware in this [https://www.youtube.com/watch?v=A5PFYUttsWA&list=PL1XOSJnvang3IbwySOf6m3PK1gm13hS5s 20 minute video].

[https://docs.slackware.com/slackwarearm:inst Installation instructions].

[https://www.youtube.com/watch?v=QKs_RnFqLO8&list=PL1XOSJnvang3VLmqke2QbRitKtOD6Rm3t Installation guide video]

== Ubuntu ==

If you install Tow-Boot to the SPI, you may then be able to use generic arm64 install disks, such as those for Ubuntu. This is because Tow-Boot can use UEFI boot partitions. The arm64 builds of the Ubuntu installer "ISOs" can be [http://cdimage.ubuntu.com/ubuntu/releases/22.04/release/ found here]. These can then be converted to UEFI bootable USB drives using a tool such as unetbootin or the Ubuntu "Startup Disk Creator".

Ubuntu 22.04 does install and boot on a Pinebook Pro, however the speakers and wifi are non-functional. A USB wifi adapter can get you online.

Upgrading such an install to 22.10 fixes the wifi. The graphics are broken in an odd way on first boot, but then functional after that. The speakers are still non-functional.

A fresh install of 22.10 would presumably produce a similar result.

[[Category:PineBook Pro]]

PINE A64

2022-12-17T16:13:35Z

ImmyChan: Added RISC OS

[[File:PINEA64_sideimg.jpg|400px|thumb|right|The PINE A64]]

The '''PINE A64''' is ''PINE64's'' first Single Board Computer powered by Allwinner’s A64 quad-core ARM Cortex A53 64-Bit SoC. There are many Operating Systems available for the PINE A64 created by the open source community and various partner projects. Currently the majority of Linux distributions for the PINE A64 are using mainline Linux but there are a number of BSP-based distribution and / or legacy systems that can be downloaded too.

== Software and OS Image Downloads ==
=== [[Pine_A64_Software_Release|PINE A64(+)]] ===
'''Note that PINE A64(+) OS images are not compatible with PINE A64-LTS due to its LPDDR3 memory configuration.

For PINE A64-LTS OS image downloads please refer to the [https://wiki.pine64.org/index.php/PINE_A64-LTS/SOPine_Main_Page SoPine and Pine64-LTS Section]'''

Under [[Pine_A64_Software_Release|PINE A64(+) Software and OS Image Download Section]] you will find a complete list of currently supported Operating System images that work with the PINE A64(+) as well as other related software.

The list includes OS images and descriptions of:

[[Pine_A64_Software_Release#Armbian|'''Armbian''']]

[[Pine_A64_Software_Release#AOSC|'''AOSC''']]

[[Pine_A64_Software_Release#Fedora_Base_Image|'''Fedora Base Image''']]

[[Pine_A64_Software_Release#openSUSE|'''openSUSE''']]

[[Pine_A64_Software_Release#OpenWRT|'''OpenWRT''']]

[[Pine_A64_Software_Release#Volumio_2 Digital_Audio_Player|'''Volumio 2 Digital Audio Player''']]

[[Pine_A64_Software_Release#FreedomBox|'''FreedomBox''']]

[[Pine_A64_Software_Release#motionEyeOS|'''motionEyeOS''']]

[[Pine_A64_Software_Release#DietPi|'''DietPi''']]

[[Pine_A64_Software_Release#LibreELEC(KODI)|'''LibreELEC(KODI)''']]

[[Pine_A64_Software_Release#NetBSD|'''NetBSD''']]

[[Pine_A64_Software_Release#Android_6.x|'''Android 6.x''']] / [[Pine_A64_Software_Release#Android_5.x|'''Android 5.x''']]

=== Quick Links to OS Images Build Sources===
'''Some of the provided OS images are still in beta or nightly build and only fit for testing purposes. These images ought to be avoided for normal usage - use them at your own risk'''

* [https://www.stdin.xyz/downloads/people/longsleep/pine64-images/ longsleep BSP Linux]
* [https://github.com/ayufan-pine64/linux-build/releases/latest/ ayufan Linux]
* [https://github.com/ayufan-pine64/android-7.1/releases/latest/ ayufan Android 7.1] | [https://github.com/ayufan-pine64/android-6.0/releases/latest/ ayufan Android 6.0] | [https://github.com/ayufan-pine64/android-5.1/releases/latest/ ayufan Android 5.1]
* [https://pine64suse.weebly.com/download.html openSUSE]
* [https://dl.armbian.com/pine64/archive/ Armbian]
* [https://github.com/anarsoul/linux-build/releases/latest Arch Linux XFCE by anarsoul]
* [https://pine64fedora.weebly.com/download.html Fedora]
* [https://forum.pine64.org/showthread.php?tid=1937 Gentoo]
* [https://sourceforge.net/projects/q4os/files/stable/ Q4OS]
* [https://downloads.lede-project.org/snapshots/targets/sunxi/cortexa53/ OpenWRT]
* [https://dietpi.com/downloads/images/ DietPi]
* [https://github.com/openhab/openhabian/releases/latest/ openHAB 2]
* [https://volumio.org/get-started/ Volumio Digital Audio Player] | [https://forum.pine64.org/showthread.php?tid=88&action=lastpost External DAC Forum Thread]
* [https://github.com/A3sal0n/FalconGate/wiki/Downloads FalconGate]
* [https://github.com/ccrisan/motioneyeos/releases motionEyeOS]
* [https://downloads.blissroms.com/Bliss/Official/pine-a64+/ Bliss OS]
* [https://sourceforge.net/projects/openmediavault/files/Other%20armhf%20images/ OpenMediaVault]
* [https://www.riscosopen.org/content/downloads/pinea64 RISC OS]
== [[Accessories_Step_by_Step_Guides|Accessories Step-by-Step Guides]] ==
Under [[Accessories_Step_by_Step_Guides|'Guides for PINE A64(+) accessories']] you can find instructions and guides pertaining to:
* Enclosures
* Bluetooth and WiFi module
* Real Time Clock (RTC) battery
* Real Time Clock (RTC) battery holder
* First and third party cases
* Featured 3D printed cases (and more).

== SoC and Memory Specification ==
* Based on Allwinner A64
[[File:Allwinner_A64.jpg|right]]

=== CPU Architecture ===
* [https://www.arm.com/products/processors/cortex-a/cortex-a53-processor.php Quad-core ARM Cortex-A53 Processor@1152Mhz]
* A power-efficient ARM v8 architecture
* 64 and 32bit execution states for scalable high performance
* Support NEON Advanced SIMD (Single Instruction Multiple Data) instruction for acceleration of media and signal processing function
* Support Large Physical Address Extensions(LPAE)
* VFPv4 Floating Point Unit
* 32KB L1 Instruction cache and 32KB L1 Data cache
* 512KB L2 cache

=== GPU Architecture ===
* [https://www.arm.com/products/multimedia/mali-gpu/ultra-low-power/mali-400.php ARM Mali400MP2 Dual-core GPU]
* Support OpenGL ES 2.0 and OpenVG 1.1 standard

=== System Memory ===
* RAM Memory Variants: 512MB, 1GB and 2GB DDR3.
* Storage Memory: PINE A64 boards ''do not'' have built-in Flash memory but use '''bootable microSD Cards''' or USB attached storage.

== Board Features ==
=== Video ===
* Digital Video Port (Type A - full)

=== Audio ===
* 3.5mm stereo earphone/microphone plug

=== Network ===
* 10/100/1000Mbps Ethernet(PINE A64+ version), 10/100Mbps Ethernet(PINE A64 version)
* WiFi 802.11 b/g/n with Bluetooth 4.0 (optional)

=== Storage ===
* microSD - bootable, support SDHC and SDXC, storage up to 256GB
* USB - 2 USB2.0 Host port

=== Expansion Ports ===
* DSI - Display Serial Interface, 4 lanes MiPi, up to 1080P
* CSI - CMOS Camera Interface up to 5 mega pixel
* TP - Touch Panel Port, SPI with interrupt
* RTC - Real Time Clock Battery Connector
* VBAT - Lithium Battery Connector with temperature sensor input
* Wifi/BT Module Header - SDIO 3.0 and UART
* 2x20 pins "Pi2" GPIO Header
* 2x17 pins "Euler" GPIO Header
* 2x5 pins "EXP" Console Header

== Pine A64 Board Information, Schematics and Certifications ==
* Board Dimensions: 133mm x 80mm x 19mm
* Input Power: DC 5V @ 2A, 3.7V Li-Ion battery connector, microUSB connector, Euler connector
* [https://wiki.pine64.org/images/1/1d/Power_Consumption.jpg Power Consumption: 2.5W]
* [https://wiki.pine64.org/images/7/7d/Pine64_Board_Connector.png PINE A64 Connector Layout @courtesy of norm24]
* [https://wiki.pine64.org/images/2/2e/Pine64_Board_Connector_heatsink.png PINE A64 Heat Sink Location @courtesy of norm24]
* [https://wiki.pine64.org/images/d/da/Pine64_Connector.JPG PINE A64 Connector List]
* [https://files.pine64.org/doc/Pine%20A64%20Schematic/Pine%20A64%20Pin%20Assignment%20160215.pdf PINE A64 Pi-2/Eular/Ext Bus/Wifi Bus Connector Pin Assignment (Updated 15/Feb/2016)]
** [https://synfare.com/599N105E/hwdocs/pine64/index.html Good documentation about PINE A64, A64+, and A64-LTS GPIO pins article]
* [https://wiki.pine64.org/images/b/be/Pine64_Model_Spec.JPG Board Model Comparison]
* PINE A64 Board Schematic:
** [https://files.pine64.org/doc/Pine%20A64%20Schematic/Pine%20A64%20512MB%20rev%20B-2015121601_Release.pdf PINE A64 512MB Rev B Board Schematic]
** [https://files.pine64.org/doc/Pine%20A64%20Schematic/a64-db-rev%20b-20151217-Plus-Release.pdf PINE A64+ 1GB Rev B Board Schematic]
** [https://files.pine64.org/doc/Pine%20A64%20Schematic/Pine%20A64plus%202GB%20Rev%20C-20160113_Release.pdf PINE A64+ 2GB Rev C Board Schematic]
** [https://files.pine64.org/doc/Pine%20A64%20Schematic/A64-DB-WIFI-BT-REV%20B.pdf PINE A64 Wifi/BT Module Schematic]
* PINE A64 Stereo Audio Dac Board Schematic
**[https://forum.pine64.org/attachment.php?aid=697 PINE A64 Stereo Audio Dac Board Schematic]
* PINE A64 Certifications:
** Disclaimer: Please note that PINE64 SBC is not a "final" product and in general certification is not necessary. However, PINE64 still submit the SBC for FCC, CE, and ROHS certifications and obtain the certificates to prove that the SBC board can pass the testing. Please note, a final commercial product needs to perform its own testing and obtain its own certificate.
** [https://files.pine64.org/doc/cert/Pine%20A64%20Board%20FCC%20certification%20CCF20160624.jpg PINE A64 FCC Certificate]
** [https://files.pine64.org/doc/cert/Pine%20A64%20Board%20CE%20Certification%20CCF20160624.jpg PINE A64 CE Certificate]
** [https://files.pine64.org/doc/cert/CCF20160627_00000.jpg PINE A64 RoHS Certificate]

== Datasheets for Components and Peripherals ==
* Allwinner A64 SoC information:
** [https://files.pine64.org/doc/datasheet/pine64/A64%20brief%20v1.0%2020150323.pdf Allwinner A64 SoC Brief Introduction]
** [https://files.pine64.org/doc/datasheet/pine64/A64_Datasheet_V1.1.pdf Allwinner A64 SoC Data Sheet V1.1 (Official Released Version)]
** [https://files.pine64.org/doc/datasheet/pine64/Allwinner_A64_User_Manual_V1.0.pdf Allwinner A64 SoC User Manual V1.0 (Official Release Version)]
* X-Powers AXP803 PMU (Power Management Unit) information:
** [https://files.pine64.org/doc/datasheet/pine64/AXP803_Datasheet_V1.0.pdf AXP803 PMIC Datasheet]
* '''PINE A64, PINE A64+ and SOPINE Related:'''
** 5MPixel CMOS Camera module information:
*** [https://files.pine64.org/doc/datasheet/pine64/YL-PINE64-4EC.pdf PINE64 YL-PINE64-4EC 5M Pixel CMOS Image Sensor Module (Description in Chinese)]
*** [https://files.pine64.org/doc/datasheet/pine64/S5K4EC%205M%208%205X8%205%20PLCC%20%20Data%20Sheet_V1.0.pdf S5K4EC 5MP CMOS Image Sensor SoC Module Datasheet]
*** [https://files.pine64.org/doc/datasheet/pine64/S5K4ECGX_EVT1_DataSheet_R005_20100816.pdf S5K4EC 5MP CMOS Image Sensor SoC Chip Datasheet]
*** [https://files.pine64.org/doc/datasheet/pine64/s5k4ec.c S5K4EC 5MP CMOS Image Sensor Driver Source Code in C language]
*** Early version Camera module information:
**** [https://files.pine64.org/doc/datasheet/pine64/D116-A64_Bonsen_cmos_camera.pdf Bonsen Kexin V118-A64-GC2145-HM5065 CMOS Image Sensor Module]
**** [https://files.pine64.org/doc/datasheet/pine64/HM5065-DS-V03.pdf HiMax 5MP CMOS Image Sensor SoC]
** LCD Touch Screen Panel information:
*** [https://files.pine64.org/doc/datasheet/pine64/FY07024DI26A30-D_feiyang_LCD_panel.pdf 7.0" 1200x600 TFT-LCD Panel Specification]
*** [https://files.pine64.org/doc/datasheet/pine64/HK70DR2459-PG-V01.pdf Touch Panel Specification]
*** [https://files.pine64.org/doc/datasheet/pine64/GT911%20Capacitive%20Touch%20Controller%20Datasheet.pdf GOODiX GT911 5-Point Capacitive Touch Controller Datasheet]
** Lithium Battery information:
*** [https://files.pine64.org/doc/datasheet/pine64/9070120P%203.7V%208000MAH.pdf 8000mAH Lithium Battery Specification]
** Ethernet PHY information:
*** [https://files.pine64.org/doc/datasheet/pine64/rtl8211e(g)-vb(vl)-cg_datasheet_1.6.pdf Realtek RTL8211 10/100/1000M Ethernet Transceiver for PINE A64+ Board]
*** [https://files.pine64.org/doc/datasheet/pine64/rtl8201cp.pdf Realtek RTL8201 10/100M Ethernet Transceiver for PINE A64 Board]
** Wifi/BT module information:
*** [https://files.pine64.org/doc/Pine%20A64%20Schematic/A64-DB-WIFI-BT-REV%20B.pdf PINE A64 Wifi/BT Module Schematic]
*** [https://files.pine64.org/doc/datasheet/pine64/RTL8723BS.pdf Realtek RTL8723BS WiFi with BT SDIO]
** Enclosure information:
*** [https://files.pine64.org/doc/datasheet/case/playbox_enclosure_20160426.stp Playbox Enclosure 3D file]
*** [https://files.pine64.org/doc/datasheet/case/ABS_enclosure_20160426.stp ABS Enclosure 3D file]
*** [https://files.pine64.org/doc/datasheet/case/pine64%20Die%20Cast%20casing-final.jpg Outdoor Aluminum Cast Dust-proof IP67 Enclosure Drawing]
** Connector information:
*** [https://files.pine64.org/doc/datasheet/pine64/ePH.pdf 2.0mm PH Type connector specification use in Lithium Battery (VBAT) port and RTC Battery port]
*** [https://files.pine64.org/doc/datasheet/pine64/0.5FPC%20Front%20Open%20Connector%20H=1.5.pdf 0.5mm Pitch cover type FPC connector specification use in DSI port, TP port and CSI port]
** Remote control button mapping
*** [https://files.pine64.org/doc/Pine%20A64%20Schematic/remote-wit-logo.jpg Official Remote Control for the PINE A64 Button Mapping]

== Pine A64 POT ==
* [[POT|PINE A64 Peripheral On Top (POT) and Related Devices]]
* [[Wifi_Remote_I2c|WiFi Remote I2c Quick Start Guide]]

== Other Resources ==
* [https://linux-sunxi.org/Pine64#Manufacturer_images Linux Sunxi Wiki page on PINE A64]
* [https://github.com/longsleep/build-pine64-image PINE A64 Linux build scripts, tools and instructions by Longsleep]
* [https://www.stdin.xyz/downloads/people/longsleep/pine64-images/ PINE A64 Linux image by Longsleep]
* [https://github.com/ayufan-pine64/linux-build/releases PINE A64 Linux Github by ayufan]
* [https://github.com/ayufan-pine64/android-7.1/releases PINE A64 Android Github by ayufan]
* [https://www.armbian.com/pine64 Armbian's PINE A64 Page]
* [https://github.com/umiddelb/z2d/tree/master/pine64 Collection of scripts to set up a minimal Xenial 14.04.3 / Debian 8 Jessie root filesystem Contributed By Uli Middelberg]
* [https://github.com/apritzel/pine64 Linux Image created by Andre Przywara]
* [https://blog.hypriot.com/post/the-pine-a64-is-about-to-become=the-cheapest-ARM-64-bit-platform-to-run-Docker/ PINE A64 with HypriotOS by Dieter and Govinda]
* [https://sosfakeflash.wordpress.com/2008/09/02/h2testw-14-gold-standard-in-detecting-usb-counterfeit-drives/comment-page-3/#comment-9861 H2testw 1.4 – Gold Standard In Detecting USB Counterfeit Drives]
* [https://oss.digirati.com.br/f3/ F3 - an alternative to h2testw]
* [https://www.phoronix.com/scan.php?page=article&item=pine-64-benchmark&num=1 Benchmarking The Low-Cost PINE 64+ ARM Single Board Computer by Michael Larabel]
* [https://www.youtube.com/playlist?list=PLgj96wTPcMKffRm_Sk6673Nfy_I6b5UJW A series of Youtube video on PINE A64 Developers Board by Michael Larson]
* [https://rayhightower.com/blog/2016/04/04/pine64-quick-start-guide-using-mac-os-x/ PINE64 Quick Start Guide (with Gotchas)]
* [https://softwarebakery.com/shrinking-images-on-linux Shrinking images on Linux by FrozenCow]
* [https://github.com/avafinger/ffmpeg-3.3.4_cedrus264 FFmpeg Hardware encoder Cedrus264 on Linux by avafinger ]

[[Category:Pine A64]] [[Category:Allwinner A64]]

Pinebook

2022-12-17T16:12:23Z

ImmyChan: Added RISC OS

== Software and OS Image Downloads ==
=== [[Pinebook_Software_Release|Pinebook]] ===
Under [[Pinebook_Software_Release|'Pinebook Software and OS Image Download Section']] you will find a complete list of currently supported Operating System images that work with the Pinebook as well as other related software.

=== Quick Links to OS Images Build Sources===
'''Some of the provided OS images are still in beta or nightly build and only fit for testing purposes. These images ought to be avoided for normal usage - use them at your own risk'''

* [https://github.com/ayufan-pine64/linux-build/releases/latest/ ayufan Linux]
* [https://github.com/ayufan-pine64/android-7.1/releases/latest/ ayufan Android 7.1]
* [https://downloads.blissroms.com/Bliss/Official/pinebook/ Pinebook Bliss OS]
* [https://dl.armbian.com/pinebook-a64/archive/ Pinebook Armbian]
* [https://github.com/anarsoul/linux-build/releases/latest Arch Linux XFCE]
* [https://sourceforge.net/projects/q4os/files/stable/ Q4OS]
* [https://www.riscosopen.org/content/downloads/pinea64 RISC OS]

== [[Pinebook_Service_Step_by_Step_Guides|Pinebook Service Step-by-Step Guides]] ==
Under [[Pinebook_Service_Step_by_Step_Guides|'Service Guides for Pinebook']] you can instructions guides concerning disassembly of:

'''Note: The installation process is the reverse order of removal guide'''

* 14″ Pinebook Lithium Battery Pack Removal Guide
* 14″ Pinebook LCD Panel Screen Removal Guide
* 14″ Pinebook eMMC Module Removal Guide
* 11.6″ Pinebook Lithium Battery Pack Removal Guide
* 11.6″ Pinebook LCD Panel Screen Removal Guide
* 11.6″ Pinebook eMMC Module Removal Guide

== Pinebook Information ==
* Dimensions: 329mm x 220mm x 12mm (WxDxH - 14" Pinebook)
* Weight: 1.26Kg (14" Pinebook)
* Input Power: DC 5V @ 3A

== SoC and Memory Specification ==
* Based on Allwinner A64
[[File:Allwinner_A64.jpg|right]]

=== CPU Architecture ===
* [https://www.arm.com/products/processors/cortex-a/cortex-a53-processor.php Quad-core ARM Cortex-A53 Processor@1152Mhz]
* A power-efficient ARM v8 architecture
* 64 and 32bit execution states for scalable high performance
* Support NEON Advanced SIMD (Single Instruction Multiple Data) instruction for acceleration of media and signal processing function
* Support Large Physical Address Extensions(LPAE)
* VFPv4 Floating Point Unit
* 32KB L1 Instruction cache and 32KB L1 Data cache
* 512KB L2 cache

=== GPU Architecture ===
* [https://www.arm.com/products/multimedia/mali-gpu/ultra-low-power/mali-400.php ARM Mali400MP2 Dual-core GPU]
* Support OpenGL ES 2.0 and OpenVG 1.1 standard

=== System Memory ===
* System RAM Memory: 2GB
* Storage Memory: 16GB eMMC module, can be upgrade to 32GB or 64GB eMMC module

=== Battery ===
* Lithium Polymer Battery (10,000mAH)

=== Video ===
* Mini Digital Video Port (Type A - mini)

=== Audio ===
* 3.5mm stereo earphone/microphone plug

=== Network ===
* WiFi 802.11 b/g/n with Bluetooth 4.0
* 10/100Mbps USB Ethernet Dongle (Optional)

=== Storage ===
* microSD - bootable, support SDHC and SDXC, storage up to 256GB
* USB - 2 USB2.0 Host port

=== Expansion Ports ===
* mini Digital Video port
* microSD card port - support SD, SDHC, SDXC uo to 256GB
* 2x USB 2.0 port
* earphone plug with UART console mux circuit

== Pinebook Schematics and Certifications ==
* Pinebook A64 Main Board Schematic:
** [https://files.pine64.org/doc/pinebook/pinebook_mainboard_schematic_3.0.pdf Pinebook Main Board Schematic]
* Pinebook Daughter Board Schematic:
** [https://files.pine64.org/doc/pinebook/pinebook_smallboard_schematic_1.0.pdf Pinebook Daughter Board Schematic]
* Pinebook Serial Console Earphone Jack Pinout:
** [https://files.pine64.org/doc/pinebook/guide/Pinebook_Earphone_Serial_Console_Developer_Guide.pdf Pinebook Serial Console Earphone Jack Pinout]

* Pinebook Certifications:
** [https://files.pine64.org/doc/cert/Pinebook%20FCC%20certification%20VOC20170928.pdf Pinebook FCC Certificate]
** [https://files.pine64.org/doc/cert/Pinebook%20FCC%20ID-Spread%20Spectrum%20Transmitter.pdf Pinebook FCC ID-Spread Spectrum Transmitter Certificate]
** [https://files.pine64.org/doc/cert/Pinebook%20FCC%20ID-Digital%20Transmission%20System.pdf Pinebook FCC ID-Digital Transmission System Certificate]
** [https://files.pine64.org/doc/cert/Pinebook%20CE%20certification%20Micom20171207.pdf Pinebook CE Certificate]
** [https://files.pine64.org/doc/cert/Pinebook%20ROHS%20certification%20VOC20170918.pdf Pinebook RoHS Certificate]

== Datasheets for Components and Peripherals ==
* Allwinner A64 SoC information:
** [https://files.pine64.org/doc/datasheet/pine64/A64%20brief%20v1.0%2020150323.pdf Allwinner A64 SoC Brief Introduction]
** [https://files.pine64.org/doc/datasheet/pine64/A64_Datasheet_V1.1.pdf Allwinner A64 SoC Data Sheet V1.1 (Official Released Version)]
** [https://files.pine64.org/doc/datasheet/pine64/Allwinner_A64_User_Manual_V1.0.pdf Allwinner A64 SoC User Manual V1.0 (Official Release Version)]
* X-Powers AXP803 PMU (Power Management Unit) information:
** [https://files.pine64.org/doc/datasheet/pine64/AXP803_Datasheet_V1.0.pdf AXP803 PMIC Datasheet]
* LPDDR3 information:
** [https://files.pine64.org/doc/datasheet/pine64/AWL3A1632_mobile_lpddr3_1600Mbps.pdf Allwinner LPDDR3 Datasheet]
** [https://files.pine64.org/doc/datasheet/pine64/FORESEE%20178ball%2012x11.5%20LPDDR3%2016G%20Spec%20V1.0-1228.pdf Foresee LPDDR3 Datasheet]
** [https://files.pine64.org/doc/datasheet/pine64/K4E6E304EE-EGCE.pdf Samsung LPDDR3 Datasheet]
** [https://files.pine64.org/doc/datasheet/pine64/LPDDR3%20178ball%208Gb_H9CCNNN8JTALAR_Rev1.0.pdf Hynix LPDDR3 Datasheet]* eMMC information:
** [https://files.pine64.org/doc/rock64/PINE64_eMMC_Module_20170719.pdf PINE64 eMMC module schematic]
** [https://files.pine64.org/doc/datasheet/pine64/SDINADF4-16-128GB-H%20data%20sheet%20v1.13.pdf SanDisk eMMC Datasheet]
** [https://files.pine64.org/doc/datasheet/pine64/FORESEE_eMMC_NCEMASD9-08G%20SPEC%20A0%2020150818.pdf Foresee eMMC Datasheet]
* eMMC information:
** [https://files.pine64.org/doc/rock64/PINE64_eMMC_Module_20170719.pdf PINE64 eMMC module schematic]
** [https://files.pine64.org/doc/rock64/usb%20emmc%20module%20adapter%20v2.pdf PINE64 USB adapter for eMMC module V2 schematic]
** [https://files.pine64.org/doc/rock64/USB%20adapter%20for%20eMMC%20module%20PCB.tar PINE64 USB adapter for eMMC module PCB in JPEG]
** [https://files.pine64.org/doc/datasheet/pine64/E-00517%20FORESEE_eMMC_NCEMAM8B-16G%20SPEC.pdf 16GB Foresee eMMC Datasheet]
** [https://files.pine64.org/doc/datasheet/pine64/SDINADF4-16-128GB-H%20data%20sheet%20v1.13.pdf 32GB/64GB/128GB SanDisk eMMC Datasheet]
* SPI NOR Flash information:
** [https://files.pine64.org/doc/datasheet/pine64/w25q128jv%20spi%20revc%2011162016.pdf WinBond 128Mb SPI Flash Datasheet]
** [https://files.pine64.org/doc/datasheet/pine64/GD25Q128C-Rev2.5.pdf GigaDevice 128Mb SPI Flash Datasheet]
* Wifi/BT module information:
** [https://files.pine64.org/doc/datasheet/pine64/RTL8723BS.pdf Realtek RTL8723BS WiFi with BT SDIO]
* LCD Panel:
** [https://files.pine64.org/doc/datasheet/pinebook/11.6inches-1080P-IPS-LCD-Panel-spec-WJFH116008A.pdf 1920x1080 1080P 11.6" IPS LCD Panel datasheet]
** [https://files.pine64.org/doc/datasheet/pinebook/11.6inches-TFT-LCD%20Approval%20Specification%20N116BGE-E42%20Ver%203.0.pdf 1366x768 11.6" TFT LCD Panel datasheet]
** [https://files.pine64.org/doc/datasheet/pinebook/14inches-HB140WX1-501(%20EDP1.2)%20Preliminary%20Product%20specification.pdf 1366x768 14" TFT LCD Panel datasheet]
* Touchpad information:
** [https://files.pine64.org/doc/datasheet/pinebook/11-Toucpad-HK-9058%20specification.pdf Touchpad Specification for 11.6" model]
** [https://files.pine64.org/doc/datasheet/pinebook/14-Touchpad-HK-9562%20specification.pdf Touchpad Specification for 14" model]
* Camera sensor:
** [https://files.pine64.org/doc/datasheet/pinebook/ZC-RZ3762-3703%C2%A0S1.0-Camera-Module%20spec.pdf VGA Camera module specification]
** [https://files.pine64.org/doc/datasheet/pinebook/VGA-CMOS-Sensor--BF3703%20Datasheet.pdf VGA Camera Sensor Data Sheet]
* Lithium Battery information:
** [https://files.pine64.org/doc/datasheet/pinebook/PL5267103P-3.7V-10000mAh-1S2P58-9-W101-7P正向-11.6.pdf 10000mAH Lithium Battery Specification for 11.6" model]
** [https://files.pine64.org/doc/datasheet/pinebook/40110175P%203.8V%2010000mAh规格书-14.pdf 10000mAH Lithium Battery Specification for 14" model]

== Other Resources ==
* [https://linux-sunxi.org/Pine_Pinebook Linux Sunxi Wiki page on Pinebook]
* [https://github.com/ayufan-pine64/linux-build/releases Pinebook Linux Github by ayufan]
* [https://github.com/ayufan-pine64/android-7.1/releases Pinebook Android Github by ayufan]
* [https://www.armbian.com/pinebook-a64 Armbian's Pinebook Page]

== FAQ / Tips and tricks ==
'''Key left of Z ( \ | )'''

How to map the key next to Z to the symbols on \ and | (rather than <>) ?

Choose the alternative international US keyboard layout and variant. The name will depend on you desktop environment:

* English (US, alt. intl.)
* English (US, international AltGr Unicode combining, alternative)
* English (US, alternative international)

'''Note:''' keyboard variants with similar names as the ones above change the upper left key for ` and ~. You have to press that key twice to get the desired char. This happens with the alt-intl variant. Choose the altgr-intl variant (or however it is called in your desktop environment) and it should work as expected.

To set the keyboard layout and variant in the terminal for X-Windows use:

setxkbmap -layout us -variant altgr-intl

The Archlinux Wiki has some good help if you need to tweak your layout further [https://wiki.archlinux.org/index.php/Xorg/Keyboard_configuration#Setting_keyboard_layout]

'''Key between Fn and Alt (Menu)'''

How to map the key between Fn and Alt to SUPER / META ?

The initial setup in many desktop environments maps the key between Fn and Alt to MENU. Although the menu key can be useful as well (e.g. spell correction in the browser) many desktop environments and window manager use the Super key for many other useful functions. And users are probably more used to have the META key near Ctrl and Alt.

In X-windows the following command maps the key between Fn and Alt to META and the Caps-Lock key to MENU.

setxkbmap -option caps:menu,altwin:alt_super_win

'''Set display brightness in the terminal'''

To set the display brightness in the terminal use xbacklight (if available in your distro):

xbacklight -setXX

XX is the percentage (%) of brightness. E.g. for 70% brightness

xbacklight -set70

If you use LXQt you can also use:
pkexec lxqt-backlight_backend --inc
pkexec lxqt-backlight_backend --dec

For an alternative solution please see the scripts discussed in this thread: [https://forum.pine64.org/showthread.php?tid=5062]

'''Get battery % in CLI'''

As ACPI is not compatible with ARM, to gather the % battery this can be used:

cat /sys/class/power_supply/battery/capacity

'''Firefox font size'''

How to get a useful font size with firefox ?

To have every web page displayed in a larger more readable font size type about:config in the search bar and confirm on the first page that you want to make changes. Then search for this parameter:

layout.css.devPixelsPerPx

and modify the value (right click) to something between 1.2 to 1.5 depending on your preferences.

In addition to that you can set in Preferences -> General -> Fonts & Color -> Advanced Minimum font size to 16

'''Disable wireless power management'''

If having issues with wifi connectivity, try to disable power management in the 8723cs module options, adding rtw_power_mgnt=0 in /etc/modprobe.d/8723cs.conf

options 8723cs rtw_initmac=00:ba:ch:16:85:46 rtw_power_mgnt=0

'''Touchpad acceleration and scroll direction.'''

To set touchpad parameters from the cli you can use the command ''xinput''.
To use it correctly you first need to determine the device id / name for your touchpad. Use
xinput list
to do so.
You are looking for a line like this:
HAILUCK CO.,LTD USB KEYBOARD Mouse id=7 [slave pointer (2)]

With the device id = 7 found you can list the parameters that can be set with ''xinput''.
xinput list-props 7

The result looks similar to this:
device 'HAILUCK CO.,LTD USB KEYBOARD Mouse':
...
libinput Natural Scrolling Enabled (256): 0
...
libinput Accel Speed (265): 0.000000
...

To change the parameter use ''xinput set-prop''

To set reverse scrolling for the touchpad use this command
xinput set-prop 7 'libinput Natural Scrolling Enabled' 1

To set mouse speed
xinput set-prop 7 'libinput Accel Speed' 0.95
Check different numbers for 0.95 to meet your needs.

For more details on xinput and mouse speed also see the Archlinux Wiki [https://wiki.archlinux.org/index.php/Mouse_acceleration#Using_xinput]

[[Category:PineBook]] [[Category:Allwinner A64]]