33![ nanoFramework logo] ( https://raw.githubusercontent.com/nanoframework/Home/main/resources/logo/nanoFramework-repo-logo.png )
44
55-----
6- 文档语言 : [ English] ( README.md ) | [ 简体中文] ( README.zh-cn.md )
6+ 切换语言 : [ English] ( README.md ) | [ 简体中文] ( README.zh-cn.md )
77
8- ### 欢迎来到 .NET ** nanoFramework** firmware工具库
8+ ### 欢迎来到.NET ** nanoFramework** 固件刷写工具存储库
99
10- 这个repo包含nano固件闪光工具 。
11- 这是一个[ . NET Core Tool ] ( https://docs.microsoft.com/en-us/dotnet/core/tools/global-tools ) 允许用一个固件映像 (nanoBooter和nanoCLR)来刷新一个 .NET ** nanoFramework** 目标,应用程序部署( 运行.NET应用程序所需的所有程序集)和恢复之前保存的部署映像。
12- 是 .NET ** nanoFramework** 工具箱的一部分,以及其他各种工具,在 .NET ** nanoFramework** 开发,使用或存储库管理中所需要的 。
10+ 这个存储库包含.NET nanoFramework固件刷写工具 。
11+ 这是一个[ .NET Core 工具 ] ( https://docs.microsoft.com/en-us/dotnet/core/tools/global-tools ) ,它能够将固件映像 (nanoBooter和nanoCLR) 刷写进一个 .NET ** nanoFramework** 支持的设备,部署应用程序( 运行.NET应用程序所需的所有程序集)并恢复先前保存的部署映像。
12+ 它是 .NET ** nanoFramework** 工具集的一部分,与其他用于 .NET ** nanoFramework** 开发、使用或仓库管理的各种工具一起使用 。
1313
1414它使用了几个第三方工具:
1515
1616- 乐鑫 esptool
17- 您可以在存储库中找到esptool和许可信息 [ 这里 ] ( http://github.com/espressif/esptool ) .
17+ 您可以在存储库中找到esptool和许可信息 [ 链接 ] ( http://github.com/espressif/esptool ) .
1818- STM32 Cube Programmer
19- 您可以找到源代码、许可信息和文档 [ 这里 ] ( https://www.st.com/en/development-tools/stm32cubeprog.html ) .
19+ 您可以找到源代码、许可信息和文档 [ 链接 ] ( https://www.st.com/en/development-tools/stm32cubeprog.html ) .
2020- Texas Instruments Uniflash
21- 您可以找到Uniflash工具和许可信息 [ 这里 ] ( http://www.ti.com/tool/download/UNIFLASH ) .
21+ 您可以找到Uniflash工具和许可信息 [ 链接 ] ( http://www.ti.com/tool/download/UNIFLASH ) .
2222
23- 我们还将此工具作为 .NET 库分发,以便它可以集成到第三方应用程序中。请查看“示例 ”文件夹中的 [ README] ( Samples\README.md ) 以获取更多详细信息以及示例应用程序。
23+ 我们还将此工具作为 .NET 库分发,以便它可以集成到第三方应用程序中。请查看“Samples ”文件夹中的 [ README] ( Samples\README.md ) 以获取更多详细信息以及示例应用程序。
2424
25- ## 安装.NET ** nanoFramework** Firmware Flasher
25+ ## 安装.NET ** nanoFramework** 固件刷写工具
2626
27- 使用以下.NET Core CLI命令一次性安装 .NET ** nanoFramework** Firmware flash工具 :
27+ 使用以下.NET Core CLI命令一键安装 .NET ** nanoFramework** 固件刷写工具 :
2828
29- ``` 控制台
29+ ``` shell
3030dotnet tool install -g nanoff
3131```
3232
3333成功安装后,将显示一条消息,显示将用于调用工具和所安装的版本的命令。 类似于下面的例子:
3434
35- ``` 控制台
35+ ``` shell
3636You can invoke the tool using the following command: nanoff
3737Tool ' nanoff' (version ' 9.9.9' ) was successfully installed.
3838```
3939
40- ### 安装路径问题
40+ ### 安装路径相关的问题
4141
42- :warning : 当'nanoff'安装在包含变音符字符的路径中时,STM32设备运行命令会出现问题。 这是由STM32 Cube Programmer中的一个已知错误引起的。
43- 例如,如果你的用户路径是这种情况,你必须把它安装在一个有这些的位置。
44- 为了实现这一点,使用下面的.NET Core CLI命令,该命令指定了工具安装的路径:
42+ :warning : 已知在安装路径中包含变音符号(例如:法语中的重音符号(acute accent)用于表示元音应该发/ay/的音)时,使用nanoff为STM32设备运行命令会出现问题。这是由于STM32 Cube Programmer中的一个已知错误引起的。如果您的路径中存在这种情况,您必须将其安装在没有这些字符的位置。为了实现这一点,可以使用以下.NET Core CLI命令,在其中指定工具将安装的路径:
4543
46- ``` 控制台
44+ ``` shell
4745dotnet tool install nanoff --tool-path c:\a -plain-simple-path-to-install-the-tool
4846```
4947
5048请注意,如果您没有在STM32设备中使用'nanoff',则此限制不适用。
5149
52- ### MacOS使用
50+ ### 对于MacOS
5351
54- 你还需要添加'nanoff'到你的路径,一旦安装运行:
52+ 您需要将nanoff添加到您的路径中。安装完成后,运行以下命令:
5553
56- ``` 控制台
54+ ``` shell
5755export PATH=$PATH :~ /.dotnet/tools
5856```
5957
6058## 更新.NET ** nanoFramework** 固件flash
6159
62- 要更新.NET ** nanoFramework** Firmware flash工具 ,请使用.NET Core CLI命令:
60+ 要更新.NET ** nanoFramework** 固件刷写工具 ,请使用.NET Core CLI命令:
6361
64- ``` 控制台
62+ ``` shell
6563dotnet tool update -g nanoff
6664```
6765
6866如果工具安装在特定的路径下,请使用以下.NET Core CLI命令:
6967
70- ``` 控制台
68+ ``` shell
7169dotnet tool update nanoff --tool-path c:\p ath-where-the-tool-was-installed
7270```
7371
74- ## 用法
72+ ## 使用方法
7573
76- 一旦安装了该工具,你可以通过使用它的命令 “nanoff”来调用它,这是名称的简短版本 ,以方便输入。
74+ 一旦安装了该工具,你就可以通过命令 “nanoff”来调用它,这是该程序名称的简称 ,以方便输入。
7775
78- ``` 控制台
76+ ``` shell
7977nanoff [command] [args]
8078```
8179
82- 该工具包括所有可用命令的帮助。 您可以通过输入以下命令查看所有可用的列表 :
80+ 该工具包括所有可用命令的帮助,您可以通过输入以下命令来查看 :
8381
84- ``` 控制台
82+ ``` shell
8583nanoff --help
8684```
8785
8886## ESP32 用法示例
8987
90- 有多个ESP32图像可用,一些是专门为一个目标构建的 。 请参阅 [ 列表] ( https://github.com/nanoframework/nf-interpreter#firmware-for-reference-boards ) .
88+ 有多个ESP32固件可用,一些是专门为一个设备构建的 。 请参阅 [ 列表] ( https://github.com/nanoframework/nf-interpreter#firmware-for-reference-boards ) .
9189
92- ESP32_PSRAM_REV0图像将只适用于ESP32系列的任何变体 ,带或不带pram,以及所有的silicon版本 。
93- 你可以阅读更多关于不同图像之间的差异 [ 这里 ] ( https://docs.nanoframework.NET/content/reference-targets/esp32.html ) .
90+ ESP32_PSRAM_REV0固件将只适用于ESP32系列的任何变体 ,带或不带pram,以及所有silicon版 。
91+ 你可以阅读更多关于不同固件之间的差异 [ 链接 ] ( https://docs.nanoframework.NET/content/reference-targets/esp32.html ) .
9492
95- FEATHER_S2图像将适用于几乎所有的ESP32 -S2系列的变体,暴露嵌入式USB CDC引脚。
93+ FEATHER_S2固件将适用于几乎所有的ESP32 -S2系列的变体,暴露嵌入式USB CDC引脚。
9694
97- 你可以阅读更多关于不同图像之间的差异 [ 这里 ] ( https://docs.nanoframework.NET/content/reference-targets/esp32.html ) .
95+ 你可以阅读更多关于不同固件之间的差异 [ 链接 ] ( https://docs.nanoframework.NET/content/reference-targets/esp32.html ) .
9896
99- 当使用'nanoff'时,你可以添加'——target MY_TARGET_NAME_HERE'来使用特定的图像 。 如果,相反,您只指定平台与'——platform esp32' 'nanoff'将选择最合适的图像 ,这取决于所连接的设备的功能。 类似于这个的输出将会显示出什么图像将要被使用 :
97+ 当使用'nanoff'时,你可以添加'——target MY_TARGET_NAME_HERE'来使用特定的固件 。 如果,相反,您只指定平台与'——platform esp32' 'nanoff'将自动选择最合适的固件 ,这取决于所连接的设备的功能。 类似于这个的输出将会显示出什么固件将要被使用 :
10098
101- ``` 控制台
102- 没有提供目标名称! 根据设备特征使用 'ESP32_REV0'。
99+ ``` shell
100+ No target name was provided ! Using ' ESP32_REV0' based on the device characteristics.
103101```
104102
105- > 注意:请注意,对于ESP32-S2目标,不可能安全地确定使用什么是最好的图像 。 由于这个原因,它必须提供适当的目标名称与 '——target MY_TARGET_NAME_HERE'。
103+ > 注意:请注意,对于ESP32-S2,不可能安全地确定使用什么是最好的固件 。 由于这个原因,它必须提供适当的设备名称与 '——target MY_TARGET_NAME_HERE'。
106104
107- 部分ESP32单板进入引导加载模式存在问题。 这通常可以通过按住BOOT/FLASH按钮来克服 。
105+ 部分ESP32单板进入引导加载模式存在问题。 这通常可以通过按住BOOT/FLASH按钮来解决 。
108106如果' nanoff '检测到这种情况,会显示以下警告:
109107
110- ``` 控制台
108+ ``` shell
111109*** Hold down the BOOT/FLASH button in ESP32 board ***
112110```
113111
114- :warning : 要更新FeatherS2和TinyS2,板需要把_download模式,按住 [ BOOT] ,点击 [ RESET] ,然后释放 [ BOOT] 。
112+ :warning : 要更新FeatherS2、TinyS2和一些S3模块,您需要将开发板置于下载模式。具体操作方法是按住 [ BOOT] 按钮,单击 [ RESET] 按钮,然后松开 [ BOOT] 按钮 。
115113
116- ### 更新ESP32版本的目标器固件
114+ ### 更新ESP32版本的设备器固件
117115
118- 更新连接到COM31的ESP32目标器的固件到最新可用的开发版本 。
116+ 更新连接到COM31的ESP32设备器的固件到最新可用的开发版本 。
119117
120- ``` 控制台
118+ ``` shell
121119nanoff --update --target ESP32_PSRAM_REV0 --serialport COM31
122120```
123121
124122### 使用本地CLR文件更新ESP32-S2 KALUGA 1的固件
125123
126- 使用本地CLR文件(例如来自一个构建文件)更新连接到COM31的ESP32-S2 KALUGA 1目标的固件 。
127- 这个文件必须是一个二进制文件,具有来自构建的有效的CLR 。 对文件内容不执行其他检查或验证。
124+ 使用本地CLR文件(例如来自一个构建文件)更新连接到COM31的ESP32-S2 KALUGA 1设备的固件 。
125+ 这个文件必须是一个二进制文件,且必须是有效且经过构建的CLR 。 对文件内容不执行其他检查或验证。
128126
129- ``` 控制台
127+ ``` shell
130128nanoff --update --target KALUGA_1 --serialport COM31 --clrfile " C:\nf-interpreter\build\nanoCLR.bin"
131129```
132130
133- 您可以调整要使用的核心图像的名称 。 请参阅前一节以获得完整的列表。
131+ 您可以调整要使用的核心固件的名称 。 请参阅前一节以获得完整的列表。
134132
135133### 显示所连接的ESP32设备的详细信息
136134
137135查看与COM31相连的ESP32设备的详细信息。
138136
139- ``` 控制台
137+ ``` shell
140138nanoff --platform esp32 --serialport COM31 --devicedetails
141139```
142140
143- ### 将托管应用程序部署到ESP32目标
141+ ### 将托管应用程序部署到ESP32设备
144142
145- 将托管应用程序部署到连接到COM31的ESP32_PSRAM_REV0目标器上 。
143+ 将托管应用程序部署到连接到COM31的ESP32_PSRAM_REV0设备上 。
146144
147- > Note: 在成功构建之后,可以在Visual Studio项目的Release或Debug文件夹中找到包含部署映像的二进制文件。 此文件包含将托管应用程序部署到目标所需的所有内容 (即应用程序可执行文件和所有引用的库和程序集)。
145+ > Note: 在成功构建之后,可以在Visual Studio项目的Release或Debug文件夹中找到包含部署映像的二进制文件。 此文件包含将托管应用程序部署到设备所需的所有内容 (即应用程序可执行文件和所有引用的库和程序集)。
148146
149- ``` 控制台
147+ ``` shell
150148nanoff --target ESP32_PSRAM_REV0 --serialport COM12 --deploy --image " E:\GitHub\nf-Samples\samples\Blinky\Blinky\bin\Debug\Blinky.bin"
151149```
152150
153- ### 更新ESP32目标和托管应用程序的固件
151+ ### 更新ESP32设备和托管应用程序的固件
154152
155- 要在连接到COM31的ESP32目标机上部署应用程序 ,您必须指定托管应用程序的路径。 您也可以提供一个地址,该地址将覆盖默认的部署地址。
156- 本示例使用的是在构建应用程序时可以找到的二进制格式文件。 注意,因为只有应用程序可以运行,所以在构建库时,不会自动创建bin文件。 只对应用程序 。
153+ 要在连接到COM31的ESP32设备机上部署应用程序 ,您必须指定托管应用程序的路径。 您也可以提供一个地址,该地址将覆盖默认的部署地址。
154+ 本示例使用的是在构建应用程序时可以找到的二进制格式文件。 注意,因为只有应用程序可以运行,所以在构建库时,不会自动创建bin文件,这只针对应用程序 。
157155
158- ``` 控制台
156+ ``` shell
159157nanoff --target ESP32_PSRAM_REV0 --update --serialport COM31 --deploy --image " c:\eps32-backups\my_awesome_app.bin" --address 0x1B000
160158```
161159
162160## STM32用法示例
163161
164- ### 更新指定STM32目标的固件
162+ ### 更新指定STM32设备的固件
165163
166- 使用JTAG连接将ST_STM32F769I_DISCOVERY目标的固件更新到最新可用的稳定版本 。
164+ 使用JTAG连接将ST_STM32F769I_DISCOVERY设备的固件更新到最新可用的稳定版本 。
167165
168- ``` 控制台
166+ ``` shell
169167nanoff --update --target ST_STM32F769I_DISCOVERY --jtag
170168```
171169
172- ### 将托管应用程序部署到ST_STM32F769I_DISCOVERY目标
170+ ### 将托管应用程序部署到ST_STM32F769I_DISCOVERY设备
173171
174- 将托管应用程序部署到ST_STM32F769I_DISCOVERY目标,该目标的部署区域位于0x08080000闪存地址,并在闪存后复位MCU 。
172+ 将托管应用程序部署到ST_STM32F769I_DISCOVERY设备,该设备的部署区域位于0x08080000 Flash地址,并在刷写后复位MCU 。
175173
176- > Note: 在成功构建之后,可以在Visual Studio项目的Release或Debug文件夹中找到包含部署映像的二进制文件。 此文件包含将托管应用程序部署到目标所需的所有内容 (即应用程序可执行文件和所有引用的库和程序集)。
174+ > Note: 在成功构建之后,可以在Visual Studio项目的Release或Debug文件夹中找到包含部署映像的二进制文件。 此文件包含将托管应用程序部署到设备所需的所有内容 (即应用程序可执行文件和所有引用的库和程序集)。
177175
178- ``` 控制台
176+ ``` shell
179177nanoff --target ST_STM32F769I_DISCOVERY --deploy --image " E:\GitHub\nf-Samples\samples\Blinky\Blinky\bin\Debug\Blinky.bin" --address 0x08040000 --reset
180178```
181179
182180### 更新ST_STM32F769I_DISCOVERY和托管应用程序的固件
183181
184- 使用JTAG连接和托管应用程序,将ST_STM32F769I_DISCOVERY目标的固件更新到最新可用的预览版本 。
182+ 使用JTAG连接和托管应用程序,将ST_STM32F769I_DISCOVERY设备的固件更新到最新可用的预览版本 。
185183您必须指定托管应用程序的路径。
186184本例使用了Visual Studio在构建任何nanoFramework c#应用程序时生成的二进制格式文件。 因为它是一个二进制文件,所以您还必须指定部署区域的flash地址(这里是0x08000000,注意十六进制格式)。
187185
188- ``` 控制台
186+ ``` shell
189187nanoff --update --target ST_STM32F769I_DISCOVERY --jtag --binfile " c:\dev\my awesome app\bin\debug\my_awesome_app.bin" --address 0x08000000
190188```
191189
192190### 列出JTAG连接中可用的所有STM32设备
193191
194- 这有助于列出通过JTAG连接的所有STM32设备 。
192+ 这将列出通过JTAG连接的所有STM32设备 。
195193
196- ``` 控制台
194+ ``` shell
197195nanoff --listjtag
198196```
199197
200198### 列出所有可用的STM32设备与DFU连接
201199
202- 这有助于列出所有通过DFU连接的STM32设备 。
200+ 这将列出所有通过DFU连接的STM32设备 。
203201
204- ``` 控制台
202+ ``` shell
205203nanoff --listdfu
206204```
207205
208206### 安装STM32 JTAG驱动程序
209207
210- 为STM32 JTAG连接的目标安装驱动程序 。
208+ 为STM32 JTAG连接的设备安装驱动程序 。
211209
212- ``` 控制台
210+ ``` shell
213211nanoff --installjtagdrivers
214212```
215213
216214### 安装STM32 DFU驱动程序
217215
218- 为STM32 DFU连接的目标安装驱动程序 。
216+ 为STM32 DFU连接的设备安装驱动程序 。
219217
220- ``` 控制台
218+ ``` shell
221219nanoff --installdfudrivers
222220```
223221
224222## TI CC13x2使用示例
225223
226- ### 更新指定TI CC13x2目标的固件
224+ ### 更新指定TI CC13x2设备的固件
227225
228- 将TI_CC1352R1_LAUNCHXL目标的固件更新到最新的预览版本 。
226+ 将TI_CC1352R1_LAUNCHXL设备的固件更新到最新的预览版本 。
229227
230- ``` 控制台
228+ ``` shell
231229nanoff --update --target TI_CC1352R1_LAUNCHXL --preview
232230```
233231
234- ### 安装TI LaunchPad目标所需的XDS110 USB驱动程序
232+ ### 安装TI LaunchPad设备所需的XDS110 USB驱动程序
235233
236234安装XDS110 USB驱动。
237235
238- ``` 控制台
236+ ``` shell
239237nanoff --installxdsdrivers
240238```
241239
242- ### 预先检查目标是否与连接的设备相匹配
240+ ### 预先检查设备是否与连接的设备相匹配
243241
244- 该工具会尽最大努力检查所请求的目标是否符合已连接的目标 。
245- 有时这是不可能的,因为目标名称的差异和变化 ,或者缺乏所连接设备提供的详细信息,甚至(像DFU所连接的设备),因为根本不可能确切地确定所连接的设备。
242+ 该工具会尽最大努力检查所请求的设备是否符合已连接的设备 。
243+ 有时这是不可能的,因为设备名称的差异和变化 ,或者缺乏所连接设备提供的详细信息,甚至(像DFU所连接的设备),因为根本不可能确切地确定所连接的设备。
246244这并不一定意味着固件不能工作,所以这只是一个建议。
247245
248246要禁用此验证,请在命令行中添加'——nofitcheck'选项。
@@ -259,28 +257,28 @@ nanoff --installxdsdrivers
259257- d[ etailed]
260258- diag[ nostic]
261259
262- ``` 控制台
260+ ``` shell
263261nanoff -v q
264262```
265263
266- ## 目标列表
264+ ## 设备列表
267265
268266翻译结果
269- 您可以列出支持的目标及其版本 ,用于稳定版本或预览。 ` --platform ` 允许您过滤平台。
267+ 您可以列出支持的设备及其版本 ,用于稳定版本或预览。 ` --platform ` 允许您过滤平台。
270268
271- 在预览版本中列出可用于ESP32目标的软件包 。
269+ 在预览版本中列出可用于ESP32设备的软件包 。
272270
273- ``` 控制台
271+ ``` shell
274272nanoff --listboards --platform esp32
275273```
276274
277- 列出可用于STM32目标的包 (稳定版本)。
275+ 列出可用于STM32设备的包 (稳定版本)。
278276
279- ``` 控制台
277+ ``` shell
280278nanoff --listboards --platform stm32
281279```
282280
283- 如果你只使用'——listtargets'开关,你会得到所有目标的所有稳定包的列表 。
281+ 如果你只使用'——listtargets'开关,你会得到所有设备的所有稳定包的列表 。
284282
285283## Exit codes
286284
@@ -298,7 +296,7 @@ nanoff --listboards --platform stm32
298296
299297## 许可证
300298
301- ** nanoFramework** firmware flash工具是在 [ 麻省理工学院的许可 ] ( LICENSE ) .
299+ ** nanoFramework** firmware flash工具使用 [ MIT许可证 ] ( LICENSE ) .
302300
303301## 规范
304302
@@ -307,4 +305,4 @@ nanoff --listboards --platform stm32
307305
308306### .NET Foundation
309307
310- 这个项目是由 [ .NET Foundation] ( https://dotnetfoundation.org ) .
308+ 这个项目由 [ .NET Foundation] ( https://dotnetfoundation.org ) 提供支持 .
0 commit comments