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 #if defined(__cplusplus)
35 extern "C" {
36 #endif
37 
38 struct sparse_file;
39 
40 /* protocol.c - fastboot protocol */
41 int fb_command(usb_handle *usb, const char *cmd);
42 int fb_command_response(usb_handle *usb, const char *cmd, char *response);
43 int fb_download_data(usb_handle *usb, const void *data, unsigned size);
44 int fb_download_data_sparse(usb_handle *usb, struct sparse_file *s);
45 char *fb_get_error(void);
46 
47 #define FB_COMMAND_SZ 64
48 #define FB_RESPONSE_SZ 64
49 
50 /* engine.c - high level command queue engine */
51 int fb_getvar(struct usb_handle *usb, char *response, const char *fmt, ...);
52 int fb_format_supported(usb_handle *usb, const char *partition, const char *type_override);
53 void fb_queue_flash(const char *ptn, void *data, unsigned sz);
54 void fb_queue_flash_sparse(const char *ptn, struct sparse_file *s, unsigned sz);
55 void fb_queue_erase(const char *ptn);
56 void fb_queue_format(const char *ptn, int skip_if_not_supported, unsigned int max_chunk_sz);
57 void fb_queue_require(const char *prod, const char *var, int invert,
58         unsigned nvalues, const char **value);
59 void fb_queue_display(const char *var, const char *prettyname);
60 void fb_queue_query_save(const char *var, char *dest, unsigned dest_size);
61 void fb_queue_reboot(void);
62 void fb_queue_command(const char *cmd, const char *msg);
63 void fb_queue_download(const char *name, void *data, unsigned size);
64 void fb_queue_notice(const char *notice);
65 void fb_queue_wait_for_disconnect(void);
66 int fb_execute_queue(usb_handle *usb);
67 int fb_queue_is_empty(void);
68 
69 /* util stuff */
70 double now();
71 char *mkmsg(const char *fmt, ...);
72 __attribute__((__noreturn__)) void die(const char *fmt, ...);
73 
74 void get_my_path(char *path);
75 
76 /* Current product */
77 extern char cur_product[FB_RESPONSE_SZ + 1];
78 
79 #if defined(__cplusplus)
80 }
81 #endif
82 
83 #endif
84