File content as of revision 24:9c456e647a8f:

/* $Id:$

1.24    6th Dec 2012
        Beta release for new Mbed library.

1.23    25th July 2012

    * LPC1768 code as was. This release includes "alpha" support for the LPC11U24

1.22    19th April 2012

    * http://mbed.org/forum/bugs-suggestions/topic/2936/
    * Bug fix, protect important buffer pointers from IRQ corruption.
      Credits: 
        Anthony Wieser  http://mbed.org/users/WieserSoftwareLtd/ for the fix.
        BlazeX http://mbed.org/users/BlazeX/ for the alert that a fix was needed!

1.21    10 May 2011
    
    * http://mbed.org/forum/mbed/topic/2264
    
1.20    26 April 2011

    * Bug fix, not blocking on transmit
      by Erik Petrich, http://mbed.org/forum/bugs-suggestions/topic/2200
      
1.19    20 April 2011

    * Fixed some doxygen comment bugs.
    
1.18    20 April 2011

    * All callbacks now use MODSERIAL_callback (rather than Mbed's FunctionPointer[1] type)
      to store and invoke it's callbacks. This allows MODSERIAL to pass a parameter
      to callbacks. The function prototype is now void func(MODSERIAL_IRQ_INFO *q).
    * Callbacks now pass a pointer to a MODSERIAL_IRQ_INFO class type.
      This class holds a pointer to the MODSERIAL object that invoked the callback
      thus freeing callbacks need to use the global variable of the original 
      MODSERIAL instance.
    * MODSERIAL_IRQ_INFO also declares public functions that are protected within MODSERIAL
      thus allowing certain functions to be restricted to callback context only.
    * New function MODSERIAL_IRQ_INFO::rxDiscardLastChar() allows an rxCallback function
      to remove the character that was just placed into the RX buffer.
    
    [1] http://mbed.org/users/AjK/libraries/FPointer/latest/docs/

1.17   08/Mar/2011
       Fixed a memory leak in the DMA code.
       
1.16 - 12 Feb 2011
    
    * Missed one, doh!

1.15 - 12 Feb 2011
    
    * Fixed some typos.
    
1.14 - 7 Feb 2011

    * Fixed a bug in __putc() that caused the output buffer pointer to 
      become corrupted.

1.13 - 20/01/2011

    * Added extra documentation.
    * Fixed some typos.
    
1.12 - 20/01/2011

    * Added new "autoDetectChar()" function. To use:-
      1st: Add a callback to invoke when the char is detected:-        
        .attach(&detectedChar, MODSERIAL::RxAutoDetect);
      2nd: Send the char to detect.
        .autoDectectChar('\n');
      Whenever that char goes into the RX buffer your callback will be invoked.
      Added example2.cpp to demo a simple messaging system using this auto feature.


1.11 - 23/11/2010

    * Fixed a minor issue with 1.10 missed an alteration of name change.
    
1.10 - 23/11/2010

    * Rename the DMA callback from attach_dma_complete() to attach_dmaSendComplete()
    
1.9 - 23/11/2010

    * Added support for DMA sending of characters. Required is
      the MODDMA library module:-
      http://mbed.org/users/AjK/libraries/MODDMA/latest
      See example_dma.cpp for more information.
      
1.8 - 22/11/2010

    * Added code so that if a buffer is set to zero length then
      MODSERIAL defaults to just using the FIFO for that stream
      thus making the library "fall back" to teh same operation
      that the Mbed Serial library performs.
    * Removed dmaSend() function that should have been removed 
      at 1.7
    
1.7 - 21/11/2010

    * Remove the DMA enum from MODSERIAL.h as it's not currently 
      ready for release.
    * Added page doxygen comments.

1.6 - 21/11/2010

   * Version 1.5 solved a blocking problem on putc() when called 
     from another ISR. However, isr_tx() invokes a callback of it's
     own when a byte is tranferred from TX buffer to TX FIFO. User
     programs may interpret that as an IRQ callback. That's an ISR
     call from within an existing ISR which is not good. So the 
     TxIrq callback from isr_tx is now conditional. It will only
     be called when isr_tx() is actually within it's own ISR and
     not when called from alternate ISR handlers.
     
1.5 - 21/11/2010

    * Calling putc() (or any derived function that uses it like
      printf()) while inside an interrupt service routine can
      cause the system to lock up if the TX buffer is full. This
      is because bytes are only transferred from the TX buffer to
      the TX FIFO via the TX ISR. If we are, say in an RX ISR already,
      then the TX ISR will never trigger. The TX buffer stays full and
      there is never space to putc() the byte. So, while putc() blocks
      waiting for space it calls isr_tx() to ensure if TX FIFO space
      becomes available it will move bytes from the TX buffer to TX
      FIFO thus removing the blocking condition within putc().

1.4 - 21/11/2010

    * Removed all the new DMA code. I wish mbed.org had proper SVN
      versioning, I'm use to working in HEAD and BRANCHES after I've
      released a project. Getting bug reports in current releases
      while trying to dev new code is hard to manage without source
      control of some type!

1.3 - 21/11/2010

    * Fixed a macro problem with txIsBusy()
    * Started adding code to use "block data" sending using DMA
    * Removed #include "IOMACROS.h"
    
1.2 - 21/11/2010

    * Removed unsed variables from flushBuffer()
    * Fixed a bug where both RX AND TX fifos are cleared/reset 
      when just TX OR RX should be cleared.
    * Fixed a bug that cleared IIR when in fact it should be left
      alone so that any pending interrupt after flush is handled.
    * Merged setBase() into init() as it wasn't required anywhere else.
    * Changed init() to enforce _uidx is set by Serial to define the _base
      address of the Uart in use.
        
1.1 - 20/11/2010

    * Added this file
    * Removed cruft from GETC.cpp
    * "teh" should be "the", why do my fingers do that?

1.0 - 20/11/2010

    * First release.

*/