02b577ec77
* Fix segfault when file to flash does not exist * Rename some fields in the flashing protocol, MMC4096 seem to be UFS, and what I thought was the protocol number seem to be the number of logical units in the storage |
||
---|---|---|
.builds | ||
Linux | ||
OSX | ||
Win32 | ||
cmake | ||
heimdall | ||
heimdall-frontend | ||
libpit | ||
.gitignore | ||
CMakeLists.txt | ||
LICENSE | ||
README.md |
README.md
Heimdall
Heimdall is a cross-platform open-source tool suite used to flash firmware (aka ROMs) onto Samsung mobile devices.
Supported Platforms
Heimdall should work on AMD64/x86-64 (64-bit) or x86 (32-bit) computers running GNU/Linux, macOS or Windows.
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
- Linux/README (online)
OS X
- OSX/README.txt (online)
Windows
- Win32/README.txt (online)
Odin protocol and PIT format
For more details on the Odin protocol, and the PIT files, see the external project samsung-loki/samsung-docs.