GenericSshClient changes for S+ module

This commit is contained in:
Heath Volmer
2016-09-22 21:57:21 -06:00
parent 0c72e68cc0
commit 8aa9f130cd
9 changed files with 785 additions and 708 deletions

View File

@@ -10,6 +10,9 @@ namespace PepperDash.Core
public class ConnectionChangeEventArgs : EventArgs public class ConnectionChangeEventArgs : EventArgs
{ {
public bool IsConnected { get; private set; } public bool IsConnected { get; private set; }
public ushort UIsConnected { get { return (ushort)(Client.IsConnected ? 1 : 0); } }
public GenericSshClient Client { get; private set; } public GenericSshClient Client { get; private set; }
public ushort Status { get { return Client.UStatus; } } public ushort Status { get { return Client.UStatus; } }
@@ -28,11 +31,21 @@ namespace PepperDash.Core
public class GenericSshClient : Device, IBasicCommunication, IAutoReconnect public class GenericSshClient : Device, IBasicCommunication, IAutoReconnect
{ {
/// <summary>
/// Event that fires when data is received. Delivers args with byte array
/// </summary>
public event EventHandler<GenericCommMethodReceiveBytesArgs> BytesReceived; public event EventHandler<GenericCommMethodReceiveBytesArgs> BytesReceived;
/// <summary>
/// Event that fires when data is received. Delivered as text.
/// </summary>
public event EventHandler<GenericCommMethodReceiveTextArgs> TextReceived; public event EventHandler<GenericCommMethodReceiveTextArgs> TextReceived;
/// <summary>
/// Event when the connection status changes.
/// </summary>
public event EventHandler<ConnectionChangeEventArgs> ConnectionChange; public event EventHandler<ConnectionChangeEventArgs> ConnectionChange;
//public event EventHandler<DataReceiveEventArgs> DataReceive;
public string Hostname { get; set; } public string Hostname { get; set; }
/// <summary> /// <summary>
@@ -45,18 +58,24 @@ namespace PepperDash.Core
public bool IsConnected public bool IsConnected
{ {
// returns false if no client or not connected // returns false if no client or not connected
get { return (Client != null ? Client.IsConnected : false); } get { return UStatus == 2; }
set
{
if (value)
UStatus = 2;
OnConnectionChange();
}
} }
/// <summary> /// <summary>
/// Contains the familiar Simpl analog status values /// Contains the familiar Simpl analog status values
/// </summary> /// </summary>
public ushort UStatus { get; private set; } public ushort UStatus
{
get { return _UStatus; }
private set
{
if (_UStatus == value)
return;
_UStatus = value;
OnConnectionChange();
}
}
ushort _UStatus;
/// <summary> /// <summary>
/// Determines whether client will attempt reconnection on failure. Default is true /// Determines whether client will attempt reconnection on failure. Default is true
@@ -64,37 +83,69 @@ namespace PepperDash.Core
public bool AutoReconnect { get; set; } public bool AutoReconnect { get; set; }
/// <summary> /// <summary>
/// Millisecond value, determines the timeout period in between reconnect attempts /// S+ helper for AutoReconnect
/// </summary>
public ushort UAutoReconnect
{
get { return (ushort)(AutoReconnect ? 1 : 0); }
set { AutoReconnect = value == 1; }
}
/// <summary>
/// Millisecond value, determines the timeout period in between reconnect attempts.
/// Set to 5000 by default
/// </summary> /// </summary>
public int AutoReconnectIntervalMs { get; set; } public int AutoReconnectIntervalMs { get; set; }
SshClient Client; SshClient Client;
ShellStream TheStream; ShellStream TheStream;
CTimer ReconnectTimer; CTimer ReconnectTimer;
//bool ReconnectTimerRunning;
/// <summary>
/// Typical constructor.
/// </summary>
public GenericSshClient(string key, string hostname, int port, string username, string password) : public GenericSshClient(string key, string hostname, int port, string username, string password) :
base(key) base(key)
{ {
AutoReconnectIntervalMs = 5000; CrestronEnvironment.ProgramStatusEventHandler += new ProgramStatusEventHandler(CrestronEnvironment_ProgramStatusEventHandler);
AutoReconnect = true; Key = key;
Hostname = hostname; Hostname = hostname;
Port = port; Port = port;
Username = username; Username = username;
Password = password; Password = password;
CrestronEnvironment.ProgramStatusEventHandler += new ProgramStatusEventHandler(CrestronEnvironment_ProgramStatusEventHandler); AutoReconnectIntervalMs = 5000;
} }
/// <summary>
/// S+ Constructor - Must set all properties before calling Connect
/// </summary>
public GenericSshClient()
: base("Uninitialized SshClient")
{
CrestronEnvironment.ProgramStatusEventHandler += new ProgramStatusEventHandler(CrestronEnvironment_ProgramStatusEventHandler);
AutoReconnectIntervalMs = 5000;
}
/// <summary>
/// Just to help S+ set the key
/// </summary>
public void Initialize(string key)
{
Key = key;
}
/// <summary>
/// Handles closing this up when the program shuts down
/// </summary>
void CrestronEnvironment_ProgramStatusEventHandler(eProgramStatusEventType programEventType) void CrestronEnvironment_ProgramStatusEventHandler(eProgramStatusEventType programEventType)
{ {
if (programEventType == eProgramStatusEventType.Stopping) if (programEventType == eProgramStatusEventType.Stopping)
{ {
if (Client != null) if (Client != null)
{ {
Debug.Console(2, this, "Closing connection"); Debug.Console(2, this, "Program stopping. Closing connection");
Client.Disconnect(); Client.Disconnect();
Client.Dispose(); Client.Dispose();
Debug.Console(2, this, "Connection closed");
} }
} }
} }
@@ -106,83 +157,85 @@ namespace PepperDash.Core
{ {
Debug.Console(1, this, "attempting connect, IsConnected={0}", Client != null ? Client.IsConnected : false); Debug.Console(1, this, "attempting connect, IsConnected={0}", Client != null ? Client.IsConnected : false);
//ReconnectTimerRunning = false; // Cancel reconnect if running.
if (ReconnectTimer != null) if (ReconnectTimer != null)
{ {
ReconnectTimer.Stop(); ReconnectTimer.Stop();
ReconnectTimer = null; ReconnectTimer = null;
} }
// Don't try to connect if already
if (IsConnected) if (IsConnected)
return; return;
if (Hostname != null && Hostname != string.Empty && Port > 0 && // Don't go unless everything is here
Username != null && Password != null) if (string.IsNullOrEmpty(Hostname) || Port < 1 || Port > 65535
{ || Username == null || Password == null)
UStatus = 1;
IsConnected = false;
// This handles both password and keyboard-interactive (like on OS-X, 'nixes)
KeyboardInteractiveAuthenticationMethod kauth = new KeyboardInteractiveAuthenticationMethod(Username);
kauth.AuthenticationPrompt += new EventHandler<AuthenticationPromptEventArgs>(kauth_AuthenticationPrompt);
PasswordAuthenticationMethod pauth = new PasswordAuthenticationMethod(Username, Password);
ConnectionInfo connectionInfo = new ConnectionInfo(Hostname, Port, Username, pauth, kauth);
// always spin up new client in case parameters have changed
if (Client != null)
{
Client.Disconnect();
Client = null;
}
Client = new SshClient(connectionInfo);
Client.ErrorOccurred += Client_ErrorOccurred;
try
{
Client.Connect();
if (Client.IsConnected)
{
Client.KeepAliveInterval = TimeSpan.FromSeconds(2);
Client.SendKeepAlive();
IsConnected = true;
Debug.Console(1, this, "Connected");
TheStream = Client.CreateShellStream("PDTShell", 100, 80, 100, 200, 65534);
TheStream.DataReceived += Stream_DataReceived;
}
return;
}
catch (SshConnectionException e)
{
var ie = e.InnerException; // The details are inside!!
string msg;
if (ie is SocketException)
msg = string.Format("'{0}' CONNECTION failure: Cannot reach host, ({1})", Key, ie.GetType());
else if (ie is System.Net.Sockets.SocketException)
msg = string.Format("'{0}' Connection failure: Cannot reach host '{1}' on port {2}, ({3})",
Key, Hostname, Port, ie.GetType());
else if (ie is SshAuthenticationException)
{
msg = string.Format("'{0}' Authentication failure for username '{1}', ({2})",
Username, Key, ie.GetType());
Debug.Console(0, this, "Authentication failure for username '{0}', ({1})",
Username, ie.GetType());
}
else
Debug.Console(0, this, "Error on connect:\r({0})", e);
}
catch (Exception e)
{
Debug.Console(0, this, "Unhandled exception on connect:\r({0})", e);
}
}
else
{ {
Debug.Console(0, this, "Connect failed. Check hostname, port, username and password are set or not null"); Debug.Console(0, this, "Connect failed. Check hostname, port, username and password are set or not null");
return;
} }
//You can do it!
UStatus = 1;
//IsConnected = false;
// This handles both password and keyboard-interactive (like on OS-X, 'nixes)
KeyboardInteractiveAuthenticationMethod kauth = new KeyboardInteractiveAuthenticationMethod(Username);
kauth.AuthenticationPrompt += new EventHandler<AuthenticationPromptEventArgs>(kauth_AuthenticationPrompt);
PasswordAuthenticationMethod pauth = new PasswordAuthenticationMethod(Username, Password);
ConnectionInfo connectionInfo = new ConnectionInfo(Hostname, Port, Username, pauth, kauth);
// always spin up new client in case parameters have changed
// **** MAY WANT TO CHANGE THIS BECAUSE OF SOCKET LEAKS ****
if (Client != null)
{
Client.Disconnect();
Client = null;
}
Client = new SshClient(connectionInfo);
Client.ErrorOccurred += Client_ErrorOccurred;
try
{
Client.Connect();
if (Client.IsConnected)
{
Client.KeepAliveInterval = TimeSpan.FromSeconds(2);
Client.SendKeepAlive();
TheStream = Client.CreateShellStream("PDTShell", 100, 80, 100, 200, 65534);
TheStream.DataReceived += Stream_DataReceived;
Debug.Console(1, this, "Connected");
UStatus = 2;
//IsConnected = true;
}
return;
}
catch (SshConnectionException e)
{
var ie = e.InnerException; // The details are inside!!
if (ie is SocketException)
Debug.Console(0, this, "'{0}' CONNECTION failure: Cannot reach host, ({1})", Key, ie.GetType());
else if (ie is System.Net.Sockets.SocketException)
Debug.Console(0, this, "'{0}' Connection failure: Cannot reach host '{1}' on port {2}, ({3})",
Key, Hostname, Port, ie.GetType());
else if (ie is SshAuthenticationException)
{
Debug.Console(0, this, "Authentication failure for username '{0}', ({1})",
Username, ie.GetType());
}
else
Debug.Console(0, this, "Error on connect:\r({0})", e);
}
catch (Exception e)
{
Debug.Console(0, this, "Unhandled exception on connect:\r({0})", e);
}
// Sucess will not make it this far // Sucess will not make it this far
UStatus = 3; UStatus = 3;
IsConnected = false; //IsConnected = false;
HandleConnectionFailure(); HandleConnectionFailure();
} }
@@ -197,14 +250,24 @@ namespace PepperDash.Core
ReconnectTimer.Stop(); ReconnectTimer.Stop();
ReconnectTimer = null; ReconnectTimer = null;
} }
// Otherwise just close up DiscoAndCleanup();
if (Client != null) // && Client.IsConnected) <-- Doesn't always report properly... UStatus = 5;
//IsConnected = false;
}
/// <summary>
///
/// </summary>
void DiscoAndCleanup()
{
if (Client != null)
{ {
Debug.Console(1, this, "Disconnecting"); Client.ErrorOccurred -= Client_ErrorOccurred;
TheStream.DataReceived -= Stream_DataReceived;
Debug.Console(2, this, "Cleaning up disconnected client");
Client.Disconnect(); Client.Disconnect();
Cleanup(); Client.Dispose();
UStatus = 5; Client = null;
IsConnected = false;
} }
} }
@@ -213,6 +276,8 @@ namespace PepperDash.Core
/// </summary> /// </summary>
void HandleConnectionFailure() void HandleConnectionFailure()
{ {
DiscoAndCleanup();
Debug.Console(2, this, "Checking autoreconnect: {0}, {1}ms", Debug.Console(2, this, "Checking autoreconnect: {0}, {1}ms",
AutoReconnect, AutoReconnectIntervalMs); AutoReconnect, AutoReconnectIntervalMs);
if (AutoReconnect) if (AutoReconnect)
@@ -235,12 +300,6 @@ namespace PepperDash.Core
} }
} }
void Cleanup()
{
Debug.Console(2, this, "cleaning up resources");
Client = null;
}
/// <summary> /// <summary>
/// Handles the keyboard interactive authentication, should it be required. /// Handles the keyboard interactive authentication, should it be required.
/// </summary> /// </summary>
@@ -277,15 +336,19 @@ namespace PepperDash.Core
/// </summary> /// </summary>
void Client_ErrorOccurred(object sender, Crestron.SimplSharp.Ssh.Common.ExceptionEventArgs e) void Client_ErrorOccurred(object sender, Crestron.SimplSharp.Ssh.Common.ExceptionEventArgs e)
{ {
Debug.Console(0, this, "SSH client error: {0}", e.Exception);
if (!(e.Exception is SshConnectionException)) if (!(e.Exception is SshConnectionException))
{ {
Debug.Console(0, this, "SSH client error: {0}", e.Exception); Debug.Console(1, this, "Disconnected by remote");
UStatus = 4;
} }
Client.Disconnect(); if (Client != null)
Client = null; {
Debug.Console(1, this, "Disconnected by remote"); Client.Disconnect();
IsConnected = false; Client.Dispose();
Client = null;
}
UStatus = 4;
//IsConnected = false;
HandleConnectionFailure(); HandleConnectionFailure();
} }
@@ -300,6 +363,10 @@ namespace PepperDash.Core
#region IBasicCommunication Members #region IBasicCommunication Members
/// <summary>
///
/// </summary>
/// <param name="text"></param>
public void SendText(string text) public void SendText(string text)
{ {
try try
@@ -311,7 +378,7 @@ namespace PepperDash.Core
{ {
Debug.Console(1, this, "Stream write failed. Disconnected, closing"); Debug.Console(1, this, "Stream write failed. Disconnected, closing");
UStatus = 4; UStatus = 4;
IsConnected = false; //IsConnected = false;
HandleConnectionFailure(); HandleConnectionFailure();
} }
} }
@@ -327,7 +394,7 @@ namespace PepperDash.Core
{ {
Debug.Console(1, this, "Stream write failed. Disconnected, closing"); Debug.Console(1, this, "Stream write failed. Disconnected, closing");
UStatus = 4; UStatus = 4;
IsConnected = false; //IsConnected = false;
HandleConnectionFailure(); HandleConnectionFailure();
} }
} }

