4 * Copyright 2003, 2004, 2005 Develer S.r.l. (http://www.develer.com/)
5 * Copyright 2000 Bernardo Innocenti <bernie@develer.com>
6 * This file is part of DevLib - See README.devlib for information.
11 * \author Bernardo Innocenti <bernie@develer.com>
12 * \author Francesco Sacchi <batt@develer.com>
14 * \brief Low-level timer module for AVR (interface).
19 *#* Revision 1.28 2006/07/19 12:56:26 bernie
20 *#* Convert to new Doxygen style.
22 *#* Revision 1.27 2006/05/18 00:38:24 bernie
23 *#* Use hw_cpu.h instead of ubiquitous hw.h.
25 *#* Revision 1.26 2006/02/21 21:28:02 bernie
26 *#* New time handling based on TIMER_TICKS_PER_SEC to support slow timers with ticks longer than 1ms.
28 *#* Revision 1.25 2005/07/19 07:26:37 bernie
29 *#* Refactor to decouple timer ticks from milliseconds.
31 *#* Revision 1.24 2005/04/11 19:10:28 bernie
32 *#* Include top-level headers from cfg/ subdir.
34 *#* Revision 1.23 2005/03/01 23:24:51 bernie
35 *#* Tweaks for avr-libc 1.2.x.
37 *#* Revision 1.21 2004/12/13 12:07:06 bernie
38 *#* DISABLE_IRQSAVE/ENABLE_IRQRESTORE: Convert to IRQ_SAVE_DISABLE/IRQ_RESTORE.
40 *#* Revision 1.20 2004/11/16 20:59:46 bernie
41 *#* Include <avr/io.h> explicitly.
43 *#* Revision 1.19 2004/10/19 08:56:41 bernie
44 *#* TIMER_STROBE_ON, TIMER_STROBE_OFF, TIMER_STROBE_INIT: Move from timer_avr.h to timer.h, where they really belong.
46 *#* Revision 1.18 2004/09/20 03:31:03 bernie
47 *#* Fix racy racy code.
49 #ifndef DRV_TIMER_AVR_H
50 #define DRV_TIMER_AVR_H
52 #include <appconfig.h> /* CONFIG_TIMER */
53 #include <cfg/compiler.h> /* uint8_t */
54 #include <hw_cpu.h> /* CLOCK_FREQ */
57 * \name Values for CONFIG_TIMER.
59 * Select which hardware timer interrupt to use for system clock and softtimers.
60 * \note The timer 1 overflow mode set the timer as a 24 kHz PWM.
64 #define TIMER_ON_OUTPUT_COMPARE0 1
65 #define TIMER_ON_OVERFLOW1 2
66 #define TIMER_ON_OUTPUT_COMPARE2 3
67 #define TIMER_ON_OVERFLOW3 4
71 * Hardware dependent timer initialization.
73 #if (CONFIG_TIMER == TIMER_ON_OUTPUT_COMPARE0)
75 #define TIMER_PRESCALER 64
76 #define TIMER_HW_BITS 8
77 #define DEFINE_TIMER_ISR SIGNAL(SIG_OUTPUT_COMPARE0)
78 #define TIMER_TICKS_PER_SEC 1000
79 #define TIMER_HW_CNT OCR_DIVISOR
81 /// Type of time expressed in ticks of the hardware high-precision timer
82 typedef uint8_t hptime_t;
84 #elif (CONFIG_TIMER == TIMER_ON_OVERFLOW1)
86 #define TIMER_PRESCALER 1
87 #define TIMER_HW_BITS 8
88 /** This value is the maximum in overflow based timers. */
89 #define TIMER_HW_CNT (1 << TIMER_HW_BITS)
90 #define DEFINE_TIMER_ISR SIGNAL(SIG_OVERFLOW1)
91 #define TIMER_TICKS_PER_SEC ((TIMER_HW_HPTICKS_PER_SEC + TIMER_HW_CNT / 2) / TIMER_HW_CNT)
93 /// Type of time expressed in ticks of the hardware high precision timer
94 typedef uint16_t hptime_t;
96 #elif (CONFIG_TIMER == TIMER_ON_OUTPUT_COMPARE2)
98 #define TIMER_PRESCALER 64
99 #define TIMER_HW_BITS 8
100 #define DEFINE_TIMER_ISR SIGNAL(SIG_OUTPUT_COMPARE2)
101 #define TIMER_TICKS_PER_SEC 1000
102 /** Value for OCR register in output-compare based timers. */
103 #define TIMER_HW_CNT OCR_DIVISOR
106 /// Type of time expressed in ticks of the hardware high precision timer
107 typedef uint8_t hptime_t;
109 #elif (CONFIG_TIMER == TIMER_ON_OVERFLOW3)
111 #define TIMER_PRESCALER 1
112 #define TIMER_HW_BITS 8
113 /** This value is the maximum in overflow based timers. */
114 #define TIMER_HW_CNT (1 << TIMER_HW_BITS)
115 #define DEFINE_TIMER_ISR SIGNAL(SIG_OVERFLOW3)
116 #define TIMER_TICKS_PER_SEC ((TIMER_HW_HPTICKS_PER_SEC + TIMER_HW_CNT / 2) / TIMER_HW_CNT)
118 /// Type of time expressed in ticks of the hardware high precision timer
119 typedef uint16_t hptime_t;
122 #error Unimplemented value for CONFIG_TIMER
123 #endif /* CONFIG_TIMER */
126 /** Frequency of the hardware high precision timer. */
127 #define TIMER_HW_HPTICKS_PER_SEC ((CLOCK_FREQ + TIMER_PRESCALER / 2) / TIMER_PRESCALER)
130 * System timer: additional division after the prescaler
131 * 12288000 / 64 / 192 (0..191) = 1 ms
133 #define OCR_DIVISOR (((CLOCK_FREQ + TIMER_PRESCALER / 2) / TIMER_PRESCALER + TIMER_TICKS_PER_SEC / 2) / TIMER_TICKS_PER_SEC - 1)
135 /** Not needed, IRQ timer flag cleared automatically */
136 #define timer_hw_irq() do {} while (0)
139 #endif /* DRV_TIMER_AVR_H */