Migrate mscorlib to v2

- Update and migrate pipeline files.
- Update references.
- Bump native assembly version.
- Replace SpanByte with Span<byte> or ReadOnlySpan<byte>.
- Update license header.
- General improvements in IntelliSense comments.

Author: josesimoes

.github/workflows/update-dependencies-develop.yml

@@ -0,0 +1,25 @@
+# Copyright (c) .NET Foundation and Contributors
+# See LICENSE file in the project root for full license information.
+
+# This workflow will periodically check .NET nanoFramework dependencies and updates them in the repository it's running.
+# Can also be triggered by a repository dispatch event.
+
+name: Update .NET nanoFramework dependencies (develop)
+
+on:
+  schedule:
+  # At 00:10 UTC every Mon,Thu.
+  - cron:  '10 00 * * Mon,Thu'
+  repository_dispatch:
+    types: update-dependencies
+
+jobs:
+  update-dependencies:
+    name: nanoFramework
+    uses: nanoframework/nf-tools/.github/workflows/update-dependencies.yml@main
+    secrets: inherit
+    with:
+      solutionsToCheck: 'nanoFramework.System.Device.I2s.sln'
+      previewPackages: true
+      branchToPr: 'develop'
+ 

System.Device.I2s/I2sDevice.cs

@@ -45,7 +45,7 @@ public I2sDevice(I2sConnectionSettings settings)
         /// The length of the buffer determines how much data to read from the I2s device.
         /// </param>
         [MethodImpl(MethodImplOptions.InternalCall)]
-        public extern void Read(SpanByte buffer);
+        public extern void Read(Span<byte> buffer);
 
         /// <summary>
         /// Writes data to the I2s device.
@@ -55,7 +55,7 @@ public I2sDevice(I2sConnectionSettings settings)
         /// The data should not include the I2s device address.
         /// </param>
         [MethodImpl(MethodImplOptions.InternalCall)]
-        public extern void Write(SpanByte buffer);
+        public extern void Write(ReadOnlySpan<byte> buffer);
 
         /// <summary>
         /// Creates a communications channel to a device on an I2s bus running on the current platform

System.Device.I2s/Properties/AssemblyInfo.cs

@@ -17,7 +17,7 @@
 
 ////////////////////////////////////////////////////////////////
 // update this whenever the native assembly signature changes //
-[assembly: AssemblyNativeVersion("100.0.0.1")]
+[assembly: AssemblyNativeVersion("100.2.0.0")]
 ////////////////////////////////////////////////////////////////
 
 // Setting ComVisible to false makes the types in this assembly not visible 

System.Device.I2s/System.Device.I2s.nfproj

@@ -12,7 +12,8 @@
     <ProjectGuid>d74a7890-8a23-417b-ab74-923d57e987ea</ProjectGuid>
     <OutputType>Library</OutputType>
     <FileAlignment>512</FileAlignment>
-    <RootNamespace></RootNamespace>
+    <RootNamespace>
+    </RootNamespace>
     <AssemblyName>System.Device.I2s</AssemblyName>
     <TargetFrameworkVersion>v1.0</TargetFrameworkVersion>
     <NF_IsCoreLibrary>True</NF_IsCoreLibrary>
@@ -57,8 +58,8 @@
     <Content Include="packages.lock.json" />
   </ItemGroup>
   <ItemGroup>
-    <Reference Include="mscorlib, Version=1.17.11.0, Culture=neutral, PublicKeyToken=c07d481e9758c731">
-      <HintPath>..\packages\nanoFramework.CoreLibrary.1.17.11\lib\mscorlib.dll</HintPath>
+    <Reference Include="mscorlib">
+      <HintPath>..\packages\nanoFramework.CoreLibrary.2.0.0-preview.29\lib\netnano1.0\mscorlib.dll</HintPath>
     </Reference>
   </ItemGroup>
   <Import Project="$(NanoFrameworkProjectSystemPath)NFProjectSystem.CSharp.targets" Condition="Exists('$(NanoFrameworkProjectSystemPath)NFProjectSystem.CSharp.targets')" />

