1 /* SPDX-License-Identifier: GPL-2.0+ */ 2 /* 3 * This is the interface to the sandbox GPIO driver for test code which 4 * wants to change the GPIO values reported to U-Boot. 5 * 6 * Copyright (c) 2011 The Chromium OS Authors. 7 */ 8 9 #ifndef __ASM_SANDBOX_GPIO_H 10 #define __ASM_SANDBOX_GPIO_H 11 12 /* 13 * We use the generic interface, and add a back-channel. 14 * 15 * The back-channel functions are declared in this file. They should not be used 16 * except in test code. 17 * 18 * Test code can, for example, call sandbox_gpio_set_value() to set the value of 19 * a simulated GPIO. From then on, normal code in U-Boot will see this new 20 * value when it calls gpio_get_value(). 21 * 22 * NOTE: DO NOT use the functions in this file except in test code! 23 */ 24 #include <asm-generic/gpio.h> 25 26 /** 27 * Return the simulated value of a GPIO (used only in sandbox test code) 28 * 29 * @param dev device to use 30 * @param offset GPIO offset within bank 31 * @return -1 on error, 0 if GPIO is low, >0 if high 32 */ 33 int sandbox_gpio_get_value(struct udevice *dev, unsigned int offset); 34 35 /** 36 * Set the simulated value of a GPIO (used only in sandbox test code) 37 * 38 * @param dev device to use 39 * @param offset GPIO offset within bank 40 * @param value value to set (0 for low, non-zero for high) 41 * @return -1 on error, 0 if ok 42 */ 43 int sandbox_gpio_set_value(struct udevice *dev, unsigned int offset, int value); 44 45 /** 46 * Return the simulated direction of a GPIO (used only in sandbox test code) 47 * 48 * @param dev device to use 49 * @param offset GPIO offset within bank 50 * @return -1 on error, 0 if GPIO is input, >0 if output 51 */ 52 int sandbox_gpio_get_direction(struct udevice *dev, unsigned int offset); 53 54 /** 55 * Set the simulated direction of a GPIO (used only in sandbox test code) 56 * 57 * @param dev device to use 58 * @param offset GPIO offset within bank 59 * @param output 0 to set as input, 1 to set as output 60 * @return -1 on error, 0 if ok 61 */ 62 int sandbox_gpio_set_direction(struct udevice *dev, unsigned int offset, 63 int output); 64 65 /** 66 * Return the simulated flags of a GPIO (used only in sandbox test code) 67 * 68 * @param dev device to use 69 * @param offset GPIO offset within bank 70 * @return dir_flags: bitfield accesses by GPIOD_ defines 71 */ 72 ulong sandbox_gpio_get_dir_flags(struct udevice *dev, unsigned int offset); 73 74 /** 75 * Set the simulated flags of a GPIO (used only in sandbox test code) 76 * 77 * @param dev device to use 78 * @param offset GPIO offset within bank 79 * @param flags dir_flags: bitfield accesses by GPIOD_ defines 80 * @return -1 on error, 0 if ok 81 */ 82 int sandbox_gpio_set_dir_flags(struct udevice *dev, unsigned int offset, 83 ulong flags); 84 85 #endif 86