Compare commits
5 Commits
master
...
size_check
Author | SHA1 | Date |
---|---|---|
Henrik Grimler | d252c72d34 | |
Henrik Grimler | 8d5a79a90c | |
Henrik Grimler | ee3b0a8fba | |
Henrik Grimler | f8001bce66 | |
Henrik Grimler | b2eaf46662 |
17
README.md
17
README.md
|
@ -1,9 +1,5 @@
|
|||
# Heimdall
|
||||
|
||||
[![builds.sr.ht status](https://builds.sr.ht/~grimler/Heimdall/commits/ubuntu.yml.svg)](https://builds.sr.ht/~grimler/Heimdall/commits/ubuntu.yml?)
|
||||
[![builds.sr.ht status](https://builds.sr.ht/~grimler/Heimdall/commits/archlinux.yml.svg)](https://builds.sr.ht/~grimler/Heimdall/commits/archlinux.yml?)
|
||||
[![builds.sr.ht status](https://builds.sr.ht/~grimler/Heimdall/commits/alpine.yml.svg)](https://builds.sr.ht/~grimler/Heimdall/commits/alpine.yml?)
|
||||
|
||||
Heimdall is a cross-platform open-source tool suite used to flash
|
||||
firmware (aka ROMs) onto Samsung mobile devices.
|
||||
|
||||
|
@ -24,7 +20,7 @@ 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](https://libusb.info).
|
||||
USB library, [libusb](http://libusb.info).
|
||||
|
||||
## Free & Open Source
|
||||
|
||||
|
@ -44,17 +40,12 @@ refer to the appropriate platform specific README:
|
|||
|
||||
#### Linux
|
||||
|
||||
- Linux/README ([online](Linux/README))
|
||||
- Linux/README ([online](https://raw.githubusercontent.com/Benjamin-Dobell/Heimdall/master/Linux/README))
|
||||
|
||||
#### OS X
|
||||
|
||||
- OSX/README.txt ([online](OSX/README.txt))
|
||||
- OSX/README.txt ([online](https://raw.githubusercontent.com/Benjamin-Dobell/Heimdall/master/OSX/README.txt))
|
||||
|
||||
#### Windows
|
||||
|
||||
- Win32/README.txt ([online](Win32/README.txt))
|
||||
|
||||
### Odin protocol and PIT format
|
||||
|
||||
For more details on the Odin protocol, and the PIT files, see the
|
||||
external project [samsung-loki/samsung-docs](https://samsung-loki.github.io/samsung-docs/).
|
||||
- Win32/README.txt ([online](https://raw.githubusercontent.com/Benjamin-Dobell/Heimdall/master/Win32/README.txt))
|
||||
|
|
Binary file not shown.
|
@ -20,7 +20,7 @@ Driver Installation Instructions:
|
|||
|
||||
1. Put your device into download mode and plug it in.
|
||||
|
||||
2. Download zadig from https://zadig.akeo.ie/downloads/, and run zadig.exe.
|
||||
2. Run zadig.exe included in the Drivers subdirectory.
|
||||
|
||||
3. From the menu chose Options -> List All Devices.
|
||||
|
||||
|
|
|
@ -114,7 +114,7 @@
|
|||
p, li { white-space: pre-wrap; }
|
||||
</style></head><body style=" font-family:'MS Shell Dlg 2'; font-size:10pt; font-weight:400; font-style:normal;">
|
||||
<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-weight:600;">Heimdall Frontend</span></p>
|
||||
<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">Version 2.0.2</p>
|
||||
<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">Version 1.4.2</p>
|
||||
<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;">Copyright © 2010-2017 Benjamin Dobell, Glass Echidna</p>
|
||||
<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"></p>
|
||||
<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-weight:600;">Heimdall (command line)</span></p>
|
||||
|
|
|
@ -20,7 +20,6 @@
|
|||
|
||||
// C Standard Library
|
||||
#include <cstdio>
|
||||
#include <fstream>
|
||||
|
||||
// libusb
|
||||
#include <libusb.h>
|
||||
|
@ -81,17 +80,16 @@ int BridgeManager::FindDeviceInterface(void)
|
|||
Interface::Print("Detecting device...\n");
|
||||
|
||||
struct libusb_device **devices;
|
||||
unsigned int deviceCount = libusb_get_device_list(libusbContext, &devices);
|
||||
int deviceCount = libusb_get_device_list(libusbContext, &devices);
|
||||
|
||||
for (unsigned int deviceIndex = 0; deviceIndex < deviceCount; deviceIndex++)
|
||||
for (int deviceIndex = 0; deviceIndex < deviceCount; deviceIndex++)
|
||||
{
|
||||
libusb_device_descriptor descriptor;
|
||||
libusb_get_device_descriptor(devices[deviceIndex], &descriptor);
|
||||
|
||||
for (int i = 0; i < BridgeManager::kSupportedDeviceCount; i++)
|
||||
{
|
||||
if (descriptor.idVendor == supportedDevices[i].vendorId &&
|
||||
descriptor.idProduct == supportedDevices[i].productId)
|
||||
if (descriptor.idVendor == supportedDevices[i].vendorId && descriptor.idProduct == supportedDevices[i].productId)
|
||||
{
|
||||
heimdallDevice = devices[deviceIndex];
|
||||
libusb_ref_device(heimdallDevice);
|
||||
|
@ -312,20 +310,14 @@ bool BridgeManager::InitialiseProtocol(void)
|
|||
memcpy(dataBuffer, "ODIN", 4);
|
||||
memset(dataBuffer + 4, 0, 1);
|
||||
|
||||
#ifdef OS_LINUX
|
||||
if (IsUbuntu())
|
||||
{
|
||||
Interface::Print("Resetting device...\n");
|
||||
if (libusb_reset_device(deviceHandle))
|
||||
{
|
||||
Interface::PrintError("Failed to reset device!\n");
|
||||
Interface::PrintError("Failed to reset device!");
|
||||
}
|
||||
}
|
||||
#endif
|
||||
|
||||
if (!SendBulkTransfer(dataBuffer, 4, 1000))
|
||||
{
|
||||
Interface::PrintError("Failed to send handshake!\n");
|
||||
Interface::PrintError("Failed to send handshake!");
|
||||
}
|
||||
|
||||
// Expect "LOKE"
|
||||
|
@ -415,8 +407,29 @@ bool BridgeManager::DetectDevice(void)
|
|||
return (false);
|
||||
}
|
||||
|
||||
// Set libusb log level.
|
||||
SetUsbLogLevel(usbLogLevel);
|
||||
// Setup libusb log level.
|
||||
switch (usbLogLevel)
|
||||
{
|
||||
case UsbLogLevel::None:
|
||||
libusb_set_option(libusbContext, LIBUSB_OPTION_LOG_LEVEL, LIBUSB_LOG_LEVEL_NONE);
|
||||
break;
|
||||
|
||||
case UsbLogLevel::Error:
|
||||
libusb_set_option(libusbContext, LIBUSB_OPTION_LOG_LEVEL, LIBUSB_LOG_LEVEL_ERROR);
|
||||
break;
|
||||
|
||||
case UsbLogLevel::Warning:
|
||||
libusb_set_option(libusbContext, LIBUSB_OPTION_LOG_LEVEL, LIBUSB_LOG_LEVEL_WARNING);
|
||||
break;
|
||||
|
||||
case UsbLogLevel::Info:
|
||||
libusb_set_option(libusbContext, LIBUSB_OPTION_LOG_LEVEL, LIBUSB_LOG_LEVEL_INFO);
|
||||
break;
|
||||
|
||||
case UsbLogLevel::Debug:
|
||||
libusb_set_option(libusbContext, LIBUSB_OPTION_LOG_LEVEL, LIBUSB_LOG_LEVEL_DEBUG);
|
||||
break;
|
||||
}
|
||||
|
||||
// Get handle to Galaxy S device
|
||||
struct libusb_device **devices;
|
||||
|
@ -429,8 +442,7 @@ bool BridgeManager::DetectDevice(void)
|
|||
|
||||
for (int i = 0; i < BridgeManager::kSupportedDeviceCount; i++)
|
||||
{
|
||||
if (descriptor.idVendor == supportedDevices[i].vendorId &&
|
||||
descriptor.idProduct == supportedDevices[i].productId)
|
||||
if (descriptor.idVendor == supportedDevices[i].vendorId && descriptor.idProduct == supportedDevices[i].productId)
|
||||
{
|
||||
libusb_free_device_list(devices, deviceCount);
|
||||
|
||||
|
@ -456,12 +468,33 @@ int BridgeManager::Initialise(bool resume)
|
|||
if (result != LIBUSB_SUCCESS)
|
||||
{
|
||||
Interface::PrintError("Failed to initialise libusb. libusb error: %d\n", result);
|
||||
Interface::Print("Failed to connect to device!\n");
|
||||
Interface::Print("Failed to connect to device!");
|
||||
return (BridgeManager::kInitialiseFailed);
|
||||
}
|
||||
|
||||
// Setup libusb log level.
|
||||
SetUsbLogLevel(usbLogLevel);
|
||||
switch (usbLogLevel)
|
||||
{
|
||||
case UsbLogLevel::None:
|
||||
libusb_set_option(libusbContext, LIBUSB_OPTION_LOG_LEVEL, LIBUSB_LOG_LEVEL_NONE);
|
||||
break;
|
||||
|
||||
case UsbLogLevel::Error:
|
||||
libusb_set_option(libusbContext, LIBUSB_OPTION_LOG_LEVEL, LIBUSB_LOG_LEVEL_ERROR);
|
||||
break;
|
||||
|
||||
case UsbLogLevel::Warning:
|
||||
libusb_set_option(libusbContext, LIBUSB_OPTION_LOG_LEVEL, LIBUSB_LOG_LEVEL_WARNING);
|
||||
break;
|
||||
|
||||
case UsbLogLevel::Info:
|
||||
libusb_set_option(libusbContext, LIBUSB_OPTION_LOG_LEVEL, LIBUSB_LOG_LEVEL_INFO);
|
||||
break;
|
||||
|
||||
case UsbLogLevel::Debug:
|
||||
libusb_set_option(libusbContext, LIBUSB_OPTION_LOG_LEVEL, LIBUSB_LOG_LEVEL_DEBUG);
|
||||
break;
|
||||
}
|
||||
|
||||
result = FindDeviceInterface();
|
||||
|
||||
|
@ -716,7 +749,7 @@ bool BridgeManager::ReceivePacket(InboundPacket *packet, int timeout, int emptyT
|
|||
if (receivedSize < 0)
|
||||
return (false);
|
||||
|
||||
if (static_cast<unsigned int>(receivedSize) != packet->GetSize() && !packet->IsSizeVariable())
|
||||
if (receivedSize != packet->GetSize() && !packet->IsSizeVariable())
|
||||
{
|
||||
if (verbose)
|
||||
Interface::PrintError("Incorrect packet size received - expected size = %d, received size = %d.\n", packet->GetSize(), receivedSize);
|
||||
|
@ -1244,32 +1277,3 @@ void BridgeManager::SetUsbLogLevel(UsbLogLevel usbLogLevel)
|
|||
}
|
||||
}
|
||||
}
|
||||
|
||||
#ifdef OS_LINUX
|
||||
bool BridgeManager::IsUbuntu()
|
||||
{
|
||||
std::ifstream os_release("/etc/os-release");
|
||||
std::string line, entry, os;
|
||||
int pos;
|
||||
while (std::getline(os_release, line))
|
||||
{
|
||||
pos = line.find("=");
|
||||
entry = line.substr(0, pos);
|
||||
if (entry == "ID")
|
||||
{
|
||||
os = line.substr(pos+1);
|
||||
if (verbose)
|
||||
{
|
||||
Interface::Print("Linux distro ID: %s\n",
|
||||
os.c_str());
|
||||
}
|
||||
if (os == "ubuntu")
|
||||
{
|
||||
return true;
|
||||
}
|
||||
break;
|
||||
}
|
||||
}
|
||||
return false;
|
||||
}
|
||||
#endif
|
||||
|
|
|
@ -166,9 +166,7 @@ namespace Heimdall
|
|||
bool SendFile(FILE *file, unsigned int destination, unsigned int deviceType, unsigned int fileIdentifier = 0xFFFFFFFF) const;
|
||||
|
||||
void SetUsbLogLevel(UsbLogLevel usbLogLevel);
|
||||
#ifdef OS_LINUX
|
||||
bool IsUbuntu(void);
|
||||
#endif
|
||||
|
||||
UsbLogLevel GetUsbLogLevel(void) const
|
||||
{
|
||||
return usbLogLevel;
|
||||
|
|
|
@ -148,7 +148,7 @@ int DownloadPitAction::Execute(int argc, char **argv)
|
|||
|
||||
if (fileSize > 0)
|
||||
{
|
||||
if (fwrite(pitBuffer, 1, fileSize, outputPitFile) != static_cast<size_t>(fileSize))
|
||||
if (fwrite(pitBuffer, 1, fileSize, outputPitFile) != fileSize)
|
||||
{
|
||||
Interface::PrintError("Failed to write PIT data to output file.\n");
|
||||
success = false;
|
||||
|
|
|
@ -116,16 +116,16 @@ static bool openFiles(Arguments& arguments, vector<PartitionFile>& partitionFile
|
|||
{
|
||||
const StringArgument *stringArgument = static_cast<const StringArgument *>(*it);
|
||||
FILE *file = FileOpen(stringArgument->GetValue().c_str(), "rb");
|
||||
FileSeek(file, 0, SEEK_END);
|
||||
unsigned long fileSize = (unsigned long)FileTell(file);
|
||||
FileRewind(file);
|
||||
|
||||
if (!file)
|
||||
{
|
||||
Interface::PrintError("Failed to open file \"%s\"\n", stringArgument->GetValue().c_str());
|
||||
return (false);
|
||||
}
|
||||
|
||||
FileSeek(file, 0, SEEK_END);
|
||||
unsigned long fileSize = (unsigned long)FileTell(file);
|
||||
FileRewind(file);
|
||||
|
||||
partitionFiles.push_back(PartitionFile(argumentName.c_str(), file, fileSize));
|
||||
}
|
||||
}
|
||||
|
@ -303,15 +303,16 @@ static bool flashPartitions(BridgeManager *bridgeManager, const vector<Partition
|
|||
{
|
||||
const PitEntry *part = pitData->FindEntry(it->argumentName);
|
||||
if (part->GetDeviceType() != PitEntry::kDeviceTypeMMC &&
|
||||
part->GetDeviceType() != PitEntry::kDeviceTypeUFS)
|
||||
part->GetDeviceType() != PitEntry::kDeviceTypeMMC4096)
|
||||
continue;
|
||||
unsigned long partitionSize = part->GetBlockCount();
|
||||
unsigned int blockSize = 512;
|
||||
if (part->GetDeviceType() == PitEntry::kDeviceTypeUFS)
|
||||
if (part->GetDeviceType() == PitEntry::kDeviceTypeMMC4096)
|
||||
blockSize = 4096;
|
||||
printf("Partition %s: size %lu, size in PIT: %lu\n", it->argumentName, it->fileSize, partitionSize*blockSize);
|
||||
if (partitionSize > 0 && it->fileSize > partitionSize*blockSize)
|
||||
{
|
||||
Interface::PrintError("%s partition is too small for given file. Use --skip-size-check to flash anyways.\n",
|
||||
Interface::PrintError("%s partition is too small for specified file\n",
|
||||
it->argumentName);
|
||||
return (false);
|
||||
}
|
||||
|
|
|
@ -42,7 +42,7 @@ using namespace Heimdall;
|
|||
map<string, Interface::ActionInfo> actionMap;
|
||||
bool stdoutErrors = false;
|
||||
|
||||
const char *version = "v2.0.2";
|
||||
const char *version = "v1.4.2";
|
||||
const char *actionUsage = "Usage: heimdall <action> <action arguments>\n";
|
||||
|
||||
const char *releaseInfo = "Heimdall %s\n\n\
|
||||
|
@ -211,7 +211,7 @@ void Interface::PrintPit(const PitData *pitData)
|
|||
Interface::Print("Entry Count: %d\n", pitData->GetEntryCount());
|
||||
Interface::Print("Unknown string: %s\n", pitData->GetComTar2());
|
||||
Interface::Print("CPU/bootloader tag: %s\n", pitData->GetCpuBlId());
|
||||
Interface::Print("Logic unit count: %d\n", pitData->GetLUCount());
|
||||
Interface::Print("Unknown: 0x%04x\n", pitData->GetUnknown());
|
||||
|
||||
for (unsigned int i = 0; i < pitData->GetEntryCount(); i++)
|
||||
{
|
||||
|
@ -257,8 +257,8 @@ void Interface::PrintPit(const PitData *pitData)
|
|||
Interface::Print("All (?)");
|
||||
break;
|
||||
|
||||
case PitEntry::kDeviceTypeUFS:
|
||||
Interface::Print("UFS");
|
||||
case PitEntry::kDeviceTypeMMC4096:
|
||||
Interface::Print("MMC 4096");
|
||||
break;
|
||||
|
||||
default:
|
||||
|
|
|
@ -45,7 +45,7 @@ namespace Heimdall
|
|||
memset(data, 0, size);
|
||||
}
|
||||
|
||||
virtual ~Packet()
|
||||
~Packet()
|
||||
{
|
||||
delete [] data;
|
||||
}
|
||||
|
|
|
@ -69,7 +69,7 @@ PitData::PitData()
|
|||
com_tar2[0] = '\0';
|
||||
cpu_bl_id[0] = '\0';
|
||||
|
||||
luCount = 0;
|
||||
unknown = 0;
|
||||
}
|
||||
|
||||
PitData::~PitData()
|
||||
|
@ -98,7 +98,7 @@ bool PitData::Unpack(const unsigned char *data)
|
|||
return (false);
|
||||
cpu_bl_id[8]='\0';
|
||||
|
||||
luCount = PitData::UnpackShort(data, 24);
|
||||
unknown = PitData::UnpackShort(data, 24);
|
||||
|
||||
unsigned int integerValue;
|
||||
unsigned int entryOffset;
|
||||
|
@ -153,7 +153,7 @@ void PitData::Pack(unsigned char *data) const
|
|||
memcpy(&data[8], com_tar2, 8);
|
||||
memcpy(&data[16], cpu_bl_id, 8);
|
||||
|
||||
PitData::PackShort(data, 24, luCount);
|
||||
PitData::PackShort(data, 24, unknown);
|
||||
|
||||
int entryOffset;
|
||||
|
||||
|
@ -187,7 +187,7 @@ bool PitData::Matches(const PitData *otherPitData) const
|
|||
if (entryCount == otherPitData->entryCount &&
|
||||
(strncmp(com_tar2, otherPitData->com_tar2, 8) == 0) &&
|
||||
(strncmp(cpu_bl_id, otherPitData->cpu_bl_id, 8) == 0) &&
|
||||
luCount == otherPitData->luCount)
|
||||
unknown == otherPitData->unknown)
|
||||
{
|
||||
for (unsigned int i = 0; i < entryCount; i++)
|
||||
{
|
||||
|
@ -211,7 +211,7 @@ void PitData::Clear(void)
|
|||
|
||||
cpu_bl_id[0] = '\0';
|
||||
|
||||
luCount = 0;
|
||||
unknown = 0;
|
||||
|
||||
for (unsigned int i = 0; i < entries.size(); i++)
|
||||
delete entries[i];
|
||||
|
|
|
@ -62,7 +62,7 @@ namespace libpit
|
|||
kDeviceTypeFile, // FAT
|
||||
kDeviceTypeMMC,
|
||||
kDeviceTypeAll, // ?
|
||||
kDeviceTypeUFS = 8
|
||||
kDeviceTypeMMC4096 = 8 // block size 4096
|
||||
};
|
||||
|
||||
enum
|
||||
|
@ -266,7 +266,7 @@ namespace libpit
|
|||
|
||||
char cpu_bl_id[8+1]; // 0x10
|
||||
|
||||
unsigned short luCount; // 0x18
|
||||
unsigned short unknown; // 0x18
|
||||
|
||||
// Entries start at 0x1C
|
||||
std::vector<PitEntry *> entries;
|
||||
|
@ -375,9 +375,9 @@ namespace libpit
|
|||
return cpu_bl_id;
|
||||
}
|
||||
|
||||
unsigned int GetLUCount(void) const
|
||||
unsigned int GetUnknown(void) const
|
||||
{
|
||||
return luCount;
|
||||
return unknown;
|
||||
}
|
||||
};
|
||||
}
|
||||
|
|
Loading…
Reference in New Issue