PinePhoneの初期設定のソースを表示

== 概要 ==
LinuxディストリビューションをPinePhoneにインストールする手順、および、推奨される設定を記載する。<br>
<br><br>

== Tow-Bootのインストール (Mobianをインストールする場合) ==
<u>Mobianをインストールする場合、OSをインストールする前に、SDカードにTow-Bootのイメージを焼いた後にPinePhone / PinePhone Proの本体にTow-Bootをインストールする必要がある。</u><br>
<br>
2022年4月3日以降、MobianではU-Bootがサポートされていない。<br>
そのため、Mobianのイメージとインストーラには、デバイス固有のU-Boot(ブートローダ)が含まれていない。<br>
<br>
PinePhoneではeMMCにインストールすることを推奨、PinePhone ProではSPIにインストールすることが推奨される。<br>
<br>
<u>Tow-Bootは、MobianをSDカードから起動する前に行う必要がある。</u><br>
<br>
また、Tow-Bootは、JumpDriveの機能も備えている。<br>
<br>
# 最新のTow-Bootをダウンロードする。
#: 最新のTow-Bootを[https://github.com/Tow-Boot/Tow-Boot/releases Github]からダウンロードする。
#: PinePhoneの場合 : pine64-pinephoneA64-YYYY.MM-XXX.tar.xz
#: PinePhone Proの場合 : pine64-pinephonePro-YYYY.MM-XXX.tar.xz
#: <br>
# ダウンロードしたファイルを解凍して、解凍したディレクトリに移動する。
#: PinePhoneの場合、SPIフラッシュが存在しないため、mmcboot.installer.imgを使用する。
#: PinePhone Proの場合、SDカードにspi.installer.imgを使用する。
#: <br>
# SDカードにtow-bootのイメージを書き込む。
#: <u>Tow-BootのイメージをSDカードに書き込む</u>。(<code>dd</code>コマンドやBalena Etcher等のソフトウェアを使用する)
#: <br>
#: <code>dd</code>コマンドの例
#: PinePhoneの場合 : <code>sudo dd if=mmcboot.installer.img of=/dev/XXX bs=1M oflag=direct,sync status=progress</code>
#: PinePhone Proの場合 : <code>sudo dd if=spi.installer.img of=/dev/XXX bs=1M oflag=direct,sync status=progress</code>
#: <br>
# PinePhoneにSDカードを挿入して、PinePhoneを起動する。
<br>
<u>※注意 1 (PinePhone Proの場合)</u><br>
<u>PinePhone Proの起動順序は、SPI -> eMMC -> SDカードの順であるため、Tow-Bootを使用してインストールするために、標準の起動順序を変更する必要がある。</u><br>
<u>これは、Pinephone Pro(Explorer Edition以降)の場合、REボタンを長押しすることにより、行うことができる。</u><br>
<br>
<u>Tow-BootをSPIにインストールすることにより、Pinephone ProはOSのストレージと競合することなく、標準規格に準拠したブートが使用できる。</u><br>
<br>
<u>PinePhone Proの電源を切り、SDカードを挿入した後、Pinephone Proの[RE]ボタンとボリュームの[−]ボタンを同時押下して、電源を入れる。</u><br>
<br>
<u>※注意 2 (PinePhone Proの場合)</u><br>
<u>起動直後において、PinePhone Proが振動してLEDが赤く点灯するまで(その後、LEDが黄色に点灯する)、[RE]ボタンとボリュームの[−]ボタンを同時押下し続ける必要があることに注意する。</u><br>
<u>PinePhone Proを充電しながら行うことを推奨する。</u><br>
<br>
インストーラGUIが起動するので、[Install Tow-Boot to eMMC Boot]または[Install Tow-Boot to SPI Boot] - [Start Installation]を選択する。<br>
この時、インストール前にストレージを消去する必要は無い。<br>
ストレージの消去は、Tow-Boot（またはSPIパーティションにインストールされた他のプラットフォームのファームウェア）のアンインストールに使用することができる。<br>
<br>
インストール完了後、SDカードを取り出す。<br>
<br><br>

== OSのダウンロード ==
インストールするLinuxディストリビューションのイメージをダウンロードする。<br>
* Arch Linux ARM
*: DanctNIXコミュニティによってメンテナンスされている。
*: Phosh (PinePhone) : https://github.com/dreemurrs-embedded/Pine64-Arch/releases
*: Plasma Mobile (PinePhone) : https://github.com/dreemurrs-embedded/Pine64-Arch/releases
*: Phosh (PinePhone Pro) : https://github.com/dreemurrs-embedded/Pine64-Arch/releases
*: Plasma Mobile (PinePhone) : https://github.com/dreemurrs-embedded/Pine64-Arch/releases
* Mobian (推奨)
*: Phosh (PinePhone) : https://images.mobian.org/sunxi/ または https://images.mobian.org/sunxi/weekly/
*: Phosh (PinePhone Pro) : https://images.mobian.org/rockchip/ または https://images.mobian.org/rockchip/weekly/
* Manjaro ARM
*: Phosh : https://github.com/manjaro-pinephone/phosh/releases  または  https://manjaro.org/download/
*: Plasma Mobile : https://github.com/manjaro-pinephone/plasma-mobile/releases  または  https://manjaro.org/download/
* openSUSE Tumbleweed
*: Phosh and Plasma Mobile : https://download.opensuse.org/repositories/devel:/ARM:/Factory:/Contrib:/PinePhone/images
<br><br>

== PinePhone本体へのインストール ==
==== JumpDrive ====
内蔵のeMMCは、postmarketOSのDanct12とMartijnによるJumpDriveユーティリティを使用してOSを書き込むことができる。<br>
<br>
JumpDriveはMicroSDから起動して、PinePhoneがコンピュータに接続されると内蔵のeMMCを公開する。<br>
マウントされたeMMCにOSをフラッシュする手順は、他のストレージの場合と同様である。<br>
<br>
<code>dd</code>コマンド、balenaEtcher、Gnome Disks等のソフトウェアを使用してOSを書き込むことができる。<br>
<br>
JumpDriveは、以下の公式Webサイトからダウンロードできる。<br>
(PinePhoneの場合は、pine64-pinephone.img.xzをダウンロードする)<br>
https://github.com/dreemurrs-embedded/Jumpdrive/releases/<br>
<br>
# JumpDriveのイメージをダウンロードして解凍する。
# balenaEtcher等を使用して、MicroSDにJumpDriveのイメージを書き込む。
# MicroSDをPinePhoneに挿入して、PinePhoneを起動する。
# PCとPinePhoneをUSBケーブルで接続する。
# PinePhoneのストレージ(例: /dev/mm〜、dmesg、GNOME disks等でデバイス名およびアンマウントされていることを確認する)に、選択したOSのイメージファイルを書き込む。
# 書き込みが完了した後、PinePhoneをPCから外して、PinePhoneをシャットダウンする。<br>この時、MicroSDを取り出す。
# PinePhoneの電源を投入して、eMMCから起動する。
<br>
<u>※備考</u><br>
<u>JumpDriveは、インストールに失敗した場合のレスキューイメージとしても機能する。</u><br>
<u>レスキューイメージとして使用するには、172.16.42.1にTelnetで接続した後、rootfsをマウントして修正すればよい。</u><br>
<br>
==== MicroSDからインストール ====
# MicroSDに任意のOSを書き込みした後、PinePhoneにMicroSDを挿入して、PinePhoneを起動する。
# Webブラウザを起動して、任意のOSのイメージをダウンロードする。<br>または、ターミナルを起動して、OSのプロジェクトをgit clone <OSのプロジェクトのURL>する。<br>Gitを使用する場合は、OSをビルドする必要がある。
# 以下のコマンドを実行して、ダウンロードまたはビルドしたOSのイメージをeMMCに書き込む。<br>通常、現在のカーネルでは、<u>MicroSDは/dev/mmcblk0</u>、<u>eMMCは/dev/mmcblk2</u>となる。
#: <code>sudo dd if=<インストールするOSのイメージ> of=/dev/mmcblk<span style="color:#C00000;">X</span> bs=1M status=progress</code> # <span style="color:#C00000;">X</span>はeMMCの番号ラベル
# 書き込みが完了した後、PinePhoneをシャットダウンして、MicroSDを取り出す。
# PinePhoneの電源を投入して、eMMCから起動する。
<br>

== MicroSDカードへのインストール ==
LinuxディストリビューションをMicroSDカードにインストールすることにより、PinePhoneにインストールせずにOSを試すことができる。<br>
これは、LinuxデスクトップにおけるLive USBやLive DVDのような位置付けである。<br>
<br>
==== MicroSDカードを使用する前に (共通) ====
<u>もし、PinePhone向けLinuxディストリビューションのインストールに使用したmicroSDカードを使用する場合、以下の手順を実行する。</u><br>
<br>
# GPartedや<code>parted</code>コマンド等を使用して、新しいMS-DOSパーティションを作成する。
#: 以下の例では、<code>parted</code>コマンドを使用したフォーマットおよびパーティションを作成している。
## フォーマットを行うmicroSDカードを選択する。
##: <code>sudo parted /dev/sd<span style="color:#C00000">X</span></code>
##: 例: <code>sudo parted /dev/sdb</code></code>
##: <br>
## microSDカードをフォーマットする前に、<code>mklabel</code>コマンドを実行してラベルを作成する必要がある。
##: (parted) <code>mklabel gpt</code>
##: <br>
## 次に、パーティションを作成する。<br>以下の例では、パーティション名を"primary"、FAT32タイプ、パーティションサイズは0%から100%までとしている。
##: (parted) <code>mkpart</code>
##: パーティションの名前?  []? <code>primary</code>
##: ファイルシステムの種類?  [ext2]? <code>FAT32</code>
##: 開始? <code>0%</code>
##: 終了? <code>100%</code>
##: <br>
## パーティションの作成が完了した後、<code>print</code>コマンドを実行して、パーティションを確認する。
##: (parted) <code>print</code>
##: <br>
# 残存しているu-bootのデータを削除する。<br><u>この操作を行わない場合、PinePhoneは残存しているu-bootから起動しようとすることに注意する。</u>
#: # MBRパーティションの場合
#: <code>sudo dd if=/dev/zero of=/dev/sd<span style="color:#C00000">X</span> bs=8k seek=1 count=4</code>
#: <br>
#: # GPTパーティションの場合 (GPTパーティションテーブルの場合は、8[KB]ではなく128[KB]のオフセットでインストールされる)
#: <code>sudo dd if=/dev/zero of=/dev/sd<span style="color:#C00000">X</span> bs=32k seek=4 count=1</code>
<br>