System.Device.I2s/packages.config

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
 <packages>
-  <package id="nanoFramework.CoreLibrary" version="1.17.11" targetFramework="netnano1.0" />
+  <package id="nanoFramework.CoreLibrary" version="2.0.0-preview.29" targetFramework="netnano1.0" />
   <package id="Nerdbank.GitVersioning" version="3.9.50" developmentDependency="true" targetFramework="netnano1.0" />
 </packages>

System.Device.I2s/packages.lock.json

@@ -4,9 +4,9 @@
     ".NETnanoFramework,Version=v1.0": {
       "nanoFramework.CoreLibrary": {
         "type": "Direct",
-        "requested": "[1.17.11, 1.17.11]",
-        "resolved": "1.17.11",
-        "contentHash": "HezzAc0o2XrSGf85xSeD/6xsO6ohF9hX6/iMQ1IZS6Zw6umr4WfAN2Jv0BrPxkaYwzEegJxxZujkHoUIAqtOMw=="
+        "requested": "[2.0.0-preview.29, 2.0.0-preview.29]",
+        "resolved": "2.0.0-preview.29",
+        "contentHash": "7NDp9Sda9FTFBDN//X34r23rJBHUkCvyGvrFh9s5B8H2nMoet4J0OlEOiZRUsEPBXlsNpZFVp+Cd6OSjnLSg5A=="
       },
       "Nerdbank.GitVersioning": {
         "type": "Direct",

azure-pipelines.yml

@@ -52,6 +52,7 @@ steps:
 - template: azure-pipelines-templates/class-lib-build.yml@templates
   parameters:
     sonarCloudProject: 'nanoframework_nanoFramework.System.Device.I2s'
+    usePreviewBuild: true
 
 # step from template @ nf-tools repo
 # report error

nanoFramework.System.Device.I2s.nuspec

@@ -1,4 +1,4 @@
-<?xml version="1.0" encoding="utf-8"?>
+<?xml version="1.0" encoding="utf-8"?>
 <package xmlns="http://schemas.microsoft.com/packaging/2012/06/nuspec.xsd">
   <metadata>
     <id>nanoFramework.System.Device.I2s</id>
@@ -19,7 +19,7 @@
 This package requires a target with System.Device.I2s v$nativeVersion$ (checksum $checksum$).</description>
     <tags>nanoFramework C# csharp netmf netnf System.Device.I2s</tags>
     <dependencies>
-      <dependency id="nanoFramework.CoreLibrary" version="1.17.11" />
+      <dependency id="nanoFramework.CoreLibrary" version="2.0.0-preview.29" />
     </dependencies>
   </metadata>
   <files>
@@ -33,4 +33,4 @@ This package requires a target with System.Device.I2s v$nativeVersion$ (checksum
     <file src="assets\nf-logo.png" target="images" />
     <file src="LICENSE.md" target="" />
   </files>
-</package>
+</package>

nanoFramework.System.Device.I2s.sln

@@ -7,7 +7,6 @@ Project("{11A8DD76-328B-46DF-9F39-F559912D0360}") = "System.Device.I2s", "System
 EndProject
 Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "Solution Items", "Solution Items", "{0660B91C-D1F7-4940-8BD4-688D84E666D2}"
 	ProjectSection(SolutionItems) = preProject
-		nanoFramework.System.Device.I2s.DELIVERABLES.nuspec = nanoFramework.System.Device.I2s.DELIVERABLES.nuspec
 		nanoFramework.System.Device.I2s.nuspec = nanoFramework.System.Device.I2s.nuspec
 		NuGet.Config = NuGet.Config
 		version.json = version.json

version.json

@@ -1,6 +1,6 @@
 {
   "$schema": "https://raw.githubusercontent.com/dotnet/Nerdbank.GitVersioning/master/src/NerdBank.GitVersioning/version.schema.json",
-  "version": "1.0",
+  "version": "2.0.0-preview.{height}",
   "assemblyVersion": {
     "precision": "build"
   },