<feed xmlns='http://www.w3.org/2005/Atom'>
<title>feurig/libmaplemidi-cma/libmaple/usart.c, branch master</title>
<subtitle>C and C++ library for STM32 ARM Cortex-M3 development boards.</subtitle>
<id>https://git.suspectdevices.com/feurig/libmaplemidi-cma/atom?h=master</id>
<link rel='self' href='https://git.suspectdevices.com/feurig/libmaplemidi-cma/atom?h=master'/>
<link rel='alternate' type='text/html' href='https://git.suspectdevices.com/feurig/libmaplemidi-cma/'/>
<updated>2012-09-04T05:36:48+00:00</updated>
<entry>
<title>Add some missing LeafLabs copyright notices.</title>
<updated>2012-09-04T05:36:48+00:00</updated>
<author>
<name>Marti Bolivar</name>
<email>mbolivar@leaflabs.com</email>
</author>
<published>2012-09-04T05:33:08+00:00</published>
<link rel='alternate' type='text/html' href='https://git.suspectdevices.com/feurig/libmaplemidi-cma/commit/?id=50448497f867d618351aaa9a19521a26a54bba02'/>
<id>urn:sha1:50448497f867d618351aaa9a19521a26a54bba02</id>
<content type='text'>
Sigh; Emacs's elide-head feature makes it easy to forget to update
these.

