From 5b90f096254cacfd9c873e5e17f3608dff04f9f1 Mon Sep 17 00:00:00 2001 From: Benjamin Dobell Date: Fri, 12 May 2017 03:44:15 +1000 Subject: A modern README --- README | 27 --------------------------- README.md | 47 +++++++++++++++++++++++++++++++++++++++++++++++ 2 files changed, 47 insertions(+), 27 deletions(-) delete mode 100644 README create mode 100644 README.md diff --git a/README b/README deleted file mode 100644 index c72d9da..0000000 --- a/README +++ /dev/null @@ -1,27 +0,0 @@ --------------------------------------------------------------------------------- -Heimdall (c) 2010-2014 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. - --------------------------------------------------------------------------------- - -For more details about how to compile and install Heimdall please refer to the -appropriate platform specific README: - -- Linux: - Linux/README - -- OS X - OSX/README.txt - -- Windows - Win32/README.txt - diff --git a/README.md b/README.md new file mode 100644 index 0000000..01bac21 --- /dev/null +++ b/README.md @@ -0,0 +1,47 @@ +# Heimdall + +Heimdall is a cross-platform open-source tool suite used to flash firmware (aka ROMs) onto Samsung mobile devices. + +## Supported Platforms + +Officially, AMD64/x86-64 (64-bit) or x86 (32-bit) computers running: + + * Linux + * macOS + * Windows (XP, Vista, 7 etc.) + +However, several third-parties have reported success running Heimdall on ARM chipsets +(in particular Raspberry Pi), as well as additional operating systems such as FreeBSD. + +## How does Heimdall work? + +Heimdall connects to a mobile device over USB and interacts with low-level software +running on device, known as Loke. Loke and Heimdall communicate via the custom +Samsung-developed protocol typically referred to as the 'Odin 3 protocol'. + +USB communication in Heimdall is handled by the popular open-source USB library, [libusb](http://libusb.info). + +## Free & Open Source + +Heimdall is both free and open source. It is licensed under the MIT license (see LICENSE). + +Heimdall is maintained and predominantly developed by [Glass Echidna](http://glassechidna.com.au/), +a _tiny_ independent software development company. If you appreciate our work and would like +to support future development please consider making a [donation](http://glassechidna.com.au/donate/). + +## Documentation + +For more details about how to compile and install Heimdall please refer to the +appropriate platform specific README: + +#### Linux + + - Linux/README ([online](https://raw.githubusercontent.com/Benjamin-Dobell/Heimdall/master/Linux/README)) + +#### OS X + + - OSX/README.txt ([online](https://raw.githubusercontent.com/Benjamin-Dobell/Heimdall/master/OSX/README.txt)) + +#### Windows + + - Win32/README.txt ([online](https://raw.githubusercontent.com/Benjamin-Dobell/Heimdall/master/Win32/README.txt)) -- cgit v1.2.3