aboutsummaryrefslogtreecommitdiff
path: root/libmaple/usart.c
AgeCommit message (Collapse)Author
2012-09-04Add some missing LeafLabs copyright notices.Marti Bolivar
Sigh; Emacs's elide-head feature makes it easy to forget to update these. Signed-off-by: Marti Bolivar <mbolivar@leaflabs.com>
2012-05-08Fix a bunch of Doxygen file-level comments.Marti Bolivar
Fix @file in many places. Also fix up the descriptions where it's appropriate. This standardizes the @file formatting across the library to explicitly include any parent directories up to the repository root. Besides being nice, this will hopefully let us manage Doxygen's XML output so as to make extracting series-specific pieces via Breathe in the leaflabs-docs repo possible. Signed-off-by: Marti Bolivar <mbolivar@leaflabs.com>
2012-04-11[FIXME] Resurrected, shinier USART support.Marti Bolivar
FIXME: - Test F1 support - Solve problem of duplicated bytes being TXed unless delay is inserted after configuration but before first bytes are TXed. Rip out nonportable bits from top-level interfaces. The USART register maps are basically the same between F1 and F2, so leave these, but add register bit definitions which had name changes to the libmaple header to avoid needless repetition. There are also a few new bits in the F2 USART registers; add definitions for these in the F2 USART header. Add Doxygen comments for all USART bit definitions. Deprecate struct usart_dev's max_baud field. This is just bloat that doesn't bring us much real benefit. Add new series-specific USART files for F1 and F2: - libmaple/stm32f[1,2]/usart.c - libmaple/stm32f[1,2]/include/series/usart.h These are standard series-specific files, providing register map base pointers, defining devices, implementing nonportable routines, etc. We need a portable way to configure the USART GPIOs. To this end, add usart_async_gpio_cfg() to the top-level USART interface. This function is implemented in new F1 and F2 USART backends to take the appropriate action to configure the RX and TX pins for asynchronous full duplex mode. USART baud rate calculation is done differently on the different series. Keep the usart_set_baud_rate() declaration in the top-level USART header, but move the implementations into the series-specific usart.c files. In usart_set_baud_rate(), allow for deriving clock_speed automatically by letting user tell us to figure out the peripheral clock speed by mapping the device's rcc_clk_id onto an STM32_PCLK[1,2] value. This preserves flexibility for users with non-default clock configurations, but makes things easier on everyone else. Add private USART files for portable private USART routines: - libmaple/usart_private.h - libmaple/usart_private.c Signed-off-by: Marti Bolivar <mbolivar@leaflabs.com>
2012-04-11Move public headers to include directories; related cleanups.Marti Bolivar
Move libmaple/*.h to (new) libmaple/include/libmaple/. The new accepted way to include a libmaple header foo.h is with: #include <libmaple/foo.h> This is more polite in terms of the include namespace. It also allows us to e.g. implement the Arduino SPI library at all (which has header SPI.h; providing it was previously impossible on case-insensitive filesystems due to libmaple's spi.h). Similarly for Wirish. The old include style (#include "header.h") is now deprecated. libmaple/*.h: - Change include guard #defines from _FOO_H_ to _LIBMAPLE_FOO_H_. - Add license headers where they're missing - Add conditional extern "C" { ... } blocks where they're missing (they aren't always necessary, but we might was well do it against the future, while we're at it.). - Change includes from #include "foo.h" to #include <libmaple/foo.h>. - Move includes after extern "C". - Remove extra trailing newlines Note that this doesn't include the headers under libmaple/usb/ or libmaple/usb/usb_lib. These will get fixed later. libmaple/*.c: - Change includes from #include "foo.h" to #include <libmaple/foo.h>. Makefile: - Add I$(LIBMAPLE_PATH)/include/libmaple to GLOBAL_FLAGS. This allows for users (including Wirish) to migrate their code, but should go away ASAP, since it slows down compilation. Wirish: - Move wirish/**/*.h to (new) wirish/include/wirish/. This ignores the USB headers, which, as usual, are getting handled after everything else. - Similarly generify wirish/boards/ structure. For each supported board "foo", move wirish/boards/foo.h and wirish/boards/foo.cpp to wirish/boards/foo/include/board/board.h and wirish/boards/foo/board.cpp, respectively. Also remove the #ifdef hacks around the .cpp files. - wirish/rules.mk: put wirish/boards/foo/include in the include path (and add wirish/boards/foo/board.cpp to the list of sources to be compiled). This allows saying: #include <board/board.h> instead of the hack currently in place. We can allow the user to override this setting later to make adding custom board definitions easier. - Disable -Werror in libmaple/rules.mk, as the current USB warnings don't let the olimex_stm32_h103 board compile. We can re-enable -Werror once we've moved the board-specific bits out of libmaple proper. libraries, examples: - Update includes accordingly. - Miscellaneous cosmetic fixups. Signed-off-by: Marti Bolivar <mbolivar@leaflabs.com>
2011-10-07usart: Add usart_rx().Marti Bolivar
usart_rx() is a nonblocking USART receive. Add it for symmetry with usart_tx().
2011-08-11Typos.Marti Bolivar
2011-05-19usart: Moving Doxygen comments to points of definitionMarti Bolivar
In keeping with convention.
2011-04-25Adding nonblocking USART transmit, usart_tx().Marti Bolivar
Other USART transmission functions are still blocking, but are now implemented in terms of usart_tx().
2011-04-15usart.c comment fixes.Marti Bolivar
License header made 80-column clean. usart_irq() comment for the USART_SAFE_INSERT case made easier to understand.
2011-04-11USART bugfix.Marti Bolivar
USART refactor commit f6f9a1122706ed336c52c984d76219dee0594487 only worked for USART1.
2011-04-08USART fixups.Marti Bolivar
* usart_enable(): Doxygen comment bugfix. * usart_disable(): previously, usart_disable() would nuke the entire CR1 register just to clear the UE bit.
2011-04-07USART refactor.Marti Bolivar
2011-02-27Refactor linker scripts. Rename irq and exception handlers.Perry Hung
Add common linker scripts for ram and rom. Add medium and high density libraries for libcs3.
2011-02-27Cleaned out libmaple.h; this had wide-ranging implications.Marti Bolivar
Many of the #defines in libmaple.h were board-specific, not MCU-specific. Most of these were only used by code under libmaple/usb/. These were moved into usb_config.h, and are clearly marked as being terrible hacks. I'm going to treat the USB stack as a black box that we'll deal with later. Further, instead of having a variety of #defines like "How many USARTS do I have?", we decide that based on the density of the chip. This is determined by testing for STM32_MEDIUM_DENSITY or STM32_HIGH_DENSITY defines. libmaple currently doesn't support low-density chips, so that suffices. The Makefile will set these automatically based on the MCU. Other offending #defines are ERROR_LED_PORT and ERROR_LED_PIN; these were made optional, but they're set in the Makefile as a hack to keep things working.
2011-02-16Merge branch 'nzmichaelh-master' into master.Marti Bolivar
This provides DMA, IWDG, PWR, and BKP support, and fixes several bugs. Conflicts: libmaple/adc.h libmaple/libmaple.h libmaple/ring_buffer.h
2011-02-15undoing USART[45] -> UART[45] mistakeMarti Bolivar
2011-01-26[WIP] Code review picked up some bugs/issues.Marti Bolivar
2010-10-11docsMarti Bolivar
2010-09-27whitespace cleanupsMarti Bolivar
2010-09-01Various fixes, working with Maplebnewbold
2010-08-25inital portability workbnewbold
2010-08-04Cleaned up wirish/time, some interrupt handling refactoring:Perry Hung
Fixed millis(), it was just wrong, before. Added micros(), not extensively tested. New implementation of delayMicroseconds(). Should be more consistent now. Added a handful of nvic routines to enable/disable interrupts. Cleaned up systick
2010-08-04New usart implementation:Perry Hung
Fixed a bug where the maximum baud rate was incorrectly set to 225000 General cleanup Use new rcc and nvic APIs
2010-08-04New reset and clock control apiPerry Hung
2010-07-19added Serial.flush()bnewbold
2010-03-31Licensing: Relicensed libmaple under the MIT License.Perry Hung
Relicensed the bulk of libmaple under the more permissive MIT License, from GPLv3. Files that were largely or entirely derived from the Arduino, STM, or Lanchon retain their original licenses.
2010-03-31Removed inttypes.hPerry Hung
Removed inttypes.h from libmaple. Will have another pass through to use the standard libmaple types, but will come in another commit.
2010-03-30Merge branch 'master' into rcc-devPerry Hung
Conflicts: Makefile
2010-03-31Major hierarchy reorganization; see README.bnewbold
copy-to-ide and Makefile updated to conform; .gitignore added; LICENSE added