heimdall/README.md
2023-01-10 18:13:25 +01:00

2.2 KiB

Original source by Benjamin Dobell

UPDATE: It was modified by maxmoon in 2022 to flash custom firmware like LineageOS on old devices (there was a bug).

Here is a step by step guide on how to flash old smartphones with it, like a Samsung Galaxy S5 (SM-G900F).


The following lines are from the original README.md


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 the 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.

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, a tiny independent software development company. If you appreciate our work and would like to support future development please consider making a donation.

Documentation

For more details about how to compile and install Heimdall please refer to the appropriate platform specific README:

Linux

OS X

Windows