Merge pull request #1731 from nanoframework/release-v1.5.0

Release release-v1.5.0

Author: josesimoes

.clang-format

@@ -0,0 +1,141 @@
+#
+# Copyright (c) .NET Foundation and Contributors
+# See LICENSE file in the project root for full license information.
+#
+
+---
+Language: Cpp
+# BasedOnStyle: Microsoft
+AccessModifierOffset: -2
+AlignAfterOpenBracket: AlwaysBreak
+AlignConsecutiveMacros: true
+AlignConsecutiveAssignments: false
+AlignConsecutiveDeclarations: false
+AlignEscapedNewlines: Right
+AlignOperands: true
+AlignTrailingComments: true
+AllowAllArgumentsOnNextLine: false
+AllowAllConstructorInitializersOnNextLine: true
+AllowAllParametersOfDeclarationOnNextLine: false
+AllowShortBlocksOnASingleLine: false
+AllowShortCaseLabelsOnASingleLine: false
+AllowShortFunctionsOnASingleLine: None
+AllowShortLambdasOnASingleLine: All
+AllowShortIfStatementsOnASingleLine: Never
+AllowShortLoopsOnASingleLine: false
+AlwaysBreakAfterDefinitionReturnType: None
+AlwaysBreakAfterReturnType: None
+AlwaysBreakBeforeMultilineStrings: false
+AlwaysBreakTemplateDeclarations: MultiLine
+BinPackArguments: false
+BinPackParameters: false
+BraceWrapping:
+  AfterCaseLabel: true
+  AfterClass: true
+  AfterControlStatement: true
+  AfterEnum: true
+  AfterFunction: true
+  AfterNamespace: true
+  AfterObjCDeclaration: true
+  AfterStruct: true
+  AfterUnion: false
+  AfterExternBlock: true
+  BeforeCatch: true
+  BeforeElse: true
+  IndentBraces: false
+  SplitEmptyFunction: true
+  SplitEmptyRecord: true
+  SplitEmptyNamespace: true
+BreakBeforeBinaryOperators: None
+BreakBeforeBraces: Custom
+BreakBeforeInheritanceComma: false
+BreakInheritanceList: BeforeColon
+BreakBeforeTernaryOperators: true
+BreakConstructorInitializersBeforeComma: false
+BreakConstructorInitializers: BeforeColon
+BreakAfterJavaFieldAnnotations: false
+BreakStringLiterals: true
+ColumnLimit: 120
+CommentPragmas: '^ IWYU pragma:'
+CompactNamespaces: false
+ConstructorInitializerAllOnOneLineOrOnePerLine: false
+ConstructorInitializerIndentWidth: 4
+ContinuationIndentWidth: 4
+Cpp11BracedListStyle: true
+DeriveLineEnding: true
+DerivePointerAlignment: false
+DisableFormat: false
+ExperimentalAutoDetectBinPacking: true
+FixNamespaceComments: true
+ForEachMacros:
+  - foreach
+  - Q_FOREACH
+  - BOOST_FOREACH
+IncludeBlocks: Preserve
+IncludeCategories:
+  - Regex: '^"(llvm|llvm-c|clang|clang-c)/'
+    Priority: 2
+    SortPriority: 0
+  - Regex: '^(<|"(gtest|gmock|isl|json)/)'
+    Priority: 3
+    SortPriority: 0
+  - Regex: '.*'
+    Priority: 1
+    SortPriority: 0
+IncludeIsMainRegex: '(Test)?$'
+IncludeIsMainSourceRegex: ''
+IndentCaseLabels: true
+IndentGotoLabels: true
+IndentPPDirectives: None
+IndentWidth: 4
+IndentWrappedFunctionNames: true
+JavaScriptQuotes: Leave
+JavaScriptWrapImports: true
+KeepEmptyLinesAtTheStartOfBlocks: true
+MacroBlockBegin: ''
+MacroBlockEnd: ''
+MaxEmptyLinesToKeep: 1
+NamespaceIndentation: None
+ObjCBinPackProtocolList: Auto
+ObjCBlockIndentWidth: 2
+ObjCSpaceAfterProperty: false
+ObjCSpaceBeforeProtocolList: true
+PenaltyBreakAssignment: 2
+PenaltyBreakBeforeFirstCallParameter: 19
+PenaltyBreakComment: 300
+PenaltyBreakFirstLessLess: 120
+PenaltyBreakString: 1000
+PenaltyBreakTemplateDeclaration: 10
+PenaltyExcessCharacter: 1000000
+PenaltyReturnTypeOnItsOwnLine: 1000
+PointerAlignment: Right
+ReflowComments: true
+SortIncludes: false
+SortUsingDeclarations: true
+SpaceAfterCStyleCast: false
+SpaceAfterLogicalNot: false
+SpaceAfterTemplateKeyword: true
+SpaceBeforeAssignmentOperators: true
+SpaceBeforeCpp11BracedList: false
+SpaceBeforeCtorInitializerColon: true
+SpaceBeforeInheritanceColon: true
+SpaceBeforeParens: ControlStatements
+SpaceBeforeRangeBasedForLoopColon: true
+SpaceInEmptyBlock: false
+SpaceInEmptyParentheses: false
+SpacesBeforeTrailingComments: 1
+SpacesInAngles: false
+SpacesInConditionalStatement: false
+SpacesInContainerLiterals: true
+SpacesInCStyleCastParentheses: false
+SpacesInParentheses: false
+SpacesInSquareBrackets: false
+SpaceBeforeSquareBrackets: false
+Standard: Latest
+StatementMacros:
+  - Q_UNUSED
+  - QT_REQUIRE_VERSION
+TabWidth: 4
+UseCRLF: false
+UseTab: Never
+...

