Derek Fukumori / MODSERIAL

Important changes to repositories hosted on mbed.com

Mbed hosted mercurial repositories are deprecated and are due to be permanently deleted in July 2026.

To keep a copy of this software download the repository Zip archive or clone locally using Mercurial.

It is also possible to export all your personal repositories from the account settings page.

Fork of MODSERIAL by Andy K

PUTC.cpp@23:1236d0b64e71, 2012-07-13 (annotated)

Committer:
dfukumori
Date:
Fri Jul 13 01:09:23 2012 +0000
Revision:
23:1236d0b64e71
Parent:
22:c11ea36f17f9 
Required commit -- no changes

Who changed what in which revision?

UserRevisionLine numberNew contents of line
dfukumori 23:1236d0b64e71 1 /*
dfukumori 23:1236d0b64e71 2 Copyright (c) 2010 Andy Kirkham
dfukumori 23:1236d0b64e71 3
dfukumori 23:1236d0b64e71 4 Permission is hereby granted, free of charge, to any person obtaining a copy
dfukumori 23:1236d0b64e71 5 of this software and associated documentation files (the "Software"), to deal
dfukumori 23:1236d0b64e71 6 in the Software without restriction, including without limitation the rights
dfukumori 23:1236d0b64e71 7 to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
dfukumori 23:1236d0b64e71 8 copies of the Software, and to permit persons to whom the Software is
dfukumori 23:1236d0b64e71 9 furnished to do so, subject to the following conditions:
dfukumori 23:1236d0b64e71 10
dfukumori 23:1236d0b64e71 11 The above copyright notice and this permission notice shall be included in
dfukumori 23:1236d0b64e71 12 all copies or substantial portions of the Software.
dfukumori 23:1236d0b64e71 13
dfukumori 23:1236d0b64e71 14 THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
dfukumori 23:1236d0b64e71 15 IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
dfukumori 23:1236d0b64e71 16 FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
dfukumori 23:1236d0b64e71 17 AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
dfukumori 23:1236d0b64e71 18 LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
dfukumori 23:1236d0b64e71 19 OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
dfukumori 23:1236d0b64e71 20 THE SOFTWARE.
dfukumori 23:1236d0b64e71 21 */
dfukumori 23:1236d0b64e71 22
dfukumori 23:1236d0b64e71 23 #include "MODSERIAL.h"
dfukumori 23:1236d0b64e71 24 #include "MACROS.h"
dfukumori 23:1236d0b64e71 25
dfukumori 23:1236d0b64e71 26 namespace AjK {
dfukumori 23:1236d0b64e71 27
dfukumori 23:1236d0b64e71 28 int
dfukumori 23:1236d0b64e71 29 MODSERIAL::__putc(int c, bool block) {
dfukumori 23:1236d0b64e71 30
dfukumori 23:1236d0b64e71 31 // If no buffer is in use fall back to standard TX FIFO usage.
dfukumori 23:1236d0b64e71 32 // Note, we must block in this case and ignore bool "block"
dfukumori 23:1236d0b64e71 33 // so as to maintain compat with Mbed Serial.
dfukumori 23:1236d0b64e71 34 if (buffer[TxIrq] == (char *)NULL || buffer_size[TxIrq] == 0) {
dfukumori 23:1236d0b64e71 35 while (! MODSERIAL_THR_HAS_SPACE) ; // Wait for space in the TX FIFO.
dfukumori 23:1236d0b64e71 36 _THR = (uint32_t)c;
dfukumori 23:1236d0b64e71 37 return 0;
dfukumori 23:1236d0b64e71 38 }
dfukumori 23:1236d0b64e71 39
dfukumori 23:1236d0b64e71 40 if ( MODSERIAL_THR_HAS_SPACE && MODSERIAL_TX_BUFFER_EMPTY && dmaSendChannel == -1 ) {
dfukumori 23:1236d0b64e71 41 _THR = (uint32_t)c;
dfukumori 23:1236d0b64e71 42 }
dfukumori 23:1236d0b64e71 43 else {
dfukumori 23:1236d0b64e71 44 if (block) {
dfukumori 23:1236d0b64e71 45 uint32_t ier = _IER; _IER = 1;
dfukumori 23:1236d0b64e71 46 while ( MODSERIAL_TX_BUFFER_FULL ) { // Blocks!
dfukumori 23:1236d0b64e71 47 // If putc() is called from an ISR then we are stuffed
dfukumori 23:1236d0b64e71 48 // because in an ISR no bytes from the TX buffer will
dfukumori 23:1236d0b64e71 49 // get transferred to teh TX FIFOs while we block here.
dfukumori 23:1236d0b64e71 50 // So, to work around this, instead of sitting in a
dfukumori 23:1236d0b64e71 51 // loop waiting for space in the TX buffer (which will
dfukumori 23:1236d0b64e71 52 // never happen in IRQ context), check to see if the
dfukumori 23:1236d0b64e71 53 // TX FIFO has space available to move bytes from the
dfukumori 23:1236d0b64e71 54 // TX buffer to TX FIFO to make space. The easiest way
dfukumori 23:1236d0b64e71 55 // to do this is to poll the isr_tx() function while we
dfukumori 23:1236d0b64e71 56 // are blocking.
dfukumori 23:1236d0b64e71 57 isr_tx(false);
dfukumori 23:1236d0b64e71 58 }
dfukumori 23:1236d0b64e71 59 _IER = ier;
dfukumori 23:1236d0b64e71 60 }
dfukumori 23:1236d0b64e71 61 else if( MODSERIAL_TX_BUFFER_FULL ) {
dfukumori 23:1236d0b64e71 62 buffer_overflow[TxIrq] = c; // Oh dear, no room in buffer.
dfukumori 23:1236d0b64e71 63 _isr[TxOvIrq].call(&this->callbackInfo);
dfukumori 23:1236d0b64e71 64 return -1;
dfukumori 23:1236d0b64e71 65 }
dfukumori 23:1236d0b64e71 66 _IER &= ~2;
dfukumori 23:1236d0b64e71 67 buffer[TxIrq][buffer_in[TxIrq]] = c;
dfukumori 23:1236d0b64e71 68 __disable_irq();
dfukumori 23:1236d0b64e71 69 buffer_count[TxIrq]++;
dfukumori 23:1236d0b64e71 70 __enable_irq();
dfukumori 23:1236d0b64e71 71 buffer_in[TxIrq]++;
dfukumori 23:1236d0b64e71 72 if (buffer_in[TxIrq] >= buffer_size[TxIrq]) {
dfukumori 23:1236d0b64e71 73 buffer_in[TxIrq] = 0;
dfukumori 23:1236d0b64e71 74 }
dfukumori 23:1236d0b64e71 75 _IER |= 2;
dfukumori 23:1236d0b64e71 76 }
dfukumori 23:1236d0b64e71 77
dfukumori 23:1236d0b64e71 78 return 0;
dfukumori 23:1236d0b64e71 79 }
dfukumori 23:1236d0b64e71 80
dfukumori 23:1236d0b64e71 81 }; // namespace AjK ends