HCL:PinePhone

Pinephone 启动到图形用户界面，旁边是一个 Geeko 毛绒玩具

Pinephone 的目的不仅仅是向最终用户提供一个可用的 Linux 手机，还要积极地为这种设备创造市场，并支持现有的、成熟的 Linux-on-Phone 项目。目前仅支持 openSUSE Tumbleweed。

在 PinePhone 上运行的 Plasma Mobile

技术数据

Allwinner A64 四核 SoC，带有 Mali 400 MP2 GPU
2GB/3GB LPDDR3 RAM
5.95″ LCD 1440×720，18:9 纵横比（硬化玻璃）
可引导 Micro SD
16GB/32GB eMMC
USB Type C（电源、数据和 HSMI）
Quectel EG-25G，具有全球频段
WiFi：802.11 b/g/n，单频段，支持热点
蓝牙：4.0，A2DP
GNSS：GPS、GPS-A、GLONASS
振动器
RGB 状态 LED
自拍和主摄像头（分别为 2/5Mpx）
主摄像头：单 OV6540，5MP，1/4″，LED 闪光灯
自拍摄像头：单 GC2035，2MP，f/2.8，1/5″
传感器：加速度计、陀螺仪、接近传感器、指南针、气压计、环境光传感器
3 个外部按钮：上、下和电源
硬件开关：LTE/GNSS、Wi-Fi、麦克风、摄像头和耳机
三星 J7 外形，3000mAh 电池
哑光黑色塑料外壳
3.5mm 耳机插孔

应用

此列表建议可以使用哪些应用程序来实现某些功能。

文件管理器：Nautilus、Portfolio、Maui Index
相机：Megapixels
电话：呼叫 (ModemManager)、Plasma Dialer (ModemManager)
短信：Chatty (ModemManager) 或 Spacebar (ModemManager)
终端模拟器：King's Cross、QMLKonsole
软件：GNOME Software、Discover
网页浏览：GNOME Web (epiphany - WebKitGTK based)、Angelfish (Chromium/QT WebEngine based)、Firefox (with mobile-config-firefox)、Chromium
图库：Maui Pix、Koko
计算器：Kalk（不是 KCalc）
绘图：Pikasso
PDF 查看器：Okular (okular-mobile 子包)
日历：Calindori、DayKountdown
闹钟：KClock
文本编辑器：Maui Nota、Maui Buho
音乐播放器和录音机：Maui Vvave、Elisa、Audacity、KRecorder
视频播放器：Maui Clip、Clapper、Glide Player
信息源阅读器：Alligator
聊天：Neochat (Matrix)、Fractal (Matrix)、Kaidan (Jabber/XMPP)、Chatty (XMPP)、Telegram (MTProto)、Tok (MTProto)、Axolotl (Signal)
地图：GNOME Maps、Pure Maps

有些可以通过 flatpak 安装，以防它们在我们的仓库中不可用。目前我们没有打包任何 CuboCore CoreApps。

推荐的软件安装方式是：Zypper、OBS 包安装程序、GNOME Software、Discover 和 Flatpak。我们有 cnf（无法找到）工具来搜索哪些包提供某些二进制文件，例如 cnf gpspipe；这仅适用于您系统上的仓库。

Flathub 必须启用，因为它默认情况下是禁用的。

flatpak remote-add --if-not-exists flathub https://flathub.org/repo/flathub.flatpakrepo

openSUSE 社区在 Open Build Service 上移植的程序可以使用 opi 安装，例如 opi kweather。我们建议您添加 Packman 仓库，以便您可以安装具有限制许可的软件，例如许多编解码器。

用户可以将包管理器从 zypper 切换到 dnf（如果需要），只需确保将仓库复制到它们所属的位置，即可切换，只需执行以下命令

zypper in dnf PackageKit-backend-dnf

这将提示与包 PackageKit-backend-zypp 发生冲突，继续将替换 PackageKit 后端。

