xref: /freebsd/stand/uboot/glue.h (revision 681ce946)
1 /*-
2  * Copyright (c) 2008 Semihalf, Rafal Jaworowski <raj@semihalf.com>
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  * 1. Redistributions of source code must retain the above copyright
9  *    notice, this list of conditions and the following disclaimer.
10  * 2. Redistributions in binary form must reproduce the above copyright
11  *    notice, this list of conditions and the following disclaimer in the
12  *    documentation and/or other materials provided with the distribution.
13  *
14  * THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
15  * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
16  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
17  * ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
18  * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
19  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
20  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
21  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
22  * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
23  * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
24  * SUCH DAMAGE.
25  *
26  * $FreeBSD$
27  */
28 
29 /*
30  * This is the header file for conveniency wrapper routines (API glue)
31  */
32 
33 #ifndef _API_GLUE_H_
34 #define _API_GLUE_H_
35 
36 #include "api_public.h"
37 
38 /*
39  * Mask used to align the start address for API signature search to 1MiB
40  */
41 #define	API_SIG_SEARCH_MASK	~0x000fffff
42 
43 /*
44  * Search for the API signature within 3MiB of the 1MiB-aligned address that
45  * U-Boot has hinted us.
46  */
47 #define	API_SIG_SEARCH_LEN	0x00300000
48 
49 int syscall(int, int *, ...);
50 extern void *syscall_ptr;
51 
52 int api_parse_cmdline_sig(int argc, char **argv, struct api_signature **sig);
53 int api_search_sig(struct api_signature **sig);
54 
55 #define	UB_MAX_MR	16		/* max mem regions number */
56 #define	UB_MAX_DEV	6		/* max devices number */
57 
58 /*
59  * The ub_ library calls are part of the application, not U-Boot code!  They
60  * are front-end wrappers that are used by the consumer application: they
61  * prepare arguments for particular syscall and jump to the low level
62  * syscall()
63  */
64 
65 /* console */
66 int ub_getc(void);
67 int ub_tstc(void);
68 void ub_putc(char);
69 void ub_puts(const char *);
70 
71 /* system */
72 void ub_reset(void) __dead2;
73 struct sys_info *ub_get_sys_info(void);
74 
75 /* time */
76 void ub_udelay(unsigned long);
77 unsigned long ub_get_timer(unsigned long);
78 
79 /* env vars */
80 char *ub_env_get(const char *);
81 void ub_env_set(const char *, char *);
82 const char *ub_env_enum(const char *);
83 
84 /* devices */
85 int ub_dev_enum(void);
86 int ub_dev_open(int);
87 int ub_dev_close(int);
88 int ub_dev_read(int, void *, lbasize_t, lbastart_t, lbasize_t *);
89 int ub_dev_send(int, void *, int);
90 int ub_dev_recv(int, void *, int, int *);
91 struct device_info *ub_dev_get(int);
92 
93 void ub_dump_di(int);
94 void ub_dump_si(struct sys_info *);
95 char *ub_mem_type(int);
96 char *ub_stor_type(int);
97 
98 #endif /* _API_GLUE_H_ */
99