Difference between revisions of "PinePhone FAQ"

From PINE64
Jump to navigation Jump to search
 
(28 intermediate revisions by 5 users not shown)
Line 8: Line 8:
  
 
==== Is the Community Edition hardware the latest revision? ====
 
==== Is the Community Edition hardware the latest revision? ====
The Community Edition program (featuring the mainboard numbers 1.2 through 1.2b and branded back covers) which provided the branded Pinephones has since ended, and a Beta Edition has since been released. The only difference between each Community Edition is the inclusion of crucial bug fixes, with the last issue being fixed with the 1.2b motherboard shipping with the Manjaro CE PinePhones. The 1.2B motherboard is also currently used in the Beta Edition PinePhones, however the Beta Edition units do not ship with any back cover branding. There is currently no plans for further hardware revisions.
+
The Community Edition program (featuring the mainboard numbers 1.2 through 1.2b and branded back covers) which provided the branded PinePhones has since ended, and a Beta Edition has since been released. The only difference between each Community Edition is the inclusion of crucial bug fixes, with the last issue being fixed with the 1.2b motherboard shipping with the Manjaro CE PinePhones. The 1.2b motherboard is also currently used in the Beta Edition PinePhones, however the Beta Edition units do not ship with any back cover branding. There are currently no plans for further hardware revisions.
  
