Feature serial port

build.proj

@@ -70,6 +70,7 @@
     <ItemGroup>
       <_ProjectsToPackage Include="$(MSBuildThisFileDirectory)src\Iot.Device.Bindings\Iot.Device.Bindings.csproj" />
       <_ProjectsToPackage Include="$(MSBuildThisFileDirectory)src\System.Device.Gpio\System.Device.Gpio.csproj" />
+      <_ProjectsToPackage Include="$(MSBuildThisFileDirectory)src\System.Device.Ports\System.Device.Ports.SerialPort\System.Device.Ports.SerialPort.csproj" />
     </ItemGroup>
 
     <MSBuild Projects="@(_ProjectsToPackage)" Targets="Pack" />

src/System.Device.Ports/System.Device.Ports.SerialPort.Tests/System.Device.Ports.SerialPort.Tests.csproj

@@ -0,0 +1,14 @@
+<Project Sdk="Microsoft.NET.Sdk">
+
+  <PropertyGroup>
+    <TargetFramework>net6.0</TargetFramework>
+    <IsPackable>false</IsPackable>
+    <!-- Keep quiet about duplicate package references from props files -->
+    <NoWarn>$(NoWarn);NETSDK1023</NoWarn>
+  </PropertyGroup>
+
+  <ItemGroup>
+    <ProjectReference Include="..\System.Device.Ports.SerialPort\System.Device.Ports.SerialPort.csproj" />
+  </ItemGroup>
+
+</Project>

src/System.Device.Ports/System.Device.Ports.SerialPort/Handshake.cs

@@ -0,0 +1,42 @@
+// Licensed to the .NET Foundation under one or more agreements.
+// The .NET Foundation licenses this file to you under the MIT license.
+
+namespace System.Device.Ports.SerialPort
+{
+    /// <summary>
+    /// Defines how the transfer is done between
+    /// the sender (DTE) and the receiver (DCE).
+    /// </summary>
+    public enum Handshake
+    {
+        /// <summary>
+        /// This is the most common option.
+        /// All the trasmitted and received data may flow at the same time.
+        /// </summary>
+        None,
+
+        /// <summary>
+        /// The data flow is controlled using the two ascii characters
+        /// XOn (17) and XOff (19).<par />
+        /// The receiver can stop receiving data by sending XOff and
+        /// restarting the flow by sending XOn to the transmitter.<para/>
+        /// This flow precludes the use of those two characters in
+        /// the message data.
+        /// </summary>
+        XOnXOff,
+
+        /// <summary>
+        /// The data flow is controlled using the RTS and CTS wires
+        /// and is used when a half-duplex communication is desired.
+        /// The RTS line is set by the transmitter. The receiver
+        /// should assert the CTS to let the trasmitter begin.
+        /// </summary>
+        RequestToSend,
+
+        /// <summary>
+        /// Both the Request-to-Send (RTS) hardware control and
+        /// the XON/XOFF software controls are used
+        /// </summary>
+        RequestToSendXOnXOff
+    }
+}

src/System.Device.Ports/System.Device.Ports.SerialPort/LinuxSerialPort.cs

