/* * Copyright (C) 2008 The Android Open Source Project * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #ifndef _RECOVERY_BOOTLOADER_H #define _RECOVERY_BOOTLOADER_H /* Bootloader Message * * This structure describes the content of a block in flash * that is used for recovery and the bootloader to talk to * each other. * * The command field is updated by linux when it wants to * reboot into recovery or to update radio or bootloader firmware. * It is also updated by the bootloader when firmware update * is complete (to boot into recovery for any final cleanup) * * The status field is written by the bootloader after the * completion of an "update-radio" or "update-hboot" command. * * The recovery field is only written by linux and used * for the system to send a message to recovery or the * other way around. */ struct bootloader_message { char command[32]; char status[32]; char recovery[1024]; }; /* Read and write the bootloader command from the "misc" partition. * These return zero on success. */ int get_bootloader_message(struct bootloader_message *out); int set_bootloader_message(const struct bootloader_message *in); /* Write an update to the cache partition for update-radio or update-hboot. * Note, this destroys any filesystem on the cache partition! * The expected bitmap format is 240x320, 16bpp (2Bpp), RGB 5:6:5. */ int write_update_for_bootloader( const char *update, int update_len, int bitmap_width, int bitmap_height, int bitmap_bpp, const char *busy_bitmap, const char *error_bitmap, const char *log_filename); /* Look for a log stored in the cache partition in the block after the * firmware update header. If we can read such a log, copy it to * stdout (ie, the current log). */ void recover_firmware_update_log(); #define CACHE_NAME "cache" #define MISC_NAME "misc" #define UPDATE_MAGIC "MSM-RADIO-UPDATE" #define UPDATE_MAGIC_SIZE 16 #define UPDATE_VERSION 0x00010000 #define LOG_MAGIC "LOGmagic" #define LOG_MAGIC_SIZE 8 #endif