| 1 | /////////////////////////////////////////////////////////////////////////////////// |
|---|
| 2 | // File : utils.h |
|---|
| 3 | // Date : 18/10/2013 |
|---|
| 4 | // Author : alain greiner |
|---|
| 5 | // Copyright (c) UPMC-LIP6 |
|---|
| 6 | /////////////////////////////////////////////////////////////////////////////////// |
|---|
| 7 | // The utils.c and utils.h files are part of the GIET-VM nano-kernel. |
|---|
| 8 | // They define more or less the GIET-VM HAL (Hardware Abstraction Layer), |
|---|
| 9 | // and contains various utility functions, that can be used by both the |
|---|
| 10 | // boot code and the kernel code. |
|---|
| 11 | /////////////////////////////////////////////////////////////////////////////////// |
|---|
| 12 | |
|---|
| 13 | #ifndef GIET_UTILS_H |
|---|
| 14 | #define GIET_UTILS_H |
|---|
| 15 | |
|---|
| 16 | #include <mapping_info.h> |
|---|
| 17 | #include <giet_config.h> |
|---|
| 18 | |
|---|
| 19 | ////////////////////////////////////////////////////////////////////////////////// |
|---|
| 20 | // NULL pointer definition |
|---|
| 21 | ////////////////////////////////////////////////////////////////////////////////// |
|---|
| 22 | |
|---|
| 23 | #define NULL (void *)0 |
|---|
| 24 | |
|---|
| 25 | /////////////////////////////////////////////////////////////////////////////////// |
|---|
| 26 | // For retrieving base addresses defined in seg.ld file. |
|---|
| 27 | /////////////////////////////////////////////////////////////////////////////////// |
|---|
| 28 | |
|---|
| 29 | typedef struct _ld_symbol_s _ld_symbol_t; |
|---|
| 30 | |
|---|
| 31 | // boot segments vbase addresses & sizes |
|---|
| 32 | extern _ld_symbol_t boot_code_vbase; |
|---|
| 33 | extern _ld_symbol_t boot_code_size; |
|---|
| 34 | |
|---|
| 35 | extern _ld_symbol_t boot_data_vbase; |
|---|
| 36 | extern _ld_symbol_t boot_data_size; |
|---|
| 37 | |
|---|
| 38 | extern _ld_symbol_t boot_stack_vbase; |
|---|
| 39 | extern _ld_symbol_t boot_stack_size; |
|---|
| 40 | |
|---|
| 41 | extern _ld_symbol_t boot_mapping_vbase; |
|---|
| 42 | extern _ld_symbol_t boot_mapping_size; |
|---|
| 43 | |
|---|
| 44 | extern _ld_symbol_t boot_buffer_vbase; |
|---|
| 45 | extern _ld_symbol_t boot_buffer_size; |
|---|
| 46 | |
|---|
| 47 | // kernel segments vbase addresses & sizes |
|---|
| 48 | extern _ld_symbol_t kernel_code_vbase; |
|---|
| 49 | extern _ld_symbol_t kernel_code_size; |
|---|
| 50 | |
|---|
| 51 | extern _ld_symbol_t kernel_data_vbase; |
|---|
| 52 | extern _ld_symbol_t kernel_data_size; |
|---|
| 53 | |
|---|
| 54 | extern _ld_symbol_t kernel_uncdata_vbase; |
|---|
| 55 | extern _ld_symbol_t kernel_uncdata_size; |
|---|
| 56 | |
|---|
| 57 | extern _ld_symbol_t kernel_init_vbase; |
|---|
| 58 | extern _ld_symbol_t kernel_init_size; |
|---|
| 59 | |
|---|
| 60 | /////////////////////////////////////////////////////////////////////////////////// |
|---|
| 61 | // Memory handling functions |
|---|
| 62 | /////////////////////////////////////////////////////////////////////////////////// |
|---|
| 63 | |
|---|
| 64 | extern void* _memcpy( void* _dst, |
|---|
| 65 | const void* _src, |
|---|
| 66 | unsigned int size ); |
|---|
| 67 | |
|---|
| 68 | extern void* _memset( void* dst, |
|---|
| 69 | int s, |
|---|
| 70 | unsigned int count ); |
|---|
| 71 | |
|---|
| 72 | /////////////////////////////////////////////////////////////////////////////////// |
|---|
| 73 | // Break function |
|---|
| 74 | /////////////////////////////////////////////////////////////////////////////////// |
|---|
| 75 | |
|---|
| 76 | extern void _break( char* str); |
|---|
| 77 | |
|---|
| 78 | /////////////////////////////////////////////////////////////////////////////////// |
|---|
| 79 | // Suicide function |
|---|
| 80 | /////////////////////////////////////////////////////////////////////////////////// |
|---|
| 81 | |
|---|
| 82 | extern void _exit(void); |
|---|
| 83 | |
|---|
| 84 | /////////////////////////////////////////////////////////////////////////////////// |
|---|
| 85 | // Eret function |
|---|
| 86 | /////////////////////////////////////////////////////////////////////////////////// |
|---|
| 87 | |
|---|
| 88 | extern void _eret(void); |
|---|
| 89 | |
|---|
| 90 | /////////////////////////////////////////////////////////////////////////////////// |
|---|
| 91 | // CP0 and CP2 registers access functions |
|---|
| 92 | /////////////////////////////////////////////////////////////////////////////////// |
|---|
| 93 | |
|---|
| 94 | extern unsigned int _get_sched(void); |
|---|
| 95 | extern unsigned int _get_mmu_ptpr(void); |
|---|
| 96 | extern unsigned int _get_mmu_mode(void); |
|---|
| 97 | extern unsigned int _get_epc(void); |
|---|
| 98 | extern unsigned int _get_bvar(void); |
|---|
| 99 | extern unsigned int _get_cr(void); |
|---|
| 100 | extern unsigned int _get_sr(void); |
|---|
| 101 | extern unsigned int _get_procid(void); |
|---|
| 102 | extern unsigned int _get_proctime(void); |
|---|
| 103 | extern unsigned int _get_current_task_id(void); |
|---|
| 104 | |
|---|
| 105 | extern void _it_disable( unsigned int* save_sr_ptr ); |
|---|
| 106 | extern void _it_enable(void); |
|---|
| 107 | extern void _it_restore( unsigned int* save_sr_ptr ); |
|---|
| 108 | |
|---|
| 109 | extern void _set_mmu_ptpr(unsigned int value); |
|---|
| 110 | extern void _set_mmu_mode(unsigned int value); |
|---|
| 111 | extern void _set_sched(unsigned int value); |
|---|
| 112 | extern void _set_sr(unsigned int value); |
|---|
| 113 | |
|---|
| 114 | /////////////////////////////////////////////////////////////////////////////////// |
|---|
| 115 | // Physical addressing related functions |
|---|
| 116 | /////////////////////////////////////////////////////////////////////////////////// |
|---|
| 117 | |
|---|
| 118 | extern unsigned int _physical_read( unsigned long long paddr ); |
|---|
| 119 | |
|---|
| 120 | extern void _physical_write( unsigned long long paddr, |
|---|
| 121 | unsigned int value ); |
|---|
| 122 | |
|---|
| 123 | extern unsigned int _io_extended_read( unsigned int* vaddr ); |
|---|
| 124 | |
|---|
| 125 | extern void _io_extended_write( unsigned int* vaddr, |
|---|
| 126 | unsigned int value ); |
|---|
| 127 | |
|---|
| 128 | /////////////////////////////////////////////////////////////////////////////////// |
|---|
| 129 | // Locks access functions |
|---|
| 130 | /////////////////////////////////////////////////////////////////////////////////// |
|---|
| 131 | |
|---|
| 132 | extern void _get_lock(unsigned int * lock); |
|---|
| 133 | extern void _release_lock(unsigned int * lock); |
|---|
| 134 | |
|---|
| 135 | /////////////////////////////////////////////////////////////////////////////////// |
|---|
| 136 | // TTY0 access functions |
|---|
| 137 | /////////////////////////////////////////////////////////////////////////////////// |
|---|
| 138 | |
|---|
| 139 | extern void _puts( char* string ); |
|---|
| 140 | |
|---|
| 141 | extern void _putx( unsigned int val ); |
|---|
| 142 | |
|---|
| 143 | extern void _putd( unsigned int val ); |
|---|
| 144 | |
|---|
| 145 | extern void _putl( unsigned long long val ); |
|---|
| 146 | |
|---|
| 147 | extern void _printf(char* format, ...); |
|---|
| 148 | |
|---|
| 149 | extern void _getc( char* byte ); |
|---|
| 150 | |
|---|
| 151 | /////////////////////////////////////////////////////////////////////////////////// |
|---|
| 152 | // string compare functions |
|---|
| 153 | /////////////////////////////////////////////////////////////////////////////////// |
|---|
| 154 | |
|---|
| 155 | extern unsigned int _strncmp(const char* s1, |
|---|
| 156 | const char* s2, |
|---|
| 157 | unsigned int n); |
|---|
| 158 | |
|---|
| 159 | extern char* _strcpy( char* dest, |
|---|
| 160 | char* source ); |
|---|
| 161 | |
|---|
| 162 | /////////////////////////////////////////////////////////////////////////////////// |
|---|
| 163 | // cache invalidate function |
|---|
| 164 | /////////////////////////////////////////////////////////////////////////////////// |
|---|
| 165 | |
|---|
| 166 | extern void _dcache_buf_invalidate( void * buffer, |
|---|
| 167 | unsigned int size ); |
|---|
| 168 | |
|---|
| 169 | /////////////////////////////////////////////////////////////////////////////////// |
|---|
| 170 | // Schedulers access functions |
|---|
| 171 | /////////////////////////////////////////////////////////////////////////////////// |
|---|
| 172 | |
|---|
| 173 | extern unsigned int _get_task_slot( unsigned int gpid, |
|---|
| 174 | unsigned int ltid, |
|---|
| 175 | unsigned int slot ); |
|---|
| 176 | |
|---|
| 177 | extern void _set_task_slot( unsigned int gpid, |
|---|
| 178 | unsigned int ltid, |
|---|
| 179 | unsigned int slot, |
|---|
| 180 | unsigned int value ); |
|---|
| 181 | |
|---|
| 182 | extern unsigned int _get_context_slot( unsigned int slot ); |
|---|
| 183 | |
|---|
| 184 | extern void _set_context_slot( unsigned int slot, |
|---|
| 185 | unsigned int value ); |
|---|
| 186 | |
|---|
| 187 | extern unsigned int _heap_info( unsigned int* vaddr, |
|---|
| 188 | unsigned int* size ); |
|---|
| 189 | |
|---|
| 190 | /////////////////////////////////////////////////////////////////////////////////// |
|---|
| 191 | // Mapping access functions |
|---|
| 192 | /////////////////////////////////////////////////////////////////////////////////// |
|---|
| 193 | |
|---|
| 194 | extern mapping_cluster_t * _get_cluster_base(mapping_header_t* header); |
|---|
| 195 | extern mapping_pseg_t * _get_pseg_base(mapping_header_t* header); |
|---|
| 196 | extern mapping_vspace_t * _get_vspace_base(mapping_header_t* header); |
|---|
| 197 | extern mapping_vseg_t * _get_vseg_base(mapping_header_t* header); |
|---|
| 198 | extern mapping_vobj_t * _get_vobj_base(mapping_header_t* header); |
|---|
| 199 | extern mapping_task_t * _get_task_base(mapping_header_t* header); |
|---|
| 200 | extern mapping_proc_t * _get_proc_base(mapping_header_t* header); |
|---|
| 201 | extern mapping_irq_t * _get_irq_base(mapping_header_t* header); |
|---|
| 202 | extern mapping_coproc_t * _get_coproc_base(mapping_header_t* header); |
|---|
| 203 | extern mapping_cp_port_t * _get_cp_port_base(mapping_header_t* header); |
|---|
| 204 | extern mapping_periph_t * _get_periph_base(mapping_header_t* header); |
|---|
| 205 | |
|---|
| 206 | #endif |
|---|
| 207 | |
|---|
| 208 | // Local Variables: |
|---|
| 209 | // tab-width: 4 |
|---|
| 210 | // c-basic-offset: 4 |
|---|
| 211 | // c-file-offsets:((innamespace . 0)(inline-open . 0)) |
|---|
| 212 | // indent-tabs-mode: nil |
|---|
| 213 | // End: |
|---|
| 214 | // vim: filetype=c:expandtab:shiftwidth=4:tabstop=4:softtabstop=4 |
|---|
| 215 | |
|---|