Add macOS nanoCLR host target scaffold

.github/workflows/osx-nanoclr.yml

@@ -0,0 +1,48 @@
+name: osx-nanoclr
+
+on:
+  push:
+    paths:
+      - "targets/osx/**"
+      - ".github/workflows/osx-nanoclr.yml"
+  pull_request:
+    paths:
+      - "targets/osx/**"
+      - ".github/workflows/osx-nanoclr.yml"
+
+jobs:
+  build-osx-nanoclr:
+    runs-on: macos-14
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Install Ninja (if missing)
+        run: |
+          if ! command -v ninja >/dev/null 2>&1; then
+            brew install ninja
+          fi
+
+      - name: Configure
+        run: |
+          cmake -S targets/osx -B build/osx -G Ninja \
+            -DNANO_OSX_ARCH=arm64 \
+            -DNANO_OSX_ENABLE_SMOKE=ON
+
+      - name: Build
+        run: cmake --build build/osx --verbose
+
+      - name: Smoke Run
+        run: |
+          set -euo pipefail
+          ./build/osx/bin/nanoFramework.nanoCLR --version | tee build/osx/smoke.log
+
+      - name: Upload Artifacts
+        if: always()
+        uses: actions/upload-artifact@v4
+        with:
+          name: osx-nanoclr
+          path: |
+            build/osx/bin/nanoFramework.nanoCLR
+            build/osx/smoke.log

azure-pipelines.yml

@@ -177,6 +177,7 @@ jobs:
               echo "##vso[task.setvariable variable=BUILD_TI;isOutput=true]false"
               echo "##vso[task.setvariable variable=BUILD_AZURERTOS;isOutput=true]false"
               echo "##vso[task.setvariable variable=BUILD_WIN32;isOutput=true]false"  
+              echo "##vso[task.setvariable variable=BUILD_OSX;isOutput=true]false"  
               echo "##vso[task.setvariable variable=BUILD_NANOCLR_CLI;isOutput=true]false"  
               echo "##vso[task.setvariable variable=BUILD_ALL;isOutput=true]false"  
 
@@ -250,6 +251,14 @@ jobs:
 
                   Write-host "##[command] Building nanoCLR target"
               }
+
+              if( ($files.where{$_.Contains('targets/osx')}).Count -gt 0)
+              {
+                  # files at OSX folder
+                  echo "##vso[task.setvariable variable=BUILD_OSX;isOutput=true]true"
+
+                  Write-host "##[command] Building OSX nanoCLR target"
+              }
 
               if( 
                 (($files.where{$_.Contains('targets/netcore/nanoFramework.nanoCLR.CLI')}).Count -gt 0) -Or
@@ -1033,6 +1042,36 @@ jobs:
 
       - template: azure-pipelines-templates/publish-nanoclr.yml
 
+  #################
+  # OSX host target
+  - job: Build_OSX_nanoCLR
+    dependsOn:
+      - Check_Build_Options
+
+    condition: >-
+      and(
+        succeeded(),
+        eq(dependencies.Check_Build_Options.outputs['TargetsToBuild.BUILD_OSX'], true)
+      )
+
+    pool:
+      vmImage: "macos-14"
+
+    steps:
+      - checkout: self
+
+      - bash: |
+          set -euo pipefail
+
+          if ! command -v ninja >/dev/null; then
+            brew install ninja
+          fi
+
+          cmake -S targets/osx -B build/osx -G Ninja -DNANO_OSX_ARCH=arm64 -DNANO_OSX_ENABLE_SMOKE=ON
+          cmake --build build/osx
+          ./build/osx/bin/nanoFramework.nanoCLR --version | tee build/osx/smoke.log
+        displayName: Build and smoke run OSX nanoCLR
+
   #################
   # nanoCLR CLI tool
   - job: Build_nanoCLR_CLI
@@ -1367,6 +1406,7 @@ jobs:
       - Build_TI_SimpleLink_targets
       - Build_Azure_RTOS_targets
       - Build_WIN32_nanoCLR
+      - Build_OSX_nanoCLR
       - Build_nanoCLR_CLI
       - Check_Code_Style
     condition: >-
@@ -1379,6 +1419,7 @@ jobs:
           failed('Build_TI_SimpleLink_targets'),
           failed('Build_Azure_RTOS_targets'),
           failed('Build_WIN32_nanoCLR'),
+          failed('Build_OSX_nanoCLR'),
           failed('Build_nanoCLR_CLI')
         )
       )

