1 /*!
2     \file    gd32e10x_exti.h
3     \brief   definitions for the EXTI
4 
5     \version 2017-12-26, V1.0.0, firmware for GD32E10x
6     \version 2020-09-30, V1.1.0, firmware for GD32E10x
7     \version 2020-12-31, V1.2.0, firmware for GD32E10x
8     \version 2022-06-30, V1.3.0, firmware for GD32E10x
9 */
10 
11 /*
12     Copyright (c) 2022, GigaDevice Semiconductor Inc.
13 
14     Redistribution and use in source and binary forms, with or without modification,
15 are permitted provided that the following conditions are met:
16 
17     1. Redistributions of source code must retain the above copyright notice, this
18        list of conditions and the following disclaimer.
19     2. Redistributions in binary form must reproduce the above copyright notice,
20        this list of conditions and the following disclaimer in the documentation
21        and/or other materials provided with the distribution.
22     3. Neither the name of the copyright holder nor the names of its contributors
23        may be used to endorse or promote products derived from this software without
24        specific prior written permission.
25 
26     THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
27 AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
28 WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
29 IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT,
30 INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
31 NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
32 PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY,
33 WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
34 ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY
35 OF SUCH DAMAGE.
36 */
37 
38 #ifndef GD32E10X_EXTI_H
39 #define GD32E10X_EXTI_H
40 
41 #include "gd32e10x.h"
42 
43 /* EXTI definitions */
44 #define EXTI                         EXTI_BASE
45 
46 /* registers definitions */
47 #define EXTI_INTEN                   REG32(EXTI + 0x00U)      /*!< interrupt enable register */
48 #define EXTI_EVEN                    REG32(EXTI + 0x04U)      /*!< event enable register */
49 #define EXTI_RTEN                    REG32(EXTI + 0x08U)      /*!< rising edge trigger enable register */
50 #define EXTI_FTEN                    REG32(EXTI + 0x0CU)      /*!< falling trigger enable register */
51 #define EXTI_SWIEV                   REG32(EXTI + 0x10U)      /*!< software interrupt event register */
52 #define EXTI_PD                      REG32(EXTI + 0x14U)      /*!< pending register */
53 
54 /* bits definitions */
55 /* EXTI_INTEN */
56 #define EXTI_INTEN_INTEN0            BIT(0)                   /*!< interrupt from line 0 */
57 #define EXTI_INTEN_INTEN1            BIT(1)                   /*!< interrupt from line 1 */
58 #define EXTI_INTEN_INTEN2            BIT(2)                   /*!< interrupt from line 2 */
59 #define EXTI_INTEN_INTEN3            BIT(3)                   /*!< interrupt from line 3 */
60 #define EXTI_INTEN_INTEN4            BIT(4)                   /*!< interrupt from line 4 */
61 #define EXTI_INTEN_INTEN5            BIT(5)                   /*!< interrupt from line 5 */
62 #define EXTI_INTEN_INTEN6            BIT(6)                   /*!< interrupt from line 6 */
63 #define EXTI_INTEN_INTEN7            BIT(7)                   /*!< interrupt from line 7 */
64 #define EXTI_INTEN_INTEN8            BIT(8)                   /*!< interrupt from line 8 */
65 #define EXTI_INTEN_INTEN9            BIT(9)                   /*!< interrupt from line 9 */
66 #define EXTI_INTEN_INTEN10           BIT(10)                  /*!< interrupt from line 10 */
67 #define EXTI_INTEN_INTEN11           BIT(11)                  /*!< interrupt from line 11 */
68 #define EXTI_INTEN_INTEN12           BIT(12)                  /*!< interrupt from line 12 */
69 #define EXTI_INTEN_INTEN13           BIT(13)                  /*!< interrupt from line 13 */
70 #define EXTI_INTEN_INTEN14           BIT(14)                  /*!< interrupt from line 14 */
71 #define EXTI_INTEN_INTEN15           BIT(15)                  /*!< interrupt from line 15 */
72 #define EXTI_INTEN_INTEN16           BIT(16)                  /*!< interrupt from line 16 */
73 #define EXTI_INTEN_INTEN17           BIT(17)                  /*!< interrupt from line 17 */
74 #define EXTI_INTEN_INTEN18           BIT(18)                  /*!< interrupt from line 18 */
75 
76 /* EXTI_EVEN */
77 #define EXTI_EVEN_EVEN0              BIT(0)                   /*!< event from line 0 */
78 #define EXTI_EVEN_EVEN1              BIT(1)                   /*!< event from line 1 */
79 #define EXTI_EVEN_EVEN2              BIT(2)                   /*!< event from line 2 */
80 #define EXTI_EVEN_EVEN3              BIT(3)                   /*!< event from line 3 */
81 #define EXTI_EVEN_EVEN4              BIT(4)                   /*!< event from line 4 */
82 #define EXTI_EVEN_EVEN5              BIT(5)                   /*!< event from line 5 */
83 #define EXTI_EVEN_EVEN6              BIT(6)                   /*!< event from line 6 */
84 #define EXTI_EVEN_EVEN7              BIT(7)                   /*!< event from line 7 */
85 #define EXTI_EVEN_EVEN8              BIT(8)                   /*!< event from line 8 */
86 #define EXTI_EVEN_EVEN9              BIT(9)                   /*!< event from line 9 */
87 #define EXTI_EVEN_EVEN10             BIT(10)                  /*!< event from line 10 */
88 #define EXTI_EVEN_EVEN11             BIT(11)                  /*!< event from line 11 */
89 #define EXTI_EVEN_EVEN12             BIT(12)                  /*!< event from line 12 */
90 #define EXTI_EVEN_EVEN13             BIT(13)                  /*!< event from line 13 */
91 #define EXTI_EVEN_EVEN14             BIT(14)                  /*!< event from line 14 */
92 #define EXTI_EVEN_EVEN15             BIT(15)                  /*!< event from line 15 */
93 #define EXTI_EVEN_EVEN16             BIT(16)                  /*!< event from line 16 */
94 #define EXTI_EVEN_EVEN17             BIT(17)                  /*!< event from line 17 */
95 #define EXTI_EVEN_EVEN18             BIT(18)                  /*!< event from line 18 */
96 
97 /* EXTI_RTEN */
98 #define EXTI_RTEN_RTEN0              BIT(0)                   /*!< rising edge from line 0 */
99 #define EXTI_RTEN_RTEN1              BIT(1)                   /*!< rising edge from line 1 */
100 #define EXTI_RTEN_RTEN2              BIT(2)                   /*!< rising edge from line 2 */
101 #define EXTI_RTEN_RTEN3              BIT(3)                   /*!< rising edge from line 3 */
102 #define EXTI_RTEN_RTEN4              BIT(4)                   /*!< rising edge from line 4 */
103 #define EXTI_RTEN_RTEN5              BIT(5)                   /*!< rising edge from line 5 */
104 #define EXTI_RTEN_RTEN6              BIT(6)                   /*!< rising edge from line 6 */
105 #define EXTI_RTEN_RTEN7              BIT(7)                   /*!< rising edge from line 7 */
106 #define EXTI_RTEN_RTEN8              BIT(8)                   /*!< rising edge from line 8 */
107 #define EXTI_RTEN_RTEN9              BIT(9)                   /*!< rising edge from line 9 */
108 #define EXTI_RTEN_RTEN10             BIT(10)                  /*!< rising edge from line 10 */
109 #define EXTI_RTEN_RTEN11             BIT(11)                  /*!< rising edge from line 11 */
110 #define EXTI_RTEN_RTEN12             BIT(12)                  /*!< rising edge from line 12 */
111 #define EXTI_RTEN_RTEN13             BIT(13)                  /*!< rising edge from line 13 */
112 #define EXTI_RTEN_RTEN14             BIT(14)                  /*!< rising edge from line 14 */
113 #define EXTI_RTEN_RTEN15             BIT(15)                  /*!< rising edge from line 15 */
114 #define EXTI_RTEN_RTEN16             BIT(16)                  /*!< rising edge from line 16 */
115 #define EXTI_RTEN_RTEN17             BIT(17)                  /*!< rising edge from line 17 */
116 #define EXTI_RTEN_RTEN18             BIT(18)                  /*!< rising edge from line 18 */
117 
118 /* EXTI_FTEN */
119 #define EXTI_FTEN_FTEN0              BIT(0)                   /*!< falling edge from line 0 */
120 #define EXTI_FTEN_FTEN1              BIT(1)                   /*!< falling edge from line 1 */
121 #define EXTI_FTEN_FTEN2              BIT(2)                   /*!< falling edge from line 2 */
122 #define EXTI_FTEN_FTEN3              BIT(3)                   /*!< falling edge from line 3 */
123 #define EXTI_FTEN_FTEN4              BIT(4)                   /*!< falling edge from line 4 */
124 #define EXTI_FTEN_FTEN5              BIT(5)                   /*!< falling edge from line 5 */
125 #define EXTI_FTEN_FTEN6              BIT(6)                   /*!< falling edge from line 6 */
126 #define EXTI_FTEN_FTEN7              BIT(7)                   /*!< falling edge from line 7 */
127 #define EXTI_FTEN_FTEN8              BIT(8)                   /*!< falling edge from line 8 */
128 #define EXTI_FTEN_FTEN9              BIT(9)                   /*!< falling edge from line 9 */
129 #define EXTI_FTEN_FTEN10             BIT(10)                  /*!< falling edge from line 10 */
130 #define EXTI_FTEN_FTEN11             BIT(11)                  /*!< falling edge from line 11 */
131 #define EXTI_FTEN_FTEN12             BIT(12)                  /*!< falling edge from line 12 */
132 #define EXTI_FTEN_FTEN13             BIT(13)                  /*!< falling edge from line 13 */
133 #define EXTI_FTEN_FTEN14             BIT(14)                  /*!< falling edge from line 14 */
134 #define EXTI_FTEN_FTEN15             BIT(15)                  /*!< falling edge from line 15 */
135 #define EXTI_FTEN_FTEN16             BIT(16)                  /*!< falling edge from line 16 */
136 #define EXTI_FTEN_FTEN17             BIT(17)                  /*!< falling edge from line 17 */
137 #define EXTI_FTEN_FTEN18             BIT(18)                  /*!< falling edge from line 18 */
138 
139 /* EXTI_SWIEV */
140 #define EXTI_SWIEV_SWIEV0            BIT(0)                   /*!< software interrupt/event request from line 0 */
141 #define EXTI_SWIEV_SWIEV1            BIT(1)                   /*!< software interrupt/event request from line 1 */
142 #define EXTI_SWIEV_SWIEV2            BIT(2)                   /*!< software interrupt/event request from line 2 */
143 #define EXTI_SWIEV_SWIEV3            BIT(3)                   /*!< software interrupt/event request from line 3 */
144 #define EXTI_SWIEV_SWIEV4            BIT(4)                   /*!< software interrupt/event request from line 4 */
145 #define EXTI_SWIEV_SWIEV5            BIT(5)                   /*!< software interrupt/event request from line 5 */
146 #define EXTI_SWIEV_SWIEV6            BIT(6)                   /*!< software interrupt/event request from line 6 */
147 #define EXTI_SWIEV_SWIEV7            BIT(7)                   /*!< software interrupt/event request from line 7 */
148 #define EXTI_SWIEV_SWIEV8            BIT(8)                   /*!< software interrupt/event request from line 8 */
149 #define EXTI_SWIEV_SWIEV9            BIT(9)                   /*!< software interrupt/event request from line 9 */
150 #define EXTI_SWIEV_SWIEV10           BIT(10)                  /*!< software interrupt/event request from line 10 */
151 #define EXTI_SWIEV_SWIEV11           BIT(11)                  /*!< software interrupt/event request from line 11 */
152 #define EXTI_SWIEV_SWIEV12           BIT(12)                  /*!< software interrupt/event request from line 12 */
153 #define EXTI_SWIEV_SWIEV13           BIT(13)                  /*!< software interrupt/event request from line 13 */
154 #define EXTI_SWIEV_SWIEV14           BIT(14)                  /*!< software interrupt/event request from line 14 */
155 #define EXTI_SWIEV_SWIEV15           BIT(15)                  /*!< software interrupt/event request from line 15 */
156 #define EXTI_SWIEV_SWIEV16           BIT(16)                  /*!< software interrupt/event request from line 16 */
157 #define EXTI_SWIEV_SWIEV17           BIT(17)                  /*!< software interrupt/event request from line 17 */
158 #define EXTI_SWIEV_SWIEV18           BIT(18)                  /*!< software interrupt/event request from line 18 */
159 
160 /* EXTI_PD */
161 #define EXTI_PD_PD0                  BIT(0)                   /*!< interrupt/event pending status from line 0 */
162 #define EXTI_PD_PD1                  BIT(1)                   /*!< interrupt/event pending status from line 1 */
163 #define EXTI_PD_PD2                  BIT(2)                   /*!< interrupt/event pending status from line 2 */
164 #define EXTI_PD_PD3                  BIT(3)                   /*!< interrupt/event pending status from line 3 */
165 #define EXTI_PD_PD4                  BIT(4)                   /*!< interrupt/event pending status from line 4 */
166 #define EXTI_PD_PD5                  BIT(5)                   /*!< interrupt/event pending status from line 5 */
167 #define EXTI_PD_PD6                  BIT(6)                   /*!< interrupt/event pending status from line 6 */
168 #define EXTI_PD_PD7                  BIT(7)                   /*!< interrupt/event pending status from line 7 */
169 #define EXTI_PD_PD8                  BIT(8)                   /*!< interrupt/event pending status from line 8 */
170 #define EXTI_PD_PD9                  BIT(9)                   /*!< interrupt/event pending status from line 9 */
171 #define EXTI_PD_PD10                 BIT(10)                  /*!< interrupt/event pending status from line 10 */
172 #define EXTI_PD_PD11                 BIT(11)                  /*!< interrupt/event pending status from line 11 */
173 #define EXTI_PD_PD12                 BIT(12)                  /*!< interrupt/event pending status from line 12 */
174 #define EXTI_PD_PD13                 BIT(13)                  /*!< interrupt/event pending status from line 13 */
175 #define EXTI_PD_PD14                 BIT(14)                  /*!< interrupt/event pending status from line 14 */
176 #define EXTI_PD_PD15                 BIT(15)                  /*!< interrupt/event pending status from line 15 */
177 #define EXTI_PD_PD16                 BIT(16)                  /*!< interrupt/event pending status from line 16 */
178 #define EXTI_PD_PD17                 BIT(17)                  /*!< interrupt/event pending status from line 17 */
179 #define EXTI_PD_PD18                 BIT(18)                  /*!< interrupt/event pending status from line 18 */
180 
181 /* constants definitions */
182 /* EXTI line number */
183 typedef enum
184 {
185     EXTI_0      = BIT(0),                                     /*!< EXTI line 0 */
186     EXTI_1      = BIT(1),                                     /*!< EXTI line 1 */
187     EXTI_2      = BIT(2),                                     /*!< EXTI line 2 */
188     EXTI_3      = BIT(3),                                     /*!< EXTI line 3 */
189     EXTI_4      = BIT(4),                                     /*!< EXTI line 4 */
190     EXTI_5      = BIT(5),                                     /*!< EXTI line 5 */
191     EXTI_6      = BIT(6),                                     /*!< EXTI line 6 */
192     EXTI_7      = BIT(7),                                     /*!< EXTI line 7 */
193     EXTI_8      = BIT(8),                                     /*!< EXTI line 8 */
194     EXTI_9      = BIT(9),                                     /*!< EXTI line 9 */
195     EXTI_10     = BIT(10),                                    /*!< EXTI line 10 */
196     EXTI_11     = BIT(11),                                    /*!< EXTI line 11 */
197     EXTI_12     = BIT(12),                                    /*!< EXTI line 12 */
198     EXTI_13     = BIT(13),                                    /*!< EXTI line 13 */
199     EXTI_14     = BIT(14),                                    /*!< EXTI line 14 */
200     EXTI_15     = BIT(15),                                    /*!< EXTI line 15 */
201     EXTI_16     = BIT(16),                                    /*!< EXTI line 16 */
202     EXTI_17     = BIT(17),                                    /*!< EXTI line 17 */
203     EXTI_18     = BIT(18),                                    /*!< EXTI line 18 */
204 }exti_line_enum;
205 
206 /* external interrupt and event  */
207 typedef enum
208 {
209     EXTI_INTERRUPT   = 0,                                     /*!< EXTI interrupt mode */
210     EXTI_EVENT                                                /*!< EXTI event mode */
211 }exti_mode_enum;
212 
213 /* interrupt trigger mode */
214 typedef enum
215 {
216     EXTI_TRIG_RISING = 0,                                     /*!< EXTI rising edge trigger */
217     EXTI_TRIG_FALLING,                                        /*!< EXTI falling edge trigger */
218     EXTI_TRIG_BOTH                                            /*!< EXTI rising and falling edge trigger */
219 }exti_trig_type_enum;
220 
221 /* function declarations */
222 /* deinitialize the EXTI */
223 void exti_deinit(void);
224 /* enable the configuration of EXTI initialize */
225 void exti_init(exti_line_enum linex, exti_mode_enum mode, exti_trig_type_enum trig_type);
226 
227 /* enable the interrupts from EXTI line x */
228 void exti_interrupt_enable(exti_line_enum linex);
229 /* enable the events from EXTI line x */
230 void exti_event_enable(exti_line_enum linex);
231 /* disable the interrupts from EXTI line x */
232 void exti_interrupt_disable(exti_line_enum linex);
233 /* disable the events from EXTI line x */
234 void exti_event_disable(exti_line_enum linex);
235 
236 /* get EXTI lines pending flag */
237 FlagStatus exti_flag_get(exti_line_enum linex);
238 /* clear EXTI lines pending flag */
239 void exti_flag_clear(exti_line_enum linex);
240 /* get EXTI lines interrupt pending flag */
241 FlagStatus exti_interrupt_flag_get(exti_line_enum linex);
242 /* clear EXTI lines interrupt pending flag */
243 void exti_interrupt_flag_clear(exti_line_enum linex);
244 /* enable the EXTI software interrupt */
245 void exti_software_interrupt_enable(exti_line_enum linex);
246 /* disable the EXTI software interrupt */
247 void exti_software_interrupt_disable(exti_line_enum linex);
248 
249 #endif /* GD32E10X_EXTI_H */
250