設定 - PinePhoneキーボードのソースを表示

== 概要 ==
PinePhoneの専用キーボードの設定およびドライバのインストール方法を記載する。<br>
<br><br>

== 専用キーボードの取り付け ==
# PinePhoneの電源を落として、バックケースを取り外す。
# 専用キーボードを開いて、ヒンジを完全に伸ばした状態で、硬い表面に平らに置く。
# PinePhoneをキーボードに約15度傾けて挿入する。<br>この時、PinePhoneのPogoピンと専用キーボードの対応するパッドの位置が合っていることを確認する。
# PinePhoneを所定の位置にしっかりと押し込む。<br>この時、カチッという音がして固定される。
# PinePhoneは、バックケースにあるような切り欠きを使用して、専用キーボードから簡単に取り外すことができる。(電源ボタンや音量ボタンがある先端部の下部にある)
<br><br>

== 専用キーボードと内蔵電池の動作 ==
専用キーボードは、対応OSを搭載したPinePhoneを取り付けると自動的に機能する。<br>
物理的なレイアウトやファームウェアの変更については、それぞれ4.1節と5.1節を参照すること。<br>
<br>
専用キーボードには、6000[mAh]のバッテリーが内蔵されている。<br>
キーボードの右端にあるボタンを押下することにより、内蔵バッテリーのON / OFFが可能となる。<br>
ボタンを短く押下する場合は内蔵バッテリーが作動して、長く押下（15秒）する場合は内蔵バッテリーの動作が解除される。<br>
<br>
専用キーボードに対応しているLinuxディストリビューションでは、PinePhoneとキーボードの両方のバッテリーの状態が表示される。<br>
<br>
PinePhoneと専用キーボードの充電は、キーボードのUSB typeCポートを使用して行う必要がある。<br>
<br>
また、専用キーボードのUSB typeCポートは周辺機器には使用できないため、PinePhoneのUSB typeCポートを使用して周辺機器に使用する。<br>
<br><br>

== 専用キーボードのドライバのインストール ==
専用キーボードのドライバのインストールに必要なライブラリをインストールする。<br>
 # Mobian
 sudo apt install gputils gputils-common gputils-doc sdcc sdcc-doc sdcc-libraries \
          apache2 apache2-bin apache2-data apache2-utils libapache2-mod-php7.4 libapr1 libaprutil1 libaprutil1-dbd-sqlite3 libaprutil1-ldap \
          php php-common php7.4 php7.4-cli php7.4-common php7.4-json php7.4-opcache php7.4-readline ssl-cert
 
 # Manjaro
 # Manjaroにおいて、PinePhoneのキーボードドライバ(KB151)は標準でインストールされているため、インストールは不要である
 sudo pacman -S make gcc sdcc php
<br>
専用キーボードのドライバのGithubから、ソースコードをダウンロードする。<br>
 git clone -b master https://megous.com/git/pinephone-keyboard
 cd pinephone-keyboard
<br>
ドライバのMakeファイルを編集する。<br>
必要であれば、Makeファイルの下部にある$(OUT)ppkb-i2c-selftestのコメントを外す。<br>
 # 編集前
 all:$(OUT)ppkb-i2c-inputd $(OUT)ppkb-usb-flasher $(OUT)ppkb-usb-debugger $(OUT)fw-stock.bin $(OUT)ppkb-i2c-debugger $(OUT)ppkb-i2c-charger-ctl $(OUT)ppkb-i2c-flasher $(OUT)ppkb-i2c-selftest
 
 # 編集後
 all:$(OUT)ppkb-usb-flasher $(OUT)ppkb-usb-debugger $(OUT)fw-stock.bin $(OUT)ppkb-i2c-debugger $(OUT)ppkb-i2c-charger-ctl $(OUT)ppkb-i2c-flasher $(OUT)ppkb-i2c-inputd $(OUT)ppkb-i2c-selftest
<br>
専用キーボードのドライバをビルドおよびインストールする。<br>
<u>※インストールディレクトリの最後に<span style="color:#C00000">/(スラッシュ)</span>を必ず付加すること。</u><br>
 make -j $(nproc) OUT=/<専用キーボードのドライバのインストールディレクトリ>/ all
<br>
もし、ppkb-i2c-inputdがインストールされない場合は、以下のコマンドを実行する。<br>
<u>※同様に、インストールディレクトリの最後に<span style="color:#C00000">/(スラッシュ)</span>を必ず付加すること。</u><br>
 make -j $(nproc) OUT=/<専用キーボードのドライバのインストールディレクトリ>/ $(OUT)ppkb-i2c-inputd
<br><br>

== 専用キーボードの有効化 ==
Mobianの場合、専用キーボードを有効にする必要がある。<br>
 cd <専用キーボードのドライバのインストールディレクトリ>
 sudo ./ppkb-i2c-inputd
<br>
また、~/.config/autostartディレクトリに、専用キーボードを自動的に有効化するデスクトップエントリファイルを作成することを推奨する。<br>
 vi ~/.config/autostart/PPKeyBoardStart.desktop
<br>
 # ~/.config/autostart/PPKeyBoardStart.desktopファイル
 
 [Desktop Entry]
 Type=Application
 Name=Keyboard
 Icon=/<専用キーボードのドライバのインストールディレクトリ>/PPKeyBoardStart.png
 Exec=/<専用キーボードのドライバのインストールディレクトリ>/PPKeyBoardStart.sh
 Categories=Utility;
 NoDisplay=true
<br>
シェルスクリプトを作成する。<br>
 vi /<専用キーボードのドライバのインストールディレクトリ>/PPKeyBoardStart.sh
<br>
 <syntaxhighlight lang="bash">
 # /<専用キーボードのドライバのインストールディレクトリ>/PPKeyBoardStart.shファイル
 
 #!/usr/bin/env bash
 
 appname="ppkb-i2c-inputd"
 
 # use -f to make the readlink path absolute
 dirname="$(dirname -- "$(readlink -f -- "${0}")" )"
 
 if [ "$dirname" = "." ]; then
    dirname="$PWD/$dirname"
 fi
 
 cd $dirname
 
 # Run ppkb-i2c-inputd binary
 echo "<パスワード>" | sudo -S "$dirname/$appname"
 </syntaxhighlight>
<br>
シェルスクリプトに実行権限を付加する。<br>
 chmod u+x /<専用キーボードのドライバのインストールディレクトリ>/PPKeyBoardStart.sh
<br><br>

== スクリーンキーボードの有効化および無効化 ==
スクリーンキーボードが不要な場合は、以下のコマンドを実行する。<br>
 gsettings set org.gnome.desktop.a11y.applications screen-keyboard-enabled false
<br>
スクリーンキーボードが必要な場合は、以下のコマンドを実行する。<br>
 gsettings set org.gnome.desktop.a11y.applications screen-keyboard-enabled true
<br><br>

== 専用キーボードの充電 ==
PinePhoneの専用キーボードは、初期設定では500[mA]でPinePhoneを充電する。<br>
例えば、1500[mA]に変更するには、以下のように編集する。<br>
 su
 vi /sys/class/power_supply/axp20x-usb/input_current_limit
<br>
 # /sys/class/power_supply/axp20x-usb/input_current_limitファイル
 
 1500000
<br><br>

__FORCETOC__
[[カテゴリ:PinePhone]]