targets/osx/CMakeLists.txt

@@ -0,0 +1,25 @@
+#
+# Copyright (c) .NET Foundation and Contributors
+# See LICENSE file in the project root for full license information.
+#
+
+cmake_minimum_required(VERSION 3.24)
+
+project(nanoFramework_nanoCLR_osx VERSION 0.1.0 LANGUAGES C CXX)
+
+if(NOT APPLE)
+    message(FATAL_ERROR "targets/osx can only be built on macOS.")
+endif()
+
+set(NANO_OSX_ARCH "arm64" CACHE STRING "Target architecture for macOS host build (arm64 or x86_64)")
+set_property(CACHE NANO_OSX_ARCH PROPERTY STRINGS arm64 x86_64)
+
+if(NOT NANO_OSX_ARCH STREQUAL "arm64" AND NOT NANO_OSX_ARCH STREQUAL "x86_64")
+    message(FATAL_ERROR "Invalid NANO_OSX_ARCH='${NANO_OSX_ARCH}'. Valid values: arm64, x86_64.")
+endif()
+
+set(CMAKE_OSX_ARCHITECTURES "${NANO_OSX_ARCH}" CACHE STRING "macOS architecture" FORCE)
+
+option(NANO_OSX_ENABLE_SMOKE "Build smoke behavior (--help/--version/banner)." ON)
+
+add_subdirectory(nanoCLR)

targets/osx/Include/TargetHAL_Spi.h

@@ -0,0 +1,15 @@
+//
+// Copyright (c) .NET Foundation and Contributors
+// See LICENSE file in the project root for full license information.
+//
+
+#ifndef TARGET_HAL_SPI_H
+#define TARGET_HAL_SPI_H
+
+// # of buses
+#define NUM_SPI_BUSES 0
+
+// Maximum number of devices per SPI bus
+#define MAX_SPI_DEVICES 5
+
+#endif // TARGET_HAL_SPI_H

targets/osx/Include/nanoHAL_Boot.h

@@ -0,0 +1,9 @@
+//
+// Copyright (c) .NET Foundation and Contributors
+// See LICENSE file in the project root for full license information.
+//
+
+#ifndef NANOHAL_BOOT_H
+#define NANOHAL_BOOT_H
+
+#endif // NANOHAL_BOOT_H

targets/osx/Include/nanoHAL_Capabilites.h

@@ -0,0 +1,9 @@
+//
+// Copyright (c) .NET Foundation and Contributors
+// See LICENSE file in the project root for full license information.
+//
+
+#ifndef NANOHAL_CAPABILITIES_H
+#define NANOHAL_CAPABILITIES_H
+
+#endif // NANOHAL_CAPABILITIES_H

targets/osx/Include/targetHAL.h

@@ -0,0 +1,84 @@
+//
+// Copyright (c) .NET Foundation and Contributors
+// See LICENSE file in the project root for full license information.
+//
+
+#ifndef TARGET_HAL_H
+#define TARGET_HAL_H
+
+#include <chrono>
+#include <csignal>
+#include <cstdint>
+#include <thread>
+
+// Keep the same macro shape used by other targets.
+#define PLATFORM_DELAY(milliSecs) std::this_thread::sleep_for(std::chrono::milliseconds((milliSecs)))
+
+// Start with the same minimum socket count used by win32 host.
+#define PLATFORM_DEPENDENT__SOCKETS_MAX_COUNT 1
+
+#define NANOCLR_STOP() std::raise(SIGTRAP)
+
+inline bool Target_ConfigUpdateRequiresErase()
+{
+    return true;
+}
+
+inline bool Target_HasNanoBooter()
+{
+    return false;
+}
+
+inline bool Target_CanChangeMacAddress()
+{
+    return false;
+}
+
+inline bool Target_IFUCapable()
+{
+    return false;
+}
+
+inline bool Target_HasProprietaryBooter()
+{
+    return false;
+}
+
+inline uint32_t GetPlatformCapabilities()
+{
+    return 0;
+}
+
+inline uint32_t GetTargetCapabilities()
+{
+    return 0;
+}
+
+inline bool RequestToLaunchProprietaryBootloader()
+{
+    return false;
+}
+
+inline bool RequestToLaunchNanoBooter(int32_t errorCode)
+{
+    (void)errorCode;
+    return false;
+}
+
+inline uint32_t CPU_TicksPerSecond()
+{
+    // 100ns ticks to align with nanoCLR time usage in virtual-device mode.
+    return 10000000U;
+}
+
+inline uint64_t CPU_MicrosecondsToTicks(uint64_t uSec)
+{
+    return uSec * 10ULL;
+}
+
+inline uint64_t CPU_MillisecondsToTicks(uint64_t mSec)
+{
+    return mSec * 10000ULL;
+}
+
+#endif // TARGET_HAL_H

