---

Document Language: English | 中文简体

Welcome to the .NET nanoFramework interpreter repository!

Build status

Component	Build Status
nanoBooter + nanoCLR
Win32 test project

Preview version with support for generics

There is currently ongoing a Public Preview of the CLR with support for C# generics. If you want to use this feature please refer to the documentation.

.NET nanoFramework interpreter for reference boards

Each of the linked files contain the firmware binaries for nanoBooter (if applicable) and nanoCLR in various formats (.HEX, .BIN and .DFU). They should be flashed to the target board using nanoff or the appropriate software utility depending on the target MCU.

Firmware versions contained below are released via the main branch, and are treated as RTM builds as per our stable release mandate. These releases are compiled with optimizations and the smallest possible size. For these builds, the debugging features are also disabled and only contain no (or minimal) detailed error messages.

We also have a Community Targets repository where you can find firmware versions for several other popular boards that have been contibuted by the community, although limited support is provided.

Available pre-built targets
ESP32 boards	ESP32 boards with ethernet	ESP32_S2 & ESP32_S3 boards
ESP32 riscv (C3,C5,C6,C61,P4 & H2)	ESP32 M5STACK
STM32 boards
Silicon Labs Giant Gecko
Raspberry Pi boards
NXP boards
TI boards

---

ESP32 modules and boards

Target	Note	Stable	Preview
ESP32_REV0
ESP32_PSRAM_REV0
ESP32_BLE_REV0
ESP32_PSRAM_XTAL26_REV0
ESP32_GenericDisplay_REV0
ESP32_REV3
ESP32_PSRAM_REV3
ESP32_CAM_REV3	Camera support
ESP32_BLE_REV3
ESP32_PSRAM_BLE_GenericGraphic_REV3
ESP32_PSRAM_REV3_IPV6	IPV6 & Thread via NCP
ESP_WROVER_KIT
ESP32_PICO

ESP32 boards with inbuilt Ethernet

Target	Note	Stable	Preview
ESP32_ETHERNET_KIT_1.2	Poe, Wrover + 8mb psram
ESP32_OLIMEX	Poe
ESP32_OLIMEX_WROVER	Poe, Wrover + 8mb psram
ESP32_WT32_ETH01
ESP32_WESP32	Poe
ESP32_LILYGO	Poe

ESP32_S2 and ESP32_S3 boards

Target	Note	Stable	Preview
ESP32_S2	Uart or USB -> VS. Including Adafruit Feather_S2
ESP32_S2_CAM	Camera support
ESP32_S3_QUAD	Display, BLE, Quad spiram support, Uart or USB/JTAG -> VS
ESP32_S3_QUAD_CAM	Display, BLE, Quad SPIRAM and camera support
ESP32_S3_OCTAL	Display, BLE, Octal spiram support, Uart or USB/JTAG -> VS
ESP32_S3_OCTAL_CAM	Display, BLE, Octal SPIRAM and camera support

ESP32 risc-v boards

Target	Note	Stable	Preview
ESP32_C3_BETA	Uart -> VS (pre production version)
ESP32_C3	Uart or USB/JTAG -> VS
ESP32_C5_THREAD	Uart or USB/JTAG -> VS, OpenThread, Generic display, psram, Wifi 2.4ghz & 5ghz
ESP32_C6_THREAD	Uart or USB/JTAG -> VS, OpenThread, Generic display
ESP32_C61	BETA - Uart or USB/JTAG -> VS, Generic display, no RMT, Bluetooth crashes
ESP32_H2_THREAD	Uart or USB/JTAG -> VS, OpenThread
ESP32_P4	BETA, P4 chips rev 3.0 or later, Uart or USB/JTAG -> VS, wifi ESP32_C6, No Display
ESP32_P4_REV_LESS3	BETA, P4 chips with rev less than 3.0, Uart or USB/JTAG -> VS, wifi ESP32_C6, No Display

M5Stack

Target	Note	Stable	Preview
M5Core
M5StickC
M5StickCPlus
M5Core2
AtomS3

STM32 boards and chip based

Target	Stable	Preview
MXCHIP_AZ3166
ST_STM32F429I_DISCOVERY (E01+)
ST_NUCLEO64_F091RC
ST_STM32F769I_DISCOVERY
ST_STM32H735_DISCOVERY
ST_B_L475E_IOT01A
ORGPAL_PALTHREE
ORGPAL_PALX

Silicon Labs Giant Gecko boards

Target	Stable	Preview
SL_STK3701A
SL_STK3701A_REVB

NXP boards

Target	Stable	Preview
NXP_MIMXRT1060_EVK

Raspberry Pi boards