Aside from the back cover, the only other difference between each Community Edition is that starting with the postmarketOS PinePhone, a convergence package option was released that adds another gigabyte of ram to the phone and a 32GB eMMC instead of a 16GB eMMC. Convergence packages also included a dock for plugging in USB peripherals and connecting to a HDMI monitor, however you can purchase a generic USB-C dock to use with a 2GB PinePhone.  
+
Aside from the back cover, the only other difference between each Community Edition is that starting with the postmarketOS PinePhone, a convergence package option was released that adds another gigabyte of ram to the phone and a 32GB eMMC instead of a 16GB eMMC. Convergence packages also included a dock for plugging in USB peripherals and connecting to an HDMI monitor, however you can purchase a generic USB-C dock to use with a 2GB PinePhone.  
  
 
The predecessor to the Convergence Edition PinePhones was the Braveheart Edition intended for developers to bring up the platform, which had the version number 1.1. For more details about the topic see [[PinePhone#Hardware Revisions]].
 
The predecessor to the Convergence Edition PinePhones was the Braveheart Edition intended for developers to bring up the platform, which had the version number 1.1. For more details about the topic see [[PinePhone#Hardware Revisions]].
Line 18: Line 18:
  
 
==== In simple terms, what are the differences between Braveheart and the new Community Edition? ====
 
==== In simple terms, what are the differences between Braveheart and the new Community Edition? ====
The Braveheart PinePhone was the first public revision of the PinePhone which was intended solely for developers and Linux enthusiasts. The Ubports Community Edition was the next revision of the PinePhone with an updated mainboard based on feedback from the Braveheart Edition, see [[PinePhone#Hardware Revisions]]. All current revisions of the PinePhone continue to be intended for developers and enthusiasts, however Pine64 will be starting to offer partnered retail units of the PinePhone in 2021 which will have a better warranty and technical support (keep in mind even then it is not intended for a broader audience at this time, as the software still needs work and the hardware does not hold up well to modern consumer standards).
+
The Braveheart PinePhone was the first public revision of the PinePhone which was intended solely for developers and Linux enthusiasts. The UBports Community Edition was the next revision of the PinePhone with an updated mainboard based on feedback from the Braveheart Edition, see [[PinePhone#Hardware Revisions]]. All current revisions of the PinePhone continue to be intended for developers and enthusiasts, however, PINE64 will be starting to offer partnered retail units of the PinePhone which will have a better warranty and technical support (keep in mind even then it is not intended for a broader audience at this time, as the software still needs work and the hardware does not hold up well to modern consumer standards).
  
 
==== Will there be a newer revision after the Community Editions? ====
 
==== Will there be a newer revision after the Community Editions? ====
Starting with the Ubports Community Edition the PinePhone has gotten CE and FCC certifications, repeating the certification process due to changes in the hardware design is very expensive, so the Community Edition(s) are viewed as the final revision besides critical fixes. The PinePhone (and parts for them) will be produced and sold for at least 5 years.  
+
Starting with the UBports Community Edition the PinePhone has gotten CE and FCC certifications, repeating the certification process due to changes in the hardware design is very expensive, so the 1.2b motherboard is viewed as the final revision. The PinePhone (and parts for them) will be produced and sold for at least 5 years.
  
There are ideas for a newer PinePhone with updated hardware, no further details were announced however.
+
==== Will there be hardware differences between the Community Editions? ====
  
==== Will there be hardware differences between the Community Editions? ====
+
Besides the varied back covers, starting with the launch of the PostmarketOS CE there has been the release of a convergence package option for the PinePhone which includes more ram and storage, and an included dock for convenience. There has also been minor hardware changes with the UBports CE (mainboard 1.2) and the Manjaro CE (mainboard revision 1.2b).
  
Besides the varied back covers, starting with the launch of the PostmarketOS CE there has been the release of a convergence package option for the PinePhone which includes more ram and storage, and a included dock for convenience. There has also been multiple hardware changes starting with the Ubports CE (mainboard 1.2) and ending with the Manjaro CE (mainboard 1.2b). There is currently no plans for future hardware changes for a few years.
+
=== General ===
  
 
==== How powerful is the PinePhone's hardware? ====
 
==== How powerful is the PinePhone's hardware? ====
  
The PinePhone is about on par with a Raspberry Pi 3 in terms of CPU power, however going by GFLOPS it has half the GPU power. The Pi 3's Videocore IV does 24 GFLOPS, and the Mali 400 MP2 on the PinePhone only 10.8.
+
The PinePhone is about on par with a Raspberry Pi 3 in terms of CPU performance, however it's Mali 400 MP2 is much weaker than the Pi 3's VideoCore IV. The Mali 400 was the first mobile OpenGL ES 2.0 GPU on the market back in 2008 when it was released, compared to the much newer Videocore IV released in 2010. The PinePhone has been shown to handle smooth H.264 1440p30 video playback using Cedrus and gstreamer as documented [https://xnux.eu/log/#001 here]. The device should be more than capable of a smooth phone experience when used in conjunction with well optimized software that makes use of its hardware features. It is also capable of running many light games (including 3D ones such as SuperTuxKart), and retro gaming. Expect further speed improvements over time as the drivers are improved, and in the meanwhile you can look into slightly [[overclocking]] the device (at your own risk).
 
 
Despite this, using software rendering the PinePhone is capable of smoothly rendering at 1080p resolution or higher. However, with a fully GPU-accelerated mobile environment you should expect a more sluggish experience outputting to such resolutions. Unfortunately the Mali 400 MP2 (a 2008 arm mobile GPU) simply isn't intended to push 1080p resolution. With that said, the VPU of the PinePhone has been shown to handle smooth H.264 1440p30 video playback using Cedrus and gstreamer as documented [https://xnux.eu/log/#001 here]. Further, the PinePhone should be more than capable of a smooth phone experience when used in conjunction with well optimized software that makes use of its hardware features. It is also more than capable of running many light games (including 3D ones such as Supertuxkart), and retro gaming. Expect further speed improvements over time as the drivers are improved, and in the meanwhile you can look into slightly [[overclocking]] the device (at your own risk).
 
  
 
=== Sound ===
 
=== Sound ===
  
 
The default ringtone for Mobian Phosh can be found at /usr/share/sounds/freedesktop/stereo/phone-incoming-call.oga
 
The default ringtone for Mobian Phosh can be found at /usr/share/sounds/freedesktop/stereo/phone-incoming-call.oga
 +
 +
=== Bluetooth ===
 +
For some reason, using pipewire-pulse with bluetooth headphones (In my case, Sony WH1000X-M3) using the default LDAC codec causes the headphones to constantly connect and disconnect until they eventually give up pairing. A work around I've found is to quickly go into Sound settings and switch the codec to "SBC".
  
 
=== Modem ===
 
=== Modem ===
Line 43: Line 44:
 
==== The modem isn't working ====
 
==== The modem isn't working ====
  
In order to use the modem and WiFi/Bluetooth, you need to ensure the battery is inside the device and has a sufficient charge. Even when supplying the phone with enough power, the modem and WiFi chip will not work without a connected battery. Further, double check that you have no put the SD card into the sim card slot, or vice versa.
+
In order to use the modem and Wi-Fi/Bluetooth, you need to ensure the battery is inside the device and has a sufficient charge. Even when supplying the phone with enough power, the modem and Wi-Fi chip will not work without a connected battery. Further, double check that you have not put the SD card into the sim card slot, or vice versa.
  
==== Does the PinePhone only wakeup from sleep for calls and texts? ====
+
==== Does the PinePhone only wake up from sleep for calls and texts? ====
  
Yes. Unless the PinePhone is configured to wakeup every few minutes from deep sleep in crust (At the cost of battery life. However, in the future there may be other solutions), then there is not any way to get any notifications for applications. The modem on the PinePhone will wake the device for incoming calls and texts however, and the real time clock is also capable of waking the device for alarms.
+
Yes. Unless the PinePhone is configured to wake up every few minutes from deep sleep in Crust (At the cost of battery life. However, in the future there may be other solutions), then there is not any way to get any notifications for applications. The modem on the PinePhone will wake the device for incoming calls and texts however, and the real-time clock is also capable of waking the device for alarms.
  
 
=== Battery ===
 
=== Battery ===
Line 55: Line 56:
 
The battery can be stuck in the phone if the screws of the frame are overtightened.
 
The battery can be stuck in the phone if the screws of the frame are overtightened.
  
If your battery is stuck inside the PinePhone, grab a screw driver and completely unscrew all the screws of the midframe. Then pull out the battery (you may have to fully take off the midframe in some cases to get it out). And then rescrew the midframe, but only tighten the screws to the point where they are just barely tight to hold. This should allow you to remove the battery easily.
+
If your battery is stuck inside the PinePhone, grab a screwdriver and completely unscrew all the screws of the midframe. Then pull out the battery (you may have to fully take off the midframe in some cases to get it out). And then rescrew the midframe, but only tighten the screws to the point where they are just barely tight to hold. This should allow you to remove the battery easily.
  
 
==== The battery is discharging while the phone is powered off (Braveheart Edition) ====
 
==== The battery is discharging while the phone is powered off (Braveheart Edition) ====
  
The issue is not present on the Community Edition. Due to a hardware bug, after poweroff, the phone still consumes 20–30mA which drains the battery in 3-4 days. A manual procedure to fix the hardware bug is described [https://xnux.eu/devices/pp-pmic-fix.jpg here].
+
The issue is not present on the Community Edition. Due to a hardware bug, after power off, the phone still consumes 20–30mA which drains the battery in 3-4 days. A manual procedure to fix the hardware bug is described [https://xnux.eu/devices/pp-pmic-fix.jpg here].
 +
 
 +
==== The battery only charges to ~84% ====
 +
 
 +
Some pre-made OSes using megi's kernel limit the maximum amount of charge to roughly ~84% in the hope of prolonging the battery life, as repeatedly reaching the upper level of battery charge reduces the battery's lifetime (this is <b>not</b> a safety feature!). The same effect however also applies when repeatedly draining the battery to a low level - users are therefore advised to consider if that setting is reasonable depending on their usage. The setting can be overwritten via Sysfs, to let the battery fully charge (this can lower the replaceable's battery lifetime considerably depending on the charging behavior!):
 +
 
 +
{{warning|The following instructions are directed towards expert-level users and developers!}}
 +
 
 +
<code>echo 4350000 > /sys/class/power_supply/axp20x-battery/voltage_max_design</code>
  
 
=== Kill Switches ===
 
=== Kill Switches ===
Line 74: Line 83:
 
| Modem
 
| Modem
 
| Pulls Q1501 gate up (FET killing modem power)
 
| Pulls Q1501 gate up (FET killing modem power)
| "On" enables 2G/3G/4G communication and GNSS hardware, "off" disables it.
+
| "On" enables cellular communication and GNSS hardware, "off" disables it.
 
|-
 
|-
 
| 2
 
| 2
| WiFi / Bluetooth
+
| Wi-Fi / Bluetooth
 
| Pulls up CHIP_EN
 
| Pulls up CHIP_EN
| "On" enables WiFi and Bluetooth communication hardware, "off" disables it.
+
| "On" enables Wi-Fi and Bluetooth communication hardware, "off" disables it.
 
|-
 
|-
 
| 3
 
| 3
Line 101: Line 110:
 
| "On" enables audio input and output via the 3.5mm audio jack, "off" switches the jack to hardware UART mode.
 
| "On" enables audio input and output via the 3.5mm audio jack, "off" switches the jack to hardware UART mode.
 
|}
 
|}
 
  
 
=== Memory ===
 
=== Memory ===
Line 112: Line 120:
 
==== GPS doesn't work ====
 
==== GPS doesn't work ====
  
Like almost all smartphones, the PinePhone GPS antenna is small and can only get a first fix unassisted if the GPS signal is very strong. To make first fix faster and more reliable, phones download assistance data either from the phone network or from the internet. The GPS in the PinePhone modem supports the internet based assistance method, as detailed in the modem documentation, but this isn't yet supported out of the box by any of the distros. There is a [https://gist.github.com/alastair-dm/263209b54d01209be28828e555fa6628 proof of concept script] to show that it can work.
+
Like almost all smartphones, the PinePhone GPS antenna is small and can only get a first fix unassisted if the GPS signal is very strong. To make first fix faster and more reliable, phones download assistance data either from the phone network or from the internet. The GPS in the PinePhone modem supports the internet based assistance method, as detailed in the modem documentation, but this is currently only supported by a few distributions, and a [https://gist.github.com/alastair-dm/263209b54d01209be28828e555fa6628 proof of concept script] that shows it can work.
 +
 
 +
Until aGPS support becomes standard you'll have to make some manual changes - see for example [https://wiki.mobian-project.org/doku.php?id=location Mobian wiki]
 +
 
 +
==== GPS can't determine direction ====
  
Until AGPS support makes its way into the distros you'll have to make some manual changes - see for example [https://wiki.mobian-project.org/doku.php?id=location Mobian wiki]
+
Currently, due to the magnetometer not being hooked up in software at this time, it is not possible for GPS software to use the phone's compass functionality. This means while you are walking it will not be possible to determine the direction of travel. This is not as much of an issue for vehicles as the faster speeds mean that it is possible to estimate the direction of travel, however it will still be an issue should the vehicle travel through a tunnel and loose GPS signal.
  
 
== Software ==
 
== Software ==
Line 136: Line 148:
 
==== How can I select different OSes at boot? ====
 
==== How can I select different OSes at boot? ====
  
There is a project by Danct12 which allows the user to select different OSes at boot, the software is currently work-in-progress: https://github.com/dreemurrs-embedded/Pineloader.
+
There was a project by Danct12 which allowed the user to select different OSes at boot, but the repository has since been archived: https://github.com/dreemurrs-embedded/Pineloader.
  
 
==== I turned on my Manjaro CE PinePhone. The red LED and screen backlight are briefly lit, then both are not and it will not boot. ====
 
==== I turned on my Manjaro CE PinePhone. The red LED and screen backlight are briefly lit, then both are not and it will not boot. ====
Line 147: Line 159:
 
If there is an installation of Manjaro on both the eMMC & an SD card, the SD card will always boot first on the device. Try taking the SD card out and booting the installation that is on the eMMC. If the problem persists, it is likely there is an issue with both installations and you will need to reinstall your distribution. You may also want to check with your distribution's maintainers if boot issues are a common problem in a recent update.
 
If there is an installation of Manjaro on both the eMMC & an SD card, the SD card will always boot first on the device. Try taking the SD card out and booting the installation that is on the eMMC. If the problem persists, it is likely there is an issue with both installations and you will need to reinstall your distribution. You may also want to check with your distribution's maintainers if boot issues are a common problem in a recent update.
  
====  I did not install an update in Ubuntu Touch and I'm stuck on the Pine64 logo after rebooting. ====
+
====  I did not install an update in Ubuntu Touch and I'm stuck on the PINE64 logo after rebooting. ====
  
 
# Use a USB A-C cable to plug your phone into your PC
 
# Use a USB A-C cable to plug your phone into your PC
Line 161: Line 173:
 
Your PinePhone should reboot into Ubuntu Touch. Now head to Settings -> Updates and install the new update!  
 
Your PinePhone should reboot into Ubuntu Touch. Now head to Settings -> Updates and install the new update!  
  
If these steps did not solve your issue, please create a new thread here on the Pine64 forums, note what the problem looks like, then say that you've tried these steps already.
+
If these steps did not solve your issue, please create a new thread here on the PINE64 forums, note what the problem looks like, then say that you've tried these steps already.
  
This is caused by corruption on the userdata partition. Normally this should be fixed by 'e2fsck' in the initramfs, however an error in image creation means that that version of e2fsck is unable to correct corruption. This has been fixed in all new PinePhone updates, so if you update from the factory image to any other image available to the PinePhone now, you will not experience this issue any longer.
+
This is caused by corruption on the userdata partition. Normally this should be fixed by 'e2fsck' in the initramfs, however, an error in image creation means that that version of e2fsck is unable to correct the corruption. This has been fixed in all new PinePhone updates, so if you update from the factory image to any other image available to the PinePhone now, you will not experience this issue any longer.
  
 
==== I turned on my PinePhone running Ubuntu Touch. The red LED is lit and it will not boot. ====
 
==== I turned on my PinePhone running Ubuntu Touch. The red LED is lit and it will not boot. ====
Line 175: Line 187:
 
==== Can I install a different OS on my Community Edition? ====
 
==== Can I install a different OS on my Community Edition? ====
  
Yes! While all of the Community Edition Pinephones come with an OS preinstalled, you are free to use any OS on the integrated storage (the eMMC) or an SD card, see [[PinePhone Installation Instructions]] and [[PinePhone Software Releases]] on how to install them.
+
Yes! While all the Community Edition PinePhones come with an OS preinstalled, you are free to use any OS on the integrated storage (the eMMC) or an SD card, see [[PinePhone Installation Instructions]] and [[PinePhone Software Releases]] on how to install them.
  
 
=== Other ===
 
=== Other ===
Line 183: Line 195:
 
In Ubuntu Touch you can run "sudo start ssh" to get a one-time start, or edit /etc/init/ssh.override and remove the manual line to make it auto-start.
 
In Ubuntu Touch you can run "sudo start ssh" to get a one-time start, or edit /etc/init/ssh.override and remove the manual line to make it auto-start.
  
In other distributions you may have to install ssh through its package manager and then proceed to use its init system to enable it. For Manjaro, Arch, and Mobian you can use "systemctl enable" and "systemctl start" command to enable and start ssh.
+
In other distributions you may have to install SSH through its package manager and then proceed to use its init system to enable it. For Manjaro, Arch, and Mobian you can use "systemctl enable" and "systemctl start" command to enable and start ssh.
  
 
==== What works, what doesn't? ====
 
==== What works, what doesn't? ====
Line 195: Line 207:
 
Reboot your device by holding the power button until the "Power" dialog appears, then pressing "Restart".
 
Reboot your device by holding the power button until the "Power" dialog appears, then pressing "Restart".
  
If that does not fix the issue, note that all the following conditions must be met to use WiFi on the PinePhone:
+
If that does not fix the issue, note that all the following conditions must be met to use Wi-Fi on the PinePhone:
  
 
# The plastic tab between the battery and the device's battery contacts has been removed
 
# The plastic tab between the battery and the device's battery contacts has been removed
 
# The battery is installed
 
# The battery is installed
# The WiFi killswitch, #2, on the rear of the device is switched "ON"
+
# The Wi-Fi killswitch, #2, on the rear of the device is switched "ON"
  
 
Wi-Fi in the PinePhone only seems stable after a warm reboot like this.
 
Wi-Fi in the PinePhone only seems stable after a warm reboot like this.
Line 211: Line 223:
 
Android has multiple techniques in place to speed up launching applications after the first launch, such as the "Dalvik cache".
 
Android has multiple techniques in place to speed up launching applications after the first launch, such as the "Dalvik cache".
  
Using a alternative filesystem such as F2FS on the eMMC (which is considerably faster than running software on the SD card) may help improve performance slightly. Over time you can expect further optimizations and improvements in various distributions that will help speed up the PinePhone.
+
Using an alternative filesystem such as F2FS on the eMMC (which is considerably faster than running software on the SD card) may help improve performance slightly. Over time you can expect further optimizations and improvements in various distributions that will help speed up the PinePhone.
 +
 
 +
==== How can I turn on the backlight? ====
 +
 
 +
On some devices the default calibration of the backlight is not sufficient and the minimum setting of the brightness of the used OS can be too low, causing the backlight to completely shut down. In that case it is recommended to connect the phone to a charger and/or to shine a flashlight at the screen to adjust the brightness to a higher setting again.
 +
 
 +
On many Linux OSes the brightness setting is an integer between 0 and 1000 and available at runtime in /sys/class/backlight/backlight/brightness and stored at shutdown and loaded at boot from /var/lib/systemd/backlight/platform-backlight:backlight:backlight by systemd-backlight@backlight:backlight.service. Changing the brightness setting can be done at runtime, for example over SSH, by executing as root <code>echo 500 > /sys/class/backlight/backlight/brightness</code>. The stored brightness setting can be modified using another system, by mounting the root filesystem of the system you want to fix and by executing <code>echo 500 > [MOUNT LOCATION]/var/lib/systemd/backlight/platform-backlight\:backlight\:backlight</code>.
 +
 
 +
==== How can I contribute regarding the WiFi and Bluetooth firmware? ====
 +
 
 +
The PinePhone uses [https://files.pine64.org/doc/datasheet/pine64/RTL8723BS.pdf Realtek RTL8723CS] for its WiFi and Bluetooth connectivity. Unfortunately, just like the other Realteks ''([https://en.wikipedia.org/wiki/Comparison_of_open-source_wireless_drivers see more info])'' - this RTL8723CS chip requires a proprietary closed-source binary blob firmware. For those who have the capability to reverse-engineer the Realtek firmware of this chip to create the opensource replacement, resources like [https://libreplanet.org/wiki/Group:Hardware/research/e-readers/Kobo/Aura_H2O_Edition_2#Firmwares this] and [https://8051enthusiast.github.io/2021/07/05/002-wifi_fun.html this] could be a great starting point for your further research.
  
 
=== SMS ===
 
=== SMS ===
Line 219: Line 241:
 
Sometimes incoming SMS messages are not being received, but outgoing ones, phone calls and data are working fine. One potential cause could be SMS messages that linger in the modem's queue (10 or more of them). This queue appears to be persistent across reboots and also re-imaging the OS.
 
Sometimes incoming SMS messages are not being received, but outgoing ones, phone calls and data are working fine. One potential cause could be SMS messages that linger in the modem's queue (10 or more of them). This queue appears to be persistent across reboots and also re-imaging the OS.
  
On Mobian and Manjaro, the ModemManager does all of the communications with the 3G modem including phone calls, cellular data, GPS and SMS. This may not be the case with other PinePhone OSes.
+
On Mobian and Manjaro, the ModemManager does all the communications with the 3G modem including phone calls, cellular data, GPS and SMS. This may not be the case with other PinePhone OSes.
  
 
You can access the ModemManager using the mmcli command.
 
You can access the ModemManager using the mmcli command.
Line 234: Line 256:
 
/org/freedesktop/ModemManager1/SMS/77 (received)</pre>
 
/org/freedesktop/ModemManager1/SMS/77 (received)</pre>
  
For Mobian, delete all of the messages like this:
+
For Mobian, delete all the messages like this:
  
<code>$ sudo mmcli -m 0 --messaging-delete-sms=1</code> (Repeat with 1 through 10 to delete all of the messages)
+
<code>$ sudo mmcli -m 0 --messaging-delete-sms=1</code> (Repeat with 1 through 10 to delete all the messages)
  
For Manjaro, delete all of the messages like this:
+
For Manjaro, delete all the messages like this:
  
 
<code>$ sudo mmcli -m 3 --messaging-delete-sms=77</code> (Repeat with all listed messages)
 
<code>$ sudo mmcli -m 3 --messaging-delete-sms=77</code> (Repeat with all listed messages)
Line 248: Line 270:
 
== Shipping ==
 
== Shipping ==
 
=== I did not receive an order confirmation ===
 
=== I did not receive an order confirmation ===
Check your "spam" folder. It was reported that some users did not receive an order confirmation. You will also still get a shipping notification when the device ships out, even if you didn't get a order confirmation email.
+
Check your "spam" folder. It was reported that some users did not receive an order confirmation. You will also still get a shipping notification when the device ships out, even if you didn't get an order confirmation email.
  
 
=== When does the phone ship? ===
 
=== When does the phone ship? ===
For up-to-date information when the phone's shipping date is estimated, see the edits in this forum post: https://forum.pine64.org/showthread.php?tid=9942.
+
For up-to-date information when the phone's shipping date is estimated, see the edits in the corresponding forum thread.
  
 
=== It is shipping day but I did not receive a shipping notification ===
 
=== It is shipping day but I did not receive a shipping notification ===
Line 260: Line 282:
  
 
=== What about import taxes? ===
 
=== What about import taxes? ===
Import taxes have to be payed by the buyer depending on the jurisdiction of the country of the buyer. Please check with your local laws if there are import taxes to pay and if so how to do the tax filing.
+
Import taxes have to be paid by the buyer depending on the jurisdiction of the country of the buyer. Please check with your local laws if there are import taxes to pay and if so how to do the tax filing.
  
 
== Accessories ==
 
== Accessories ==
  
 
=== Protection ===
 
=== Protection ===
==== Which screen protector should i use? ====
+
==== Which screen protector should I use? ====
  
 
Protecting your screen is important, especially for devices like the PinePhone that doesn't have access to the newest glass technology.
 
Protecting your screen is important, especially for devices like the PinePhone that doesn't have access to the newest glass technology.
The Braveheart and Community Editions of the PinePhone comes with a plastic film screen protector installed, and Pine64 sells a tempered glass screen protector [https://pine64.com/product/pinephone-tempered-glass-screen-protector/ in their store].
+
The Braveheart and Community Editions of the PinePhone comes with a plastic film screen protector installed, and PINE64 sells a tempered glass screen protector [https://pine64.com/product/pinephone-tempered-glass-screen-protector/ in their store].
  
You can also buy a third party screen protector, as the screen protectors for the iPhone 11 Pro Max/XS Max fit the PinePhone pretty well based on [https://forum.pine64.org/showthread.php?tid=8458&pid=65409#pid65409 this] forum post.
+
You can also buy a third-party screen protector, as the screen protectors for the iPhone 11 Pro Max/XS Max fit the PinePhone pretty well based on [https://forum.pine64.org/showthread.php?tid=8458&pid=65409#pid65409 this] forum post.
  
 
=== Batteries ===
 
=== Batteries ===
Line 281: Line 303:
 
=== External hardware ===
 
=== External hardware ===
  
==== Will Pine64 sell other addons made for the PinePhone? ====
+
==== Will PINE64 sell other add-ons made for the PinePhone? ====
  
Yes, currently there is a keyboard case [https://forum.pine64.org/showthread.php?tid=8537&pid=55396#pid55396 with similarities to the Psion 5] which includes an internal battery, and a [https://www.pine64.org/2020/05/15/may-update-pinetab-pre-orders-pinephone-qi-charging-more/ Qi wireless charging] add-on planned, both of which Pine64 intends to directly sell. There is the potential for future add-ons such as a game pad, however that is currently just an idea and not in any way planned.
+
Yes, currently there is a keyboard case [https://forum.pine64.org/showthread.php?tid=8537&pid=55396#pid55396 with similarities to the Psion 5] which includes an internal battery, and a [https://www.pine64.org/2020/05/15/may-update-pinetab-pre-orders-pinephone-qi-charging-more/ Qi wireless charging] add-on planned, both of which PINE64 intends to directly sell. There is the potential for future add-ons such as a game pad, however that is currently just an idea and not in any way planned.
  
 
==== Which 3rd party hardware can connect to my PinePhone? ====
 
==== Which 3rd party hardware can connect to my PinePhone? ====

Latest revision as of 12:16, 25 August 2021

A list of frequently asked question.

Contents

Hardware

Revisions

What are Community Editions?

Community Editions of the PinePhone were versions of the PinePhone which came preinstalled with the operating system of a partner project and featured the logo of the project on the back panel. The Community Edition was intended to help partner projects developing these systems: "Community editions are meant to bring exposure to partner-projects operating systems and communities, as well as help finance ongoing development.", source.

Is the Community Edition hardware the latest revision?

The Community Edition program (featuring the mainboard numbers 1.2 through 1.2b and branded back covers) which provided the branded PinePhones has since ended, and a Beta Edition has since been released. The only difference between each Community Edition is the inclusion of crucial bug fixes, with the last issue being fixed with the 1.2b motherboard shipping with the Manjaro CE PinePhones. The 1.2b motherboard is also currently used in the Beta Edition PinePhones, however the Beta Edition units do not ship with any back cover branding. There are currently no plans for further hardware revisions.

Aside from the back cover, the only other difference between each Community Edition is that starting with the postmarketOS PinePhone, a convergence package option was released that adds another gigabyte of ram to the phone and a 32GB eMMC instead of a 16GB eMMC. Convergence packages also included a dock for plugging in USB peripherals and connecting to an HDMI monitor, however you can purchase a generic USB-C dock to use with a 2GB PinePhone.

The predecessor to the Convergence Edition PinePhones was the Braveheart Edition intended for developers to bring up the platform, which had the version number 1.1. For more details about the topic see PinePhone#Hardware Revisions.

Will there be other Community Editions?

Five Community Editions have been announced: UBports, postmarketOS, Manjaro, KDE, and Mobian. Since the release of the Mobian edition, the Beta Edition PinePhones have been released and the Community Edition Program has ended.

In simple terms, what are the differences between Braveheart and the new Community Edition?

The Braveheart PinePhone was the first public revision of the PinePhone which was intended solely for developers and Linux enthusiasts. The UBports Community Edition was the next revision of the PinePhone with an updated mainboard based on feedback from the Braveheart Edition, see PinePhone#Hardware Revisions. All current revisions of the PinePhone continue to be intended for developers and enthusiasts, however, PINE64 will be starting to offer partnered retail units of the PinePhone which will have a better warranty and technical support (keep in mind even then it is not intended for a broader audience at this time, as the software still needs work and the hardware does not hold up well to modern consumer standards).

Will there be a newer revision after the Community Editions?

Starting with the UBports Community Edition the PinePhone has gotten CE and FCC certifications, repeating the certification process due to changes in the hardware design is very expensive, so the 1.2b motherboard is viewed as the final revision. The PinePhone (and parts for them) will be produced and sold for at least 5 years.

Will there be hardware differences between the Community Editions?

Besides the varied back covers, starting with the launch of the PostmarketOS CE there has been the release of a convergence package option for the PinePhone which includes more ram and storage, and an included dock for convenience. There has also been minor hardware changes with the UBports CE (mainboard 1.2) and the Manjaro CE (mainboard revision 1.2b).

General

How powerful is the PinePhone's hardware?

The PinePhone is about on par with a Raspberry Pi 3 in terms of CPU performance, however it's Mali 400 MP2 is much weaker than the Pi 3's VideoCore IV. The Mali 400 was the first mobile OpenGL ES 2.0 GPU on the market back in 2008 when it was released, compared to the much newer Videocore IV released in 2010. The PinePhone has been shown to handle smooth H.264 1440p30 video playback using Cedrus and gstreamer as documented here. The device should be more than capable of a smooth phone experience when used in conjunction with well optimized software that makes use of its hardware features. It is also capable of running many light games (including 3D ones such as SuperTuxKart), and retro gaming. Expect further speed improvements over time as the drivers are improved, and in the meanwhile you can look into slightly overclocking the device (at your own risk).

Sound

The default ringtone for Mobian Phosh can be found at /usr/share/sounds/freedesktop/stereo/phone-incoming-call.oga

Bluetooth

For some reason, using pipewire-pulse with bluetooth headphones (In my case, Sony WH1000X-M3) using the default LDAC codec causes the headphones to constantly connect and disconnect until they eventually give up pairing. A work around I've found is to quickly go into Sound settings and switch the codec to "SBC".

Modem

The modem isn't working

In order to use the modem and Wi-Fi/Bluetooth, you need to ensure the battery is inside the device and has a sufficient charge. Even when supplying the phone with enough power, the modem and Wi-Fi chip will not work without a connected battery. Further, double check that you have not put the SD card into the sim card slot, or vice versa.

Does the PinePhone only wake up from sleep for calls and texts?

Yes. Unless the PinePhone is configured to wake up every few minutes from deep sleep in Crust (At the cost of battery life. However, in the future there may be other solutions), then there is not any way to get any notifications for applications. The modem on the PinePhone will wake the device for incoming calls and texts however, and the real-time clock is also capable of waking the device for alarms.

Battery

The battery is stuck inside the phone

The battery can be stuck in the phone if the screws of the frame are overtightened.

If your battery is stuck inside the PinePhone, grab a screwdriver and completely unscrew all the screws of the midframe. Then pull out the battery (you may have to fully take off the midframe in some cases to get it out). And then rescrew the midframe, but only tighten the screws to the point where they are just barely tight to hold. This should allow you to remove the battery easily.

The battery is discharging while the phone is powered off (Braveheart Edition)

The issue is not present on the Community Edition. Due to a hardware bug, after power off, the phone still consumes 20–30mA which drains the battery in 3-4 days. A manual procedure to fix the hardware bug is described here.

The battery only charges to ~84%

Some pre-made OSes using megi's kernel limit the maximum amount of charge to roughly ~84% in the hope of prolonging the battery life, as repeatedly reaching the upper level of battery charge reduces the battery's lifetime (this is not a safety feature!). The same effect however also applies when repeatedly draining the battery to a low level - users are therefore advised to consider if that setting is reasonable depending on their usage. The setting can be overwritten via Sysfs, to let the battery fully charge (this can lower the replaceable's battery lifetime considerably depending on the charging behavior!):

Warning: The following instructions are directed towards expert-level users and developers!

echo 4350000 > /sys/class/power_supply/axp20x-battery/voltage_max_design

Kill Switches

What are the kill switches doing?

Number Name Explanation Description
1 Modem Pulls Q1501 gate up (FET killing modem power) "On" enables cellular communication and GNSS hardware, "off" disables it.
2 Wi-Fi / Bluetooth Pulls up CHIP_EN "On" enables Wi-Fi and Bluetooth communication hardware, "off" disables it.
3 Microphone Breaks microphone bias voltage from the SoC "On" enables audio input from on-board microphones (not 3.5mm jack), "off" disables it.
4 Rear camera Pulls up PWDN on OV5640 "On" enables the rear camera, "off" disables it.
5 Front camera Pulls up PWDN on GC2145 "On" enables the front camera, "off" disables it.
6 Headphone Pulls up IN2 on analog switch BCT4717ETB "On" enables audio input and output via the 3.5mm audio jack, "off" switches the jack to hardware UART mode.

Memory

What's the speed difference between the eMMC and SD cards?

Maximum transfer speed of the eMMC is around 85 MB/s, while SD cards are limited to approximately 23 MB/s (even with faster cards).

GPS

GPS doesn't work

Like almost all smartphones, the PinePhone GPS antenna is small and can only get a first fix unassisted if the GPS signal is very strong. To make first fix faster and more reliable, phones download assistance data either from the phone network or from the internet. The GPS in the PinePhone modem supports the internet based assistance method, as detailed in the modem documentation, but this is currently only supported by a few distributions, and a proof of concept script that shows it can work.

Until aGPS support becomes standard you'll have to make some manual changes - see for example Mobian wiki

GPS can't determine direction

Currently, due to the magnetometer not being hooked up in software at this time, it is not possible for GPS software to use the phone's compass functionality. This means while you are walking it will not be possible to determine the direction of travel. This is not as much of an issue for vehicles as the faster speeds mean that it is possible to estimate the direction of travel, however it will still be an issue should the vehicle travel through a tunnel and loose GPS signal.

Software

Installation

How can I install an operating system on the SD card / eMMC?

See PinePhone Installation Instructions.

Updating

Read the PinePhone Updating Instructions.

Booting

What's the boot order for SD cards and eMMC?

The PinePhone will automatically boot from microSD if a bootable card is inserted. If no (bootable) microSD is found, it will boot from eMMC.

How can I select different OSes at boot?

There was a project by Danct12 which allowed the user to select different OSes at boot, but the repository has since been archived: https://github.com/dreemurrs-embedded/Pineloader.

I turned on my Manjaro CE PinePhone. The red LED and screen backlight are briefly lit, then both are not and it will not boot.

This can be the result of at least one situation:

  1. The eMMC installation became corrupt or otherwise unbootable
  2. An SD card is present but not bootable (consider PinePhone#Detailed usage instructions)

If there is an installation of Manjaro on both the eMMC & an SD card, the SD card will always boot first on the device. Try taking the SD card out and booting the installation that is on the eMMC. If the problem persists, it is likely there is an issue with both installations and you will need to reinstall your distribution. You may also want to check with your distribution's maintainers if boot issues are a common problem in a recent update.

I did not install an update in Ubuntu Touch and I'm stuck on the PINE64 logo after rebooting.

  1. Use a USB A-C cable to plug your phone into your PC
  2. Hold the PinePhone's power button for 4 seconds or more to power it off.
  3. Wait 5 seconds
  4. Hold the Volume Up and Power buttons on the PinePhone to boot into recovery. You should see the LED light red, then yellow, then green. The "Installing update" screen will appear, but a progress bar to indicate update progress will not. Ignore the "Installing update" part.
  5. Your PC may automatically mount the PinePhone's partitions. If it does, Safely Remove or Eject all of them.
  6. Open a terminal on your PC. Type telnet 172.16.42.1
  7. You should receive the text 'Welcome to Rescue SD Shell!'
  8. In the new Rescue SD shell, type umount /dev/mmcblk2p10; e2fsck -fy /dev/mmcblk2p10 && sync
  9. Once this command pipeline finishes, type sync && reboot -f

Your PinePhone should reboot into Ubuntu Touch. Now head to Settings -> Updates and install the new update!

If these steps did not solve your issue, please create a new thread here on the PINE64 forums, note what the problem looks like, then say that you've tried these steps already.

This is caused by corruption on the userdata partition. Normally this should be fixed by 'e2fsck' in the initramfs, however, an error in image creation means that that version of e2fsck is unable to correct the corruption. This has been fixed in all new PinePhone updates, so if you update from the factory image to any other image available to the PinePhone now, you will not experience this issue any longer.

I turned on my PinePhone running Ubuntu Touch. The red LED is lit and it will not boot.

  1. Hold the power button until the light turns off
  2. Hold the power button until the light turns on

You may need to repeat these steps more than once.

This is caused by u-boot apparently trying to use the eMMC before it is ready. We are not entirely sure why this occurs yet.

Can I install a different OS on my Community Edition?

Yes! While all the Community Edition PinePhones come with an OS preinstalled, you are free to use any OS on the integrated storage (the eMMC) or an SD card, see PinePhone Installation Instructions and PinePhone Software Releases on how to install them.

Other

How can I enable SSH?

In Ubuntu Touch you can run "sudo start ssh" to get a one-time start, or edit /etc/init/ssh.override and remove the manual line to make it auto-start.

In other distributions you may have to install SSH through its package manager and then proceed to use its init system to enable it. For Manjaro, Arch, and Mobian you can use "systemctl enable" and "systemctl start" command to enable and start ssh.

What works, what doesn't?

For Ubuntu Touch see https://gitlab.com/ubports/community-ports/pinephone#what-works-what-doesnt.

Other distributions will have different levels of functionality. Please refer to the release page of your chosen distribution for further information.

I can't connect to a 2.4Ghz Wi-Fi network in Ubuntu Touch.

Reboot your device by holding the power button until the "Power" dialog appears, then pressing "Restart".

If that does not fix the issue, note that all the following conditions must be met to use Wi-Fi on the PinePhone:

  1. The plastic tab between the battery and the device's battery contacts has been removed
  2. The battery is installed
  3. The Wi-Fi killswitch, #2, on the rear of the device is switched "ON"

Wi-Fi in the PinePhone only seems stable after a warm reboot like this.

What's the status of Android for the PinePhone?

Currently, there isn't any major push to get Android running well on the PinePhone. The developer Icenowy did get a Android image to run and partly work, it was however slow and buggy, with major functions not working. A solution for running some of your android apps may be found in Anbox as of now. Anbox is currently not included in Ubuntu Touch. In other distributions your millage may vary on what applications will run and how well.

Why are my apps loading slower than on my Android phone?

Android has multiple techniques in place to speed up launching applications after the first launch, such as the "Dalvik cache".

Using an alternative filesystem such as F2FS on the eMMC (which is considerably faster than running software on the SD card) may help improve performance slightly. Over time you can expect further optimizations and improvements in various distributions that will help speed up the PinePhone.

How can I turn on the backlight?

On some devices the default calibration of the backlight is not sufficient and the minimum setting of the brightness of the used OS can be too low, causing the backlight to completely shut down. In that case it is recommended to connect the phone to a charger and/or to shine a flashlight at the screen to adjust the brightness to a higher setting again.

On many Linux OSes the brightness setting is an integer between 0 and 1000 and available at runtime in /sys/class/backlight/backlight/brightness and stored at shutdown and loaded at boot from /var/lib/systemd/backlight/platform-backlight:backlight:backlight by systemd-backlight@backlight:backlight.service. Changing the brightness setting can be done at runtime, for example over SSH, by executing as root echo 500 > /sys/class/backlight/backlight/brightness. The stored brightness setting can be modified using another system, by mounting the root filesystem of the system you want to fix and by executing echo 500 > [MOUNT LOCATION]/var/lib/systemd/backlight/platform-backlight\:backlight\:backlight.

How can I contribute regarding the WiFi and Bluetooth firmware?

The PinePhone uses Realtek RTL8723CS for its WiFi and Bluetooth connectivity. Unfortunately, just like the other Realteks (see more info) - this RTL8723CS chip requires a proprietary closed-source binary blob firmware. For those who have the capability to reverse-engineer the Realtek firmware of this chip to create the opensource replacement, resources like this and this could be a great starting point for your further research.

SMS

The phone does not receive SMS

Sometimes incoming SMS messages are not being received, but outgoing ones, phone calls and data are working fine. One potential cause could be SMS messages that linger in the modem's queue (10 or more of them). This queue appears to be persistent across reboots and also re-imaging the OS.

On Mobian and Manjaro, the ModemManager does all the communications with the 3G modem including phone calls, cellular data, GPS and SMS. This may not be the case with other PinePhone OSes.

You can access the ModemManager using the mmcli command.

Mobian:

$ sudo mmcli -m 0 --messaging-list-sms
Found 10 SMS messages:
/org/freedesktop/ModemManager1/SMS/0 (received)

Manjaro:

$ sudo mmcli -m 3 --messaging-list-sms
/org/freedesktop/ModemManager1/SMS/77 (received)

For Mobian, delete all the messages like this:

$ sudo mmcli -m 0 --messaging-delete-sms=1 (Repeat with 1 through 10 to delete all the messages)

For Manjaro, delete all the messages like this:

$ sudo mmcli -m 3 --messaging-delete-sms=77 (Repeat with all listed messages)

Note that the "-m 0" or "-m 3" refers to modem 0 or 3 (the only one in a PinePhone). For more help on the messaging related actions available in mmcli you can check the help with mmcli --help-messaging. This article is also helpful in learning: https://electronproton.com/mmcli-command-examples/. For your particular configuration, you may need to try different "-m #" combinations, e.g., "-m 2" or "-m 4." "-m 0" is not always the default.

It should also be noted that recent releases of Mobian and postmarketOS now include a userspace daemon called eg25-manager, which helps manage the modem and ensure proper operation.

Shipping

I did not receive an order confirmation

Check your "spam" folder. It was reported that some users did not receive an order confirmation. You will also still get a shipping notification when the device ships out, even if you didn't get an order confirmation email.

When does the phone ship?

For up-to-date information when the phone's shipping date is estimated, see the edits in the corresponding forum thread.

It is shipping day but I did not receive a shipping notification

For shipments with DHL the shipping notification is sent out as soon as the packet reached DHL's warehouse and scanned (it can take up to 24 hours after scanning after the shipment is added to DHL's database). For all other shipments (via Ascendia) the notification is sent out sometime after shipment.

When does my phone ship if I order now?

Orders made after Friday, 22nd May 2020 are shipped after the first bulk of pre-orders has been shipped. The exact date is not known yet due to various reasons, it may be a few weeks after the first bulk shipped. The forum will be edited with updated information and you will receive a shipping notification when the device was shipped.

What about import taxes?

Import taxes have to be paid by the buyer depending on the jurisdiction of the country of the buyer. Please check with your local laws if there are import taxes to pay and if so how to do the tax filing.

Accessories

Protection

Which screen protector should I use?

Protecting your screen is important, especially for devices like the PinePhone that doesn't have access to the newest glass technology. The Braveheart and Community Editions of the PinePhone comes with a plastic film screen protector installed, and PINE64 sells a tempered glass screen protector in their store.

You can also buy a third-party screen protector, as the screen protectors for the iPhone 11 Pro Max/XS Max fit the PinePhone pretty well based on this forum post.

Batteries

I want a replacement battery, which one should I buy?

Replacement batteries for US customers are available in the store.

Currently the PinePhone battery is known to be compatible with replacement batteries for the Samsung J700. Specifically, models "EB-BJ700BBC" and "EB-BJ700BBE" are compatible with all PinePhone models, and "EB-BJ700CBE" is compatible with Community Editions after UBPorts (due to plastic tabs on its bottom which only the newer phones have tolerance for).

External hardware

Will PINE64 sell other add-ons made for the PinePhone?

Yes, currently there is a keyboard case with similarities to the Psion 5 which includes an internal battery, and a Qi wireless charging add-on planned, both of which PINE64 intends to directly sell. There is the potential for future add-ons such as a game pad, however that is currently just an idea and not in any way planned.

Which 3rd party hardware can connect to my PinePhone?

See PinePhone Hardware Accessory Compatibility.