Linux Kernel  3.7.1
 All Data Structures Namespaces Files Functions Variables Typedefs Enumerations Enumerator Macros Groups Pages
openprom.h
Go to the documentation of this file.
1 #ifndef __SPARC_OPENPROM_H
2 #define __SPARC_OPENPROM_H
3 
4 /* openprom.h: Prom structures and defines for access to the OPENBOOT
5  * prom routines and data areas.
6  *
7  * Copyright (C) 1995,1996 David S. Miller ([email protected])
8  */
9 
10 /* Empirical constants... */
11 #define LINUX_OPPROM_MAGIC 0x10010407
12 
13 #ifndef __ASSEMBLY__
14 #include <linux/of.h>
15 
16 /* V0 prom device operations. */
17 struct linux_dev_v0_funcs {
18  int (*v0_devopen)(char *device_str);
19  int (*v0_devclose)(int dev_desc);
20  int (*v0_rdblkdev)(int dev_desc, int num_blks, int blk_st, char *buf);
21  int (*v0_wrblkdev)(int dev_desc, int num_blks, int blk_st, char *buf);
22  int (*v0_wrnetdev)(int dev_desc, int num_bytes, char *buf);
23  int (*v0_rdnetdev)(int dev_desc, int num_bytes, char *buf);
24  int (*v0_rdchardev)(int dev_desc, int num_bytes, int dummy, char *buf);
25  int (*v0_wrchardev)(int dev_desc, int num_bytes, int dummy, char *buf);
26  int (*v0_seekdev)(int dev_desc, long logical_offst, int from);
27 };
28 
29 /* V2 and later prom device operations. */
30 struct linux_dev_v2_funcs {
31  phandle (*v2_inst2pkg)(int d); /* Convert ihandle to phandle */
32  char * (*v2_dumb_mem_alloc)(char *va, unsigned sz);
33  void (*v2_dumb_mem_free)(char *va, unsigned sz);
34 
35  /* To map devices into virtual I/O space. */
36  char * (*v2_dumb_mmap)(char *virta, int which_io, unsigned paddr, unsigned sz);
37  void (*v2_dumb_munmap)(char *virta, unsigned size);
38 
39  int (*v2_dev_open)(char *devpath);
40  void (*v2_dev_close)(int d);
41  int (*v2_dev_read)(int d, char *buf, int nbytes);
42  int (*v2_dev_write)(int d, const char *buf, int nbytes);
43  int (*v2_dev_seek)(int d, int hi, int lo);
44 
45  /* Never issued (multistage load support) */
46  void (*v2_wheee2)(void);
47  void (*v2_wheee3)(void);
48 };
49 
50 struct linux_mlist_v0 {
52  unsigned int start_adr;
53  unsigned num_bytes;
54 };
55 
56 struct linux_mem_v0 {
57  struct linux_mlist_v0 **v0_totphys;
58  struct linux_mlist_v0 **v0_prommap;
59  struct linux_mlist_v0 **v0_available; /* What we can use */
60 };
61 
62 /* Arguments sent to the kernel from the boot prompt. */
63 struct linux_arguments_v0 {
64  char *argv[8];
65  char args[100];
66  char boot_dev[2];
67  int boot_dev_ctrl;
68  int boot_dev_unit;
69  int dev_partition;
70  char *kernel_file_name;
71  void *aieee1; /* XXX */
72 };
73 
74 /* V2 and up boot things. */
75 struct linux_bootargs_v2 {
76  char **bootpath;
77  char **bootargs;
78  int *fd_stdin;
79  int *fd_stdout;
80 };
81 
82 /* The top level PROM vector. */
83 struct linux_romvec {
84  /* Version numbers. */
85  unsigned int pv_magic_cookie;
86  unsigned int pv_romvers;
87  unsigned int pv_plugin_revision;
88  unsigned int pv_printrev;
89 
90  /* Version 0 memory descriptors. */
91  struct linux_mem_v0 pv_v0mem;
92 
93  /* Node operations. */
94  struct linux_nodeops *pv_nodeops;
95 
96  char **pv_bootstr;
98 
99  char *pv_stdin;
100  char *pv_stdout;
101 #define PROMDEV_KBD 0 /* input from keyboard */
102 #define PROMDEV_SCREEN 0 /* output to screen */
103 #define PROMDEV_TTYA 1 /* in/out to ttya */
104 #define PROMDEV_TTYB 2 /* in/out to ttyb */
105 
106  /* Blocking getchar/putchar. NOT REENTRANT! (grr) */
107  int (*pv_getchar)(void);
108  void (*pv_putchar)(int ch);
109 
110  /* Non-blocking variants. */
111  int (*pv_nbgetchar)(void);
112  int (*pv_nbputchar)(int ch);
113 
114  void (*pv_putstr)(char *str, int len);
115 
116  /* Miscellany. */
117  void (*pv_reboot)(char *bootstr);
118  void (*pv_printf)(__const__ char *fmt, ...);
119  void (*pv_abort)(void);
120  __volatile__ int *pv_ticks;
121  void (*pv_halt)(void);
122  void (**pv_synchook)(void);
123 
124  /* Evaluate a forth string, not different proto for V0 and V2->up. */
125  union {
126  void (*v0_eval)(int len, char *str);
127  void (*v2_eval)(char *str);
128  } pv_fortheval;
129 
131 
132  /* Get ether address. */
133  unsigned int (*pv_enaddr)(int d, char *enaddr);
134 
137 
138  int filler[15];
139 
140  /* This one is sun4c/sun4 only. */
141  void (*pv_setctxt)(int ctxt, char *va, int pmeg);
142 
143  /* Prom version 3 Multiprocessor routines. This stuff is crazy.
144  * No joke. Calling these when there is only one cpu probably
145  * crashes the machine, have to test this. :-)
146  */
147 
148  /* v3_cpustart() will start the cpu 'whichcpu' in mmu-context
149  * 'thiscontext' executing at address 'prog_counter'
150  */
151  int (*v3_cpustart)(unsigned int whichcpu, int ctxtbl_ptr,
152  int thiscontext, char *prog_counter);
153 
154  /* v3_cpustop() will cause cpu 'whichcpu' to stop executing
155  * until a resume cpu call is made.
156  */
157  int (*v3_cpustop)(unsigned int whichcpu);
158 
159  /* v3_cpuidle() will idle cpu 'whichcpu' until a stop or
160  * resume cpu call is made.
161  */
162  int (*v3_cpuidle)(unsigned int whichcpu);
163 
164  /* v3_cpuresume() will resume processor 'whichcpu' executing
165  * starting with whatever 'pc' and 'npc' were left at the
166  * last 'idle' or 'stop' call.
167  */
168  int (*v3_cpuresume)(unsigned int whichcpu);
169 };
170 
171 /* Routines for traversing the prom device tree. */
172 struct linux_nodeops {
175  int (*no_proplen)(phandle node, const char *name);
176  int (*no_getprop)(phandle node, const char *name, char *val);
177  int (*no_setprop)(phandle node, const char *name, char *val, int len);
178  char * (*no_nextprop)(phandle node, char *name);
179 };
180 
181 /* More fun PROM structures for device probing. */
182 #if defined(__sparc__) && defined(__arch64__)
183 #define PROMREG_MAX 24
184 #define PROMVADDR_MAX 16
185 #define PROMINTR_MAX 32
186 #else
187 #define PROMREG_MAX 16
188 #define PROMVADDR_MAX 16
189 #define PROMINTR_MAX 15
190 #endif
191 
192 struct linux_prom_registers {
193  unsigned int which_io; /* hi part of physical address */
194  unsigned int phys_addr; /* The physical address of this register */
195  unsigned int reg_size; /* How many bytes does this register take up? */
196 };
197 
199  unsigned long phys_addr;
200  unsigned long reg_size;
201 };
202 
203 struct linux_prom_irqs {
204  int pri; /* IRQ priority */
205  int vector; /* This is foobar, what does it do? */
206 };
207 
208 /* Element of the "ranges" vector */
209 struct linux_prom_ranges {
210  unsigned int ot_child_space;
211  unsigned int ot_child_base; /* Bus feels this */
212  unsigned int ot_parent_space;
213  unsigned int ot_parent_base; /* CPU looks from here */
214  unsigned int or_size;
215 };
216 
217 /*
218  * Ranges and reg properties are a bit different for PCI.
219  */
220 #if defined(__sparc__) && defined(__arch64__)
222  unsigned int phys_hi;
223  unsigned int phys_mid;
224  unsigned int phys_lo;
225 
226  unsigned int size_hi;
227  unsigned int size_lo;
228 };
229 #else
231  /*
232  * We don't know what information this field contain.
233  * We guess, PCI device function is in bits 15:8
234  * So, ...
235  */
236  unsigned int which_io; /* Let it be which_io */
237 
238  unsigned int phys_hi;
239  unsigned int phys_lo;
240 
241  unsigned int size_hi;
242  unsigned int size_lo;
243 };
244 
245 #endif
246 
248  unsigned int child_phys_hi; /* Only certain bits are encoded here. */
249  unsigned int child_phys_mid;
250  unsigned int child_phys_lo;
251 
252  unsigned int parent_phys_hi;
253  unsigned int parent_phys_lo;
254 
255  unsigned int size_hi;
256  unsigned int size_lo;
257 };
258 
260  unsigned int phys_hi;
261  unsigned int phys_mid;
262  unsigned int phys_lo;
263 
264  unsigned int interrupt;
265 
266  int cnode;
267  unsigned int cinterrupt;
268 };
269 
271  unsigned int phys_hi;
272  unsigned int phys_mid;
273  unsigned int phys_lo;
274  unsigned int interrupt;
275 };
276 
277 #endif /* !(__ASSEMBLY__) */
278 
279 #endif /* !(__SPARC_OPENPROM_H) */