Target	Note	Stable	Preview
PICO_RP2040	Raspberry Pi Pico
PICO2_RP2350	Raspberry Pi Pico 2
PICO_RP2040_W	Raspberry Pi Pico W with WiFi
PICO2_RP2350_W	Raspberry Pi Pico 2 W with WiFi

TI boards

Target	Stable	Preview
TI_CC1352R1_LAUNCHXL_868
TI_CC1352R1_LAUNCHXL_915
TI_CC3220SF_LAUNCHXL

The above .NET nanoFramework interpreter builds include support for the class libraries and features marked below.

Click to expand!

Target	Gpio	Spi	I2c	Pwm	Adc	Dac	Serial	OneWire	Events	SWO	Networking	Bluetooth BLE	Large Heap	UI
ESP32_PSRAM_REV0	✔️	✔️	✔️	✔️	✔️	✔️	✔️	✔️	✔️		✔️		✔️
ESP32_REV0	✔️	✔️	✔️	✔️	✔️	✔️	✔️	✔️	✔️		✔️		✔️
ESP32_PSRAM_XTAL26_REV0	✔️	✔️	✔️	✔️	✔️	✔️	✔️	✔️	✔️		✔️		✔️
ESP32_PSRAM_REV3	✔️	✔️	✔️	✔️	✔️	✔️	✔️	✔️	✔️		✔️		✔️
ESP32_REV3	✔️	✔️	✔️	✔️	✔️	✔️	✔️	✔️	✔️		✔️		✔️
ESP32_BLE_REV0	✔️	✔️	✔️	✔️	✔️	✔️	✔️	✔️	✔️		✔️	✔️
ESP32_BLE_REV3	✔️	✔️	✔️	✔️	✔️	✔️	✔️	✔️	✔️		✔️	✔️
ESP_WROVER_KIT	✔️	✔️	✔️	✔️	✔️	✔️	✔️	✔️	✔️		✔️		✔️	✔️
ESP32_PICO	✔️	✔️	✔️	✔️	✔️	✔️	✔️	✔️	✔️		✔️
ESP32_LILYGO	✔️	✔️	✔️	✔️	✔️	✔️	✔️	✔️	✔️		✔️ Wi-Fi + Ethernet
ESP32_S2_USB	✔️	✔️	✔️	✔️	✔️	✔️	✔️	✔️	✔️		✔️
ESP32_S2_UART	✔️	✔️	✔️	✔️	✔️	✔️	✔️	✔️	✔️		✔️			✔️
ESP32_C3	✔️	✔️	✔️	✔️	✔️		✔️	✔️	✔️		✔️
XIAO_ESP32C3	✔️	✔️	✔️	✔️	✔️		✔️	✔️	✔️		✔️
ESP32_C6	✔️	✔️	✔️	✔️	✔️		✔️	✔️	✔️		✔️
ESP32_H2	✔️	✔️	✔️	✔️	✔️		✔️	✔️	✔️		✔️
ESP32_ETHERNET_KIT_1.2	✔️	✔️	✔️	✔️	✔️	✔️	✔️	✔️		✔️	✔️ Wi-Fi + Ethernet		✔️
ESP32_OLIMEX	✔️	✔️	✔️	✔️	✔️	✔️	✔️	✔️		✔️	✔️ Wi-Fi + Ethernet		✔️
ESP32_WT32_ETH01	✔️	✔️	✔️	✔️	✔️	✔️	✔️	✔️		✔️	✔️ Wi-Fi + Ethernet		✔️
ESP32_WESP32	✔️	✔️	✔️	✔️	✔️	✔️	✔️	✔️		✔️	✔️ Wi-Fi + Ethernet		✔️
M5Core	✔️	✔️	✔️	✔️	✔️	✔️	✔️	✔️		✔️	✔️ Wi-Fi		✔️
M5StickC	✔️	✔️	✔️	✔️	✔️	✔️	✔️	✔️		✔️	✔️ Wi-Fi		✔️
M5StickCPlus	✔️	✔️	✔️	✔️	✔️	✔️	✔️	✔️		✔️	✔️ Wi-Fi		✔️
M5Core2	✔️	✔️	✔️	✔️	✔️	✔️	✔️	✔️		✔️	✔️ Wi-Fi		✔️
ESP32_GenericDisplay_REV0	✔️	✔️	✔️	✔️	✔️	✔️	✔️	✔️		✔️	✔️ Wi-Fi		✔️
ESP32_PSRAM_BLE_GenericGraphic_REV3	✔️	✔️	✔️	✔️	✔️	✔️	✔️	✔️		✔️	✔️ Wi-Fi		✔️
MXCHIP_AZ3166	✔️	✔️	✔️	✔️			✔️
ST_STM32F429I_DISCOVERY (E01+)	✔️	✔️	✔️	✔️	✔️		✔️	✔️	✔️	✔️			✔️
ST_NUCLEO64_F091RC	✔️	✔️	✔️	✔️			✔️	✔️	✔️	✔️
ST_STM32F769I_DISCOVERY	✔️	✔️	✔️	✔️	✔️	✔️	✔️	✔️	✔️	✔️	✔️		✔️	✔️
ST_STM32H735_DISCOVERY	✔️	✔️	✔️	✔️	✔️	✔️	✔️	✔️	✔️	✔️	✔️
ST_B_L475E_IOT01A	✔️	✔️	✔️				✔️		✔️		✔️ Wi-Fi, no TLS
ORGPAL_PALTHREE	✔️	✔️	✔️	✔️	✔️	✔️	✔️	✔️	✔️	✔️	✔️		✔️
ORGPAL_PALX	✔️	✔️	✔️	✔️	✔️	✔️	✔️	✔️	✔️	✔️	✔️		✔️
SL_STK3701A_REVB	✔️	✔️	✔️	✔️	✔️		✔️		✔️	✔️
SL_STK3701A	✔️	✔️	✔️	✔️	✔️		✔️		✔️	✔️
TI_CC1352R1_LAUNCHXL	✔️
TI_CC3220SF_LAUNCHXL	✔️	✔️	✔️	✔️	✔️				✔️		✔️
NXP_MIMXRT1060_EVK	✔️						✔️		✔️		✔️		✔️
PICO_RP2040	✔️	✔️	✔️	✔️	✔️		✔️
PICO2_RP2350	✔️	✔️	✔️	✔️	✔️		✔️
PICO_RP2040_W	✔️	✔️	✔️	✔️	✔️		✔️				✔️ Wi-Fi
PICO2_RP2350_W	✔️	✔️	✔️	✔️	✔️		✔️				✔️ Wi-Fi

