Go to file
Henrik Grimler e916c679ed
PIT: unknown version in PIT header has to be protocol version
And in that case there now exists a fifth version of the Odin
protocol, seen on Galaxy S9 and newer.

In total we have seen these versions (as of January 2022):

* 0, on devices from around 2014 or older
* 3, on devices from around 2015
* 4, on devices from around 2016 - 2017
* 5, on devices from around 2018 or newer
2022-01-01 20:38:19 +01:00
.builds builds: test build for ubuntu 20.04 as well 2021-11-22 17:26:43 +01:00
Linux */README: replace http with https in urls 2021-06-15 11:29:49 +02:00
OSX */README: replace http with https in urls 2021-06-15 11:29:49 +02:00
Win32 win32: remove zadig.exe from repo 2021-12-14 11:22:04 +01:00
cmake cmake: replace LFS check with scripts from wireshark 2021-12-10 09:46:24 +01:00
heimdall PIT: unknown version in PIT header has to be protocol version 2022-01-01 20:38:19 +01:00
heimdall-frontend heimdall-frontend: set version to 2.0.0 here as well 2021-12-16 17:40:42 +01:00
libpit PIT: unknown version in PIT header has to be protocol version 2022-01-01 20:38:19 +01:00
.gitignore gitignore: ignore *~ as well 2021-06-15 10:46:25 +02:00
CMakeLists.txt CMake: bump minimum version 2021-05-03 14:07:33 +02:00
LICENSE It's 2017. Where did the years go? 2017-05-12 03:47:37 +10:00
README.md README: add build status images 2021-12-16 16:15:51 +01:00

README.md

Heimdall

builds.sr.ht status builds.sr.ht status builds.sr.ht status

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

OS X

Windows