#region CmdMessenger - MIT - (c) 2013 Thijs Elenbaas.
/*
CmdMessenger - library that provides command based messaging
Permission is hereby granted, free of charge, to any person obtaining
a copy of this software and associated documentation files (the
"Software"), to deal in the Software without restriction, including
without limitation the rights to use, copy, modify, merge, publish,
distribute, sublicense, and/or sell copies of the Software, and to
permit persons to whom the Software is furnished to do so, subject to
the following conditions:
The above copyright notice and this permission notice shall be
included in all copies or substantial portions of the Software.
Copyright 2013 - Thijs Elenbaas
*/
#endregion
using System;
using System.IO.Ports;
namespace CommandMessenger.Transport.Serial
{
/// Fas
/// Manager for serial port data
///
public class SerialTransport : ITransport
{
private const int BufferSize = 4096;
private volatile bool _connected;
private readonly AsyncWorker _worker;
private readonly object _serialReadWriteLock = new object();
private readonly object _readLock = new object();
private readonly byte[] _readBuffer = new byte[BufferSize];
private int _bufferFilled;
private SerialPort _serialPort; // The serial port
private SerialSettings _currentSerialSettings = new SerialSettings(); // The current serial settings
public event EventHandler DataReceived; // Event queue for all listeners interested in NewLinesReceived events.
/// Gets or sets the current serial port settings.
/// The current serial settings.
public SerialSettings CurrentSerialSettings
{
get { return _currentSerialSettings; }
set { _currentSerialSettings = value; }
}
public SerialTransport()
{
_worker = new AsyncWorker(Poll, "SerialTransport");
}
private bool Poll()
{
var bytes = UpdateBuffer();
if (bytes > 0 && DataReceived != null) DataReceived(this, EventArgs.Empty);
// Return true as we always have work to do here. The delay is achieved by SerialPort.Read timeout.
return true;
}
/// Connects to a serial port defined through the current settings.
/// true if it succeeds, false if it fails.
public bool Connect()
{
if (!_currentSerialSettings.IsValid())
throw new InvalidOperationException("Unable to open connection - serial settings invalid.");
if (IsConnected())
throw new InvalidOperationException("Serial port is already opened.");
// Setting serial port settings
_serialPort = new SerialPort(
_currentSerialSettings.PortName,
_currentSerialSettings.BaudRate,
_currentSerialSettings.Parity,
_currentSerialSettings.DataBits,
_currentSerialSettings.StopBits)
{
DtrEnable = _currentSerialSettings.DtrEnable,
WriteTimeout = _currentSerialSettings.Timeout,
ReadTimeout = 1000, // read timeout is used for polling in worker thread
};
_connected = Open();
if (_connected) _worker.Start();
return _connected;
}
/// Query if the serial port is open.
/// true if open, false if not.
public bool IsConnected()
{
return _connected && _serialPort.IsOpen;
}
/// Stops listening to the serial port.
/// true if it succeeds, false if it fails.
public bool Disconnect()
{
bool result = Close();
if (_connected)
{
_connected = false;
_worker.Stop();
}
return result;
}
/// Writes a parameter to the serial port.
/// The buffer to write.
public void Write(byte[] buffer)
{
if (IsConnected())
{
try
{
lock (_serialReadWriteLock)
{
_serialPort.Write(buffer, 0, buffer.Length);
}
}
catch (TimeoutException)
{
// Timeout (expected)
}
catch
{
Disconnect();
}
}
}
/// Reads the serial buffer into the string buffer.
public byte[] Read()
{
if (IsConnected())
{
byte[] buffer;
lock (_readLock)
{
buffer = new byte[_bufferFilled];
Array.Copy(_readBuffer, buffer, _bufferFilled);
_bufferFilled = 0;
}
return buffer;
}
return new byte[0];
}
public void Dispose()
{
Dispose(true);
GC.SuppressFinalize(this);
}
/// Opens the serial port.
/// true if it succeeds, false if it fails.
private bool Open()
{
if (!_connected && PortExists() && !_serialPort.IsOpen)
{
try
{
_serialPort.Open();
_serialPort.DiscardInBuffer();
_serialPort.DiscardOutBuffer();
return _serialPort.IsOpen;
}
catch
{
// Ignore.
}
}
return false;
}
/// Closes the serial port.
/// true if it succeeds, false if it fails.
private bool Close()
{
if (!IsConnected()) return false;
try
{
_serialPort.Close();
return true;
}
catch
{
return false;
}
}
/// Queries if a current port exists.
/// true if it succeeds, false if it fails.
private bool PortExists()
{
return SerialUtils.PortExists(_serialPort.PortName);
}
private int UpdateBuffer()
{
if (IsConnected())
{
try
{
lock (_readLock)
{
var nbrDataRead = _serialPort.Read(_readBuffer, _bufferFilled, (BufferSize - _bufferFilled));
_bufferFilled += nbrDataRead;
}
return _bufferFilled;
}
catch (TimeoutException)
{
// Timeout (expected)
}
catch
{
Disconnect();
}
}
return 0;
}
protected virtual void Dispose(bool disposing)
{
if (disposing)
{
Disconnect();
if (_serialPort != null) _serialPort.Dispose();
}
}
}
}