View File

@@ -82,13 +82,13 @@ namespace PepperDash.Core
: base(key) : base(key)
{ {
Client = new TCPClient(address, port, bufferSize); Client = new TCPClient(address, port, bufferSize);
Client.SocketStatusChange += new TCPClientSocketStatusChangeEventHandler(Client_SocketStatusChange);
} }
public override bool CustomActivate() //public override bool CustomActivate()
{ //{
Client.SocketStatusChange += new TCPClientSocketStatusChangeEventHandler(Client_SocketStatusChange); // return true;
return true; //}
}
public override bool Deactivate() public override bool Deactivate()
{ {

View File

@@ -54,6 +54,11 @@ namespace PepperDash.Core
{ {
Bytes = bytes; Bytes = bytes;
} }
/// <summary>
/// Stupid S+ Constructor
/// </summary>
public GenericCommMethodReceiveBytesArgs() { }
} }
/// <summary> /// <summary>
@@ -66,6 +71,11 @@ namespace PepperDash.Core
{ {
Text = text; Text = text;
} }
/// <summary>
/// Stupid S+ Constructor
/// </summary>
public GenericCommMethodReceiveTextArgs() { }
} }
/// <summary> /// <summary>

View File

@@ -85,7 +85,7 @@
<Programmer /> <Programmer />
<ArchiveFilename>C:\Users\hvolm\Desktop\working\pepperdash-simplsharp-core\Pepperdash Core\Pepperdash Core\bin\PepperDash_Core.clz</ArchiveFilename> <ArchiveFilename>C:\Users\hvolm\Desktop\working\pepperdash-simplsharp-core\Pepperdash Core\Pepperdash Core\bin\PepperDash_Core.clz</ArchiveFilename>
<MinFirmwareVersion>1.007.0017</MinFirmwareVersion> <MinFirmwareVersion>1.007.0017</MinFirmwareVersion>
<CompiledOn>9/20/2016 2:09:33 PM</CompiledOn> <CompiledOn>9/22/2016 9:42:40 PM</CompiledOn>
<AdditionalInfo /> <AdditionalInfo />
<EmbedSourceArchive>False</EmbedSourceArchive> <EmbedSourceArchive>False</EmbedSourceArchive>
<CopyTo /> <CopyTo />

View File

@@ -10,7 +10,7 @@
<ArchiveName /> <ArchiveName />
</RequiredInfo> </RequiredInfo>
<OptionalInfo> <OptionalInfo>
<CompiledOn>9/20/2016 2:09:33 PM</CompiledOn> <CompiledOn>9/22/2016 9:42:40 PM</CompiledOn>
<CompilerRev>1.0.0.23686</CompilerRev> <CompilerRev>1.0.0.37279</CompilerRev>
</OptionalInfo> </OptionalInfo>
</ProgramInfo> </ProgramInfo>

View File

@@ -1,4 +1,4 @@
MainAssembly=PepperDash_Core.dll:d21b9348a9ff127c20006e8d8b9a166c MainAssembly=PepperDash_Core.dll:022f5296f4c24102c3cb64cd3a10fa41
MainAssemblyMinFirmwareVersion=1.007.0017 MainAssemblyMinFirmwareVersion=1.007.0017
ü ü
DependencySource=Newtonsoft.Json.Compact.dll:ea996aa2ec65aa1878e7c9d09e37a896 DependencySource=Newtonsoft.Json.Compact.dll:ea996aa2ec65aa1878e7c9d09e37a896