1 /*- 2 * SPDX-License-Identifier: BSD-2-Clause 3 * 4 * Copyright (c) 2017 Kyle Evans <kevans@FreeBSD.org> 5 * 6 * Redistribution and use in source and binary forms, with or without 7 * modification, are permitted provided that the following conditions 8 * are met: 9 * 1. Redistributions of source code must retain the above copyright 10 * notice, this list of conditions and the following disclaimer. 11 * 2. Redistributions in binary form must reproduce the above copyright 12 * notice, this list of conditions and the following disclaimer in the 13 * documentation and/or other materials provided with the distribution. 14 * 15 * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR 16 * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES 17 * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. 18 * IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, 19 * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT 20 * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, 21 * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY 22 * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT 23 * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF 24 * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. 25 */ 26 27 #ifndef DEV_SYSCON_H 28 #define DEV_SYSCON_H 29 30 #include "opt_platform.h" 31 32 #include <sys/types.h> 33 #include <sys/kobj.h> 34 #ifdef FDT 35 #include <dev/ofw/ofw_bus.h> 36 #endif 37 38 struct syscon { 39 KOBJ_FIELDS; 40 41 TAILQ_ENTRY(syscon) syscon_link; /* Global list entry */ 42 43 device_t pdev; /* provider device */ 44 #ifdef FDT 45 phandle_t ofw_node; /* OFW node for syscon */ 46 #endif 47 void *softc; /* provider softc */ 48 }; 49 50 /* 51 * Shorthands for constructing method tables. 52 */ 53 #define SYSCONMETHOD KOBJMETHOD 54 #define SYSCONMETHOD_END KOBJMETHOD_END 55 #define syscon_method_t kobj_method_t 56 #define syscon_class_t kobj_class_t 57 DECLARE_CLASS(syscon_class); 58 59 void *syscon_get_softc(struct syscon *syscon); 60 61 /* 62 * Provider interface 63 */ 64 struct syscon *syscon_create(device_t pdev, syscon_class_t syscon_class); 65 struct syscon *syscon_register(struct syscon *syscon); 66 int syscon_unregister(struct syscon *syscon); 67 68 #ifdef FDT 69 struct syscon *syscon_create_ofw_node(device_t pdev, 70 syscon_class_t syscon_class, phandle_t node); 71 phandle_t syscon_get_ofw_node(struct syscon *syscon); 72 int syscon_get_by_ofw_property(device_t consumer, phandle_t node, char *name, 73 struct syscon **syscon); 74 int syscon_get_by_ofw_node(device_t cdev, phandle_t node, struct syscon **syscon); 75 #endif 76 77 #endif /* DEV_SYSCON_H */ 78