Minor Doxygen documentation improvements.
[pub/lufa.git] / LUFA / Drivers / Board / XMEGA / A3BU_XPLAINED / LEDs.h
1 /*
2 LUFA Library
3 Copyright (C) Dean Camera, 2011.
4
5 dean [at] fourwalledcubicle [dot] com
6 www.fourwalledcubicle.com
7 */
8
9 /*
10 Copyright 2011 Dean Camera (dean [at] fourwalledcubicle [dot] com)
11
12 Permission to use, copy, modify, and distribute this software
13 and its documentation for any purpose and without fee is hereby
14 granted, provided that the above copyright notice appear in all
15 copies and that both that the copyright notice and this
16 permission notice and warranty disclaimer appear in supporting
17 documentation, and that the name of the author not be used in
18 advertising or publicity pertaining to distribution of the
19 software without specific, written prior permission.
20
21 The author disclaim all warranties with regard to this
22 software, including all implied warranties of merchantability
23 and fitness. In no event shall the author be liable for any
24 special, indirect or consequential damages or any damages
25 whatsoever resulting from loss of use, data or profits, whether
26 in an action of contract, negligence or other tortious action,
27 arising out of or in connection with the use or performance of
28 this software.
29 */
30
31 /** \file
32 * \brief Board specific LED driver header for the Atmel XMEGA A3BU Xplained.
33 * \copydetails Group_LEDs_A3BU_XPLAINED
34 *
35 * \note This file should not be included directly. It is automatically included as needed by the LEDs driver
36 * dispatch header located in LUFA/Drivers/Board/LEDs.h.
37 */
38
39 /** \ingroup Group_LEDs
40 * \defgroup Group_LEDs_A3BU_XPLAINED A3BU_XPLAINED
41 * \brief Board specific LED driver header for the Atmel XMEGA A3BU Xplained.
42 *
43 * Board specific LED driver header for the Atmel XMEGA A3BU Xplained.
44 *
45 * @{
46 */
47
48 #ifndef __LEDS_A3BU_XPLAINED_H__
49 #define __LEDS_A3BU_XPLAINED_H__
50
51 /* Includes: */
52 #include <avr/io.h>
53
54 /* Enable C linkage for C++ Compilers: */
55 #if defined(__cplusplus)
56 extern "C" {
57 #endif
58
59 /* Preprocessor Checks: */
60 #if !defined(__INCLUDE_FROM_LEDS_H)
61 #error Do not include this file directly. Include LUFA/Drivers/Board/LEDS.h instead.
62 #endif
63
64 /* Public Interface - May be used in end-application: */
65 /* Macros: */
66 /** LED mask for the first LED on the board. */
67 #define LEDS_LED1 (1 << 0)
68
69 /** LED mask for the second LED on the board. */
70 #define LEDS_LED2 (1 << 1)
71
72 /** LED mask for all the LEDs on the board. */
73 #define LEDS_ALL_LEDS (LEDS_LED1 | LEDS_LED2)
74
75 /** LED mask for none of the board LEDs. */
76 #define LEDS_NO_LEDS 0
77
78 /* Inline Functions: */
79 #if !defined(__DOXYGEN__)
80 static inline void LEDs_Init(void)
81 {
82 PORTR_DIRSET = LEDS_ALL_LEDS;
83 PORTR_OUTSET = LEDS_ALL_LEDS;
84 }
85
86 static inline void LEDs_TurnOnLEDs(const uint8_t LEDMask)
87 {
88 PORTR_OUTCLR = LEDMask;
89 }
90
91 static inline void LEDs_TurnOffLEDs(const uint8_t LEDMask)
92 {
93 PORTR_OUTSET = LEDMask;
94 }
95
96 static inline void LEDs_SetAllLEDs(const uint8_t LEDMask)
97 {
98 PORTR_OUT = (PORTR.OUT & ~LEDS_ALL_LEDS) | LEDMask;
99 }
100
101 static inline void LEDs_ChangeLEDs(const uint8_t LEDMask, const uint8_t ActiveMask)
102 {
103 PORTR_OUT = (PORTR.OUT & ~LEDMask) | ActiveMask;
104 }
105
106 static inline void LEDs_ToggleLEDs(const uint8_t LEDMask)
107 {
108 PORTR_OUTTGL = LEDMask;
109 }
110
111 static inline uint8_t LEDs_GetLEDs(void) ATTR_WARN_UNUSED_RESULT;
112 static inline uint8_t LEDs_GetLEDs(void)
113 {
114 return (PORTR_OUT & LEDS_ALL_LEDS);
115 }
116 #endif
117
118 /* Disable C linkage for C++ Compilers: */
119 #if defined(__cplusplus)
120 }
121 #endif
122
123 #endif
124
125 /** @} */
126
127