==== Arch Linux ARM ====
ダウンロードしたイメージファイルから、MicroSDにArch Linux ARMをインストールする。<br>
または、balenaEtcher等を使用する。<br>
 xzcat archlinux-pinephone-<DE名>-<バージョン>.img.xz　| sudo dd bs=4M of=/dev/sd<span style="color:#C00000">X</span> iflag=fullblock oflag=direct status=progress; sync
 または
 unxz archlinux-pinephone-<DE名>-<バージョン>.img.xz
 sudo dd bs=4M if=archlinux-pinephone-<DE名>-<バージョン>.img of=/dev/sd<span style="color:#C00000">X</span> status=progress
<br>
* 一般ユーザ名
*: alarm
* パスワード
*: 123456
* ルートユーザ名
*: root
* ルートユーザのパスワード
*: 不明 (※)
*: <br>
*: 最新のArch Linux ARMにおいて、スーパーユーザのパスワードは不明である。
*: そのため、以下に示すコマンドを実行して、スーパーユーザのパスワードを指定する必要がある。
*: <code>sudo passwd root</code>
<br>

==== Mobian ====
ダウンロードしたイメージファイルから、MicroSDにMobianをインストールする。<br>
または、balenaEtcher等を使用する。<br>
 gunzip mobian-installer-pinephone-phosh-<バージョン>.img.gz または gzip -d mobian-installer-pinephone-phosh-<バージョン>.img.gz
 sudo dd bs=1M if=mobian-installer-pinephone-phosh-<バージョン>.img of=/dev/sd<span style="color:#C00000">X</span> status=progress
<br>
* 一般ユーザ名
*: mobian
* パスワード
*: Mobian 13 Trixie : 1234
*: Mobian 12 Bookworm : インストール時に指定する。
* ルートユーザ名
*: root
* ルートユーザのパスワード
*: 不明 (※)
*: <br>
*: 最新のMobianにおいて、スーパーユーザのパスワードは不明である。
*: そのため、以下に示すコマンドを実行して、スーパーユーザのパスワードを指定する必要がある。
*: <code>sudo passwd root</code>
<br>

==== Manjaro ARM ====
ダウンロードしたイメージファイルから、MicroSDにManjaro ARMをインストールする。<br>
または、balenaEtcher等を使用する。<br>
 xzcat Manjaro-ARM-<DE名>-pinephone-<バージョン>.img.xz　| sudo dd bs=4M of=/dev/sd<span style="color:#C00000">X</span> iflag=fullblock oflag=direct status=progress; sync
 または
 unxz Manjaro-ARM-<DE名>-pinephone-<バージョン>.img.xz
 sudo dd bs=4M if=Manjaro-ARM-<DE名>-pinephone-<バージョン>.img of=/dev/sd<span style="color:#C00000">X</span> status=progress
<br>
* 一般ユーザ名
*: manjaro
* パスワード
*: 123456
* ルートユーザ名
*: root
* ルートユーザのパスワード
*: 不明 (※)
*: <br>
*: 最新のManajro ARMにおいて、スーパーユーザのパスワードは不明である。
*: そのため、以下に示すコマンドを実行して、スーパーユーザのパスワードを指定する必要がある。
*: <code>sudo passwd root</code>
<br>

==== openSUSE Tumbleweed ====
ダウンロードしたイメージファイルから、MicroSDにopenSUSE Tumbleweedをインストールする。<br>
または、balenaEtcher等を使用する。<br>
 xzcat openSUSE-Tumbleweed-ARM-PLAMO-pinephone.aarch64.raw.xz | sudo dd bs=4M of=/dev/sd<span style="color:#C00000">X</span> iflag=fullblock oflag=direct status=progress; sync
<br>
* 一般ユーザ名
*: pine
* パスワード
*: 1234
* ルートユーザ名
*: root
* ルートユーザのパスワード
*: linux
<br><br>

== SIMカード ==
==== Phosh ====
# まず、[設定] - [Mobile] - [Advanced]項目 - [Network Mode]から、[3G, 4G]を選択する。
# 次に、[設定] - [Mobile] - [Advanced]項目 - [Access Point Names]を選択する。
# [Access Points]画面右上の[+]ボタンをタップして、APNを設定する。
<br>
以下に、各通信会社の設定を示す。<br>
* IIJmio
** 名前
**: 任意 (例. IIJmio)
** APN
**: iijmio.jp
** ユーザ名
**: mio@iij
** Password
**: iij
** 認証方式
**: CHAPまたはPAP
** その他
**: もし、通信ができない場合は、[MVNOの種類]に[SPN]を選択する。
*: <br>
* b-mobile
** 名前
**: 任意 (例. b-mobile)
** APN
**: dm.jplat.net
** ユーザ名
**: jci@jci
** Password
**: jci
** 認証方式
**: CHAPまたはPAP
** PDP Type
**: IP
*: <br>
* Biglobe
** 名前
**: 任意 (例. Biglobe mobile type D)
** APN
**: biglobe.jp
** ユーザ名 (一部端末では、ID(ユーザ名)を<code>user@biglobe.jp</code>に設定する必要がある。エラーが発生する場合は試すこと)
**: user
** Password
**: 0000
** 認証方式
**: CHAPまたはPAP
** PDP Type
**: IP （PPPは未対応）
** APNタイプ (テザリングが利用できない場合、端末の接続設定に<code>APNタイプ</code>項目が表示される場合は、以下の設定を追加で入力する)
**: default,supl,dun
**: ※文字列の区切りは、<code>,</code>（カンマ）であることに注意する。
*: <br>
* OCNモバイル
** 名前
**: 任意 (例. OCN mobile)
** APN
**: 新コース : ocn.ne.jp
**: ※従来の新コース用APNである<code>lte.ocn.ne.jp</code>は、グローバルIPアドレスによる接続サービスとなるが、引き続き利用できる。
**: 新コース以外 : lte-d.ocn.ne.jp
** ユーザ名
**: mobileid@ocn
** Password
**: mobile
** 認証方式
**: CHAP
** PDP Type
**: IP （PPPは未対応）
** PINパスワード
**: 0000(デフォルト)
<br><br>

== microSDカードの使用 ==
microSDカードをデータ領域として使用する場合は、ext4フォーマットのmicroSDカードを挿入する必要がある。<br>
<br>
もし、インストール時に使用したmicroSDカードを使用する場合は、以下の手順を実行する。<br>
# GPartedやpartedコマンド等を使用して、新しいMS-DOSパーティションを作成する。
#: partedコマンドでのパーティション作成例を、以下に示す。
## microSDカードをフォーマットする前に、<code>mklabel</code>コマンドを実行してラベルを作成する必要がある。
##: <syntaxhighlight lang="text">
 sudo parted /dev/sdX  # 例: sudo parted /dev/sdb
 </syntaxhighlight>
##: <syntaxhighlight lang="text">
 (parted) mklabel gpt
 </syntaxhighlight>
## 次に、パーティションを作成する。<br>以下の例では、パーティション名を"primary"、FATfsタイプ、パーティションサイズは0[%]から100[%]までとしている。
##: <syntaxhighlight lang="text">
 (parted) mkpart
 
 パーティションの名前?  []? primary
 ファイルシステムの種類?  [ext2]? FAT32
 開始? 0%
 終了? 100%
 </syntaxhighlight>
## パーティションの作成が完了した後、printコマンドを実行して、パーティションを確認する。
##: <syntaxhighlight lang="text">
 (parted) print
 </syntaxhighlight>
# 次に、以下のコマンドを実行して、u-bootを上書きする。(これを行わない場合、PinePhoneは残存しているu-bootから起動しようとする)
#: <syntaxhighlight lang="text">
 # MBRパーティションの場合
 sudo dd if=/dev/zero of=/dev/sdX bs=8k seek=1 count=4
 
 # GPTパーティションの場合
 sudo dd if=/dev/zero of=/dev/sdX bs=32k seek=4 count=1
 </syntaxhighlight>
# 最後に、GNOME DisksやYaSTパーティションマネージャを使用して、microSDカードに対して、ext4パーティションを作成する。
<br>
以下に、microSDカードを使用する手順を示す。
# まず、microSDカードを挿入およびPinePhoneの電源を投入して、ターミナルを起動する。
# 以下のコマンドを実行して、microSDカードをマウントする。
#: <syntaxhighlight lang="text">
 sudo mkdir /mnt/sdcard && sudo mount -t ext4 /dev/mmcblk0p1 /mnt/sdcard
 </syntaxhighlight>
# 次に、ホームディレクトリの内容にmicroSDカードへコピーする。
#: <syntaxhighlight lang="text">
 sudo cp -aR /home /mnt/sdcard
 </syntaxhighlight>
# microSDカードの一時的なマウントポイントをアンマウントする。
#: <syntaxhighlight lang="text">
 sudo umount /mnt/sdcard
 </syntaxhighlight>
# microSDカードを、ホームディレクトリへマウントする。
#: <syntaxhighlight lang="text">
 sudo mount -t ext4 /dev/mmcblk0p1 /home
 </syntaxhighlight>
# microSDカードのUUIDを取得して、/etc/fstabファイルにエントリを追加する。
#: UUIDを取得するには、以下のコマンドを実行する。
#: <syntaxhighlight lang="text">
 sudo blkid /dev/mmcblk0p1
 </syntaxhighlight>
#: <br>
#: /etc/fstabファイルに、以下の内容を追記する。
#: (最後のパラメータの<code>2</code>は、fsckに他のエントリの後で確認するように指示している)
#: <syntaxhighlight lang="text">
 UUID=a2c1f977-0405-4ae1-8169-639b8ae53e3b /home ext4 defaults 0 2
 </syntaxhighlight>
# 最後に、microSDカードにあるホームディレクトリのユーザ名とグループ名を、現在使用しているユーザ名とグループ名に変更する。
#: <syntaxhighlight lang="text">
 sudo chown -R mobian:mobian /home/mobian
 </syntaxhighlight>
<br>
上記の設定により、microSDカードはホームディレクトリに持続的にマウントされる。<br>
(eMMCのホームディレクトリにある全てのファイルを持つ)<br>
<br><br>

== Wi-FiのIPアドレスの設定 ==
==== Phosh ====
[設定]を開いて、[Wi-Fi]を選択する。<br>
現在接続しているWi-FiのSSID名の右にある歯車ボタンをタップする。<br>
[IPv4]項目において、IPアドレス、サブネットマスク、ゲートウェイ、DNSの設定を行う。<br>
<br><br>

