Erik - / MODSERIAL-RTOS

MODSERIAL with support for KL25Z + RTOS (beta, putc + puts currently)

Dependents:   kl25z_USB_4

Fork of MODSERIAL by Erik -

MODSERIAL.h@30:913b04338760, 2013-07-16 (annotated)

Committer:
Sissors
Date:
Tue Jul 16 14:00:58 2013 +0000
Revision:
30:913b04338760
Parent:
28:76793a84f9e5 
Added some RTOS ability

Who changed what in which revision?

UserRevisionLine numberNew contents of line
AjK 12:8c7394e2ae7f 1 /*
AjK 12:8c7394e2ae7f 2 Copyright (c) 2010 Andy Kirkham
AjK 12:8c7394e2ae7f 3
AjK 12:8c7394e2ae7f 4 Permission is hereby granted, free of charge, to any person obtaining a copy
AjK 12:8c7394e2ae7f 5 of this software and associated documentation files (the "Software"), to deal
AjK 12:8c7394e2ae7f 6 in the Software without restriction, including without limitation the rights
AjK 12:8c7394e2ae7f 7 to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
AjK 12:8c7394e2ae7f 8 copies of the Software, and to permit persons to whom the Software is
AjK 12:8c7394e2ae7f 9 furnished to do so, subject to the following conditions:
AjK 12:8c7394e2ae7f 10
AjK 12:8c7394e2ae7f 11 The above copyright notice and this permission notice shall be included in
AjK 12:8c7394e2ae7f 12 all copies or substantial portions of the Software.
AjK 12:8c7394e2ae7f 13
AjK 12:8c7394e2ae7f 14 THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
AjK 12:8c7394e2ae7f 15 IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
AjK 12:8c7394e2ae7f 16 FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AjK 12:8c7394e2ae7f 17 AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
AjK 12:8c7394e2ae7f 18 LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
AjK 12:8c7394e2ae7f 19 OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
AjK 12:8c7394e2ae7f 20 THE SOFTWARE.
AjK 12:8c7394e2ae7f 21
AjK 12:8c7394e2ae7f 22 @file MODSERIAL.h
AjK 12:8c7394e2ae7f 23 @purpose Extends Serial to provide fully buffered IO
AjK 12:8c7394e2ae7f 24 @version see ChangeLog.c
AjK 12:8c7394e2ae7f 25 @date Nov 2010
AjK 12:8c7394e2ae7f 26 @author Andy Kirkham
AjK 12:8c7394e2ae7f 27 */
AjK 12:8c7394e2ae7f 28
AjK 12:8c7394e2ae7f 29 #ifndef MODSERIAL_H
AjK 12:8c7394e2ae7f 30 #define MODSERIAL_H
AjK 12:8c7394e2ae7f 31
AjK 12:8c7394e2ae7f 32 /** @defgroup API The MODSERIAL API */
AjK 12:8c7394e2ae7f 33 /** @defgroup MISC Misc MODSERIAL functions */
AjK 12:8c7394e2ae7f 34 /** @defgroup INTERNALS MODSERIAL Internals */
AjK 12:8c7394e2ae7f 35
AjK 12:8c7394e2ae7f 36 #ifndef MODSERIAL_DEFAULT_RX_BUFFER_SIZE
AjK 12:8c7394e2ae7f 37 #define MODSERIAL_DEFAULT_RX_BUFFER_SIZE 256
AjK 12:8c7394e2ae7f 38 #endif
AjK 12:8c7394e2ae7f 39
AjK 12:8c7394e2ae7f 40 #ifndef MODSERIAL_DEFAULT_TX_BUFFER_SIZE
AjK 12:8c7394e2ae7f 41 #define MODSERIAL_DEFAULT_TX_BUFFER_SIZE 256
AjK 12:8c7394e2ae7f 42 #endif
AjK 12:8c7394e2ae7f 43
AjK 12:8c7394e2ae7f 44 #include "mbed.h"
AjK 24:9c456e647a8f 45 #include "serial_api.h"
Sissors 30:913b04338760 46 //#include <cstdarg>
Sissors 30:913b04338760 47
AjK 12:8c7394e2ae7f 48
AjK 12:8c7394e2ae7f 49 namespace AjK {
AjK 12:8c7394e2ae7f 50
AjK 18:21ef26402365 51 // Forward reference.
AjK 18:21ef26402365 52 class MODSERIAL;
AjK 18:21ef26402365 53
AjK 18:21ef26402365 54 /**
AjK 18:21ef26402365 55 * @author Andy Kirkham
AjK 18:21ef26402365 56 * @see http://mbed.org/cookbook/MODSERIAL
AjK 18:21ef26402365 57 * @see example3a.cpp
AjK 18:21ef26402365 58 * @see example3b.cpp
AjK 18:21ef26402365 59 * @see API
AjK 18:21ef26402365 60 *
AjK 18:21ef26402365 61 * <b>MODSERIAL_IRQ_INFO</b> is a class used to pass information (and access to protected
AjK 19:a158936322cc 62 * MODSERIAL functions) to IRQ callbacks.
AjK 18:21ef26402365 63 */
AjK 18:21ef26402365 64 class MODSERIAL_IRQ_INFO
AjK 18:21ef26402365 65 {
AjK 18:21ef26402365 66 public:
AjK 18:21ef26402365 67 friend class MODSERIAL;
AjK 18:21ef26402365 68
AjK 18:21ef26402365 69 MODSERIAL *serial;
AjK 18:21ef26402365 70
AjK 18:21ef26402365 71 MODSERIAL_IRQ_INFO() { serial = 0; }
AjK 18:21ef26402365 72
AjK 18:21ef26402365 73 /** rxDiscardLastChar()
AjK 18:21ef26402365 74 *
AjK 18:21ef26402365 75 * Remove the last char placed into the rx buffer.
AjK 18:21ef26402365 76 * This is an operation that can only be performed
AjK 18:21ef26402365 77 * by an rxCallback function.
AjK 18:21ef26402365 78 * @ingroup API
AjK 18:21ef26402365 79 * @return The byte removed from the buffer.
AjK 18:21ef26402365 80 */
AjK 18:21ef26402365 81 int rxDiscardLastChar(void);
AjK 18:21ef26402365 82
AjK 18:21ef26402365 83 protected:
AjK 18:21ef26402365 84
AjK 18:21ef26402365 85 /** setSerial()
AjK 18:21ef26402365 86 *
AjK 18:21ef26402365 87 * Used internally by MODSERIAL to set the "this" pointer
AjK 18:21ef26402365 88 * of the MODSERIAL that created this object.
AjK 18:21ef26402365 89 * @ingroup INTERNAL
AjK 18:21ef26402365 90 * @param A pointer to a MODSERIAL object instance.
AjK 18:21ef26402365 91 */
AjK 18:21ef26402365 92 void setSerial(MODSERIAL *s) { serial = s; }
AjK 18:21ef26402365 93 };
AjK 18:21ef26402365 94
AjK 18:21ef26402365 95 // Forward reference dummy class.
AjK 18:21ef26402365 96 class MODSERIAL_callback_dummy;
AjK 18:21ef26402365 97
AjK 18:21ef26402365 98 /**
AjK 18:21ef26402365 99 * @author Andy Kirkham
AjK 18:21ef26402365 100 * @see http://mbed.org/cookbook/MODSERIAL
AjK 18:21ef26402365 101 * @see example3a.cpp
AjK 18:21ef26402365 102 * @see example3b.cpp
AjK 18:21ef26402365 103 * @see API
AjK 18:21ef26402365 104 *
AjK 18:21ef26402365 105 * <b>MODSERIAL_callback</b> is a class used to hold application callbacks that
AjK 18:21ef26402365 106 * MODSERIAL can invoke on certain events.
AjK 18:21ef26402365 107 */
AjK 18:21ef26402365 108 class MODSERIAL_callback
AjK 18:21ef26402365 109 {
AjK 18:21ef26402365 110 protected:
AjK 18:21ef26402365 111
AjK 18:21ef26402365 112 //! C callback function pointer.
AjK 18:21ef26402365 113 void (*c_callback)(MODSERIAL_IRQ_INFO *);
AjK 18:21ef26402365 114
AjK 18:21ef26402365 115 //! C++ callback object/method pointer (the object part).
AjK 18:21ef26402365 116 MODSERIAL_callback_dummy *obj_callback;
AjK 18:21ef26402365 117
AjK 18:21ef26402365 118 //! C++ callback object/method pointer (the method part).
AjK 18:21ef26402365 119 void (MODSERIAL_callback_dummy::*method_callback)(MODSERIAL_IRQ_INFO *);
AjK 18:21ef26402365 120
AjK 18:21ef26402365 121 public:
AjK 18:21ef26402365 122
AjK 18:21ef26402365 123 /** Constructor
AjK 18:21ef26402365 124 */
AjK 18:21ef26402365 125 MODSERIAL_callback() {
AjK 18:21ef26402365 126 c_callback = 0;
AjK 18:21ef26402365 127 obj_callback = 0;
AjK 18:21ef26402365 128 method_callback = 0;
AjK 18:21ef26402365 129 }
AjK 18:21ef26402365 130
AjK 18:21ef26402365 131 /** attach - Overloaded attachment function.
AjK 18:21ef26402365 132 *
AjK 18:21ef26402365 133 * Attach a C type function pointer as the callback.
AjK 18:21ef26402365 134 *
AjK 18:21ef26402365 135 * Note, the callback function prototype must be:-
AjK 18:21ef26402365 136 * @code
AjK 18:21ef26402365 137 * void myCallbackFunction(MODSERIAL_IRQ_INFO *);
AjK 18:21ef26402365 138 * @endcode
AjK 18:21ef26402365 139 * @param A C function pointer to call.
AjK 18:21ef26402365 140 */
AjK 18:21ef26402365 141 void attach(void (*function)(MODSERIAL_IRQ_INFO *) = 0) { c_callback = function; }
AjK 18:21ef26402365 142
AjK 18:21ef26402365 143 /** attach - Overloaded attachment function.
AjK 18:21ef26402365 144 *
AjK 18:21ef26402365 145 * Attach a C++ type object/method pointer as the callback.
AjK 18:21ef26402365 146 *
AjK 18:21ef26402365 147 * Note, the callback method prototype must be:-
AjK 18:21ef26402365 148 * @code
AjK 18:21ef26402365 149 * public:
AjK 18:21ef26402365 150 * void myCallbackFunction(MODSERIAL_IRQ_INFO *);
AjK 18:21ef26402365 151 * @endcode
AjK 18:21ef26402365 152 * @param A C++ object pointer.
AjK 18:21ef26402365 153 * @param A C++ method within the object to call.
AjK 18:21ef26402365 154 */
AjK 18:21ef26402365 155 template<class T>
AjK 18:21ef26402365 156 void attach(T* item, void (T::*method)(MODSERIAL_IRQ_INFO *)) {
AjK 18:21ef26402365 157 obj_callback = (MODSERIAL_callback_dummy *)item;
AjK 18:21ef26402365 158 method_callback = (void (MODSERIAL_callback_dummy::*)(MODSERIAL_IRQ_INFO *))method;
AjK 18:21ef26402365 159 }
AjK 18:21ef26402365 160
AjK 18:21ef26402365 161 /** call - Overloaded callback initiator.
AjK 18:21ef26402365 162 *
AjK 18:21ef26402365 163 * call the callback function.
AjK 18:21ef26402365 164 *
AjK 20:59c74aaedda2 165 * @param A pointer to a MODSERIAL_IRQ_INFO object.
AjK 18:21ef26402365 166 */
AjK 18:21ef26402365 167 void call(MODSERIAL_IRQ_INFO *arg) {
AjK 18:21ef26402365 168 if (c_callback != 0) {
AjK 18:21ef26402365 169 (*c_callback)(arg);
AjK 18:21ef26402365 170 }
AjK 18:21ef26402365 171 else {
AjK 18:21ef26402365 172 if (obj_callback != 0 && method_callback != 0) {
AjK 18:21ef26402365 173 (obj_callback->*method_callback)(arg);
AjK 18:21ef26402365 174 }
AjK 18:21ef26402365 175 }
AjK 18:21ef26402365 176 }
AjK 18:21ef26402365 177 };
AjK 18:21ef26402365 178
AjK 12:8c7394e2ae7f 179 /**
AjK 12:8c7394e2ae7f 180 * @author Andy Kirkham
AjK 12:8c7394e2ae7f 181 * @see http://mbed.org/cookbook/MODSERIAL
AjK 12:8c7394e2ae7f 182 * @see http://mbed.org/handbook/Serial
AjK 19:a158936322cc 183 * @see example1.cpp
AjK 19:a158936322cc 184 * @see example2.cpp
AjK 19:a158936322cc 185 * @see example3a.cpp
AjK 19:a158936322cc 186 * @see example3b.cpp
AjK 19:a158936322cc 187 * @see example_dma.cpp
AjK 12:8c7394e2ae7f 188 * @see API
AjK 12:8c7394e2ae7f 189 *
AjK 12:8c7394e2ae7f 190 * <b>MODSERIAL</b> extends the Mbed library <a href="/handbook/Serial">Serial</a> to provide fully buffered
AjK 12:8c7394e2ae7f 191 * TX and RX streams. Buffer length is fully customisable.
AjK 12:8c7394e2ae7f 192 *
AjK 12:8c7394e2ae7f 193 * Before using MODSERIAL users should be familar with Mbed's standard <a href="/handbook/Serial">Serial</a>
AjK 12:8c7394e2ae7f 194 * library object. MODSERIAL is a direct "drop in" replacement for <a href="/handbook/Serial">Serial</a>. Where
AjK 12:8c7394e2ae7f 195 * previously Serial was used, MODSERIAL can be used as adirect replacement instantly offering standard
AjK 12:8c7394e2ae7f 196 * TX and RX buffering. By default, both TX and RX buffers are 256 bytes in length.
AjK 12:8c7394e2ae7f 197 *
AjK 12:8c7394e2ae7f 198 * @image html /media/uploads/mbedofficial/serial_interfaces.png
AjK 12:8c7394e2ae7f 199 *
AjK 12:8c7394e2ae7f 200 * Standard example:
AjK 12:8c7394e2ae7f 201 * @code
AjK 12:8c7394e2ae7f 202 * #include "mbed.h"
AjK 12:8c7394e2ae7f 203 * #include "MODSERIAL.h"
AjK 12:8c7394e2ae7f 204 *
AjK 12:8c7394e2ae7f 205 * MODSERIAL pc(USBTX, USBRX); // tx, rx
AjK 12:8c7394e2ae7f 206 *
AjK 12:8c7394e2ae7f 207 * int main() {
AjK 12:8c7394e2ae7f 208 * pc.printf("Hello World!");
AjK 12:8c7394e2ae7f 209 * while(1) {
AjK 12:8c7394e2ae7f 210 * pc.putc(pc.getc() + 1);
AjK 12:8c7394e2ae7f 211 * }
AjK 12:8c7394e2ae7f 212 * }
AjK 12:8c7394e2ae7f 213 * @endcode
AjK 12:8c7394e2ae7f 214 *
AjK 12:8c7394e2ae7f 215 * Example with alternate buffer length:
AjK 12:8c7394e2ae7f 216 * @code
AjK 12:8c7394e2ae7f 217 * #include "mbed.h"
AjK 12:8c7394e2ae7f 218 * #include "MODSERIAL.h"
AjK 12:8c7394e2ae7f 219 *
AjK 12:8c7394e2ae7f 220 * // Make TX and RX buffers 512byes in length
AjK 12:8c7394e2ae7f 221 * MODSERIAL pc(USBTX, USBRX, 512); // tx, rx
AjK 12:8c7394e2ae7f 222 *
AjK 12:8c7394e2ae7f 223 * int main() {
AjK 12:8c7394e2ae7f 224 * pc.printf("Hello World!");
AjK 12:8c7394e2ae7f 225 * while(1) {
AjK 12:8c7394e2ae7f 226 * pc.putc(pc.getc() + 1);
AjK 12:8c7394e2ae7f 227 * }
AjK 12:8c7394e2ae7f 228 * }
AjK 12:8c7394e2ae7f 229 * @endcode
AjK 12:8c7394e2ae7f 230 *
AjK 12:8c7394e2ae7f 231 * Example with alternate buffer length:
AjK 12:8c7394e2ae7f 232 * @code
AjK 12:8c7394e2ae7f 233 * #include "mbed.h"
AjK 12:8c7394e2ae7f 234 * #include "MODSERIAL.h"
AjK 12:8c7394e2ae7f 235 *
AjK 12:8c7394e2ae7f 236 * // Make TX 1024bytes and RX 512byes in length
AjK 12:8c7394e2ae7f 237 * MODSERIAL pc(USBTX, USBRX, 1024, 512); // tx, rx
AjK 12:8c7394e2ae7f 238 *
AjK 12:8c7394e2ae7f 239 * int main() {
AjK 12:8c7394e2ae7f 240 * pc.printf("Hello World!");
AjK 12:8c7394e2ae7f 241 * while(1) {
AjK 12:8c7394e2ae7f 242 * pc.putc(pc.getc() + 1);
AjK 12:8c7394e2ae7f 243 * }
AjK 12:8c7394e2ae7f 244 * }
AjK 12:8c7394e2ae7f 245 * @endcode
AjK 12:8c7394e2ae7f 246 */
AjK 12:8c7394e2ae7f 247 class MODSERIAL : public Serial
AjK 12:8c7394e2ae7f 248 {
AjK 12:8c7394e2ae7f 249 public:
AjK 12:8c7394e2ae7f 250
AjK 18:21ef26402365 251 // Allow instances of MODSERIAL_IRQ_INFO to use protected properties and methods.
AjK 18:21ef26402365 252 friend class MODSERIAL_IRQ_INFO;
AjK 18:21ef26402365 253
AjK 12:8c7394e2ae7f 254 //! A copy of the Serial parity enum
AjK 12:8c7394e2ae7f 255 /** @see http://mbed.org/projects/libraries/api/mbed/trunk/Serial#Serial.format */
AjK 12:8c7394e2ae7f 256 enum Parity {
AjK 12:8c7394e2ae7f 257 None = 0
AjK 12:8c7394e2ae7f 258 , Odd
AjK 12:8c7394e2ae7f 259 , Even
AjK 12:8c7394e2ae7f 260 , Forced1
AjK 12:8c7394e2ae7f 261 , Forced0
AjK 12:8c7394e2ae7f 262 };
AjK 12:8c7394e2ae7f 263
AjK 12:8c7394e2ae7f 264 //! A copy of the Serial IrqType enum
AjK 12:8c7394e2ae7f 265 enum IrqType {
AjK 12:8c7394e2ae7f 266 RxIrq = 0
AjK 12:8c7394e2ae7f 267 , TxIrq
AjK 12:8c7394e2ae7f 268 , RxOvIrq
AjK 12:8c7394e2ae7f 269 , TxOvIrq
AjK 12:8c7394e2ae7f 270 , TxEmpty
AjK 12:8c7394e2ae7f 271 , RxAutoDetect
AjK 12:8c7394e2ae7f 272 , NumOfIrqTypes
AjK 12:8c7394e2ae7f 273 };
AjK 12:8c7394e2ae7f 274
AjK 12:8c7394e2ae7f 275 //! Non-blocking functions return code.
AjK 12:8c7394e2ae7f 276 enum Result {
AjK 12:8c7394e2ae7f 277 Ok = 0 /*!< Ok. */
AjK 12:8c7394e2ae7f 278 , NoMemory = -1 /*!< Memory allocation failed. */
AjK 12:8c7394e2ae7f 279 , NoChar = -1 /*!< No character in buffer. */
AjK 12:8c7394e2ae7f 280 , BufferOversize = -2 /*!< Oversized buffer. */
AjK 12:8c7394e2ae7f 281 };
AjK 12:8c7394e2ae7f 282
AjK 12:8c7394e2ae7f 283 /**
AjK 12:8c7394e2ae7f 284 * The MODSERIAL constructor is used to initialise the serial object.
AjK 12:8c7394e2ae7f 285 *
AjK 12:8c7394e2ae7f 286 * @param tx PinName of the TX pin.
AjK 12:8c7394e2ae7f 287 * @param rx PinName of the TX pin.
AjK 12:8c7394e2ae7f 288 */
AjK 25:ae0408ebdd68 289 MODSERIAL(PinName tx, PinName rx, const char* name = NULL);
AjK 12:8c7394e2ae7f 290
AjK 12:8c7394e2ae7f 291 /**
AjK 12:8c7394e2ae7f 292 * The MODSERIAL constructor is used to initialise the serial object.
AjK 12:8c7394e2ae7f 293 *
AjK 12:8c7394e2ae7f 294 * @param tx PinName of the TX pin.
AjK 12:8c7394e2ae7f 295 * @param rx PinName of the TX pin.
AjK 12:8c7394e2ae7f 296 * @param bufferSize Integer of the TX and RX buffer sizes.
AjK 12:8c7394e2ae7f 297 */
AjK 25:ae0408ebdd68 298 MODSERIAL(PinName tx, PinName rx, int bufferSize, const char* name = NULL);
AjK 12:8c7394e2ae7f 299
AjK 12:8c7394e2ae7f 300 /**
AjK 12:8c7394e2ae7f 301 * The MODSERIAL constructor is used to initialise the serial object.
AjK 12:8c7394e2ae7f 302 *
AjK 12:8c7394e2ae7f 303 * @param tx PinName of the TX pin.
AjK 12:8c7394e2ae7f 304 * @param rx PinName of the TX pin.
AjK 12:8c7394e2ae7f 305 * @param txBufferSize Integer of the TX buffer sizes.
AjK 12:8c7394e2ae7f 306 * @param rxBufferSize Integer of the RX buffer sizes.
AjK 12:8c7394e2ae7f 307 */
AjK 25:ae0408ebdd68 308 MODSERIAL(PinName tx, PinName rx, int txBufferSize, int rxBufferSize, const char* name = NULL);
AjK 12:8c7394e2ae7f 309
AjK 12:8c7394e2ae7f 310 virtual ~MODSERIAL();
AjK 12:8c7394e2ae7f 311
AjK 12:8c7394e2ae7f 312 /**
AjK 12:8c7394e2ae7f 313 * Function: attach
AjK 12:8c7394e2ae7f 314 *
AjK 12:8c7394e2ae7f 315 * The Mbed standard <a href="/handbook/Serial">Serial</a> library object allows an interrupt callback
AjK 12:8c7394e2ae7f 316 * to be made when a byte is received by the TX or RX UART hardware. MODSERIAL traps these interrupts
AjK 12:8c7394e2ae7f 317 * to enable it's buffering system. However, after the byte has been received/sent under interrupt control,
AjK 12:8c7394e2ae7f 318 * MODSERIAL can callback a user function as a notification of the interrupt. Note, user code should not
AjK 12:8c7394e2ae7f 319 * directly interact with the Uart hardware, MODSERIAL does that, instead, MODSERIAL API functions should
AjK 12:8c7394e2ae7f 320 * be used.
AjK 12:8c7394e2ae7f 321 *
AjK 12:8c7394e2ae7f 322 * <b>Note</b>, a character is written out then, if there is room in the TX FIFO and the TX buffer is empty,
AjK 12:8c7394e2ae7f 323 * putc() will put the character directly into THR (the output holding register). If the TX FIFO is full and
AjK 12:8c7394e2ae7f 324 * cannot accept the character, it is placed into the TX output buffer. The TX interrupts are then enabled
AjK 12:8c7394e2ae7f 325 * so that when the TX FIFO empties, the TX buffer is then transferred to the THR FIFO. The TxIrq will ONLY
AjK 12:8c7394e2ae7f 326 * be activated when this transfer of a character from BUFFER to THR FIFO takes place. If your character
AjK 12:8c7394e2ae7f 327 * throughput is not high bandwidth, then the 16 byte TX FIFO may be enough and the TX output buffer may
AjK 12:8c7394e2ae7f 328 * never come into play.
AjK 12:8c7394e2ae7f 329 *
AjK 12:8c7394e2ae7f 330 * @code
AjK 12:8c7394e2ae7f 331 * #include "mbed.h"
AjK 12:8c7394e2ae7f 332 * #include "MODSERIAL.h"
AjK 12:8c7394e2ae7f 333 *
AjK 12:8c7394e2ae7f 334 * DigitalOut led1(LED1);
AjK 12:8c7394e2ae7f 335 * DigitalOut led2(LED2);
AjK 12:8c7394e2ae7f 336 * DigitalOut led3(LED3);
AjK 12:8c7394e2ae7f 337 *
AjK 12:8c7394e2ae7f 338 * // To test, connect p9 to p10 as a loopback.
AjK 12:8c7394e2ae7f 339 * MODSERIAL pc(p9, p10);
AjK 12:8c7394e2ae7f 340 *
AjK 12:8c7394e2ae7f 341 * // This function is called when a character goes into the TX buffer.
AjK 12:8c7394e2ae7f 342 * void txCallback(void) {
AjK 12:8c7394e2ae7f 343 * led2 = !led2;
AjK 12:8c7394e2ae7f 344 * }
AjK 12:8c7394e2ae7f 345 *
AjK 12:8c7394e2ae7f 346 * // This function is called when a character goes into the RX buffer.
AjK 12:8c7394e2ae7f 347 * void rxCallback(void) {
AjK 12:8c7394e2ae7f 348 * led3 = !led3;
AjK 12:8c7394e2ae7f 349 * }
AjK 12:8c7394e2ae7f 350 *
AjK 12:8c7394e2ae7f 351 * int main() {
AjK 12:8c7394e2ae7f 352 * pc.baud(115200);
AjK 12:8c7394e2ae7f 353 * pc.attach(&txCallback, MODSERIAL::TxIrq);
AjK 12:8c7394e2ae7f 354 * pc.attach(&rxCallback, MODSERIAL::RxIrq);
AjK 12:8c7394e2ae7f 355 *
AjK 12:8c7394e2ae7f 356 * while(1) {
AjK 12:8c7394e2ae7f 357 * led1 = !led1;
AjK 12:8c7394e2ae7f 358 * wait(0.5);
AjK 12:8c7394e2ae7f 359 * pc.putc('A');
AjK 12:8c7394e2ae7f 360 * wait(0.5);
AjK 12:8c7394e2ae7f 361 * }
AjK 12:8c7394e2ae7f 362 * ]
AjK 12:8c7394e2ae7f 363 * @endcode
AjK 12:8c7394e2ae7f 364 *
AjK 12:8c7394e2ae7f 365 * @ingroup API
AjK 12:8c7394e2ae7f 366 * @param fptr A pointer to a void function, or 0 to set as none
AjK 12:8c7394e2ae7f 367 * @param type Which serial interrupt to attach the member function to (Seriall::RxIrq for receive, TxIrq for transmit buffer empty)
AjK 12:8c7394e2ae7f 368 */
AjK 18:21ef26402365 369 void attach(void (*fptr)(MODSERIAL_IRQ_INFO *), IrqType type = RxIrq) { _isr[type].attach(fptr); }
AjK 12:8c7394e2ae7f 370
AjK 12:8c7394e2ae7f 371 /**
AjK 12:8c7394e2ae7f 372 * Function: attach
AjK 12:8c7394e2ae7f 373 *
AjK 12:8c7394e2ae7f 374 * The Mbed standard <a href="/handbook/Serial">Serial</a> library object allows an interrupt callback
AjK 12:8c7394e2ae7f 375 * to be made when a byte is received by the TX or RX UART hardware. MODSERIAL traps these interrupts
AjK 12:8c7394e2ae7f 376 * to enable it's buffering system. However, after the byte has been received/sent under interrupt control,
AjK 12:8c7394e2ae7f 377 * MODSERIAL can callback a user function as a notification of the interrupt. Note, user code should not
AjK 12:8c7394e2ae7f 378 * directly interact with the Uart hardware, MODSERIAL does that, instead, MODSERIAL API functions should
AjK 12:8c7394e2ae7f 379 * be used.
AjK 12:8c7394e2ae7f 380 *
AjK 12:8c7394e2ae7f 381 * <b>Note</b>, a character is written out then, if there is room in the TX FIFO and the TX buffer is empty,
AjK 12:8c7394e2ae7f 382 * putc() will put the character directly into THR (the output holding register). If the TX FIFO is full and
AjK 12:8c7394e2ae7f 383 * cannot accept the character, it is placed into the TX output buffer. The TX interrupts are then enabled
AjK 12:8c7394e2ae7f 384 * so that when the TX FIFO empties, the TX buffer is then transferred to the THR FIFO. The TxIrq will ONLY
AjK 12:8c7394e2ae7f 385 * be activated when this transfer of a character from BUFFER to THR FIFO takes place. If your character
AjK 12:8c7394e2ae7f 386 * throughput is not high bandwidth, then the 16 byte TX FIFO may be enough and the TX output buffer may
AjK 12:8c7394e2ae7f 387 * never come into play.
AjK 12:8c7394e2ae7f 388 *
AjK 12:8c7394e2ae7f 389 * @code
AjK 12:8c7394e2ae7f 390 * #include "mbed.h"
AjK 12:8c7394e2ae7f 391 * #include "MODSERIAL.h"
AjK 12:8c7394e2ae7f 392 *
AjK 12:8c7394e2ae7f 393 * DigitalOut led1(LED1);
AjK 12:8c7394e2ae7f 394 * DigitalOut led2(LED2);
AjK 12:8c7394e2ae7f 395 * DigitalOut led3(LED3);
AjK 12:8c7394e2ae7f 396 *
AjK 12:8c7394e2ae7f 397 * // To test, connect p9 to p10 as a loopback.
AjK 12:8c7394e2ae7f 398 * MODSERIAL pc(p9, p10);
AjK 12:8c7394e2ae7f 399 *
AjK 12:8c7394e2ae7f 400 * class Foo {
AjK 12:8c7394e2ae7f 401 * public:
AjK 12:8c7394e2ae7f 402 * // This method is called when a character goes into the TX buffer.
AjK 12:8c7394e2ae7f 403 * void txCallback(void) { led2 = !led2; }
AjK 12:8c7394e2ae7f 404 *
AjK 12:8c7394e2ae7f 405 * // This method is called when a character goes into the RX buffer.
AjK 12:8c7394e2ae7f 406 * void rxCallback(void) { led3 = !led3; }
AjK 12:8c7394e2ae7f 407 * };
AjK 12:8c7394e2ae7f 408 *
AjK 12:8c7394e2ae7f 409 * Foo foo;
AjK 12:8c7394e2ae7f 410 *
AjK 12:8c7394e2ae7f 411 * int main() {
AjK 12:8c7394e2ae7f 412 * pc.baud(115200);
AjK 12:8c7394e2ae7f 413 * pc.attach(&foo, &Foo::txCallback, MODSERIAL::TxIrq);
AjK 12:8c7394e2ae7f 414 * pc.attach(&foo, &Foo::rxCallback, MODSERIAL::RxIrq);
AjK 12:8c7394e2ae7f 415 *
AjK 12:8c7394e2ae7f 416 * while(1) {
AjK 12:8c7394e2ae7f 417 * led1 = !led1;
AjK 12:8c7394e2ae7f 418 * wait(0.5);
AjK 12:8c7394e2ae7f 419 * pc.putc('A');
AjK 12:8c7394e2ae7f 420 * wait(0.5);
AjK 12:8c7394e2ae7f 421 * }
AjK 12:8c7394e2ae7f 422 * ]
AjK 12:8c7394e2ae7f 423 * @endcode
AjK 12:8c7394e2ae7f 424 *
AjK 12:8c7394e2ae7f 425 * @ingroup API
AjK 12:8c7394e2ae7f 426 * @param tptr A pointer to the object to call the member function on
AjK 12:8c7394e2ae7f 427 * @param mptr A pointer to the member function to be called
AjK 12:8c7394e2ae7f 428 * @param type Which serial interrupt to attach the member function to (Seriall::RxIrq for receive, TxIrq for transmit buffer empty)
AjK 12:8c7394e2ae7f 429 */
AjK 12:8c7394e2ae7f 430 template<typename T>
AjK 21:af2af4c61c2f 431 void attach(T* tptr, void (T::*mptr)(MODSERIAL_IRQ_INFO *), IrqType type = RxIrq) {
AjK 18:21ef26402365 432 if((mptr != 0) && (tptr != 0)) {
AjK 12:8c7394e2ae7f 433 _isr[type].attach(tptr, mptr);
AjK 12:8c7394e2ae7f 434 }
AjK 12:8c7394e2ae7f 435 }
AjK 12:8c7394e2ae7f 436
AjK 12:8c7394e2ae7f 437 /**
AjK 12:8c7394e2ae7f 438 * @see attach
AjK 12:8c7394e2ae7f 439 * @ingroup API
AjK 12:8c7394e2ae7f 440 */
AjK 18:21ef26402365 441 void connect(void (*fptr)(MODSERIAL_IRQ_INFO *), IrqType type = RxIrq) { _isr[RxIrq].attach(fptr); }
AjK 12:8c7394e2ae7f 442
AjK 12:8c7394e2ae7f 443 /**
AjK 12:8c7394e2ae7f 444 * @see attach
AjK 12:8c7394e2ae7f 445 * @ingroup API
AjK 12:8c7394e2ae7f 446 */
AjK 12:8c7394e2ae7f 447 template<typename T>
AjK 18:21ef26402365 448 void connect(T* tptr, void (T::*mptr)(MODSERIAL_IRQ_INFO *), IrqType type = RxIrq) {
AjK 18:21ef26402365 449 if((mptr != 0) && (tptr != 0)) {
AjK 12:8c7394e2ae7f 450 _isr[type].attach(tptr, mptr);
AjK 12:8c7394e2ae7f 451 }
AjK 12:8c7394e2ae7f 452 }
AjK 12:8c7394e2ae7f 453
AjK 12:8c7394e2ae7f 454 /**
AjK 12:8c7394e2ae7f 455 * Function: writeable
AjK 12:8c7394e2ae7f 456 *
AjK 12:8c7394e2ae7f 457 * Determine if there is space available to write a byte
AjK 12:8c7394e2ae7f 458 *
AjK 12:8c7394e2ae7f 459 * @ingroup API
AjK 12:8c7394e2ae7f 460 * @return 1 if there is space to write a character, else 0
AjK 12:8c7394e2ae7f 461 */
AjK 12:8c7394e2ae7f 462 int writeable() { return txBufferFull() ? 0 : 1; }
AjK 12:8c7394e2ae7f 463
AjK 12:8c7394e2ae7f 464 /**
AjK 12:8c7394e2ae7f 465 * Function: readable
AjK 12:8c7394e2ae7f 466 *
AjK 12:8c7394e2ae7f 467 * Determine if there is a byte available to read
AjK 12:8c7394e2ae7f 468 *
AjK 12:8c7394e2ae7f 469 * @ingroup API
AjK 12:8c7394e2ae7f 470 * @return 1 if there is a character available to read, else 0
AjK 12:8c7394e2ae7f 471 */
AjK 12:8c7394e2ae7f 472 int readable() { return rxBufferEmpty() ? 0 : 1; }
AjK 12:8c7394e2ae7f 473
AjK 12:8c7394e2ae7f 474 /**
AjK 12:8c7394e2ae7f 475 * Function: txBufferSane
AjK 12:8c7394e2ae7f 476 *
AjK 12:8c7394e2ae7f 477 * Determine if the TX buffer has been initialized.
AjK 12:8c7394e2ae7f 478 *
AjK 12:8c7394e2ae7f 479 * @ingroup API
AjK 12:8c7394e2ae7f 480 * @return true if the buffer is initialized, else false
AjK 12:8c7394e2ae7f 481 */
AjK 12:8c7394e2ae7f 482 bool txBufferSane(void) { return buffer[TxIrq] != (char *)NULL ? true : false; }
AjK 12:8c7394e2ae7f 483
AjK 12:8c7394e2ae7f 484 /**
AjK 12:8c7394e2ae7f 485 * Function: rxBufferSane
AjK 12:8c7394e2ae7f 486 *
AjK 12:8c7394e2ae7f 487 * Determine if the RX buffer has been initialized.
AjK 12:8c7394e2ae7f 488 *
AjK 12:8c7394e2ae7f 489 * @ingroup API
AjK 12:8c7394e2ae7f 490 * @return true if the buffer is initialized, else false
AjK 12:8c7394e2ae7f 491 */
AjK 12:8c7394e2ae7f 492 bool rxBufferSane(void) { return buffer[TxIrq] != (char *)NULL ? true : false; }
AjK 12:8c7394e2ae7f 493
AjK 12:8c7394e2ae7f 494 /**
AjK 12:8c7394e2ae7f 495 * Function: txBufferGetCount
AjK 12:8c7394e2ae7f 496 *
AjK 12:8c7394e2ae7f 497 * Returns how many bytes are in the TX buffer
AjK 12:8c7394e2ae7f 498 *
AjK 12:8c7394e2ae7f 499 * @ingroup API
AjK 12:8c7394e2ae7f 500 * @return The number of bytes in the TX buffer
AjK 12:8c7394e2ae7f 501 */
AjK 12:8c7394e2ae7f 502 int txBufferGetCount(void) { return buffer_count[TxIrq]; }
AjK 12:8c7394e2ae7f 503
AjK 12:8c7394e2ae7f 504 /**
AjK 12:8c7394e2ae7f 505 * Function: rxBufferGetCount
AjK 12:8c7394e2ae7f 506 *
AjK 12:8c7394e2ae7f 507 * Returns how many bytes are in the RX buffer
AjK 12:8c7394e2ae7f 508 *
AjK 12:8c7394e2ae7f 509 * @ingroup API
AjK 12:8c7394e2ae7f 510 * @return The number of bytes in the RX buffer
AjK 12:8c7394e2ae7f 511 */
AjK 12:8c7394e2ae7f 512 int rxBufferGetCount(void) { return buffer_count[RxIrq]; }
AjK 12:8c7394e2ae7f 513
AjK 12:8c7394e2ae7f 514 /**
AjK 12:8c7394e2ae7f 515 * Function: txBufferGetSize
AjK 12:8c7394e2ae7f 516 *
AjK 12:8c7394e2ae7f 517 * Returns the current size of the TX buffer
AjK 12:8c7394e2ae7f 518 *
AjK 12:8c7394e2ae7f 519 * @ingroup API
AjK 12:8c7394e2ae7f 520 * @return The length iof the TX buffer in bytes
AjK 12:8c7394e2ae7f 521 */
AjK 12:8c7394e2ae7f 522 int txBufferGetSize(int size) { return buffer_size[TxIrq]; }
AjK 12:8c7394e2ae7f 523
AjK 12:8c7394e2ae7f 524 /**
AjK 12:8c7394e2ae7f 525 * Function: rxBufferGetSize
AjK 12:8c7394e2ae7f 526 *
AjK 12:8c7394e2ae7f 527 * Returns the current size of the RX buffer
AjK 12:8c7394e2ae7f 528 *
AjK 12:8c7394e2ae7f 529 * @ingroup API
AjK 12:8c7394e2ae7f 530 * @return The length iof the RX buffer in bytes
AjK 12:8c7394e2ae7f 531 */
AjK 12:8c7394e2ae7f 532 int rxBufferGetSize(int size) { return buffer_size[RxIrq]; }
AjK 12:8c7394e2ae7f 533
AjK 12:8c7394e2ae7f 534 /**
AjK 12:8c7394e2ae7f 535 * Function: txBufferFull
AjK 12:8c7394e2ae7f 536 *
AjK 12:8c7394e2ae7f 537 * Is the TX buffer full?
AjK 12:8c7394e2ae7f 538 *
AjK 12:8c7394e2ae7f 539 * @ingroup API
AjK 12:8c7394e2ae7f 540 * @return true if the TX buffer is full, otherwise false
AjK 12:8c7394e2ae7f 541 */
AjK 12:8c7394e2ae7f 542 bool txBufferFull(void);
AjK 12:8c7394e2ae7f 543
AjK 12:8c7394e2ae7f 544 /**
AjK 12:8c7394e2ae7f 545 * Function: rxBufferFull
AjK 12:8c7394e2ae7f 546 *
AjK 12:8c7394e2ae7f 547 * Is the RX buffer full?
AjK 12:8c7394e2ae7f 548 *
AjK 12:8c7394e2ae7f 549 * @ingroup API
AjK 12:8c7394e2ae7f 550 * @return true if the RX buffer is full, otherwise false
AjK 12:8c7394e2ae7f 551 */
AjK 12:8c7394e2ae7f 552 bool rxBufferFull(void);
AjK 12:8c7394e2ae7f 553
AjK 12:8c7394e2ae7f 554 /**
AjK 12:8c7394e2ae7f 555 * Function: txBufferEmpty
AjK 12:8c7394e2ae7f 556 *
AjK 12:8c7394e2ae7f 557 * Is the TX buffer empty?
AjK 12:8c7394e2ae7f 558 *
AjK 12:8c7394e2ae7f 559 * @ingroup API
AjK 12:8c7394e2ae7f 560 * @return true if the TX buffer is empty, otherwise false
AjK 12:8c7394e2ae7f 561 */
AjK 12:8c7394e2ae7f 562 bool txBufferEmpty(void);
AjK 12:8c7394e2ae7f 563
AjK 12:8c7394e2ae7f 564 /**
AjK 12:8c7394e2ae7f 565 * Function: rxBufferEmpty
AjK 12:8c7394e2ae7f 566 *
AjK 12:8c7394e2ae7f 567 * Is the RX buffer empty?
AjK 12:8c7394e2ae7f 568 *
AjK 12:8c7394e2ae7f 569 * @ingroup API
AjK 12:8c7394e2ae7f 570 * @return true if the RX buffer is empty, otherwise false
AjK 12:8c7394e2ae7f 571 */
AjK 12:8c7394e2ae7f 572 bool rxBufferEmpty(void);
AjK 12:8c7394e2ae7f 573
AjK 12:8c7394e2ae7f 574 /**
AjK 12:8c7394e2ae7f 575 * Function: txBufferSetSize
AjK 12:8c7394e2ae7f 576 *
AjK 12:8c7394e2ae7f 577 * Change the TX buffer size.
AjK 12:8c7394e2ae7f 578 *
AjK 12:8c7394e2ae7f 579 * @see Result
AjK 12:8c7394e2ae7f 580 * @ingroup API
AjK 12:8c7394e2ae7f 581 * @param size The new TX buffer size in bytes.
AjK 12:8c7394e2ae7f 582 * @param m Perform a memory sanity check. Errs the Mbed if memory alloc fails.
AjK 12:8c7394e2ae7f 583 * @return Result Ok on success.
AjK 12:8c7394e2ae7f 584 */
AjK 12:8c7394e2ae7f 585 int txBufferSetSize(int size, bool m) { return resizeBuffer(size, TxIrq, m); }
AjK 12:8c7394e2ae7f 586
AjK 12:8c7394e2ae7f 587 /**
AjK 12:8c7394e2ae7f 588 * Function: rxBufferSetSize
AjK 12:8c7394e2ae7f 589 *
AjK 12:8c7394e2ae7f 590 * Change the RX buffer size.
AjK 12:8c7394e2ae7f 591 *
AjK 12:8c7394e2ae7f 592 * @see Result
AjK 12:8c7394e2ae7f 593 * @ingroup API
AjK 12:8c7394e2ae7f 594 * @param size The new RX buffer size in bytes.
AjK 12:8c7394e2ae7f 595 * @param m Perform a memory sanity check. Errs the Mbed if memory alloc fails.
AjK 12:8c7394e2ae7f 596 * @return Result Ok on success.
AjK 12:8c7394e2ae7f 597 */
AjK 12:8c7394e2ae7f 598 int rxBufferSetSize(int size, bool m) { return resizeBuffer(size, RxIrq, m); }
AjK 12:8c7394e2ae7f 599
AjK 12:8c7394e2ae7f 600 /**
AjK 12:8c7394e2ae7f 601 * Function: txBufferSetSize
AjK 12:8c7394e2ae7f 602 *
AjK 12:8c7394e2ae7f 603 * Change the TX buffer size.
AjK 12:8c7394e2ae7f 604 * Always performs a memory sanity check, halting the Mbed on failure.
AjK 12:8c7394e2ae7f 605 *
AjK 12:8c7394e2ae7f 606 * @see Result
AjK 12:8c7394e2ae7f 607 * @ingroup API
AjK 12:8c7394e2ae7f 608 * @param size The new TX buffer size in bytes.
AjK 12:8c7394e2ae7f 609 * @return Result Ok on success.
AjK 12:8c7394e2ae7f 610 */
AjK 12:8c7394e2ae7f 611 int txBufferSetSize(int size) { return resizeBuffer(size, TxIrq, true); }
AjK 12:8c7394e2ae7f 612
AjK 12:8c7394e2ae7f 613 /**
AjK 12:8c7394e2ae7f 614 * Function: rxBufferSetSize
AjK 12:8c7394e2ae7f 615 *
AjK 12:8c7394e2ae7f 616 * Change the RX buffer size.
AjK 12:8c7394e2ae7f 617 * Always performs a memory sanity check, halting the Mbed on failure.
AjK 12:8c7394e2ae7f 618 *
AjK 12:8c7394e2ae7f 619 * @see Result
AjK 12:8c7394e2ae7f 620 * @ingroup API
AjK 12:8c7394e2ae7f 621 * @param size The new RX buffer size in bytes.
AjK 12:8c7394e2ae7f 622 * @return Result Ok on success.
AjK 12:8c7394e2ae7f 623 */
AjK 12:8c7394e2ae7f 624 int rxBufferSetSize(int size) { return resizeBuffer(size, RxIrq, true); }
AjK 12:8c7394e2ae7f 625
AjK 12:8c7394e2ae7f 626 /**
AjK 12:8c7394e2ae7f 627 * Function: txBufferFlush
AjK 12:8c7394e2ae7f 628 *
AjK 12:8c7394e2ae7f 629 * Remove all bytes from the TX buffer.
AjK 12:8c7394e2ae7f 630 * @ingroup API
AjK 12:8c7394e2ae7f 631 */
AjK 12:8c7394e2ae7f 632 void txBufferFlush(void) { flushBuffer(TxIrq); }
AjK 12:8c7394e2ae7f 633
AjK 12:8c7394e2ae7f 634 /**
AjK 12:8c7394e2ae7f 635 * Function: rxBufferFlush
AjK 12:8c7394e2ae7f 636 *
AjK 12:8c7394e2ae7f 637 * Remove all bytes from the RX buffer.
AjK 12:8c7394e2ae7f 638 * @ingroup API
AjK 12:8c7394e2ae7f 639 */
AjK 12:8c7394e2ae7f 640 void rxBufferFlush(void) { flushBuffer(RxIrq); }
AjK 12:8c7394e2ae7f 641
AjK 12:8c7394e2ae7f 642 /**
AjK 12:8c7394e2ae7f 643 * Function: getcNb
AjK 12:8c7394e2ae7f 644 *
AjK 12:8c7394e2ae7f 645 * Like getc() but is non-blocking. If no bytes are in the RX buffer this
AjK 12:8c7394e2ae7f 646 * function returns Result::NoChar (-1)
AjK 12:8c7394e2ae7f 647 *
AjK 12:8c7394e2ae7f 648 * @ingroup API
AjK 12:8c7394e2ae7f 649 * @return A byte from the RX buffer or Result::NoChar (-1) if bufer empty.
AjK 12:8c7394e2ae7f 650 */
AjK 12:8c7394e2ae7f 651 int getcNb() { return __getc(false); }
AjK 12:8c7394e2ae7f 652
AjK 12:8c7394e2ae7f 653 /**
AjK 12:8c7394e2ae7f 654 * Function: getc
AjK 12:8c7394e2ae7f 655 *
AjK 12:8c7394e2ae7f 656 * Overloaded version of Serial::getc()
AjK 12:8c7394e2ae7f 657 *
AjK 12:8c7394e2ae7f 658 * This function blocks (if the RX buffer is empty the function will wait for a
AjK 12:8c7394e2ae7f 659 * character to arrive and then return that character).
AjK 12:8c7394e2ae7f 660 *
AjK 12:8c7394e2ae7f 661 * @ingroup API
AjK 12:8c7394e2ae7f 662 * @return A byte from the RX buffer
AjK 12:8c7394e2ae7f 663 */
AjK 12:8c7394e2ae7f 664 int getc() { return __getc(true); }
AjK 12:8c7394e2ae7f 665
AjK 12:8c7394e2ae7f 666 /**
AjK 12:8c7394e2ae7f 667 * Function: txGetLastChar
AjK 12:8c7394e2ae7f 668 *
AjK 12:8c7394e2ae7f 669 * Rteurn the last byte to pass through the TX interrupt handler.
AjK 12:8c7394e2ae7f 670 *
AjK 12:8c7394e2ae7f 671 * @ingroup MISC
AjK 12:8c7394e2ae7f 672 * @return The byte
AjK 12:8c7394e2ae7f 673 */
AjK 12:8c7394e2ae7f 674 char txGetLastChar(void) { return txc; }
AjK 12:8c7394e2ae7f 675
AjK 12:8c7394e2ae7f 676 /**
AjK 12:8c7394e2ae7f 677 * Function: rxGetLastChar
AjK 12:8c7394e2ae7f 678 *
AjK 12:8c7394e2ae7f 679 * Return the last byte to pass through the RX interrupt handler.
AjK 12:8c7394e2ae7f 680 *
AjK 12:8c7394e2ae7f 681 * @ingroup MISC
AjK 12:8c7394e2ae7f 682 * @return The byte
AjK 12:8c7394e2ae7f 683 */
AjK 12:8c7394e2ae7f 684 char rxGetLastChar(void) { return rxc; }
AjK 12:8c7394e2ae7f 685
Sissors 27:9c93ce7cb9d8 686
AjK 12:8c7394e2ae7f 687
AjK 12:8c7394e2ae7f 688 /**
AjK 16:8b1dbf4cce4e 689 * Function: autoDetectChar
AjK 12:8c7394e2ae7f 690 *
AjK 12:8c7394e2ae7f 691 * Set the char that, if seen incoming, invokes the AutoDetectChar callback.
AjK 12:8c7394e2ae7f 692 *
AjK 12:8c7394e2ae7f 693 * @ingroup API
AjK 12:8c7394e2ae7f 694 * @param int c The character to detect.
AjK 12:8c7394e2ae7f 695 */
AjK 16:8b1dbf4cce4e 696 void autoDetectChar(char c) { auto_detect_char = c; }
AjK 12:8c7394e2ae7f 697
AjK 12:8c7394e2ae7f 698 /**
AjK 12:8c7394e2ae7f 699 * Function: move
AjK 12:8c7394e2ae7f 700 *
AjK 12:8c7394e2ae7f 701 * Move contents of RX buffer to external buffer. Stops if "end" detected.
AjK 12:8c7394e2ae7f 702 *
AjK 12:8c7394e2ae7f 703 * @ingroup API
AjK 12:8c7394e2ae7f 704 * @param char *s The destination buffer address
AjK 12:8c7394e2ae7f 705 * @param int max The maximum number of chars to move.
AjK 12:8c7394e2ae7f 706 * @param char end If this char is detected stop moving.
AjK 12:8c7394e2ae7f 707 */
AjK 12:8c7394e2ae7f 708 int move(char *s, int max, char end) {
AjK 12:8c7394e2ae7f 709 int counter = 0;
AjK 12:8c7394e2ae7f 710 char c;
AjK 12:8c7394e2ae7f 711 while(readable()) {
AjK 12:8c7394e2ae7f 712 c = getc();
AjK 12:8c7394e2ae7f 713 if (c == end) break;
AjK 12:8c7394e2ae7f 714 *(s++) = c;
AjK 12:8c7394e2ae7f 715 counter++;
AjK 12:8c7394e2ae7f 716 if (counter == max) break;
AjK 12:8c7394e2ae7f 717 }
AjK 12:8c7394e2ae7f 718 return counter;
AjK 12:8c7394e2ae7f 719 }
AjK 12:8c7394e2ae7f 720
AjK 12:8c7394e2ae7f 721 /**
AjK 12:8c7394e2ae7f 722 * Function: move (overloaded)
AjK 12:8c7394e2ae7f 723 *
AjK 12:8c7394e2ae7f 724 * Move contents of RX buffer to external buffer. Stops if auto_detect_char detected.
AjK 12:8c7394e2ae7f 725 *
AjK 12:8c7394e2ae7f 726 * @ingroup API
AjK 12:8c7394e2ae7f 727 * @param int max The maximum number of chars to move.
AjK 12:8c7394e2ae7f 728 * @param char *s The destination buffer address
AjK 12:8c7394e2ae7f 729 */
AjK 12:8c7394e2ae7f 730 int move(char *s, int max) {
AjK 12:8c7394e2ae7f 731 return move(s, max, auto_detect_char);
AjK 12:8c7394e2ae7f 732 }
AjK 12:8c7394e2ae7f 733
Sissors 30:913b04338760 734 /**
AjK 12:8c7394e2ae7f 735 * Function: putc
AjK 12:8c7394e2ae7f 736 *
AjK 12:8c7394e2ae7f 737 * Write a character
AjK 12:8c7394e2ae7f 738 *
AjK 12:8c7394e2ae7f 739 * @see http://mbed.org/projects/libraries/api/mbed/trunk/Serial#Serial.putc
AjK 12:8c7394e2ae7f 740 * @ingroup API
AjK 12:8c7394e2ae7f 741 * @param c The character to write to the serial port
AjK 12:8c7394e2ae7f 742 */
Sissors 30:913b04338760 743 int putc(int c) {
Sissors 30:913b04338760 744 _putc(c);
Sissors 30:913b04338760 745 return c;
Sissors 30:913b04338760 746 }
Sissors 30:913b04338760 747
Sissors 30:913b04338760 748 /**
Sissors 30:913b04338760 749 * Function: puts
Sissors 30:913b04338760 750 *
Sissors 30:913b04338760 751 * Write a string
Sissors 30:913b04338760 752 *
Sissors 30:913b04338760 753 * @ingroup API
Sissors 30:913b04338760 754 * @param s The string to write to the serial port
Sissors 30:913b04338760 755 */
Sissors 30:913b04338760 756 int puts(char *string) {
Sissors 30:913b04338760 757 int i = 0;
Sissors 30:913b04338760 758 while (string[i]!='\0') {
Sissors 30:913b04338760 759 putc(string[i]);
Sissors 30:913b04338760 760 i++;
Sissors 30:913b04338760 761 }
Sissors 30:913b04338760 762 return 1;
Sissors 30:913b04338760 763 }
Sissors 30:913b04338760 764
Sissors 30:913b04338760 765 /**
Sissors 30:913b04338760 766 * Function: printf
Sissors 30:913b04338760 767 *
Sissors 30:913b04338760 768 * Write a formatted string
Sissors 30:913b04338760 769 *
Sissors 30:913b04338760 770 * @ingroup API
Sissors 30:913b04338760 771 * @param ---
Sissors 30:913b04338760 772 *
Sissors 30:913b04338760 773 int printf(const char* format, ...) {
Sissors 30:913b04338760 774 std::va_list arg;
Sissors 30:913b04338760 775 va_start(arg, format);
Sissors 30:913b04338760 776 char buffer[30];
Sissors 30:913b04338760 777 int r = snprintf(buffer, 30, format, arg);
Sissors 30:913b04338760 778 va_end(arg);
Sissors 30:913b04338760 779 puts(buffer);
Sissors 30:913b04338760 780 return r;
Sissors 30:913b04338760 781
Sissors 30:913b04338760 782 }
Sissors 30:913b04338760 783 */
AjK 12:8c7394e2ae7f 784
AjK 12:8c7394e2ae7f 785 #if 0 // Inhereted from Serial/Stream, for documentation only
AjK 12:8c7394e2ae7f 786 /**
AjK 12:8c7394e2ae7f 787 * Function: printf
AjK 12:8c7394e2ae7f 788 *
AjK 12:8c7394e2ae7f 789 * Write a formated string
AjK 12:8c7394e2ae7f 790 * Inhereted from Serial/Stream
AjK 12:8c7394e2ae7f 791 *
AjK 12:8c7394e2ae7f 792 * @see http://mbed.org/projects/libraries/api/mbed/trunk/Serial#Serial.printf
AjK 12:8c7394e2ae7f 793 * @ingroup API
AjK 12:8c7394e2ae7f 794 * @param format A printf-style format string, followed by the variables to use in formating the string.
AjK 12:8c7394e2ae7f 795 */
AjK 12:8c7394e2ae7f 796 int printf(const char* format, ...);
AjK 12:8c7394e2ae7f 797 #endif
AjK 12:8c7394e2ae7f 798
AjK 12:8c7394e2ae7f 799 #if 0 // Inhereted from Serial/Stream, for documentation only
AjK 12:8c7394e2ae7f 800 /**
AjK 12:8c7394e2ae7f 801 * Function: scanf
AjK 12:8c7394e2ae7f 802 *
AjK 12:8c7394e2ae7f 803 * Read a formated string
AjK 12:8c7394e2ae7f 804 * Inhereted from Serial/Stream
AjK 12:8c7394e2ae7f 805 *
AjK 12:8c7394e2ae7f 806 * @see http://mbed.org/projects/libraries/api/mbed/trunk/Serial#Serial.scanf
AjK 12:8c7394e2ae7f 807 * @ingroup API
AjK 12:8c7394e2ae7f 808 * @param format - A scanf-style format string, followed by the pointers to variables to store the results.
AjK 12:8c7394e2ae7f 809 */
AjK 12:8c7394e2ae7f 810 int scanf(const char* format, ...);
AjK 12:8c7394e2ae7f 811 #endif
AjK 18:21ef26402365 812
AjK 18:21ef26402365 813 protected:
AjK 18:21ef26402365 814 /**
AjK 18:21ef26402365 815 * Used to pass information to callbacks.
AjK 18:21ef26402365 816 * @ingroup INTERNALS
AjK 18:21ef26402365 817 */
AjK 18:21ef26402365 818 MODSERIAL_IRQ_INFO callbackInfo;
AjK 18:21ef26402365 819
AjK 18:21ef26402365 820 /**
AjK 18:21ef26402365 821 * Remove the last char placed into the rx buffer.
AjK 18:21ef26402365 822 * This is an operation that can only be performed
AjK 18:21ef26402365 823 * by an rxCallback function. To protect the buffers
AjK 18:21ef26402365 824 * this function is defined protected so that a
AjK 18:21ef26402365 825 * regular application cannot call it directly. It
AjK 18:21ef26402365 826 * can only be called by the public version within a
AjK 18:21ef26402365 827 * MODSERIAL_IRQ_INFO class.
AjK 18:21ef26402365 828 * @ingroup INTERNALS
AjK 18:21ef26402365 829 * @return The byte removed from the buffer.
AjK 18:21ef26402365 830 */
AjK 18:21ef26402365 831 int rxDiscardLastChar(void);
AjK 12:8c7394e2ae7f 832
AjK 18:21ef26402365 833 private:
AjK 12:8c7394e2ae7f 834
AjK 12:8c7394e2ae7f 835 /**
AjK 12:8c7394e2ae7f 836 * A pointer to the UART peripheral base address being used.
AjK 12:8c7394e2ae7f 837 * @ingroup INTERNALS
AjK 12:8c7394e2ae7f 838 */
AjK 12:8c7394e2ae7f 839 void *_base;
AjK 12:8c7394e2ae7f 840
AjK 12:8c7394e2ae7f 841 /**
AjK 12:8c7394e2ae7f 842 * The last byte to pass through the TX IRQ handler.
AjK 12:8c7394e2ae7f 843 * @ingroup INTERNALS
AjK 12:8c7394e2ae7f 844 */
AjK 12:8c7394e2ae7f 845 volatile char txc;
AjK 12:8c7394e2ae7f 846
AjK 12:8c7394e2ae7f 847 /**
AjK 12:8c7394e2ae7f 848 * The last byte to pass through the RX IRQ handler.
AjK 12:8c7394e2ae7f 849 * @ingroup INTERNALS
AjK 12:8c7394e2ae7f 850 */
AjK 12:8c7394e2ae7f 851 volatile char rxc;
AjK 12:8c7394e2ae7f 852
AjK 12:8c7394e2ae7f 853 /**
AjK 12:8c7394e2ae7f 854 * Pointers to the TX and RX buffers.
AjK 12:8c7394e2ae7f 855 * @ingroup INTERNALS
AjK 12:8c7394e2ae7f 856 */
AjK 12:8c7394e2ae7f 857 volatile char *buffer[2];
AjK 12:8c7394e2ae7f 858
AjK 12:8c7394e2ae7f 859 /**
AjK 12:8c7394e2ae7f 860 * Buffer in pointers.
AjK 12:8c7394e2ae7f 861 * @ingroup INTERNALS
AjK 12:8c7394e2ae7f 862 */
AjK 12:8c7394e2ae7f 863 volatile int buffer_in[2];
AjK 12:8c7394e2ae7f 864
AjK 12:8c7394e2ae7f 865 /**
AjK 12:8c7394e2ae7f 866 * Buffer out pointers.
AjK 12:8c7394e2ae7f 867 * @ingroup INTERNALS
AjK 12:8c7394e2ae7f 868 */
AjK 12:8c7394e2ae7f 869 volatile int buffer_out[2];
AjK 12:8c7394e2ae7f 870
AjK 12:8c7394e2ae7f 871 /**
AjK 12:8c7394e2ae7f 872 * Buffer lengths.
AjK 12:8c7394e2ae7f 873 * @ingroup INTERNALS
AjK 12:8c7394e2ae7f 874 */
AjK 12:8c7394e2ae7f 875 volatile int buffer_size[2];
AjK 12:8c7394e2ae7f 876
AjK 12:8c7394e2ae7f 877 /**
AjK 12:8c7394e2ae7f 878 * Buffer content counters.
AjK 12:8c7394e2ae7f 879 * @ingroup INTERNALS
AjK 12:8c7394e2ae7f 880 */
AjK 12:8c7394e2ae7f 881 volatile int buffer_count[2];
AjK 12:8c7394e2ae7f 882
AjK 12:8c7394e2ae7f 883 /**
AjK 12:8c7394e2ae7f 884 * Buffer overflow.
AjK 12:8c7394e2ae7f 885 * @ingroup INTERNALS
AjK 12:8c7394e2ae7f 886 */
AjK 12:8c7394e2ae7f 887 volatile int buffer_overflow[2];
AjK 12:8c7394e2ae7f 888
AjK 12:8c7394e2ae7f 889 /**
AjK 12:8c7394e2ae7f 890 * Auto-detect character.
AjK 12:8c7394e2ae7f 891 * @ingroup INTERNALS
AjK 12:8c7394e2ae7f 892 */
AjK 12:8c7394e2ae7f 893 volatile char auto_detect_char;
AjK 12:8c7394e2ae7f 894
AjK 12:8c7394e2ae7f 895 /**
AjK 12:8c7394e2ae7f 896 * Callback system.
AjK 12:8c7394e2ae7f 897 * @ingroup INTERNALS
AjK 12:8c7394e2ae7f 898 */
AjK 18:21ef26402365 899 MODSERIAL_callback _isr[NumOfIrqTypes];
AjK 12:8c7394e2ae7f 900
AjK 12:8c7394e2ae7f 901 /**
AjK 12:8c7394e2ae7f 902 * TX Interrupt Service Routine.
AjK 12:8c7394e2ae7f 903 * @ingroup INTERNALS
AjK 12:8c7394e2ae7f 904 */
AjK 12:8c7394e2ae7f 905 void isr_tx(bool doCallback);
AjK 12:8c7394e2ae7f 906
AjK 12:8c7394e2ae7f 907 /**
AjK 12:8c7394e2ae7f 908 * TX Interrupt Service Routine stub version.
AjK 12:8c7394e2ae7f 909 * @ingroup INTERNALS
AjK 12:8c7394e2ae7f 910 */
AjK 12:8c7394e2ae7f 911 void isr_tx(void) { isr_tx(true); }
AjK 12:8c7394e2ae7f 912
AjK 12:8c7394e2ae7f 913
AjK 12:8c7394e2ae7f 914 /**
AjK 12:8c7394e2ae7f 915 * RX Interrupt Service Routine.
AjK 12:8c7394e2ae7f 916 * @ingroup INTERNALS
AjK 12:8c7394e2ae7f 917 */
AjK 12:8c7394e2ae7f 918 void isr_rx(void);
AjK 12:8c7394e2ae7f 919
Sissors 27:9c93ce7cb9d8 920 /**
AjK 12:8c7394e2ae7f 921 * Get a character from the RX buffer
AjK 12:8c7394e2ae7f 922 * @ingroup INTERNALS
AjK 12:8c7394e2ae7f 923 * @param bool True to block (wait for input)
AjK 12:8c7394e2ae7f 924 * @return A byte from the buffer.
AjK 12:8c7394e2ae7f 925 */
AjK 12:8c7394e2ae7f 926 int __getc(bool);
AjK 12:8c7394e2ae7f 927
AjK 12:8c7394e2ae7f 928 /**
AjK 12:8c7394e2ae7f 929 * Put a character from the TX buffer
AjK 12:8c7394e2ae7f 930 * @ingroup INTERNALS
AjK 12:8c7394e2ae7f 931 * @param bool True to block (wait for space in the TX buffer if full)
AjK 12:8c7394e2ae7f 932 * @return 0 on success
AjK 12:8c7394e2ae7f 933 */
AjK 12:8c7394e2ae7f 934 int __putc(int c, bool);
AjK 12:8c7394e2ae7f 935
AjK 12:8c7394e2ae7f 936 /**
AjK 12:8c7394e2ae7f 937 * Function: _putc
AjK 12:8c7394e2ae7f 938 * Overloaded virtual function.
AjK 12:8c7394e2ae7f 939 */
AjK 12:8c7394e2ae7f 940 virtual int _putc(int c) { return __putc(c, true); }
AjK 12:8c7394e2ae7f 941
AjK 12:8c7394e2ae7f 942 /**
AjK 12:8c7394e2ae7f 943 * Function: _getc
AjK 12:8c7394e2ae7f 944 * Overloaded virtual function.
AjK 12:8c7394e2ae7f 945 */
AjK 12:8c7394e2ae7f 946 virtual int _getc() { return __getc(true); }
AjK 12:8c7394e2ae7f 947
AjK 12:8c7394e2ae7f 948 /**
AjK 12:8c7394e2ae7f 949 * Function: init
AjK 12:8c7394e2ae7f 950 * Initialize the MODSERIAL object
AjK 12:8c7394e2ae7f 951 * @ingroup INTERNALS
AjK 12:8c7394e2ae7f 952 */
AjK 24:9c456e647a8f 953 void init(int txSize, int rxSize, PinName rx);
AjK 12:8c7394e2ae7f 954
AjK 12:8c7394e2ae7f 955 /**
AjK 12:8c7394e2ae7f 956 * Function: flushBuffer
AjK 12:8c7394e2ae7f 957 * @ingroup INTERNALS
AjK 12:8c7394e2ae7f 958 */
AjK 12:8c7394e2ae7f 959 void flushBuffer(IrqType type);
AjK 12:8c7394e2ae7f 960
AjK 12:8c7394e2ae7f 961 /**
AjK 12:8c7394e2ae7f 962 * Function: resizeBuffer
AjK 12:8c7394e2ae7f 963 * @ingroup INTERNALS
AjK 12:8c7394e2ae7f 964 */
AjK 12:8c7394e2ae7f 965 int resizeBuffer(int size, IrqType type = RxIrq, bool memory_check = true);
AjK 12:8c7394e2ae7f 966
AjK 12:8c7394e2ae7f 967 /**
AjK 12:8c7394e2ae7f 968 * Function: downSizeBuffer
AjK 12:8c7394e2ae7f 969 * @ingroup INTERNALS
AjK 12:8c7394e2ae7f 970 */
AjK 12:8c7394e2ae7f 971 int downSizeBuffer(int size, IrqType type, bool memory_check);
AjK 12:8c7394e2ae7f 972
AjK 12:8c7394e2ae7f 973 /**
AjK 12:8c7394e2ae7f 974 * Function: upSizeBuffer
AjK 12:8c7394e2ae7f 975 * @ingroup INTERNALS
AjK 12:8c7394e2ae7f 976 */
AjK 12:8c7394e2ae7f 977 int upSizeBuffer(int size, IrqType type, bool memory_check);
AjK 12:8c7394e2ae7f 978
AjK 12:8c7394e2ae7f 979 /*
AjK 12:8c7394e2ae7f 980 * If MODDMA is available the compile in code to handle sending
AjK 12:8c7394e2ae7f 981 * an arbitary char buffer. Note, the parts before teh #ifdef
AjK 12:8c7394e2ae7f 982 * are declared so that MODSERIAL can access then even if MODDMA
AjK 12:8c7394e2ae7f 983 * isn't avaiable. Since MODDMA.h is only available at this point
AjK 12:8c7394e2ae7f 984 * all DMA functionality must be declared inline in the class
AjK 12:8c7394e2ae7f 985 * definition.
AjK 12:8c7394e2ae7f 986 */
AjK 12:8c7394e2ae7f 987 public:
AjK 12:8c7394e2ae7f 988
AjK 12:8c7394e2ae7f 989 int dmaSendChannel;
AjK 12:8c7394e2ae7f 990 void *moddma_p;
AjK 12:8c7394e2ae7f 991
AjK 12:8c7394e2ae7f 992 #ifdef MODDMA_H
AjK 12:8c7394e2ae7f 993
AjK 17:6c9b57c14868 994 MODDMA_Config *config;
AjK 17:6c9b57c14868 995
AjK 12:8c7394e2ae7f 996 /**
AjK 12:8c7394e2ae7f 997 * Set the "void pointer" moddma_p to be a pointer to a
AjK 12:8c7394e2ae7f 998 * MODDMA controller class instance. Used to manage the
AjK 12:8c7394e2ae7f 999 * data transfer of DMA configurations.
AjK 12:8c7394e2ae7f 1000 *
AjK 12:8c7394e2ae7f 1001 * @ingroup API
AjK 12:8c7394e2ae7f 1002 * @param p A pointer to "the" instance of MODDMA.
AjK 12:8c7394e2ae7f 1003 */
AjK 12:8c7394e2ae7f 1004 void MODDMA(MODDMA *p) { moddma_p = p; }
AjK 12:8c7394e2ae7f 1005
AjK 12:8c7394e2ae7f 1006 /**
AjK 12:8c7394e2ae7f 1007 * Send a char buffer to the Uarts TX system
AjK 12:8c7394e2ae7f 1008 * using DMA. This blocks regular library
AjK 12:8c7394e2ae7f 1009 * sending.
AjK 12:8c7394e2ae7f 1010 *
AjK 12:8c7394e2ae7f 1011 * @param buffer A char buffer of bytes to send.
AjK 12:8c7394e2ae7f 1012 * @param len The length of the buffer to send.
AjK 12:8c7394e2ae7f 1013 * @param dmaChannel The DMA channel to use, defaults to 7
AjK 12:8c7394e2ae7f 1014 * @return MODDMA::Status MODDMA::ok if all went ok
AjK 12:8c7394e2ae7f 1015 */
AjK 12:8c7394e2ae7f 1016 int dmaSend(char *buffer, int len, int dmaChannel = 7)
AjK 12:8c7394e2ae7f 1017 {
AjK 12:8c7394e2ae7f 1018 if (moddma_p == (void *)NULL) return -2;
AjK 12:8c7394e2ae7f 1019 class MODDMA *dma = (class MODDMA *)moddma_p;
AjK 12:8c7394e2ae7f 1020
AjK 12:8c7394e2ae7f 1021 dmaSendChannel = dmaChannel & 0x7;
AjK 12:8c7394e2ae7f 1022
AjK 12:8c7394e2ae7f 1023 uint32_t conn = MODDMA::UART0_Tx;
Sissors 26:91e4dba7ebe2 1024 switch(_serial.index) {
AjK 12:8c7394e2ae7f 1025 case 0: conn = MODDMA::UART0_Tx; break;
AjK 12:8c7394e2ae7f 1026 case 1: conn = MODDMA::UART1_Tx; break;
AjK 12:8c7394e2ae7f 1027 case 2: conn = MODDMA::UART2_Tx; break;
AjK 12:8c7394e2ae7f 1028 case 3: conn = MODDMA::UART3_Tx; break;
AjK 12:8c7394e2ae7f 1029 }
AjK 12:8c7394e2ae7f 1030
AjK 17:6c9b57c14868 1031 config = new MODDMA_Config;
AjK 12:8c7394e2ae7f 1032 config
AjK 12:8c7394e2ae7f 1033 ->channelNum ( (MODDMA::CHANNELS)(dmaSendChannel & 0x7) )
AjK 12:8c7394e2ae7f 1034 ->srcMemAddr ( (uint32_t) buffer )
AjK 12:8c7394e2ae7f 1035 ->transferSize ( len )
AjK 12:8c7394e2ae7f 1036 ->transferType ( MODDMA::m2p )
AjK 12:8c7394e2ae7f 1037 ->dstConn ( conn )
AjK 12:8c7394e2ae7f 1038 ->attach_tc ( this, &MODSERIAL::dmaSendCallback )
AjK 12:8c7394e2ae7f 1039 ->attach_err ( this, &MODSERIAL::dmaSendCallback )
AjK 12:8c7394e2ae7f 1040 ; // config end
AjK 12:8c7394e2ae7f 1041
AjK 12:8c7394e2ae7f 1042 // Setup the configuration.
AjK 17:6c9b57c14868 1043 if (dma->Setup(config) == 0) {
AjK 12:8c7394e2ae7f 1044 return -1;
AjK 12:8c7394e2ae7f 1045 }
AjK 12:8c7394e2ae7f 1046
AjK 12:8c7394e2ae7f 1047 //dma.Enable( MODDMA::Channel_0 );
AjK 12:8c7394e2ae7f 1048 dma->Enable( config->channelNum() );
AjK 12:8c7394e2ae7f 1049 return MODDMA::Ok;
AjK 12:8c7394e2ae7f 1050 }
AjK 12:8c7394e2ae7f 1051
AjK 12:8c7394e2ae7f 1052 /**
AjK 12:8c7394e2ae7f 1053 * Attach a callback to the DMA completion.
AjK 12:8c7394e2ae7f 1054 *
AjK 12:8c7394e2ae7f 1055 * @ingroup API
AjK 12:8c7394e2ae7f 1056 * @param fptr A function pointer to call
AjK 12:8c7394e2ae7f 1057 * @return this
AjK 12:8c7394e2ae7f 1058 */
AjK 18:21ef26402365 1059 void attach_dmaSendComplete(void (*fptr)(MODSERIAL_IRQ_INFO *)) {
AjK 12:8c7394e2ae7f 1060 _isrDmaSendComplete.attach(fptr);
AjK 12:8c7394e2ae7f 1061 }
AjK 12:8c7394e2ae7f 1062
AjK 12:8c7394e2ae7f 1063 /**
AjK 12:8c7394e2ae7f 1064 * Attach a callback to the DMA completion.
AjK 12:8c7394e2ae7f 1065 *
AjK 12:8c7394e2ae7f 1066 * @ingroup API
AjK 12:8c7394e2ae7f 1067 * @param tptr A template pointer to the calling object
AjK 12:8c7394e2ae7f 1068 * @param mptr A method pointer within the object to call.
AjK 12:8c7394e2ae7f 1069 * @return this
AjK 12:8c7394e2ae7f 1070 */
AjK 12:8c7394e2ae7f 1071 template<typename T>
AjK 18:21ef26402365 1072 void attach_dmaSendComplete(T* tptr, void (T::*mptr)(MODSERIAL_IRQ_INFO *)) {
AjK 12:8c7394e2ae7f 1073 if((mptr != NULL) && (tptr != NULL)) {
AjK 12:8c7394e2ae7f 1074 _isrDmaSendComplete.attach(tptr, mptr);
AjK 12:8c7394e2ae7f 1075 }
AjK 12:8c7394e2ae7f 1076 }
AjK 12:8c7394e2ae7f 1077
AjK 18:21ef26402365 1078 MODSERIAL_callback _isrDmaSendComplete;
AjK 12:8c7394e2ae7f 1079
AjK 12:8c7394e2ae7f 1080 protected:
AjK 12:8c7394e2ae7f 1081 /**
AjK 12:8c7394e2ae7f 1082 * Callback for dmaSend().
AjK 12:8c7394e2ae7f 1083 */
AjK 12:8c7394e2ae7f 1084 void dmaSendCallback(void)
AjK 12:8c7394e2ae7f 1085 {
AjK 12:8c7394e2ae7f 1086 if (moddma_p == (void *)NULL) return;
AjK 12:8c7394e2ae7f 1087 class MODDMA *dma = (class MODDMA *)moddma_p;
AjK 12:8c7394e2ae7f 1088
AjK 12:8c7394e2ae7f 1089 MODDMA_Config *config = dma->getConfig();
AjK 12:8c7394e2ae7f 1090 dma->haltAndWaitChannelComplete( (MODDMA::CHANNELS)config->channelNum());
AjK 12:8c7394e2ae7f 1091 dma->Disable( (MODDMA::CHANNELS)config->channelNum() );
AjK 12:8c7394e2ae7f 1092 if (dma->irqType() == MODDMA::TcIrq) dma->clearTcIrq();
AjK 12:8c7394e2ae7f 1093 if (dma->irqType() == MODDMA::ErrIrq) dma->clearErrIrq();
AjK 12:8c7394e2ae7f 1094 dmaSendChannel = -1;
AjK 18:21ef26402365 1095 _isrDmaSendComplete.call(&this->callbackInfo);
AjK 17:6c9b57c14868 1096 delete(config);
AjK 12:8c7394e2ae7f 1097 }
AjK 12:8c7394e2ae7f 1098
AjK 12:8c7394e2ae7f 1099 #endif // MODDMA_H
AjK 12:8c7394e2ae7f 1100
Sissors 27:9c93ce7cb9d8 1101
Sissors 27:9c93ce7cb9d8 1102 //DEVICE SPECIFIC FUNCTIONS:
Sissors 28:76793a84f9e5 1103 private:
Sissors 28:76793a84f9e5 1104 /**
Sissors 28:76793a84f9e5 1105 * Set pointers to UART and IRQ
Sissors 28:76793a84f9e5 1106 */
Sissors 27:9c93ce7cb9d8 1107 void setBase( void );
Sissors 27:9c93ce7cb9d8 1108
Sissors 28:76793a84f9e5 1109 /**
Sissors 28:76793a84f9e5 1110 * If required, allows for adding specific settings
Sissors 28:76793a84f9e5 1111 */
Sissors 28:76793a84f9e5 1112 void initDevice( void );
Sissors 28:76793a84f9e5 1113
Sissors 27:9c93ce7cb9d8 1114 IRQn_Type _IRQ;
Sissors 27:9c93ce7cb9d8 1115
Sissors 27:9c93ce7cb9d8 1116 public:
Sissors 27:9c93ce7cb9d8 1117 /**
Sissors 27:9c93ce7cb9d8 1118 * Function: txIsBusy
Sissors 27:9c93ce7cb9d8 1119 *
Sissors 27:9c93ce7cb9d8 1120 * If the Uart is still actively sending characters this
Sissors 27:9c93ce7cb9d8 1121 * function will return true.
Sissors 27:9c93ce7cb9d8 1122 *
Sissors 27:9c93ce7cb9d8 1123 * @ingroup API
Sissors 27:9c93ce7cb9d8 1124 * @return bool
Sissors 27:9c93ce7cb9d8 1125 */
Sissors 27:9c93ce7cb9d8 1126 bool txIsBusy(void);
Sissors 27:9c93ce7cb9d8 1127
Sissors 27:9c93ce7cb9d8 1128
AjK 12:8c7394e2ae7f 1129 };
AjK 12:8c7394e2ae7f 1130
AjK 12:8c7394e2ae7f 1131 }; // namespace AjK ends
AjK 12:8c7394e2ae7f 1132
AjK 12:8c7394e2ae7f 1133 using namespace AjK;
AjK 12:8c7394e2ae7f 1134
AjK 12:8c7394e2ae7f 1135 #endif