X-Git-Url: http://git.linex4red.de/pub/USBasp.git/blobdiff_plain/071e02c6b6b4837fa9cf0b6d4c749994e02638d7..5517f96e86b9447780a3e27bb455697f9fc65eea:/LUFA/Drivers/Peripheral/SerialStream.h diff --git a/LUFA/Drivers/Peripheral/SerialStream.h b/LUFA/Drivers/Peripheral/SerialStream.h index 83c3036d3..c0f15658d 100644 --- a/LUFA/Drivers/Peripheral/SerialStream.h +++ b/LUFA/Drivers/Peripheral/SerialStream.h @@ -1,7 +1,7 @@ /* LUFA Library Copyright (C) Dean Camera, 2010. - + dean [at] fourwalledcubicle [dot] com www.fourwalledcubicle.com */ @@ -9,13 +9,13 @@ /* Copyright 2010 Dean Camera (dean [at] fourwalledcubicle [dot] com) - Permission to use, copy, modify, distribute, and sell this + Permission to use, copy, modify, distribute, and sell this software and its documentation for any purpose is hereby granted - without fee, provided that the above copyright notice appear in + without fee, provided that the above copyright notice appear in all copies and that both that the copyright notice and this - permission notice and warranty disclaimer appear in supporting - documentation, and that the name of the author not be used in - advertising or publicity pertaining to distribution of the + permission notice and warranty disclaimer appear in supporting + documentation, and that the name of the author not be used in + advertising or publicity pertaining to distribution of the software without specific, written prior permission. The author disclaim all warranties with regard to this @@ -42,7 +42,7 @@ * * \section Sec_Dependencies Module Source Dependencies * The following files must be built with any user project that uses this module: - * - LUFA/Drivers/Peripheral/SerialStream.c + * - LUFA/Drivers/Peripheral/SerialStream.c (Makefile source module name: LUFA_SRC_SERIALSTREAM) * * \section Module Description * Serial stream driver for the USART subsystem on supported USB AVRs. This makes use of the functions in the @@ -59,49 +59,51 @@ /* Includes: */ #include #include - + #include "Serial.h" - + /* Enable C linkage for C++ Compilers: */ #if defined(__cplusplus) extern "C" { #endif - /* Private Interface - For use in library only: */ + /* Private Interface - For use in library only: */ #if !defined(__DOXYGEN__) /* External Variables: */ extern FILE USARTStream; /* Function Prototypes: */ #if defined(__INCLUDE_FROM_SERIALSTREAM_C) - static int SerialStream_TxByte(char DataByte, FILE *Stream) ATTR_NON_NULL_PTR_ARG(2); + static int SerialStream_TxByte(char DataByte, + FILE *Stream) ATTR_NON_NULL_PTR_ARG(2); static int SerialStream_RxByte(FILE *Stream) ATTR_NON_NULL_PTR_ARG(1); #endif #endif /* Public Interface - May be used in end-application: */ /* Inline Functions: */ - /** Initializes the serial stream (and regular USART driver) so that both the stream and regular + /** Initialises the serial stream (and regular USART driver) so that both the stream and regular * USART driver functions can be used. Must be called before any stream or regular USART functions. * - * \param[in] BaudRate Baud rate to configure the USART to - * \param[in] DoubleSpeed Enables double speed mode when set, halving the sample time to double the baud rate + * \param[in] BaudRate Baud rate to configure the USART to. + * \param[in] DoubleSpeed Enables double speed mode when set, halving the sample time to double the baud rate. */ - static inline void SerialStream_Init(const uint32_t BaudRate, const bool DoubleSpeed) + static inline void SerialStream_Init(const uint32_t BaudRate, + const bool DoubleSpeed) { Serial_Init(BaudRate, DoubleSpeed); - + stdout = &USARTStream; stdin = &USARTStream; } - + /** Turns off the serial stream (and regular USART driver), disabling and returning used hardware to * their default configuration. */ static inline void SerialStream_ShutDown(void) { Serial_ShutDown(); - } + } /* Disable C linkage for C++ Compilers: */ #if defined(__cplusplus) @@ -111,3 +113,4 @@ #endif /** @} */ +