@@ -0,0 +1,135 @@
+// Licensed to the .NET Foundation under one or more agreements.
+// The .NET Foundation licenses this file to you under the MIT license.
+
+namespace System.Device.Ports.SerialPort
+{
+    internal class LinuxSerialPort : SerialPort
+    {
+        private const string DefaultPortName = "/dev/tty0";
+
+        public LinuxSerialPort()
+        {
+            _portName = DefaultPortName;
+        }
+
+        protected internal override void SetBaudRate(int baudRate)
+        {
+            throw new NotImplementedException();
+        }
+
+        protected internal override void SetParity(Parity parity)
+        {
+            throw new NotImplementedException();
+        }
+
+        protected internal override void SetDataBits(int dataBits)
+        {
+            throw new NotImplementedException();
+        }
+
+        protected internal override void SetStopBits(StopBits stopBits)
+        {
+            throw new NotImplementedException();
+        }
+
+        protected internal override void SetBreakState(bool breakState)
+        {
+            throw new NotImplementedException();
+        }
+
+        protected internal override int GetBytesToRead()
+        {
+            throw new NotImplementedException();
+        }
+
+        protected internal override int GetBytesToWrite()
+        {
+            throw new NotImplementedException();
+        }
+
+        protected internal override int GetCDHolding()
+        {
+            throw new NotImplementedException();
+        }
+
+        protected internal override int GetCtsHolding()
+        {
+            throw new NotImplementedException();
+        }
+
+        protected internal override void SetDiscardNull(bool value)
+        {
+            throw new NotImplementedException();
+        }
+
+        protected internal override int GetDsrHolding()
+        {
+            throw new NotImplementedException();
+        }
+
+        protected internal override void SetDtrEnable(bool value)
+        {
+            throw new NotImplementedException();
+        }
+
+        protected internal override void SetHandshake(Handshake handshake)
+        {
+            throw new NotImplementedException();
+        }
+
+        protected internal override byte SetParityReplace(byte parityReplace)
+        {
+            throw new NotImplementedException();
+        }
+
+        protected internal override void SetReadTimeout(int timeout)
+        {
+            throw new NotImplementedException();
+        }
+
+        protected internal override void SetRtsEnable(bool rtsEnable)
+        {
+            throw new NotImplementedException();
+        }
+
+        protected internal override void SetWriteBufferSize(int writeBufferSize)
+        {
+            throw new NotImplementedException();
+        }
+
+        protected internal override void SetWriteTimeout(int writeTimeout)
+        {
+            throw new NotImplementedException();
+        }
+
+        protected internal override void OpenPort()
+        {
+            throw new NotImplementedException();
+        }
+
+        protected internal override void ClosePort()
+        {
+            throw new NotImplementedException();
+        }
+
+        public override void DiscardInBuffer()
+        {
+            throw new NotImplementedException();
+        }
+
+        public override void DiscardOutBuffer()
+        {
+            throw new NotImplementedException();
+        }
+
+        protected override void Dispose(bool disposing)
+        {
+            base.Dispose(disposing);
+        }
+
+        protected internal override void InitializeBuffers(int readBufferSize, int writeBufferSize)
+        {
+            throw new NotImplementedException();
+        }
+    }
+}

src/System.Device.Ports/System.Device.Ports.SerialPort/NativeMethods.txt

@@ -0,0 +1,28 @@
+MAXDWORD
+DCB
+COMMTIMEOUTS
+COMSTAT
+COMMPROP
+
+SetCommState
+SetCommBreak
+SetCommMask
+SetCommTimeouts
+SetupComm
+PurgeComm
+ClearCommBreak
+ClearCommError
+WaitCommEvent
+EscapeCommFunction
+GetCommModemStatus
+GetFileType
+GetCommProperties
+FlushFileBuffers
+CreateFile
+ReadFile
+WriteFile
+GetOverlappedResult
+CloseHandle
+
+WIN32_ERROR
+

src/System.Device.Ports/System.Device.Ports.SerialPort/Parity.cs

@@ -0,0 +1,36 @@
+// Licensed to the .NET Foundation under one or more agreements.
+// The .NET Foundation licenses this file to you under the MIT license.
+
+namespace System.Device.Ports.SerialPort
+{
+    /// <summary>
+    /// Specifies the parity bit for a SerialPort object.
+    /// </summary>
+    public enum Parity
+    {
+        /// <summary>
+        /// No parity bit is senty or expected.
+        /// </summary>
+        None = 0,
+
+        /// <summary>
+        /// Sets the parity bit so that the count of bits set is an odd number.
+        /// </summary>
+        Odd = 1,
+
+        /// <summary>
+        /// Sets the parity bit so that the count of bits set is an even number.
+        /// </summary>
+        Even = 2,
+
+        /// <summary>
+        /// Leaves the parity bit set to 1.
+        /// </summary>
+        Mark = 3,
+
+        /// <summary>
+        /// Leaves the parity bit set to 0.
+        /// </summary>
+        Space = 4
+    }
+}

src/System.Device.Ports/System.Device.Ports.SerialPort/SerialData.cs

