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

== 概要 ==

<br><br>

== eMMCへのインストール ==
==== 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のOSからインストール ====
# 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><br>

== 日本語入力 ==
現在(2021/4/24)、この設定が有効な環境は、Mobianのみである。<br>
<br>
まず、以下のFcitxとそのライブラリをインストールする。<br>
 sudo apt install fcitx fcitx5 fcitx5-config-qt fcitx5-data fcitx5-frontend-gtk2 fcitx5-frontend-gtk3 \
                  fcitx5-frontend-qt5 fcitx5-table gir1.2-fcitxg-1.0 fcitx5-module-wayland fcitx5-modules \
                  fcitx5-module-ibus fcitx5-module-fullwidth fcitx5-module-dbus fcitx5-module-emoji fcitx-mozc \
                  ibus-mozc mozc-data mozc-server mozc-utils-gui
<br>
/etc/environmentファイルまたは~/.profileファイルの最下行に、以下の内容を追記する。<br>
 export XMODIFIERS=@im=fcitx
 export QT_IM_MODULE=fcitx
 export GTK_IM_MODULE=fcitx
<br>
次に、/usr/share/fcitx5/addon/fcitx-mozc.confファイルを、以下の内容で作成する。<br>
 [Addon]
 Type=SharedLibrary
 Name=fcitx-mozc
 GeneralName=Mozc
 Comment=Mozc support for Fcitx
 Library=fcitx-mozc.so
 Category=InputMethod
 Enabled=True
 SubConfig=
 IMRegisterMethod=ConfigFile
 LoadLocal=True
<br>
さらに、/usr/share/fcitx5/inputmethod/mozc.confファイルを、以下の内容で作成する。<br>
 [InputMethod]
 UniqueName=mozc
 Name=Mozc
 IconName=/usr/share/fcitx5/mozc/icon/mozc.png
 Priority=1
 LangCode=ja
 Parent=fcitx-mozc
<br>
/usr/share/fcitx/mozcディレクトリを/usr/share/fcitx5ディレクトリにコピーする。<br>
 sudo cp -rf /usr/share/fcitx/mozc/ /usr/share/fcitx5/
<br>
Mobianを再起動する。<br>
 sudo shutdown -r now
<br>
再起動後、Fcitx5を有効にする。<br>
有効にするには、ターミナルで以下のコマンドを実行する。(~/.profileファイルに、以下のコマンドを記述してもよい)<br>
<u>この時、エラーメッセージが出力されて処理が止まるが、気にせずに[Ctrl] + [C]キーを同時押下する。</u><br>
 fcitx -r
<br>
日本語入力と英語入力の切り替えは、PCと同様に、[Ctrl] + [Space]キーを同時押下することで切り替えができる。<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>

__FORCETOC__
[[カテゴリ:PinePhone]]