== 初期設定 ==
==== Manjaro ====
アップデートにおいて、ミラーサーバを設定する。<br>
 sudo pacman-mirrors --continent
 sudo pacman-key --init
 sudo pacman -Syyu
<br>
Manjaroを使用する場合、必要となる基本的なライブラリをインストールする。<br>
 sudo pacman -S --needed make cmake rsync base-devel gcc gdb gdb-common zip unzip lz4 meson ninja python python-pip sdl2 zlib ffmpeg
<br>
KB151キーボードライブラリを使用する場合は、以下に示す手順を実行する。(2023/06現在、KB151は使用できない)<br>
# KB151キーボードライブラリをインストールする。
#: <code>sudo pacman -S --needed ppkb-tools</code>
#: <br>
# KB151キーボードライブラリのデーモンを自動起動する。<br>
#: <code>sudo systemctl enable ppkb-i2c-inputd.service</code>
#: <br>
# 標準のキーボードライブラリを無効にするため、ブートオプション<code>pinephone-keyboard.disable_input</code>を追記する。
#: <code>sudo nano /boot/boot.txt</code>
#: <br>
#: <code># /boot/boot.txtファイル</code>
#: <code> setenv bootargs 〜 pinephone-keyboard.disable_input</code>
#: <br>
# ブートローダを更新する。
#: <code>sudo pp-uboot-mkscr</code>
#: <br>
# PinePhoneを再起動する。
#: <code>sudo systemctl reboot</code>
#: <br>
# KB151キーボードライブラリを使用して入力できるかどうか確認する。
<br>
==== Mobian ====
Mobianをアップデートする。<br>
 sudo apt update
 sudo apt upgrade
<br>
次に、GNOME Tweaks Toolをインストールする。<br>
GNOME Tweaks Toolは、拡張された設定範囲を提供しており、ユーザの好みに合わせてシステムをカスタマイズすることができる。<br>
 sudo apt install gnome-tweaks
<br>
Moabianを使用する場合、必要となる基本的なライブラリをインストールする。<br>
 sudo apt install pkg-config make cmake rsync gcc gdb binutils build-essential zip unzip lz4 meson ninja-build python3 ffmpeg \
                  gnome-tweaks openvpn network-manager-openvpn network-manager-openvpn-gnome
<br>

==== SSHの設定 ====
まず、OpenSSHサーバをインストールする。<br>
Manjaro ARMでは、Phosh Beta28以降、Plasma Beta 13以降は標準でOpenSSHがインストールされている。<br>
 # Mobian
 sudo apt install openssh-server
 
 # Manjaro
 sudo pacman -S openssh
<br>
OpenSSHを自動起動および開始する。<br>
 # Mobian
 sudo systemctl enable ssh
 sudo systemctl restart ssh
 
 # Manjaro
 sudo systemctl enable sshd
 sudo systemctl restart sshd
<br>

==== 日本語フォントのインストール ====
日本語フォントをインストールするために、以下のコマンドを実行する。<br>
 # Mobian
 sudo apt install fonts-dejavu fonts-noto-cjk fonts-ipafont
 
 # Manjaro
 sudo pacman -S --needed ttf-dejavu ttf-droid noto-fonts noto-fonts-cjk noto-fonts-emoji noto-fonts-extra otf-ipafont otf-ipaexfont otf-ipamjfont
<br><br>

== ディスプレイ関連の調整 ==
==== ソフトウェアの自動スケーリング ====
Phoc 0.4.0以降、画面に収まらない大きなウィンドウを自動的に縮小することができる。<br>
この機能は、以下のコマンドを実行して、各ソフトウェアごとに有効にする必要がある。<br>
 scale-to-fit <ソフトウェアID> on
