AYANEO GeekにChimeraOSをインストールする

## 概要
この記事は[Reddit](https://www.reddit.com/r/ayaneo/comments/12fvwbn/aya_neo_2_chimera_os_guide/)を自分なりにまとめたものです。

ChimeraOSはSteam OSをカスタムしたものらしく、Steam Deck以外でも動作するOSらしい。
違いはよくわからないけど、AYANEO Geekでは指紋認証以外動作した。

## 必要なもの

- インストール作業用
  - マウス、キーボードを接続するためのType-Cハブ
    - 有線LANのポートがついているとOSインストールが早い
    - HDMIポートがついていると作業が楽
  - 8GB以上のUSBメモリ(OSインストール用)
- バックアップ用
  - 250GB以上の外付けSSD(バックアップ用)
  - 8GB以上のUSBメモリ(回復OSの起動用)

## インストール手順

省電力やバッテリー制御をするためにはOSのインストール後に作業が必要です。
LinuxのCUIを操作したことがない場合、難しく感じるかもしれません。

### バックアップ

何かしらの方法でバックアップを取る
筆者はAOMEI Backupperを利用して外付けSSDにバックアップを作成した

Redditでは"Macrium Home Free"を利用しているらしい
回復用OSの起動用USBメモリも作成できるみたい

### ChimeraOSの準備

1. <https://chimeraos.org>に移動
1. Downloadをクリック
1. 画面遷移後に再度Downloadを押す
1. "ChimeraOS-20XX.XX.XX-x86-64.iso"を保存する
1. "Balena Etcher Portable"を<https://www.balena.io/etcher#download-etcher>からダウンロードする
1. OSインストール用のUSBメモリをPCに刺す
1. "Balena Etcher"を起動する
1. USBメモリにOSを書き込む
    1. "Flash from file"を押す
    1. "ChimeraOS-20XX.XX.XX-x86-64.iso"を選択する
    1. "Select target"からUSBメモリを選ぶ
    1. "Flash !"を押して書き込む

### ChimeraOSをインストール

1. AYANEO Geekの電源を落とす
1. AYANEO GeekにType-Cハブを接続する
    1. マウスとキーボードを接続する
    1. **オプション:** 有線LANを接続する
    1. **オプション:** HDMIを接続する
        HDMIがない場合は本体を縦にする覚悟を持ってください
1. AYANEO GeekにOSインストール用のUSBメモリを接続する
1. LCボタンと音量+を押したまま電源をオンにする
    Note1: Bootメニューが出るまでLCボタンと音量+は離さない
    Note2: キーボードのF7でもよい
1. BootメニューからUSBメモリを選択する
1. "Install ChimeraOS" / "Reboot...etc"と表示されるので"Install ChimeraOS"を選択する
1. 有線LANを接続していない場合、Wi-Fiの設定をする
1. OSのインストール先を選択する
    お試しで外付けSSDにインストールするのもあり
1. 15分ほどインストールに時間がかかる
1. インストールが完了すると再起動される
1. ChimeraOS(SteamDeck)の初回セットアップを実行する
1. セットアップ完了後、USBメモリを外す

### デスクトップモードの説明

1. ホーム画面でBボタンを押して左メニューを表示する
1. 電源からデスクトップに切り替えを選択する
    初めてデスクトップにするときは1分ほど待ち時間がある
1. 画面が切り替わったあと画面下に3x3ドットのメニューボタンがある
    1. 青いゲームアイコンを押すとSteamのインターフェースに戻ります
    1. SteamアイコンをクリックするとウィンドウモードでSteamインターフェースが開きます
    1. フォルダー内にコンソールアプリがあります
        CUIはこのアプリを使用する

### デスクトップの設定

1. 外部ディスプレイに接続する
    しないとディスプレイ設定ができない(かも)
1. 画面下の3x3ドットのメニューボタンを押す
1. Settingsを選択する
1. Displayを選ぶ
1. ①Built-in displayを選ぶ
1. "Orientation"から"Portrait Left"を選ぶ
1. 画面に表示された"Keep Changes"を押す
1. 画面左上のActivitiesを押す
1. 画面下のSoftwareを選択する
1. 左上の検索マークからfirefoxを検索する
1. 検索結果からfirefoxを選択する
1. installを押す

### TDP制御を有効化

V41 Stableとそれ以前では、この手順が必要です

1. 画面左上のActivitiesを押す
1. 画面下の3x3ドットのメニューボタンを押す
1. 一番右のフォルダの中にあるconsoleを選択する
1. consoleにコマンドを入力し、Enterで実行する
    1. `git clone https://github.com/ruineka/chimeraos-hack-tools.git`
    1. `cd chimeraos-hack-tools/hacks`
    1. `sudo ./chimeraos-enable-amdpstate.sh`
        パスワードの初期値は`gamer`
1. Steam Deck UIに戻る
    1. 画面左上のActivitiesを押す
    1. Game Modeを選択する
1. Bボタンを押して左メニューを表示する
1. 電源から再起動を選択する
1. 再起動後、デスクトップモードを表示する
1. consoleを起動する
1. consoleにコマンドを入力する
    `cat /sys/devices/system/cpu/cpu0/cpufreq/scaling_driver`
1. `amd-pstate`と結果が帰ってくれば成功している
1. それ以外の場合手順を最初からやり直す必要がある

### DeckyLoaderをインストール

1. consoleにコマンドを入力する
    1. `curl -L https://github.com/SteamDeckHomebrew/decky-installer/releases/latest/download/install_release.sh | sh`
        コマンドを実行した際にパスワードかY(yes)を入力する必要がある
    1. `reboot`
1. 再起動後、左メニューを表示する
1. 電源から再起動を選択する
1. AYAボタンの右側を押すと右メニューを表示できます
    インストールが成功していれば、メニューの一番下にプラグのアイコンが表示されている
1. プラグアイコンを選択して左上の設定を開きます
1. Deckyの設定を変更します
    1. Decky Update ChannelをStableに変更
    1. Plugin Store ChannelをTestingに変更
    1. Enable Developer Modeをオフにする
1. Bボタンを何度か押してホームに戻る

### PowerControlをインストール

1. デスクトップモードに変更する
1. consoleを起動する
    1. `curl -OL https://github.com/oliverchang/PowerControl/releases/download/v0.0.4/PowerControl.tar.gz`
    1. `sudo su`
        パスワードのデフォルトは`gamer`
    1. `tar -xvzf PowerControl.tar.gz -C homebrew/plugins/ --overwrite`
    1. `rm -r PowerControl.tar.gz`
    1. `shutdown -r -t 0`
        1分後に再起動される
1. 再起動後、AYAボタンの右側を押して右メニューを表示する
1. 一番下のプラグアイコンを選択する
    PowerControlが表示されていればインストールは成功している
1. PowerControlを選択するとCPUブースト、SMT、コア数、ワット単位の熱出力、およびGPU周波数を変更できるようになります
1. USBの周辺機器を外してゲームをインストールする

### デフォルトのパスワードを変更

1. デスクトップモードに変更する
1. Settingsアプリを開く
1. Users->Passwordからパスワードを変更する

### LED設定を変更

1. デスクトップモードからconsoleを開く
    1. `sudo frzr-unlock`
    1. `wget https://github.com/Maccraft123/ayaled/releases/download/0.3.0/ayaled-0.3.0-1-x86_64.pkg.tar.zst`
    1. `sudo pacman -U ayaled-0.3.0-1-x86_64.pkg.tar.zst`
        プロンプトが表示された場合は`Y`を入力する
    1. `rm ayaled-0.3.0-1-x86_64.pkg.tar.zst`
    1. `sudo systemctl start ayaled`
    1. これ以降は[ここ](https://github.com/Maccraft123/ayaled)を参照する
    1. `sudo systemctl enable ayaled`
    1. `reboot`