summaryrefslogtreecommitdiffstats
path: root/OSX/README.txt
diff options
context:
space:
mode:
authorBenjamin Dobell <benjamin.dobell+github@glassechidna.com.au>2010-12-04 14:25:04 +0100
committerBenjamin Dobell <benjamin.dobell+github@glassechidna.com.au>2010-12-04 14:25:04 +0100
commit46f2c1134d276944fb74584a61d90cc363aee7eb (patch)
tree6fa14b7ef509a3fb84305dec013dd24bcae6c17d /OSX/README.txt
parentAddresses: (diff)
downloadHeimdall-46f2c1134d276944fb74584a61d90cc363aee7eb.tar
Heimdall-46f2c1134d276944fb74584a61d90cc363aee7eb.tar.gz
Heimdall-46f2c1134d276944fb74584a61d90cc363aee7eb.tar.bz2
Heimdall-46f2c1134d276944fb74584a61d90cc363aee7eb.tar.lz
Heimdall-46f2c1134d276944fb74584a61d90cc363aee7eb.tar.xz
Heimdall-46f2c1134d276944fb74584a61d90cc363aee7eb.tar.zst
Heimdall-46f2c1134d276944fb74584a61d90cc363aee7eb.zip
Diffstat (limited to '')
-rw-r--r--OSX/README.txt133
1 files changed, 133 insertions, 0 deletions
diff --git a/OSX/README.txt b/OSX/README.txt
new file mode 100644
index 0000000..c5e82b0
--- /dev/null
+++ b/OSX/README.txt
@@ -0,0 +1,133 @@
+Heimdall (c) 2010 Benjamin Dobell, Glass Echidna
+http://www.glassechidna.com.au/products/heimdall/
+
+DISCLAIMER:
+
+ This software attempts to flash your Galaxy S device. The very nature of
+ flashing is dangerous. As with all flashing software, Heimdall has the
+ potential to damage (brick) your phone if not used carefully. If you're
+ concerned, don't use this software. Flashing ROMs onto your phone may also
+ void your warranty. Benjamin Dobell and Glass Echidna are not responsible
+ for the result of your actions.
+
+
+
+These instructions are for OS X operating systems.
+
+Installing Heimdall and Heimdall Frontend Binaries:
+
+ 1. Run "Heimdall Suite.pkg" and follow the instructions.
+
+ 2. Reboot your system.
+
+ 3. Done
+
+
+
+Installing Heimdall from Source:
+
+ 1. First make sure you have installed build-tools and pkgconfig.
+
+ 2. Open a terminal and navigate to the directory where you extracted
+ Heimdall.
+
+ 3. Then enter the following commands to compile and install libusb-1.0:
+
+ cd libusb-1.0
+ ./configure
+ make
+ sudo make install
+ cd ..
+
+ If you have problems please consult http://www.libusb.org/
+
+ 4. Enter the following commands to compile and install Heimdall:
+
+ cd heimdall
+ ./configure
+ make
+ sudo make install
+ cd ..
+
+ 5. If you haven't installed the driver before, enter the following:
+
+ cd OSX
+ sudo ./install-kext.sh
+
+ 6. Done
+
+
+Installing Heimdall Frontend from Source (Optional):
+
+ 1. First make sure you have installed XCode and Qt 4.6 or above,
+ available from http://qt.nokia.com/.
+
+ 2. Open a terminal and navigate to the directory where you extracted
+ Heimdall.
+
+ 3. Enter the following commands to compile and install Heimdall Frontend:
+
+ cd heimdall-frontend
+ qmake heimdall-frontend.pro
+
+ 4. This will produce an XCode project called heimdall-frontend.xcodeproj
+ in the heimdall-frontend folder. Open this file in XCode.
+
+ 5. From the menu bar select Build -> Build. This outputs heimdall-frontend
+ to /Applications
+
+ 6. Done
+
+
+
+Flashing Firmware with Heimdall Frontend:
+
+ 1. Fully charge your device (use the wall charger as it's faster).
+
+ 2. Download a decrypted Samsung Galaxy S ROM and extract it to a directory.
+
+ 3. If the ROM is provided as one of more archives (nested or otherwise),
+ extract them all to the same location.
+
+ NOTE: If you want to use the CSC then extract it last.
+
+ 3. Open Heimdall Frontend.
+
+ 4. Put your Galaxy S device into download mode.
+
+ 5. For each file you wish to flash use "Browse" to select the file.
+
+ 6. Press "Start".
+
+ 7. Heimdall Frontend will display the progress and inform you when the
+ flash is complete.
+
+
+
+Flashing Firmware from Command Line / Terminal:
+
+ 1. Fully charge your device (use the wall charger as it's faster).
+
+ 2. Download a decrypted Samsung Galaxy S ROM and extract it to a directory.
+
+ 3. If the ROM is provided as one of more archives (nested or otherwise),
+ extract them all to the same location.
+
+ NOTE: If you want to use the CSC then extract it last.
+
+ 4. Open a terminal and navigate to the directory where you extracted the
+ ROM files.
+
+ 5. Type the following to list all the functionality Heimdall supports:
+
+ heimdall help
+
+ 8. Use the instructions to manually enter a command with all the files you
+ want to flash.
+
+ Here is an example that does a full flash and repartition:
+
+ heimdall flash --repartition --pit s1_odin_20100512.pit --factoryfs factoryfs.rfs --cache cache.rfs --dbdata dbdata.rfs --primary-boot boot.bin --secondary-boot Sbl.bin --param param.lfs --kernel zImage --modem modem.bin
+
+ 9. Done
+