Signed-off-by: Marti Bolivar &lt;mbolivar@leaflabs.com&gt;
</content>
</entry>
<entry>
<title>Fix a bunch of Doxygen file-level comments.</title>
<updated>2012-05-08T20:22:41+00:00</updated>
<author>
<name>Marti Bolivar</name>
<email>mbolivar@leaflabs.com</email>
</author>
<published>2012-05-08T20:22:41+00:00</published>
<link rel='alternate' type='text/html' href='https://git.suspectdevices.com/feurig/libmaplemidi-cma/commit/?id=306e19cb9ffc452f5759c863ef55b6e9e837f6b1'/>
<id>urn:sha1:306e19cb9ffc452f5759c863ef55b6e9e837f6b1</id>
<content type='text'>
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 &lt;mbolivar@leaflabs.com&gt;
</content>
</entry>
<entry>
<title>[FIXME] Resurrected, shinier USART support.</title>
<updated>2012-04-11T20:56:55+00:00</updated>
<author>
<name>Marti Bolivar</name>
<email>mbolivar@leaflabs.com</email>
</author>
<published>2012-03-26T19:42:25+00:00</published>
<link rel='alternate' type='text/html' href='https://git.suspectdevices.com/feurig/libmaplemidi-cma/commit/?id=e59a7442a30e8214763375e21d2f875c9af4acd0'/>
<id>urn:sha1:e59a7442a30e8214763375e21d2f875c9af4acd0</id>
<content type='text'>
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 &lt;mbolivar@leaflabs.com&gt;
</content>
</entry>
<entry>
<title>Move public headers to include directories; related cleanups.</title>
<updated>2012-04-11T20:56:50+00:00</updated>
<author>
<name>Marti Bolivar</name>
<email>mbolivar@leaflabs.com</email>
</author>
<published>2011-11-15T17:45:43+00:00</published>
<link rel='alternate' type='text/html' href='https://git.suspectdevices.com/feurig/libmaplemidi-cma/commit/?id=954f9e5065b39fe4c683f4d216b54326d876f51b'/>
<id>urn:sha1:954f9e5065b39fe4c683f4d216b54326d876f51b</id>
<content type='text'>
Move libmaple/*.h to (new) libmaple/include/libmaple/. The new
accepted way to include a libmaple header foo.h is with:

    #include &lt;libmaple/foo.h&gt;

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 &lt;libmaple/foo.h&gt;.
- 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 &lt;libmaple/foo.h&gt;.

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 &lt;board/board.h&gt;

  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 &lt;mbolivar@leaflabs.com&gt;
</content>
</entry>
<entry>
<title>usart: Add usart_rx().</title>
<updated>2011-10-07T18:38:33+00:00</updated>
<author>
<name>Marti Bolivar</name>
<email>mbolivar@leaflabs.com</email>
</author>
<published>2011-09-15T00:38:26+00:00</published>
<link rel='alternate' type='text/html' href='https://git.suspectdevices.com/feurig/libmaplemidi-cma/commit/?id=2d689be936db1d55648f52a6dd5562ff8bd7f257'/>
<id>urn:sha1:2d689be936db1d55648f52a6dd5562ff8bd7f257</id>
<content type='text'>
usart_rx() is a nonblocking USART receive.  Add it for symmetry with
usart_tx().
</content>
</entry>
<entry>
<title>Typos.</title>
<updated>2011-08-11T06:56:09+00:00</updated>
<author>
<name>Marti Bolivar</name>
<email>mbolivar@leaflabs.com</email>
</author>
<published>2011-08-10T19:14:22+00:00</published>
<link rel='alternate' type='text/html' href='https://git.suspectdevices.com/feurig/libmaplemidi-cma/commit/?id=aa05fa2276a0bcef174f7dbe2b70960bf1dca195'/>
<id>urn:sha1:aa05fa2276a0bcef174f7dbe2b70960bf1dca195</id>
<content type='text'>
</content>
</entry>
<entry>
<title>usart: Moving Doxygen comments to points of definition</title>
<updated>2011-05-19T22:45:46+00:00</updated>
<author>
<name>Marti Bolivar</name>
<email>mbolivar@leaflabs.com</email>
</author>
<published>2011-05-19T21:25:27+00:00</published>
<link rel='alternate' type='text/html' href='https://git.suspectdevices.com/feurig/libmaplemidi-cma/commit/?id=9cf0e1006ecf927cc9f5b447914a970e2b7cfeb4'/>
<id>urn:sha1:9cf0e1006ecf927cc9f5b447914a970e2b7cfeb4</id>
<content type='text'>
In keeping with convention.
</content>
</entry>
<entry>
<title>Adding nonblocking USART transmit, usart_tx().</title>
<updated>2011-04-25T22:00:34+00:00</updated>
<author>
<name>Marti Bolivar</name>
<email>mbolivar@leaflabs.com</email>
</author>
<published>2011-04-25T22:00:34+00:00</published>
<link rel='alternate' type='text/html' href='https://git.suspectdevices.com/feurig/libmaplemidi-cma/commit/?id=000e0e5a9845404441e9ca843742b9169acfb1a2'/>
<id>urn:sha1:000e0e5a9845404441e9ca843742b9169acfb1a2</id>
<content type='text'>
Other USART transmission functions are still blocking, but are now
implemented in terms of usart_tx().
</content>
</entry>
<entry>
<title>usart.c comment fixes.</title>
<updated>2011-04-15T20:43:57+00:00</updated>
<author>
<name>Marti Bolivar</name>
<email>mbolivar@leaflabs.com</email>
</author>
<published>2011-04-15T20:43:57+00:00</published>
<link rel='alternate' type='text/html' href='https://git.suspectdevices.com/feurig/libmaplemidi-cma/commit/?id=7ebf41352ac08d803ceb51aa6d738343163823e6'/>
<id>urn:sha1:7ebf41352ac08d803ceb51aa6d738343163823e6</id>
<content type='text'>
License header made 80-column clean.  usart_irq() comment for the
USART_SAFE_INSERT case made easier to understand.
</content>
</entry>
<entry>
<title>USART bugfix.</title>
<updated>2011-04-11T19:56:38+00:00</updated>
<author>
<name>Marti Bolivar</name>
<email>mbolivar@leaflabs.com</email>
</author>
<published>2011-04-11T19:52:48+00:00</published>
<link rel='alternate' type='text/html' href='https://git.suspectdevices.com/feurig/libmaplemidi-cma/commit/?id=f604bb7b27abea7e6cab2ef9c5f6d9dde9c69957'/>
<id>urn:sha1:f604bb7b27abea7e6cab2ef9c5f6d9dde9c69957</id>
<content type='text'>
USART refactor commit f6f9a1122706ed336c52c984d76219dee0594487 only
worked for USART1.
</content>
</entry>
</feed>
