1 /* $OpenBSD: openfirm.h,v 1.16 2020/07/06 15:18:03 kettenis 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 uint32_t OF_getpropint(int handle, char *, uint32_t); 54 int OF_getpropintarray(int, char *, uint32_t *, int); 55 uint64_t OF_getpropint64(int handle, char *, uint64_t); 56 int OF_setprop(int, char *, const void *, int); 57 int OF_nextprop(int, char *, void *); 58 int OF_finddevice(char *name); 59 int OF_is_compatible(int, const char *); 60 int OF_instance_to_path(int ihandle, char *buf, int buflen); 61 int OF_package_to_path(int phandle, char *buf, int buflen); 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 * Some generic routines for OpenFirmware handling. 82 */ 83 int ofnmmatch(char *cp1, char *cp2); 84 void ofw_intr_establish(void); 85 86 /* 87 * Generic OpenFirmware probe argument. 88 * This is how all probe structures must start 89 * in order to support generic OpenFirmware device drivers. 90 */ 91 struct ofprobe { 92 int phandle; 93 /* 94 * Special unit field for disk devices. 95 * This is a KLUDGE to work around the fact that OpenFirmware 96 * doesn't probe the scsi bus completely. 97 * YES, I THINK THIS IS A BUG IN THE OPENFIRMWARE DEFINITION!!! XXX 98 * See also ofdisk.c. 99 */ 100 int unit; 101 }; 102 103 /* 104 * The softc structure for devices we might be booted from (i.e. we might 105 * want to set root/swap to) needs to start with these fields: XXX 106 */ 107 struct ofb_softc { 108 struct device sc_dev; 109 int sc_phandle; 110 int sc_unit; /* Might be missing for non-disk devices */ 111 }; 112