/* * libirecovery.h * Communication to iBoot/iBSS on Apple iOS devices via USB * * Copyright (c) 2012-2013 Martin Szulecki * Copyright (c) 2010 Chronic-Dev Team * Copyright (c) 2010 Joshua Hill * * All rights reserved. This program and the accompanying materials * are made available under the terms of the GNU Lesser General Public License * (LGPL) version 2.1 which accompanies this distribution, and is available at * http://www.gnu.org/licenses/lgpl-2.1.html * * This library is distributed in the hope that it will be useful, * but WITHOUT ANY WARRANTY; without even the implied warranty of * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU * Lesser General Public License for more details. */ #ifndef LIBIRECOVERY_H #define LIBIRECOVERY_H #ifdef __cplusplus extern "C" { #endif #include #ifndef WIN32 #include #else #define WIN32_LEAN_AND_MEAN #include #undef interface #ifndef sleep #define sleep(n) Sleep(1000 * n) #endif #endif #define APPLE_VENDOR_ID 0x05AC #define CPID_UNKNOWN -1 #define BDID_UNKNOWN -1 enum { kRecoveryMode1 = 0x1280, kRecoveryMode2 = 0x1281, kRecoveryMode3 = 0x1282, kRecoveryMode4 = 0x1283, kWTFMode = 0x1222, kDfuMode = 0x1227 }; typedef enum { IRECV_E_SUCCESS = 0, IRECV_E_NO_DEVICE = -1, IRECV_E_OUT_OF_MEMORY = -2, IRECV_E_UNABLE_TO_CONNECT = -3, IRECV_E_INVALID_INPUT = -4, IRECV_E_FILE_NOT_FOUND = -5, IRECV_E_USB_UPLOAD = -6, IRECV_E_USB_STATUS = -7, IRECV_E_USB_INTERFACE = -8, IRECV_E_USB_CONFIGURATION = -9, IRECV_E_PIPE = -10, IRECV_E_TIMEOUT = -11, IRECV_E_UNKNOWN_ERROR = -255 } irecv_error_t; typedef enum { IRECV_RECEIVED = 1, IRECV_PRECOMMAND = 2, IRECV_POSTCOMMAND = 3, IRECV_CONNECTED = 4, IRECV_DISCONNECTED = 5, IRECV_PROGRESS = 6 } irecv_event_type; typedef struct { int size; const char* data; double progress; irecv_event_type type; } irecv_event_t; struct irecv_client; typedef struct irecv_client* irecv_client_t; typedef struct irecv_device* irecv_device_t; typedef int(*irecv_event_cb_t)(irecv_client_t client, const irecv_event_t* event); struct irecv_client { int debug; int config; int interface; int alt_interface; unsigned short mode; char serial[256]; #ifndef WIN32 libusb_device_handle* handle; #else HANDLE handle; HANDLE hDFU; HANDLE hIB; LPSTR iBootPath; LPSTR DfuPath; #endif irecv_event_cb_t progress_callback; irecv_event_cb_t received_callback; irecv_event_cb_t connected_callback; irecv_event_cb_t precommand_callback; irecv_event_cb_t postcommand_callback; irecv_event_cb_t disconnected_callback; }; #define DEVICE_UNKNOWN -1 #define DEVICE_IPHONE2G 0 #define DEVICE_IPHONE3G 1 #define DEVICE_IPHONE3GS 2 #define DEVICE_IPHONE4 3 #define DEVICE_IPHONE4REVA 4 #define DEVICE_IPHONE4CDMA 5 #define DEVICE_IPHONE4S 6 #define DEVICE_IPHONE51 7 #define DEVICE_IPHONE52 8 #define DEVICE_IPHONE53 9 #define DEVICE_IPHONE54 10 #define DEVICE_IPHONE61 11 #define DEVICE_IPHONE62 12 #define DEVICE_IPOD1G 13 #define DEVICE_IPOD2G 14 #define DEVICE_IPOD3G 15 #define DEVICE_IPOD4G 16 #define DEVICE_IPOD5G 17 #define DEVICE_IPAD1G 18 #define DEVICE_IPAD21 19 #define DEVICE_IPAD22 20 #define DEVICE_IPAD23 21 #define DEVICE_IPAD24 22 #define DEVICE_IPAD25 23 #define DEVICE_IPAD26 24 #define DEVICE_IPAD27 25 #define DEVICE_IPAD31 26 #define DEVICE_IPAD32 27 #define DEVICE_IPAD33 28 #define DEVICE_IPAD34 29 #define DEVICE_IPAD35 30 #define DEVICE_IPAD36 31 #define DEVICE_APPLETV2 32 #define DEVICE_APPLETV31 33 #define DEVICE_APPLETV32 34 struct irecv_device { int index; const char* product; const char* model; unsigned int board_id; unsigned int chip_id; }; static struct irecv_device irecv_devices[] = { { 0, "iPhone1,1", "m68ap", 0x00, 0x8900 }, { 1, "iPhone1,2", "n82ap", 0x04, 0x8900 }, { 2, "iPhone2,1", "n88ap", 0x00, 0x8920 }, { 3, "iPhone3,1", "n90ap", 0x00, 0x8930 }, { 4, "iPhone3,2", "n90bap", 0x04, 0x8930 }, { 5, "iPhone3,3", "n92ap", 0x06, 0x8930 }, { 6, "iPhone4,1", "n94ap", 0x08, 0x8940 }, { 7, "iPhone5,1", "n41ap", 0x00, 0x8950 }, { 8, "iPhone5,2", "n42ap", 0x02, 0x8950 }, { 9, "iPhone5,3", "n48ap", 0x0a, 0x8950 }, { 10, "iPhone5,4", "n49ap", 0x0e, 0x8950 }, { 11, "iPhone6,1", "n51ap", 0x00, 0x8960 }, { 12, "iPhone6,2", "n53ap", 0x02, 0x8960 }, { 13, "iPod1,1", "n45ap", 0x02, 0x8900 }, { 14, "iPod2,1", "n72ap", 0x00, 0x8720 }, { 15, "iPod3,1", "n18ap", 0x02, 0x8922 }, { 16, "iPod4,1", "n81ap", 0x08, 0x8930 }, { 17, "iPod5,1", "n78ap", 0x00, 0x8942 }, { 18, "iPad1,1", "k48ap", 0x02, 0x8930 }, { 19, "iPad2,1", "k93ap", 0x04, 0x8940 }, { 20, "iPad2,2", "k94ap", 0x06, 0x8940 }, { 21, "iPad2,3", "k95ap", 0x02, 0x8940 }, { 22, "iPad2,4", "k93aap", 0x06, 0x8942 }, { 23, "iPad2,5", "p105ap", 0x0a, 0x8942 }, { 24, "iPad2,6", "p106ap", 0x0c, 0x8942 }, { 25, "iPad2,7", "p107ap", 0x0e, 0x8942 }, { 26, "iPad3,1", "j1ap", 0x00, 0x8945 }, { 27, "iPad3,2", "j2ap", 0x02, 0x8945 }, { 28, "iPad3,3", "j2aap", 0x04, 0x8945 }, { 29, "iPad3,4", "p101ap", 0x00, 0x8955 }, { 30, "iPad3,5", "p102ap", 0x02, 0x8955 }, { 31, "iPad3,6", "p103ap", 0x04, 0x8955 }, { 32, "AppleTV2,1", "k66ap", 0x10, 0x8930 }, { 33, "AppleTV3,1", "j33ap", 0x08, 0x8942 }, { 34, "AppleTV3,2","j33iap", 0x00, 0x8947 }, { -1, NULL, NULL, -1, -1 } }; void irecv_set_debug_level(int level); const char* irecv_strerror(irecv_error_t error); irecv_error_t irecv_open_with_ecid(irecv_client_t* client, unsigned long long ecid); irecv_error_t irecv_open_with_ecid_and_attempts(irecv_client_t* pclient, unsigned long long ecid, int attempts); irecv_error_t irecv_reset(irecv_client_t client); irecv_error_t irecv_close(irecv_client_t client); irecv_error_t irecv_receive(irecv_client_t client); irecv_error_t irecv_send_exploit(irecv_client_t client); irecv_error_t irecv_execute_script(irecv_client_t client, const char* script); irecv_error_t irecv_set_configuration(irecv_client_t client, int configuration); irecv_error_t irecv_event_subscribe(irecv_client_t client, irecv_event_type type, irecv_event_cb_t callback, void *user_data); irecv_error_t irecv_event_unsubscribe(irecv_client_t client, irecv_event_type type); int irecv_control_transfer(irecv_client_t client, uint8_t bmRequestType, uint8_t bRequest, uint16_t wValue, uint16_t wIndex, unsigned char *data, uint16_t wLength, unsigned int timeout); int irecv_bulk_transfer(irecv_client_t client, unsigned char endpoint, unsigned char *data, int length, int *transferred, unsigned int timeout); irecv_error_t irecv_send_file(irecv_client_t client, const char* filename, int dfuNotifyFinished); irecv_error_t irecv_send_command(irecv_client_t client, const char* command); irecv_error_t irecv_send_buffer(irecv_client_t client, unsigned char* buffer, unsigned long length, int dfuNotifyFinished); irecv_error_t irecv_saveenv(irecv_client_t client); irecv_error_t irecv_getret(irecv_client_t client, unsigned int* value); irecv_error_t irecv_getenv(irecv_client_t client, const char* variable, char** value); irecv_error_t irecv_setenv(irecv_client_t client, const char* variable, const char* value); irecv_error_t irecv_set_interface(irecv_client_t client, int interface, int alt_interface); irecv_error_t irecv_reboot(irecv_client_t client); irecv_error_t irecv_get_cpid(irecv_client_t client, unsigned int* cpid); irecv_error_t irecv_get_bdid(irecv_client_t client, unsigned int* bdid); irecv_error_t irecv_get_ecid(irecv_client_t client, unsigned long long* ecid); irecv_error_t irecv_get_nonce(irecv_client_t client, unsigned char** nonce, int* nonce_size); irecv_error_t irecv_get_srnm(irecv_client_t client, char* srnm); irecv_error_t irecv_get_imei(irecv_client_t client, char* imei); void irecv_init(); void irecv_exit(); irecv_client_t irecv_reconnect(irecv_client_t client, int initial_pause); irecv_error_t irecv_reset_counters(irecv_client_t client); irecv_error_t irecv_finish_transfer(irecv_client_t client); irecv_error_t irecv_recv_buffer(irecv_client_t client, char* buffer, unsigned long length); irecv_error_t irecv_get_device(irecv_client_t client, irecv_device_t* device); #ifdef __cplusplus } #endif #endif