Home | History | Annotate | Download | only in fastboot
      1 /*
      2  * Copyright (C) 2008 The Android Open Source Project
      3  * All rights reserved.
      4  *
      5  * Redistribution and use in source and binary forms, with or without
      6  * modification, are permitted provided that the following conditions
      7  * are met:
      8  *  * Redistributions of source code must retain the above copyright
      9  *    notice, this list of conditions and the following disclaimer.
     10  *  * Redistributions in binary form must reproduce the above copyright
     11  *    notice, this list of conditions and the following disclaimer in
     12  *    the documentation and/or other materials provided with the
     13  *    distribution.
     14  *
     15  * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
     16  * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
     17  * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
     18  * FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE
     19  * COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
     20  * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING,
     21  * BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS
     22  * OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED
     23  * AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
     24  * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
     25  * OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
     26  * SUCH DAMAGE.
     27  */
     28 
     29 #ifndef _FASTBOOT_H_
     30 #define _FASTBOOT_H_
     31 
     32 #include "usb.h"
     33 
     34 struct sparse_file;
     35 
     36 /* protocol.c - fastboot protocol */
     37 int fb_command(usb_handle *usb, const char *cmd);
     38 int fb_command_response(usb_handle *usb, const char *cmd, char *response);
     39 int fb_download_data(usb_handle *usb, const void *data, unsigned size);
     40 int fb_download_data_sparse(usb_handle *usb, struct sparse_file *s);
     41 char *fb_get_error(void);
     42 
     43 #define FB_COMMAND_SZ 64
     44 #define FB_RESPONSE_SZ 64
     45 
     46 /* engine.c - high level command queue engine */
     47 int fb_getvar(struct usb_handle *usb, char *response, const char *fmt, ...);
     48 int fb_format_supported(usb_handle *usb, const char *partition, const char *type_override);
     49 void fb_queue_flash(const char *ptn, void *data, unsigned sz);
     50 void fb_queue_flash_sparse(const char *ptn, struct sparse_file *s, unsigned sz);
     51 void fb_queue_erase(const char *ptn);
     52 void fb_queue_format(const char *ptn, int skip_if_not_supported, unsigned int max_chunk_sz);
     53 void fb_queue_require(const char *prod, const char *var, int invert,
     54         unsigned nvalues, const char **value);
     55 void fb_queue_display(const char *var, const char *prettyname);
     56 void fb_queue_query_save(const char *var, char *dest, unsigned dest_size);
     57 void fb_queue_reboot(void);
     58 void fb_queue_command(const char *cmd, const char *msg);
     59 void fb_queue_download(const char *name, void *data, unsigned size);
     60 void fb_queue_notice(const char *notice);
     61 void fb_queue_wait_for_disconnect(void);
     62 int fb_execute_queue(usb_handle *usb);
     63 int fb_queue_is_empty(void);
     64 
     65 /* util stuff */
     66 double now();
     67 char *mkmsg(const char *fmt, ...);
     68 void die(const char *fmt, ...);
     69 
     70 /* Current product */
     71 extern char cur_product[FB_RESPONSE_SZ + 1];
     72 
     73 #endif
     74