BlazeX . / SerialDriver Featured

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.

Last commit 20 Feb 2019 by mbed official

Import librarymbed-rtos

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

Last commit 04 Jul 2017 by mbed official

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.

Examples/Example_Blocking.cpp@8:903a4162a0d1, 2015-10-29 (annotated)

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_Blocking.cpp
BlazeX 0:cd0d79be0c1a 2 /// @brief Test blocking write / read
BlazeX 0:cd0d79be0c1a 3 ///
BlazeX 0:cd0d79be0c1a 4 /// - Uses SerialDriver with USBTX and USBRX.
BlazeX 0:cd0d79be0c1a 5 /// - Has much too small buffers, to how far can it get?
BlazeX 0:cd0d79be0c1a 6 ///
BlazeX 0:cd0d79be0c1a 7 /// - Testing how much bytes were transmitted, with too small TX buffer and forced non blocking
BlazeX 0:cd0d79be0c1a 8 /// - Waiting till 10 bytes are received
BlazeX 0:cd0d79be0c1a 9 /// - LED4 indicates parallel thread working
BlazeX 0:cd0d79be0c1a 10 ///
BlazeX 0:cd0d79be0c1a 11
BlazeX 0:cd0d79be0c1a 12 #if 0
BlazeX 0:cd0d79be0c1a 13
BlazeX 0:cd0d79be0c1a 14 #include "SerialDriver.h"
BlazeX 0:cd0d79be0c1a 15
BlazeX 0:cd0d79be0c1a 16 SerialDriver pc(USBTX, USBRX, 4, 32);
BlazeX 0:cd0d79be0c1a 17
BlazeX 0:cd0d79be0c1a 18 // This thread is running in parallel
BlazeX 0:cd0d79be0c1a 19 DigitalOut led4(LED4);
BlazeX 0:cd0d79be0c1a 20 void parallel(void const * argument)
BlazeX 0:cd0d79be0c1a 21 {
BlazeX 0:cd0d79be0c1a 22 while(1)
BlazeX 0:cd0d79be0c1a 23 {
BlazeX 0:cd0d79be0c1a 24 Thread::wait(20);
BlazeX 0:cd0d79be0c1a 25 led4= !led4;
BlazeX 0:cd0d79be0c1a 26 }
BlazeX 0:cd0d79be0c1a 27 }
BlazeX 0:cd0d79be0c1a 28
BlazeX 0:cd0d79be0c1a 29 int main()
BlazeX 0:cd0d79be0c1a 30 {
BlazeX 0:cd0d79be0c1a 31 // Start the other thread
BlazeX 0:cd0d79be0c1a 32 Thread parallelTask(&parallel);
BlazeX 0:cd0d79be0c1a 33
BlazeX 0:cd0d79be0c1a 34
BlazeX 0:cd0d79be0c1a 35 const char * completeText= "This is a complete text. How much will you receive?";
BlazeX 0:cd0d79be0c1a 36 const int completeTextLength= strlen(completeText);
BlazeX 0:cd0d79be0c1a 37 int writtenBytes;
BlazeX 0:cd0d79be0c1a 38
BlazeX 0:cd0d79be0c1a 39
BlazeX 0:cd0d79be0c1a 40 const int readBufferLength= 10;
BlazeX 0:cd0d79be0c1a 41 unsigned char readBuffer[readBufferLength];
BlazeX 0:cd0d79be0c1a 42 int receivedBytes= 0;
BlazeX 0:cd0d79be0c1a 43
BlazeX 0:cd0d79be0c1a 44 while(1)
BlazeX 0:cd0d79be0c1a 45 {
BlazeX 0:cd0d79be0c1a 46 // write non blocking, how much get transmitted?
BlazeX 0:cd0d79be0c1a 47 writtenBytes= pc.write((const unsigned char*)completeText, completeTextLength, false);
BlazeX 0:cd0d79be0c1a 48
BlazeX 0:cd0d79be0c1a 49 // now print the result
BlazeX 0:cd0d79be0c1a 50 pc.printf("\r\nOnly %i of %i bytes were transmitted using non blocking write.\r\n", writtenBytes, completeTextLength);
BlazeX 0:cd0d79be0c1a 51
BlazeX 0:cd0d79be0c1a 52
BlazeX 0:cd0d79be0c1a 53 // wait for 10 bytes
BlazeX 0:cd0d79be0c1a 54 pc.printf("I wait for my 10 bytes. Send them!\r\n", writtenBytes, completeTextLength);
BlazeX 0:cd0d79be0c1a 55 receivedBytes+= pc.read(readBuffer, readBufferLength);
BlazeX 0:cd0d79be0c1a 56
BlazeX 0:cd0d79be0c1a 57 // now print result
BlazeX 0:cd0d79be0c1a 58 pc.printf("Received %i bytes since start.\r\n\r\n", receivedBytes);
BlazeX 0:cd0d79be0c1a 59
BlazeX 0:cd0d79be0c1a 60
BlazeX 0:cd0d79be0c1a 61 // wait a bit
BlazeX 0:cd0d79be0c1a 62 Thread::wait(1000);
BlazeX 0:cd0d79be0c1a 63 }
BlazeX 0:cd0d79be0c1a 64 }
BlazeX 0:cd0d79be0c1a 65
BlazeX 0:cd0d79be0c1a 66 #endif