Loading...
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 | /* * Copyright (c) 2018 Linaro Limited * * SPDX-License-Identifier: Apache-2.0 */ #ifndef ZEPHYR_INCLUDE_LED_H_ #define ZEPHYR_INCLUDE_LED_H_ /** * @file * @brief Public LED driver APIs */ #include <zephyr/types.h> #include <device.h> /** * @typedef led_api_blink() * @brief Callback API for blinking an LED * * @see led_blink() for argument descriptions. */ typedef int (*led_api_blink)(struct device *dev, u32_t led, u32_t delay_on, u32_t delay_off); /** * @typedef led_api_set_brightness() * @brief Callback API for setting brightness of an LED * * @see led_set_brightness() for argument descriptions. */ typedef int (*led_api_set_brightness)(struct device *dev, u32_t led, u8_t value); /** * @typedef led_api_on() * @brief Callback API for turning on an LED * * @see led_on() for argument descriptions. */ typedef int (*led_api_on)(struct device *dev, u32_t led); /** * @typedef led_api_off() * @brief Callback API for turning off an LED * * @see led_off() for argument descriptions. */ typedef int (*led_api_off)(struct device *dev, u32_t led); /** * @brief LED driver API * * This is the mandatory API any LED driver needs to expose. */ struct led_driver_api { led_api_blink blink; led_api_set_brightness set_brightness; led_api_on on; led_api_off off; }; /** * @brief Blink an LED * * This routine starts blinking an LED forever with the given time period * * @param dev LED device * @param led LED channel/pin * @param delay_on Time period (in milliseconds) an LED should be ON * @param delay_off Time period (in milliseconds) an LED should be OFF * @return 0 on success, negative on error */ __syscall int led_blink(struct device *dev, u32_t led, u32_t delay_on, u32_t delay_off); static inline int z_impl_led_blink(struct device *dev, u32_t led, u32_t delay_on, u32_t delay_off) { const struct led_driver_api *api = dev->driver_api; return api->blink(dev, led, delay_on, delay_off); } /** * @brief Set LED brightness * * This routine sets the brightness of a LED to the given value. * Calling this function after led_blink() won't affect blinking. * * @param dev LED device * @param led LED channel/pin * @param value Brightness value to set in percent * @return 0 on success, negative on error */ __syscall int led_set_brightness(struct device *dev, u32_t led, u8_t value); static inline int z_impl_led_set_brightness(struct device *dev, u32_t led, u8_t value) { const struct led_driver_api *api = dev->driver_api; return api->set_brightness(dev, led, value); } /** * @brief Turn on an LED * * This routine turns on an LED * * @param dev LED device * @param led LED channel/pin * @return 0 on success, negative on error */ __syscall int led_on(struct device *dev, u32_t led); static inline int z_impl_led_on(struct device *dev, u32_t led) { const struct led_driver_api *api = dev->driver_api; return api->on(dev, led); } /** * @brief Turn off an LED * * This routine turns off an LED * * @param dev LED device * @param led LED channel/pin * @return 0 on success, negative on error */ __syscall int led_off(struct device *dev, u32_t led); static inline int z_impl_led_off(struct device *dev, u32_t led) { const struct led_driver_api *api = dev->driver_api; return api->off(dev, led); } #include <syscalls/led.h> #endif /* ZEPHYR_INCLUDE_LED_H_ */ |