added CommunicationDataViewModel,

added DataLine,
added Properties to ExtendedChar to access Data from Frontend,
added MultiFormatDataView in first state,
fixed some warnings
master
Jonas Arnold 3 years ago
parent 88ba4515c6
commit 429c7e842d
  1. 37
      MultiTerm.Core/Model/MultiFormatString.cs
  2. 98
      MultiTerm.Core/ViewModel/CommunicationDataViewModel.cs
  3. 19
      MultiTerm.Core/ViewModel/TerminalViewModel.cs
  4. 28
      MultiTerm.Protocols/Model/DataLine.cs
  5. 34
      MultiTerm.Protocols/Model/ExtendedChar.cs
  6. 2
      MultiTerm.Protocols/Serial/SerialProtocolSettingsViewModel.cs
  7. 1
      MultiTerm.Wpf/View/SendReceiveView.xaml

@ -3,10 +3,21 @@ using System.Text;
namespace MultiTerm.Core.Model;
/// <summary>
/// A string that contains symbols of multiple formats such as a standard character as well as hexadecimal or binary parts.
/// </summary>
public class MultiFormatString
{
/// <summary>
/// List of Symbols that are stored in this <see cref="MultiFormatString"/>
/// </summary>
public List<Tuple<FormatType, string>> FormatValuePairs { get; private set; } = new();
/// <summary>
/// Adds a single character to <see cref="FormatValuePairs"/>.
/// </summary>
/// <param name="format">format of the <paramref name="value"/></param>
/// <param name="value">value of the symbol, must be convertible to an Unicode character</param>
public void Add(FormatType format, string value)
{
// check if value is valid, if yes add to FormatValuePairs
@ -16,6 +27,11 @@ public class MultiFormatString
}
}
/// <summary>
/// Removes a given amount of characters from the end of <see cref="FormatValuePairs"/>.
/// </summary>
/// <param name="amount">amount of characters to remove from the list, starting at the last item</param>
/// <exception cref="ArgumentException">if amount <= 0</exception>
public void Remove(int amount)
{
// guard amount <= 0
@ -32,12 +48,16 @@ public class MultiFormatString
this.FormatValuePairs.RemoveRange( (listCount - amount) , amount);
}
// TODO Setup Unit Tests
public override string ToString()
/// <summary>
/// Converts the <see cref="MultiFormatString"/> to a string that only contains Unicode (UTF-16) characters.
/// </summary>
/// <returns>converted string</returns>
public override string ToString() // TODO Implement Unit Tests!
{
StringBuilder stringBuilder = new();
string hexConversionCharacters = String.Empty, binaryConversionCharacters = String.Empty;
// Internal function to check and finalize a Hexadecimal Conversion
// parameter == null will force ending
void finalizeHexConversion(Tuple<FormatType, string>? formatValuePair)
{
@ -57,6 +77,7 @@ public class MultiFormatString
}
}
// Internal function to check and finalize a Binary Conversion
// parameter == null will force ending
void finalizeBinaryConversion(Tuple<FormatType, string>? formatValuePair)
{
@ -76,8 +97,10 @@ public class MultiFormatString
}
}
// go through every character
foreach (var formatValuePair in this.FormatValuePairs)
{
// finalize ongoing conversions if there are any
finalizeHexConversion(formatValuePair);
finalizeBinaryConversion(formatValuePair);
@ -100,13 +123,17 @@ public class MultiFormatString
}
}
// fully finalize after the loop, finish all unfinished conversions
finalizeHexConversion(null);
finalizeBinaryConversion(null);
return stringBuilder.ToString();
}
/// <summary>
/// Validates wether a certain <paramref name="value"/> is valid for the given <paramref name="format"/>.
/// </summary>
/// <returns>true if valid</returns>
public static bool ValidateValue(FormatType format, string value)
{
// invalid if more than one character
@ -143,7 +170,7 @@ public class MultiFormatString
// from: https://stackoverflow.com/questions/724862/converting-from-hex-to-string
// test with: returns: "Hello world" for "48656C6C6F20776F726C64"
// see https://www.fileformat.info/info/charset/UTF-16/list.htm
public static string FromHexString(string hexString)
private static string FromHexString(string hexString)
{
// Added PadLeft so strings with one character do not get ignored
string internalHexString = hexString.PadLeft(4, '0');
@ -156,7 +183,7 @@ public class MultiFormatString
return Encoding.BigEndianUnicode.GetString(bytes);
}
public static string FromBinaryString(string binaryString)
private static string FromBinaryString(string binaryString)
{
string internalBinaryString = binaryString.PadLeft(16, '0');
var bytes = new byte[internalBinaryString.Length / 8];

@ -0,0 +1,98 @@
using CommunityToolkit.Mvvm.ComponentModel;
using CommunityToolkit.Mvvm.Input;
using MultiTerm.Protocols;
using MultiTerm.Protocols.Model;
using System.Collections.ObjectModel;
namespace MultiTerm.Core.ViewModel;
public partial class CommunicationDataViewModel : ObservableObject
{
private ICommunicationProtocol? communicationProtocol;
/// <summary>
/// Represents the collection of received characters from a communicaiton protocol.
/// </summary>
[ObservableProperty]
private ObservableCollection<DataLine> receivedData = new();
/// <summary>
/// Represents the collection of received characters from a communicaiton protocol.
/// </summary>
[ObservableProperty]
private ObservableCollection<ExtendedChar> receivedCharacters = new(); //TODO
/// <summary>
/// Represents the collection of sent characters to a communicaiton protocol.
/// </summary>
[ObservableProperty]
private ObservableCollection<ExtendedChar> sentCharacters = new(); // TODO Change
public CommunicationDataViewModel(ICommunicationProtocol? communicationProtocol)
{
this.communicationProtocol = communicationProtocol;
if (this.communicationProtocol != null)
{
this.communicationProtocol.ReceivedDataEvent += CommunicationProtocol_ReceivedDataEvent;
this.communicationProtocol.SentDataEvent += CommunicationProtocol_SentDataEvent;
}
else // TEMP
{
string lorem = "Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Pellentesque elit eget gravida cum sociis natoque penatibus et magnis. Purus sit amet volutpat consequat mauris nunc congue nisi vitae. Id ornare arcu odio ut sem. Neque ornare aenean euismod elementum nisi quis eleifend. Faucibus vitae aliquet nec ullamcorper sit. Fermentum iaculis eu non diam phasellus vestibulum lorem sed risus. Pellentesque nec nam aliquam sem et tortor consequat id porta. Diam sollicitudin tempor id eu nisl. Fames ac turpis egestas sed tempus urna et. Commodo odio aenean sed adipiscing diam donec adipiscing tristique risus. Id aliquet lectus proin nibh nisl condimentum id. Dolor sit amet consectetur adipiscing elit duis. Sed vulputate odio ut enim blandit. Neque convallis a cras semper auctor neque vitae.\r\n\r\nLacus laoreet non curabitur gravida arcu ac tortor. Volutpat maecenas volutpat blandit aliquam. Neque laoreet suspendisse interdum consectetur. Tincidunt augue interdum velit euismod in pellentesque massa placerat. Magna fringilla urna porttitor rhoncus dolor purus non enim praesent. Fermentum leo vel orci porta non pulvinar neque laoreet suspendisse. Scelerisque viverra mauris in aliquam sem fringilla. Nec feugiat nisl pretium fusce id velit ut. Urna cursus eget nunc scelerisque viverra mauris. Condimentum mattis pellentesque id nibh tortor id aliquet. Enim sed faucibus turpis in eu. Adipiscing elit pellentesque habitant morbi tristique. A pellentesque sit amet porttitor eget dolor morbi non arcu. Amet commodo nulla facilisi nullam vehicula ipsum a arcu. Hac habitasse platea dictumst vestibulum rhoncus est pellentesque elit ullamcorper. Curabitur vitae nunc sed velit dignissim sodales ut. Malesuada fames ac turpis egestas maecenas pharetra. Tellus pellentesque eu tincidunt tortor aliquam.\r\n\r\nVitae proin sagittis nisl rhoncus mattis rhoncus urna neque viverra. Eget mi proin sed libero enim sed faucibus. Commodo nulla facilisi nullam vehicula ipsum. Proin libero nunc consequat interdum varius sit amet mattis vulputate. Morbi tristique senectus et netus. Feugiat scelerisque varius morbi enim nunc. Nulla aliquet enim tortor at auctor urna nunc. Non pulvinar neque laoreet suspendisse interdum consectetur libero id. Tellus orci ac auctor augue mauris augue neque gravida in. In egestas erat imperdiet sed euismod. Amet volutpat consequat mauris nunc congue nisi. Massa eget egestas purus viverra accumsan in. Eget duis at tellus at. Mi sit amet mauris commodo quis imperdiet. Nibh mauris cursus mattis molestie a iaculis at.\r\n\r\nNetus et malesuada fames ac turpis. Sit amet dictum sit amet justo donec. Euismod quis viverra nibh cras pulvinar mattis. Sit amet commodo nulla facilisi nullam vehicula ipsum a arcu. Scelerisque felis imperdiet proin fermentum. Ac tincidunt vitae semper quis lectus nulla at. Sit amet commodo nulla facilisi nullam vehicula. Enim lobortis scelerisque fermentum dui faucibus in ornare quam. Quam id leo in vitae turpis massa sed. Quam quisque id diam vel quam. A condimentum vitae sapien pellentesque. Neque aliquam vestibulum morbi blandit cursus risus at. Velit laoreet id donec ultrices tincidunt arcu non sodales neque. Tempus imperdiet nulla malesuada pellentesque elit eget gravida cum sociis. Egestas tellus rutrum tellus pellentesque eu tincidunt tortor. Nec feugiat in fermentum posuere. Dui accumsan sit amet nulla. Lacus viverra vitae congue eu consequat ac felis. Etiam tempor orci eu lobortis. Fermentum leo vel orci porta non pulvinar.";
string mcu = "<\\r><\\n>\r\n--------------------------------------------------------------<\\r><\\n>\r\nSPLITFLAP<\\r><\\n>\r\n--------------------------------------------------------------<\\r><\\n>\r\nMcuShell ; Group of McuShell commands<\\r><\\n>\r\n help|status ; Print help or status information<\\r><\\n>\r\nSplitFlap ; Group of McuRTOS commands<\\r><\\n>\r\n help ; Print help or status information<\\r><\\n>\r\n setId <SetupId> <hwId> ; sets the position (setupId) of the sf and its id (hwId)<\\r><\\n>\r\n initAll ; init all Splitflaps<\\r><\\n>\r\n Display <string> ; displays as many chars of the string as sf are available<\\r><\\n>\r\n addId <hwId> <offset> ; add new hwId with offset<\\r><\\n>\r\nMcuRTOS ; Group of McuRTOS commands<\\r><\\n>\r\n help|status ; Print help or status information<\\r><\\n>\r\n tasklist ; Print tasklist<\\r><\\n>\r\nMcuFlash ; Group of flash ini commands<\\r><\\n>\r\n help|status ; Print help or status information<\\r><\\n>\r\n dump <start> <size> ; Dump memory data<\\r><\\n>\r\n erase <addr> <size> ; Erase memory at address<\\r><\\n>\r\nini ; Group of flash ini commands<\\r><\\n>\r\n help|status ; Print help or status information<\\r><\\n>\r\n dump ; Dump data information<\\r><\\n>\r\n erase ; Erase data information<\\r><\\n>\r\nMcuMinINI ; Group of McuMinINI commands<\\r><\\n>\r\n help|status ; Print help or status information<\\r><\\n>\r\n read <f> <s> <k> ; Read a key from a section in a file<\\r><\\n>\r\n write <f> <s> <k> <v> ; Write a key with value to a section in a file<\\r><\\n>\r\n delkey <f> <s> <k> ; Delete a key in a section of file<\\r><\\n>\r\n delsec <f> <s> ; Delete a section in a file<\\r><\\n>\r\nnvmc ; Group of NVMC commands<\\r><\\n>\r\n help|status ; Print help or status information<\\r><\\n>\r\n flags <val> ; Set flags<\\r><\\n>\r\nrs ; Group of RS-485 commands<\\r><\\n>\r\n help|status ; Print help or status information<\\r><\\n>\r\n addr <addr> ; Set RS-485 address<\\r><\\n>\r\n send <text> ; Send a text to the RS-485 bus<\\r><\\n>\r\n sendcmd <addr> <cmd> ; Send a shell command to the RS-485 address and check response<\\r><\\n>\r\n log on|off ; Log RS-485 bus activity to McuLog<\\r><\\n>\r\nMcuUart485 ; Group of RS-485 commands<\\r><\\n>\r\n help|status ; Print help or status information<\\r><\\n>\r\n clear <flags> ; Clear UART ISR flags<\\r><\\n>\r\n<\\r><\\n>\r\nCMD>";
string exampleData = "This is some example Text\nSecond line\nNow a very long line: Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.";
int counter = 0;
List<ExtendedChar> listOfChars = new();
foreach (var character in exampleData)
{
if(++counter > 100 || character == '\n')
{
this.ReceivedData.Add(new DataLine(listOfChars));
listOfChars = new List<ExtendedChar>();
counter = 0;
}
var extdChar = new ExtendedChar(character);
listOfChars.Add(extdChar);
this.ReceivedCharacters.Add(extdChar);
}
}
}
~CommunicationDataViewModel()
{
if (this.communicationProtocol != null)
{
this.communicationProtocol.ReceivedDataEvent -= CommunicationProtocol_ReceivedDataEvent;
this.communicationProtocol.SentDataEvent -= CommunicationProtocol_SentDataEvent;
this.communicationProtocol = null;
}
}
private void CommunicationProtocol_ReceivedDataEvent(object? sender, ReceivedDataEventArgs e)
{
foreach (var receivedChar in e.ReceivedCharacters)
{
//this.ReceivedData.Add(receivedChar); // TODO Fix
}
}
private void CommunicationProtocol_SentDataEvent(object? sender, SentDataEventArgs e)
{
foreach (var sentChar in e.SentCharacters)
{
this.SentCharacters.Add(sentChar);
}
}
[RelayCommand]
private void ClearReceivedCharacters()
{
this.ReceivedData = new ObservableCollection<DataLine>();
}
[RelayCommand]
private void ClearSentCharacters()
{
this.SentCharacters = new ObservableCollection<ExtendedChar>();
}
}

@ -11,12 +11,25 @@ public abstract partial class TerminalViewModel : ObservableObject, ITerminalVie
public abstract string Title { get; }
public abstract TerminalViewType ViewType { get; }
public ProtocolType ProtocolType { get; set; }
public ICommunicationProtocol? CommunicationProtocol { get; set; }
public event EventHandler? ClosingEvent;
private IProtocolSettingsViewModel? protocolSettings;
[ObservableProperty]
private CommunicationDataViewModel communicationData = new(null);
private ICommunicationProtocol? communicationProtocol;
public ICommunicationProtocol? CommunicationProtocol
{
get { return communicationProtocol; }
set
{
communicationProtocol = value;
// register communication protocol in the Communication Data View Model
//this.CommunicationData = new CommunicationDataViewModel(communicationProtocol); // TEMP
}
}
private IProtocolSettingsViewModel? protocolSettings;
public IProtocolSettingsViewModel? ProtocolSettings
{
get { return protocolSettings; }

@ -0,0 +1,28 @@
using CommunityToolkit.Mvvm.ComponentModel;
using System.Collections.ObjectModel;
namespace MultiTerm.Protocols.Model;
/// <summary>
/// One line of data(characters).
/// </summary>
public partial class DataLine : ObservableObject
{
/// <summary>
/// Represents the collection of characters from a communication protocol.
/// </summary>
[ObservableProperty]
private ObservableCollection<ExtendedChar> characters = new();
/// <summary>
/// Constructor of <see cref="DataLine"/>.
/// </summary>
/// <param name="characters">characters collection</param>
public DataLine(IEnumerable<ExtendedChar> characters)
{
foreach (var character in characters)
{
this.Characters.Add(character);
}
}
}

@ -1,4 +1,5 @@
using System.Text;
using CommunityToolkit.Mvvm.ComponentModel;
using System.Text;
namespace MultiTerm.Protocols.Model;
@ -7,13 +8,31 @@ namespace MultiTerm.Protocols.Model;
/// A time can be stored in combination with this Character using the <see cref="Time"/> property. E.g. to represent arrived or sent time.
/// Several methods to display the Character in other formats than Unicode are provided.
/// </summary>
public class ExtendedChar
public partial class ExtendedChar : ObservableObject
{
/// <summary>
/// Data in the form of a character. UTF-16 code unit.
/// </summary>
public char Character { get; set; }
/// <summary>
/// Property that hosts a displayable string of the character (UTF-16 encoded).
/// </summary>
[ObservableProperty]
private string displayStringUtf16 = String.Empty;
/// <summary>
/// Property that hosts a string of the character (hexadecimal format).
/// </summary>
[ObservableProperty]
private string displayStringHex = String.Empty;
/// <summary>
/// Property that hosts a string of the character (binary format).
/// </summary>
[ObservableProperty]
private string displayStringBin = String.Empty;
/// <summary>
/// Time that is associated with the <see cref="Character"/>.
/// E.g. to represent arrived or sent time.
@ -25,15 +44,11 @@ public class ExtendedChar
/// Sets <see cref="Time"/> to now.
/// </summary>
/// <param name="character">data</param>
public ExtendedChar(char character)
{
// initialize time with now
this.Time = TimeOnly.FromDateTime(DateTime.Now);
this.Character = character;
}
public ExtendedChar(char character) : this(character, TimeOnly.FromDateTime(DateTime.Now)) { }
/// <summary>
/// Creates an instance of ExtendedChar with a given <paramref name="character"/> and <paramref name="time"/>.
/// Initializes string properties <see cref="StringUtf16"/>, <see cref="StringHex"/> and <see cref="StringBin"/>.
/// </summary>
/// <param name="character">data</param>
/// <param name="time">time</param>
@ -41,6 +56,9 @@ public class ExtendedChar
{
this.Character = character;
this.Time = time;
this.DisplayStringUtf16 = this.ToUtf16String();
this.DisplayStringHex = this.ToHexString();
this.DisplayStringBin = this.ToBinaryString();
}
public override string ToString()

@ -29,7 +29,7 @@ public partial class SerialProtocolSettingsViewModel : ProtocolSettingsViewModel
private Handshake handshake = Handshake.None;
[ObservableProperty]
private IEnumerable<string> comPorts = new string[] { };
private IEnumerable<string> comPorts = Array.Empty<string>();
[RelayCommand]
private void ReloadComPorts()

@ -31,6 +31,7 @@
</ContentControl>
</GroupBox>
<GroupBox Header="Receive" Grid.Row="1" Padding="5">
<custom_controls:MultiFormatDataView DataSource="{Binding CommunicationData.ReceivedData}" />
</GroupBox>
<GroupBox Header="Send" Grid.Row="2" Padding="5">

Loading…
Cancel
Save