{{warning|1=IMPORTANT INFORMATION for '''Early Adopters''' - please [[PineTab/Early-Adopter|'''CLICK HERE''']] - some '''known issues''' are listed there}}

The PineTab is a 10" tablet created by Pine64.

== Specifications ==
* '''Dimensions:''' 11mm x 175mm x 260mm (Thickness, Width, Height)
* '''Weight:''' 575g (Tablet alone)
* '''Build:''' Plastic
* '''Storage:'''
** 64GB of internal eMMC storage
** MicroSD slot, bootable
** M.2 SSD slot, supports SATA and USB devices only, not NVME (optional)
* '''Cameras:''' 2Mpx Front, 5Mpx Rear
* '''SOC:''' Allwinner A64 Quad Core
* '''CPU:''' 4x ARM A53 1.152GHz
* '''GPU:''' Mali 400 MP2
* '''RAM:''' 2GB LPDDR3
* '''I/O:''' HD Video Out (Mini HDMI), Micro USB 2.0 OTG, USB 2.0 A host, 3.5mm Headphone/Mic combo,
* '''Network'''
** WiFi (802.11b/g/n, 2.4GHz only)
** Bluetooth 2.1
** M.2 LTE / Cell MODEM card, (optional, and takes place of optional M.2 SSD)
* '''Screen:''' 10.1" IPS 800x1280 Capacitive LCD
* '''Attachments/Accessories:''' Magnetically attached keyboard (optional)
* '''Battery:''' 6000MAh (6Ah)
* '''Misc. features:'''
** Volume rocker and home button
** Speakers and Microphone
** 2.5mm OD 0.7mm ID DC Jack Power (5V 2A) Port

== Keyboard ==
'''Overview:''' The PineTab detachable keyboard features a full function row, FN key functionality, meta key (where the Windows key would be) and all of the keys you need for daily use.

'''FN keys:''': Pause/play (F2), Stop (F3), Previous(F4), Next(F5), Music (F6), Mail (F7), Home (F8), Mute (F9), Vol- (F10), Vol+ (F11), Disable touchpad (F12), NumLock (Insert), Scroll Lock (Delete), PgUp (Up Arrow), PgDn (Down Arrow), Home (Left Arrow), End (Right Arrow), Digital Numpad (7,8,9,0,U,I,O,P,J,K,L,;,M,.,/)

==Versions==
For now there is only one version, also mentioned in the manual leaflet in the box.

* "pinetab-dev": development version sent to ~100 developers. This one is like the Early Adopter version, but has a different display panel.
* [[PineTab/Early-Adopter|Early Adopter]]: the first hardware revision of the PineTab, which shipped to customers.

[[File:PineTabBoard.jpeg|400px|thumb|right|The insides of the PineTab]]

