Fairphone 6の広角カメラの実験的なLinuxサポート
Fairphone 6 wide camera experimental Linux support (nondescriptpointer.com)
要約
Fairphone 6の超広角カメラがGNOME Snapshotで動作するようになったことが報告されています。これは、メインラインLinuxおよびpostmarketOSコミュニティにとって重要な進展であり、Fairphone 6の比較的新しいハードウェアと、開発を推進するFairphone社のサポートが、この成果に貢献しています。今後は、オーディオと他のカメラサポートが課題となります。
全文翻訳
Fairphone 6 広角カメラの実験的なLinuxサポート
公開日: 2026年7月21日
[動画: Fairphone 6 超広角カメラがGNOME Snapshotで動作している様子]
背景
Fairphone 6 は、いくつかの理由からメインラインLinuxおよびpostmarketOSにとって興味深いターゲットとなっています。
- 他の多くのpostmarketOS対応デバイスと比較して、比較的新しいハードウェアを搭載しています。
- FairphoneはメインラインLinuxサポートに投資しており、Luca Weiss氏が開発の多くを主導しています。
- これらの取り組みにより、ハードウェアの初期サポートはすでに有望なものとなっています。
- Fairphoneは意図的に代替オペレーティングシステムの利用を許可しています。
- Fairphoneはデバイスを長期間サポートすることを目指しており、将来的な作業のための安定した基盤を提供できる可能性があります。
デバイスを一般的に使用可能にするための主なブロッカーは、オンボードオーディオとカメラサポートの2つです。私はQRスキャンを必要とするプロジェクトに取り組んでおり、その機会を利用して少なくとも1つのカメラを動作させられるか確認しました。免責事項:この作業の実現には、LLM(大規模言語モデル)の支援に大きく依存しました。
Fairphone 6のカメラ
Fairphone 6には3つのカメラが搭載されています。
- リア: Sony IMX896
- フロント: Samsung S5KKD1
- ワイド: OmniVision OV13B10
SonyとSamsungのセンサーにはメインラインLinuxドライバーがありませんが、OmniVision OV13B10にはメインラインドライバーが存在します。超広角カメラはQRスキャンには十分です。
スマートフォンのカメラは単一のデバイスではありません。Qualcomm SoCでは、キャプチャパスは以下のチェーンで構成されます。
イメージセンサー → CSI-2 D-PHY → CSIPHY → CSID → ISP (VFE/TFE) → メモリ
(I2C) (MIPIレーン) (デコード) (デマルチプレクサ) (ライトエンジン) (DMA)
これに加えて、カメラクロックコントローラー(camcc)、CCI(Qualcomm専用カメラI2Cコントローラー)、電源レール、オートフォーカス用のVCM(ボイスコイルモーター)など、いくつかのサポートコンポーネントがあります。
ダウンストリームのベンダーAndroidカーネルは、Qualcommの大きくてプロプライエタリなCAMX/cam-kernelスタックを使用してこれらすべてを駆動します。メインラインでは、同等のものがより小規模なqcom-camssドライバーであり、libcameraがユーザー空間統合と画像処理を提供します。
OmniVisionカメラを動作させるには、qcom-camssにSoC固有のブロックについて教え、デバイスツリーでハードウェアを記述し、センサードライバーを有効にし、libcameraを設定して生のBayerフレームをアプリケーションが使用できる画像に変換する必要がありました。
初期調査
実装を開始する前に、作業のどの程度が新規で、どの程度をメインラインがすでにサポートしているハードウェアから移植できるかを把握したいと考えました。これにより、メーカーのサポートなしでプロジェクトが実現可能かどうかを確認できます。
初期調査は有望でした。
- FP6のSoCはQualcomm milos (SM7635) です。ダウンストリームボードのコードネームはvolcanoで、postmarketOSはすでにメインラインベースのカーネルフォークでこれを起動しています。
- カメラハードウェアブロックは、TFE665(薄型フロントエンドISP)、CSID665、およびCSIPHY v2.2.1です。
- camccクロックコントローラーとCCIは、カーネルフォークにすでに存在しています。
- 3つのカメラは以下の通りです。
- メイン: Sony IMX896、メインラインドライバーなし。
- 超広角: OmniVision OV13B10、ACPI/x86のみをサポートするメインラインドライバーが存在。
- フロント: Samsung S5KKD1、メインラインドライバーなし。
これにより、ターゲットが明確になりました:OV13B10超広角です。これは13MPセンサーで、既存のメインラインドライバーがあり、その広視野角はQRスキャンに適しています。
ダウンストリームのレジスタヘッダー(cam_tfe665.h、cam_csiphy_2_2_1_hwreg.h、cam_tfe_bus.c)とメインラインのqcom-camssを比較したところ、TFE665は基本的にメインラインがすでにサポートしているTFE530と同じIPであることがわかりました。レジスタレイアウトは同一です。内部ブロックのベースオフセットのみが異なり、ライトバスが異なるアドレスに配置されています。同様に、CSID665 RDIレジスタはサポートされているCSIDと一致し、CSIPHY v2.2.1は同じ3相PHYファミリーに属します。
これは、すべてをゼロから書くのではなく、既存のドライバーを移植できることを意味しました。
ステップ1:キャプチャサブシステムをカーネルに移植する
milosにはまだqcom-camssが利用できなかったため、既存のコンポーネントを接続する必要がありました。
TFE665 ISPドライバー
メインラインのTFE530ドライバー(camss-vfe-340.c)を直接モデルにした新しいcamss-vfe-665.cを追加しました。レジスタの内容は同一であるため、ドライバーロジックは同じです。主な違いは、milosがISP制御ブロックとライトバスブロックを異なるオフセットに配置していることです。バスレジスタのベースは0xa00から0x1800に移動し、このオフセットシフトをカプセル化することが作業の大部分を占めました。
CSID665およびCSIPHY v2.2.1
- CSID665は、RDIレジスタオフセットが同一であったため、既存のgen-2 CSID操作を再利用しました。
- CSIPHY v2.2.1には、このリビジョン用の新しいレーン構成テーブルとD-PHYチューニング値が必要でした。ダウンストリームの
cam_csiphy_2_2_1_hwreg.hからレーンレジスタシーケンスと約1.1 Gbps/レーン(「500 Msps」)のデータレートおよびAFE設定を転記しました。PHYのレジスタウィンドウはオフセット0x1000にありました。
リソース、互換性、およびデバイスツリー
camss.cで、milosのキャプチャコンプレックス(4つのCSIPHY、3つのCSID、3つのTFE、それらのクロック、インターコネクト、パワー ドメイン)を記述しました。また、新しいqcom,milos-camss互換性を登録しました。デバイスツリーでは、レジスタ、IRQ、クロック、インターコネクト、IOMMU、GDSC、CSI入力ポート、およびMCLKとリセットのピンコントロール状態を持つcamss@ac13000ノードを追加しました。
不足していたレジスタバスクロック
この時点で問題に遭遇しました。ドライバーはバインドされましたが、TFEハードウェアバージョンレジスタの読み取りは0x0を返し、ブロックに電源が入っていないかのようにリセットがタイムアウトしました。修正したのは、ISPクロックとは明白ではなかったクロック:CAM_CC_SOC_AHB_CLKでした。これは、CCIを含むカメラコンプレックス全体が使用するAHBレジスタバスをゲートしていました。これがなければ、レジスタアクセスはサイレントにゼロを返していました。このクロックとCAMNOC AXIクロックを追加し、CAMNOCデータパスクロックレートを設定しました。ISPはhw_version = 0x30000000で起動しました。
これは、Qualcommハードウェアでは、ゼロと読み取られるブロックは、そのアクセスパス上のクロックまたはパワー ドメインが欠落している可能性があることを示唆しています。
ステップ2:OV13B10センサーの起動
メインラインのov13b10ドライバーは存在しますが、x86/ACPIラップトップ用に書かれており、ACPI経由でのみマッチします。2つの箇所を変更しました。
ドライバーをARMおよびデバイスツリーで利用可能にする
- デバイスツリーからドライバーがプローブできるように、OpenFirmwareマッチテーブル(
ovti,ov13b10)を追加しました。 milos-fairphone-fp6.dtsでセンサーを記述しました。センサーはCCI I2Cバスの0x36アドレスにあり、MCLK1 19.2 MHz、リセットGPIO、および電源レールが必要です。この実験的な起動のために、レギュレーターを完全にシーケンスする代わりに、単純にオンになるように強制しました。
2つの小さな詳細
- レーン番号付け。 ダウンストリームデバイスツリーは
data-lanes = <1 2 3 4>を使用していましたが、メインラインの規約はゼロベースです:<0 1 2 3>。番号付けが間違っていたため、CSIPHYはレーン0が欠落したレーンマスクをプログラムし、PHYはロックしませんでした。 - どのCSIPHYか? FP6の配線は、超広角カメラをCSIPHY1にルーティングしていました。これを推測するのではなく、ダウンストリームデバイスツリーから取得したことで、多くの試行錯誤が省けました。
この時点で、センサーは正常にプローブされ、チップIDはI2C経由で正しく読み取られ、CSIPHYはレーンアクティビティを報告し、ISPは完全に黒いフレームを生成しました。
ステップ3:すべてのピクセルがゼロのフレームの謎
これが主なバグでした。フレームは正しいレートとサイズで到着し、buf_doneが発火しましたが、すべてのピクセルがゼロでした。センサー内部で生成され、シーンに関係なく表示されるはずのカラーバーテストパターンを有効にしたときも同様でした。データパスはフレームタイミングを提供していましたが、ピクセルデータは提供していませんでした。
カーネルログが手がかりを提供しました:VFE0: Bad config violation。ISPのライトエンジンは、ライトマスターの設定が入ってくるデータと一致しなかったため、フレームごとにコンシューマー/コンフィギュレーション違反を報告しました。
ダウンストリームのcam_tfe_bus.cを詳しく調べると、違いが明らかになりました。RDIライトマスターのパッカーフォーマットは、ISPバス幅に依存します。
- TFE530(qcm2290、メインラインドライバーのターゲット)は64ビットRDIバスを持っているため、パッカー
0xaを使用します。 - TFE665(milos)は128ビットRDIバスを持っているため、パッカー
0x0が必要です。
メインラインドライバーは64ビット値をハードコードしていました。milosではそれは間違っており、ライトエンジンはピクセルを書き込むことを拒否しました。レジスタ値をPLAIN64 (0xa)から0x0に変更したことで、すべてのピクセルがゼロのフレームが実際の画像に変わり、最大ピクセル値は255になり、フルカラーバーパターンが表示され、違反が停止しました。
これがカメラが物理的に機能した時点でした:OV13B10 → CSIPHY → CSID → TFE665 → DDR、本物のBayerフレームを配信しました。
ステップ4:RAW Bayerからlibcameraへ
RAWフレームはQRスクリプトには十分でしたが、使用可能なカメラには、最新のLinuxカメラアプリケーションで使用されているユーザー空間フレームワークであるlibcameraが必要です。libcamera 0.7.2は、ジェネリックなsimpleパイプラインハンドラーを通じて、すでにmilos qcom-camssグラフを認識しています。そのソフトウェアISPは、EGL経由でAdreno上のGPUアクセラレーションを使用して、生のフレームをRGBにデベイヤーし、すぐに約30fpsで動作しました。camおよびGStreamerのlibcamerasrcは、すぐにクリーンな画像を生成しました。
自動露出は動作しなかった部分でした。画像は暗すぎたり明るすぎたりし、ログにはFailed to create camera sensor helper for ov13b10と報告されました。libcameraのソフトウェア自動露出およびゲインループには、センサーのゲインレジスタ値を実際のゲイン乗数にマッピングするための、センサーごとの小さなヘルパーが必要でした。libcameraにはいくつかのセンサー用のヘルパーが含まれていますが、このセンサー用はありませんでした。
修正は小さかったです。OV13B10のアナログゲインは線形であり、0x80 = 1×、つまりgain = code / 128という動作は、他のいくつかのOmniVisionセンサーと同じです。libcameraのセンサーヘルパーデータベースにクラスを追加しました。
class CameraSensorHelperOv13b10 : public CameraSensorHelper {
public:
CameraSensorHelperOv13b10() { gain_ = AnalogueGainLinear{ 1, 0, 0, 128 }; }
};
REGISTER_CAMERA_SENSOR_HELPER("ov13b10", CameraSensorHelperOv13b10)
自動露出ループはすぐに収束し始めました。libcameraのセンサープロパティデータベースにエントリを追加し、センサードライバーのV4L2クロップおよびget_selectionサポート(libcameraがピクセルアレイジオメトリに使用)をバックポートしました。その後、GStreamerとPipeWireは適切に露出されたフィードを受け取りました。PipeWireのlibcameraプラグインをインストールすると、カメラはデスクトップアプリケーションに通常のビデオソースとして表示されました。
状況によっては画像がまだやや過露出になるため、ヘルパーはさらに作業が必要になる可能性があります。
ステップ5:フォーカス、向き、および解像度の問題
まだ微調整が必要な問題がいくつかありました。
オートフォーカス
超広角カメラには、フォーカス用のボイスコイルモーター(VCM)があります。ダウンストリームデバイスツリーは、それがAwinic AW86017であることを示唆しています。GPIO駆動レギュレーターによって制御されるオートフォーカスレールに電源を供給し、CCI I2Cバスをプローブした後、標準的なDW9714 10ビットDACプロトコルを話すアドレス0x0cのデバイスを見つけました。メインラインのdw9714ドライバーがこれを直接駆動します。
フォーカススイープにより、レンズが物理的に移動し、中間設定でシャープネスが明確にピークに達することが確認されました。libcameraは、デバイスツリーのlens-focusリンクを通じてレンズをセンサーに関連付けました。
残念ながら、libcameraのソフトウェアISPにはオートフォーカスアルゴリズムがありません。レンズを無限遠に固定して近くのぼやけた画像を作成する代わりに、QRスキャンやドキュメントを腕の届く距離でスキャンするのに適した固定フォーカスを設定し、小さなudevルールを使用しました。設定は必要に応じて調整するか、ソフトウェアからフォーカスを制御できます。
向き
センサーは、電話の縦向きに対して角度をつけて取り付けられているため、プレビューは最初は横向きに表示されました。デバイスツリーの回転および向きプロパティを設定することで、libcamera対応アプリケーションがフィードを正立表示できるようになりました。
ビニングモード
OV13B10ドライバーは、半分の解像度の2×2ビニングモードを含むいくつかの解像度を広告していました。このCAMSSパスでは、ビニングモードは破損した、歪んだ出力を生成しました。それらの読み出しジオメトリは宣言されたフレームサイズと一致しませんでしたが、フル解像度およびその他のいくつかのモードはクリーンでした。
壊れたプレビューを出荷する代わりに、2つの壊れたモードを無効にしたため、libcameraは動作するモードのみを選択するようになりました。トレードオフとして、ソフトウェアISPはスケーリングではなくクロップするため、1080pプレビューはより大きなモードの中央クロップになります。これは、フル超広角視野角を表示するのではなく、わずかにズームインされています。結果として、GNOME Camera / Snapshotでライブで、正立、自動露出、フォーカスが合ったプレビューが得られ、QRスキャンも機能します。
ソース
これらの結果を再現するために必要なパッチと関連ファイルは、このリポジトリで入手できます。
github.com/nondescriptpointer/fairphone6-wide-camera-linux
制限事項
これは実験的な開始段階であり、本番環境のカメラサポートではありません。
- 超広角(OV13B10)のみが動作します。 メイン(IMX896)およびフロント(S5KKD1)センサーにはメインラインドライバーがありません。
- オートフォーカスはありません。 libcameraのソフトウェアISPにはコントラストAFループがないため、フォーカスは固定の妥協点にあります。適切なオートフォーカスには、ソフトウェアISPでのAFアルゴリズム、またはVCMを駆動するためのアプリ側ループが必要です。
- プレビューの視野角はクロップされます。一般的な解像度では、2×2ビニングセンサーモードがこのパスで破損しており、ソフトウェアISPがスケーリングではなくクロップするためです。ビニングモードのレジスタシーケンスを修正するか、スケーラーを追加することで、フル超広角視野角が復元されます。
- 電源シーケンスが簡略化されています。 レギュレーターはシーケンスされるのではなくオンに強制され、VCMは固定フォーカス位置に保持されている間、わずかなアイドル電流を消費します。これは実験には問題ありませんが、日常使用には適切な電源管理が必要です。
- ISPはソフトウェアのみです。 すべてのデベイヤー、自動露出、およびホワイトバランス処理はソフトウェアで行われ、GPU支援を受けます。QRスキャンやカジュアルな使用にはうまく機能しますが、調整されたハードウェアISPパイプラインの画質を提供するものではありません。
- 画質の最適化には時間をかけませんでした。 センサーからより良い写真を撮るためには、さらなる最適化が必要になる可能性が高いです。
次のステップ
- ビニングモードを修正して、フル視野角を復元する。
- 適切な電源シーケンスを作成する。
- アップストリームに準備できる部分を準備する。