git.sur5r.net Git - freertos/blob - FreeRTOS/Source/portable/IAR/AVR32_UC3/read.c

   1 /*This file is prepared for Doxygen automatic documentation generation.*/\r
   2 /*! \file *********************************************************************\r
   3  *\r
   4  * \brief System-specific implementation of the \ref __read function used by\r
   5           the standard library.\r
   6  *\r
   7  * - Compiler:           IAR EWAVR32\r
   8  * - Supported devices:  All AVR32 devices with a USART module can be used.\r
   9  * - AppNote:\r
  10  *\r
  11  * \author               Atmel Corporation: http://www.atmel.com \n\r
  12  *                       Support and FAQ: http://support.atmel.no/\r
  13  *\r
  14  ******************************************************************************/\r
  15 \r
  16 /* Copyright (c) 2007, Atmel Corporation All rights reserved.\r
  17  *\r
  18  * Redistribution and use in source and binary forms, with or without\r
  19  * modification, are permitted provided that the following conditions are met:\r
  20  *\r
  21  * 1. Redistributions of source code must retain the above copyright notice,\r
  22  * this list of conditions and the following disclaimer.\r
  23  *\r
  24  * 2. Redistributions in binary form must reproduce the above copyright notice,\r
  25  * this list of conditions and the following disclaimer in the documentation\r
  26  * and/or other materials provided with the distribution.\r
  27  *\r
  28  * 3. The name of ATMEL may not be used to endorse or promote products derived\r
  29  * from this software without specific prior written permission.\r
  30  *\r
  31  * THIS SOFTWARE IS PROVIDED BY ATMEL ``AS IS'' AND ANY EXPRESS OR IMPLIED\r
  32  * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF\r
  33  * MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE EXPRESSLY AND\r
  34  * SPECIFICALLY DISCLAIMED. IN NO EVENT SHALL ATMEL BE LIABLE FOR ANY DIRECT,\r
  35  * INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES\r
  36  * (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;\r
  37  * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND\r
  38  * ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT\r
  39  * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF\r
  40  * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.\r
  41  */\r
  42 \r
  43 \r
  44 #include <yfuns.h>\r
  45 #include <avr32/io.h>\r
  46 #include "usart.h"\r
  47 \r
  48 \r
  49 _STD_BEGIN\r
  50 \r
  51 \r
  52 #pragma module_name = "?__read"\r
  53 \r
  54 \r
  55 extern volatile avr32_usart_t *volatile stdio_usart_base;\r
  56 \r
  57 \r
  58 /*! \brief Reads a number of bytes, at most \a size, into the memory area\r
  59  *         pointed to by \a buffer.\r
  60  *\r
  61  * \param handle File handle to read from.\r
  62  * \param buffer Pointer to buffer to write read bytes to.\r
  63  * \param size Number of bytes to read.\r
  64  *\r
  65  * \return The number of bytes read, \c 0 at the end of the file, or\r
  66  *         \c _LLIO_ERROR on failure.\r
  67  */\r
  68 size_t __read(int handle, uint8_t *buffer, size_t size)\r
  69 {\r
  70   int nChars = 0;\r
  71 \r
  72   // This implementation only reads from stdin.\r
  73   // For all other file handles, it returns failure.\r
  74   if (handle != _LLIO_STDIN)\r
  75   {\r
  76     return _LLIO_ERROR;\r
  77   }\r
  78 \r
  79   for (; size > 0; --size)\r
  80   {\r
  81     int c = usart_getchar(stdio_usart_base);\r
  82     if (c < 0)\r
  83       break;\r
  84 \r
  85     *buffer++ = c;\r
  86     ++nChars;\r
  87   }\r
  88 \r
  89   return nChars;\r
  90 }\r
  91 \r
  92 \r
  93 _STD_END\r