.gitignore

@@ -6,16 +6,17 @@
 /build/
 /build/.gitkeep
 
-# ignore cmake-variants file (will change frequently per user/board setup, use should derive content from cmake-variants.TEMPLATE.json)
-cmake-variants.json
+# ignore cmake-variants file (will change per user/board setup, developers should derive content from cmake-variants.TEMPLATE.json)
+/cmake-variants.json
+.vscode/cmake-variants.json
 
 # ignore any content inside the Interop assemblies folder
 InteropAssemblies/*
 !InteropAssemblies/CLR_RT_InteropAssembliesTable.cpp.in
 !InteropAssemblies/README.md
 
 # Visual Studio Code
-# ignore C/C++ launch file (will change frequently per user/board setup, use should derive content from launch.TEMPLATE.json)
+# ignore C/C++ launch file (will change frequently per user/board setup, developers should derive content from launch.TEMPLATE.json)
 .vscode/launch.json
 .vscode/.cmaketools.json
 .vscode/settings.json

.typo-ci.yml

@@ -0,0 +1,25 @@
+dictionaries:
+  - en
+  - en_GB
+
+# Any files/folders we should ignore?
+excluded_files:
+  - ".typo-ci.yml"
+  - ".gitignore"
+
+# Any typos we should ignore?
+excluded_words:
+  - nanoFramework
+  - llvm
+  - vso
+  - autocrlf
+  - uart
+  - gpio
+  - csharp
+  - dotnet
+  - spi
+  - i2c
+  - pwm
+  
+# Would you like filenames to also be spellchecked?
+spellcheck_filenames: true

.vscode/cmake-variants.TEMPLATE.json

@@ -0,0 +1,107 @@
+{
+  "buildType": {
+    "default": "debug",
+    "choices": {
+      "debug": {
+        "short": "Debug",
+        "long": "Emit debug information without performing optimizations",
+        "buildType": "Debug"
+      },
+      "minsize": {
+        "short": "MinSizeRel",
+        "long": "Optimize for smallest binary size",
+        "buildType": "MinSizeRel"
+      },
+      "reldeb": {
+        "short": "RelWithDebInfo",
+        "long": "Perform optimizations AND include debugging information",
+        "buildType": "RelWithDebInfo"
+      }
+    }
+  },
+  "linkage": {
+    "default": "",
+    "choices": {
+      "OPTION_NAME_HERE": {
+        "short": "<summary-here>",
+        "settings": {
+          "BUILD_VERSION": "0.9.99.999",
+          "CMAKE_TOOLCHAIN_FILE": "CMake/toolchain.<arm-none-eabi-OR-xtensa-esp32-elf>.cmake",
+          "TOOLCHAIN_PREFIX": "<path-to-gcc-toolchain-mind-the-forward-slash>",
+          "TOOL_HEX2DFU_PREFIX": "<path-to-hex2dfu-utility-mind-the-forward-slash>",
+          "ESP32_IDF_PATH": "<path-to-esp32-idf-mind-the-forward-slash>/esp-idf",
+          "ESP32_LIBS_PATH": "<path-to-esp32-libraries-mind-the-forward-slash>/libs",
+          "ESP32_BOARD": "ESP32_WROOM_32",
+          "EXECUTABLE_OUTPUT_PATH": "${workspaceRoot}/build",
+          "TARGET_SERIES": "<series-name-of-the-target-chip-STM32F0xx-STM32F4xx-STM32F7xx-ESP32-CC32xx>",
+          "USE_RNG": "<ON-default-for-using-hardware-true-random-generator-unit>",
+          "DP_FLOATINGPOINT": "<OFF-default-ON-for-adding-support-for-double-precision-floating-point>",
+          "SUPPORT_ANY_BASE_CONVERSION": "<OFF-default-ON-for-adding-support-for-conversion-strings-to-values-on-any-base>",
+          "RTOS": "<one-of-valid-rtos-options-CHIBIOS-FREERTOS-FREERTOS_ESP32-TI_SIMPLELINK>",
+          "RTOS_SOURCE_FOLDER": "<path-to-RTOS-source-folder-if-supported-mind-the-forward-slash>",
+          "CHIBIOS_CONTRIB_REQUIRED": "OFF-default-ON-to-include_ChibiOS-Contrib-repository-in-the-build",
+          "CHIBIOS_CONTRIB_SOURCE": "<path-to-local-ChibiOS-contrib-source-mind-the-forward-slash>",
+          "FREERTOS_BOARD": "<valid-freertos-board-name-from-boards-collection>",
+          "RTOS_VERSION": "<valid-rtos-git-branch-if-empty-use-default-cmake-setting>",
+          "RTOS_SOURCE": "<path-to-rtos-source-mind-the-forward-slash>",
+          "CMSIS_SOURCE": "<path-to-cmsis-source-mind-the-forward-slash>",
+          "CMSIS_VERSION": "<valid-cmsis-version-if-empty-use-default-set-cmake>",
+          "CHIBIOS_BOARD": "<valid-chibios-board-name-from-boards-collection>",
+          "STM32_CUBE_PACKAGE_REQUIRED": "<OFF-default-ON-to-include_STM-cube-package-in-the-build>",
+          "STM32_CUBE_PACKAGE_SOURCE": "<path-to-stm32-cubemx-package-mind-the-forward-slash>",
+          "TI_BOARD": "<valid-TI-board-name-from-boards-collection>",
+          "TI_SL_CC32xx_SDK_SOURCE": "<path-to-local-TI-SimpleLink-CC32xx-SDK-source-mind-the-forward-slash>",
+          "TI_SL_CC13x2_26x2_SDK_SOURCE": "<path-to-local-TI-SimpleLink-CC13x2_26x2-SDK-source-mind-the-forward-slash>",
+          "TI_XDCTOOLS_SOURCE": "<path-to-local-TI-XDC-Tools-source-mind-the-forward-slash>",
+          "TI_SYSCONFIG_SOURCE": "<path-to-local-TI-SYSCONFIG-Tool-source-mind-the-forward-slash>",
+          "SPIFFS_SOURCE": "<path-to-local-SPIFFS-source-mind-the-forward-slash>",
+          "SWO_OUTPUT": "OFF-default-ON-to-enable-ARM-CortexM-Single-Wire-Output",
+          "FATFS_VERSION": "<valid-fatfs-version-if-empty-use-default-set-cmake>",
+          "FATFS_SOURCE": "<path-to-local-FATFS-source-mind-the-forward-slash>",
+          "LWIP_VERSION": "<valid-lwip-version-if-empty-use-default-set-cmake>",
+          "NF_BUILD_RTM": "OFF-default-ON-to-enable-RTM-build",
+          "NF_WP_TRACE_ERRORS": "OFF-default-ON-to-enable-trace-error-messages-wire-protocol",
+          "NF_WP_TRACE_HEADERS": "OFF-default-ON-to-enable-trace-header-messages-wire-protocol",
+          "NF_WP_TRACE_STATE": "OFF-default-ON-to-enable-trace-state-messages-wire-protocol",
+          "NF_WP_TRACE_NODATA": "OFF-default-ON-to-enable-trace-no-data-messages-wire-protocol",
+          "NF_WP_TRACE_ALL": "OFF-default-ON-to-enable-trace-all-messages-wire-protocol",
+          "NF_WP_IMPLEMENTS_CRC32": "ON-default-OFF-to-disable-CRC32-wire-protocol",
+          "NF_FEATURE_DEBUGGER": "OFF-default-ON-to-include-managed-app-debugging-capability",
+          "NF_FEATURE_RTC": "OFF-default-ON-to-enable-hardware-RTC",
+          "NF_FEATURE_USE_APPDOMAINS": "OFF-default-ON-to-enable-support-for-Application-Domains",
+          "NF_FEATURE_SUPPORT_REFLECTION": "ON-default-OFF-to-disable-support-for-System.Reflection-API",
+          "NF_FEATURE_WATCHDOG": "ON-to-enable-hardware-watchdog-ON-is-default",
+          "NF_FEATURE_HAS_CONFIG_BLOCK": "OFF-default-ON-to-enable-configuration-block-storage",
+          "NF_FEATURE_HAS_SDCARD": "OFF-default-ON-to-enable-support-for-SDCard-storage-device",
+          "NF_FEATURE_HAS_USB_MSD": "OFF-default-ON-to-enable-support-for-USB-Mass-storage-device",
+          "NF_FEATURE_USE_SPIFFS": "OFF-default-ON-to-enable-support-for-SPI-flash-file-system",
+          "NF_PLATFORM_NO_CLR_TRACE": "OFF-default-ON-to-disable-all-trace-on-CLR",
+          "NF_CLR_NO_IL_INLINE": "OFF-default-ON-to-disable-CLR-IL-inlining",
+          "NF_INTEROP_ASSEMBLIES": "assembly-namespaces-separated-by-whitespace-leave-empty-to-NOT-include-any-interop-assemblies",
+          "NF_NETWORKING_SNTP": "ON-default-to-add-SNTP-client-requires-networking",
+          "NF_SECURITY_MBEDTLS": "OFF-default-ON-to-add-network-security-from-mbedTLS",
+          "MBEDTLS_SOURCE": "<path-to-mbedtls-source-mind-the-forward-slashes>",
+          "API_nanoFramework.Devices.Can": "OFF-default-ON-to-add-this-API",
+          "API_nanoFramework.Devices.OneWire": "OFF-default-ON-to-add-this-API",
+          "API_nanoFramework.ResourceManager": "OFF-default-ON-to-add-this-API",
+          "API_nanoFramework.System.Collections": "OFF-default-ON-to-add-this-API",
+          "API_nanoFramework.System.Text": "OFF-default-ON-to-add-this-API",
+          "API_System.Math": "OFF-default-ON-to-add-this-API",
+          "API_System.Net": "OFF-default-ON-to-add-this-API",
+          "API_Windows.Devices.Adc": "OFF-default-ON-to-add-this-API",
+          "API_System.Device.Dac": "OFF-default-ON-to-add-this-API",
+          "API_Windows.Devices.Gpio": "OFF-default-ON-to-add-this-API",
+          "API_Windows.Devices.I2c": "OFF-default-ON-to-add-this-API",
+          "API_Windows.Devices.Pwm": "OFF-default-ON-to-add-this-API",
+          "API_Windows.Devices.SerialCommunication": "OFF-default-ON-to-add-this-API",
+          "API_Windows.Devices.Spi": "OFF-default-ON-to-add-this-API",
+          "API_Windows.Networking.Sockets": "OFF-default-ON-to-add-this-API",
+          "API_Hardware.Esp32": "OFF-default-ON-to-add-this-API",
+          "API_Hardware.Stm32": "OFF-default-ON-to-add-this-API",
+          "API_nanoFramework.TI.EasyLink": "OFF-default-ON-to-add-this-API",
+          "API_nanoFramework.Hardware.Esp32.Rmt": "OFF-default-ON-to-add-this-API"
+        }
+      }
+    }
+  }
+}