Serial.h

/*
  Serial.h - wrapper over mbed RawSerial
  Part of Arduino - http://www.arduino.cc/

  Copyright (c) 2018-2019 Arduino SA

  This library is free software; you can redistribute it and/or
  modify it under the terms of the GNU Lesser General Public
  License as published by the Free Software Foundation; either
  version 2.1 of the License, or (at your option) any later version.

  This library is distributed in the hope that it will be useful,
  but WITHOUT ANY WARRANTY; without even the implied warranty of
  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  Lesser General Public License for more details.

  You should have received a copy of the GNU Lesser General
  Public License along with this library; if not, write to the
  Free Software Foundation, Inc., 59 Temple Place, Suite 330,
  Boston, MA  02111-1307  USA
*/

#include "api/RingBuffer.h"
#include "Arduino.h"
#include "api/HardwareSerial.h"
#include "PinNames.h"
#include <platform/FileHandle.h>

#ifdef __cplusplus

#ifndef __ARDUINO_UART_IMPLEMENTATION__
#define __ARDUINO_UART_IMPLEMENTATION__

typedef struct _mbed_serial mbed_serial;
typedef struct _mbed_usb_serial mbed_usb_serial;

namespace arduino {

class UART : public HardwareSerial {
	public:
		UART(int tx, int rx, int rts = -1, int cts = -1);
		UART(PinName tx, PinName rx, PinName rts = NC, PinName cts = NC) : _tx(tx), _rx(rx), _rts(rts), _cts(cts) {}
		UART() {
			is_usb = true;
		}
		void begin(unsigned long);
		void begin(unsigned long baudrate, uint16_t config);
		void begin(unsigned long baudrate, uint16_t config, bool no_rx_pullup);
		void end();
		int available(void);
		int peek(void);
		int read(void);
		void flush(void);
		size_t write(uint8_t c);
		size_t write(const uint8_t*, size_t);
		using Print::write; // pull in write(str) and write(buf, size) from Print
		operator bool();
		operator mbed::FileHandle*();	// exposes the internal mbed object

#if defined(SERIAL_CDC)
		uint32_t baud();
		uint8_t stopbits();
		uint8_t paritytype();
		uint8_t numbits();
		bool dtr();
		bool rts();
#endif

	private:
		void on_rx();
		void block_tx(int);
		bool _block;
		// See https://github.com/ARMmbed/mbed-os/blob/f5b5989fc81c36233dbefffa1d023d1942468d42/targets/TARGET_NORDIC/TARGET_NRF5x/TARGET_NRF52/serial_api.c#L76
		const size_t WRITE_BUFF_SZ = 32;
		mbed_serial* _serial = NULL;
		mbed_usb_serial* _usb_serial = NULL;
		PinName _tx, _rx, _rts, _cts;
		RingBufferN<256> rx_buffer;
		bool is_usb = false;
};
}

extern arduino::UART _UART1_;
extern arduino::UART _UART2_;
extern arduino::UART _UART3_;
extern arduino::UART _UART4_;
extern arduino::UART _UART_USB_;

#endif
#endif