xref: /rk3399_ARM-atf/include/lib/semihosting.h (revision 4ecca33988b90de43ec4f4a929094a38a23fda31)
1 /*
2  * Copyright (c) 2013-2014, ARM Limited and Contributors. All rights reserved.
3  *
4  * Redistribution and use in source and binary forms, with or without
5  * modification, are permitted provided that the following conditions are met:
6  *
7  * Redistributions of source code must retain the above copyright notice, this
8  * list of conditions and the following disclaimer.
9  *
10  * Redistributions in binary form must reproduce the above copyright notice,
11  * this list of conditions and the following disclaimer in the documentation
12  * and/or other materials provided with the distribution.
13  *
14  * Neither the name of ARM nor the names of its contributors may be used
15  * to endorse or promote products derived from this software without specific
16  * prior written permission.
17  *
18  * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
19  * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
20  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
21  * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
22  * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
23  * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
24  * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
25  * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
26  * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
27  * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
28  * POSSIBILITY OF SUCH DAMAGE.
29  */
30 
31 #ifndef __SEMIHOSTING_H__
32 #define __SEMIHOSTING_H__
33 
34 #define SEMIHOSTING_SYS_OPEN            0x01
35 #define SEMIHOSTING_SYS_CLOSE           0x02
36 #define SEMIHOSTING_SYS_WRITE0          0x04
37 #define SEMIHOSTING_SYS_WRITEC          0x03
38 #define SEMIHOSTING_SYS_WRITE           0x05
39 #define SEMIHOSTING_SYS_READ            0x06
40 #define SEMIHOSTING_SYS_READC           0x07
41 #define SEMIHOSTING_SYS_SEEK            0x0A
42 #define SEMIHOSTING_SYS_FLEN            0x0C
43 #define SEMIHOSTING_SYS_REMOVE          0x0E
44 #define SEMIHOSTING_SYS_SYSTEM          0x12
45 #define SEMIHOSTING_SYS_ERRNO           0x13
46 
47 #define FOPEN_MODE_R			0x0
48 #define FOPEN_MODE_RB			0x1
49 #define FOPEN_MODE_RPLUS		0x2
50 #define FOPEN_MODE_RPLUSB		0x3
51 #define FOPEN_MODE_W			0x4
52 #define FOPEN_MODE_WB			0x5
53 #define FOPEN_MODE_WPLUS		0x6
54 #define FOPEN_MODE_WPLUSB		0x7
55 #define FOPEN_MODE_A			0x8
56 #define FOPEN_MODE_AB			0x9
57 #define FOPEN_MODE_APLUS		0xa
58 #define FOPEN_MODE_APLUSB		0xb
59 
60 long semihosting_connection_supported(void);
61 long semihosting_file_open(const char *file_name, size_t mode);
62 long semihosting_file_seek(long file_handle, ssize_t offset);
63 long semihosting_file_read(long file_handle, size_t *length, void *buffer);
64 long semihosting_file_write(long file_handle,
65 			    size_t *length,
66 			    const void *buffer);
67 long semihosting_file_close(long file_handle);
68 long semihosting_file_length(long file_handle);
69 long semihosting_system(char *command_line);
70 long semihosting_get_flen(const char *file_name);
71 long semihosting_download_file(const char *file_name,
72 			       size_t buf_size,
73 			       void *buf);
74 void semihosting_write_char(char character);
75 void semihosting_write_string(char *string);
76 char semihosting_read_char(void);
77 
78 #endif /* __SEMIHOSTING_H__ */
79