/* Copyright (c) 2010-2014 Benjamin Dobell, Glass Echidna Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.*/ // C Standard Library #include // Heimdall #include "Arguments.h" #include "BridgeManager.h" #include "EndModemFileTransferPacket.h" #include "EndPhoneFileTransferPacket.h" #include "FlashAction.h" #include "Heimdall.h" #include "Interface.h" #include "SessionSetupResponse.h" #include "TotalBytesPacket.h" #include "Utility.h" using namespace std; using namespace libpit; using namespace Heimdall; const char *FlashAction::usage = "Action: flash\n\ Arguments:\n\ [-- ...]\n\ [-- ...]\n\ [--pit ] [--verbose] [--no-reboot] [--resume] [--stdout-errors]\n\ [--usb-log-level ]\n\ or:\n\ --repartition --pit [-- ...]\n\ [-- ...] [--verbose] [--no-reboot]\n\ [--resume] [--stdout-errors] [--usb-log-level ]\n\ Description: Flashes one or more firmware files to your phone. Partition names\n\ (or identifiers) can be obtained by executing the print-pit action.\n\ Note: --no-reboot causes the device to remain in download mode after the action\n\ is completed. If you wish to perform another action whilst remaining in\n\ download mode, then the following action must specify the --resume flag.\n\ WARNING: If you're repartitioning it's strongly recommended you specify\n\ all files at your disposal.\n"; struct PartitionFile { const char *argumentName; FILE *file; PartitionFile(const char *argumentName, FILE *file) { this->argumentName = argumentName; this->file = file; } }; struct PartitionFlashInfo { const PitEntry *pitEntry; FILE *file; PartitionFlashInfo(const PitEntry *pitEntry, FILE *file) { this->pitEntry = pitEntry; this->file = file; } }; static bool openFiles(Arguments& arguments, vector& partitionFiles, FILE *& pitFile) { // Open PIT file const StringArgument *pitArgument = static_cast(arguments.GetArgument("pit")); if (pitArgument) { pitFile = FileOpen(pitArgument->GetValue().c_str(), "rb"); if (!pitFile) { Interface::PrintError("Failed to open file \"%s\"\n", pitArgument->GetValue().c_str()); return (false); } } // Open partition files for (vector::const_iterator it = arguments.GetArguments().begin(); it != arguments.GetArguments().end(); it++) { const string& argumentName = (*it)->GetName(); // The only way an argument could exist without being in the argument types map is if it's a wild-card. // The "%d" wild-card refers to a partition by identifier, where as the "%s" wild-card refers to a // partition by name. if (arguments.GetArgumentTypes().find(argumentName) == arguments.GetArgumentTypes().end()) { const StringArgument *stringArgument = static_cast(*it); FILE *file = FileOpen(stringArgument->GetValue().c_str(), "rb"); if (!file) { Interface::PrintError("Failed to open file \"%s\"\n", stringArgument->GetValue().c_str()); return (false); } partitionFiles.push_back(PartitionFile(argumentName.c_str(), file)); } } return (true); } static void closeFiles(vector& partitionFiles, FILE *& pitFile) { // Close PIT file if (pitFile) { FileClose(pitFile); pitFile = nullptr; } // Close partition files for (vector::const_iterator it = partitionFiles.begin(); it != partitionFiles.end(); it++) FileClose(it->file); partitionFiles.clear(); } static bool sendTotalTransferSize(BridgeManager *bridgeManager, const vector& partitionFiles, FILE *pitFile, bool repartition) { unsigned int totalBytes = 0; for (vector::const_iterator it = partitionFiles.begin(); it != partitionFiles.end(); it++) { FileSeek(it->file, 0, SEEK_END); totalBytes += (unsigned int)FileTell(it->file); FileRewind(it->file); } if (repartition) { FileSeek(pitFile, 0, SEEK_END); totalBytes += (unsigned int)FileTell(pitFile); FileRewind(pitFile); } bool success; TotalBytesPacket *totalBytesPacket = new TotalBytesPacket(totalBytes); success = bridgeManager->SendPacket(totalBytesPacket); delete totalBytesPacket; if (!success) { Interface::PrintError("Failed to send total bytes packet!\n"); return (false); } SessionSetupResponse *totalBytesResponse = new SessionSetupResponse(); success = bridgeManager->ReceivePacket(totalBytesResponse); int totalBytesResult = totalBytesResponse->GetResult(); delete totalBytesResponse; if (!success) { Interface::PrintError("Failed to receive session total bytes response!\n"); return (false); } if (totalBytesResult != 0) { Interface::PrintError("Unexpected session total bytes response!\nExpected: 0\nReceived:%d\n", totalBytesResult); return (false); } return (true); } static bool setupPartitionFlashInfo(const vector& partitionFiles, const PitData *pitData, vector& partitionFlashInfos) { for (vector::const_iterator it = partitionFiles.begin(); it != partitionFiles.end(); it++) { const PitEntry *pitEntry = nullptr; // Was the argument a partition identifier? unsigned int partitionIdentifier; if (Utility::ParseUnsignedInt(partitionIdentifier, it->argumentName) == kNumberParsingStatusSuccess) { pitEntry = pitData->FindEntry(partitionIdentifier); if (!pitEntry) { Interface::PrintError("No partition with identifier \"%s\" exists in the specified PIT.\n", it->argumentName); return (false); } } else { // The argument must be an partition name e.g. "ZIMAGE" pitEntry = pitData->FindEntry(it->argumentName); if (!pitEntry) { Interface::PrintError("Partition \"%s\" does not exist in the specified PIT.\n", it->argumentName); return (false); } } partitionFlashInfos.push_back(PartitionFlashInfo(pitEntry, it->file)); } return (true); } static bool flashPitData(BridgeManager *bridgeManager, const PitData *pitData) { Interface::Print("Uploading PIT\n"); if (bridgeManager->SendPitData(pitData)) { Interface::Print("PIT upload successful\n\n"); return (true); } else { Interface::PrintError("PIT upload failed!\n\n"); return (false); } } static bool flashFile(BridgeManager *bridgeManager, const PartitionFlashInfo& partitionFlashInfo) { if (partitionFlashInfo.pitEntry->GetBinaryType() == PitEntry::kBinaryTypeCommunicationProcessor) // Modem { Interface::Print("Uploading %s\n", partitionFlashInfo.pitEntry->GetPartitionName()); if (bridgeManager->SendFile(partitionFlashInfo.file, EndModemFileTransferPacket::kDestinationModem, partitionFlashInfo.pitEntry->GetDeviceType())) { Interface::Print("%s upload successful\n\n", partitionFlashInfo.pitEntry->GetPartitionName()); return (true); } else { Interface::PrintError("%s upload failed!\n\n", partitionFlashInfo.pitEntry->GetPartitionName()); return (false); } } else // partitionFlashInfo.pitEntry->GetBinaryType() == PitEntry::kBinaryTypeApplicationProcessor { Interface::Print("Uploading %s\n", partitionFlashInfo.pitEntry->GetPartitionName()); if (bridgeManager->SendFile(partitionFlashInfo.file, EndPhoneFileTransferPacket::kDestinationPhone, partitionFlashInfo.pitEntry->GetDeviceType(), partitionFlashInfo.pitEntry->GetIdentifier())) { Interface::Print("%s upload successful\n\n", partitionFlashInfo.pitEntry->GetPartitionName()); return (true); } else { Interface::PrintError("%s upload failed!\n\n", partitionFlashInfo.pitEntry->GetPartitionName()); return (false); } } } static bool flashPartitions(BridgeManager *bridgeManager, const vector& partitionFiles, const PitData *pitData, bool repartition) { vector partitionFlashInfos; // Map the files being flashed to partitions stored in the PIT file. if (!setupPartitionFlashInfo(partitionFiles, pitData, partitionFlashInfos)) return (false); // If we're repartitioning then we need to flash the PIT file first (if it is listed in the PIT file). if (repartition) { if (!flashPitData(bridgeManager, pitData)) return (false); } // Flash partitions in the same order that arguments were specified in. for (vector::const_iterator it = partitionFlashInfos.begin(); it != partitionFlashInfos.end(); it++) { if (!flashFile(bridgeManager, *it)) return (false); } return (true); } static PitData *getPitData(BridgeManager *bridgeManager, FILE *pitFile, bool repartition) { PitData *pitData; PitData *localPitData = nullptr; // If a PIT file was passed as an argument then we must unpack it. if (pitFile) { // Load the local pit file into memory. FileSeek(pitFile, 0, SEEK_END); unsigned int localPitFileSize = (unsigned int)FileTell(pitFile); FileRewind(pitFile); unsigned char *pitFileBuffer = new unsigned char[localPitFileSize]; memset(pitFileBuffer, 0, localPitFileSize); int dataRead = fread(pitFileBuffer, 1, localPitFileSize, pitFile); if (dataRead > 0) { FileRewind(pitFile); localPitData = new PitData(); localPitData->Unpack(pitFileBuffer); delete [] pitFileBuffer; } else { Interface::PrintError("Failed to read PIT file.\n"); delete [] pitFileBuffer; return (nullptr); } } if (repartition) { // Use the local PIT file data. pitData = localPitData; } else { // If we're not repartitioning then we need to retrieve the device's PIT file and unpack it. unsigned char *pitFileBuffer; if (bridgeManager->DownloadPitFile(&pitFileBuffer) == 0) return (nullptr); pitData = new PitData(); pitData->Unpack(pitFileBuffer); delete [] pitFileBuffer; if (localPitData != nullptr) { // The user has specified a PIT without repartitioning, we should verify the local and device PIT data match! bool pitsMatch = pitData->Matches(localPitData); delete localPitData; if (!pitsMatch) { Interface::Print("Local and device PIT files don't match and repartition wasn't specified!\n"); Interface::PrintError("Flash aborted!\n"); return (nullptr); } } } return (pitData); } int FlashAction::Execute(int argc, char **argv) { // Setup argument types map argumentTypes; map shortArgumentAliases; argumentTypes["repartition"] = kArgumentTypeFlag; argumentTypes["no-reboot"] = kArgumentTypeFlag; argumentTypes["resume"] = kArgumentTypeFlag; argumentTypes["verbose"] = kArgumentTypeFlag; argumentTypes["stdout-errors"] = kArgumentTypeFlag; argumentTypes["usb-log-level"] = kArgumentTypeString; argumentTypes["pit"] = kArgumentTypeString; shortArgumentAliases["pit"] = "pit"; // Add wild-cards "%d" and "%s", for partition identifiers and partition names respectively. argumentTypes["%d"] = kArgumentTypeString; shortArgumentAliases["%d"] = "%d"; argumentTypes["%s"] = kArgumentTypeString; shortArgumentAliases["%s"] = "%s"; map argumentAliases; argumentAliases["PIT"] = "pit"; // Map upper-case PIT argument (i.e. partition name) to known lower-case pit argument. // Handle arguments Arguments arguments(argumentTypes, shortArgumentAliases, argumentAliases); if (!arguments.ParseArguments(argc, argv, 2)) { Interface::Print(FlashAction::usage); return (0); } bool reboot = arguments.GetArgument("no-reboot") == nullptr; bool resume = arguments.GetArgument("resume") != nullptr; bool verbose = arguments.GetArgument("verbose") != nullptr; if (arguments.GetArgument("stdout-errors") != nullptr) Interface::SetStdoutErrors(true); const StringArgument *usbLogLevelArgument = static_cast(arguments.GetArgument("usb-log-level")); BridgeManager::UsbLogLevel usbLogLevel = BridgeManager::Default; if (usbLogLevelArgument) { const string& usbLogLevelString = usbLogLevelArgument->GetValue(); if (usbLogLevelString.compare("none") == 0 || usbLogLevelString.compare("NONE") == 0) { usbLogLevel = BridgeManager::None; } else if (usbLogLevelString.compare("error") == 0 || usbLogLevelString.compare("ERROR") == 0) { usbLogLevel = BridgeManager::Error; } else if (usbLogLevelString.compare("warning") == 0 || usbLogLevelString.compare("WARNING") == 0) { usbLogLevel = BridgeManager::Warning; } else if (usbLogLevelString.compare("info") == 0 || usbLogLevelString.compare("INFO") == 0) { usbLogLevel = BridgeManager::Info; } else if (usbLogLevelString.compare("debug") == 0 || usbLogLevelString.compare("DEBUG") == 0) { usbLogLevel = BridgeManager::Debug; } else { Interface::Print("Unknown USB log level: %s\n\n", usbLogLevelString.c_str()); Interface::Print(FlashAction::usage); return (0); } } const StringArgument *pitArgument = static_cast(arguments.GetArgument("pit")); bool repartition = arguments.GetArgument("repartition") != nullptr; if (repartition && !pitArgument) { Interface::Print("If you wish to repartition then a PIT file must be specified.\n\n"); Interface::Print(FlashAction::usage); return (0); } // Open files FILE *pitFile = nullptr; vector partitionFiles; if (!openFiles(arguments, partitionFiles, pitFile)) { closeFiles(partitionFiles, pitFile); return (1); } if (partitionFiles.size() == 0) { Interface::Print(FlashAction::usage); return (0); } // Info Interface::PrintReleaseInfo(); Sleep(1000); // Perform flash BridgeManager *bridgeManager = new BridgeManager(verbose); bridgeManager->SetUsbLogLevel(usbLogLevel); if (bridgeManager->Initialise(resume) != BridgeManager::kInitialiseSucceeded || !bridgeManager->BeginSession()) { closeFiles(partitionFiles, pitFile); delete bridgeManager; return (1); } bool success = sendTotalTransferSize(bridgeManager, partitionFiles, pitFile, repartition); if (success) { PitData *pitData = getPitData(bridgeManager, pitFile, repartition); if (pitData) success = flashPartitions(bridgeManager, partitionFiles, pitData, repartition); else success = false; delete pitData; } if (!bridgeManager->EndSession(reboot)) success = false; delete bridgeManager; closeFiles(partitionFiles, pitFile); return (success ? 0 : 1); }