Bringing MBed serial ports back like it's 1999... or at least 2019.
Dependents: CC1200-MorseEncoder AccurateWaiter-Test
SerialStream adapts an MBed 6.0 serial port class into a Stream instance. This lets you do two useful things with it:
- Call printf() and scanf() on it
- Pass it to code that expects a Stream to print things on. This should help adapt code written for older versions of MBed with a minimum of pain.
Example code:
Hello world program with SerialStream
#include <mbed.h> #include "SerialStream.h" BufferedSerial serial(USBTX, USBRX, 115200); SerialStream<BufferedSerial> pc(serial); int main() { while(true) { pc.printf("Hello world!\n"); ThisThread::sleep_for(1s); } }
Why Serial was deprecated
Using a Stream does introduce some additional overhead into your code, and this was part of the reason the new serial classes did not implement Stream. However, this is unlikely to make a difference in many applications.
There is also a newer way to use printf() with BufferedSerial using fdopen():
Hello world program with mbed 6 serial
#include <mbed.h> BufferedSerial serial(USBTX, USBRX, 115200); FILE * pc; int main() { pc = fdopen(&serial, "r+"); while(true) { fprintf(pc, "Hello world!\n"); ThisThread::sleep_for(1s); } }
This takes advantage of Mbed's FileHandle API and its integration with the C library. Any class that implements FileHandle can be opened as a C FILE
.
This method (along with some other interesting info) can be found in the PR that deprecated Serial. In my opinion, this is something that ARM has done an atrocious job of documenting and it’s criminal that the only place I found this information was by digging through closed PRs! (though it’s also buried in the FileHandle docs if you look hard enough)
SerialStream.h
- Committer:
- Jamie Smith
- Date:
- 2020-08-25
- Revision:
- 1:9437ea7d0799
- Parent:
- 0:889cfd2df4cd
- Child:
- 2:3736580f2dbe
File content as of revision 1:9437ea7d0799:
#ifndef SERIALSTREAM_H #define SERIALSTREAM_H #include <mbed.h> #include <platform/Stream.h> /** * SerialStream * Bringing MBed serial ports back like it's 1999... or at least 2019. * * This class adapts an MBed 6.0 serial port class into a Stream instance. * This lets you do two useful things with it: * - Call printf() and scanf() on it * - Pass it to code that expects a Stream to print things on. * */ template<class SerialClass> class SerialStream : public Stream { SerialClass & serialClass; public: /** * Create a SerialStream from a serial port. * @param _serialClass BufferedSerial or UnbufferedSerial instance * @param name The name of the stream associated with this serial port (optional) */ SerialStream(SerialClass & _serialClass, const char *name = nullptr): Stream(name), serialClass(_serialClass) { } private: // override Stream::read() and write() to call serial class directly. // This avoids the overhead of feeding in individual characters. virtual ssize_t write(const void *buffer, size_t length) { return serialClass.write(buffer, length); } virtual ssize_t read(void *buffer, size_t length) { return serialClass.read(buffer, length); } // Dummy implementations -- these will never be called because we override write() and read() instead. // but we have to override them since they're pure virtual. virtual int _putc(int c) { return 0; } virtual int _getc() { return 0; } }; #endif //SERIALSTREAM_H