xref: /DragonStub/inc/aarch64/efibind.h (revision 787b53a66cbbec6b10d47264b9eea9b24bc4e34c)
1333bf05dSNigel Croxon /*
2333bf05dSNigel Croxon  * Copright (C) 2014 - 2015 Linaro Ltd.
3333bf05dSNigel Croxon  * Author: Ard Biesheuvel <ard.biesheuvel@linaro.org>
4333bf05dSNigel Croxon  *
5333bf05dSNigel Croxon  * Redistribution and use in source and binary forms, with or without
6333bf05dSNigel Croxon  * modification, are permitted provided that the following conditions
7333bf05dSNigel Croxon  * are met:
8333bf05dSNigel Croxon  * 1. Redistributions of source code must retain the above copyright
9333bf05dSNigel Croxon  *    notice and this list of conditions, without modification.
10333bf05dSNigel Croxon  * 2. The name of the author may not be used to endorse or promote products
11333bf05dSNigel Croxon  *    derived from this software without specific prior written permission.
12333bf05dSNigel Croxon  *
13333bf05dSNigel Croxon  * Alternatively, this software may be distributed under the terms of the
14333bf05dSNigel Croxon  * GNU General Public License as published by the Free Software Foundation;
15333bf05dSNigel Croxon  * either version 2 of the License, or (at your option) any later version.
16333bf05dSNigel Croxon  */
17530d68baSNigel Croxon 
1839ce220cSNigel Croxon #if !defined(_MSC_VER) && (!defined(__STDC_VERSION__) || (__STDC_VERSION__ < 199901L ))
19333bf05dSNigel Croxon 
20333bf05dSNigel Croxon // ANSI C 1999/2000 stdint.h integer width declarations
21333bf05dSNigel Croxon 
22333bf05dSNigel Croxon typedef unsigned long       uint64_t;
23333bf05dSNigel Croxon typedef long                int64_t;
24333bf05dSNigel Croxon typedef unsigned int        uint32_t;
25333bf05dSNigel Croxon typedef int                 int32_t;
26333bf05dSNigel Croxon typedef unsigned short      uint16_t;
27333bf05dSNigel Croxon typedef short               int16_t;
28333bf05dSNigel Croxon typedef unsigned char       uint8_t;
29333bf05dSNigel Croxon typedef signed char         int8_t;   // unqualified 'char' is unsigned on ARM
30333bf05dSNigel Croxon 
31333bf05dSNigel Croxon #else
32530d68baSNigel Croxon #include <stdint.h>
33333bf05dSNigel Croxon #endif
34530d68baSNigel Croxon 
35530d68baSNigel Croxon //
36530d68baSNigel Croxon // Basic EFI types of various widths
37530d68baSNigel Croxon //
38530d68baSNigel Croxon 
39530d68baSNigel Croxon #ifndef __WCHAR_TYPE__
40530d68baSNigel Croxon # define __WCHAR_TYPE__ short
41530d68baSNigel Croxon #endif
42530d68baSNigel Croxon 
43530d68baSNigel Croxon typedef uint64_t   UINT64;
44530d68baSNigel Croxon typedef int64_t    INT64;
45530d68baSNigel Croxon 
46530d68baSNigel Croxon typedef uint32_t   UINT32;
47530d68baSNigel Croxon typedef int32_t    INT32;
48530d68baSNigel Croxon 
49530d68baSNigel Croxon typedef uint16_t   UINT16;
50530d68baSNigel Croxon typedef int16_t    INT16;
51530d68baSNigel Croxon typedef uint8_t    UINT8;
52530d68baSNigel Croxon typedef int8_t     INT8;
53530d68baSNigel Croxon typedef __WCHAR_TYPE__ WCHAR;
54530d68baSNigel Croxon 
55530d68baSNigel Croxon #undef VOID
56530d68baSNigel Croxon #define VOID    void
57530d68baSNigel Croxon 
58530d68baSNigel Croxon typedef int64_t    INTN;
59530d68baSNigel Croxon typedef uint64_t   UINTN;
60530d68baSNigel Croxon 
61530d68baSNigel Croxon #define EFIERR(a)           (0x8000000000000000 | a)
62530d68baSNigel Croxon #define EFI_ERROR_MASK      0x8000000000000000
63530d68baSNigel Croxon #define EFIERR_OEM(a)       (0xc000000000000000 | a)
64530d68baSNigel Croxon 
65530d68baSNigel Croxon #define BAD_POINTER         0xFBFBFBFBFBFBFBFB
66530d68baSNigel Croxon #define MAX_ADDRESS         0xFFFFFFFFFFFFFFFF
67530d68baSNigel Croxon 
68530d68baSNigel Croxon #define BREAKPOINT()        while (TRUE);    // Make it hang on Bios[Dbg]32
69530d68baSNigel Croxon 
70530d68baSNigel Croxon //
71530d68baSNigel Croxon // Pointers must be aligned to these address to function
72530d68baSNigel Croxon //
73530d68baSNigel Croxon 
74530d68baSNigel Croxon #define MIN_ALIGNMENT_SIZE  8
75530d68baSNigel Croxon 
76530d68baSNigel Croxon #define ALIGN_VARIABLE(Value ,Adjustment) \
77530d68baSNigel Croxon             (UINTN)Adjustment = 0; \
78530d68baSNigel Croxon             if((UINTN)Value % MIN_ALIGNMENT_SIZE) \
79530d68baSNigel Croxon                 (UINTN)Adjustment = MIN_ALIGNMENT_SIZE - ((UINTN)Value % MIN_ALIGNMENT_SIZE); \
80530d68baSNigel Croxon             Value = (UINTN)Value + (UINTN)Adjustment
81530d68baSNigel Croxon 
82530d68baSNigel Croxon 
83530d68baSNigel Croxon //
84530d68baSNigel Croxon // Define macros to build data structure signatures from characters.
85530d68baSNigel Croxon //
86530d68baSNigel Croxon 
87530d68baSNigel Croxon #define EFI_SIGNATURE_16(A,B)             ((A) | (B<<8))
88530d68baSNigel Croxon #define EFI_SIGNATURE_32(A,B,C,D)         (EFI_SIGNATURE_16(A,B)     | (EFI_SIGNATURE_16(C,D)     << 16))
89530d68baSNigel Croxon #define EFI_SIGNATURE_64(A,B,C,D,E,F,G,H) (EFI_SIGNATURE_32(A,B,C,D) | ((UINT64)(EFI_SIGNATURE_32(E,F,G,H)) << 32))
90530d68baSNigel Croxon 
91530d68baSNigel Croxon //
92530d68baSNigel Croxon // EFIAPI - prototype calling convention for EFI function pointers
93530d68baSNigel Croxon // BOOTSERVICE - prototype for implementation of a boot service interface
94530d68baSNigel Croxon // RUNTIMESERVICE - prototype for implementation of a runtime service interface
95530d68baSNigel Croxon // RUNTIMEFUNCTION - prototype for implementation of a runtime function that is not a service
96530d68baSNigel Croxon // RUNTIME_CODE - pragma macro for declaring runtime code
97530d68baSNigel Croxon //
98530d68baSNigel Croxon 
99530d68baSNigel Croxon #ifndef EFIAPI          // Forces EFI calling conventions reguardless of compiler options
100530d68baSNigel Croxon #define EFIAPI          // Substitute expresion to force C calling convention
101530d68baSNigel Croxon #endif
102530d68baSNigel Croxon 
103530d68baSNigel Croxon #define BOOTSERVICE
104530d68baSNigel Croxon #define RUNTIMESERVICE
105530d68baSNigel Croxon #define RUNTIMEFUNCTION
106530d68baSNigel Croxon 
107530d68baSNigel Croxon 
108530d68baSNigel Croxon #define RUNTIME_CODE(a)         alloc_text("rtcode", a)
109530d68baSNigel Croxon #define BEGIN_RUNTIME_DATA()    data_seg("rtdata")
110530d68baSNigel Croxon #define END_RUNTIME_DATA()      data_seg("")
111530d68baSNigel Croxon 
112530d68baSNigel Croxon #define VOLATILE                volatile
113530d68baSNigel Croxon 
114530d68baSNigel Croxon #define MEMORY_FENCE            __sync_synchronize
115530d68baSNigel Croxon 
116530d68baSNigel Croxon //
117530d68baSNigel Croxon // When build similiar to FW, then link everything together as
118*787b53a6SNigel Croxon // one big module. For the MSVC toolchain, we simply tell the
119*787b53a6SNigel Croxon // linker what our driver init function is using /ENTRY.
120530d68baSNigel Croxon //
121*787b53a6SNigel Croxon #if defined(_MSC_EXTENSIONS)
122*787b53a6SNigel Croxon #define EFI_DRIVER_ENTRY_POINT(InitFunction) \
123*787b53a6SNigel Croxon     __pragma(comment(linker, "/ENTRY:" # InitFunction))
124*787b53a6SNigel Croxon #else
125530d68baSNigel Croxon #define EFI_DRIVER_ENTRY_POINT(InitFunction)    \
126530d68baSNigel Croxon     UINTN                                       \
127530d68baSNigel Croxon     InitializeDriver (                          \
128530d68baSNigel Croxon         VOID    *ImageHandle,                   \
129530d68baSNigel Croxon         VOID    *SystemTable                    \
130530d68baSNigel Croxon         )                                       \
131530d68baSNigel Croxon     {                                           \
132530d68baSNigel Croxon         return InitFunction(ImageHandle,        \
133530d68baSNigel Croxon                 SystemTable);                   \
134530d68baSNigel Croxon     }                                           \
135530d68baSNigel Croxon                                                 \
136530d68baSNigel Croxon     EFI_STATUS efi_main(                        \
137530d68baSNigel Croxon         EFI_HANDLE image,                       \
138530d68baSNigel Croxon         EFI_SYSTEM_TABLE *systab                \
139530d68baSNigel Croxon         ) __attribute__((weak,                  \
140530d68baSNigel Croxon                 alias ("InitializeDriver")));
141*787b53a6SNigel Croxon #endif
142530d68baSNigel Croxon 
143530d68baSNigel Croxon #define LOAD_INTERNAL_DRIVER(_if, type, name, entry)    \
144530d68baSNigel Croxon         (_if)->LoadInternal(type, name, entry)
145530d68baSNigel Croxon 
146530d68baSNigel Croxon 
147530d68baSNigel Croxon //
148530d68baSNigel Croxon // Some compilers don't support the forward reference construct:
149530d68baSNigel Croxon //  typedef struct XXXXX
150530d68baSNigel Croxon //
151530d68baSNigel Croxon // The following macro provide a workaround for such cases.
152530d68baSNigel Croxon 
153530d68baSNigel Croxon #define INTERFACE_DECL(x) struct x
154530d68baSNigel Croxon 
155530d68baSNigel Croxon #define uefi_call_wrapper(func, va_num, ...) func(__VA_ARGS__)
156530d68baSNigel Croxon #define EFI_FUNCTION
157