Buffered Serial Port Driver for RTOS

Dependents:   nucleo_cannonball PiballNeoController

Buffered Serial Port Driver for RTOS

  • ISR driven, ring buffered IO operation
  • IO operations are idle waiting, don't waste time in RTOS :D
  • Can use external buffers
  • Based on mbed RawSerial

Example

SerialDriver Example

#include "SerialDriver.h"

SerialDriver pc(USBTX, USBRX);

int main()
{
    // setup serial port
    pc.baud(9600);
    
    // print some text
    pc.puts("This is just a string.\r\n");
    pc.printf("But this is a %s with integer %i and float %f.\r\n", "formatted text", 123, 0.456f);
    
    // now lets behave like a null modem 
    while(1)
       pc.putc(pc.getc());
}

Look at the API Documentation for more Examples.

Dependencies

Import librarymbed

The official Mbed 2 C/C++ SDK provides the software platform and libraries to build your applications.

Import librarymbed-rtos

Official mbed Real Time Operating System based on the RTX implementation of the CMSIS-RTOS API open standard.

If you find a bug, please help me to fix it. Send me a message. You can help me a lot: Write a demo program that causes the bug reproducible.

Committer:
BlazeX
Date:
Thu Oct 29 19:38:11 2015 +0000
Revision:
8:903a4162a0d1
Parent:
1:1464146bd7fb
Beta Update: Could SerialDriver inherit RawSerial rather than SerialBase? Maybe, let's try!

Who changed what in which revision?

UserRevisionLine numberNew contents of line
BlazeX 0:cd0d79be0c1a 1 /// @file Example_printf.cpp
BlazeX 0:cd0d79be0c1a 2 /// @brief Formatted output
BlazeX 0:cd0d79be0c1a 3 ///
BlazeX 0:cd0d79be0c1a 4 /// - Uses SerialDriver with USBTX and USBRX.
BlazeX 0:cd0d79be0c1a 5 /// - Has much too small buffers, but printf is blocking, so it does not matter
BlazeX 0:cd0d79be0c1a 6 ///
BlazeX 0:cd0d79be0c1a 7 /// - The terminal will be flooded with text
BlazeX 0:cd0d79be0c1a 8 /// - LED4 indicates parallel thread working
BlazeX 0:cd0d79be0c1a 9 ///
BlazeX 0:cd0d79be0c1a 10
BlazeX 0:cd0d79be0c1a 11 #if 0
BlazeX 0:cd0d79be0c1a 12
BlazeX 0:cd0d79be0c1a 13 #include "SerialDriver.h"
BlazeX 0:cd0d79be0c1a 14
BlazeX 0:cd0d79be0c1a 15 // only 4 byte of software ring buffer?
BlazeX 0:cd0d79be0c1a 16 // No problem! SerialDriver uses idle blocking calls :D
BlazeX 0:cd0d79be0c1a 17 SerialDriver pc(USBTX, USBRX, 4, 4);
BlazeX 0:cd0d79be0c1a 18
BlazeX 0:cd0d79be0c1a 19 // This thread is running in parallel
BlazeX 0:cd0d79be0c1a 20 DigitalOut led4(LED4);
BlazeX 0:cd0d79be0c1a 21 void parallel(void const * argument)
BlazeX 0:cd0d79be0c1a 22 {
BlazeX 0:cd0d79be0c1a 23 while(1)
BlazeX 0:cd0d79be0c1a 24 {
BlazeX 0:cd0d79be0c1a 25 Thread::wait(20);
BlazeX 0:cd0d79be0c1a 26 led4= !led4;
BlazeX 0:cd0d79be0c1a 27 }
BlazeX 0:cd0d79be0c1a 28 }
BlazeX 0:cd0d79be0c1a 29
BlazeX 0:cd0d79be0c1a 30 int main()
BlazeX 0:cd0d79be0c1a 31 {
BlazeX 0:cd0d79be0c1a 32 // Start the other thread
BlazeX 0:cd0d79be0c1a 33 Thread parallelTask(&parallel);
BlazeX 0:cd0d79be0c1a 34
BlazeX 0:cd0d79be0c1a 35 float f= 0.0f;
BlazeX 0:cd0d79be0c1a 36 while(1)
BlazeX 0:cd0d79be0c1a 37 {
BlazeX 0:cd0d79be0c1a 38 // unformatted text
BlazeX 0:cd0d79be0c1a 39 pc.puts("Hi! this uses puts.\r\n");
BlazeX 0:cd0d79be0c1a 40
BlazeX 0:cd0d79be0c1a 41 // formatted text
BlazeX 0:cd0d79be0c1a 42 pc.printf("And this is formatted. Here is the sin(%f)=%f.\r\n", f, sinf(f));
BlazeX 0:cd0d79be0c1a 43 f+= 0.25f;
BlazeX 0:cd0d79be0c1a 44 }
BlazeX 0:cd0d79be0c1a 45 }
BlazeX 0:cd0d79be0c1a 46
BlazeX 0:cd0d79be0c1a 47 #endif