== PineTab board information, schematics and certifications ==
* PineTab mainboard schematic:
** [http://files.pine64.org/doc/PineTab/PineTab%20Schematic%20v1.2-20191125.pdf PineTab mainboard Released Schematic ver 1.2]
** [http://files.pine64.org/doc/PineTab/PineTab%20Board%20View%20v1.2-20191201-top.pdf PineTab mainboard component placement ver 1.2 - Top View]
** [http://files.pine64.org/doc/PineTab/PineTab%20Board%20View%20v1.2-20191201-bottom.pdf PineTab mainboard component placement ver 1.2 - Bottom View]
* PineTab keyboard schematic:
** PineTab keyboard and Pinebook (Pro) keyboard using same controller and from same engineering source
** [http://files.pine64.org/doc/PineTab/Pinetab%20HB092A%20Keyboard%20Schematic.pdf PineTab Keyboard Schematic]
** [http://files.pine64.org/doc/PineTab/HB092_0884232458_Hynitron_PTP_20200514_662905_Linux_US_BackLight_CRC_175057F5.hex PineTab keyboard firmware code]
** [http://files.pine64.org/doc/PineTab/SH68F83V2.0.pdf PineTab Keyboard Controller Datasheet]

* PineTab certifications:
** [http://files.pine64.org/doc/cert/PineTab%20FCC-SDOC%20Certificate-S20060600404001.pdf PineTab FCC Certificate]
** [http://files.pine64.org/doc/cert/PineTab%20CE-RED%20Certificate-S20060600403.pdf PineTab CE RED Certificate]
** [http://files.pine64.org/doc/cert/PINETAB%20ROHS%20TEST%20REPORT.pdf PineTab ROHS Test Report]

== Datasheets for components and peripherals ==
* Allwinner A64 SoC information:
** [http://files.pine64.org/doc/datasheet/pine64/A64%20brief%20v1.0%2020150323.pdf Allwinner A64 SoC brief introduction]
** [http://files.pine64.org/doc/datasheet/pine64/A64_Datasheet_V1.1.pdf Allwinner A64 SoC Data Sheet V1.1 (Official Released Version)]
** [http://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:
** [http://files.pine64.org/doc/datasheet/pine64/AXP803_Datasheet_V1.0.pdf AXP803 PMIC datasheet]

* LPDDR3 (178 Balls) SDRAM:
** [http://files.pine64.org/doc/datasheet/pinephone/ATL3A1632H12A_mobile_lpddr3_11x11.5_v1.0_1600.pdf Artmem LPDDR3 datasheet]

* eMMC information:
** [http://files.pine64.org/doc/rock64/PINE64_eMMC_Module_20170719.pdf PINE64 eMMC module schematic]
** [http://files.pine64.org/doc/rock64/usb%20emmc%20module%20adapter%20v2.pdf PINE64 USB adapter for eMMC module V2 schematic]
** [http://files.pine64.org/doc/rock64/USB%20adapter%20for%20eMMC%20module%20PCB.tar PINE64 USB adapter for eMMC module PCB in JPEG]
** [http://files.pine64.org/doc/datasheet/pine64/SDINADF4-16-128GB-H%20data%20sheet%20v1.13.pdf 64GB SanDisk eMMC Datasheet]

* CMOS camera module information:
** [http://files.pine64.org/doc/datasheet/pinephone/OV5640_datasheet.pdf OV5640 5MP CMOS Image Sensor SoC for Rear Module datasheet]
** [http://files.pine64.org/doc/datasheet/pinephone/GC2145%20CSP%20DataSheet%20release%20V1.0_20131201.pdf GC2145 2MP CMOS Image Sensor SoC for Front Module datasheet]

* LCD touch screen panel information:
** [http://files.pine64.org/doc/datasheet/pinetab/GT9271.pdf GOODiX GT9271 Capacitive Touch Controller datasheet]
** [http://files.pine64.org/doc/datasheet/pinetab/GT9271_Config_20200818_142030_V66.cfg PineTab GT9271 Capacitive Touch Controller configuration file]

* Lithium battery information:

* WiFi/BT module information:
** [http://files.pine64.org/doc/datasheet/pine64/RTL8723BS.pdf RTL8723BS/RTL8723CS specification]

== Operating Systems ==
The PineTab will automatically boot from microSD if a bootable card is inserted. Although it is technically possible to use any ARM distro (because the PineTab uses the mainline kernel), only few of them will actually be usable on Early Adopters PineTab, due to specifics of working with LCD panel. Among those listed all except for postmarketOS have working builds.

=== UBPorts ===
[[File:Ubports-logo.png|100px]]
The UBPorts Ubuntu Touch is what preinstalled on PineTab Early Adopters batch.

It can update itself, and also jenkins daily build can be downloaded [https://ci.ubports.com/job/rootfs/job/rootfs-pinetab/ here]

In the event that WiFi fails to connect, the USB port can be used with an appropriate dongle to connect for internet using ethernet cable.

=== postmarketOS ===
[[File:PostmarketOS-logo.png|100px]]
postmarketOS is a preconfigured version of [https://www.alpinelinux.org/ Alpine Linux] for mobile devices.

The latest builds can be downloaded from the [https://images.postmarketos.org/pinetab/ images page] to be flashed to the PineTab.

More information is available at [https://postmarketos.org postmarketos.org] and on their [https://wiki.postmarketos.org/wiki/PINE64_PineTab_(pine64-pinetab) dedicated PineTab wiki page].

=== Arch Linux ARM ===
[[File:Archlinux-logo.png|100px]]
Arch Linux ARM with Phosh as the UI selection, maintained by the DanctNIX community.

The latest image can be downloaded [https://github.com/dreemurrs-embedded/Pine64-Arch/releases here]

=== Manjaro ARM ===
[[File:Manjaro-logo.svg|100px]]
Th first Manjaro ARM image confirmed to be working on Early Adopters PineTab can be downloaded [https://next.manjaro.org/index.php/s/aeXDtbWnnBNEM2Q here], ref [https://forum.manjaro.org/t/manjaro-arm-alpha2-with-phosh-pinetab/150/12 forum thread].

Older Manjaro images with several different environments, including Phosh and Plasma, but '''not working on Early Adopters PineTab''' can be downloaded [https://osdn.net/projects/manjaro-arm/storage/pinetab/ here]

=== Mobian ===
[[File:Debian-logo.png|100px]]
Mobian is a project providing Debian images for mobile devices.

PineTab images can be downloaded [https://images.mobian-project.org/pinetab/ here]. Password is '''1234'''

== Installation instructions ==
For instructions on how to install the operating systems to the eMMC or microSD card see [[PinePhone Installation Instructions]]. The information is almost the same for the PineTab, as it is a very similar device. Do not try to use the PinePhone images though, use the PineTab images linked above.

=== Testing ===
To test an OS, just flash its image onto an microSD card, plug it into PineTab, and reboot.
Note that USB stick won't work.
Also note that you need to "flash", not just copy the file onto the card.
Also remember that you need to unpack image file if it's packed!

You can do it using Ubuntu Touch installed on the PineTab! For now, only Mobian is supported by the guide below.

* First, make sure you have enough free disk space and empty Downloads directory on the PineTab (while not strictly necessary, empty Downloads dir will simplify your typing. You can just move all files from there to another directory).
* go to the Mobian link above and download compressed image (the one ending with .img.gz) - usual recommendation is to download latest, i.e. lowest one.
* Open terminal and type this in it:
cd Downloads
ls
* It should show you the name of the file you've just downloaded
* This file is compressed, so first you need to uncompress it. Type this into terminal:
gunzip *.gz && echo done
* This command will take some time (you won't see any progress until it's done). It either will succeed (and print "done") and fail (and print why).
* Now, let's have a look at disks. Type this into terminal:
lsblk
* It should show you a tree of disks and their partitions. If you don't have microCD card inserted yet, all of them begin with mmcblk2. Also, some of them have something in the "MOUNTPOINT" column
* Insert microSD card into PineTab. Note that all information on it will be deleted, so don't insert one with valuable information on it!
* type `lsblk` into terminal again.
* Note that now tree of disks has one or more new entries - starting with mmcblk0 - that's partitions of your microSD card.
* Confirm that size of mmcblk0 is close to size of the microSD card, and all lines starting with mmcblk0 have empty "MOUNTPOINT" column.
* now type this:
sudo dd if=`ls` of=/dev/mmcblk0 bs=1M status=progress
* It will take some time, depending on speed of your microSD card and size of image file
* Now, reboot your PineTab - type this into terminal:
sudo reboot
* PineTab should boot from the microSD you've just flashed

== Tips and tricks ==

=== Reset ===

If your PineTab is in unknown state or doesn't want to start.
Press power button for 7-8s. It makes a sound and you know it's totally off. 3 seconds after, power button again for 2-3s and it will start to boot. - thanks
@Aperricio on IRC for this hint

=== Display rotated 90° on Arch ARM ===
With the following command you can turn the display to landscape:

* echo 1 | sudo tee /sys/class/graphics/fbcon/rotate

This command does not persist a reboot.

[[Category:PineTab]] [[Category:Allwinner A64]]

PinePhone Installation Instructions

2020-07-01T09:15:41Z

Ollieparanoid: /* Safe With No Extra Tools, But Slower */ dd: add "status=progress"

This section has generic installation instructions. Please see the [[PinePhone Software Releases]] section for specific installation instructions for each distribution.

== Boot priority ==

The default PinePhone boot priority is first the SD card and then the eMMC so inserting your own SD card with your preferred release will result in the phone booting your image.

== Preparation of SD card ==

# Download your chosen image from the options below
# Extract the compressed file
# Write the image to your SD card
# Plug SD card into phone
# Boot phone

If you need step-by-step instructions for writing an image to an SD card, check [[NOOB#Step-by-Step_Instructions_to_Flashing_MicroSD_Cards|the NOOB guide]], then return to this page.

=== bmaptool ===
Download the .img.xz and the .img.bmap files, then run <code>bmaptool copy --bmap image.bmap image.xz /dev/sdX</code>. This takes 2.5mins to flash a 4Gb file.

=== dd ===
Make sure to select the correct device using <code>lsblk</code>. Then run dd with the correct device:

<code>sudo dd if=pine.img of=/dev/[DEVICE] bs=1M status=progress conv=fsync</code>

== Installation to eMMC (Optional) ==

=== Method Using Factory Installed Tools ===

The initial OS you get with your phone has the option to flash an image on SD card to eMMC.

# Copy (not flash) the image file to a formatted SD card.
# Insert SD card into powered-off phone.
# Turn on phone and select option to install to eMMC.

=== Safe & Easy Method ===

[https://forum.pine64.org/showthread.php?tid=9444 Jumpdrive thread]

# download and extract [https://github.com/dreemurrs-embedded/Jumpdrive/releases the Jumpdrive image]
# flash the Jumpdrive image to a SD card
# boot from the SD card
# connect the PinePhone to your computer using USB-A -> USB-C cable.
# flash the exposed (mounted) PinePhone drive with a chosen OS image as you'd flash any SD card, and resize partitions (optional, see below)
# disconnect the PinePhone from your PC, power it down and remove the Jumpdrive SD card
# boot into your OS of choice on eMMC

The Jumpdrive image is smaller than 50MB. You can keep an SD card specifically for using Jumpdrive, and there are 64MB micro SD cards sold cheaply that will suffice.

=== Safe With No Extra Tools, But Slower ===

# Prepare a formatted SD card, flash desired OS to the SD card, and (optionally) resize the partition (see below)
# Insert SD card and boot the phone
# Open terminal and <code>git clone [url]</code> your desired project OR: Open web browser and download the desired OS image file.
# Build the OS (Optional)
# Flash the resulting image file you got by downloading or by building, to eMMC, using <code>dd if=/dev/mmcblkX of=/dev/mmcblkY bs=1M status=progress</code> where X is the number label of the SD card, and Y is the number label of the eMMC. Use the command ''lsblk'' to check your devices: typically with the current kernel the SD card is /dev/mmcblk0 and the eMMC is /dev/mmcblk2 but as always with ''dd'' be extremely cautious to get the devices correct. Then, resize partition to fill up entire disk (see below).
# Turn off phone, remove SD card. Turn on phone.

=== Risky Method ===

Warning: This copies a mounted filesystem, which can lead to instability, erratic behavior, and data corruption. Do not use long term.

# Prepare a new SD card, flash desired OS to the SD card
# Boot the phone with your new SD card image
# Within the booted OS, flash/clone the running OS to eMMC, e.g. using dd. It will take about 15 minutes (depending on the speed of your card), and in the end it may show an error about not enough space - just ignore it.
# Turn off phone, take out SD card, and try booting the phone which should load up the new OS from eMMC.
# Open terminal and resize partition to fill up entire disk (see below).

== Resize partition to fit disk space ==

Once you've flashed the OS to your SD card or eMMC storage, you may also need to expand the partition to fill all the available space.

=== Resize SD card's partition using computer ===

For SD cards, insert the SD card and resize the partitions through the computer. For eMMC, insert the phone cable and use Jumpdrive to access the eMMC directly, and resize the partition after flashing the image.

Using Growpart:

growpart /dev/sdX 1
resize2fs /dev/sdX 1

Locate growpart (<code>apt-cache search growpart</code> and install the package in the search results) and run:
growpart /dev/mmcblkX Y
resize2fs /dev/mmcblkXpY
where X is the storage device and Y is the partition number (viewable from lsblk).

If you get any errors about missing or unknown commands, use apt-cache search to find and install the needed software. Also don't forget to use sudo.

Using Parted:

Parted's interactive mode and resize work well together. Do this before you put your SD card into the PinePhone for the first time for best results.

sudo parted /dev/<your_sd_card_device>
(parted) resizepart 2 100%
(parted) quit
sudo resize /dev/<the_second_sd_card_PARTITION>

=== Resize from within PinePhone: ===

eMMC: you would need to resize the partition on eMMC (flashed with the operating system) by booting another image from the SD card: that way, the eMMC will be unmounted. It is '''not recommended''' to resize eMMC while booted from eMMC! Resizing a currently mounted partition can have weird results.

SD card: It is generally not possible to boot from eMMC to partition the unmounted SD card, because of the boot order -- you would have to write the image to the empty SD card first, then resize partition, all without rebooting. It is also '''not recommended''' to resize the SD card while booted from SD card! Resizing a currently mounted partition can have weird results.

== Reuse SD card for data storage on system booting from eMMC==
Once you have installed your release of choice to eMMC, you may wish to use an SD card for data storage. If you choose to re-use a card you have previously used to boot from, you will find your phone will not boot if you just reformat the card and insert it. This is because the Allwinner firmware in the PinePhone uses some (normally) unused space at the front of the SD card to store boot software, which you need to clear.

This can be done as follows on any linux system:
lsblk
to check the device of your SD card – as an example lets assume it is /dev/mmcblk0
then
sudo dd if=/dev/zero of=/dev/mmcblk0 bs=8k seek=1 count=4
will clear the relevant sectors of your card.