hal_gpio.h 5.3 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149
  1. /*
  2. * Copyright (c) 2019-2025 Allwinner Technology Co., Ltd. ALL rights reserved.
  3. *
  4. * Allwinner is a trademark of Allwinner Technology Co.,Ltd., registered in
  5. * the the People's Republic of China and other countries.
  6. * All Allwinner Technology Co.,Ltd. trademarks are used with permission.
  7. *
  8. * DISCLAIMER
  9. * THIRD PARTY LICENCES MAY BE REQUIRED TO IMPLEMENT THE SOLUTION/PRODUCT.
  10. * IF YOU NEED TO INTEGRATE THIRD PARTY’S TECHNOLOGY (SONY, DTS, DOLBY, AVS OR MPEGLA, ETC.)
  11. * IN ALLWINNERS’SDK OR PRODUCTS, YOU SHALL BE SOLELY RESPONSIBLE TO OBTAIN
  12. * ALL APPROPRIATELY REQUIRED THIRD PARTY LICENCES.
  13. * ALLWINNER SHALL HAVE NO WARRANTY, INDEMNITY OR OTHER OBLIGATIONS WITH RESPECT TO MATTERS
  14. * COVERED UNDER ANY REQUIRED THIRD PARTY LICENSE.
  15. * YOU ARE SOLELY RESPONSIBLE FOR YOUR USAGE OF THIRD PARTY’S TECHNOLOGY.
  16. *
  17. *
  18. * THIS SOFTWARE IS PROVIDED BY ALLWINNER"AS IS" AND TO THE MAXIMUM EXTENT
  19. * PERMITTED BY LAW, ALLWINNER EXPRESSLY DISCLAIMS ALL WARRANTIES OF ANY KIND,
  20. * WHETHER EXPRESS, IMPLIED OR STATUTORY, INCLUDING WITHOUT LIMITATION REGARDING
  21. * THE TITLE, NON-INFRINGEMENT, ACCURACY, CONDITION, COMPLETENESS, PERFORMANCE
  22. * OR MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
  23. * IN NO EVENT SHALL ALLWINNER BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
  24. * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
  25. * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
  26. * LOSS OF USE, DATA, OR PROFITS, OR BUSINESS INTERRUPTION)
  27. * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
  28. * STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
  29. * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED
  30. * OF THE POSSIBILITY OF SUCH DAMAGE.
  31. */
  32. #ifndef __HAL_GPIO_H__
  33. #define __HAL_GPIO_H__
  34. #include <stdlib.h>
  35. #include <hal_interrupt.h>
  36. #include <hal_log.h>
  37. #include <gpio/gpio.h>
  38. #include <platform-gpio.h>
  39. #ifdef __cplusplus
  40. extern "C" {
  41. #endif
  42. #define CONFIG_DRIVERS_GPIO_DEBUG
  43. #ifndef CONFIG_DRIVERS_GPIO_DEBUG
  44. #define GPIO_INFO(fmt, arg...) hal_log_info(fmt, ##arg)
  45. #else
  46. #define GPIO_INFO(fmt, arg...) do {}while(0)
  47. #endif
  48. #define GPIO_ERR(fmt, arg...) hal_log_err(fmt, ##arg)
  49. /**This enum defines the GPIO MUX function*/
  50. #if defined(CONFIG_SOC_SUN20IW1) || defined(CONFIG_ARCH_SUN8IW20)
  51. typedef enum
  52. {
  53. GPIO_MUXSEL_IN = 0,
  54. GPIO_MUXSEL_OUT = 1,
  55. GPIO_MUXSEL_FUNCTION2 = 2,
  56. GPIO_MUXSEL_FUNCTION3 = 3,
  57. GPIO_MUXSEL_FUNCTION4 = 4,
  58. GPIO_MUXSEL_FUNCTION5 = 5,
  59. GPIO_MUXSEL_FUNCTION6 = 6,
  60. GPIO_MUXSEL_FUNCTION7 = 7,
  61. GPIO_MUXSEL_FUNCTION8 = 8,
  62. GPIO_MUXSEL_FUNCTION9 = 9,
  63. GPIO_MUXSEL_FUNCTION10 = 10,
  64. GPIO_MUXSEL_FUNCTION11 = 11,
  65. GPIO_MUXSEL_FUNCTION12 = 12,
  66. GPIO_MUXSEL_FUNCTION13 = 13,
  67. GPIO_MUXSEL_EINT = 14,
  68. GPIO_MUXSEL_DISABLED = 15,
  69. } gpio_muxsel_t;
  70. #else
  71. typedef enum
  72. {
  73. GPIO_MUXSEL_IN = 0,
  74. GPIO_MUXSEL_OUT = 1,
  75. GPIO_MUXSEL_FUNCTION2 = 2,
  76. GPIO_MUXSEL_FUNCTION3 = 3,
  77. GPIO_MUXSEL_FUNCTION4 = 4,
  78. GPIO_MUXSEL_FUNCTION5 = 5,
  79. GPIO_MUXSEL_EINT = 6,
  80. GPIO_MUXSEL_DISABLED = 7,
  81. } gpio_muxsel_t;
  82. #endif
  83. typedef enum
  84. {
  85. GPIO_DRIVING_LEVEL0 = 0, /**< Defines GPIO driving current as level0. */
  86. GPIO_DRIVING_LEVEL1 = 1, /**< Defines GPIO driving current as level1. */
  87. GPIO_DRIVING_LEVEL2 = 2, /**< Defines GPIO driving current as level2. */
  88. GPIO_DRIVING_LEVEL3 = 3 /**< Defines GPIO driving current as level3. */
  89. } gpio_driving_level_t;
  90. typedef enum
  91. {
  92. GPIO_PULL_DOWN_DISABLED = 0, /**< Defines GPIO pull up and pull down disable. */
  93. GPIO_PULL_UP = 1, /**< Defines GPIO is pull up state. */
  94. GPIO_PULL_DOWN = 2, /**< Defines GPIO is pull down state. */
  95. } gpio_pull_status_t;
  96. /** This enum defines the GPIO direction. */
  97. typedef enum
  98. {
  99. GPIO_DIRECTION_INPUT = 0, /**< GPIO input direction. */
  100. GPIO_DIRECTION_OUTPUT = 1 /**< GPIO output direction. */
  101. } gpio_direction_t;
  102. /** This enum defines the data type of GPIO. */
  103. typedef enum
  104. {
  105. GPIO_DATA_LOW = 0, /**< GPIO data low. */
  106. GPIO_DATA_HIGH = 1 /**< GPIO data high. */
  107. } gpio_data_t;
  108. typedef enum
  109. {
  110. POWER_MODE_330 = 0,
  111. POWER_MODE_180 = 1
  112. } gpio_power_mode_t;
  113. bool hal_gpio_check_valid(gpio_pin_t pin);
  114. int hal_gpio_get_data(gpio_pin_t pin, gpio_data_t *data);
  115. int hal_gpio_set_data(gpio_pin_t pin, gpio_data_t data);
  116. int hal_gpio_set_direction(gpio_pin_t pin, gpio_direction_t direction);
  117. int hal_gpio_get_direction(gpio_pin_t pin, gpio_direction_t *direction);
  118. int hal_gpio_set_pull(gpio_pin_t pin, gpio_pull_status_t pull);
  119. int hal_gpio_get_pull(gpio_pin_t pin, gpio_pull_status_t *pull);
  120. int hal_gpio_set_driving_level(gpio_pin_t pin, gpio_driving_level_t level);
  121. int hal_gpio_get_driving_level(gpio_pin_t pin, gpio_driving_level_t *level);
  122. int hal_gpio_pinmux_set_function(gpio_pin_t pin, gpio_muxsel_t function_index);
  123. int hal_gpio_sel_vol_mode(gpio_pin_t pins, gpio_power_mode_t pm_sel);
  124. int hal_gpio_set_debounce(gpio_pin_t pin, unsigned value);
  125. int hal_gpio_to_irq(gpio_pin_t pin, uint32_t *irq);
  126. int hal_gpio_irq_attach(uint32_t irq, void (*hdle)(void *), unsigned long flags, void *data);
  127. int hal_gpio_irq_request(uint32_t irq, irq_handler_t hdle, unsigned long flags, void *data);
  128. int hal_gpio_irq_free(uint32_t irq);
  129. int hal_gpio_irq_enable(uint32_t irq);
  130. int hal_gpio_irq_disable(uint32_t irq);
  131. int hal_gpio_init(void);
  132. #ifdef __cplusplus
  133. }
  134. #endif
  135. #endif