1 #ifndef __SPARC_OPENPROM_H
2 #define __SPARC_OPENPROM_H
4 /* openprom.h: Prom structures and defines for access to the OPENBOOT
5 * prom routines and data areas.
7 * Copyright (C) 1995 David S. Miller (davem@caip.rutgers.edu)
10 /* Empirical constants... */
11 #define LINUX_OPPROM_MAGIC 0x10010407
14 /* V0 prom device operations. */
15 struct linux_dev_v0_funcs
{
16 int (*v0_devopen
)(char *device_str
);
17 int (*v0_devclose
)(int dev_desc
);
18 int (*v0_rdblkdev
)(int dev_desc
, int num_blks
, int blk_st
, char *buf
);
19 int (*v0_wrblkdev
)(int dev_desc
, int num_blks
, int blk_st
, char *buf
);
20 int (*v0_wrnetdev
)(int dev_desc
, int num_bytes
, char *buf
);
21 int (*v0_rdnetdev
)(int dev_desc
, int num_bytes
, char *buf
);
22 int (*v0_rdchardev
)(int dev_desc
, int num_bytes
, int dummy
, char *buf
);
23 int (*v0_wrchardev
)(int dev_desc
, int num_bytes
, int dummy
, char *buf
);
24 int (*v0_seekdev
)(int dev_desc
, long logical_offst
, int from
);
27 /* V2 and later prom device operations. */
28 struct linux_dev_v2_funcs
{
29 int (*v2_inst2pkg
)(int d
); /* Convert ihandle to phandle */
30 char * (*v2_dumb_mem_alloc
)(char *va
, unsigned sz
);
31 void (*v2_dumb_mem_free
)(char *va
, unsigned sz
);
33 /* To map devices into virtual I/O space. */
34 char * (*v2_dumb_mmap
)(char *virta
, int which_io
, unsigned paddr
, unsigned sz
);
35 void (*v2_dumb_munmap
)(char *virta
, unsigned size
);
37 int (*v2_dev_open
)(char *devpath
);
38 void (*v2_dev_close
)(int d
);
39 int (*v2_dev_read
)(int d
, char *buf
, int nbytes
);
40 int (*v2_dev_write
)(int d
, char *buf
, int nbytes
);
41 int (*v2_dev_seek
)(int d
, int hi
, int lo
);
43 /* Never issued (multistage load support) */
44 void (*v2_wheee2
)(void);
45 void (*v2_wheee3
)(void);
48 struct linux_mlist_v0
{
49 struct linux_mlist_v0
*theres_more
;
55 struct linux_mlist_v0
**v0_totphys
;
56 struct linux_mlist_v0
**v0_prommap
;
57 struct linux_mlist_v0
**v0_available
; /* What we can use */
60 /* Arguments sent to the kernel from the boot prompt. */
61 struct linux_arguments_v0
{
68 char *kernel_file_name
;
69 void *aieee1
; /* XXX */
72 /* V2 and up boot things. */
73 struct linux_bootargs_v2
{
80 /* The top level PROM vector. */
82 /* Version numbers. */
83 unsigned int pv_magic_cookie
;
84 unsigned int pv_romvers
;
85 unsigned int pv_plugin_revision
;
86 unsigned int pv_printrev
;
88 /* Version 0 memory descriptors. */
89 struct linux_mem_v0 pv_v0mem
;
91 /* Node operations. */
92 struct linux_nodeops
*pv_nodeops
;
95 struct linux_dev_v0_funcs pv_v0devops
;
99 #define PROMDEV_KBD 0 /* input from keyboard */
100 #define PROMDEV_SCREEN 0 /* output to screen */
101 #define PROMDEV_TTYA 1 /* in/out to ttya */
102 #define PROMDEV_TTYB 2 /* in/out to ttyb */
104 /* Blocking getchar/putchar. NOT REENTRANT! (grr) */
105 int (*pv_getchar
)(void);
106 void (*pv_putchar
)(int ch
);
108 /* Non-blocking variants. */
109 int (*pv_nbgetchar
)(void);
110 int (*pv_nbputchar
)(int ch
);
112 void (*pv_putstr
)(char *str
, int len
);
115 void (*pv_reboot
)(char *bootstr
);
116 void (*pv_printf
)(__const__
char *fmt
, ...);
117 void (*pv_abort
)(void);
118 __volatile__
int *pv_ticks
;
119 void (*pv_halt
)(void);
120 void (**pv_synchook
)(void);
122 /* Evaluate a forth string, not different proto for V0 and V2->up. */
124 void (*v0_eval
)(int len
, char *str
);
125 void (*v2_eval
)(char *str
);
128 struct linux_arguments_v0
**pv_v0bootargs
;
130 /* Get ether address. */
131 unsigned int (*pv_enaddr
)(int d
, char *enaddr
);
133 struct linux_bootargs_v2 pv_v2bootargs
;
134 struct linux_dev_v2_funcs pv_v2devops
;
138 /* This one is sun4c/sun4 only. */
139 void (*pv_setctxt
)(int ctxt
, char *va
, int pmeg
);
141 /* Prom version 3 Multiprocessor routines. This stuff is crazy.
142 * No joke. Calling these when there is only one cpu probably
143 * crashes the machine, have to test this. :-)
146 /* v3_cpustart() will start the cpu 'whichcpu' in mmu-context
147 * 'thiscontext' executing at address 'prog_counter'
149 int (*v3_cpustart
)(unsigned int whichcpu
, int ctxtbl_ptr
,
150 int thiscontext
, char *prog_counter
);
152 /* v3_cpustop() will cause cpu 'whichcpu' to stop executing
153 * until a resume cpu call is made.
155 int (*v3_cpustop
)(unsigned int whichcpu
);
157 /* v3_cpuidle() will idle cpu 'whichcpu' until a stop or
158 * resume cpu call is made.
160 int (*v3_cpuidle
)(unsigned int whichcpu
);
162 /* v3_cpuresume() will resume processor 'whichcpu' executing
163 * starting with whatever 'pc' and 'npc' were left at the
164 * last 'idle' or 'stop' call.
166 int (*v3_cpuresume
)(unsigned int whichcpu
);
169 /* Routines for traversing the prom device tree. */
170 struct linux_nodeops
{
171 int (*no_nextnode
)(int node
);
172 int (*no_child
)(int node
);
173 int (*no_proplen
)(int node
, char *name
);
174 int (*no_getprop
)(int node
, char *name
, char *val
);
175 int (*no_setprop
)(int node
, char *name
, char *val
, int len
);
176 char * (*no_nextprop
)(int node
, char *name
);
179 /* More fun PROM structures for device probing. */
180 #define PROMREG_MAX 16
181 #define PROMVADDR_MAX 16
182 #define PROMINTR_MAX 15
184 struct linux_prom_registers
{
185 unsigned int which_io
; /* is this in OBIO space? */
186 unsigned int phys_addr
; /* The physical address of this register */
187 unsigned int reg_size
; /* How many bytes does this register take up? */
190 struct linux_prom_irqs
{
191 int pri
; /* IRQ priority */
192 int vector
; /* This is foobar, what does it do? */
195 /* Element of the "ranges" vector */
196 struct linux_prom_ranges
{
197 unsigned int ot_child_space
;
198 unsigned int ot_child_base
; /* Bus feels this */
199 unsigned int ot_parent_space
;
200 unsigned int ot_parent_base
; /* CPU looks from here */
201 unsigned int or_size
;
204 /* Ranges and reg properties are a bit different for PCI. */
205 struct linux_prom_pci_registers
{
207 * We don't know what information this field contain.
208 * We guess, PCI device function is in bits 15:8
211 unsigned int which_io
; /* Let it be which_io */
213 unsigned int phys_hi
;
214 unsigned int phys_lo
;
216 unsigned int size_hi
;
217 unsigned int size_lo
;
220 struct linux_prom_pci_ranges
{
221 unsigned int child_phys_hi
; /* Only certain bits are encoded here. */
222 unsigned int child_phys_mid
;
223 unsigned int child_phys_lo
;
225 unsigned int parent_phys_hi
;
226 unsigned int parent_phys_lo
;
228 unsigned int size_hi
;
229 unsigned int size_lo
;
232 struct linux_prom_pci_assigned_addresses
{
233 unsigned int which_io
;
235 unsigned int phys_hi
;
236 unsigned int phys_lo
;
238 unsigned int size_hi
;
239 unsigned int size_lo
;
242 struct linux_prom_ebus_ranges
{
243 unsigned int child_phys_hi
;
244 unsigned int child_phys_lo
;
246 unsigned int parent_phys_hi
;
247 unsigned int parent_phys_mid
;
248 unsigned int parent_phys_lo
;
253 #endif /* !(__ASSEMBLY__) */
255 #endif /* !(__SPARC_OPENPROM_H) */