1 /*- 2 * Copyright (c) 2014 Ian Lepore <ian@freebsd.org> 3 * All rights reserved. 4 * 5 * Redistribution and use in source and binary forms, with or without 6 * modification, are permitted provided that the following conditions 7 * are met: 8 * 1. Redistributions of source code must retain the above copyright 9 * notice, this list of conditions and the following disclaimer. 10 * 2. Redistributions in binary form must reproduce the above copyright 11 * notice, this list of conditions and the following disclaimer in the 12 * documentation and/or other materials provided with the distribution. 13 * 14 * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR 15 * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES 16 * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. 17 * IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, 18 * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT 19 * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, 20 * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY 21 * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT 22 * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF 23 * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. 24 */ 25 26 #ifndef DEV_FDT_PINCTRL_H 27 #define DEV_FDT_PINCTRL_H 28 29 #include "fdt_pinctrl_if.h" 30 31 /* 32 * Configure pins by name or index. This looks up the pinctrl-N property in 33 * client's fdt data by index or name, and passes each handle in it to the 34 * pinctrl driver for configuration. 35 */ 36 int fdt_pinctrl_configure(device_t client, u_int index); 37 int fdt_pinctrl_configure_by_name(device_t client, const char * name); 38 39 /* 40 * Register a pinctrl driver so that it can be used by other devices which call 41 * fdt_pinctrl_configure(). The pinprop argument is the name of a property that 42 * identifies each descendent of the pinctrl node which is a pin configuration 43 * node whose xref phandle can be passed to FDT_PINCTRL_CONFIGURE(). If this is 44 * NULL, every descendant node is registered. 45 */ 46 int fdt_pinctrl_register(device_t pinctrl, const char *pinprop); 47 48 /* 49 * Walk the device tree and configure pins for each enabled device whose 50 * pinctrl-0 property contains references to nodes which are children of the 51 * given pinctrl device. This helper routine is for use by pinctrl drivers. 52 */ 53 int fdt_pinctrl_configure_tree(device_t pinctrl); 54 55 #endif /* DEV_FDT_PINCTRL_H */ 56 57