drv/timer_avr.h

   1 /*!
   2  * \file
   3  * <!--
   4  * Copyright 2003, 2004 Develer S.r.l. (http://www.develer.com/)
   5  * Copyright 2000 Bernardo Innocenti <bernie@develer.com>
   6  * This file is part of DevLib - See devlib/README for information.
   7  * -->
   8  *
   9  * \version $Id$
  10  *
  11  * \author Bernardo Innocenti <bernie@develer.com>
  12  *
  13  * \brief Low-level timer module for AVR
  14  */
  15
  16 /*#*
  17  *#* $Log$
  18  *#* Revision 1.16  2004/09/06 21:49:26  bernie
  19  *#* CONFIG_TIMER_STROBE: be tolerant with missing optional macro.
  20  *#*
  21  *#* Revision 1.15  2004/08/25 14:12:08  rasky
  22  *#* Aggiornato il comment block dei log RCS
  23  *#*
  24  *#* Revision 1.14  2004/08/24 16:27:01  bernie
  25  *#* Add missing headers.
  26  *#*
  27  *#* Revision 1.13  2004/08/24 14:30:11  bernie
  28  *#* Use new-style config macros for drv/timer.c
  29  *#*
  30  *#* Revision 1.12  2004/08/10 06:59:45  bernie
  31  *#* CONFIG_TIMER_STROBE: Define no-op default macros.
  32  *#*
  33  *#* Revision 1.11  2004/08/03 15:53:17  aleph
  34  *#* Fix spacing
  35  *#*
  36  *#* Revision 1.10  2004/08/02 20:20:29  aleph
  37  *#* Merge from project_ks
  38  *#*
  39  *#* Revision 1.9  2004/07/22 02:01:14  bernie
  40  *#* Use TIMER_PRESCALER consistently.
  41  *#*/
  42 #ifndef DRV_TIMER_AVR_H
  43 #define DRV_TIMER_AVR_H
  44
  45 #include <arch_config.h> // ARCH_BOARD_KC
  46 #include <avr/wdt.h>
  47 #include <avr/signal.h>
  48
  49 #if defined(ARCH_BOARD_KC) && (ARCH & ARCH_BOARD_KC)
  50         #include <drv/adc.h>
  51 #endif
  52
  53
  54 /*!
  55  * Values for CONFIG_TIMER.
  56  *
  57  * Select which hardware timer interrupt to use for system clock and softtimers.
  58  * \note The timer 1 overflow mode set the timer as a 24 kHz PWM.
  59  */
  60 #define TIMER_ON_OUTPUT_COMPARE0  1
  61 #define TIMER_ON_OVERFLOW1        2
  62 #define TIMER_ON_OUTPUT_COMPARE2  3
  63
  64
  65 /*!
  66  * \def CONFIG_TIMER_STROBE
  67  *
  68  * This is a debug facility that can be used to
  69  * monitor timer interrupt activity on an external pin.
  70  *
  71  * To use strobes, redefine the macros TIMER_STROBE_ON,
  72  * TIMER_STROBE_OFF and TIMER_STROBE_INIT and set
  73  * CONFIG_TIMER_STROBE to 1.
  74  */
  75 #if !defined(CONFIG_TIMER_STROBE) || !CONFIG_TIMER_STROBE
  76         #define TIMER_STROBE_ON    do {/*nop*/} while(0)
  77         #define TIMER_STROBE_OFF   do {/*nop*/} while(0)
  78         #define TIMER_STROBE_INIT  do {/*nop*/} while(0)
  79 #endif
  80
  81
  82 /* Not needed, IRQ timer flag cleared automatically */
  83 #define timer_hw_irq() do {} while (0)
  84
  85 #define TIMER_PRESCALER 64
  86
  87 /*!
  88  * System timer: additional division after the prescaler
  89  * 12288000 / 64 / 192 (0..191) = 1 ms
  90  */
  91 #define OCR_DIVISOR  (CLOCK_FREQ / TIMER_PRESCALER / TICKS_PER_SEC - 1) /* 191 */
  92
  93 /*! HW dependent timer initialization  */
  94 #if (CONFIG_TIMER == TIMER_ON_OUTPUT_COMPARE0)
  95
  96         //! Type of time expressed in ticks of the hardware high-precision timer
  97         typedef uint8_t hptime_t;
  98
  99         static void timer_hw_init(void)
 100         {
 101                 cpuflags_t flags;
 102                 DISABLE_IRQSAVE(flags);
 103
 104                 /* Reset Timer flags */
 105                 TIFR = BV(OCF0) | BV(TOV0);
 106
 107                 /* Setup Timer/Counter interrupt */
 108                 ASSR = 0x00;                  /* Internal system clock */
 109                 TCCR0 = BV(WGM01)             /* Clear on Compare match */
 110                         #if TIMER_PRESCALER == 64
 111                                 | BV(CS02)
 112                         #else
 113                                 #error Unsupported value of TIMER_PRESCALER
 114                         #endif
 115                 ;
 116                 TCNT0 = 0x00;                 /* Initialization of Timer/Counter */
 117                 OCR0 = OCR_DIVISOR;           /* Timer/Counter Output Compare Register */
 118
 119                 /* Enable timer interrupts: Timer/Counter2 Output Compare (OCIE2) */
 120                 TIMSK &= ~BV(TOIE0);
 121                 TIMSK |= BV(OCIE0);
 122
 123                 ENABLE_IRQRESTORE(flags);
 124         }
 125
 126         //! Frequency of the hardware high precision timer
 127         #define TIMER_HW_HPTICKS_PER_SEC  (CLOCK_FREQ / TIMER_PRESCALER)
 128
 129         INLINE hptime_t timer_hw_hpread(void)
 130         {
 131                 return TCNT0;
 132         }
 133
 134 #elif (CONFIG_TIMER == TIMER_ON_OVERFLOW1)
 135
 136         //! Type of time expressed in ticks of the hardware high precision timer
 137         typedef uint16_t hptime_t;
 138
 139         static void timer_hw_init(void)
 140         {
 141                 cpuflags_t flags;
 142                 DISABLE_IRQSAVE(flags);
 143
 144                 /* Reset Timer overflow flag */
 145                 TIFR |= BV(TOV1);
 146
 147                 /* Fast PWM mode, 9 bit, 24 kHz, no prescaling. When changing freq or
 148                    resolution (top of TCNT), change TIMER_HW_HPTICKS_PER_SEC too */
 149                 TCCR1A |= BV(WGM11);
 150                 TCCR1A &= ~BV(WGM10);
 151                 TCCR1B |= BV(WGM12) | BV(CS10);
 152                 TCCR1B &= ~(BV(WGM13) | BV(CS11) | BV(CS12));
 153
 154                 TCNT1 = 0x00;         /* initialization of Timer/Counter */
 155
 156                 /* Enable timer interrupt: Timer/Counter1 Overflow */
 157                 TIMSK |= BV(TOIE1);
 158
 159                 ENABLE_IRQRESTORE(flags);
 160         }
 161
 162         //! Frequency of the hardware high precision timer
 163         #define TIMER_HW_HPTICKS_PER_SEC  (24000ul * 512)
 164
 165         INLINE hptime_t timer_hw_hpread(void)
 166         {
 167                 return TCNT1;
 168         }
 169
 170 #elif (CONFIG_TIMER == TIMER_ON_OUTPUT_COMPARE2)
 171
 172         //! Type of time expressed in ticks of the hardware high precision timer
 173         typedef uint8_t hptime_t;
 174
 175         static void timer_hw_init(void)
 176         {
 177                 cpuflags_t flags;
 178                 DISABLE_IRQSAVE(flags);
 179
 180                 /* Reset Timer flags */
 181                 TIFR = BV(OCF2) | BV(TOV2);
 182
 183                 /* Setup Timer/Counter interrupt */
 184                 TCCR2 = BV(WGM21)
 185                         #if TIMER_PRESCALER == 64
 186                                 | BV(CS21) | BV(CS20)
 187                         #else
 188                                 #error Unsupported value of TIMER_PRESCALER
 189                         #endif
 190                 ;
 191                 /* Clear on Compare match & prescaler = 64, internal sys clock.
 192                    When changing prescaler change TIMER_HW_HPTICKS_PER_SEC too */
 193                 TCNT2 = 0x00;         /* initialization of Timer/Counter */
 194                 OCR2 = OCR_DIVISOR;   /* Timer/Counter Output Compare Register */
 195
 196                 /* Enable timer interrupts: Timer/Counter2 Output Compare (OCIE2) */
 197                 TIMSK &= ~BV(TOIE2);
 198                 TIMSK |= BV(OCIE2);
 199
 200                 ENABLE_IRQRESTORE(flags);
 201         }
 202
 203         //! Frequency of the hardware high precision timer
 204         #define TIMER_HW_HPTICKS_PER_SEC  (CLOCK_FREQ / TIMER_PRESCALER)
 205
 206         INLINE hptime_t timer_hw_hpread(void)
 207         {
 208                 return TCNT2;
 209         }
 210
 211 #else
 212         #error Unimplemented value for CONFIG_TIMER
 213 #endif /* CONFIG_TIMER */
 214
 215
 216 #if (CONFIG_TIMER == TIMER_ON_OVERFLOW1)
 217
 218         #define DEFINE_TIMER_ISR        \
 219                 static void timer_handler(void)
 220
 221         DEFINE_TIMER_ISR;
 222
 223         /*
 224          * Timer 1 overflow irq handler. It's called at the frequency of the timer 1
 225          * PWM (should be 24 kHz). It's too much for timer purposes, so the interrupt
 226          * handler is really a counter that call the true handler in timer.c
 227          * every 1 ms.
 228          */
 229         SIGNAL(SIG_OVERFLOW1)
 230         {
 231                 /*!
 232                  * How many overflow we have to count before calling the true timer handler.
 233                  * If timer overflow is at 24 kHz, with a value of 24 we have 1 ms between
 234                  * each call.
 235                  */
 236                 #define TIMER1_OVF_COUNT 24
 237
 238                 static uint8_t count = TIMER1_OVF_COUNT;
 239
 240                 count--;
 241                 if (!count)
 242                 {
 243                         timer_handler();
 244                         count = TIMER1_OVF_COUNT;
 245                 }
 246
 247         #if (ARCH & ARCH_BOARD_KC)
 248                 /*
 249                  * Super-optimization-hack: switch CPU ADC mux here, ASAP after the start
 250                  * of conversion (auto-triggered with timer 1 overflow).
 251                  * The switch can be done 2 ADC cycles after start of conversion.
 252                  * The handler prologue takes a little more than 32 CPU cycles: with
 253                  * the prescaler at 1/16 the timing should be correct even at the start
 254                  * of the handler.
 255                  *
 256                  * The switch is synchronized with the ADC handler using _adc_trigger_lock.
 257                  */
 258                 extern uint8_t _adc_idx_next;
 259                 extern bool _adc_trigger_lock;
 260
 261                 if (!_adc_trigger_lock)
 262                 {
 263                         TIMER_STROBE_ON;
 264                         ADC_SETCHN(_adc_idx_next);
 265                         TIMER_STROBE_OFF;
 266                         _adc_trigger_lock = true;
 267                 }
 268         #endif
 269         }
 270
 271 #elif (CONFIG_TIMER == TIMER_ON_OUTPUT_COMPARE0)
 272
 273         #define DEFINE_TIMER_ISR        \
 274                 SIGNAL(SIG_OUTPUT_COMPARE0)
 275
 276 #elif (CONFIG_TIMER == TIMER_ON_OUTPUT_COMPARE2)
 277
 278         #define DEFINE_TIMER_ISR        \
 279                 SIGNAL(SIG_OUTPUT_COMPARE2)
 280
 281 #else
 282         #error Unimplemented value for CONFIG_TIMER
 283 #endif /* CONFIG_TIMER */
 284
 285 #endif /* DRV_TIMER_AVR_H */