1 /* $OpenBSD: openfirm.h,v 1.20 2024/11/08 12:48:00 miod Exp $ */ 2 /* $NetBSD: openfirm.h,v 1.1 1996/09/30 16:35:10 ws Exp $ */ 3 4 /* 5 * Copyright (C) 1995, 1996 Wolfgang Solfrank. 6 * Copyright (C) 1995, 1996 TooLs GmbH. 7 * All rights reserved. 8 * 9 * Redistribution and use in source and binary forms, with or without 10 * modification, are permitted provided that the following conditions 11 * are met: 12 * 1. Redistributions of source code must retain the above copyright 13 * notice, this list of conditions and the following disclaimer. 14 * 2. Redistributions in binary form must reproduce the above copyright 15 * notice, this list of conditions and the following disclaimer in the 16 * documentation and/or other materials provided with the distribution. 17 * 3. All advertising materials mentioning features or use of this software 18 * must display the following acknowledgement: 19 * This product includes software developed by TooLs GmbH. 20 * 4. The name of TooLs GmbH may not be used to endorse or promote products 21 * derived from this software without specific prior written permission. 22 * 23 * THIS SOFTWARE IS PROVIDED BY TOOLS GMBH ``AS IS'' AND ANY EXPRESS OR 24 * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES 25 * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. 26 * IN NO EVENT SHALL TOOLS GMBH BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, 27 * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, 28 * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; 29 * OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, 30 * WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR 31 * OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF 32 * ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. 33 */ 34 /* 35 * Prototypes for OpenFirmware Interface Routines 36 */ 37 38 #include <sys/param.h> 39 #include <sys/device.h> 40 41 #define OFMAXPARAM 64 42 43 int openfirmware(void *); 44 45 extern char OF_buf[]; 46 47 int OF_peer(int phandle); 48 int OF_child(int phandle); 49 int OF_parent(int phandle); 50 int OF_instance_to_package(int ihandle); 51 int OF_getproplen(int handle, char *prop); 52 int OF_getprop(int handle, char *prop, void *buf, int buflen); 53 int OF_getpropbool(int handle, char *); 54 uint32_t OF_getpropint(int handle, char *, uint32_t); 55 int OF_getpropintarray(int, char *, uint32_t *, int); 56 uint64_t OF_getpropint64(int handle, char *, uint64_t); 57 int OF_getpropint64array(int, char *, uint64_t *, int); 58 int OF_setprop(int, char *, const void *, int); 59 int OF_nextprop(int, char *, void *); 60 int OF_finddevice(char *name); 61 int OF_is_compatible(int, const char *); 62 int OF_call_method_1(char *method, int ihandle, int nargs, ...); 63 int OF_call_method(char *method, int ihandle, int nargs, int nreturns, ...); 64 int OF_open(char *dname); 65 void OF_close(int handle); 66 int OF_read(int handle, void *addr, int len); 67 int OF_write(int handle, void *addr, int len); 68 int OF_seek(int handle, u_quad_t pos); 69 void OF_boot(char *bootspec); 70 void OF_enter(void); 71 void OF_exit(void) __attribute__((__noreturn__)); 72 int OF_interpret(char *cmd, int nreturns, ...); 73 #if 0 74 void (*OF_set_callback(void (*newfunc)(void *))) (); 75 #endif 76 int OF_getnodebyname(int, const char *); 77 int OF_getnodebyphandle(uint32_t); 78 int OF_getindex(int, const char *, const char *); 79 80 /* 81 * Generic OpenFirmware probe argument. 82 * This is how all probe structures must start 83 * in order to support generic OpenFirmware device drivers. 84 */ 85 struct ofprobe { 86 int phandle; 87 /* 88 * Special unit field for disk devices. 89 * This is a KLUDGE to work around the fact that OpenFirmware 90 * doesn't probe the scsi bus completely. 91 * YES, I THINK THIS IS A BUG IN THE OPENFIRMWARE DEFINITION!!! XXX 92 * See also ofdisk.c. 93 */ 94 int unit; 95 }; 96 97 /* 98 * The softc structure for devices we might be booted from (i.e. we might 99 * want to set root/swap to) needs to start with these fields: XXX 100 */ 101 struct ofb_softc { 102 struct device sc_dev; 103 int sc_phandle; 104 int sc_unit; /* Might be missing for non-disk devices */ 105 }; 106