xref: /DragonStub/inc/aarch64/efibind.h (revision 056bdaa53e8dbffbf5363cc9a58ccea666334be3)
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 
186685cd00SAlexander von Gluck IV #if !defined(_MSC_VER) && (!defined(__STDC_VERSION__) || (__STDC_VERSION__ < 199901L )) && !defined(__cplusplus)
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
301a53d8f8SEsben Haabendal typedef uint64_t            uintptr_t;
311a53d8f8SEsben Haabendal typedef int64_t             intptr_t;
32333bf05dSNigel Croxon 
33333bf05dSNigel Croxon #else
34530d68baSNigel Croxon #include <stdint.h>
35333bf05dSNigel Croxon #endif
36530d68baSNigel Croxon 
37530d68baSNigel Croxon //
38530d68baSNigel Croxon // Basic EFI types of various widths
39530d68baSNigel Croxon //
40530d68baSNigel Croxon 
41189200d0SCallum Farmer #include <stddef.h>
42189200d0SCallum Farmer 
43189200d0SCallum Farmer typedef wchar_t CHAR16;
44189200d0SCallum Farmer #define WCHAR CHAR16
45530d68baSNigel Croxon 
46530d68baSNigel Croxon typedef uint64_t   UINT64;
47530d68baSNigel Croxon typedef int64_t    INT64;
48530d68baSNigel Croxon 
49530d68baSNigel Croxon typedef uint32_t   UINT32;
50530d68baSNigel Croxon typedef int32_t    INT32;
51530d68baSNigel Croxon 
52530d68baSNigel Croxon typedef uint16_t   UINT16;
53530d68baSNigel Croxon typedef int16_t    INT16;
5414899d89SPeter Jones 
55530d68baSNigel Croxon typedef uint8_t    UINT8;
5614899d89SPeter Jones typedef char       CHAR8;
57530d68baSNigel Croxon typedef int8_t     INT8;
5814899d89SPeter Jones 
59530d68baSNigel Croxon #undef VOID
60*056bdaa5SCallum Farmer typedef void       VOID;
61530d68baSNigel Croxon 
62530d68baSNigel Croxon typedef int64_t    INTN;
63530d68baSNigel Croxon typedef uint64_t   UINTN;
64530d68baSNigel Croxon 
65530d68baSNigel Croxon #define EFIERR(a)           (0x8000000000000000 | a)
66530d68baSNigel Croxon #define EFI_ERROR_MASK      0x8000000000000000
67530d68baSNigel Croxon #define EFIERR_OEM(a)       (0xc000000000000000 | a)
68530d68baSNigel Croxon 
69530d68baSNigel Croxon #define BAD_POINTER         0xFBFBFBFBFBFBFBFB
70530d68baSNigel Croxon #define MAX_ADDRESS         0xFFFFFFFFFFFFFFFF
71530d68baSNigel Croxon 
72530d68baSNigel Croxon #define BREAKPOINT()        while (TRUE);    // Make it hang on Bios[Dbg]32
73530d68baSNigel Croxon 
74530d68baSNigel Croxon //
75530d68baSNigel Croxon // Pointers must be aligned to these address to function
76530d68baSNigel Croxon //
77530d68baSNigel Croxon 
78530d68baSNigel Croxon #define MIN_ALIGNMENT_SIZE  8
79530d68baSNigel Croxon 
80530d68baSNigel Croxon #define ALIGN_VARIABLE(Value ,Adjustment) \
81530d68baSNigel Croxon             (UINTN)Adjustment = 0; \
82530d68baSNigel Croxon             if((UINTN)Value % MIN_ALIGNMENT_SIZE) \
83530d68baSNigel Croxon                 (UINTN)Adjustment = MIN_ALIGNMENT_SIZE - ((UINTN)Value % MIN_ALIGNMENT_SIZE); \
84530d68baSNigel Croxon             Value = (UINTN)Value + (UINTN)Adjustment
85530d68baSNigel Croxon 
86530d68baSNigel Croxon 
87530d68baSNigel Croxon //
88530d68baSNigel Croxon // Define macros to build data structure signatures from characters.
89530d68baSNigel Croxon //
90530d68baSNigel Croxon 
91530d68baSNigel Croxon #define EFI_SIGNATURE_16(A,B)             ((A) | (B<<8))
92530d68baSNigel Croxon #define EFI_SIGNATURE_32(A,B,C,D)         (EFI_SIGNATURE_16(A,B)     | (EFI_SIGNATURE_16(C,D)     << 16))
93530d68baSNigel 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))
94530d68baSNigel Croxon 
95530d68baSNigel Croxon //
96530d68baSNigel Croxon // EFIAPI - prototype calling convention for EFI function pointers
97530d68baSNigel Croxon // BOOTSERVICE - prototype for implementation of a boot service interface
98530d68baSNigel Croxon // RUNTIMESERVICE - prototype for implementation of a runtime service interface
99530d68baSNigel Croxon // RUNTIMEFUNCTION - prototype for implementation of a runtime function that is not a service
100530d68baSNigel Croxon // RUNTIME_CODE - pragma macro for declaring runtime code
101530d68baSNigel Croxon //
102530d68baSNigel Croxon 
103530d68baSNigel Croxon #ifndef EFIAPI          // Forces EFI calling conventions reguardless of compiler options
104530d68baSNigel Croxon #define EFIAPI          // Substitute expresion to force C calling convention
105530d68baSNigel Croxon #endif
106530d68baSNigel Croxon 
107530d68baSNigel Croxon #define BOOTSERVICE
108530d68baSNigel Croxon #define RUNTIMESERVICE
109530d68baSNigel Croxon #define RUNTIMEFUNCTION
110530d68baSNigel Croxon 
111530d68baSNigel Croxon 
112530d68baSNigel Croxon #define RUNTIME_CODE(a)         alloc_text("rtcode", a)
113530d68baSNigel Croxon #define BEGIN_RUNTIME_DATA()    data_seg("rtdata")
114530d68baSNigel Croxon #define END_RUNTIME_DATA()      data_seg("")
115530d68baSNigel Croxon 
116530d68baSNigel Croxon #define VOLATILE                volatile
117530d68baSNigel Croxon 
118530d68baSNigel Croxon #define MEMORY_FENCE            __sync_synchronize
119530d68baSNigel Croxon 
120530d68baSNigel Croxon //
121530d68baSNigel Croxon // When build similiar to FW, then link everything together as
122787b53a6SNigel Croxon // one big module. For the MSVC toolchain, we simply tell the
123787b53a6SNigel Croxon // linker what our driver init function is using /ENTRY.
124530d68baSNigel Croxon //
125787b53a6SNigel Croxon #if defined(_MSC_EXTENSIONS)
126787b53a6SNigel Croxon #define EFI_DRIVER_ENTRY_POINT(InitFunction) \
127787b53a6SNigel Croxon     __pragma(comment(linker, "/ENTRY:" # InitFunction))
128787b53a6SNigel Croxon #else
129530d68baSNigel Croxon #define EFI_DRIVER_ENTRY_POINT(InitFunction)    \
130530d68baSNigel Croxon     UINTN                                       \
131530d68baSNigel Croxon     InitializeDriver (                          \
132530d68baSNigel Croxon         VOID    *ImageHandle,                   \
133530d68baSNigel Croxon         VOID    *SystemTable                    \
134530d68baSNigel Croxon         )                                       \
135530d68baSNigel Croxon     {                                           \
136530d68baSNigel Croxon         return InitFunction(ImageHandle,        \
137530d68baSNigel Croxon                 SystemTable);                   \
138530d68baSNigel Croxon     }                                           \
139530d68baSNigel Croxon                                                 \
140530d68baSNigel Croxon     EFI_STATUS efi_main(                        \
141530d68baSNigel Croxon         EFI_HANDLE image,                       \
142530d68baSNigel Croxon         EFI_SYSTEM_TABLE *systab                \
143530d68baSNigel Croxon         ) __attribute__((weak,                  \
144530d68baSNigel Croxon                 alias ("InitializeDriver")));
145787b53a6SNigel Croxon #endif
146530d68baSNigel Croxon 
147530d68baSNigel Croxon #define LOAD_INTERNAL_DRIVER(_if, type, name, entry)    \
148530d68baSNigel Croxon         (_if)->LoadInternal(type, name, entry)
149530d68baSNigel Croxon 
150530d68baSNigel Croxon 
151530d68baSNigel Croxon //
152530d68baSNigel Croxon // Some compilers don't support the forward reference construct:
153530d68baSNigel Croxon //  typedef struct XXXXX
154530d68baSNigel Croxon //
155530d68baSNigel Croxon // The following macro provide a workaround for such cases.
156530d68baSNigel Croxon 
157530d68baSNigel Croxon #define INTERFACE_DECL(x) struct x
158530d68baSNigel Croxon 
159530d68baSNigel Croxon #define uefi_call_wrapper(func, va_num, ...) func(__VA_ARGS__)
160530d68baSNigel Croxon #define EFI_FUNCTION
161