<br>
ソフトウェアIDは、ソフトウェア自身がどのように宣言しているかによって異なる。<br>
<center>
{| class="wikitable" style="background-color:#fefefe;"
|+ ソフトウェアとソフトウェアIDの関係
|-
! style="background-color:#00ffff;" | ソフトウェア名 
! style="background-color:#00ffff;" | ソフトウェアID
|-
| Anki || anki
|-
| Calendar || gnome-calendar
|-
| Cawbird || cawbird
|-
| Empathy || empathy
|-
| Firefox || firefox-esr
|-
| Geary || geary
|-
| Maps || org.gnome.Maps
|-
| Mumble || net.sourceforge.mumble.mumble
|-
| Nautilus || org.gnome.nautilus
|-
| Totem || totem
|-
| Sudoku || gnome-sudoku
|-
| Chromium || chromium
|}
</center>
<br>
ソフトウェアIDを確認するには、ソフトウェアを<code>WAYLAND_DEBUG=client</code>を付加して起動する。<br>
例えば、Geditの場合は、<code>xdg_toplevel@37.set_app_id("gedit")</code>のような行を確認する。<br>
<br>
Evolutionのリマインダーウィンドウのサイズを変更する場合、ソフトウェアIDは、<code>evolution-alarm-notify</code>となる。<br>
<br>
[https://linmob.net/2021/02/13/pinephone-setup-scaling-in-phosh.html Linmob.net]には、スケーリングのテクニックの詳細が記載されている。<br>
<br>
==== 画面の拡大 1 ====
ソフトウェアが画面に収まらない場合、画面を拡大して表示したい場合がある。<br>
<br>
[設定]にある[ディスプレイ]には、100[%]または200[%]のスケーリングを選択する設定がある。<br>
他の値を使用する場合やターミナルから操作する場合は、wlr-randrパッケージをインストールする。<br>
 sudo apt install wlr-randr
<br>
 # スケーリングを1.5にする場合
 wlr-randr --output DSI-1 -scale 1.5
<br>
この方法では、スケーリングは再起動するまで適用される。<br>
小数点の数値を選択することもできるが、パフォーマンスに影響する可能性があることに注意すること。<br>
puri.smのブログには、スケーリングをその場で簡単に変更できるソフトウェアを作成する方法についての記事がある。<br>
<br>
==== 画面の拡大 2 ====
スケーリングの設定を永続的に適用する方法がある。<br>
ただし、phoc.iniのデフォルト値が変更された場合、古い値になってしまう可能性があることに注意する。<br>
<br>
標準の設定は、/usr/share/phosh/phoc.iniファイルにある。<br>
標準の画面のスケーリングを変更するには、/usr/share/phosh/phoc.iniファイルを/etc/phosh/phoc.iniファイルにコピーして、以下の箇所を変更する。<br>
 sudo mkdir -p /etc/phosh
 sudo cp /usr/share/phosh/phoc.ini /etc/phosh/phoc.ini
<br>
 sudo vi /etc/phosh/phoc.ini
<br>
 <syntaxhighlight lang="ini">
 # /etc/phosh/phoc.iniファイル
 
 # ...略
 
 [output:DSI-1]
 #scale = 2
 scale = 1
 
 # ...略
 
 </syntaxhighlight>
<br>

==== 画面の拡大 3 ====
<code>wlr-randr</code>コマンドの使用を便利にするため、yad(特に、フォーム構築オプション)を使用して、GUIソフトウェアを作成する。<br>
これは、<code>wlr-randr</code>コマンドを使用して、異なるスケールを設定する一連のボタン群である。<br>
 vi ~/InstallSoftware/Scale/scale.sh
<br>
 <syntaxhighlight lang="bash">
 #!/usr/bin/env bash
 
 yad --title Scale Screen --form \
     --field='Default dpi (2x scale)':fbtn "wlr-randr --output DSI-1 --scale 2" \
     --field='Low dpi (1.75x scale)!window-restore-symbolic':fbtn "wlr-randr --output DSI-1 --scale 1.75" \
     --field='Medium dpi (1.5x scale)!window-minimize-symbolic':fbtn "wlr-randr --output DSI-1 --scale 1.5" \
     --field='High dpi (1.25x scale)!window-maximize-symbolic':fbtn "wlr-randr --output DSI-1 --scale 1.25" \
     --field='Max dpi (1x scale)!view-fullscreen-symbolic':fbtn "wlr-randr --output DSI-1 --scale 1" \
     --field='Restart Phosh':fbtn "sudo systemctl restart phosh" \
     --button='Close!gtk-cancel':1
 </syntaxhighlight>
<br>
上記のシェルスクリプトを実行するデスクトップエントリファイルを作成する。<br>
 vi ~/.local/share/applications/Scale.desktop:
<br>
 [Desktop Entry]
 Type=Application
 Name=Scale Screen
 GenericName=Scale Screen
 Icon=video-display-symbolic
 Exec=/home/<ユーザ名>/InstallSoftware/Scale/scale.sh
 Terminal=false
 Categories=Utility;
<br><br>

== オンスクリーンキーボード ==
Mobianには、標準でSqueekboard(オンスクリーンキーボード)が搭載されている。<br>
<br>
Squeekboardのレイアウトは、キーボードの説明ファイルを~/.local/share/squeekboard/keyboards/terminalディレクトリに追加することにより、<br>
簡単にカスタマイズできる。<br>
また、ディスプレイのスケーリングが100%の場合、Squeekboardは、(us|de|...)_wide.yamlファイルという追加のレイアウトを探す。<br>
 # ターミナル
 ~/.local/share/squeekboard/keyboards/terminal/(us|de|...).yaml
 ~/.local/share/squeekboard/keyboards/terminal/(us|de|...)_wide.yaml  (スケーリングが100%の場合)
 
 # Emoji :
 ~/.local/share/squeekboard/keyboards/emoji/(us|de|...).yaml
 ~/.local/share/squeekboard/keyboards/emoji/(us|de|...)_wide.yaml  (スケーリングが100%の場合)
<br>
Squeekboardの設定ファイルのフォーマットは、2021年4月現在、十分に文書化されていないが、カスタマイズすることは簡単である。<br>
https://developer.puri.sm/projects/squeekboard<br>
<br>
既存のレイアウトを利用して、それを調整すると便利である。<br>
<br>
すぐに使用できる設定ファイルは、以下に示すURL(特に、Squeekboardリポジトリ)にある。<br>
* [https://source.puri.sm/Librem5/squeekboard/-/tree/master/data/keyboards Squeekboardリポジトリ]
* [https://gitlab.com/Ph42oN/squeekboard-terminal-layout 他のリポジトリ]
* [https://forum.pine64.org/showthread.php?tid=9633&page=2 PINE64フォーラムのスレッド]
<br>
ユーザがカスタマイズした設定ファイルは、2文字の言語コードの後に".yaml"というファイル拡張子を付けて保存する。<br>
横長にカスタマイズする場合は、言語コードの後に"_wide.yaml"を付ける。<br>
例えば、us.yamlファイルおよびus_wide.yamlファイルとなる。<br>
<br>
設定ファイルを、~/.local/share/squeekboard/keyboardsディレクトリに配置する。<br>
<br>
ターミナルや絵文字用にカスタマイズされた設定ファイルも同じように命名されるが、terminalディレクトリやemojiディレクトリといったサブディレクトリに配置する。<br>
例えば、カスタマイズされたUSレイアウトは、以下のディレクトリのようになる。<br>
* ~/.local/share/squeekboard/keyboards/us.yamlファイル
* ~/.local/share/squeezeboard/keyboards/terminal/us.yaml (端末のキーボード)
<br>
また、[https://wiki.mobian-project.org/doku.php?id=accessibility アクセシビリティ]とOrca screenreaderとの互換性については、いくつかの作業が必要である。<br>
<br><br>

== 日本語入力 ==
==== Mobian ====
===== Fcitx5-KKCを使用する場合 =====
まず、FcitxおよびKKCをインストールする。<br>
 sudo apt install fcitx5 fcitx5-kkc libfcitx5-qt1 fcitx5-config-qt fcitx5-frontend-gtk4 fcitx5-configtool fonts-noto-cjk
<br>
/etc/environmentファイルまたは~/.profileファイルの最下行に、以下の内容を追記する。<br>
 INPUT_METHOD=fcitx5
 XMODIFIERS=@im=fcitx5
 GTK_IM_MODULE=fcitx5
 QT_IM_MODULE=fcitx5
 
 fcitx5 -d &
<br>
PinePhoneを再起動する。<br>
<br>
PinePhoneを再起動、または、再ログインする。<br>
<br>
ターミナルを起動して、Fcitx5の設定を行う。<br>
 QT_QPA_PLATFORM=wayland fcitx5-configtool
<br>
Fcitx設定ツールのキーボード一覧画面が表示される。(標準キーボードは削除してはならない)<br>
[現在の言語のみ表示]チェックボックスのチェックを外す。<br>
<br>
[+]アイコンを選択して、検索欄に<u>kkc</u>と入力する。<br>
[かな漢字]キーボードを選択して、[OK]ボタンを押下する。<br>
<br>
KKCを有効にするには、[Global Config]タブ - [Trigger Input Method]項目がある。(初期設定では、[Ctrl] + [Space])<br>
しかし、[Ctrl] + [Space]キーはPinePhoneで使用するには快適ではないため、[Ctrl] + [LAlt]キーのような他のトリガーに変更する。<br>
<br>
Fcitx設定ツールを終了して、外部キーボードおよびスクリーンキーボードから日本語入力ができるかどうかを確認する。<br>
<br>

===== Fcitx5-Mozcを使用する場合 =====
まず、Fcitx5とそのライブラリをインストールする。<br>
 sudo apt install fcitx5 fcitx5-mozc libfcitx5-qt1 fcitx5-config-qt fcitx5-frontend-gtk4 fcitx5-configtool
<br>
/etc/environmentファイルまたは~/.profileファイルの最下行に、以下の内容を追記する。<br>
 INPUT_METHOD=fcitx5
 XMODIFIERS=@im=fcitx5
 GTK_IM_MODULE=fcitx5
 QT_IM_MODULE=fcitx5
 
 fcitx5 -d &
<br>
PinePhoneを再起動、または、再ログインする。<br>
<br>
ターミナルを起動して、Fcitx5の設定を行う。<br>
Fcitx5の設定では、入力メソッドにMozcを追加する。<br>
 QT_QPA_PLATFORM=wayland fcitx5-configtool
<br>
日本語入力と英語入力の切り替えは、PCと同様に、[Ctrl] + [Space]キーを同時押下することで切り替えができる。<br>
<br>

==== Manjaro ARM ====
Fcitxをインストールする。<br>
 # Fcitxをインストールする場合
 sudo pacman -S --needed qt5ct qt5-translations
 sudo pacman -S fcitx fcitx-mozc fcitx-gtk2 fcitx-gtk3 fcitx-qt5 kcm-fcitx
 
 # Fcitx5をインストールする場合
 sudo pacman -S --needed qt5ct qt5-translations
 sudo pacman -S --needed fcitx5 fcitx5-mozc fcitx5-qt fcitx5-config-qt fcitx5-gtk fcitx5-configtool
<br>
次に、~/.pam_environmentファイル(場合によっては、/etc/environmentファイルも含む)を作成して、以下の設定を追記する。<br>
なお、~/.xprofileファイル、~/.profileファイル、~/.bashrcファイル、~/.xinitrcファイルは設定不要である。<br>
 # Fcitxをインストールする場合
 LANG=en_US.UTF-8
 XMODIFIERS=@im=fcitx
 XMODIFIER=@im=fcitx
 GTK_IM_MODULE=fcitx
 QT_IM_MODULE=fcitx
 DefaultIMModule=fcitx
 
 # Fcitx5をインストールする場合
 INPUT_METHOD=fcitx5
 XMODIFIERS=@im=fcitx5
 GTK_IM_MODULE=fcitx5
 QT_IM_MODULE=fcitx5
 
 fcitx5 -r
<br>
PinePhoneを再起動、または、再ログインする。<br>
<br>
ターミナルを起動して以下のコマンドを実行する。<br>
Fcitx5の設定では、入力メソッドにMozcを追加する。<br>
* Manjaro Phoshの場合
*: <code>QT_QPA_PLATFORM=wayland fcitx5-configtool</code>
*: または
*: <code>QT_QPA_PLATFORM=xcb fcitx5-configtool</code>
* Manjaro Plasma Mobileの場合
*: <code>fcitx5-configtool</code>
<br><br>

== 電話帳 ==
==== Evolutionの使用 (Phoshの場合) ====
Evolutionをインストールする。<br>
 # Mobian
 sudo apt install evolution
 
 # Manjaro
 sudo pacman -S evolution
<br>
Evolutionをディスプレイにフィットさせる。<br>
この設定を行わない場合、インポート画面が大きくなりすぎるため、表示できない。<br>
 scale-to-fit evolution on
<br>
ファイルマネージャから電話帳のファイル(.vcf拡張子)を開く。<br>
[データのインポート]画面が起動して、インポートする連絡先が表示される。<br>
画面下の[進む]ボタンを押下して、電話帳をインポートする。<br>
<br>
インポート完了後は、Evolutionをアンインストールする。<br>
 # Mobian
 sudo apt purge evolution
 sudo apt autoremove
 
 # Manjaro
 sudo pacman -R evolution
<br>
==== PhoneBookの使用 (KDEの場合) ====
# Phonebookを起動する。
# Phonebookのメイン画面右上にあるボタンをタップして、[Import Contacts]を選択する。
# ファイル選択ダイアログから、電話帳ファイル(.vcf拡張子)を選択する。
<br>
==== Clontactsの使用 ====
[https://github.com/pine-clover/Clontacts.git ClontactsのGithub]から、Clontactsをダウンロードする。<br>
または、<code>git clone</code>コマンドを使用して、Clontactsをダウンロードする。<br>
 sudo apt install git  # Mobianのみ
 git clone https://github.com/pine-clover/Clontacts.git
<br>
以下のコマンドを実行して、電話帳のファイル(vcf拡張子)をインポートする。<br>
 python3 main.py <電話帳のファイルのパス>
<br>
==== 電話帳のエクスポート ====
Evolutionをインストールする。<br>
 # Mobian
 sudo apt install evolution
 
 # Manjaro
 sudo pacman -S evolution
<br>
まず、Evolutionを起動する。<br>
<br>
次に、Evolutionのメイン画面左ペインにある[Contacts]タブを選択する。<br>
Evolutionのメインメニューにある[File] - [Save Address Book as vCard]を選択する。<br>
<br>
ファイルマネージャが起動するので、任意のディレクトリに.vcfファイルを保存する。<br>
<br><br>

== スクリーンショット ==
==== 静止画 ====
必要な依存関係をインストールする。
 # Mobian
 sudo apt install grim libnotify-bin yad
 
 # Manjaro
 sudo pacman -S --needed grim libnotify yad
<br>
以下のURLからscreenshot2appスクリプトをダウンロードして、任意のディレクトリに保存する。<br>
https://matrix-client.matrix.org/_matrix/media/r0/download/matrix.org/rGMszhcjGTIQeZwCCaXMGMvw<br>
 chmod 755 screenshot2app
 
 mkdir -p ~/InstallSoftware/ScreenShot2app
 mv screenshot2app ~/InstallSfotware/ScreenShot2app
<br>
以下のURLからscreenshot2appスクリプトのデスクトップエントリファイルをダウンロードして、~/.local/share/applicationsディレクトリに保存する。<br>
https://matrix-client.matrix.org/_matrix/media/r0/download/matrix.org/CMaVegElpdiMbiChKaqPRgAW<br>
 mv screenshot.desktop ~/.local/share/applications
<br>
また、screenshot.desktopファイルを以下のように編集する。<br>
<br>

==== 動画 ====
画面を録画する場合は、wf-recorderをインストールする。<br>
 sudo apt install wf-recorder
<br>
画面とマイクを使用した動画を作成する場合、以下のコマンドを実行する。(SSHからでも可能)<br>
 wf-recorder --file=recording_with_audio.mp4 --audio
<br><br>

== 音量 ==
音量を最大にしているのに、内蔵スピーカーの音が小さいように感じることがある。
この時、alsamixerを使用して、ラインアウトのゲインを調整することができる。
 sudo apt install alsa-utils
<br>
alsamixerを使用する場合、以下のコマンドを実行する。<br>
 alsamixer
<br>
ミキサーが表示されたら、[F6]キーを押下して、[PinePhone]デバイスを選択する。<br>
左右の矢印キーで[ラインアウト]を探して、上矢印でゲインを上げる。<br>
<br>
また、[Line Out Source]でステレオではなく[Mono Dif]を選択することで、さらにゲインを上げることができる。<br>
<br><br>

== PinePhoneがSMSを受信しない場合 ==
SMSメッセージの受信ができない場合でも、SMSの送信、電話、データ通信は正常に行われている場合がある。<br>
原因として、モデムのキューに残っているSMSメッセージが考えられる。<br>
<br>
モデムのキューは、OSを再起動しても、OSを再インストールしても持続する時がある。<br>
MobianおよびManjaroでは、電話、データ通信、GPS、SMS等のモデムとの全ての通信をModemManagerが行う。(他のOSではこの限りではない)<br>
<br>
ModemManagerには、<code>mmcli</code>コマンドでアクセスできる。<br>
* Mobian
 sudo mmcli -m 0 --messaging-list-sms
 
 # SMSメッセージが無い場合
 No sms messages were found
 
 # SMSメッセージが10件ある場合
 Found 10 SMS messages:
 /org/freedesktop/ModemManager1/SMS/0 (received)
<br>
* Manjaro
 sudo mmcli -m 3 --messaging-list-sms
 
 # SMSメッセージが無い場合
 No sms messages were found
 
 # SMSメッセージがある場合
 /org/freedesktop/ModemManager1/SMS/77 (受信)
<br>
Mobianの場合は、全てのSMSメッセージを削除する場合、以下のコマンドを実行する。<br>
 sudo mmcli -m 0 --messaging-delete-sms=1  # 10件削除する場合、--messaging-delete-smsオプションの値において、
                                           # 1～10を設定して、全てのメッセージを削除する
<br>
Manjaroの場合は、全てのSMSメッセージを削除する場合、以下のコマンドを実行する。<br>
 sudo mmcli -m 3 --messaging-delete-sms=77  # リストアップされた全てのSMSメッセージで繰り返す
<br>
なお、<code>-m 0</code>または<code>-m 3</code>とは、モデム0またはモデム3(PinePhoneに搭載されているモデム)を指す。<br>
<br>
mmcliコマンドで利用できるメッセージ関連のアクションの詳細は、<code>sudo mmcli --help-messaging</code>コマンドを実行することで確認できる。<br>
また、https://electronproton.com/mmcli-command-examples も参考になる。<br>
<br>
特定の構成では、-m 2や-m 4等、様々な-m <数値>の組み合わせを試す必要があるかもしれない。<br>
<br>
最近のMobianやPostmarketOSには、eg25-managerというユーザスペースのデーモンが含まれており、モデムを管理して適切な動作を確保している。<br>
<br><br>

== スリープ / サスペンド ==
==== Phosh ====
===== カスタムサスペンドタイムアウトの設定 =====
[設定]ソフトウェアの[電源]項目では、限られた種類のタイムアウトのみ用意されている。<br>
<br>
以下の例では、サスペンドのタイムアウトを30秒に設定している。<br>
 gsettings set org.gnome.settings-daemon.plugins.power sleep-inactive-battery-timeout 30
<br>
また、現在のタイムアウトを確認するには、以下のコマンドを実行する。<br>
 gsettings get org.gnome.settings-daemon.plugins.power sleep-inactive-battery-timeout
<br>
===== サスペンドを防いで画面を表示し続ける =====
ソフトウェアの中には、スクリーンセーバーまたはサスペンドが作動するものがある。(mpv、aptでのアップグレード等)<br>
このような場合、gnome-session-inhibitツールが役に立つ。<br>
<br>
gnome-session-inhibitツールには、様々なレベルの抑制機能がある。<br>
inhibit LEVELオプションを使用すると、サスペンド(別名:クラストスリープ)やアイドルでのスクリーンロックを防ぐことができる。<br>
<br>
例えば、PinePhoneがスリープ状態になるのを防ぎ、システムをアップグレードするには、以下のコマンドを実行する。<br>
 gnome-session-inhibit -inhibit suspend sudo apt upgrade
<br>
また、以下のコマンドを.bashrcファイルのエイリアスに追記すると便利である。<br>
 # ターミナルでsudoコマンドを使用する場合はサスペンドを禁止する
 alias sudo='gnome-session-inhibit sudo'
<br>
上記のコマンドを自動化するには、/usr/share/applications/*.desktop にある任意のデスクトップランチャーのexec項目に対して、<br>
gnome-session-inhibitを付加することができる。<br>
<br>
===== SSHセッションでのスリープ防止 =====
Phoshの[電源]項目にあるインアクティビティは、画面とのインタラクションのみを考慮しているため、SSH接続中にPinePhoneがスリープモードに入ることがある。<br>
これを防ぐためには、~/.bashrcファイルの最下行に以下の設定を追記する。<br>
 <syntaxhighlight lang="sh">
 if [[ -n $SSH_CONNECTION ]]; then
    : $(gnome-session-inhibit --inhibit suspend \
       --reason "SSH connection is active" \
       --inhibit-only) &
 fi
 </syntaxhighlight>
<br>
上記の設定は、環境変数SSH_CONNECTIONが現在設定されているかどうかを確認する。(これはPinePhoneにSSH接続した場合に確認される)<br>
設定されている場合は、現在のシェルはSSHセッションを介して生成されているので、gnome-session-inhibitを使用してPinePhoneのサスペンド / スリープを防ぐ。<br>
<br>
ssh-connectionやbash-sessionがkillされる時、gnome-session-inhibitもkillされて、PinePhoneはサスペンドできるようになる。<br>
<br>
===== Mediaplayback作動中のスリープ防止 =====
[https://src.jayvii.de/Hobby/PinePhoneScripts/src/branch/main/sguard Suspend-Guardスクリプト]を使用して、メディア(音楽や動画等)が再生されている間はサスペンドしないようにすることができる。<br>
<br>
このスクリプトは、pulseaudioでオーディオを出力しているソフトウェアがあるかどうかを確認して、再度確認するまでの間、サスペンドを防止する。<br>
これにより、メディアが再生されない場合は、サスペンドできるようになる。<br>
<br>
このスクリプトには、自動的に設定を有効にするsystemd-unitが付属しており、ソースコードは[https://src.jayvii.de/Hobby/PinePhoneScripts/src/branch/main/sguard Git]で閲覧することができる。<br>
<br><br>

== 起動時にコンソール出力を表示する ==
==== Mobian ====
標準では、ブートコンソールはシリアルインターフェースである。<br>
ブートコンソールにターミナルを追加することにより、コンソール出力が可能になる。<br>
<br>
この設定では、/etc/default/u-bootファイルを編集する。<br>
もし、ファイルが存在しない場合は、以下のコマンドを実行する。<br>
 sudo u-boot-update
<br>
/etc/default/u-bootファイルの<code>U_BOOT_PARAMETERS</code>パラメータに対して、<code>splash</code>項目を削除して、<code>console=tty1</code>を追記する。<br>
これは、2つの異なるコンソール(シリアルとtty1)を有効にするためのものである。<br>
 sudo vi /etc/default/u-boot
 
 # /etc/default/u-bootファイル
 U_BOOT_PARAMETERS="console=ttyS0,115200 consoleblank=0 loglevel=7 rw plymouth.ignore-serial-consoles vt.global_cursor_default=0 console=tty1"
<br>
設定を適用するため、ブートローダをアップデートする。<br>
 sudo u-boot-update
<br>
==== Manjaro ====
まず、/boot/boot.txtファイルを以下のように編集する。<br>
 sudo vi /boot/boot.txt
<br>
 # /boot/boot.txtファイル
 
 # 編集前
 setenv bootargs loglevel=4 console=tty0 console=${console} earlycon=uart,mmio32,0x01c28000 consoleblank=0 boot=PARTUUID=${uuid_boot} root=PARTUUID=${uuid_root} rw rootwait quiet audit=0 bootsplash.bootfile=bootsplash-themes/manjaro/bootsplash 
 
 # 編集後
 setenv bootargs loglevel=4 console=ttyS0,115200 earlycon=uart,mmio32,0x01c28000 consoleblank=0 boot=PARTUUID=${uuid_boot} root=PARTUUID=${uuid_root} rw rootwait audit=0 console=tty1
<br>
設定を適用するため、U-bootをアップデートする。<br>
 sudo pp-uboot-mkscr
<br>
==== SUSE ====
ブートローダの<code>quiet</code>オプションは、ブートプロセスを出力しないようにする設定である。<br>
また、<code>splash</code>オプションはブート画面を表示するための設定である。<br>
<br>
Linux起動時にブートプロセスの情報を見る場合は、/etc/sysconfig/bootloaderファイルにある<code>DEFAULT_APPEND</code>を編集する。<br>
 sudo vi /etc/sysconfig/bootloader
<br>
* <code>quiet</code>オプションを削除する。
* <code>splash=〜</code>を<code>splash=0</code>に変更する。 <br>
<br>
設定を適用するため、GRUBをアップデートする。<br>
 sudo grub2-mkconfig -o /boot/grub2/grub.cfg 
<br><br>

== FlatPakのインストール ==
ターミナルを起動して、以下のコマンドを実行する。<br>
 # Mobian
 sudo apt install gnome-software-plugin-flatpak
 flatpak remote-add --if-not-exists flathub https://flathub.org/repo/flathub.flatpakrepo
 
 # Manjaro
 sudo pacman -S flatpak
 flatpak remote-add --if-not-exists flathub https://flathub.org/repo/flathub.flatpakrepo
<br><br>

== Chromiumブラウザのインストール ==
==== パッケージ管理システムからインストール (Mobian / Manjaro) ====
Chromiumをインストールする。<br>
 # Mobian
 sudo apt install chromium
 
 # Manjaro
 sudo pacman -S --needed chromium
<br>
==== FlatPakからインストール (Mobian / Manjaro) ====
パッケージ管理システムからインストールしたChromiumは、描画処理の不具合により、画面がホワイトアウトする場合がある。<br>
この時、FlatPakからChromiumをインストールする。<br>
 flatpak install flathub org.chromium.Chromium
<br>
PinePhoneの画面に最適化する。<br>
 scale-to-fit chromium on
<br> 
Chromiumを起動する。<br>
 flatpak run org.chromium.Chromium
<br>
FlatPakからChromiumをアンインストールする場合は、以下のコマンドを実行する。<br>
 flatpak uninstall org.chromium.Chromium
<br>
また、FlatPakからChromiumをアップデートする場合は、以下のコマンドを実行する。<br>
 flatpak update org.chromium.Chromium
 # または
 flatpak upgrade org.chromium.Chromium
<br>
==== Chromiumブラウザの設定 ====
Chromiumを使用する前に、以下の設定を行うことが重要である。<br>
Webブラウザのユーザエージェントが漏洩する時、サービスプロバイダがデバイスを特定した場合、アカウントを無効にする可能性がある。<br>
<br>
# Chromiumのアドレスバーに<code>chrome://flags</code>と入力して、"Freeze User-Agent request header"をインストールおよび有効にして、Chromiumを終了する。
# 再度、Chromiumを起動して、[その他のツール] - [拡張機能]から"Use-Agent Switcher"をインストールする。
# この拡張機能を開いて、[Android] - [Android Kitkat]を選択する。
# 最後に、Chromiumを再起動する。<br>これにより、Chromiumがモバイルで起動する。
<br>
もし、Chromiumを起動した時に画面がホワイトアウトする場合は、/etc/chromium/local.confファイルを作成して、以下の設定を追記する。<br>
 sudo vi /etc/chromium/local.conf
<br>
 # /etc/chromium/local.confファイル
 
 unset GDK_BACKEND
<br>
Chromiumブラウザが実行できるかどうか確認する。<br>
<br>
==== 描画エラー ====
Chromiumを起動した時、文字が表示されない場合がある。<br>
この時、[ハードウェアアクセラレーションが使用可能な場合は使用する]のチェックを外す。<br>
<br>
# 設定画面も見えない可能性もあるため、アドレスバーに chrome://settings/system と入力する。
# 上から2番目のスイッチを無効化（グレーアウト）する。
# Chromiumを再起動する。
<br>
==== 日本語入力できない ====
===== 方法 1: GTK4方式に切り替え =====
<u>この方法では、候補ウィンドウの位置がずれる場合がある。</u><br>
<br>
 sudo vi /etc/chromium.d/fcitx5-wayland
<br>
 export CHROMIUM_FLAGS="$CHROMIUM_FLAGS --ozone-platform=wayland --gtk-version=4"
<br>
===== 方法 2: XWaylandにフォールバック =====
<u>この方法は、環境変数 <code>GTK_IM_MODULE=fcitx</code> が設定されている必要がある。</u><br>
ネイティブWaylandの恩恵は失われるが、日本語入力は最も安定して動作する。<br>
<br>
 sudo vi /etc/chromium.d/fcitx5-wayland
<br>
 export CHROMIUM_FLAGS="$CHROMIUM_FLAGS --ozone-platform=x11"
<br>
アドレスバーに chrome://version と入力して、フラグが反映されているか確認する。<br>
<br><br>

==== リモートデスクトップ ====
VNCサーバを起動して、PCからPinephoneにアクセスしてコントロールすることができる。<br>
 sudo apt install wayvnc
<br>
インストールしたwayvncを実行する。<br>
 wayvnc 0.0.0.0 -r --render-cursor
<br>
PCからTigerVNC等のVNCクライアントを使用して接続する。<br>
<br>
<u>※注意</u><br>
<u>マウスカーソルがPinephoneのスクリーンにしか表示されず、VNCクライアントのウインドウには表示されないため、一部のUI(ロックスクリーン等)が操作しづらい。</u><br>
<u>しかし、<code>-r --render-cursor</code>オプションを付加することにより、カーソルが動くようになる。</u><br>
<br>
<u>Pinephoneの解像度は720x1280のため、PCモニタの解像度(1920x1080等)では画面の下から200ピクセルはみ出す。</u><br>
<u>ディスプレイを横向きに切り替えると、よりフィットする。</u><br>
<br><br>

== アイコンの変更 ==
==== Papirus ====
Papirusのアイコンテーマをインストールする。<br>
 sudo apt install papirus-icon-theme
<br>
アイコンテーマをPapirusに変更する。<br>
 # Papirusライトを使用する場合
 gsettings set org.gnome.desktop.interface icon-theme 'Papirus-Light'
 
 # Papirusダークを使用する場合
 gsettings set org.gnome.desktop.interface icon-theme 'Papirus-Dark'
<br><br>

== テーマの変更 ==
インストールしたテーマは、/usr/share/themesディレクトリに保存される。<br>
また、テーマの中には、システムの標準のキーバインドを変更するものがある。(例えば、プリインストールされているEmacsテーマはキーバインドのみを変更する)<br>
<br>
* Adapta
*: Adaptaは、Material Design Guidelinesに基づいたアダプティブなテーマである。
*: パッケージには、Adapta、Adapta-Eta、Adapta-Nokto、Adapta-Nokto-Etaの5種類が含まれている。
*: <code>sudo apt install adapta-gtk-theme fonts-roboto fonts-roboto-unhinted gnome-accessibility-themes gnome-themes-extra gtk2-engines-murrine</code>
*: <br>
* Breeze
*: KDEのBreezeに合わせて作成されたGTK2、GTK3用のGTKテーマである。
*: パッケージには、BreezeとBreeze-Darkが含まれている。
*: <code>sudo apt install breeze-gtk-theme</code>
*: <br>
* Materia
*: Materia(旧Flat-Plat)は、Material Designテーマである。
*: パッケージには、Materia-light-compact、Materia-light、Materia-dark-compact、Materia-dark、Materia-compact、Materiaの各テーマが含まれている。
*: <code>sudo apt install materia-gtk-theme</code>
*: <br>
* Numix
*: Numixは、ライト要素とダーク要素が組み合わさったモダンなフラットテーマである。
*: ただし、Darkバージョンでは、上下のバーのテキストが見えにくい欠点がある。
*: <code>sudo apt install numix-gtk-theme</code>
<br>
インストールしたテーマを変更するには、以下のコマンドを実行する。<br>
テーマ名とは、/usr/share/themesディレクトリにあるテーマのディレクトリ名である。<br>
 gsettings set org.gnome.desktop.interface gtk-theme '<テーマ名>'
<br>
例えば、Materiaダークに変更する場合は、以下のコマンドを実行する。<br>
 gsettings set org.gnome.desktop.interface gtk-theme 'Materia-dark'
<br><br>

== 壁紙の変更 ==
==== メイン画面 ====
壁紙は、ソフトウェアを起動して表示されるまでの間、短い時間のみ表示される。<br>
[設定]の[背景]で設定できる。<br>
<br>
ターミナルで背景を設定するには、以下のコマンドを実行する。<br>
 gsettings set org.gnome.desktop.background picture-uri 'file:///home/mobian/Pictures/<画像ファイル名>.jpg'
<br>
==== ロック画面 ====
ソフトウェア選択画面やロック画面の背景を変更するには、~/.config/gtk-3.0/gtk.cssファイルを作成する必要がある。<br>
<br>
以下は、cssスクリプトの例である。
 <syntaxhighlight lang="css">
 // ~/.config/gtk-3.0/gtk.css
 // Restart phosh using "sudo systemctl restart phosh"
 
 phosh-app-grid {
    background-image: linear-gradient(rgba(0, 0, 0, 0.7), rgba(0, 0, 0, 0.7)), url('file:///home/mobian/Pictures/App.jpg');
    background-size: cover;
    background-position: center;
 }
 
 phosh-lockscreen, .phosh-lockshield {
    background-image: linear-gradient(rgba(0, 0, 0, 0.7), rgba(0, 0, 0, 0.7)), url('file:///home/mobian/Pictures/Lock.jpg');
    background-size: cover;
    background-position: center;
 }
 </syntaxhighlight>
<br><br>

== .profileファイルの編集 ==
.profileファイルを、以下のような内容を追記する。<br>
 <syntaxhighlight lang="sh">
 # User Add
 
 # Add Library Path
 export LD_LIBRARY_PATH="/home/mobian/InstallSoftware/Qt_5_15_2/lib:$LD_LIBRARY_PATH"
 
 # Display Scaling
 #wlr-randr --output DSI-1 --scale 1.5
 
 # Enable Qt Debug
 export QT_QPA_PLATFORMTHEME="qt5ct"
 export DISPLAY=":0"
 export XAUTHORITY="/home/mobian/.Xauthrity"
 export XDG_SESSION_TYPE="wayland"
 
 # Enable Qt Quick Debug
 export QML2_IMPORT_PATH="/home/mobian/InstallSoftware/Qt_5_15_2_Library/qml"
 export QML_IMPORT_PATH="/home/mobian/InstallSoftware/Qt_5_15_2_Library/qml"
 export QT_PLUGIN_PATH="/home/mobian/InstallSoftware/Qt_5_15_2_Library/plugins"
 
 #export XDG_RUNTIME_DIR="/home/mobian/XDG_RUNTIME"  # Not Enable (Display will be Black Screen)
 
 # Fcitx for Japanese
 export XMODIFIERS=@im=fcitx
 export QT_IM_MODULE=fcitx
 export GTK_IM_MODULE=fcitx
 </syntaxhighlight>
<br><br>

== .bashrcファイルの編集 ==
.bashrcファイルを、以下のような内容を追記する。<br>
 <syntaxhighlight lang="sh">
 # User Add
 
 # エイリアスを追加
 alias cd='cd -P'
 alias rm='rm -i'
 alias cp='cp -i'
 alias mv='mv -i'
 alias ls='ls -hlvF --group-directories-first --color=auto'
 alias cat='cat -n'
 alias less='less -n'
 alias grep='grep -i'
 alias en='LANG=C LANGUAGE=C LC_ALL=C'
 alias jp='LANG=ja_JP.UTF-8'
 alias igrep='sudo dpkg -l | grep'
 alias asearch='sudo apt-cache search'
 alias nano='nano -lmS'
 alias snano='sudo nano -lmS'
 alias scale='wlr-randr --output DSI-1 --scale'
 alias poff='sudo shutdown -h now'
 alias preboot='sudo shutdown -r now'
 #alias sudo='gnome-session-inhibit sudo'
 
 # コマンドの重複を履歴に残さない
 export HISTCONTROL=ignoredups
 
 # 空白から始めたコマンドを無視
 export HISTCONTROL=ignorespace
 
 # コマンド履歴に残さないコマンド群
 export HISTIGNORE="fg*:bg*:history*:cd*:ls*:cat*:less*:more*:grep*:lgrep*:igrep*:scale*:which*:clear:man*:startx*:exit*:poff*:preboot*"
 
 HISTTIMEFORMAT='%Y%m%d %T   ';
 export HISTTIMEFORMA
 
 # プロンプトの表示形式
 PS1='\e[0;31m\u\e[0m@\e[0;32m\h\e[0m(\t) [Path \w] \n> '
 
 # mkdirとcdを同時実行
 function mkcd()
 {
    if [ "$#" -eq 0 ]; then
       echo "Too few arguments!"
    elif [ "$#" -eq 1 ]; then
       if [ -d $1 ]; then
          echo "$1 already exists!"
          cd $1
       else
          mkdir -p $1 && cd $1
       fi
    else
       echo "Too many arguments!"
    fi
 }
 
 # ディレクトリに存在するディレクトリとファイルの検索
 function lgrep()
 {
    if [ "$#" -eq 1 ]; then
       local IFS_BACKUP=$IFS
       IFS=$'\n\t'
 
       for OBJECT in $(\ls -aA --group-directories-first | \grep -iE "${1}")
       do
          \ls -AdhlF --color "${OBJECT}"
       done
 
       echo ""
 
       IFS=$IFS_BACKUP
    elif [ "$#" -eq 2 ]; then
       # 第1引数で指定したディレクトリが存在するか確認する
       if [ ! -d "$1" ]; then
          echo "Not Exist Directory $1" 1>&2
          return 1
       fi
 
       local IFS_BACKUP=$IFS
       IFS=$'\n\t'
 
       # 現在のカレントディレクトリを一時的に保存する
       local CURRENTDIR=$(\pwd)
 
       # 第1引数で指定したディレクトリに移動する
       cd "${1}";
 
       # 第2引数で指定したパターンを使用して検索する
       for OBJECT in $(\ls -aA --group-directories-first | \grep -iE "${2}")
       do
          \ls -AdhlF --color "${OBJECT}"
       done
 
       # カレントディレクトリに戻る
       cd "${CURRENTDIR}"
 
       echo ""
 
       IFS=$IFS_BACKUP
 
       unset -v OBJECT
    else
       echo "Specify Arguments." 1>&2
    fi
 
    return 0
 }
 
 # パターンにマッチするファイル内容を検索する
 function filegrep()
 {
    if [ "$#" -eq 2 ]; then
       local IFS_BACKUP=$IFS
       IFS=$''
 
       for OBJECT in $(\find . -type f -name "${1}" -print0 | \xargs -0 \grep -inE "${2}")
       do
          echo "${OBJECT}"
       done
 
       echo ""
 
       IFS=$IFS_BACKUP
    elif [ "$#" -eq 3 ]; then
       # 第1引数で指定したディレクトリが存在するか確認する
       if [ ! -d "$1" ]; then
          echo "Not Exist Directory $1" 1>&2
          return 1
       fi
 
       local IFS_BACKUP=$IFS
       IFS=$''
 
       # 現在のカレントディレクトリを一時的に保存する
       local CURRENTDIR=$(\pwd)
 
       # 第1引数で指定したディレクトリに移動する
       cd "${1}";
 
       # 第2引数で指定したパターンを使用して検索する
       for OBJECT in $(\find . -type f -name "${2}" -print0 | \xargs -0 \grep -inE "${3}")
       do
          echo "${OBJECT}"
       done
 
       # カレントディレクトリに戻る
       cd "${CURRENTDIR}"
 
       echo ""
 
       IFS=$IFS_BACKUP
 
       unset -v OBJECT
    else
       echo "Specify Arguments." 1>&2
    fi
 
    return 0
 }
 
 # 環境変数PATHの設定
 function SetPATH()
 {
    OLDIFS=${IFS}
    IFS=$':'
 
    BEFORE_HOME='$HOME'
    AFTER_HOME=${HOME}
    PATH_NAME=$(echo ${1//${BEFORE_HOME}/${AFTER_HOME}})
 
    SLASH=$(echo ${PATH_NAME: -1:1})
    if [ ${SLASH} = "/" ]; then
        LENGTH="${#PATH_NAME}"
        let LENGTH=${LENGTH}-1
        PATH_NAME=$(echo ${PATH_NAME:0:${LENGTH}})
    fi
 
    if [ ! -d ${PATH_NAME} ]; then
        echo "No Exist Directory"
        return 1
    fi
 
    EXIST_FLAG=0
    for VALUE in ${PATH}
    do
        if [ ${VALUE} = ${PATH_NAME} ]; then
            EXIST_FLAG=1
            break
        fi
    done
 
    if [ ${EXIST_FLAG} -eq 0 ]; then
        export PATH="$PATH_NAME:$PATH"
    elif [ ${EXIST_FLAG} -eq 1 ]; then
        echo "Already Exist ${PATH_NAME} in PATH " 1>&2
    fi
 
    unset -v OLDIFS SLASH LENGTH BEFORE_HOME AFTER_HOME PATH_NAME EXIST_FLAG VALUE
 
    IFS=${OLDIFS}
 
    return 0
 }
 
 function SetLIBRARY()
 {
    OLDIFS=${IFS}
    IFS=$':'
 
    BEFORE_HOME='$HOME'
    AFTER_HOME="$HOME"
    PATH_NAME=$(echo ${1//${BEFORE_HOME}/${AFTER_HOME}})
 
    SLASH=$(echo ${PATH_NAME: -1:1})
    if [ ${SLASH} = "/" ]; then
        LENGTH="${#PATH_NAME}"
        let LENGTH=${LENGTH}-1
        PATH_NAME=$(echo ${PATH_NAME:0:${LENGTH}})
    fi
 
    if [ ! -d ${PATH_NAME} ]; then
        echo "No Exist Directory"
        return 1
    fi
 
    EXIST_FLAG=0
    for VALUE in ${PATH}
    do
        if [ ${VALUE} = ${PATH_NAME} ]; then
            EXIST_FLAG=1
            break
        fi
    done
 
    if [ ${EXIST_FLAG} -eq 0 ]; then
        export LD_LIBRARY_PATH="$PATH_NAME:$LD_LIBRARY_PATH"
    elif [ ${EXIST_FLAG} -eq 1 ]; then
        echo "Already Exist ${PATH_NAME} in PATH " 1>&2
    fi
 
    unset -v OLDIFS SLASH LENGTH BEFORE_HOME AFTER_HOME PATH_NAME EXIST_FLAG VALUE
 
    IFS=${OLDIFS}
 }
 
 # 環境変数PATHの重複を削除する
 function DeleteDuplicate()
 {
    if typeset -A &>/dev/null; then  # 連想配列が使用できるか確認する
        # 使える場合
        typeset -A _paths
        typeset _results
 
        while read -r _p
        do
            if [[ -n ${_p} ]] && (( ${_paths["${_p}"]:-1} )); then
                _paths["${_p}"]=0
                _results=${_results}:${_p}
            fi
        done <<<"${PATH//:/$'\n'}"
 
        PATH=${_results/:/}
 
        unset -v _p _paths _results
    else
        # 使えない場合はawkを使用する
        typeset _p=$(awk 'BEGIN{RS=":";ORS=":"} !x[$0]++' <<<"${PATH}:")
        PATH=${_p%:*:}
 
        unset -v _p
    fi
 }
 
 if [[ -n $SSH_CONNECTION ]]; then
   : $(gnome-session-inhibit --inhibit suspend \
      --reason "SSH connection is active" \
      --inhibit-only) &
 fi
 </syntaxhighlight>
<br><br>

== SoCのオーバークロック ==
==== Allwinner SoC ====
Allwinner Socをオーバークロックするには、まず、/boot/dtbs/allwinnerディレクトリにあるDTBファイルをDTSファイルに変換する必要がある。<br>
所有しているPinePhoneに適合するsun50i-a64-pinephone-1.X.dtbファイルを、DTSファイルに変換する。<br>
 sudo dtc -I dtb -O dts /boot/dtbs/allwinner/sun50i-a64-pinephone-1.X.dtb -o /boot/dtbs/allwinner/sun50i-a64-pinephone-1.X.dts
<br>
変換したDTSファイルの内容を、以下に示すように編集する。<br>
以下の例では、Allwinner SoCのCPUを1.344[GHz]に変更している。<br>
 sudo vi /boot/dtbs/allwinner/sun50i-a64-pinephone-1.X.dts
<br>
 # /boot/dtbs/allwinner/sun50i-a64-pinephone-1.X.dtsファイル
 
 # 編集前
 
 opp-table-cpu {
    ...略
 
    opp-1152000000 {
       opp-hz = <0x00 0x44aa2000>;
       opp-microvolt = <0x13d620>;
       clock-latency-ns = <0x3b9b0>;
    };
 };
 
 # 編集後 (Allwinner SoCを1.344[GHz]に変更する場合)
 
 opp-table-cpu {
    ...略
 
    opp-1152000000 {
       #opp-hz = <0x00 0x44aa2000>;
       opp-hz = <0x00 0x501bd000>;
       opp-microvolt = <0x13d620>;
       clock-latency-ns = <0x3b9b0>;
    };
 };
<br>
次に、編集したDTSファイルをDTBファイルに変更する。<br>
 sudo dtc -I dts -O dtb /boot/dtbs/allwinner/sun50i-a64-pinephone-1.X.dts -o /boot/dtbs/allwinner/sun50i-a64-pinephone-1.X.dtb
<br>
以下のパッケージを再インストールする。<br>
 sudo pacman -S linux-pinephone
 sudo pacman -S kmod libdrm mtdev ndctl libxdmcp powersupply wayland xorg-xprop zenity iio-sensor-proxy  # 不要の可能性あり
<br>
最後に、PinePhoneを再起動する。<br>
 sudo systemctl reboot
<br>
Allwinner Socのクロックの詳細を知りたい場合、/sys/kernel/debug/clk/clk_summaryファイルを確認する。<br>
 sudo cat /sys/kernel/debug/clk/clk_summary
<br>
オーバークロックに関する詳細は、[https://wiki.pine64.org/index.php/Overclocking PinePhoneの公式Wiki]を参照すること。<br>
<br>
初期状態のGPUのクロックは、432[MHz]に設定されている。<br>
以下の例では、GPUのクロックを500[MHz]に設定している。<br>
<br>
GPUの安定性を確認するために、ベンチマークツール（glmark2-es2等）を実行すること。<br>
<br><br>

== エラー関連 ==
==== SDカードからLinuxディストリビューションがブートしない場合 ====
最も一般的な原因は、以前、SDカードにLinuxディストリビューションまたはJumpDriveがフラッシュされており、それを消去した際にブートセクタが消去されなかったことである。<br>
<br>
<code>dd</code>コマンドを実行して、SDカードのブートセクタを消去する。<br>
 sudo dd if=/dev/zero of=/dev/sd<span style="color:#C00000">X</span> bs=512 seek=16 count=1  # <span style="color:#C00000">X</span> : SDカードのデバイス番号
<br>
==== 起動時にLEDは緑のままでLinuxディストリビューションが起動しない場合 ====
緑色のLEDは、まだP-Bootの段階であることを意味する。<br>
<br>
* Tow-Bootを使用している場合
** 方法 1
**: 起動時および2回目のバイブレーションの間、<u>ボリュームダウンボタン</u>を押しながらPinePhoneを起動する。
** 方法 2
**: 再度、SDカードにLinuxディストリビューションをインストールする。
*: <br>
* SDカード上のJumpDriveを使用している場合
*: JumpDriveで起動する。
<br>
あるいは、/boot/extlinux/extlinux.confファイルを編集して古いカーネルを優先させて起動することもできる。<br>
<br>
==== アップデートエラー ====
<code>sudo apt upgrade</code>コマンドの実行において、エラーが発生する場合、以下のコマンドを実行する。<br>
 timedatectl set-ntp yes
 sudo systemctl restart systemd-timesyncd.service
<br>
==== モデムマネージャ ====
Phoshにおいて、SIMカードを使用して通信(4G通信)を行うEG25モデムマネージャが停止する場合がある。<br>
この時、メイン画面左上にあるモデムマネージャ(4G)のアイコンが消える。<br>
<br>
===== 方法 1 =====
モデムマネージャを再起動するため、以下のコマンドを実行する。<br>
 sudo systemctl restart eg25-manager.service
<br>
もし、上記のコマンドが正常に実行された場合は、2〜3分後にモデムマネージャが再起動する。<br>
<br>
===== 方法 2 =====
モデムマネージャを再起動するため、以下のコマンドを実行する。<br>
 sudo --askpass killall ModemManager
 sudo /usr/bin/ModemManager &
<br>
また、上記のコマンドを、~/.bashrcファイル等にエイリアスを追加してもよい。<br>
 vi ~/.bashrc
<br>
 # ~/.bashrcファイル
 
 alias startmodem=' sudo --askpass killall ModemManager; sudo /usr/bin/ModemManager &'
<br>
===== 方法 3 =====
モデムマネージャを数分ごとに確認して、停止している場合は自動的に再起動するSystemdサービスユニットを作成する。<br>
<br>
モデムマネージャが停止する時、/dev/ttyUSB2ファイルが自動的に削除されるため、このファイルが削除された時にSystemdサービスユニットを実行する。<br>
 sudo vi /etc/systemd/system/modem-test.timer
<br>
 # /etc/systemd/system/modem-test.timerファイル
 
 [Unit]
 Description=Check presence of modem every minute
 
 [Timer]
 OnBootSec=180
 OnUnitActiveSec=180
 
 [Install]
 WantedBy=timers.target
<br>
 sudo vi /etc/systemd/system/modem-test.service
<br>
 # /etc/systemd/system/modem-test.serviceファイル
 
 [Unit]
 Description=Check if modem is present and restart eg25-manager if necessary
 ConditionPathExists=!/dev/ttyUSB2
 
 [Service]
 Type=oneshot
 ExecStart=systemctl restart eg25-manager.service
<br>
==== Manjaro ARMのアップデートエラー (QEMU-User-Staticで実行する場合) ====
Manjaro ARMのシステムをアップデートする時、以下に示すようなエラーが発生する場合がある。<br>
 error: <インストールするパッケージ名>: signature from "Arch Linux ARM Build System <builder@archlinuxarm.org>" is unknown trust
<br>
この時、/etc/pacman.confファイルを以下に示すように編集する。<br>
 sudo vi /etc/pacman.conf
<br>
 <syntaxhighlight lang="ini">
 # 42行目あたり
 
 #SigLevel    = Required DatabaseOptional  # コメントアウトする
 SigLevel    = Optional TrustAll           # 追記する
 </syntaxhighlight>
<br><br>

== その他 ==
==== アニメーションの無効化 ====
Phoshにおいて、アニメーションを無効化することにより、システムのスループットが向上する場合がある。<br>
<u>ただし、Phosh 0.20等の古いバージョンでは、描画が崩れることに注意する。</u><br>
 gsettings set org.gnome.desktop.interface enable-animations false
<br>
設定を有効にするため、PinePhoneを再起動する。<br>
または、Phoshを再起動する。<br>
 sudo systemctl restart phosh
<br><br>

== PinePhone / PinePhone Proのバッテリー ==
PinePhone / PinePhone Proの純正バッテリーは、Pine64のWebサイトでは在庫が存在しない時がある。<br>
そのため、互換バッテリーで代用しなければならない場合もある。<br>
<br>
PinePhone / PinePhone Proのバッテリーは、2015年に販売されたSamsung J7 Phoneのバッテリー(サムスン部品番号 EB-BJ700BBC / BBE / CBE)と互換性がある。<br>
このバッテリーは、タイトではあるが、PinePhone / PinePhone Proの筐体にフィットする。<br>
<br>
* 国内販売店 (配達は早いが値段が高い)
*: https://www.denchi-pc.jp/samsung-EB-BJ700BBC-battery-214494.htm
*: <br>
* AliExpress (配達は遅いが値段が安い)
*: https://ja.aliexpress.com/item/32974287225.html
*: https://ja.aliexpress.com/item/1005002515953771.html
*: https://ja.aliexpress.com/item/1005002169247438.html
*: https://ja.aliexpress.com/item/1005003706605263.html
<br>
<u>※注意</u><br>
<u>警告より大きな容量のアフターマーケットバッテリーを使用することは、自己責任で行うこと。</u><br>
<u>特に、充電器との組み合わせにより、大きな容量のバッテリーを使用すると、過電圧が発生して、モデムやBluetooth、Wi-Fiチップが壊れる場合があることに注意する。</u><br>
<br><br>

== 故障 ==
==== キーボード関連の故障 ====
キーボードを装着すると、装着していないときよりもバッテリーの消耗が速くなる。<br>
* キーボード未装着の場合、PinePhoneは1日経ってもバッテリーは保つ。
* キーボードを装着している場合、PinePhoneのバッテリーは完全に消耗し、キーボードのバッテリーもかなり消耗している。
* キーボードを通しての充電はとても遅い。
* また、キーボードを装着すると、より頻繁に熱くなる。(触ると通常より熱くなる)
<br>
この場合、キーボードのメイン基板が故障している可能性が高い。<br>
<u>キーボードのメイン基板の故障に巻き込まれて、PinePhoneのメイン基板も故障している場合もあるので注意すること。</u><br>
<br>
詳細は、以下に示すPine64フォーラムを参照すること。<br>
https://forum.pine64.org/showthread.php?tid=16271<br>
<br>
キーボードを分解して、チップの焼損を確認することができる。 (キーボードを試験および修理するには、マルチメーターとハンダごてが必要となる)<br>
もし、キーボードの充電回路が故障している場合、交換用のキーボードのメイン基板が$9.99で購入することができる。<br>
https://pine64.com/product/pinephonepro-keyboard-mainboard/<br>
<br>
ただし、キーボードの充電回路は故障している場合でも、PinePhoneが充電されていればキーボードとして使用できる。<br>
<br><br>

== PinePhoneのメインボード交換手順 ==
PinePhoneのメインボードを交換する前に、以下に示す手順に従う。<br>
<br>
PinePhoneのメインボードを交換するには、小型のフィリップスドライバと他工具が必要となる。<br>
<br>
# PinePhoneの背面カバーを取り外す。
# バッテリーと挿入されているSDカード、SIMカードを取り外す。
# PinePhoneのミッドフレーム周辺にある15個のフィリップスネジを全て外す。
# プラスチックスクライバを使用して、ミッドフレームをゆっくりとこじ開ける。<br>ミッドフレームの下端を切り離すのが最も簡単である。<br>ミッドフレームがスマートフォン本体から分離するまで、スマートフォンの全側面に手を回す。
# 全てのリボンケーブルとLegoコネクタを取り外す。<br>以下に、取り外す部品の詳細を示す。
## メインボード上部のLCDリボンケーブル
## メインボード下部の2つのレゴコネクタ
## メインボード左側のタッチスクリーンデジタイザ
## メインボード左下にあるu.FLアンテナ接続
## 上記部品を取り外した後、オーディオ/UARTジャックを外す。
# メインボードを左側から軽くこじる。
# フロントカメラとメインカメラを取り外し、これらのカメラを新しいメインボードに取り付ける。
# 新しいメインボードをシャーシにセットし、左側のプラスチック製タブに引っ掛け、反対側をしっかりと押さえ、手順5を逆に行う。
<br>
<center><embedvideo service="youtube">https://youtu.be/5GbMoZ_zuZs</embedvideo></center><br>
<br><br>

== USBドック ==
Mobianにおいて、動作報告のあるUSBドックを以下に示す。<br>
<br>
* Anker PowerExpand+
*: HDMIポートを起動するコマンド
*: <code>wlr-randr --output HDMI-A-1 --mode <外部ディスプレイの解像度></code>
*: 注意 : 1080p以上だと不安定になることがある。
<br>
<center>
{| class="wikitable"
|-
! style="background-color:#44CC99;" | USBドック
|- style="text-align: center; background-color:white;"
| <html><a href="https://www.amazon.co.jp/Anker-PowerExpand-Delivery-USB-C%E3%83%9D%E3%83%BC%E3%83%88-USB-A%E3%83%9D%E3%83%BC%E3%83%88/dp/B087TB7YM7?__mk_ja_JP=%E3%82%AB%E3%82%BF%E3%82%AB%E3%83%8A&keywords=Anker+PowerExpand%2B+7in1+USB+PD+HDMI+%E3%82%A4%E3%83%BC%E3%82%B5%E3%83%8D%E3%83%83%E3%83%88+microSD%26SD+60W%E5%87%BA%E5%8A%9B&qid=1687416712&sr=8-1&linkCode=ll1&tag=presire2-22&linkId=55e142eaf8a90bbba2fbd713039dbcea&language=ja_JP&ref_=as_li_ss_tl" target="_blank"><img style="width: 250px; height: auto;" src="https://m.media-amazon.com/images/I/61pnlfrrehS._AC_SL1500_.jpg" ></a><br>
<center><a target="_blank" href="https://www.amazon.co.jp/Anker-PowerExpand-Delivery-USB-C%E3%83%9D%E3%83%BC%E3%83%88-USB-A%E3%83%9D%E3%83%BC%E3%83%88/dp/B087TB7YM7?__mk_ja_JP=%E3%82%AB%E3%82%BF%E3%82%AB%E3%83%8A&keywords=Anker+PowerExpand%2B+7in1+USB+PD+HDMI+%E3%82%A4%E3%83%BC%E3%82%B5%E3%83%8D%E3%83%83%E3%83%88+microSD%26SD+60W%E5%87%BA%E5%8A%9B&qid=1687416712&sr=8-1&linkCode=ll1&tag=presire2-22&linkId=55e142eaf8a90bbba2fbd713039dbcea&language=ja_JP&ref_=as_li_ss_tl">Anker PowerExpand 8-in-1 USB-C PD</a></center></html>
|}
</center>
<br><br>

__FORCETOC__
[[カテゴリ:PinePhone]]