cp -t /etc/dnf/repos.d/ /etc/zypp/repos.d/*

不要链接两个文件夹以防止后续出现问题。转移仓库后，请查看我们的 wiki 以获取更多信息。

在 Pinephone 上安装 openSUSE

截至 2020.12.16 的发布，Jumpdrive 可用于直接刷新 eMMC 存储器。该过程与 sdcard 相同。请参阅 Pine64 wiki 以获取更多信息。事实上，出于性能原因，安装到 eMMC 存储器是首选。

从这里下载您想要的镜像。选择手机环境

Tumbleweed Phosh
GNOME Shell 适配小型设备，由 Purism 开发。

如果您无法使用上面的直接链接（因为我们不断构建新的镜像），请检查通用下载目录以获取镜像。
根据您的意愿，验证下载的镜像。
将镜像刷到您的存储设备（将 sdX 替换为您的存储设备的设备名称）。您可以使用 lsblk 在插入 SD 卡/暴露的 eMMC 之前和之后列出您的驱动器，以便选择正确的驱动器。

存储设备上的所有先前数据都将被丢失。首先检查您选择的设备是否真的是正确的设备！
```
$ xzcat [image].raw.xz | sudo dd bs=4M of=/dev/sdX iflag=fullblock oflag=direct status=progress; sync
```
将带有 openSUSE 镜像的 SD 卡插入您的板子。
打开板子电源。

Phosh：将启动一个欢迎应用程序，引导您完成首次启动步骤。

玩得开心...

默认登录名是 pine，密码是 1234。

root 用户的密码是 linux，您应该使用 sudo passwd root 设置一个不同的密码。

在首次启动期间，屏幕可能会保持黑色大约一分钟。这是完全正常的，只要我们使用 Plymouth，就会发生这种情况。后续启动应该花费更少的时间。

警告： 在 openSUSE Tumbleweed 中，通过终端更新系统的正确方法是使用 zypper dup，而不是 zypper up。

默认文件系统是 Btrfs，并且默认情况下禁用透明压缩，因为它会导致更新缓慢并压缩一些不应压缩的重要文件。

验证镜像

每次构建新镜像时，都会附带匹配的 SHA-256 校验和和 PGP 签名。 PGP 签名验证 SHA-256 校验和。以下是验证我们的镜像的步骤

下载我们的公钥。

curl https://build.opensuse.org/projects/devel:ARM:Factory:Contrib:PinePhone/public_key > public_key

导入下载的密钥。
```
gpg --import public_key
rm public_key
```
下载与您下载的镜像对应的 SHA-256 文件对（例如 Plasma Mobile）。可以在镜像仓库中找到它们。

按照以下示例检查 SHA-256 校验和与附带的签名

gpg --verify openSUSE-Tumbleweed-ARM-PLAMO-pinephone.aarch64-2021.04.16-Build27.11.raw.xz.sha256.asc openSUSE-Tumbleweed-ARM-PLAMO-pinephone.aarch64-2021.04.16-Build27.11.raw.xz.sha256

输出应显示 Good signature（良好签名）。

gpg: Signature made jue 22 abr 2021 00:31:21 CST
gpg:                using RSA key 16C5D54F3F546F34
gpg: Good signature from "devel:ARM OBS Project <[...]@build.opensuse.org>" [unknown]
gpg: WARNING: This key is not certified with a trusted signature!
gpg:          There is no indication that the signature belongs to the owner.
Primary key fingerprint: 1D65 71D6 77CD 36CE F6B9  3856 16C5 D54F 3F54 6F34

最后，验证下载的镜像的 SHA256 校验和。确保 *.sha256 和 *.raw.xz 文件位于同一位置。
```
sha256sum -c openSUSE-Tumbleweed-ARM-PLAMO-pinephone.aarch64-2021.04.16-Build27.11.raw.xz.sha256
```
输出应如下所示
```
openSUSE-Tumbleweed-ARM-PLAMO-pinephone.aarch64-2021.04.16-Build27.11.raw.xz: OK
```
如果是这样，则您已成功验证下载的镜像的完整性。否则，您拥有的镜像已损坏或在传输过程中被篡改。尝试通过更稳定或更安全的网络重新下载它。

当前状态

特性	支持？	附加说明
后置和前置摄像头	是	使用 `megapixels` 应用程序，它包含后处理脚本以增强图像质量。
相机闪光灯	是
WiFi	是	在 Plasma Mobile 中，如果提示输入 KWallet 密码，请记住，如果您设置了密码，每次重启都会要求您输入密码。如果您不想，只需在不输入任何内容的情况下按 Ok。
蓝牙	是
GNSS:GPS	是	A-GPS 功能集成到 eg25-manager 中。
磁力计、环境光传感器、加速度计、陀螺仪	是	通过 iio-sensor-proxy 支持。
振动马达	是
接近传感器	是	在 Phosh 上，当物体靠近传感器时，显示屏会被禁用。在 Plasma Mobile 的情况下，通话期间屏幕当前不会关闭。
通知 LED	是
音量按钮	是
音频	是
移动数据	是
短信	是
呼叫	是
USB OTG	是	在可以访问存储单元之前，可能需要手动挂载它们。在终端会话中运行 `lsblk` 以查看检测到您的设备。
官方扩展坞	是	鼠标、键盘、RJ-45 和 HDMI 正常工作，因为这符合 USB 标准。
无线热点	是	需要安装 `dnsmasq`（现在已包含），并且需要启用 WiFi 连接，否则它将失败，表明设备 wlan0 不可用。
USB 网络共享	否
USB MTP	否
系统加密	否

故障排除和建议

在更新时，您可能会注意到 zypper 会尝试提取许多推荐的软件包。这可以通过以下参数更新来解决

sudo zypper dup --no-recommends

这是因为我们的镜像是在没有推荐软件包的情况下构建的。相反，要安装尚未安装的所有推荐软件包

sudo zypper dup --recommends

通常 lang（翻译）子包作为推荐软件包的一部分安装。这种行为无法通过 PackageKit 控制，但您可以通过在 /etc/zypp/zypp.conf 中注释掉 # solver.onlyRequires = false 并将其更改为 true 来禁用它。

如果某些应用程序无法启动，请尝试执行以下命令

rm -rf ~/.cache

如果内核或 u-boot 有可用更新，请通过 PackageKit（Discover 或 GNOME Software）更新，因为这些更新会在系统重启后安装，这对于系统完整性更安全。
如果您在使用 SIM 卡时遇到问题，请尝试从另一台设备中删除 PIN 码。
对于 YaST，请注意 GUI 不起作用，但您可以使用内置的 Alt、Tab 和箭头按钮（在 QMLKonsole 或 Phosh 的 Squeekboard 中）使用 YaST2 TUI。通过在终端会话中运行 yast2 启动它（请注意，您也可以通过 SSH 使用它）。
如果您在音频播放方面遇到问题，请确保选择了正确的输出设备（内部扬声器）和设备配置文件设置（默认）。网站或容器格式（如 mp4）上的多媒体内容可能无法播放 - 尝试安装必要的编解码器。它们不包含在 openSUSE 发行版中，因为法律原因。
Plasma Mobile 的表情符号支持默认情况下未包含。要添加它
```
sudo zypper install maliit-keyboard2-lang maliit-keyboard2-emoji
```
要轻松地通过终端设置 WiFi 连接，可以使用 nmtui 或 nmcli。有一种困难的方法是使用 wpa_supplicant，这是 JeOS 的情况（确保 wicked 未运行）。

systemctl stop wicked wickedd
wpa_passphrase SSID PASSWORD > /etc/wpa_supplicant/SSID.conf #replace SSID and PASSWORD with your configuration
ip link set wlan0 down; ip link set wlan0 up
wpa_supplicant -B -iwlan0 -c /etc/wpa_supplicant/SSID.conf -Dnl80211,wext
ip addr add DEVICEIP/SUBNET dev wlan0    #example: ip addr add 10.42.0.27/24 dev wlan0
#this ^ is your local IP, as DHCP/dhclient won't set one for you, choose whatever number you want as long as it is not already in use; use ip neigh to scan your local network from another device
ip route add default via GATEWAY||ROUTE  #example: ip route add default via 10.42.0.1
echo "nameserver 1.1.1.1">>/etc/resolv.conf #you need to add a DNS server, 1.1.1.1 is the Cloudflare DNS

如果您想使用 wicked，请注意可以通过 YaST 配置网络。

您可以使用 sftp 协议通过终端或 Dolphin 等某些文件浏览器远程浏览您的手机文件。由于安全原因，目前不提供 MTP 实现。
如果您尝试直接从笔记本电脑 chroot 到 SD 卡，您会看到如下错误

"chroot: failed to run command '/usr/bin/rpmdb': No such file or directory"
"chroot: failed to run command '/bin/bash': No such file or directory"

这令人困惑，因为它们并没有真正说明幕后发生了什么。要解决它，请参阅我们的指南

简而言之：挂载 SD 卡/eMMC，为当前会话设置 binmft（安装 qemu-linux-user 并执行 qemu-binfmt-conf.sh），将 binmft 文件复制到目标 chroot（例如 cp /usr/bin/{qemu-aarch64-binfmt,qemu-aarch64} /mnt/sdcard/usr/bin/）。

按照这些步骤操作后，您应该能够顺利地 chroot。以上说明仅适用于 openSUSE 发行版。

Waydroid 可用。待办事项：安装说明

贡献

如果您想参与打包、测试或有任何建议，请随时通过以下方式联系我们：

Matrix
Telegram
Discord (移动频道)
邮件列表 (ARM)

如果您在使用过程中遇到任何问题，可以通过这些聊天室联系我们寻求帮助，但请记住，我们都是自愿参与，并且在有限的时间内为项目工作。

我们还在 openSUSE Etherpad 上列出了可用的任务、想法和笔记。

源代码可在 devel:ARM:Factory:Contrib:PinePhone Open Build Service 项目中找到。

以下仓库用于测试和实验更改

这些仓库不稳定，可能存在使您的设备进入无法使用状态的风险。请自行承担风险添加它们。

基础 PinePhone 组件：较新的内核、Phosh 包等

zypper ar -p90 https://download.opensuse.org/repositories/home:/alefnode:/branches:/devel:/ARM:/Factory:/Contrib:/PinePhone/standard/home:alefnode:branches:devel:ARM:Factory:Contrib:PinePhone.repo

KDE:Frameworks5：包含 Plasma Mobile Beta 版本的 KDE 仓库

zypper ar -p90 https://download.opensuse.org/repositories/KDE:/Frameworks5/openSUSE_Factory/KDE:Frameworks5.repo

plasma-mobile、plasma-mobile:extra 和 plasma-mobile:gear：包含 KDE 应用程序和重要库的仓库；请注意，它们也应该适用于 Phosh，并且是为 x86_64 构建的

zypper ar -p90 https://download.opensuse.org/repositories/home:/andresbs:/plasma-mobile/openSUSE_Tumbleweed/home:andresbs:plasma-mobile.repo
zypper ar -p90 https://download.opensuse.org/repositories/home:/andresbs:/plasma-mobile:/extra/openSUSE_Tumbleweed/home:andresbs:plasma-mobile:extra.repo
zypper ar -p90 https://download.opensuse.org/repositories/home:/andresbs:/plasma-mobile:/gear/openSUSE_Tumbleweed/home:andresbs:plasma-mobile:gear.repo

Pure Maps：用于测试 Pure Maps 和 OSM Scout

zypper ar -p90 https://download.opensuse.org/repositories/home:/andresbs:/pure-maps/openSUSE_Tumbleweed/home:andresbs:pure-maps.repo

有用的链接

变更日志
Pine64 论坛 - 用于讨论 openSUSE 在 PinePhone 上的空间。
Pine64 Wiki - 通用的 Pine64 信息。
您应该能够在已经受 openSUSE 支持的任何设备上测试 Plasma Mobile。请在 patterns-plasma-mobile 上查看软件包列表。
关于电池调整的信息；请注意，我们不调整电池限制。我们也不调整任何时钟。 如果您想这样做，请自行承担风险，我们对任何损坏不负责。您将强行突破硬件能力的限制。
Maui 项目主网站
Pine64 Discord 聊天
Maliit 虚拟键盘技巧和窍门
为什么不支持 F2FS？