From 7341c3f22d422b478082fa814817e420340a6cb8 Mon Sep 17 00:00:00 2001
From: microcompiler <58912473+bytewizer@users.noreply.github.com>
Date: Sun, 31 Oct 2021 12:21:53 -0700
Subject: [PATCH] Updated build files

---
 ....Drivers.Blues.Notecard.Diagnostics.csproj |  1 +
 .../Notecard.cs                               | 43 +++++++++++++++++--
 ...izer.TinyCLR.Drivers.Blues.Notecard.csproj |  1 +
 3 files changed, 42 insertions(+), 3 deletions(-)

diff --git a/src/Bytewizer.TinyCLR.Drivers.Blues.Notecard.Diagnostics/Bytewizer.TinyCLR.Drivers.Blues.Notecard.Diagnostics.csproj b/src/Bytewizer.TinyCLR.Drivers.Blues.Notecard.Diagnostics/Bytewizer.TinyCLR.Drivers.Blues.Notecard.Diagnostics.csproj
index c0bee6c..064fac9 100644
--- a/src/Bytewizer.TinyCLR.Drivers.Blues.Notecard.Diagnostics/Bytewizer.TinyCLR.Drivers.Blues.Notecard.Diagnostics.csproj
+++ b/src/Bytewizer.TinyCLR.Drivers.Blues.Notecard.Diagnostics/Bytewizer.TinyCLR.Drivers.Blues.Notecard.Diagnostics.csproj
@@ -27,6 +27,7 @@
     <DefineConstants>DEBUG;TRACE</DefineConstants>
     <ErrorReport>prompt</ErrorReport>
     <WarningLevel>4</WarningLevel>
+    <DocumentationFile>bin\Debug\Bytewizer.TinyCLR.Drivers.Blues.Notecard.Diagnostics.xml</DocumentationFile>
   </PropertyGroup>
   <PropertyGroup Condition=" '$(Configuration)|$(Platform)' == 'Release|AnyCPU' ">
     <DebugType>pdbonly</DebugType>
diff --git a/src/Bytewizer.TinyCLR.Drivers.Blues.Notecard.Diagnostics/Notecard.cs b/src/Bytewizer.TinyCLR.Drivers.Blues.Notecard.Diagnostics/Notecard.cs
index 394e5fa..f4baf74 100644
--- a/src/Bytewizer.TinyCLR.Drivers.Blues.Notecard.Diagnostics/Notecard.cs
+++ b/src/Bytewizer.TinyCLR.Drivers.Blues.Notecard.Diagnostics/Notecard.cs
@@ -6,12 +6,20 @@
 
 namespace Bytewizer.TinyCLR.Drivers.Blues.Notecard.Diagnostics
 {
+    /// <summary>
+    /// Configures the <see cref="NotecardLogger"/> to use the serial interface for communication with the host.
+    /// </summary>
     public sealed class NotecardLogger : IDisposable
     {
         private readonly GpioPin enablePin;
         private readonly UartController uartController;
         private readonly GpioController gpioController;
 
+        /// <summary>
+        /// Initializes a default instance of the <see cref="NotecardLogger"/> class.
+        /// </summary>
+        /// <param name="uartController">The uart controller to use.</param>
+        /// <param name="enablePin">The gpio pin to use enable the serial interface.</param>
         public NotecardLogger(UartController uartController, int enablePin)
             : this(uartController, new UartSetting()
             {
@@ -21,9 +29,14 @@ public NotecardLogger(UartController uartController, int enablePin)
                 StopBits = UartStopBitCount.One,
                 Handshaking = UartHandshake.None
             }, enablePin)
-        {
-        }
-
+        { }
+
+        /// <summary>
+        /// Initializes a new instance of the <see cref="NotecardLogger"/> class.
+        /// </summary>
+        /// <param name="uartController">The uart controller to use.</param>
+        /// <param name="uartSettings">The uart controller settings to use.</param>
+        /// <param name="enablePin">The gpio pin to use enable the serial interface.</param>
         public NotecardLogger(UartController uartController, UartSetting uartSettings, int enablePin)
         {
             this.uartController = uartController;
@@ -38,10 +51,19 @@ public NotecardLogger(UartController uartController, UartSetting uartSettings, i
             this.enablePin.Write(GpioPinValue.High);
         }
 
+        /// <summary>
+        /// Enable the notecard debug interface.
+        /// </summary>
         public void Enable() => this.enablePin.Write(GpioPinValue.High);
 
+        /// <summary>
+        /// Disable the notecard debug interface.
+        /// </summary>
         public void Disable() => this.enablePin.Write(GpioPinValue.Low);
 
+        /// <summary>
+        /// Enable debug message logging.
+        /// </summary>
         public void TraceOn()
         {
             Enable();
@@ -50,6 +72,9 @@ public void TraceOn()
             this.uartController.Write(writeBuffer);
         }
 
+        /// <summary>
+        /// Disable degug message logging.
+        /// </summary>
         public void TraceOff()
         {
             var writeBuffer = Encoding.UTF8.GetBytes("{\"req\":\"card.trace\",\"mode\":\"off\"}\n");
@@ -58,6 +83,9 @@ public void TraceOff()
             Disable();
         }
 
+        /// <summary>
+        /// Pro-actively frees resources owned by this instance.
+        /// </summary>
         public void Dispose()
         {
             this.enablePin.Dispose();
@@ -65,7 +93,16 @@ public void Dispose()
             this.gpioController.Dispose();
         }
 
+
+        /// <summary>
+        /// An event that is raised when a message is available.
+        /// </summary>
         public event MessageAvailableEventHandler MessageAvailable;
+
+
+        /// <summary>
+        /// An event that is raised when a message is available.
+        /// </summary>
         public delegate void MessageAvailableEventHandler(string message);
 
         private string TempData { set; get; } = string.Empty;
diff --git a/src/Bytewizer.TinyCLR.Drivers.Blues.Notecard/Bytewizer.TinyCLR.Drivers.Blues.Notecard.csproj b/src/Bytewizer.TinyCLR.Drivers.Blues.Notecard/Bytewizer.TinyCLR.Drivers.Blues.Notecard.csproj
index 67d636f..d1fa90e 100644
--- a/src/Bytewizer.TinyCLR.Drivers.Blues.Notecard/Bytewizer.TinyCLR.Drivers.Blues.Notecard.csproj
+++ b/src/Bytewizer.TinyCLR.Drivers.Blues.Notecard/Bytewizer.TinyCLR.Drivers.Blues.Notecard.csproj
@@ -27,6 +27,7 @@
     <DefineConstants>DEBUG;TRACE</DefineConstants>
     <ErrorReport>prompt</ErrorReport>
     <WarningLevel>4</WarningLevel>
+    <DocumentationFile>bin\Debug\Bytewizer.TinyCLR.Drivers.Blues.Notecard.xml</DocumentationFile>
   </PropertyGroup>
   <PropertyGroup Condition=" '$(Configuration)|$(Platform)' == 'Release|AnyCPU' ">
     <DebugType>pdbonly</DebugType>