This repo contains:

• nanoFramework agnostic blocks
  • CLR
  • HAL
  • PAL
• Target reference for CMSIS OS
  • ChibiOS
    • Reference target boards
      • OrgPal PalThree
      • OrgPal PalX
      • ST NUCLEO64 F091RC
      • ST STM32F429I DISCOVERY (E01+)
      • ST STM32F769I DISCOVERY
      • ST STM32H735 DISCOVERY
      • ST B-L475E-IOT01A (WiFi only, no TLS/HTTPS support - see board README)
    • ChibiOS overlay for nanoFramework
      • STM32 1.Wire driver
      • STM32 CRC32 driver
      • STM32 Flash driver
      • STM32 Flexible Memory Controller driver
      • STM32 Random number generator driver
• Target reference for FreeRTOS
  • ESP32_REV0
  • NXP_MIMXRT1060_EVK
• Target references for ThreadX
  • Silabs Giant Gecko EVB
• Target references for TI SimpleLink
  • TI CC1352R1_LAUNCHXL
  • TI CC3220SF_LAUNCHXL
• Target reference for Raspberry Pi (ChibiOS)
  • PICO_RP2040
  • PICO2_RP2350
  • PICO_RP2040_W
  • PICO2_RP2350_W
• Target reference for other OSes
  • Win32 OS (test project only at this time)
• CMake files for the build system

Reusing downloaded build dependencies

When cleaning the build directory or switching targets, preserve the complete build/_deps directory, including its *-subbuild directories. CMake uses those directories to remember which repositories it has already cloned. The build selects CMP0168 OLD to keep this bookkeeping with the dependencies rather than under build/CMakeFiles, where cmake --fresh would remove it. This uses CMake's legacy sub-build implementation; the compatibility policy may need revisiting when upgrading to a CMake version that removes it.

Changing from the newer FetchContent layout may repopulate dependencies once. Subsequent fresh configurations can reuse the preserved cache. Dependency versions remain controlled by their declared Git revisions; UPDATE_DISCONNECTED ON does not automatically pull upstream branch changes. Messages saying a dependency is "from GitHub repo" identify its source, not necessarily a new download.

Feedback and documentation

For documentation, providing feedback, issues and finding out how to contribute please refer to the Home repo.

Join our Discord community here.

Credits

The list of contributors to this project can be found at CONTRIBUTORS.

License

The nanoFramework Interpreter is licensed under the MIT license.

Code of Conduct

This project has adopted the code of conduct defined by the Contributor Covenant to clarify expected behavior in our community. For more information see the .NET Foundation Code of Conduct.

.NET Foundation

This project is supported by the .NET Foundation.