Non-development related questions and troubleshooting belong here: [Q&T][ROM] CyanogenMod 10.1 and 10.2
Contents
This Post: Instructions and information - Please read all of this post before installing CyanogenMod!
Post 2 - Restoring a non-functioning radio
Post 3 - Frequently asked questions and workarounds for common problems
Introduction
This is CyanogenMod 10.1 (cm-10.1) for the HTC Droid Incredible 4G LTE (fireball) based on Android 4.2.2. Usage of this ROM indicates that you understand...
- the warranty on your device is void;
- the developer(s) are not responsible for any damages that may occur to your device as a result of using this ROM;
- there is a significantly higher chance that your device will eat your cat (for which the developer will not take responsibility).
Preparations and Installation
Get your phone ready for a new ROM
- You must have an unlocked bootloader or be S-OFF (read here for instructions)
- Before leaving your stock based ROM, turn on all GPS location services:
Settings > Location > (all three location services) = On - Backup the contents of your internal sd card. You can ignore these files/folders: ext_sd, battery_history.txt, .android_secure
- Install a custom recovery: CWM or TWRP
- Make a backup of your current ROM in recovery - DO THIS!
- Perform the factory reset function in recovery and wipe the /system partition
- Flash the CyanogenMod zip and optionally flash the GApps version corresponding to CM 10.1.x
- If you are S-OFF, you're done; reboot and enjoy
- If you are only unlocked, and not S-OFF, you will need to flash the boot image through fastboot. Extract boot.img from the zip file and place it in the same directory as your fastboot and adb executables. While still in recovery, execute these commands:
Code:adb reboot-bootloader fastboot flash boot boot.img fastboot reboot
Updating to a new build
- Make a backup of your current build in recovery
- Install the new build
- If you are S-OFF, reboot
If you are not S-OFF, reboot to the bootloader and flash boot.img using fastboot (extract it from the CyanogenMod zip)
Special notes about connecting to Verizon's network
Getting the RIL to play nicely with Verizon is tricky. The following quirks should be noted:
- Waiting for network...: If you install gapps, the phone might seem to hang at "Waiting for network... Activation can take a few minutes" on the first boot. This takes a long time to timeout (maybe 3-5min). When it eventually fails, choose the SKIP option. Do not choose restart or the cycle will repeat. This is a one-time inconvenience that should not reappear on subsequent reboots.
- SIM card added: the first couple times you boot the phone you may get a notice, "SIM card added". Do not hit restart, just hit the back button and the notice will go away.
- Borked radio: in the rare event that your radio refuses to make a connection, your radio's nv may have stored some bad settings. If restoring the backup of your previous ROM does not restore the radio to working condition, then see Post 2 for instructions on how to get the radio working again.
Official Downloads
Official builds are available at download.cyanogenmod.org/?device=fireball
Archive of older official nightlies: goo.im/devs/cm/fireball/nightly
If your display flickers noticeably after an hour or so of usage, discontinue use of these official releases (see below for unofficial releases that do not exhibit this issue). This issue affects about half of the fireball user base (rough estimate based on forum replies). These builds use linux kernel 3.4 which was never released by HTC for the fireball, so the board files are assembled as best possible with what little we have for reference. If your device suffers from this problem, you may notice the flickering persists for a few hours after restoring another ROM, but it should eventually subside. The developer(s) are not responsible for damaged devices as a result of running these builds. Stick with a stock-based ROM if you're uncomfortable with this.
Unofficial Builds
These builds are not endorsed by CyanogenMod. They are my personal builds.
Most recent builds: goo.im
Archive/Mirror: mediafire.com
goo.im folder structure: visit the page to read release-specific notes
- mdm-releases - Recommended for users that have flickering panels on official builds. Based on CM 10.1.2 stable using linux kernel 3.0
- kernels - Enhanced kernels for use only in CM
- cm-10.1 - CM 10.1 builds that incorporate experimental patches being considered for inclusion in official CM releases
- cm-10.2 - CM 10.2 builds that incorporate experimental patches being considered for inclusion in official CM releases
GApps
Download the GApps version corresponding to CyanogenMod 10.1.x
Reporting Issues and Getting Help
Policy on bug reports:
- You must reproduce the issue in a clean state. i.e. install cm after wiping /data, /cache, and /system
- logcat or GTFO
How to gather helpful data for troubleshooting
How to use the issue tracker
Getting help
There is an IRC chat room on freenode.net where you can speak with other HTC s4 and m7 users: #cm-htc. A device maintainer is usually present as well. For reference, the fireball is an s4 device in the same league as jewel (EVO 4G LTE), ville (One S), and evita (One XL), and these are all based on the Qualcomm Snapdragon S4 Plus MSM8960 processor. The various HTC One models for different carriers fall under the m7 name and use a similar but more advanced processor, the Qualcomm Snapdragon S4 Pro APQ8064. The device maintainers on s4 phones are: jewel=deck, evita=h8rift/rohan32, ville=intervigil, fireball=mdmower.
Change Log
CyanogenMod BBQLog
fireball-specific changes:
- 20130725 - fix blank MMS messages from iPhone 5 users
- 20130723 - fix low in-call volume and raise speaker volume max
- 20130721 - fix signal strength reporting zero on some GSM networks
- 20130715 - fix front facing camera face detect crash, fix dim screen on wake
- 20130628 - wake-on-volume fixed
- 20130622 - camcorder can now record in all resolutions
- 20130619 - finishing touches to battery parameters; charging should properly reach 100% now
- 20130618a - stereo audio fixed
- 20130618 - fix charging and battery level indicator
- 20130616 - kernel 3.4 introduced, updated adreno driver blobs from Qualcomm
---- break all teh things ----- 20130504 - wake-on-volume fixed; flash and shutter synchronized better in camera
- 20130424 - encryption of /data partition is now supported, read post 3 for instructions!
- 20130306 - fix for selecting bands crashes com.android.phone, SMS/MMS behavior changes
- 20130303 - camcorder video focus improvements (still loses focus, but should be better)
- 20130226 - all resolutions save without restarting camcorder application
- 20130223 - all resolutions available in camcorder (with quirks)
- 20130221 - secure adb, experimental microphone noise suppression fix (amluto)
- 20130217 - camcorder saves videos correctly
- 20130209 - gooManager OTA support, camera focus fixed, notification led fixed
- 20130207 - fixed audio applications freezing phone, sending mms messages should not return invalid destination, battery charging LED can be disabled
- 20130204 - removed non-effective VZW APNs, enabled MTP support
- 20130131 - experimental VZW APN configuration
- 20130128 - initial Release
Known Issues
Official Builds
- Display flickers and gets worse the longer the phone is on (may not occur depending on specific panel in your phone) - if you experience this issue, discontinue use of the CyanogenMod nightlies until the bug is fixed
- Screen-on delay is long
- Audio pauses briefly during screen on/off events
- High pitch background noise in camcorder recordings
- Touch to focus doesn't work
- Flash crashes camera application
- The first few times the phone boots there may be a "SIM card added" notice
Workaround in post 3
Unofficial MDM Builds
- Moving between 1x and LTE networks sometimes requires toggling airplane mode to get data working
- Camcorder does not stay focused
- Music lock-screen widgets sometimes flicker when you turn on the screen; the controls are still active though
- The first few times the phone boots there may be a "SIM card added" notice - Workaround in post 3
Known Issues that will not be fixed
- OTG mounting of USB sticks - Likely no hardware support
- FM Radio - Likely no hardware support
- MicroSD does not show as a mass storage drive when connected to the computer - UMS was deprecated in Android 3.x
Workaround in post 3
Development Information
CyanogenMod 10.1 builds using linux kernel 3.0 were becoming very stable before DxO Labs made a DMCA take-down request on a camera auto-focus library: libDxOAF.so. CyanogenMod had to pull official support for this device until builds could be offered that do not include this library. Kernel 3.4 no longer depends on the auto-focus routines in that library, so development efforts have gone into getting evita, fireball, jewel, and ville running well on it. Official nightlies are currently available for fireball, based on kernel 3.4, but there are a number of issues to be resolved (see above). Since HTC has not released an official jellybean ROM for this phone, there is no recent kernel source that could provide hints about how to fix these issues. If you have kernel development experience, your help would be greatly appreciated in fixing up the board files: android_kernel_htc_msm8960/arch/arm/mach-msm/htc.
The following trees are needed to build CyanogenMod 10.1 based on kernel 3.4:
- CyanogenMod/android_device_htc_fireball
- CyanogenMod/android_device_htc_s4-common
- CyanogenMod/android_device_htc_msm8960-common
- CyanogenMod/android_kernel_htc_msm8960
The following trees are needed to build unofficial CyanogenMod 10.1.2 based on kernel 3.0 (a.k.a. mdm-releases):
- mdmower/android_device_htc_fireball - branch cm-10.1-FbR
- mdmower/android_device_htc_msm8960-common - branch cm-10.1-FbR
- mdmower/android_kernel_htc_msm8960 - branch cm-10.1-FbR
- mdmower/android_frameworks_base - branch cm-10.1-FbR
- mdmower/android_frameworks_opt_telephony - branch cm-10.1-FbR
- mdmower/android_apps_Settings - branch cm-10.1-FbR
Credits
The task of bringing CyanogenMod to the HTC Droid Incredible 4G LTE was not a one man effort. I'm indebted to
- htc-msm8960-devs: a talented group of developers with lots of patience while I was learning
- utkanos, KemoNine, and Jin^eLD for general building questions
- jose51197, Linch89, and blazingwolf for early testing reports
- squeezyb for selling his fireball at a discount so I can share it with other developers
Attachments
Last edited: