[HOW-TO]Heimdall One-Click - ROM Packaging and Distribution System

1. Obtain firmware
2. Use Heimdall frontend to package a tar.gz
3. Select your tar.gz file with Heimdall One-Click. Your final package will be a executable cross-platform JAR file for redistribution which will deploy everything needed to flash your ROM.
   
   

• Heimdall is Open-Source software. Without Open-Source software we would not have android or custom ROMs. Open-Source developers should support and expand the work of other Open-Source developers.
• Odin is closed source and propritary. Not only is the application proprietary, but the drivers are also proprietary. Open-Source developers do not support Closed-Source work as it is a hindrance to development.
• Heimdall supports Open-Source Tar.GZ compression which ensures file integrity and provides higher compression than zip formats. A 500 megabyte ROM can compress to less than 200 megabytes.
• Heimdall can restore operation to a device which does not even have access to recovery mode. Heimdall does not require the kernel to be operational, it works at a higher level in the Secondary Bootloader.
• A Heimdall One-Click is a single executable file which contains everything needed to flash a ROM.
• A Heimdall One-Click works on Windows, Linux or Mac OS-X.
• A Heimdall One-Click is not a final output format. Once you make a One-Click, the contents are not lost forever. The ROM package contained within can be unzipped using your favorite archive program, modified and redistributed.

• A deployable and unpackable firmware located in /com/adamoutler/heimdalloneclick/
• Installer routines
• Windows Drivers
• Windows C++ Redistributable Package
• Windows Heimdall binary
• Linux32 Debian package
• Linux64 Debian package
• Mac OS-X Installation package

1. Open a terminal to your device (terminal emulator or QuickSSHD, or adb shell)
2. Enter the following commands into the terminal
   
   Code:

   su
   #Remove the target folder if it is present
   rm -r -f /sdcard/firmwarepackage
   #Write all zeros to data partition to zero flash memory until the partition is full
   dd if=/dev/zero of=/data/big_zero bs=1048576
   #Remove the zerod out dummy file
   rm -r -f /data/big_zero
   #Mount The /system folder as RW so we can read and write to it
   mount -o remount,rw /system /system
   #Drop all zeros into a file on the /system partition until it is full
   dd if=/dev/zero of=/system/big_zero bs=1048576
   #Remove the zerod out dummy file
   rm /system/big_zero
   #Make our folder to write the firmware package onto the SDCard
   mkdir /sdcard/firmwarepackage
   #Begin transfer of all relevant blocks to sdcard
   dd if=/dev/block/stl9 of=/sdcard/firmwarepackage/factoryfs.img bs=4096
   dd if=/dev/block/bml7 of=/sdcard/firmwarepackage/zImage bs=4096
   dd if=/dev/block/stl10 of=/sdcard/firmwarepackage/dbdata.img bs=4096
   dd if=/dev/block/stl11 of=/sdcard/firmwarepackage/cache.img bs=4096
   dd if=/dev/block/bml12 of=/sdcard/firmwarepackage/modem.bin bs=4096
   #Done
   echo done

   
3. copy the files from your sdcard in the firmwarepackage folder to your desktop/laptop computer.
   Never mount an RFS filesystem to your computer Your computer is not equipped to handle the RFS filesystem. All permissions data will be lost and the filesystem will be rendered useless.
4. Using Heimdall Frontend, you can download the part.pit from the options tab to obtain the partition tables for custom ROM use.
5. Use Heimdall frontend to package a tar.gz
6. Use Heimdall One-Click Packager to make a One-Click

• http://Xda-developers.com developer forums
• http://rootzwiki.com
• http://sammobile.com
• http://samfirmware.com
• http://sampro.pl

1. Totally decompress the entire firmware package down to its individual files
2. Use heimdall-frontend to create a package
3. Use One-Click Packager to generate a one-click.

1. You will need Java installed on your computer Do you have java?
2. right click and open with Java
3. Put your device in "Download Mode" and click the flash button
4. Problems? Enter "Recovery Mode" and select "factory reset"

[ list=1]
[ *]You will need Java installed on your computer [url=http://www.java.com/en/download/installed.jsp?detect=jre&try=1]Do you have java?[/url]
[ *]right click and open with Java
[ *]Put your device in "Download Mode" and click the flash button
[ *]Problems?  Enter "Recovery Mode" and select "factory reset"
[/list]
[ size=4][ url=MYROM.COM]Click here to Download My ROM![/url][/size]

mrhaley30705 said:

Adam,
Does Heimdall frontend know which cache and dbdata file to use from a stock package, or do i need to manually select them? I've noticed that in a full package, there is a cache and dbdata file in two different places, but I do not know which one should be used. Also, should the param.lfs file be used only if flashing bootloaders, or should it always be included?

Edit
I am using stock firmware for a Captivate.

Click to expand...

Click to collapse

mrhaley30705 said:

Ok, I watched the video (great tutorial,btw), but I still don't know what to do about my problem. In a stock captivate package, there is a dbdata and cache file in the pda package, and another dbdata and cache file in the csc package. Which one gets used and which one gets tossed?

Click to expand...

Click to collapse

mrhaley30705 said:

Ok, thanks.
Just so I know, what does the dbdata and cache files do? What is in them?

Click to expand...

Click to collapse

mrhaley30705 said:

Ok, thanks again.

Any chance you are going to attempt a mobile Heimdall, similar to Mobile Odin I've been hearing about?

Click to expand...

Click to collapse

stayintwisted said:

this seems to be a very valuable tool for developers and I am very glad you posted it,,watched the video,,sounds like a good thing,, could not see what you were doing,,read the post repeatedly,,yep this will be useful to the devs,, truly had hoped it would be useful to those of us on here that have figured out how to follow instructions and flash roms but really do not understand what we are doing,,now I understand why odin is so useful,,it allows people to do the job without knowing how to make the tools to do the job ( although I would like to learn that) unfortunately this seems to be a common "open source" mindset,,thats why apple sells so many overpriced machines,, they expect people to know nothing and intend to keep them that way,,so their machines are simplified and locked,, but they work without having to know how to program them,,without having to understand the whole command line BS,,yes I am guilty of being uneducated,,I am not guilty of being stupid,, I do not use tools or equipment that assumes I do not know,, I do not use tools or equipment that assumes I know more than I do,,I will continue to follow this because I still have hopes it will become useful,,to the common run of the mill user,,thanks for your work,, it is impressive,,now to get it useable to those of us that do not have years of programming experience,,that went to school when punch cards were still in existance

Click to expand...

Click to collapse

stayintwisted said:

ok sorry to have bothered you,, I will try to find someplace to learn enough to understand what you consider stupidly simple,,I will just stick to odin and cwm they just work,,was my error for thinking that you would be able to write at a level I would understand,, but it is still going to be a very useful tool for those who can use it and I thank you for the work you have put into it

Click to expand...

Click to collapse