@@ -0,0 +1,23 @@
+// Licensed to the .NET Foundation under one or more agreements.
+// The .NET Foundation licenses this file to you under the MIT license.
+
+namespace System.Device.Ports.SerialPort
+{
+    /// <summary>
+    /// Specifies the type of character that was received on the serial port of the SerialPort object.
+    /// </summary>
+    public enum SerialData
+    {
+        /// <summary>
+        /// A character was received and placed in the input buffer.
+        /// In the Windows implementation, this is EV_RXCHAR.
+        /// </summary>
+        Chars = 0x01,
+
+        /// <summary>
+        /// The end of file character was received and placed in the input buffer.
+        /// In the Windows implementation, this is EV_RXFLAG.
+        /// </summary>
+        Eof = 0x02
+    }
+}

src/System.Device.Ports/System.Device.Ports.SerialPort/SerialDataReceivedEventArgs.cs

@@ -0,0 +1,21 @@
+// Licensed to the .NET Foundation under one or more agreements.
+// The .NET Foundation licenses this file to you under the MIT license.
+
+namespace System.Device.Ports.SerialPort
+{
+    /// <summary>
+    /// The arguments for the SerialDataReceived event
+    /// </summary>
+    public class SerialDataReceivedEventArgs : EventArgs
+    {
+        internal SerialDataReceivedEventArgs(SerialData eventCode)
+        {
+            EventType = eventCode;
+        }
+
+        /// <summary>
+        /// The nature of data recevied from the serial port
+        /// </summary>
+        public SerialData EventType { get; private set; }
+    }
+}

src/System.Device.Ports/System.Device.Ports.SerialPort/SerialDataReceivedEventHandler.cs

@@ -0,0 +1,12 @@
+// Licensed to the .NET Foundation under one or more agreements.
+// The .NET Foundation licenses this file to you under the MIT license.
+
+namespace System.Device.Ports.SerialPort
+{
+    /// <summary>
+    /// Represents the method that will handle the DataReceived event of a SerialPort object.
+    /// </summary>
+    /// <param name="sender">The sender of the event, which is the SerialPort object.</param>
+    /// <param name="e">A SerialDataReceivedEventArgs object that contains the event data.</param>
+    public delegate void SerialDataReceivedEventHandler(object sender, SerialDataReceivedEventArgs e);
+}

src/System.Device.Ports/System.Device.Ports.SerialPort/SerialError.cs

@@ -0,0 +1,40 @@
+// Licensed to the .NET Foundation under one or more agreements.
+// The .NET Foundation licenses this file to you under the MIT license.
+
+namespace System.Device.Ports.SerialPort
+{
+    /// <summary>
+    /// Specifies errors that occur on the SerialPort object.
+    /// </summary>
+    public enum SerialError
+    {
+        /// <summary>
+        /// The application tried to transmit a character,
+        /// but the output buffer was full.
+        /// </summary>
+        TXFull = 0x100,
+
+        /// <summary>
+        /// An input buffer overflow has occurred.
+        /// There is either no room in the input buffer, or a character
+        /// was received after the end-of-file (EOF) character.
+        /// </summary>
+        RXOver = 0x01,
+
+        /// <summary>
+        /// A character-buffer overrun has occurred.
+        /// The next character is lost.
+        /// </summary>
+        Overrun = 0x02,
+
+        /// <summary>
+        /// The hardware detected a parity error.
+        /// </summary>
+        RXParity = 0x04,
+
+        /// <summary>
+        /// The hardware detected a framing error.
+        /// </summary>
+        Frame = 0x08,
+    }
+}

src/System.Device.Ports/System.Device.Ports.SerialPort/SerialErrorReceivedEventArgs.cs

@@ -0,0 +1,21 @@
+// Licensed to the .NET Foundation under one or more agreements.
+// The .NET Foundation licenses this file to you under the MIT license.
+
+namespace System.Device.Ports.SerialPort
+{
+    /// <summary>
+    /// Prepares data for the ErrorReceived event.
+    /// </summary>
+    public class SerialErrorReceivedEventArgs : EventArgs
+    {
+        internal SerialErrorReceivedEventArgs(SerialError eventCode)
+        {
+            EventType = eventCode;
+        }
+
+        /// <summary>
+        /// The nature of data recevied from the serial port
+        /// </summary>
+        public SerialError EventType { get; private set; }
+    }
+}