[RECOVERY] ClockworkMod BML Officially supported by ROM Manager for Epic 4G

309 posts
Thanks Meter: 564
By DRockstar, Retired Recognized Developer on 22nd November 2011, 06:10 AM
Post Reply Email Thread
OK guys, you have NO idea what it has taken to get to this point...

Welcome to the first officially supported ClockworkMod for the Epic 4G since cwm, I think it's been over a year now...

Changes since

* Backups are tar files by default, with the filesystem type noted in the filename. Backups automatically reformat to the backup filesystem before restore. This will work to restore rfs and ext4 setups. So, for example, if you're currently on rfs, but your backup was done while on the ext4 filesystem, the restore will reformat back to ext4 before restoring. Older backups done by cwm 3.x and ACS Recovery can be restored by this ClockworkMod version, and will not reformat before restoring older backups.

* This cwm is not meant for mtd partition layout / yaffs2 filesystem, that is another matter entirely, and mtd will require it's own cwm build and kernel, that will most likely be in the official CM repo when it's done.

* One "No" in confirmations, for all but factory wipe: Make a blank file called .one_confirm (that is a period in the beginning of the name), and place it in /sdcard/clockworkmod directory. This works right now with 3 finger boot from power off, but will be added to the next Clockwork Recovery update in ROM Manager. When that happens, then it will also work from the option Reboot into Recovery, when called from ROM Manager. This is now official, so that in the future, anyone with ClockworkMod 5.0.27+ will be able to benefit from this. Thanks to chris41g for this edit and push to the official source.

* Keycodes were fixed to work with the gingerbread kernel... and menu was fixed up a bit.
up = vol up, keypad up, keypad left
down = vol down, keypad down, keypad right
back = back cap key, power button, keypad backspace key
select = home cap key, keypad enter key, camera button
toggle display = keypad d key
reboot = power button 5 times, no matter where you are in the cwm menu

If your current kernel is a froyo kernel, then the cap keys will be reversed... We will have some growing pains, until everyone is on board with gingerbread, and the kernel devs start implementing the kernel mod described below, to change the mode of reboot recovery to go to bml8 recovery partition. If you are running gingerbread, then you can flash this prerelease:

This isn't exactly finished yet, but it's stable, and has voodoo sound, root, busybox, etc.

* DO NOT REPARTITION YOUR SDCARD WITH CLOCKWORKMOD. There are problems associated with this that I will detail later.

* I highly recommend flashing both the new recovery kernel and the ROM Manager update... pretty soon, ROM Manager will be able to flash our favorite ROMs, by downloading and flashing from ROM Manager.

At this time, I recommend flashing the new cwm over ACS Recovery. Testing has shown that backups done when the ROM Manager fakeflash is called through ACS Recovery, is that the backups won't be in the proper format... they will probably work, but not in the way the CWM 5 intends it too, with fs saved tar backups.
I know that some of you are avid fans of ACS Recovery, and I have nothing against that. In fact, it should be pretty easy for chris41g to make a new version if he so desires... and, he did contribute to the official source, which is something I truly appreciate In fact, I have been working with koush, to get some other of the most requested features, into the official cwm sources, so they can benefit everyone in android. One of the first new features to be put into the next cwm update in ROM Manager, is the ability to have only one "No" in the confirmations, if the file /sdcard/clockworkmod/.one_confirm is present. chris41g authored this for the cwm sources. Also, we have been given the go ahead to implement the inclusion of reboot into download mode from the main cwm menu in the official sources as well


Firstly, flash the new recovery with odin/clockworkmod.

Also, I'd recommend a known working kernel for the new recovery:
md5: 389f5b1745352326c9357c1252cd37b9

This isn't exactly finished yet, but it's stable, and has voodoo sound, root, busybox, etc.
Nubernel by nubecoder for gingerbread
other kernel devs feel free to link me to your posts!

Get ROM Manager from the market, and choose Flash ClockworkMod Recovery.
Choose the Samsung Epic4G.
It should then download, and you should see ClockworkMod version:
Now, whenever you use ROM Manager for anything, it will automatically load the latest supported ClockworkMod for the Epic.

DEVELOPERS: Please visit this forum thread, and learn all you need to know about getting your zips listed in ROM Manager, and the features available for you to use.
KERNEL DEVELOPERS: It is highly recommended at this time to use this commit, to change boot mode for reboot recovery to boot from bml8 recovery partition:

OK, here are the links:

cwm- tar flash for odin
cwm- mirror
md5: edd321a3aa2ba4c73f1d3612e9b19c05 zip flash for cwm
md5: 869baf2d6a52b5604764f70556c9482e


Flashing ClockworkMod Recovery Kernel:

Setting up ROM Manager for the Epic 4G:

Thanks goes to:
koush - Creator of ClockworkMod, and very good guy for his patience and willingness to listen to the needs of the Epic community, and the android community at large.
mkasick - help with C code to support rfs formatting in the official cwm sources.
chris41g - inclusion of code in official sources to permit one "no" in confirmations, if file /sdcard/clockworkmod/.one_confirm is present
The Following 153 Users Say Thank You to DRockstar For This Useful Post: [ View ] Gift DRockstar Ad-Free
22nd November 2011, 06:10 AM |#2  
OP Retired Recognized Developer
Flag Pasadena, CA
Thanks Meter: 564
Donate to Me

Yes, this time there are developer notes! I will be adding more over the next couple of days.

ClockworkMod Binary:
Epic4G device file sources:
ClockworkMod Recovery kernel sources:

