From d4c616e6eeb0587ca450c75b1086efa77ac690e5 Mon Sep 17 00:00:00 2001 From: gdisirio Date: Sun, 29 Nov 2009 08:50:13 +0000 Subject: git-svn-id: svn://svn.code.sf.net/p/chibios/svn/trunk@1351 35acf78f-673a-0410-8e92-d51de3d6d3f4 --- os/hal/platforms/AVR/platform.dox | 34 +++++ os/hal/platforms/AVR/serial_lld.c | 256 ++++++++++++++++++++++++++++++++++++++ os/hal/platforms/AVR/serial_lld.h | 161 ++++++++++++++++++++++++ 3 files changed, 451 insertions(+) create mode 100644 os/hal/platforms/AVR/platform.dox create mode 100644 os/hal/platforms/AVR/serial_lld.c create mode 100644 os/hal/platforms/AVR/serial_lld.h (limited to 'os/hal/platforms/AVR') diff --git a/os/hal/platforms/AVR/platform.dox b/os/hal/platforms/AVR/platform.dox new file mode 100644 index 000000000..05eb4d76e --- /dev/null +++ b/os/hal/platforms/AVR/platform.dox @@ -0,0 +1,34 @@ +/* + ChibiOS/RT - Copyright (C) 2006-2007 Giovanni Di Sirio. + + This file is part of ChibiOS/RT. + + ChibiOS/RT is free software; you can redistribute it and/or modify + it under the terms of the GNU General Public License as published by + the Free Software Foundation; either version 3 of the License, or + (at your option) any later version. + + ChibiOS/RT is distributed in the hope that it will be useful, + but WITHOUT ANY WARRANTY; without even the implied warranty of + MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + GNU General Public License for more details. + + You should have received a copy of the GNU General Public License + along with this program. If not, see . +*/ + +/** + * @defgroup AVR_DRIVERS AVR Drivers + * @brief Device drivers included in the AVR support. + * + * @ingroup AVR + */ + +/** + * @defgroup AVR_SERIAL AVR USART Support + * @brief USART support. + * @details The serial driver supports both the AVR USARTs in asynchronous + * mode. + * + * @ingroup AVR_DRIVERS + */ diff --git a/os/hal/platforms/AVR/serial_lld.c b/os/hal/platforms/AVR/serial_lld.c new file mode 100644 index 000000000..0acf15700 --- /dev/null +++ b/os/hal/platforms/AVR/serial_lld.c @@ -0,0 +1,256 @@ +/* + ChibiOS/RT - Copyright (C) 2006-2007 Giovanni Di Sirio. + + This file is part of ChibiOS/RT. + + ChibiOS/RT is free software; you can redistribute it and/or modify + it under the terms of the GNU General Public License as published by + the Free Software Foundation; either version 3 of the License, or + (at your option) any later version. + + ChibiOS/RT is distributed in the hope that it will be useful, + but WITHOUT ANY WARRANTY; without even the implied warranty of + MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + GNU General Public License for more details. + + You should have received a copy of the GNU General Public License + along with this program. If not, see . +*/ + +/** + * @file AVR/serial_lld.c + * @brief AVR low level serial driver code + * @addtogroup AVR_SERIAL + * @{ + */ + +#include +#include + +#if USE_AVR_USART0 || defined(__DOXYGEN__) +/** + * @brief USART0 serial driver identifier. + * @note The name does not follow the convention used in the other ports + * (COMn) because a name conflict with the AVR headers. + */ +SerialDriver SD1; +#endif +#if USE_AVR_USART1 || defined(__DOXYGEN__) +/** + * @brief USART1 serial driver identifier. + * @note The name does not follow the convention used in the other ports + * (COMn) because a name conflict with the AVR headers. + */ +SerialDriver SD2; +#endif + +/** @brief Driver default configuration.*/ +static const SerialDriverConfig default_config = { + UBRR(DEFAULT_USART_BITRATE), + (1 << UCSZ1) | (1 << UCSZ0) +}; + +/*===========================================================================*/ +/* Low Level Driver local functions. */ +/*===========================================================================*/ + +static void set_error(uint8_t sra, SerialDriver *sdp) { + sdflags_t sts = 0; + + if (sra & (1 << DOR)) + sts |= SD_OVERRUN_ERROR; + if (sra & (1 << UPE)) + sts |= SD_PARITY_ERROR; + if (sra & (1 << FE)) + sts |= SD_FRAMING_ERROR; + chSysLockFromIsr(); + sdAddFlagsI(sdp, sts); + chSysUnlockFromIsr(); +} + +#if USE_AVR_USART0 || defined(__DOXYGEN__) +static void notify1(void) { + + UCSR0B |= (1 << UDRIE); +} + +/** + * @brief USART0 initialization. + * @param[in] config the architecture-dependent serial driver configuration + */ +static void usart0_init(const SerialDriverConfig *config) { + + UBRR0L = config->brr; + UBRR0H = config->brr >> 8; + UCSR0A = 0; + UCSR0B = (1 << RXEN) | (1 << TXEN) | (1 << RXCIE); + UCSR0C = config->csrc; +} + +/** + * @brief USART0 de-initialization. + */ +static void usart0_deinit(void) { + + UCSR0A = 0; + UCSR0B = 0; + UCSR0C = 0; +} +#endif + +#if USE_AVR_USART1 || defined(__DOXYGEN__) +static void notify2(void) { + + UCSR1B |= (1 << UDRIE); +} + +/** + * @brief USART1 initialization. + * @param[in] config the architecture-dependent serial driver configuration + */ +static void usart1_init(const SerialDriverConfig *config) { + + UBRR1L = config->brr; + UBRR1H = config->brr >> 8; + UCSR1A = 0; + UCSR1B = (1 << RXEN) | (1 << TXEN) | (1 << RXCIE); + UCSR1C = config->csrc; +} + +/** + * @brief USART1 de-initialization. + */ +static void usart1_deinit(void) { + + UCSR1A = 0; + UCSR1B = 0; + UCSR1C = 0; +} +#endif + +/*===========================================================================*/ +/* Low Level Driver interrupt handlers. */ +/*===========================================================================*/ + +#if USE_AVR_USART0 || defined(__DOXYGEN__) +CH_IRQ_HANDLER(USART0_RX_vect) { + uint8_t sra; + + CH_IRQ_PROLOGUE(); + + sra = UCSR0A; + if (sra & ((1 << DOR) | (1 << UPE) | (1 << FE))) + set_error(sra, &SD1); + chSysLockFromIsr(); + sdIncomingDataI(&SD1, UDR0); + chSysUnlockFromIsr(); + + CH_IRQ_EPILOGUE(); +} + +CH_IRQ_HANDLER(USART0_UDRE_vect) { + msg_t b; + + CH_IRQ_PROLOGUE(); + + chSysLockFromIsr(); + b = sdRequestDataI(&SER1); + chSysUnlockFromIsr(); + if (b < Q_OK) + UCSR0B &= ~(1 << UDRIE); + else + UDR0 = b; + + CH_IRQ_EPILOGUE(); +} +#endif /* USE_AVR_USART0 */ + +#if USE_AVR_USART1 || defined(__DOXYGEN__) +CH_IRQ_HANDLER(USART1_RX_vect) { + uint8_t sra; + + CH_IRQ_PROLOGUE(); + + sra = UCSR1A; + if (sra & ((1 << DOR) | (1 << UPE) | (1 << FE))) + set_error(sra, &SD2); + chSysLockFromIsr(); + sdIncomingDataI(&SD2, UDR1); + chSysUnlockFromIsr(); + + CH_IRQ_EPILOGUE(); +} + +CH_IRQ_HANDLER(USART1_UDRE_vect) { + msg_t b; + + CH_IRQ_PROLOGUE(); + + chSysLockFromIsr(); + b = sdRequestDataI(&SD2); + chSysUnlockFromIsr(); + if (b < Q_OK) + UCSR1B &= ~(1 << UDRIE); + else + UDR1 = b; + + CH_IRQ_EPILOGUE(); +} +#endif /* USE_AVR_USART1 */ + +/*===========================================================================*/ +/* Low Level Driver exported functions. */ +/*===========================================================================*/ + +/** + * Low level serial driver initialization. + */ +void sd_lld_init(void) { + +#if USE_AVR_USART0 + sdObjectInit(&SD1, NULL, notify1); +#endif +#if USE_AVR_USART1 + sdObjectInit(&SD2, NULL, notify2); +#endif +} + +/** + * @brief Low level serial driver configuration and (re)start. + * + * @param[in] sdp pointer to a @p SerialDriver object + * @param[in] config the architecture-dependent serial driver configuration. + * If this parameter is set to @p NULL then a default + * configuration is used. + */ +void sd_lld_start(SerialDriver *sdp, const SerialDriverConfig *config) { + + if (config == NULL) + config = &default_config; + +#if USE_AVR_USART0 + usart0_init(config); +#endif +#if USE_AVR_USART1 + usart1_init(config); +#endif +} + +/** + * @brief Low level serial driver stop. + * @details De-initializes the USART, stops the associated clock, resets the + * interrupt vector. + * + * @param[in] sdp pointer to a @p SerialDriver object + */ +void sd_lld_stop(SerialDriver *sdp) { + +#if USE_AVR_USART0 + usart0_deinit(); +#endif +#if USE_AVR_USART1 + usart1_deinit(); +#endif +} + +/** @} */ diff --git a/os/hal/platforms/AVR/serial_lld.h b/os/hal/platforms/AVR/serial_lld.h new file mode 100644 index 000000000..c1889f8b5 --- /dev/null +++ b/os/hal/platforms/AVR/serial_lld.h @@ -0,0 +1,161 @@ +/* + ChibiOS/RT - Copyright (C) 2006-2007 Giovanni Di Sirio. + + This file is part of ChibiOS/RT. + + ChibiOS/RT is free software; you can redistribute it and/or modify + it under the terms of the GNU General Public License as published by + the Free Software Foundation; either version 3 of the License, or + (at your option) any later version. + + ChibiOS/RT is distributed in the hope that it will be useful, + but WITHOUT ANY WARRANTY; without even the implied warranty of + MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + GNU General Public License for more details. + + You should have received a copy of the GNU General Public License + along with this program. If not, see . +*/ + +/** + * @file AVR/serial_lld.h + * @brief AVR low level serial driver header + * @addtogroup AVR_SERIAL + * @{ + */ + +#ifndef _SERIAL_LLD_H_ +#define _SERIAL_LLD_H_ + +/*===========================================================================*/ +/* Driver pre-compile time settings. */ +/*===========================================================================*/ + +/** + * @brief Serial buffers size. + * @details Configuration parameter, you can change the depth of the queue + * buffers depending on the requirements of your application. + * @note The default is 32 bytes for both the transmission and receive buffers. + */ +#if !defined(SERIAL_BUFFERS_SIZE) || defined(__DOXYGEN__) +#define SERIAL_BUFFERS_SIZE 32 +#endif + +/** + * @brief Default bit rate. + * @details Configuration parameter, at startup the UARTs are configured at + * this speed. + * @note It is possible to use @p SetUART() in order to change the working + * parameters at runtime. + */ +#if !defined(DEFAULT_USART_BITRATE) || defined(__DOXYGEN__) +#define DEFAULT_USART_BITRATE 38400 +#endif + + +/** + * @brief USART0 driver enable switch. + * @details If set to @p TRUE the support for USART0 is included. + * @note The default is @p FALSE. + */ +#if !defined(USE_AVR_USART0) || defined(__DOXYGEN__) +#define USE_AVR_USART0 FALSE +#endif + +/** + * @brief USART1 driver enable switch. + * @details If set to @p TRUE the support for USART1 is included. + * @note The default is @p TRUE. + */ +#if !defined(USE_AVR_USART1) || defined(__DOXYGEN__) +#define USE_AVR_USART1 TRUE +#endif + +/*===========================================================================*/ +/* Unsupported event flags and custom events. */ +/*===========================================================================*/ + +/*===========================================================================*/ +/* Driver data structures and types. */ +/*===========================================================================*/ + +/** + * Serial Driver condition flags type. + */ +typedef uint8_t sdflags_t; + +/** + * @brief @p SerialDriver specific data. + */ +struct _serial_driver_data { + /** + * Input queue, incoming data can be read from this input queue by + * using the queues APIs. + */ + InputQueue iqueue; + /** + * Output queue, outgoing data can be written to this output queue by + * using the queues APIs. + */ + OutputQueue oqueue; + /** + * Status Change @p EventSource. This event is generated when one or more + * condition flags change. + */ + EventSource sevent; + /** + * I/O driver status flags. + */ + sdflags_t flags; + /** + * Input circular buffer. + */ + uint8_t ib[SERIAL_BUFFERS_SIZE]; + /** + * Output circular buffer. + */ + uint8_t ob[SERIAL_BUFFERS_SIZE]; +}; + +/** + * @brief Macro for baud rate computation. + * @note Make sure the final baud rate is within tolerance. + */ +#define UBRR(b) ((F_CPU / (b << 4)) - 1) + +/** + * @brief AVR Serial Driver configuration structure. + * @details An instance of this structure must be passed to @p sdStart() + * in order to configure and start a serial driver operations. + */ +typedef struct { + uint16_t brr; + uint8_t csrc; +} SerialDriverConfig; + +/*===========================================================================*/ +/* External declarations. */ +/*===========================================================================*/ + +/** @cond never*/ +#if USE_AVR_USART0 +extern SerialDriver SD1; +#endif +#if USE_AVR_USART1 +extern SerialDriver SD2; +#endif + +#ifdef __cplusplus +extern "C" { +#endif + void sd_lld_init(void); + void sd_lld_start(SerialDriver *sdp, const SerialDriverConfig *config); + void sd_lld_stop(SerialDriver *sdp); +#ifdef __cplusplus +} +#endif +/** @endcond*/ + +#endif /* _SERIAL_LLD_H_ */ + +/** @} */ -- cgit v1.2.3