README.md

---

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 boards	ESP32_S3 boards
ESP32 riscv (C3,C5,C6,P4 & H2)	ESP32 M5STACK
STM32 boards
Silicon Labs Giant Gecko
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_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 boards

Target	Note	Stable	Preview
ESP32_S2_USB	S2 boards with direct USB connection to chip. Including Adafruit Feather_S2
ESP32_S2_UART	S2 boards with onboard USB->UART. This includes the Kaluga dev. board from Espressif

ESP32_S3 boards

Target	Note	Stable	Preview
ESP32_S3	Display & Quad spiram support
ESP32_S3_BLE	Display, BLE, Quad spiram support
ESP32_S3_BLE_UART	Display, BLE, Quad spiram support, connection via UART
ESP32_S3_ALL	Display, BLE, Octal spiram support
ESP32_S3_ALL_UART	Display, BLE, Octal spiram support, connection via UART

ESP32 risc-v boards

Target	Note	Stable	Preview
ESP32_C3	Uart -> VS (Beta C3 version)
ESP32_C3_REV3	Uart -> VS
XIAO_ESP32C3	USB jtag -> VS
ESP32_C5_THREAD_USB	USB jtag -> VS, OpenThread, Generic display, psram, Wifi 2.4ghz & 5ghz
ESP32_C5_THREAD_UART	Uart -> VS, OpenThread, Generic display, psram, Wifi 2.4ghz & 5ghz
ESP32_C6_THREAD	USB jtag -> VS, OpenThread, Generic display
ESP32_H2_THREAD	USB jtag -> VS, OpenThread
ESP32_P4_UART	Beta, P4 chips rev 3.0 or later, Uart -> VS, wifi ESP32_C6, No Display
ESP32_P4_USB	Beta, P4 chips rev 3.0 or later, USB -> VS, wifi ESP32_C6, No Display
ESP32_P4_UART_REV_LESS3	Beta, P4 chips with rev less than 3.0, Uart -> VS, wifi ESP32_C6, No Display
ESP32_P4_USB_REV_LESS3	Beta, P4 chips with rev less than 3.0, USB -> 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 (B01)
ST_NUCLEO64_F091RC
ST_STM32F769I_DISCOVERY
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

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	:heavy_check_mark:	:heavy_check_mark:	:heavy_check_mark:	:heavy_check_mark:	:heavy_check_mark:	:heavy_check_mark:	:heavy_check_mark:	:heavy_check_mark:	:heavy_check_mark:		:heavy_check_mark:		:heavy_check_mark:
ESP32_REV0	:heavy_check_mark:	:heavy_check_mark:	:heavy_check_mark:	:heavy_check_mark:	:heavy_check_mark:	:heavy_check_mark:	:heavy_check_mark:	:heavy_check_mark:	:heavy_check_mark:		:heavy_check_mark:		:heavy_check_mark:
ESP32_PSRAM_XTAL26_REV0	:heavy_check_mark:	:heavy_check_mark:	:heavy_check_mark:	:heavy_check_mark:	:heavy_check_mark:	:heavy_check_mark:	:heavy_check_mark:	:heavy_check_mark:	:heavy_check_mark:		:heavy_check_mark:		:heavy_check_mark:
ESP32_PSRAM_REV3	:heavy_check_mark:	:heavy_check_mark:	:heavy_check_mark:	:heavy_check_mark:	:heavy_check_mark:	:heavy_check_mark:	:heavy_check_mark:	:heavy_check_mark:	:heavy_check_mark:		:heavy_check_mark:		:heavy_check_mark:
ESP32_REV3	:heavy_check_mark:	:heavy_check_mark:	:heavy_check_mark:	:heavy_check_mark:	:heavy_check_mark:	:heavy_check_mark:	:heavy_check_mark:	:heavy_check_mark:	:heavy_check_mark:		:heavy_check_mark:		:heavy_check_mark:
ESP32_BLE_REV0	:heavy_check_mark:	:heavy_check_mark:	:heavy_check_mark:	:heavy_check_mark:	:heavy_check_mark:	:heavy_check_mark:	:heavy_check_mark:	:heavy_check_mark:	:heavy_check_mark:		:heavy_check_mark:	:heavy_check_mark:
ESP32_BLE_REV3	:heavy_check_mark:	:heavy_check_mark:	:heavy_check_mark:	:heavy_check_mark:	:heavy_check_mark:	:heavy_check_mark:	:heavy_check_mark:	:heavy_check_mark:	:heavy_check_mark:		:heavy_check_mark:	:heavy_check_mark:
ESP_WROVER_KIT	:heavy_check_mark:	:heavy_check_mark:	:heavy_check_mark:	:heavy_check_mark:	:heavy_check_mark:	:heavy_check_mark:	:heavy_check_mark:	:heavy_check_mark:	:heavy_check_mark:		:heavy_check_mark:		:heavy_check_mark:	:heavy_check_mark:
ESP32_PICO	:heavy_check_mark:	:heavy_check_mark:	:heavy_check_mark:	:heavy_check_mark:	:heavy_check_mark:	:heavy_check_mark:	:heavy_check_mark:	:heavy_check_mark:	:heavy_check_mark:		:heavy_check_mark:
ESP32_LILYGO	:heavy_check_mark:	:heavy_check_mark:	:heavy_check_mark:	:heavy_check_mark:	:heavy_check_mark:	:heavy_check_mark:	:heavy_check_mark:	:heavy_check_mark:	:heavy_check_mark:		:heavy_check_mark: Wi-Fi + Ethernet
ESP32_S2_USB	:heavy_check_mark:	:heavy_check_mark:	:heavy_check_mark:	:heavy_check_mark:	:heavy_check_mark:	:heavy_check_mark:	:heavy_check_mark:	:heavy_check_mark:	:heavy_check_mark:		:heavy_check_mark:
ESP32_S2_UART	:heavy_check_mark:	:heavy_check_mark:	:heavy_check_mark:	:heavy_check_mark:	:heavy_check_mark:	:heavy_check_mark:	:heavy_check_mark:	:heavy_check_mark:	:heavy_check_mark:		:heavy_check_mark:			:heavy_check_mark:
ESP32_C3	:heavy_check_mark:	:heavy_check_mark:	:heavy_check_mark:	:heavy_check_mark:	:heavy_check_mark:		:heavy_check_mark:	:heavy_check_mark:	:heavy_check_mark:		:heavy_check_mark:
XIAO_ESP32C3	:heavy_check_mark:	:heavy_check_mark:	:heavy_check_mark:	:heavy_check_mark:	:heavy_check_mark:		:heavy_check_mark:	:heavy_check_mark:	:heavy_check_mark:		:heavy_check_mark:
ESP32_C6	:heavy_check_mark:	:heavy_check_mark:	:heavy_check_mark:	:heavy_check_mark:	:heavy_check_mark:		:heavy_check_mark:	:heavy_check_mark:	:heavy_check_mark:		:heavy_check_mark:
ESP32_H2	:heavy_check_mark:	:heavy_check_mark:	:heavy_check_mark:	:heavy_check_mark:	:heavy_check_mark:		:heavy_check_mark:	:heavy_check_mark:	:heavy_check_mark:		:heavy_check_mark:
ESP32_ETHERNET_KIT_1.2	:heavy_check_mark:	:heavy_check_mark:	:heavy_check_mark:	:heavy_check_mark:	:heavy_check_mark:	:heavy_check_mark:	:heavy_check_mark:	:heavy_check_mark:		:heavy_check_mark:	:heavy_check_mark: Wi-Fi + Ethernet		:heavy_check_mark:
ESP32_OLIMEX	:heavy_check_mark:	:heavy_check_mark:	:heavy_check_mark:	:heavy_check_mark:	:heavy_check_mark:	:heavy_check_mark:	:heavy_check_mark:	:heavy_check_mark:		:heavy_check_mark:	:heavy_check_mark: Wi-Fi + Ethernet		:heavy_check_mark:
ESP32_WT32_ETH01	:heavy_check_mark:	:heavy_check_mark:	:heavy_check_mark:	:heavy_check_mark:	:heavy_check_mark:	:heavy_check_mark:	:heavy_check_mark:	:heavy_check_mark:		:heavy_check_mark:	:heavy_check_mark: Wi-Fi + Ethernet		:heavy_check_mark:
ESP32_WESP32	:heavy_check_mark:	:heavy_check_mark:	:heavy_check_mark:	:heavy_check_mark:	:heavy_check_mark:	:heavy_check_mark:	:heavy_check_mark:	:heavy_check_mark:		:heavy_check_mark:	:heavy_check_mark: Wi-Fi + Ethernet		:heavy_check_mark:
M5Core	:heavy_check_mark:	:heavy_check_mark:	:heavy_check_mark:	:heavy_check_mark:	:heavy_check_mark:	:heavy_check_mark:	:heavy_check_mark:	:heavy_check_mark:		:heavy_check_mark:	:heavy_check_mark: Wi-Fi		:heavy_check_mark:
M5StickC	:heavy_check_mark:	:heavy_check_mark:	:heavy_check_mark:	:heavy_check_mark:	:heavy_check_mark:	:heavy_check_mark:	:heavy_check_mark:	:heavy_check_mark:		:heavy_check_mark:	:heavy_check_mark: Wi-Fi		:heavy_check_mark:
M5StickCPlus	:heavy_check_mark:	:heavy_check_mark:	:heavy_check_mark:	:heavy_check_mark:	:heavy_check_mark:	:heavy_check_mark:	:heavy_check_mark:	:heavy_check_mark:		:heavy_check_mark:	:heavy_check_mark: Wi-Fi		:heavy_check_mark:
M5Core2	:heavy_check_mark:	:heavy_check_mark:	:heavy_check_mark:	:heavy_check_mark:	:heavy_check_mark:	:heavy_check_mark:	:heavy_check_mark:	:heavy_check_mark:		:heavy_check_mark:	:heavy_check_mark: Wi-Fi		:heavy_check_mark:
ESP32_GenericDisplay_REV0	:heavy_check_mark:	:heavy_check_mark:	:heavy_check_mark:	:heavy_check_mark:	:heavy_check_mark:	:heavy_check_mark:	:heavy_check_mark:	:heavy_check_mark:		:heavy_check_mark:	:heavy_check_mark: Wi-Fi		:heavy_check_mark:
ESP32_PSRAM_BLE_GenericGraphic_REV3	:heavy_check_mark:	:heavy_check_mark:	:heavy_check_mark:	:heavy_check_mark:	:heavy_check_mark:	:heavy_check_mark:	:heavy_check_mark:	:heavy_check_mark:		:heavy_check_mark:	:heavy_check_mark: Wi-Fi		:heavy_check_mark:
MXCHIP_AZ3166	:heavy_check_mark:	:heavy_check_mark:	:heavy_check_mark:	:heavy_check_mark:			:heavy_check_mark:
ST_STM32F429I_DISCOVERY (B01)	:heavy_check_mark:	:heavy_check_mark:	:heavy_check_mark:	:heavy_check_mark:	:heavy_check_mark:		:heavy_check_mark:	:heavy_check_mark:	:heavy_check_mark:	:heavy_check_mark:			:heavy_check_mark:
ST_NUCLEO64_F091RC	:heavy_check_mark:	:heavy_check_mark:	:heavy_check_mark:	:heavy_check_mark:			:heavy_check_mark:	:heavy_check_mark:	:heavy_check_mark:	:heavy_check_mark:
ST_STM32F769I_DISCOVERY	:heavy_check_mark:	:heavy_check_mark:	:heavy_check_mark:	:heavy_check_mark:	:heavy_check_mark:	:heavy_check_mark:	:heavy_check_mark:	:heavy_check_mark:	:heavy_check_mark:	:heavy_check_mark:	:heavy_check_mark:		:heavy_check_mark:	:heavy_check_mark:
ORGPAL_PALTHREE	:heavy_check_mark:	:heavy_check_mark:	:heavy_check_mark:	:heavy_check_mark:	:heavy_check_mark:	:heavy_check_mark:	:heavy_check_mark:	:heavy_check_mark:	:heavy_check_mark:	:heavy_check_mark:	:heavy_check_mark:		:heavy_check_mark:
ORGPAL_PALX	:heavy_check_mark:	:heavy_check_mark:	:heavy_check_mark:	:heavy_check_mark:	:heavy_check_mark:	:heavy_check_mark:	:heavy_check_mark:	:heavy_check_mark:	:heavy_check_mark:	:heavy_check_mark:	:heavy_check_mark:		:heavy_check_mark:
SL_STK3701A_REVB	:heavy_check_mark:	:heavy_check_mark:	:heavy_check_mark:	:heavy_check_mark:	:heavy_check_mark:		:heavy_check_mark:		:heavy_check_mark:	:heavy_check_mark:
SL_STK3701A	:heavy_check_mark:	:heavy_check_mark:	:heavy_check_mark:	:heavy_check_mark:	:heavy_check_mark:		:heavy_check_mark:		:heavy_check_mark:	:heavy_check_mark:
TI_CC1352R1_LAUNCHXL	:heavy_check_mark:
TI_CC3220SF_LAUNCHXL	:heavy_check_mark:	:heavy_check_mark:	:heavy_check_mark:	:heavy_check_mark:	:heavy_check_mark:				:heavy_check_mark:		:heavy_check_mark:
NXP_MIMXRT1060_EVK	:heavy_check_mark:						:heavy_check_mark:		:heavy_check_mark:		:heavy_check_mark:		:heavy_check_mark:

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 (B01)
      • ST STM32F769I DISCOVERY
    • 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 other OSes
  • Win32 OS (test project only at this time)
• CMake files for the build system

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.