I have put the branch trees in the URLs, since the masters could be subject to change in the future.


ClockworkMod version 5 now stores the backup filesystem in the name of the tar backup files. When I first submitted my device files to koush for ROM Manager support, it became clear that now ClockworkMod would have to support the formatting of rfs volumes for the restores to work properly. This took me a while, but thankfully with the generous advice of mkasick, I wrote the function and pushed to the official source:
To experienced C programmers, this is easy stuff, but hey, admittedly, I'm a very new to C programming, and I wanted to learn... and I wanted to get it as correct as possible the first time... so this took me a while


The important thing with a recovery kernel, is that it only needs to do one thing:
Load ClockworkMod, and anything ClockworkMod might need.

For this reason, there are minimal kernel modifications for the ClockworkMod Kernel. The following details, however, are worthy of note:
* This kernel supports kexec, as in the future, dual boot may become the norm.
* The boot mode for reboot recovery has been modified to reboot the bml8 recovery kernel, and not the boot kernel recovery.
* I left in the keypad timer patch by mkasick, since it really makes a difference in scrolling through the menus in ClockworkMod.
* The initramfs /sbin was modified to only have files needed for ClockworkMod, along with the following scripts and binaries that I often find useful:
bmlwrite - binary to flash kernels
bmlflash - script to flash boot or recovery kernels easily
bclean - script to clean all busybox files from /system
rclean - script to clean all busybox and root related files in /system


It is highly recommended at this time to use this commit, to change boot mode for reboot recovery to boot from bml8 recovery partition:


When I did ClockworkMod, I created a custom recovery, with some requested features. However, with time, it became apparent that having an official recovery with ROM Manager support was ultimately more favorable than having a custom one. Furthermore, with just a little effort and cooperation, the official source can be appended to include the most requested features. We're not the only ones asking for those features. I now believe that contributing to the official source benefits the entire community in the end, and not just one or two devices.

Along with my rfs formatting commit, I invited chris41g to contribute as well, and hence his following commit was also accepted, which allows only one "No" to appear in confirmations, when the blank file /sdcard/clockworkmod/.oneconfirm is detected:
Again, very simple here, but solves the most requested modification to ClockworkMod probably ever, and now, anyone with ClockworkMod can enjoy it too!

I really want to thank chris41g for taking the time to contribute. I respect and appreciate his work on the ACS Recovery, and I feel that his work will make even more of a difference in the end- to a lot more people than just the Epic 4G community.

I truly hope that my example can be an inspiration to others, to cooperate with other developers for the benefit of all. This may appear idealistic, but I believe the Epic 4G community has matured and has already started reaping the benefits of this cooperation. I also believe that in learning from others, you are also given the obligation to help others, who will, in turn, help others, and so on. I should hope that the benefits to all are obvious. And with that, I'll stop "preaching"... hehe.
The Following 38 Users Say Thank You to DRockstar For This Useful Post: [ View ] Gift DRockstar Ad-Free
22nd November 2011, 06:13 AM |#3  
Flag Omaha
Thanks Meter: 1
Rockstar! Thanks are in order!

Sent from my SPH-D700 using Tapatalk
22nd November 2011, 06:24 AM |#4  
Senior Member
Flag Union City
Thanks Meter: 60
Great news!

Sent from my SPH-D700 using XDA Premium App
22nd November 2011, 06:37 AM |#5  
zanderman112's Avatar
Senior Member
Flag SouthEast USA
Thanks Meter: 1,839
Donate to Me
First page reserve. This recovery is great.

Sharing via any means i can. Gonna get Kevin to do something with our roms now
22nd November 2011, 06:52 AM |#6  
counterfeit187's Avatar
Senior Member
Thanks Meter: 295
Great job! Thank you for all the hard work that you put into this!

Sent from my SPH-D700 using Tapatalk
22nd November 2011, 06:58 AM |#7  
lancelane's Avatar
Senior Member
Thanks Meter: 18
All i can say is wow. Thanks.

Sent from my Legandary Epic or my Galaxy Tab rooted (feels naked without a ROM)
22nd November 2011, 07:03 AM |#8  
zman519's Avatar
Senior Member
Flag the Land of Beer & Cheese
Thanks Meter: 252
Sweeeeeet!!! Thanks Drockstar! And devs!

Could we get md5's

Sent from the Drivers Seat of my Suby txting and Driving doing 100MPH+ in a school zone! Ha.

hear the md5 from the cwm flash 869BAF2D6A52B5604764F70556C9482E
22nd November 2011, 07:16 AM |#9  
travmofosho's Avatar
Senior Member
Flag Sacramento, CA
Thanks Meter: 424
Donate to Me
Thanks Drockstar!! Been testing it out and it works awesome!

Sent from my SPH-D700 using Tapatalk
22nd November 2011, 07:21 AM |#10  
ksmullins88's Avatar
Senior Member
Flag Detroit, MI
Thanks Meter: 1,216
Donate to Me
Thanks!!! This rocks.

Sent from my SPH-D700 using XDA App
The Following User Says Thank You to ksmullins88 For This Useful Post: [ View ] Gift ksmullins88 Ad-Free
22nd November 2011, 08:06 AM |#11  
Digglez's Avatar
Senior Member
Thanks Meter: 22
i know this is dumb but i gotta ask what color is it ?
Post Reply Subscribe to Thread

Guest Quick Reply (no urls or BBcode)
Previous Thread Next Thread
Thread Tools Search this Thread
Search this Thread:

Advanced Search
Display Modes