git.sur5r.net Git - freertos/blob - FreeRTOS/Demo/CORTEX_AT91SAM3U256_IAR/AT91Lib/peripherals/rtt/rtt.c

   1 /* ----------------------------------------------------------------------------\r
   2  *         ATMEL Microcontroller Software Support \r
   3  * ----------------------------------------------------------------------------\r
   4  * Copyright (c) 2008, Atmel Corporation\r
   5  *\r
   6  * All rights reserved.\r
   7  *\r
   8  * Redistribution and use in source and binary forms, with or without\r
   9  * modification, are permitted provided that the following conditions are met:\r
  10  *\r
  11  * - Redistributions of source code must retain the above copyright notice,\r
  12  * this list of conditions and the disclaimer below.\r
  13  *\r
  14  * Atmel's name may not be used to endorse or promote products derived from\r
  15  * this software without specific prior written permission.\r
  16  *\r
  17  * DISCLAIMER: THIS SOFTWARE IS PROVIDED BY ATMEL "AS IS" AND ANY EXPRESS OR\r
  18  * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF\r
  19  * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT ARE\r
  20  * DISCLAIMED. IN NO EVENT SHALL ATMEL BE LIABLE FOR ANY DIRECT, INDIRECT,\r
  21  * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT\r
  22  * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA,\r
  23  * OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF\r
  24  * LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING\r
  25  * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE,\r
  26  * EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.\r
  27  * ----------------------------------------------------------------------------\r
  28  */\r
  29 \r
  30 //------------------------------------------------------------------------------\r
  31 //         Headers\r
  32 //------------------------------------------------------------------------------\r
  33 \r
  34 #include "rtt.h"\r
  35 #include <utility/assert.h>\r
  36 \r
  37 //------------------------------------------------------------------------------\r
  38 //         Exported functions\r
  39 //------------------------------------------------------------------------------\r
  40 \r
  41 //------------------------------------------------------------------------------\r
  42 /// Changes the prescaler value of the given RTT and restarts it. This function\r
  43 /// disables RTT interrupt sources.\r
  44 /// \param rtt  Pointer to a AT91S_RTTC instance.\r
  45 /// \param prescaler  Prescaler value for the RTT.\r
  46 //------------------------------------------------------------------------------\r
  47 void RTT_SetPrescaler(AT91S_RTTC *rtt, unsigned short prescaler)\r
  48 {\r
  49     rtt->RTTC_RTMR = (prescaler | AT91C_RTTC_RTTRST);\r
  50 }\r
  51 \r
  52 //------------------------------------------------------------------------------\r
  53 /// Returns the current value of the RTT timer value.\r
  54 /// \param rtt  Pointer to a AT91S_RTTC instance.\r
  55 //------------------------------------------------------------------------------\r
  56 unsigned int RTT_GetTime(AT91S_RTTC *rtt)\r
  57 {\r
  58     return rtt->RTTC_RTVR;\r
  59 }\r
  60 \r
  61 //------------------------------------------------------------------------------\r
  62 /// Enables the specified RTT interrupt sources.\r
  63 /// \param rtt  Pointer to a AT91S_RTTC instance.\r
  64 /// \param sources  Bitmask of interrupts to enable.\r
  65 //------------------------------------------------------------------------------\r
  66 void RTT_EnableIT(AT91S_RTTC *rtt, unsigned int sources)\r
  67 {\r
  68     ASSERT((sources & 0x0004FFFF) == 0,\r
  69            "RTT_EnableIT: Wrong sources value.\n\r");\r
  70     rtt->RTTC_RTMR |= sources;\r
  71 }\r
  72 \r
  73 //------------------------------------------------------------------------------\r
  74 /// Returns the status register value of the given RTT.\r
  75 /// \param rtt  Pointer to an AT91S_RTTC instance.\r
  76 //------------------------------------------------------------------------------\r
  77 unsigned int RTT_GetStatus(AT91S_RTTC *rtt)\r
  78 {\r
  79     return rtt->RTTC_RTSR;\r
  80 }\r
  81 \r
  82 //------------------------------------------------------------------------------\r
  83 /// Configures the RTT to generate an alarm at the given time.\r
  84 /// \param pRtt  Pointer to an AT91S_RTTC instance.\r
  85 /// \param time  Alarm time.\r
  86 //------------------------------------------------------------------------------\r
  87 void RTT_SetAlarm(AT91S_RTTC *pRtt, unsigned int time)\r
  88 {\r
  89     SANITY_CHECK(time > 0);\r
  90 \r
  91     pRtt->RTTC_RTAR = time - 1;\r
  92 }\r
  93 \r