1 /* SPDX-License-Identifier: GPL-2.0 */
2 /*
3   nubus.h: various definitions and prototypes for NuBus drivers to use.
4 
5   Originally written by Alan Cox.
6 
7   Hacked to death by C. Scott Ananian and David Huggins-Daines.
8 */
9 
10 #ifndef LINUX_NUBUS_H
11 #define LINUX_NUBUS_H
12 
13 #include <linux/device.h>
14 #include <asm/nubus.h>
15 #include <uapi/linux/nubus.h>
16 
17 struct proc_dir_entry;
18 struct seq_file;
19 
20 struct nubus_dir {
21 	unsigned char *base;
22 	unsigned char *ptr;
23 	int done;
24 	int mask;
25 	struct proc_dir_entry *procdir;
26 };
27 
28 struct nubus_dirent {
29 	unsigned char *base;
30 	unsigned char type;
31 	__u32 data;	/* Actually 24 bits used */
32 	int mask;
33 };
34 
35 struct nubus_board {
36 	struct device dev;
37 
38 	/* Only 9-E actually exist, though 0-8 are also theoretically
39 	   possible, and 0 is a special case which represents the
40 	   motherboard and onboard peripherals (Ethernet, video) */
41 	int slot;
42 	/* For slot 0, this is bogus. */
43 	char name[64];
44 
45 	/* Format block */
46 	unsigned char *fblock;
47 	/* Root directory (does *not* always equal fblock + doffset!) */
48 	unsigned char *directory;
49 
50 	unsigned long slot_addr;
51 	/* Offset to root directory (sometimes) */
52 	unsigned long doffset;
53 	/* Length over which to compute the crc */
54 	unsigned long rom_length;
55 	/* Completely useless most of the time */
56 	unsigned long crc;
57 	unsigned char rev;
58 	unsigned char format;
59 	unsigned char lanes;
60 
61 	/* Directory entry in /proc/bus/nubus */
62 	struct proc_dir_entry *procdir;
63 };
64 
65 struct nubus_rsrc {
66 	struct list_head list;
67 
68 	/* The functional resource ID */
69 	unsigned char resid;
70 	/* These are mostly here for convenience; we could always read
71 	   them from the ROMs if we wanted to */
72 	unsigned short category;
73 	unsigned short type;
74 	unsigned short dr_sw;
75 	unsigned short dr_hw;
76 
77 	/* Functional directory */
78 	unsigned char *directory;
79 	/* Much of our info comes from here */
80 	struct nubus_board *board;
81 };
82 
83 /* This is all NuBus functional resources (used to find devices later on) */
84 extern struct list_head nubus_func_rsrcs;
85 
86 struct nubus_driver {
87 	struct device_driver driver;
88 	int (*probe)(struct nubus_board *board);
89 	int (*remove)(struct nubus_board *board);
90 };
91 
92 extern struct bus_type nubus_bus_type;
93 
94 /* Generic NuBus interface functions, modelled after the PCI interface */
95 #ifdef CONFIG_PROC_FS
96 void nubus_proc_init(void);
97 struct proc_dir_entry *nubus_proc_add_board(struct nubus_board *board);
98 struct proc_dir_entry *nubus_proc_add_rsrc_dir(struct proc_dir_entry *procdir,
99 					       const struct nubus_dirent *ent,
100 					       struct nubus_board *board);
101 void nubus_proc_add_rsrc_mem(struct proc_dir_entry *procdir,
102 			     const struct nubus_dirent *ent,
103 			     unsigned int size);
104 void nubus_proc_add_rsrc(struct proc_dir_entry *procdir,
105 			 const struct nubus_dirent *ent);
106 #else
nubus_proc_init(void)107 static inline void nubus_proc_init(void) {}
108 static inline
nubus_proc_add_board(struct nubus_board * board)109 struct proc_dir_entry *nubus_proc_add_board(struct nubus_board *board)
110 { return NULL; }
111 static inline
nubus_proc_add_rsrc_dir(struct proc_dir_entry * procdir,const struct nubus_dirent * ent,struct nubus_board * board)112 struct proc_dir_entry *nubus_proc_add_rsrc_dir(struct proc_dir_entry *procdir,
113 					       const struct nubus_dirent *ent,
114 					       struct nubus_board *board)
115 { return NULL; }
nubus_proc_add_rsrc_mem(struct proc_dir_entry * procdir,const struct nubus_dirent * ent,unsigned int size)116 static inline void nubus_proc_add_rsrc_mem(struct proc_dir_entry *procdir,
117 					   const struct nubus_dirent *ent,
118 					   unsigned int size) {}
nubus_proc_add_rsrc(struct proc_dir_entry * procdir,const struct nubus_dirent * ent)119 static inline void nubus_proc_add_rsrc(struct proc_dir_entry *procdir,
120 				       const struct nubus_dirent *ent) {}
121 #endif
122 
123 struct nubus_rsrc *nubus_first_rsrc_or_null(void);
124 struct nubus_rsrc *nubus_next_rsrc_or_null(struct nubus_rsrc *from);
125 
126 #define for_each_func_rsrc(f) \
127 	for (f = nubus_first_rsrc_or_null(); f; f = nubus_next_rsrc_or_null(f))
128 
129 #define for_each_board_func_rsrc(b, f) \
130 	for_each_func_rsrc(f) if (f->board != b) {} else
131 
132 /* These are somewhat more NuBus-specific.  They all return 0 for
133    success and -1 for failure, as you'd expect. */
134 
135 /* The root directory which contains the board and functional
136    directories */
137 int nubus_get_root_dir(const struct nubus_board *board,
138 		       struct nubus_dir *dir);
139 /* The board directory */
140 int nubus_get_board_dir(const struct nubus_board *board,
141 			struct nubus_dir *dir);
142 /* The functional directory */
143 int nubus_get_func_dir(const struct nubus_rsrc *fres, struct nubus_dir *dir);
144 
145 /* These work on any directory gotten via the above */
146 int nubus_readdir(struct nubus_dir *dir,
147 		  struct nubus_dirent *ent);
148 int nubus_find_rsrc(struct nubus_dir *dir,
149 		    unsigned char rsrc_type,
150 		    struct nubus_dirent *ent);
151 int nubus_rewinddir(struct nubus_dir *dir);
152 
153 /* Things to do with directory entries */
154 int nubus_get_subdir(const struct nubus_dirent *ent,
155 		     struct nubus_dir *dir);
156 void nubus_get_rsrc_mem(void *dest, const struct nubus_dirent *dirent,
157 			unsigned int len);
158 unsigned int nubus_get_rsrc_str(char *dest, const struct nubus_dirent *dirent,
159 				unsigned int len);
160 void nubus_seq_write_rsrc_mem(struct seq_file *m,
161 			      const struct nubus_dirent *dirent,
162 			      unsigned int len);
163 unsigned char *nubus_dirptr(const struct nubus_dirent *nd);
164 
165 /* Declarations relating to driver model objects */
166 int nubus_parent_device_register(void);
167 int nubus_device_register(struct nubus_board *board);
168 int nubus_driver_register(struct nubus_driver *ndrv);
169 void nubus_driver_unregister(struct nubus_driver *ndrv);
170 int nubus_proc_show(struct seq_file *m, void *data);
171 
nubus_set_drvdata(struct nubus_board * board,void * data)172 static inline void nubus_set_drvdata(struct nubus_board *board, void *data)
173 {
174 	dev_set_drvdata(&board->dev, data);
175 }
176 
nubus_get_drvdata(struct nubus_board * board)177 static inline void *nubus_get_drvdata(struct nubus_board *board)
178 {
179 	return dev_get_drvdata(&board->dev);
180 }
181 
182 /* Returns a pointer to the "standard" slot space. */
nubus_slot_addr(int slot)183 static inline void *nubus_slot_addr(int slot)
184 {
185 	return (void *)(0xF0000000 | (slot << 24));
186 }
187 
188 #endif /* LINUX_NUBUS_H */
189