1 | /*
|
---|
2 | * Copyright (c) 2007 Michal Kebrt
|
---|
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 | *
|
---|
9 | * - Redistributions of source code must retain the above copyright
|
---|
10 | * notice, this list of conditions and the following disclaimer.
|
---|
11 | * - Redistributions in binary form must reproduce the above copyright
|
---|
12 | * notice, this list of conditions and the following disclaimer in the
|
---|
13 | * documentation and/or other materials provided with the distribution.
|
---|
14 | * - The name of the author may not be used to endorse or promote products
|
---|
15 | * derived from this software without specific prior written permission.
|
---|
16 | *
|
---|
17 | * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
|
---|
18 | * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
|
---|
19 | * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
|
---|
20 | * IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
|
---|
21 | * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
|
---|
22 | * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
|
---|
23 | * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
|
---|
24 | * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
|
---|
25 | * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
|
---|
26 | * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
|
---|
27 | */
|
---|
28 |
|
---|
29 | /** @addtogroup arm32
|
---|
30 | * @{
|
---|
31 | */
|
---|
32 | /** @file
|
---|
33 | * @brief Declarations of machine specific functions.
|
---|
34 | *
|
---|
35 | * These functions enable to differentiate more kinds of ARM emulators
|
---|
36 | * or CPUs. It's the same concept as "arch" functions on the architecture
|
---|
37 | * level.
|
---|
38 | */
|
---|
39 |
|
---|
40 | #ifndef KERN_arm32_MACHINE_H_
|
---|
41 | #define KERN_arm32_MACHINE_H_
|
---|
42 |
|
---|
43 | #include <console/console.h>
|
---|
44 | #include <arch/types.h>
|
---|
45 | #include <arch/exception.h>
|
---|
46 | #include <arch/drivers/gxemul.h>
|
---|
47 |
|
---|
48 |
|
---|
49 | /** Initializes console.
|
---|
50 | *
|
---|
51 | * @param devno Console device number.
|
---|
52 | */
|
---|
53 | extern void machine_console_init(devno_t devno);
|
---|
54 |
|
---|
55 |
|
---|
56 | /** Acquire console back for kernel. */
|
---|
57 | extern void machine_grab_console(void);
|
---|
58 |
|
---|
59 |
|
---|
60 | /** Return console to userspace. */
|
---|
61 | extern void machine_release_console(void);
|
---|
62 |
|
---|
63 |
|
---|
64 | /** Maps HW devices to the kernel address space using #hw_map. */
|
---|
65 | extern void machine_hw_map_init(void);
|
---|
66 |
|
---|
67 |
|
---|
68 | /** Starts timer. */
|
---|
69 | extern void machine_timer_irq_start(void);
|
---|
70 |
|
---|
71 |
|
---|
72 | /** Halts CPU. */
|
---|
73 | extern void machine_cpu_halt(void);
|
---|
74 |
|
---|
75 |
|
---|
76 | /** Returns size of available memory.
|
---|
77 | *
|
---|
78 | * @return Size of available memory.
|
---|
79 | */
|
---|
80 | extern size_t machine_get_memory_size(void);
|
---|
81 |
|
---|
82 |
|
---|
83 | /** Prints a character.
|
---|
84 | *
|
---|
85 | * @param ch Character to be printed.
|
---|
86 | */
|
---|
87 | extern void machine_debug_putc(char ch);
|
---|
88 |
|
---|
89 |
|
---|
90 | /** Interrupt exception handler.
|
---|
91 | *
|
---|
92 | * @param exc_no Interrupt exception number.
|
---|
93 | * @param istate Saved processor state.
|
---|
94 | */
|
---|
95 | extern void machine_irq_exception(int exc_no, istate_t *istate);
|
---|
96 |
|
---|
97 |
|
---|
98 | /** Returns address of framebuffer device.
|
---|
99 | *
|
---|
100 | * @return Address of framebuffer device.
|
---|
101 | */
|
---|
102 | extern uintptr_t machine_get_fb_address(void);
|
---|
103 |
|
---|
104 |
|
---|
105 | #ifdef MACHINE_GXEMUL_TESTARM
|
---|
106 | #define machine_console_init(devno) gxemul_console_init(devno)
|
---|
107 | #define machine_grab_console gxemul_grab_console
|
---|
108 | #define machine_release_console gxemul_release_console
|
---|
109 | #define machine_hw_map_init gxemul_hw_map_init
|
---|
110 | #define machine_timer_irq_start gxemul_timer_irq_start
|
---|
111 | #define machine_cpu_halt gxemul_cpu_halt
|
---|
112 | #define machine_get_memory_size gxemul_get_memory_size
|
---|
113 | #define machine_debug_putc(ch) gxemul_debug_putc(ch)
|
---|
114 | #define machine_irq_exception(exc_no, istate) gxemul_irq_exception(exc_no, istate)
|
---|
115 | #define machine_get_fb_address gxemul_get_fb_address
|
---|
116 | #endif
|
---|
117 |
|
---|
118 | #endif
|
---|
119 |
|
---|
120 | /** @}
|
---|
121 | */
|
---|