VSF Documented
vsf_template_timer.h
Go to the documentation of this file.
1/*****************************************************************************
2 * Copyright(C)2009-2022 by VSF Team *
3 * *
4 * Licensed under the Apache License, Version 2.0 (the "License"); *
5 * you may not use this file except in compliance with the License. *
6 * You may obtain a copy of the License at *
7 * *
8 * http://www.apache.org/licenses/LICENSE-2.0 *
9 * *
10 * Unless required by applicable law or agreed to in writing, software *
11 * distributed under the License is distributed on an "AS IS" BASIS, *
12 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. *
13 * See the License for the specific language governing permissions and *
14 * limitations under the License. *
15 * *
16 ****************************************************************************/
17
18#ifndef __VSF_TEMPLATE_TIMER_H__
19#define __VSF_TEMPLATE_TIMER_H__
20
21/*============================ INCLUDES ======================================*/
22
24#include "hal/arch/vsf_arch.h"
25
26#ifdef __cplusplus
27extern "C" {
28#endif
29
30/*============================ MACROS ========================================*/
31
38#ifndef VSF_TIMER_CFG_MULTI_CLASS
39# define VSF_TIMER_CFG_MULTI_CLASS ENABLED
40#endif
41
50#if defined(VSF_HW_TIMER_COUNT) && !defined(VSF_HW_TIMER_MASK)
51# define VSF_HW_TIMER_MASK VSF_HAL_COUNT_TO_MASK(VSF_HW_TIMER_COUNT)
52#endif
53
54#if defined(VSF_HW_TIMER_MASK) && !defined(VSF_HW_TIMER_COUNT)
55# define VSF_HW_TIMER_COUNT VSF_HAL_MASK_TO_COUNT(VSF_HW_TIMER_MASK)
56#endif
57
64#ifndef VSF_TIMER_CFG_PREFIX
65# if VSF_TIMER_CFG_MULTI_CLASS == ENABLED
66# define VSF_TIMER_CFG_PREFIX vsf
67# elif defined(VSF_HW_TIMER_COUNT) && (VSF_HW_TIMER_COUNT != 0)
68# define VSF_TIMER_CFG_PREFIX vsf_hw
69# else
70# define VSF_TIMER_CFG_PREFIX vsf
71# endif
72#endif
73
80#ifndef VSF_TIMER_CFG_FUNCTION_RENAME
81# define VSF_TIMER_CFG_FUNCTION_RENAME ENABLED
82#endif
83
92#ifndef VSF_TIMER_CFG_REIMPLEMENT_TYPE_IRQ_MASK
93# define VSF_TIMER_CFG_REIMPLEMENT_TYPE_IRQ_MASK DISABLED
94#endif
95
106#if VSF_TIMER_CFG_REIMPLEMENT_TYPE_CFG == DISABLED
107# define VSF_TIMER_CFG_REIMPLEMENT_TYPE_CFG DISABLED
108#endif
109
118#if VSF_TIMER_CFG_REIMPLEMENT_TYPE_CHANNEL_MODE == DISABLED
119# define VSF_TIMER_CFG_REIMPLEMENT_TYPE_CHANNEL_MODE DISABLED
120#endif
121
131#if VSF_TIMER_CFG_REIMPLEMENT_TYPE_CHANNEL_CFG == DISABLED
132# define VSF_TIMER_CFG_REIMPLEMENT_TYPE_CHANNEL_CFG DISABLED
133#endif
134
144#if VSF_TIMER_CFG_REIMPLEMENT_TYPE_CHANNEL_REQUEST == DISABLED
145# define VSF_TIMER_CFG_REIMPLEMENT_TYPE_CHANNEL_REQUEST DISABLED
146#endif
147
156#ifndef VSF_TIMER_CFG_REIMPLEMENT_TYPE_STATUS
157# define VSF_TIMER_CFG_REIMPLEMENT_TYPE_STATUS DISABLED
158#endif
159
168#ifndef VSF_TIMER_CFG_REIMPLEMENT_TYPE_CTRL
169# define VSF_TIMER_CFG_REIMPLEMENT_TYPE_CTRL DISABLED
170#endif
171
180#ifndef VSF_TIMER_CFG_REIMPLEMENT_TYPE_CHANNEL_CTRL
181# define VSF_TIMER_CFG_REIMPLEMENT_TYPE_CHANNEL_CTRL DISABLED
182#endif
183
193#if VSF_TIMER_CFG_REIMPLEMENT_TYPE_CAPABILITY == DISABLED
194# define VSF_TIMER_CFG_REIMPLEMENT_TYPE_CAPABILITY DISABLED
195#endif
196
204#ifndef VSF_TIMER_CFG_INHERIT_HAL_CAPABILITY
205# define VSF_TIMER_CFG_INHERIT_HAL_CAPABILITY ENABLED
206#endif
207
208/*============================ MACROFIED FUNCTIONS ===========================*/
209
216#define VSF_TIMER_APIS(__prefix_name) \
217 __VSF_HAL_TEMPLATE_API(__prefix_name, vsf_err_t, timer, init, VSF_MCONNECT(__prefix_name, _timer_t) *timer_ptr, vsf_timer_cfg_t *cfg_ptr) \
218 __VSF_HAL_TEMPLATE_API(__prefix_name, void, timer, fini, VSF_MCONNECT(__prefix_name, _timer_t) *timer_ptr) \
219 __VSF_HAL_TEMPLATE_API(__prefix_name, fsm_rt_t, timer, enable, VSF_MCONNECT(__prefix_name, _timer_t) *timer_ptr) \
220 __VSF_HAL_TEMPLATE_API(__prefix_name, fsm_rt_t, timer, disable, VSF_MCONNECT(__prefix_name, _timer_t) *timer_ptr) \
221 __VSF_HAL_TEMPLATE_API(__prefix_name, void, timer, irq_enable, VSF_MCONNECT(__prefix_name, _timer_t) *timer_ptr, vsf_timer_irq_mask_t irq_mask) \
222 __VSF_HAL_TEMPLATE_API(__prefix_name, void, timer, irq_disable, VSF_MCONNECT(__prefix_name, _timer_t) *timer_ptr, vsf_timer_irq_mask_t irq_mask) \
223 __VSF_HAL_TEMPLATE_API(__prefix_name, vsf_timer_status_t, timer, status, VSF_MCONNECT(__prefix_name, _timer_t) *timer_ptr) \
224 __VSF_HAL_TEMPLATE_API(__prefix_name, vsf_timer_capability_t, timer, capability, VSF_MCONNECT(__prefix_name, _timer_t) *timer_ptr) \
225 __VSF_HAL_TEMPLATE_API(__prefix_name, vsf_err_t, timer, set_period, VSF_MCONNECT(__prefix_name, _timer_t) *timer_ptr, uint32_t period) \
226 __VSF_HAL_TEMPLATE_API(__prefix_name, vsf_err_t, timer, ctrl, VSF_MCONNECT(__prefix_name, _timer_t) *timer_ptr, vsf_timer_ctrl_t ctrl, void* param) \
227 __VSF_HAL_TEMPLATE_API(__prefix_name, vsf_err_t, timer, channel_config, VSF_MCONNECT(__prefix_name, _timer_t) *timer_ptr, uint8_t channel, vsf_timer_channel_cfg_t *channel_cfg_ptr) \
228 __VSF_HAL_TEMPLATE_API(__prefix_name, vsf_err_t, timer, channel_start, VSF_MCONNECT(__prefix_name, _timer_t) *timer_ptr, uint8_t channel) \
229 __VSF_HAL_TEMPLATE_API(__prefix_name, vsf_err_t, timer, channel_stop, VSF_MCONNECT(__prefix_name, _timer_t) *timer_ptr, uint8_t channel) \
230 __VSF_HAL_TEMPLATE_API(__prefix_name, vsf_err_t, timer, channel_request_start, VSF_MCONNECT(__prefix_name, _timer_t) *timer_ptr, uint8_t channel, vsf_timer_channel_request_t *request_ptr) \
231 __VSF_HAL_TEMPLATE_API(__prefix_name, vsf_err_t, timer, channel_request_stop, VSF_MCONNECT(__prefix_name, _timer_t) *timer_ptr, uint8_t channel) \
232 __VSF_HAL_TEMPLATE_API(__prefix_name, vsf_err_t, timer, channel_ctrl, VSF_MCONNECT(__prefix_name, _timer_t) *timer_ptr, uint8_t channel, vsf_timer_channel_ctrl_t ctrl, void* param)
233
234/*============================ TYPES =========================================*/
235
236#if VSF_TIMER_CFG_REIMPLEMENT_TYPE_CHANNEL_MODE == DISABLED
238 // channel mode : different timer channel may support different mode
239 // Base Mode : The timer channel will be used as a base timer
241
242 /*
243 // \~english Some timer may support more mode like PWM, Output Compare etc.
244 // \~chinese 有些定时器可能支持更多的模式,如 PWM、输出比较等。
245
246 // \~english PWM(Pulse Width Modulation) Mode : The timer channel will be used as a
247 // PWM output, all channels's period should be the same
248 // \~chinese PWM(脉宽调制)模式:定时器通道将用作 PWM 输出,所有通道的周期应该相同
249 VSF_TIMER_CHANNEL_MODE_PWM = (0x01 << 0),
250 #define VSF_TIMER_CHANNEL_MODE_PWM VSF_TIMER_CHANNEL_MODE_PWM
251
252 // \~english Output Compare Mode: The timer channel will be used as a output compare,
253 // different channels can have different period (change pin level in interrupt)
254 // PWM mode can be seen as a special case of output compare mode, that is all
255 // channels have the same period.
256 // \~chinese 输出比较模式:定时器通道将用作输出比较,不同通道可以有不同的周期(在中断中改变引脚电平)。
257 // PWM 模式可以看作是输出比较模式的一种特殊情况,即所有通道的周期相同。
258 VSF_TIMER_CHANNEL_MODE_OUTPUT_COMPARE = (0x02 << 0),
259 #define VSF_TIMER_CHANNEL_MODE_OUTPUT_COMPARE VSF_TIMER_CHANNEL_MODE_OUTPUT_COMPARE
260
261 // \~english Input Capture Mode : The timer channel will be used as a input capture
262 // \~chinese 输入捕获模式:定时器通道将用作输入捕获
263 VSF_TIMER_CHANNEL_MODE_INPUT_CAPTURE = (0x03 << 0),
264 #define VSF_TIMER_CHANNEL_MODE_INPUT_CAPTURE VSF_TIMER_CHANNEL_MODE_INPUT_CAPTURE
265
266 // \~english Encoder Mode : The timer channel will be used as a encoder
267 // \~chinese 编码器模式:定时器通道将用作编码器
268 VSF_TIMER_CHANNEL_MODE_ENCODER = (0x04 << 0),
269 #define VSF_TIMER_CHANNEL_MODE_ENCODER VSF_TIMER_CHANNEL_MODE_ENCODER
270
271 // \~english One Pulse Mode : The timer channel will be used as a one pulse mode
272 // \~chinese 单脉冲模式:定时器通道将用作单脉冲模式
273 VSF_TIMER_CHANNEL_MODE_ONE_PULSE = (0x05 << 0),
274 #define VSF_TIMER_CHANNEL_MODE_ONE_PULSE VSF_TIMER_CHANNEL_MODE_ONE_PULSE
275
276 // \~english Hall Sensor Mode : The timer channel will be used as a hall sensor
277 // \~chinese 霍尔传感器模式:定时器通道将用作霍尔传感器
278 VSF_TIMER_CHANNEL_MODE_HALL_SENSOR = (0x06 << 0),
279 #define VSF_TIMER_CHANNEL_MODE_HALL_SENSOR VSF_TIMER_CHANNEL_MODE_HALL_SENSOR
280 */
281
282 /********************************************************************************/
285
286 // Counter Mode
287 // Oneshot : The timer will stop after the first overflow
289 // Continues : The timer will continue to count after overflow
291 /*
292 // \~english Some timer may support more counter direction like center-aligned etc.
293 // The following mode only valid for VSF_TIMER_CHANNEL_MODE_BASE
294 // \~chinese 有些定时器可能支持更多的计数模式,如中心对齐等。以下模式仅适用于 VSF_TIMER_CHANNEL_MODE_BASE
295 VSF_TIMER_BASE_COUNTER_UP = (0x00 << 4),
296 VSF_TIMER_BASE_COUNTER_DOWN = (0x01 << 4),
297 VSF_TIMER_BASE_COUNTER_CENTER_ALIGNED1 = (0x02 << 4),
298 VSF_TIMER_BASE_COUNTER_CENTER_ALIGNED2 = (0x03 << 4),
299 VSF_TIMER_BASE_COUNTER_CENTER_ALIGNED3 = (0x04 << 4),
300 #define VSF_TIMER_BASE_COUNTER_UP VSF_TIMER_BASE_COUNTER_UP
301 #define VSF_TIMER_BASE_COUNTER_DOWN VSF_TIMER_BASE_COUNTER_DOWN
302 #define VSF_TIMER_BASE_COUNTER_CENTER_ALIGNED1 VSF_TIMER_BASE_COUNTER_CENTER_ALIGNED1
303 #define VSF_TIMER_BASE_COUNTER_CENTER_ALIGNED2 VSF_TIMER_BASE_COUNTER_CENTER_ALIGNED2
304 #define VSF_TIMER_BASE_COUNTER_CENTER_ALIGNED3 VSF_TIMER_BASE_COUNTER_CENTER_ALIGNED3
305 */
306
307 /*
308 // \~english Some timer may support more clock division like 1, 2, 4 etc.
309 // \~chinese 有些定时器可能支持更多的时钟分频,如 1、2、4 等。
310 VSF_TIEMR_BASE_CLOCKDIVISION_DIV_1 = (0x00 << 8),
311 VSF_TIEMR_BASE_CLOCKDIVISION_DIV_2 = (0x01 << 8),
312 VSF_TIEMR_BASE_CLOCKDIVISION_DIV_4 = (0x02 << 8),
313 #define VSF_TIEMR_BASE_CLOCKDIVISION_DIV_1 VSF_TIEMR_BASE_CLOCKDIVISION_DIV_1
314 #define VSF_TIEMR_BASE_CLOCKDIVISION_DIV_2 VSF_TIEMR_BASE_CLOCKDIVISION_DIV_2
315 #define VSF_TIEMR_BASE_CLOCKDIVISION_DIV_4 VSF_TIEMR_BASE_CLOCKDIVISION_DIV_4
316 */
317
318 /********************************************************************************/
319 /*
320 // \~english The following mode only valid for VSF_TIMER_CHANNEL_MODE_PWM
321 // \~chinese 以下模式仅适用于 VSF_TIMER_CHANNEL_MODE_PWM
322 // Output Compare Mode
323 VSF_TIMER_OUTPUT_COMPARE_ACTIVE = (0x00 << 4),
324 VSF_TIMER_OUTPUT_COMPARE_INACTIVE = (0x01 << 4),
325 VSF_TIMER_OUTPUT_COMPARE_TOGGLE = (0x02 << 4),
326 VSF_TIMER_OUTPUT_COMPARE_PWM1 = (0x03 << 4),
327 VSF_TIMER_OUTPUT_COMPARE_PWM2 = (0x04 << 4),
328 VSF_TIMER_OUTPUT_COMPARE_FORCED_ACTIVE = (0x05 << 4),
329 VSF_TIMER_OUTPUT_COMPARE_FORCED_INACTIVE = (0x06 << 4),
330 #define VSF_TIMER_OUTPUT_COMPARE_ACTIVE VSF_TIMER_OUTPUT_COMPARE_ACTIVE
331 #define VSF_TIMER_OUTPUT_COMPARE_INACTIVE VSF_TIMER_OUTPUT_COMPARE_INACTIVE
332 #define VSF_TIMER_OUTPUT_COMPARE_TOGGLE VSF_TIMER_OUTPUT_COMPARE_TOGGLE
333 #define VSF_TIMER_OUTPUT_COMPARE_PWM1 VSF_TIMER_OUTPUT_COMPARE_PWM1
334 #define VSF_TIMER_OUTPUT_COMPARE_PWM2 VSF_TIMER_OUTPUT_COMPARE_PWM2
335 #define VSF_TIMER_OUTPUT_COMPARE_FORCED_ACTIVE VSF_TIMER_OUTPUT_COMPARE_FORCED_ACTIVE
336 #define VSF_TIMER_OUTPUT_COMPARE_FORCED_INACTIVE VSF_TIMER_OUTPUT_COMPARE_FORCED_INACTIVE
337 */
338
339 /********************************************************************************/
340 /*
341 // \~english The following mode only valid for VSF_TIMER_CHANNEL_MODE_OUTPUT_COMPARE
342 // \~chinese 以下模式仅适用于 VSF_TIMER_CHANNEL_MODE_OUTPUT_COMPARE
343
344 // \~english Output Compare Polarity and N Polarity
345 // \~chinese 输出比较极性和 N 极性
346 VSF_TIMER_OUTPUT_COMPARE_POLARITY_HIGH = (0x00 << 8),
347 VSF_TIMER_OUTPUT_COMPARE_POLARITY_LOW = (0x01 << 8),
348 VSF_TIMER_OUTPUT_COMPARE_N_POLARITY_HIGH = (0x00 << 8),
349 VSF_TIMER_OUTPUT_COMPARE_N_POLARITY_LOW = (0x01 << 8),
350 #define VSF_TIMER_OUTPUT_COMPARE_POLARITY_HIGH VSF_TIMER_OUTPUT_COMPARE_POLARITY_HIGH
351 #define VSF_TIMER_OUTPUT_COMPARE_POLARITY_LOW VSF_TIMER_OUTPUT_COMPARE_POLARITY_LOW
352 #define VSF_TIMER_OUTPUT_COMPARE_N_POLARITY_HIGH VSF_TIMER_OUTPUT_COMPARE_N_POLARITY_HIGH
353 #define VSF_TIMER_OUTPUT_COMPARE_N_POLARITY_LOW VSF_TIMER_OUTPUT_COMPARE_N_POLARITY_LOW
354 */
355
356 /********************************************************************************/
357 /*
358 // \~english The following mode only valid for VSF_TIMER_CHANNEL_MODE_PWM
359 // \~chinese 以下模式仅适用于 VSF_TIMER_CHANNEL_MODE_PWM
360
361 // \~english PWM Output Polarity
362 // \~chinese PWM 输出极性
363 VSF_TIMER_PWM_OUTPUT_POLARITY_HIGH = (0x00 << 4),
364 VSF_TIMER_PWM_OUTPUT_POLARITY_LOW = (0x01 << 4),
365 #define VSF_TIMER_PWM_OUTPUT_POLARITY_HIGH VSF_TIMER_PWM_OUTPUT_POLARITY_HIGH
366 #define VSF_TIMER_PWM_OUTPUT_POLARITY_LOW VSF_TIMER_PWM_OUTPUT_POLARITY_LOW
367 */
368
369 /********************************************************************************/
370 /*
371 // \~english The following mode only valid for VSF_TIMER_CHANNEL_MODE_INPUT_CAPTURE
372 // \~chinese 以下模式仅适用于 VSF_TIMER_CHANNEL_MODE_INPUT_CAPTURE
373
374 // \~english Input Capture Polarity
375 // \~chinese 输入捕获极性
376 VSF_TIMER_INPUT_CAPTURE_POLARITY_RISING = (0x00 << 4),
377 VSF_TIMER_INPUT_CAPTURE_POLARITY_FALLING = (0x01 << 4),
378 VSF_TIMER_INPUT_CAPTURE_POLARITY_BOTH = (0x02 << 4),
379 #define VSF_TIMER_INPUT_CAPTURE_POLARITY_RISING VSF_TIMER_INPUT_CAPTURE_POLARITY_RISING
380 #define VSF_TIMER_INPUT_CAPTURE_POLARITY_FALLING VSF_TIMER_INPUT_CAPTURE_POLARITY_FALLING
381 #define VSF_TIMER_INPUT_CAPTURE_POLARITY_BOTH VSF_TIMER_INPUT_CAPTURE_POLARITY_BOTH
382
383 // \~english Input Capture Filter
384 // \~chinese 输入捕获滤波
385 VSF_TIMER_INPUT_CAPTURE_FILTER_MASK = (0x0F << 4),
386 VSF_TIMER_INPUT_CAPTURE_FILTER_OFFSET = 4,
387 */
388
389 /********************************************************************************/
390 /*
391 // \~english The following mode only valid for VSF_TIMER_CHANNEL_MODE_ENCODER
392 // \~chinese 以下模式仅适用于 VSF_TIMER_CHANNEL_MODE_ENCODER
393
394 // \~english Encoder Mode
395 // \~chinese 编码器模式
396 VSF_TIMER_ENCODER_CHANNEL_A_POLARITY_RISING = (0x00 << 4),
397 VSF_TIMER_ENCODER_CHANNEL_A_POLARITY_FALLING = (0x01 << 4),
398 VSF_TIMER_ENCODER_CHANNEL_A_POLARITY_BOTH = (0x02 << 4),
399 VSF_TIMER_ENCODER_CHANNEL_B_POLARITY_RISING = (0x00 << 6),
400 VSF_TIMER_ENCODER_CHANNEL_B_POLARITY_FALLING = (0x01 << 6),
401 VSF_TIMER_ENCODER_CHANNEL_B_POLARITY_BOTH = (0x02 << 6),
402 #define VSF_TIMER_ENCODER_CHANNEL_A_POLARITY_RISING VSF_TIMER_ENCODER_CHANNEL_A_POLARITY_RISING
403 #define VSF_TIMER_ENCODER_CHANNEL_A_POLARITY_FALLING VSF_TIMER_ENCODER_CHANNEL_A_POLARITY_FALLING
404 #define VSF_TIMER_ENCODER_CHANNEL_A_POLARITY_BOTH VSF_TIMER_ENCODER_CHANNEL_A_POLARITY_BOTH
405 #define VSF_TIMER_ENCODER_CHANNEL_B_POLARITY_RISING VSF_TIMER_ENCODER_CHANNEL_B_POLARITY_RISING
406 #define VSF_TIMER_ENCODER_CHANNEL_B_POLARITY_FALLING VSF_TIMER_ENCODER_CHANNEL_B_POLARITY_FALLING
407 #define VSF_TIMER_ENCODER_CHANNEL_B_POLARITY_BOTH VSF_TIMER_ENCODER_CHANNEL_B_POLARITY_BOTH
408 */
410#endif
411
412enum {
413#ifndef VSF_TIMER_CHANNEL_MODE_MASK
415#ifdef VSF_TIMER_CHANNEL_MODE_PWM
416 | VSF_TIMER_CHANNEL_MODE_PWM
417#endif
418#ifdef VSF_TIMER_CHANNEL_MODE_OUTPUT_COMPARE
419 | VSF_TIMER_CHANNEL_MODE_OUTPUT_COMPARE
420#endif
421#ifdef VSF_TIMER_CHANNEL_MODE_INPUT_CAPTURE
422 | VSF_TIMER_CHANNEL_MODE_INPUT_CAPTURE
423#endif
424#ifdef VSF_TIMER_CHANNEL_MODE_ENCODER
425 | VSF_TIMER_CHANNEL_MODE_ENCODER
426#endif
427#ifdef VSF_TIMER_CHANNEL_MODE_ONE_PULSE
428 | VSF_TIMER_CHANNEL_MODE_ONE_PULSE
429#endif
430#ifdef VSF_TIMER_CHANNEL_MODE_HALL_SENSOR
431 | VSF_TIMER_CHANNEL_MODE_HALL_SENSOR
432#endif
434#endif
435
436#ifndef VSF_TIMER_BASE_COUNTER_MASK
439#endif
440
441#ifndef VSF_TIMER_CHANNEL_MODE_ALL_MASK
444#endif
446
447#if VSF_TIMER_CFG_REIMPLEMENT_TYPE_IRQ_MASK == DISABLED
450
451 /*
452 // \~english We can define more channel irq mask here
453 // \~chinese 我们可以在这里定义更多的通道的不同模式的中断掩码
454
455 VSF_TIMER_IRQ_MASK_CHANNEL_0_INPUT_CAPTURE = (0x01 << 1),
456 VSF_TIMER_IRQ_MASK_CHANNEL_0_OUTPUT_COMPARE = (0x01 << 2),
457 VSF_TIMER_IRQ_MASK_CHANNEL_0_PWM = (0x01 << 3),
458
459 // We can define more channel irq mask here
460 VSF_TIMER_IRQ_MASK_CHANNEL_1_INPUT_CAPTURE = (0x01 << 3),
461 #define VSF_TIMER_IRQ_MASK_CHANNEL_1_INPUT_CAPTURE VSF_TIMER_IRQ_MASK_CHANNEL_1_INPUT_CAPTURE
462 VSF_TIMER_IRQ_MASK_CHANNEL_1_OUTPUT_COMPARE = (0x01 << 4),
463 #define VSF_TIMER_IRQ_MASK_CHANNEL_1_OUTPUT_COMPARE VSF_TIMER_IRQ_MASK_CHANNEL_1_OUTPUT_COMPARE
464 VSF_TIMER_IRQ_MASK_CHANNEL_2_INPUT_CAPTURE = (0x01 << 5),
465 #define VSF_TIMER_IRQ_MASK_CHANNEL_2_INPUT_CAPTURE VSF_TIMER_IRQ_MASK_CHANNEL_2_INPUT_CAPTURE
466 VSF_TIMER_IRQ_MASK_CHANNEL_2_OUTPUT_COMPARE = (0x01 << 6),
467 #define VSF_TIMER_IRQ_MASK_CHANNEL_2_OUTPUT_COMPARE VSF_TIMER_IRQ_MASK_CHANNEL_2_OUTPUT_COMPARE
468 */
470#endif
471
472enum {
475};
476
477#if VSF_TIMER_CFG_REIMPLEMENT_TYPE_CFG == DISABLED
479
480typedef void vsf_timer_isr_handler_t(void *target_ptr,
481 vsf_timer_t *timer_ptr,
483
484typedef struct vsf_timer_isr_t {
489
491
498typedef struct vsf_timer_cfg_t {
500 union {
503 };
506#endif
507
508#if VSF_TIMER_CFG_REIMPLEMENT_TYPE_CHANNEL_CFG == DISABLED
513#endif
514
515
516#if VSF_TIMER_CFG_REIMPLEMENT_TYPE_CTRL == DISABLED
533typedef enum vsf_timer_ctrl_t {
536#endif
537
538#if VSF_TIMER_CFG_REIMPLEMENT_TYPE_CHANNEL_CTRL == DISABLED
558#endif
559
560#if VSF_TIMER_CFG_REIMPLEMENT_TYPE_CHANNEL_CFG == DISABLED
563 union {
564 // for VSF_TIMER_CHANNEL_MODE_BASE mode
566 // for VSF_TIMER_CHANNEL_MODE_PWM mode and VSF_TIMER_CHANNEL_MODE_OUTPUT_COMPARE mode
568 // for VSF_TIMER_CHANNEL_MODE_INPUT_CAPTURE mode
570 // for VSF_TIMER_CHANNEL_MODE_ENCODER mode
571 struct {
574 };
575 };
577#endif
578
587#if VSF_TIMER_CFG_REIMPLEMENT_TYPE_STATUS == DISABLED
588typedef struct vsf_timer_status_t {
589 union {
592 };
594#endif
595
596
597#if VSF_TIMER_CFG_REIMPLEMENT_TYPE_CAPABILITY == DISABLED
599#if VSF_TIMER_CFG_INHERIT_HAL_CAPABILITY == ENABLED
601#endif
602 // support interrupt for timer
604
605 // timer bit length, like 16bit, 32bit etc.
607 // timer channel count, like 1, 2, 4 etc.
609
610 // support different channel mode
611 // we can redefine it if different channel support different mode.
617#endif
618
619typedef struct vsf_timer_op_t {
621#undef __VSF_HAL_TEMPLATE_API
622#define __VSF_HAL_TEMPLATE_API VSF_HAL_TEMPLATE_API_FP
624
625 VSF_TIMER_APIS(vsf)
627
628#if VSF_TIMER_CFG_MULTI_CLASS == ENABLED
631};
632#endif
633
634/*============================ GLOBAL VARIABLES ==============================*/
635/*============================ PROTOTYPES ====================================*/
636
656extern vsf_err_t vsf_timer_init(vsf_timer_t *timer_ptr, vsf_timer_cfg_t *cfg_ptr);
657
669extern void vsf_timer_fini(vsf_timer_t *timer_ptr);
670
682extern fsm_rt_t vsf_timer_enable(vsf_timer_t *timer_ptr);
683
695extern fsm_rt_t vsf_timer_disable(vsf_timer_t *timer_ptr);
696
713
728
741
754
768extern vsf_err_t vsf_timer_set_period(vsf_timer_t *timer_ptr, uint32_t period);
769
792extern vsf_err_t vsf_timer_ctrl(vsf_timer_t *timer_ptr, vsf_timer_ctrl_t ctrl, void *param);
793
810 uint8_t channel,
811 vsf_timer_channel_cfg_t *channel_cfg_ptr);
812
826extern vsf_err_t vsf_timer_channel_start(vsf_timer_t *timer_ptr, uint8_t channel);
827
841extern vsf_err_t vsf_timer_channel_stop(vsf_timer_t *timer_ptr, uint8_t channel);
842
874
889
914extern vsf_err_t vsf_timer_channel_ctrl(vsf_timer_t *timer_ptr, uint8_t channel, vsf_timer_channel_ctrl_t ctrl, void *param);
915
916/*============================ MACROFIED FUNCTIONS ===========================*/
917
919#if VSF_TIMER_CFG_FUNCTION_RENAME == ENABLED
920# define __vsf_timer_t VSF_MCONNECT(VSF_TIMER_CFG_PREFIX, _timer_t)
921# define vsf_timer_init(__TIME, ...) VSF_MCONNECT(VSF_TIMER_CFG_PREFIX, _timer_init) ((__vsf_timer_t *)(__TIME), ##__VA_ARGS__)
922# define vsf_timer_fini(__TIME) VSF_MCONNECT(VSF_TIMER_CFG_PREFIX, _timer_fini) ((__vsf_timer_t *)(__TIME))
923# define vsf_timer_enable(__TIME) VSF_MCONNECT(VSF_TIMER_CFG_PREFIX, _timer_enable) ((__vsf_timer_t *)(__TIME))
924# define vsf_timer_disable(__TIME) VSF_MCONNECT(VSF_TIMER_CFG_PREFIX, _timer_disable) ((__vsf_timer_t *)(__TIME))
925# define vsf_timer_status(__TIMER) VSF_MCONNECT(VSF_TIMER_CFG_PREFIX, _timer_status) ((__vsf_timer_t *)(__TIMER))
926# define vsf_timer_capability(__TIME) VSF_MCONNECT(VSF_TIMER_CFG_PREFIX, _timer_capability) ((__vsf_timer_t *)(__TIME))
927# define vsf_timer_irq_enable(__TIME, ...) VSF_MCONNECT(VSF_TIMER_CFG_PREFIX, _timer_irq_enable) ((__vsf_timer_t *)(__TIME), ##__VA_ARGS__)
928# define vsf_timer_irq_disable(__TIME, ...) VSF_MCONNECT(VSF_TIMER_CFG_PREFIX, _timer_irq_disable) ((__vsf_timer_t *)(__TIME), ##__VA_ARGS__)
929# define vsf_timer_set_period(__TIME, ...) VSF_MCONNECT(VSF_TIMER_CFG_PREFIX, _timer_set_period) ((__vsf_timer_t *)(__TIME), ##__VA_ARGS__)
930# define vsf_timer_ctrl(__TIME, ...) VSF_MCONNECT(VSF_TIMER_CFG_PREFIX, _timer_ctrl) ((__vsf_timer_t *)(__TIME), ##__VA_ARGS__)
931# define vsf_timer_channel_config(__TIME, ...) VSF_MCONNECT(VSF_TIMER_CFG_PREFIX, _timer_channel_config) ((__vsf_timer_t *)(__TIME), ##__VA_ARGS__)
932# define vsf_timer_channel_start(__TIME, ...) VSF_MCONNECT(VSF_TIMER_CFG_PREFIX, _timer_channel_start) ((__vsf_timer_t *)(__TIME), ##__VA_ARGS__)
933# define vsf_timer_channel_stop(__TIME, ...) VSF_MCONNECT(VSF_TIMER_CFG_PREFIX, _timer_channel_stop) ((__vsf_timer_t *)(__TIME), ##__VA_ARGS__)
934# define vsf_timer_channel_request_start(__TIME, ...) VSF_MCONNECT(VSF_TIMER_CFG_PREFIX, _timer_channel_request_start)((__vsf_timer_t *)(__TIME), ##__VA_ARGS__)
935# define vsf_timer_channel_request_stop(__TIME, ...) VSF_MCONNECT(VSF_TIMER_CFG_PREFIX, _timer_channel_request_stop) ((__vsf_timer_t *)(__TIME), ##__VA_ARGS__)
936# define vsf_timer_channel_ctrl(__TIME, ...) VSF_MCONNECT(VSF_TIMER_CFG_PREFIX, _timer_channel_ctrl) ((__vsf_timer_t *)(__TIME), ##__VA_ARGS__)
937#endif
939
940#ifdef __cplusplus
941}
942#endif
943
944#endif /*__VSF_TEMPLATE_TIMER_H__*/
vsf_err_t
Definition __type.h:42
vsf_arch_prio_t
Definition cortex_a_generic.h:88
vsf_timer_irq_mask_t
Definition timer.h:134
vsf_timer_channel_mode_t
Definition timer.h:124
void vsf_timer_isr_handler_t(void *target_ptr, vsf_timer_t *timer_ptr, vsf_timer_irq_mask_t irq_mask)
Definition timer.h:162
const i_spi_t vsf_spi_irq_mask_t irq_mask
Definition spi_interface.h:38
unsigned short uint16_t
Definition stdint.h:7
unsigned uint32_t
Definition stdint.h:9
unsigned char uint8_t
Definition stdint.h:5
Definition vsf_template_hal_driver.h:203
Definition vsf_template_hal_driver.h:196
Definition vsf_template_timer.h:598
uint8_t support_output_compare
Definition vsf_template_timer.h:613
uint8_t timer_bitlen
Definition vsf_template_timer.h:606
vsf_timer_irq_mask_t irq_mask
Definition timer.h:234
inherit(vsf_peripheral_capability_t) vsf_timer_irq_mask_t irq_mask
uint8_t support_one_pulse
Definition vsf_template_timer.h:615
uint8_t channel_cnt
Definition vsf_template_timer.h:608
uint8_t support_input_capture
Definition vsf_template_timer.h:614
uint8_t support_pwm
Definition vsf_template_timer.h:612
timer configuration
Definition vsf_template_timer.h:498
uint32_t freq
Definition vsf_template_timer.h:501
uint32_t min_freq
Definition vsf_template_timer.h:502
uint32_t period
Period in Tick.
Definition vsf_template_timer.h:499
vsf_timer_isr_t isr
ISR config.
Definition vsf_template_timer.h:504
Definition vsf_template_timer.h:509
vsf_timer_channel_mode_t mode
Definition vsf_template_timer.h:510
uint32_t pulse
Definition vsf_template_timer.h:511
Definition vsf_template_timer.h:561
uint16_t length
Definition vsf_template_timer.h:562
uint32_t * pulse_buffer
Definition vsf_template_timer.h:567
uint32_t * channel_a_buffer
Definition vsf_template_timer.h:572
uint32_t * input_capture_buffer
Definition vsf_template_timer.h:569
uint32_t * channel_b_buffer
Definition vsf_template_timer.h:573
uint32_t * period_buffer
Definition vsf_template_timer.h:565
Definition vsf_template_timer.h:484
vsf_arch_prio_t prio
Definition vsf_template_timer.h:487
vsf_timer_isr_handler_t * handler_fn
Definition vsf_template_timer.h:485
void * target_ptr
Definition vsf_template_timer.h:486
Definition vsf_template_timer.h:619
TIMER status information structure Contains the current status of TIMER operations.
Definition vsf_template_timer.h:588
uint32_t value
Definition timer.h:222
Definition vsf_template_timer.h:629
const vsf_timer_op_t * op
Definition vsf_template_timer.h:630
fsm_rt_t
Definition vsf_fsm.h:315
struct vsf_timer_capability_t vsf_timer_capability_t
#define VSF_TIMER_APIS(__prefix_name)
Timer API template macros for generating timer function declarations and implementations.
Definition vsf_template_timer.h:216
void vsf_timer_fini(vsf_timer_t *timer_ptr)
Finalize a TIMER instance.
Definition timer_common.c:45
vsf_timer_irq_mask_t
Definition vsf_template_timer.h:448
@ VSF_TIMER_IRQ_MASK_OVERFLOW
Definition vsf_template_timer.h:449
@ VSF_TIMER_CHANNEL_MODE_ALL_MASK
Definition vsf_template_timer.h:442
@ VSF_TIMER_CHANNEL_MODE_MASK
Definition vsf_template_timer.h:414
@ VSF_TIMER_BASE_COUNTER_MASK
Definition vsf_template_timer.h:437
@ VSF_TIMER_IRQ_ALL_BITS_MASK
Definition vsf_template_timer.h:474
@ VSF_TIMER_IRQ_COUNT
Definition vsf_template_timer.h:473
vsf_err_t vsf_timer_set_period(vsf_timer_t *timer_ptr, uint32_t period)
TIMER set period (maximum count), used for change the period of TIMER dynamically.
Definition timer_common.c:109
vsf_err_t vsf_timer_channel_stop(vsf_timer_t *timer_ptr, uint8_t channel)
stop a TIMER channel
Definition timer_common.c:146
vsf_timer_status_t vsf_timer_status(vsf_timer_t *timer_ptr)
Get the status of TIMER instance.
Definition timer_common.c:91
struct vsf_timer_channel_cfg_t vsf_timer_channel_cfg_t
struct vsf_timer_channel_request_t vsf_timer_channel_request_t
vsf_timer_channel_mode_t
Definition vsf_template_timer.h:237
@ VSF_TIMER_CHANNEL_MODE_BASE
Definition vsf_template_timer.h:240
@ VSF_TIMER_BASE_ONESHOT
Definition vsf_template_timer.h:288
@ VSF_TIMER_BASE_CONTINUES
Definition vsf_template_timer.h:290
vsf_err_t vsf_timer_channel_request_stop(vsf_timer_t *timer_ptr, uint8_t channel)
stop a TIMER channel request.
vsf_timer_capability_t vsf_timer_capability(vsf_timer_t *timer_ptr)
get the capability of TIMER instance.
Definition timer_common.c:100
vsf_timer_ctrl_t
Predefined VSF TIMER control command that can be reimplemented in specific hal drivers....
Definition vsf_template_timer.h:533
@ __VSF_TIMER_CTRL_DUMMY
Dummy value for compilation.
Definition vsf_template_timer.h:534
struct vsf_timer_isr_t vsf_timer_isr_t
void vsf_timer_isr_handler_t(void *target_ptr, vsf_timer_t *timer_ptr, vsf_timer_irq_mask_t irq_mask)
Definition vsf_template_timer.h:480
void vsf_timer_irq_enable(vsf_timer_t *timer_ptr, vsf_timer_irq_mask_t irq_mask)
Enable interrupt masks of TIMER instance.
Definition timer_common.c:72
vsf_err_t vsf_timer_channel_ctrl(vsf_timer_t *timer_ptr, uint8_t channel, vsf_timer_channel_ctrl_t ctrl, void *param)
Execute a control command on the TIMER channel.
Definition timer_common.c:155
vsf_err_t vsf_timer_channel_request_start(vsf_timer_t *timer_ptr, uint8_t channel, vsf_timer_channel_request_t *request_ptr)
start a TIMER channel request (usually based on DMA)
vsf_err_t vsf_timer_ctrl(vsf_timer_t *timer_ptr, vsf_timer_ctrl_t ctrl, void *param)
Execute a control command on the TIMER instance.
Definition timer_common.c:118
void vsf_timer_irq_disable(vsf_timer_t *timer_ptr, vsf_timer_irq_mask_t irq_mask)
Disable interrupt masks of TIMER instance.
Definition timer_common.c:81
struct vsf_timer_status_t vsf_timer_status_t
TIMER status information structure Contains the current status of TIMER operations.
vsf_err_t vsf_timer_init(vsf_timer_t *timer_ptr, vsf_timer_cfg_t *cfg_ptr)
Initialize a Timer instance.
Definition timer_common.c:37
struct vsf_timer_cfg_t vsf_timer_cfg_t
timer configuration
fsm_rt_t vsf_timer_enable(vsf_timer_t *timer_ptr)
Enable a TIMER instance.
Definition timer_common.c:54
fsm_rt_t vsf_timer_disable(vsf_timer_t *timer_ptr)
Disable a TIMER instance.
Definition timer_common.c:63
vsf_timer_channel_ctrl_t
Predefined VSF TIMER control command that can be reimplemented in specific hal drivers....
Definition vsf_template_timer.h:555
@ __VSF_TIMER_CHANNEL_CTRL_DUMMY
Dummy value for compilation.
Definition vsf_template_timer.h:556
vsf_err_t vsf_timer_channel_config(vsf_timer_t *timer_ptr, uint8_t channel, vsf_timer_channel_cfg_t *channel_cfg_ptr)
TIMER set the period width and pulse width for a channel.
Definition timer_common.c:127
vsf_err_t vsf_timer_channel_start(vsf_timer_t *timer_ptr, uint8_t channel)
start a TIMER channel
Definition timer_common.c:137
Generated from commit: vsfteam/vsf@2b286be