===============================================
HTC Butterfly Kernel for X920d-nized KDDI HTL21
    By Backspace Dev-Team: http://backspace.jp/
===============================================

すべての説明は日本語です。 | All directions in Japanese.
結果について無保証・免責です。 | This program contributed by *AS IS*.


* WHAT IS THIS

KDDI HTL21をS-OFFし、SuperCID化を行い、mmcblk0p5に含まれるデバイス属性を
UB1へ書き換え、HTC Butterfly X920dのラジオとシステムを書き込んだ端末の
ためのカスタムカーネルです。
システムソフトウェア1.18.709.3とラジオベースバンド3A.24.306.14_10.12.1060.10L
にて検証を行っており、以下の機能を含みます。

* FEATURES

主な追加機能は以下のとおりです。

- BackキーからHomeキーをなぞってスリープ解除する "sweep2wake" 機能
  (別途 "Kernel Tuner" などで有効化が必要)
- カーネルレベルでのFeliCa/NFC/ワンセグ/3点ドック端子の有効化
  (別途フレームワークやソフトウェアでのサポートが必要)
- LCD輝度のより幅広いサポート
  (デフォルトでの30%~100%を8%~100%へ変更)
- LCD駆動レートの低下
  (省電力化のため60fpsから50fpsへ変更、1割程度のバッテリー駆動時間増加)
- ラジオ、カメラ等のパラメータを特定ハードウェアに合わせて調整
  (HTL21とX920dで搭載品が一部異なるため)


現在、非サポートとなる機能は以下のとおりです。

- IrDAの有効化
  (設定を有効にしたカーネルでは、現段階で起動できないため)


* AND WE NEED...

カーネル側で有効にしている各々の機能について、それぞれフレームワークや
ソフトウェアによる追加のサポートが必要です。

- おサイフケータイ/NFC/ワンセグを動作させるためのフレームワーク移植


* PREBUILT

カーネルをビルドするために、以下のようにしてAndroidのプレビルト環境を
構築する必要があります(下記はLinux, Mac OSの場合)。

~$ git clone https://android.googlesource.com/platform/prebuilt
~$ export CCOMPILER=~/prebuilt/linux-x86/toolchain/arm-eabi-4.4.3/bin/arm-eabi-


* GIT CLONE

gitの初期設定を行い、GitHubからソースファイル一式を取得します。

~$ mkdir src
~$ mkdir src/x920d-jp
~$ cd src/x920d-jp
~/src/x920d-jp$ git init
~/src/x920d-jp$ git clone git://github.com/Backspace-Dev/x920d-jp.git ./


* BUILD

カーネルビルドのための初期設定を行い、カーネルをビルドします。

~/src/x920d-jp$ make ARCH=arm CROSS_COMPILE=$CCOMPILER deluxe_ub1_defconfig
~/src/x920d-jp$ make ARCH=arm CROSS_COMPILE=$CCOMPILER -j2


"-j2" 部分に関しては、お使いのPCのCPUコア数に合わせて調整してください。
たとえば4コアであれば "-j4" です。


* TEST

ビルドが成功した場合に、生成されたカーネルで起動できるかは以下のように
してテストすることができます。

~/src/x920d-jp$ adb reboot bootloader
~/src/x920d-jp$ fastboot boot arch/arm/boot/zImage


* HOW TO USE

カーネルが正しく生成された場合、以下のようにしてカーネルとモジュールを
端末側へ書き込み、新しい環境で起動させることができます。

~/src/x920d-jp$ adb remount
~/src/x920d-jp$ adb push ./drivers/input/evbug.ko system/lib/modules/
~/src/x920d-jp$ adb push ./drivers/crypto/msm/qcedev.ko system/lib/modules/
~/src/x920d-jp$ adb push ./drivers/crypto/msm/qcrypto.ko system/lib/modules/
~/src/x920d-jp$ adb push ./drivers/crypto/msm/qce40.ko system/lib/modules/
~/src/x920d-jp$ adb push ./drivers/misc/eeprom/eeprom_93cx6.ko system/lib/modules/
~/src/x920d-jp$ adb push ./drivers/spi/spidev.ko system/lib/modules/
~/src/x920d-jp$ adb push ./drivers/scsi/scsi_wait_scan.ko system/lib/modules/
~/src/x920d-jp$ adb push ./drivers/video/backlight/lcd.ko system/lib/modules/
~/src/x920d-jp$ adb push ./drivers/bluetooth/bluetooth-power.ko system/lib/modules/
~/src/x920d-jp$ adb push ./drivers/net/ethernet/micrel/ks8851.ko system/lib/modules/
~/src/x920d-jp$ adb push ./drivers/net/wireless/bcmdhd_4334/bcmdhd.ko system/lib/modules/
~/src/x920d-jp$ adb push ./drivers/media/video/gspca/gspca_main.ko system/lib/modules/
~/src/x920d-jp$ adb push ./crypto/ansi_cprng.ko system/lib/modules/
~/src/x920d-jp$ adb push ./arch/arm/mach-msm/msm-buspm-dev.ko system/lib/modules/
~/src/x920d-jp$ adb push ./arch/arm/mach-msm/reset_modem.ko system/lib/modules/
~/src/x920d-jp$ adb push ./block/test-iosched.ko system/lib/modules/
~/src/x920d-jp$ adb shell chmod 0644 system/lib/modules/*
~/src/x920d-jp$ adb reboot-bootloader

~/src/x920d-jp$ fastboot flash zimage arch/arm/boot/zImage
~/src/x920d-jp$ fastboot erase cache
~/src/x920d-jp$ fastboot reboot


* HOW TO CONTRIBUTE

新しい環境を更に発展させたときは、Backspace Dev-Teamへお知らせください。
GitHubでのpull requestや、サポートを追加した新しいフレームワークのコミット
をお待ちしています。

Welcome to the hacked world,

--
Backspace Dev-Team <[email protected]>