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 <inttypes.h>
33 #include <stdlib.h>
34 
35 #include <string>
36 
37 #include "transport.h"
38 
39 struct sparse_file;
40 
41 /* protocol.c - fastboot protocol */
42 int fb_command(Transport* transport, const char* cmd);
43 int fb_command_response(Transport* transport, const char* cmd, char* response);
44 int fb_download_data(Transport* transport, const void* data, uint32_t size);
45 int fb_download_data_sparse(Transport* transport, struct sparse_file* s);
46 char *fb_get_error(void);
47 
48 #define FB_COMMAND_SZ 64
49 #define FB_RESPONSE_SZ 64
50 
51 /* engine.c - high level command queue engine */
52 bool fb_getvar(Transport* transport, const std::string& key, std::string* value);
53 void fb_queue_flash(const char *ptn, void *data, uint32_t sz);
54 void fb_queue_flash_sparse(const char* ptn, struct sparse_file* s, uint32_t sz, size_t current,
55                            size_t total);
56 void fb_queue_erase(const char *ptn);
57 void fb_queue_format(const char *ptn, int skip_if_not_supported, int32_t max_chunk_sz);
58 void fb_queue_require(const char *prod, const char *var, bool invert,
59                       size_t nvalues, const char **value);
60 void fb_queue_display(const char *var, const char *prettyname);
61 void fb_queue_query_save(const char *var, char *dest, uint32_t dest_size);
62 void fb_queue_reboot(void);
63 void fb_queue_command(const char *cmd, const char *msg);
64 void fb_queue_download(const char *name, void *data, uint32_t size);
65 void fb_queue_notice(const char *notice);
66 void fb_queue_wait_for_disconnect(void);
67 int fb_execute_queue(Transport* transport);
68 void fb_set_active(const char *slot);
69 
70 /* util stuff */
71 double now();
72 char *mkmsg(const char *fmt, ...);
73 __attribute__((__noreturn__)) void die(const char *fmt, ...);
74 
75 void get_my_path(char *path);
76 
77 /* Current product */
78 extern char cur_product[FB_RESPONSE_SZ + 1];
79 
80 #endif
81