README.zh-cn.md

---

文档语言: English | 简体中文

.NET nanoFramework 首页

这个 Home 存储库对于想要了解 .NET nanoFramework、为其做出贡献或提出问题的开发人员来说，是个起点。它包含指向 .NET nanoFramework 使用的各种 GitHub 存储库的链接。

.NET nanoFramework 的目标是成为一个能够为受限嵌入式设备编写托管代码应用程序的平台。开发者可以利用熟悉的 IDE Visual Studio 和 .NET(C#) 知识快速编写应用程序，而无需担心微控制器的低层硬件复杂性。

它是 .NET Foundation 的一部分。

作为一名 开发人员，您可能会适合以下的一个(或多个😉)角色：

• 您可以享受为微控制器开发 C# 应用程序的乐趣。
• 您可以成为贡献者，因为有很多领域可以表达自己：
  • 使用我们的平台抽象层和硬件抽象层 RTOS 直接在 MCU 上低层工作的 C/C++ 原生驱动程序，为 nanoFramework 开发 .NET CLR。
  • 托管 C# 以编写新的类和驱动程序，以向 .NET nanoFramework 添加更多绑定、库。
  • 托管 C# 以编写 Visual Studio Extensibility、debugger，主要是 .NET Core/.NET 5 CLI 应用程序。
  • 帮助设置 Azure DevOps Pipelines 以尽可能实现自动化。
  • 编写和改进我们的单元测试。
  • 通过回答他人的问题来帮助他人。
  • 编写和改进文档、进行 PR 审查或参与整个项目组织。

.NET nanoFramework 是一种有趣的学习方式。这是一个完整的项目，有很多深入的工程。你会发现一个充满活力的社区来帮助你，你也将能够提供帮助。我们欢迎各种贡献，我们的目标是提高贡献者的知名度。

赞助 .NET nanoFramework

大多数核心团队成员和贡献者都是嵌入式系统爱好者，对编码充满热情，喜欢挑战。.NET nanoFramework 的工作主要在空闲时间完成。一些核心成员碰巧在赞助大量 nanoFramework 的公司工作，并为该项目提供工作时间。如果您使用 .NET nanoFramework 进行严肃的工作或想要支持它，请捐赠。这允许支付基础设施成本和更多的时间投入到项目上。除了捐款外，还有其他几种方式可以贡献。请在 这里 阅读有关此内容的文档。

我们如何使用捐赠：

• 支付基础设施成本。
• 宣传推广项目。
• 支持在项目中投入大量时间的维护人员和贡献者。
• 支持 .NET nanoFramework 所依赖的项目。
• 制作产品文档、教程以及其它内容，以支持使用 .NET nanoFramework 的其他开发人员。
• 组织活动演示 .NET nanoFramework

赞助商

赞助商将在我们的Github自述文件和主页上获得他们的徽标和链接。

铜牌赞助商

支持者

支持者是那些用钱帮助支持 nanoFramework 的个人。每一点都有帮助，我们感谢所有的贡献，即使是最小的贡献。

其他支持者和赞助商

还有其他人和组织一直以多种方式为 .NET NanoFramework 做出贡献：赞助对缺失或需要改进的功能进行编码、支付费用、对功能进行编码或……我们要感谢这些赞助商。

参考板固件

以下每个ZIP文件包括了 nanoBooter 和 nanoCLR 图像文件（HEX，BIN，DFU）。可以使用相应烧写工具把它们写入目标板卡中。

稳定 版本是 RTM 构建，具有尽可能小的编译。它们包括最新的稳定版本。调试功能处于禁用状态，并且只有极少（或无）错误消息。

预览 版是目标板持续编译。它包含所有功能和错误修正的最新版本，也包括调试信息和详细错误信息。

您还可以为社区提供的目标板找到其他几个固件映像。在 社区目标库 上检查可用的链接并下载。

ESP32 模块和板卡

目标	稳定
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
FEATHER_S2
KALUGA_1
ESP32_C3
ESP32_C3_REV3
ESP32_OLIMEX
XIAO_ESP32C3
ESP32_S3
ESP32_S3_BLE

M5Stack

目标	稳定
M5Core
M5StickC
M5StickCPlus
M5Core2
AtomS3

STM32 基于电路板和芯片

目标	稳定
ST_STM32F429I_DISCOVERY (B01)
ST_NUCLEO64_F091RC
ST_STM32F769I_DISCOVERY
ORGPAL_PALTHREE

Silicon Labs Giant Gecko boards

目标	版本
SL_STK3701A
SL_STK3701A_REVB

NXP 板卡

目标	稳定
NXP_MIMXRT1060_EVK

TI 板卡

目标	稳定
TI_CC1352R1_LAUNCHXL_868
TI_CC1352R1_LAUNCHXL_915
TI_CC3220SF_LAUNCHXL

以上固件支持以下类库和功能：

点击展开

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
FEATHER_S2	✔️	✔️	✔️	✔️	✔️	✔️	✔️	✔️	✔️		✔️
KALUGA_1	✔️	✔️	✔️	✔️	✔️	✔️	✔️	✔️	✔️		✔️			✔️
ESP32_C3	✔️	✔️	✔️	✔️	✔️		✔️	✔️	✔️		✔️
ESP32_OLIMEX	✔️	✔️	✔️	✔️	✔️	✔️	✔️	✔️		✔️	✔️ Wi-Fi + Ethernet		✔️
M5Core	✔️	✔️	✔️	✔️	✔️	✔️	✔️	✔️		✔️	✔️ Wi-Fi		✔️
M5StickC	✔️	✔️	✔️	✔️	✔️	✔️	✔️	✔️		✔️	✔️ Wi-Fi		✔️
M5StickCPlus	✔️	✔️	✔️	✔️	✔️	✔️	✔️	✔️		✔️	✔️ Wi-Fi		✔️
M5Core2	✔️	✔️	✔️	✔️	✔️	✔️	✔️	✔️		✔️	✔️ Wi-Fi		✔️
ST_STM32F429I_DISCOVERY (B01)	✔️	✔️	✔️	✔️	✔️		✔️	✔️	✔️	✔️			✔️
ST_NUCLEO64_F091RC	✔️	✔️	✔️	✔️			✔️	✔️	✔️	✔️
ST_STM32F769I_DISCOVERY	✔️	✔️	✔️	✔️	✔️	✔️	✔️	✔️	✔️	✔️	✔️		✔️	✔️
ORGPAL_PALTHREE	✔️	✔️	✔️	✔️	✔️	✔️	✔️	✔️	✔️	✔️	✔️		✔️
TI_CC1352R1_LAUNCHXL	✔️
TI_CC3220SF_LAUNCHXL	✔️	✔️	✔️	✔️	✔️				✔️		✔️
NXP_MIMXRT1060_EVK	✔️						✔️		✔️		✔️		✔️

存储库

我们的GitHub团队拥有用于固件、类库、文档和工具的各种存储库。你可以在 这里 得到一个列表和描述。

如何参与、贡献和提供反馈

贡献的一些最佳方法是尝试一下，记录错误并加入设计对话。

如果你有一个问题，需要澄清某件事，需要对特定情况的帮助或想要开始讨论，请不要在这里 (Github Issues) 提出问题。我们要求您仅在有真实且已确认的问题时才在 Github Issues 提出问题。最好先在我们的 Discord 频道中讨论。请选择最适合您所面临的问题的频道，以便主题专家最有可能及时回答。或者你可以去 Stack Overflow 并在那里提问题，确保使用 nanoframework 标签。

如果您无法使用 Discord，则应在 Discussion 中开始讨论。

在寻找需要解决的若干问题？请查看主存储库上的待抓问题列表，up-for-grabs issues ，这是一个很好的切入点。

有关更多详细信息，请参阅我们的一些指南：

• 贡献指南
• 贡献流程

许可证

.NET nanoFramework 库、固件映像、工具和示例根据 MIT license 获得许可。

文档

文档

无论您是新手还是老手，项目文档都是查找有关 .NET nanoFramework 信息的好地方。它按以下类别组织：

• API手册 各种类库的文档。
• 开发C#应用 使用 .NET nanoFramework.
• 编译映像 加载到目标板上。
• .NET nanoFramework 架构 不同的部分是如何组合在一起的。
• 贡献 .NET nanoFramework 包括如何为项目做出贡献的概述。

博客

我们通过博客尝试发布关于开发状态的详细更新，关于某个特定功能的技术文章，或者设计选项。

YouTube 频道

我们还有一个YouTube 频道，里面有视频教程，还有关于我们正在试验的功能演示和新想法构思。

行为准则

该项目通过了《贡献者公约》界定的行为守则，以澄清我们社区的预期行为。 有关详细信息，请参阅 .NET Foundation 行为准则。