targets/osx/Include/targetHAL_Power.h

@@ -0,0 +1,21 @@
+//
+// Copyright (c) .NET Foundation and Contributors
+// See LICENSE file in the project root for full license information.
+//
+
+#ifndef TARGET_HAL_POWER_H
+#define TARGET_HAL_POWER_H
+
+#include <cstdlib>
+
+inline void CPU_Reset()
+{
+    std::exit(0);
+}
+
+inline bool CPU_IsSoftRebootSupported()
+{
+    return true;
+}
+
+#endif // TARGET_HAL_POWER_H

targets/osx/Include/targetHAL_Time.h

@@ -0,0 +1,15 @@
+//
+// Copyright (c) .NET Foundation and Contributors
+// See LICENSE file in the project root for full license information.
+//
+
+#ifndef TARGET_HAL_TIME_H
+#define TARGET_HAL_TIME_H
+
+#include <cstdint>
+
+uint64_t HAL_Time_CurrentSysTicks();
+void HAL_Time_Sleep_MicroSeconds(unsigned int uSec);
+void HAL_Time_Sleep_MicroSeconds_InterruptEnabled(unsigned int uSec);
+
+#endif // TARGET_HAL_TIME_H

targets/osx/Include/targetPAL_time.h

@@ -0,0 +1,9 @@
+//
+// Copyright (c) .NET Foundation and Contributors
+// See LICENSE file in the project root for full license information.
+//
+
+#ifndef TARGET_PAL_TIME_H
+#define TARGET_PAL_TIME_H
+
+#endif // TARGET_PAL_TIME_H

targets/osx/Include/target_BlockStorage.h

@@ -0,0 +1,12 @@
+//
+// Copyright (c) .NET Foundation and Contributors
+// See LICENSE file in the project root for full license information.
+//
+
+#ifndef TARGETPAL_BLOCKSTORAGE_H
+#define TARGETPAL_BLOCKSTORAGE_H
+
+// Start with the same value as win32 target profile.
+#define TARGET_BLOCKSTORAGE_COUNT 1
+
+#endif // TARGETPAL_BLOCKSTORAGE_H

targets/osx/Include/target_board.h

@@ -0,0 +1,9 @@
+//
+// Copyright (c) .NET Foundation and Contributors
+// See LICENSE file in the project root for full license information.
+//
+
+#ifndef TARGET_BOARD_H
+#define TARGET_BOARD_H
+
+#endif // TARGET_BOARD_H

targets/osx/Include/target_common.h

@@ -0,0 +1,14 @@
+//
+// Copyright (c) .NET Foundation and Contributors
+// See LICENSE file in the project root for full license information.
+//
+
+#ifndef TARGET_COMMON_H
+#define TARGET_COMMON_H
+
+#define TARGETNAMESTRING    "Virtual nanoDevice"
+#define PLATFORMNAMESTRING  "OSX"
+#define TARGETINFOSTRING    "CLR for OSX"
+#define OEMSYSTEMINFOSTRING "nanoCLR running @ OSX"
+
+#endif // TARGET_COMMON_H

targets/osx/Include/target_os.h

@@ -0,0 +1,11 @@
+//
+// Copyright (c) .NET Foundation and Contributors
+// See LICENSE file in the project root for full license information.
+//
+
+#ifndef TARGET_OS_H
+#define TARGET_OS_H
+
+#define TARGET_HAS_NANOBOOTER 0
+
+#endif // TARGET_OS_H

targets/osx/Include/target_platform.h

@@ -0,0 +1,9 @@
+//
+// Copyright (c) .NET Foundation and Contributors
+// See LICENSE file in the project root for full license information.
+//
+
+#ifndef TARGET_PLATFORM_H
+#define TARGET_PLATFORM_H
+
+#endif // TARGET_PLATFORM_H