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.md | 47 +++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 47 insertions(+) create mode 100644 README.md (limited to 'README.md') 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