Add System.IO.Ports
authorKrzysztof Wicher <kwicher@microsoft.com>
Wed, 6 Sep 2023 07:27:14 +0000 (09:27 +0200)
committerViktor Hofer <viktor.hofer@microsoft.com>
Mon, 18 Sep 2023 14:24:48 +0000 (16:24 +0200)
src/libraries/System.IO.Ports/src/PACKAGE.md

index 2709a6e..b450bd4 100644 (file)
@@ -1,44 +1,58 @@
 ## About
 
 <!-- A description of the package and where one can find more documentation -->
-
-
+[System.IO.Ports](https://www.nuget.org/packages/System.IO.Ports) package provides synchronous serial port file resource. Additionally, the functionality of this class can be wrapped in an internal `Stream` object, accessible through the `BaseStream` property, and passed to classes that wrap or use streams.
 
 ## Key Features
 
 <!-- The key features of this package -->
 
-*
-*
-*
+* synchronous and event-driven I/O
+* access to pin and break states
+* access to serial driver properties
+* access to `Stream` object through the `BaseStream` property
 
 ## How to Use
 
 <!-- A compelling example on how to use this package with code, as well as any specific guidelines for when to use the package -->
 
+```C#
+using System.IO.Ports;
+
+// Provides list of available serial ports
+string[] portNames = SerialPort.GetPortNames();
+
+// First available port
+string myPortName = portNames[0];
+int baudRate = 9600;
+
+SerialPort sp = new SerialPort(myPortName, baudRate);
+sp.Open();
+sp.WriteLine("Hello World!");
+```
+
 ## Main Types
 
 <!-- The main types provided in this library -->
 
-The main types provided by this library are:
+The main type provided by this library is:
 
-* ``
-* ``
-* ``
+* `SerialPort`
 
 ## Additional Documentation
 
 <!-- Links to further documentation. Remove conceptual documentation if not available for the library. -->
 
-* [Conceptual documentation](https://learn.microsoft.com/en-us/dotnet/standard/serialization/**LIBRARYNAME**/overview)
-* [API documentation](https://learn.microsoft.com/en-us/dotnet/api/**LIBRARYNAME**)
+* [SerialPort class documentation](https://learn.microsoft.com/en-us/dotnet/api/system.io.ports.serialport?view=dotnet-plat-ext-7.0)
+* [API documentation](https://learn.microsoft.com/en-us/dotnet/api/System.IO.Ports)
 
 ## Related Packages
 
 <!-- The related packages associated with this package -->
+- [System.IO.Ports](https://www.nuget.org/packages/System.IO.Ports)
 
 ## Feedback & Contributing
 
 <!-- How to provide feedback on this package and contribute to it -->
 
-**LIBRARY NAME** is released as open source under the [MIT license](https://licenses.nuget.org/MIT). Bug reports and contributions are welcome at [the GitHub repository](https://github.com/dotnet/runtime).
\ No newline at end of file
+**System.IO.Ports** is released as open source under the [MIT license](https://licenses.nuget.org/MIT). Bug reports and contributions are welcome at [the GitHub repository](https://github.com/dotnet/runtime).