Skip to content

Commit b36a4bc

Browse files
authored
Optimize Chinese README translation (#239)
***NO_CI***
1 parent c89f1d1 commit b36a4bc

File tree

1 file changed

+90
-92
lines changed

1 file changed

+90
-92
lines changed

README.zh-cn.md

Lines changed: 90 additions & 92 deletions
Original file line numberDiff line numberDiff line change
@@ -3,246 +3,244 @@
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
3030
dotnet tool install -g nanoff
3131
```
3232

3333
成功安装后,将显示一条消息,显示将用于调用工具和所安装的版本的命令。 类似于下面的例子:
3434

35-
```控制台
35+
```shell
3636
You can invoke the tool using the following command: nanoff
3737
Tool '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
4745
dotnet 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
5755
export 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
6563
dotnet tool update -g nanoff
6664
```
6765

6866
如果工具安装在特定的路径下,请使用以下.NET Core CLI命令:
6967

70-
```控制台
68+
```shell
7169
dotnet tool update nanoff --tool-path c:\path-where-the-tool-was-installed
7270
```
7371

74-
## 用法
72+
## 使用方法
7573

76-
一旦安装了该工具,你可以通过使用它的命令“nanoff”来调用它,这是名称的简短版本,以方便输入。
74+
一旦安装了该工具,你就可以通过命令“nanoff”来调用它,这是该程序名称的简称,以方便输入。
7775

78-
```控制台
76+
```shell
7977
nanoff [command] [args]
8078
```
8179

82-
该工具包括所有可用命令的帮助。 您可以通过输入以下命令查看所有可用的列表:
80+
该工具包括所有可用命令的帮助,您可以通过输入以下命令来查看:
8381

84-
```控制台
82+
```shell
8583
nanoff --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
121119
nanoff --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
130128
nanoff --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
140138
nanoff --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
150148
nanoff --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
159157
nanoff --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
169167
nanoff --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
179177
nanoff --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
189187
nanoff --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
197195
nanoff --listjtag
198196
```
199197

200198
### 列出所有可用的STM32设备与DFU连接
201199

202-
这有助于列出所有通过DFU连接的STM32设备
200+
这将列出所有通过DFU连接的STM32设备
203201

204-
```控制台
202+
```shell
205203
nanoff --listdfu
206204
```
207205

208206
### 安装STM32 JTAG驱动程序
209207

210-
为STM32 JTAG连接的目标安装驱动程序
208+
为STM32 JTAG连接的设备安装驱动程序
211209

212-
```控制台
210+
```shell
213211
nanoff --installjtagdrivers
214212
```
215213

216214
### 安装STM32 DFU驱动程序
217215

218-
为STM32 DFU连接的目标安装驱动程序
216+
为STM32 DFU连接的设备安装驱动程序
219217

220-
```控制台
218+
```shell
221219
nanoff --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
231229
nanoff --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
239237
nanoff --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
263261
nanoff -v q
264262
```
265263

266-
## 目标列表
264+
## 设备列表
267265

268266
翻译结果
269-
您可以列出支持的目标及其版本,用于稳定版本或预览。 `--platform` 允许您过滤平台。
267+
您可以列出支持的设备及其版本,用于稳定版本或预览。 `--platform` 允许您过滤平台。
270268

271-
在预览版本中列出可用于ESP32目标的软件包
269+
在预览版本中列出可用于ESP32设备的软件包
272270

273-
```控制台
271+
```shell
274272
nanoff --listboards --platform esp32
275273
```
276274

277-
列出可用于STM32目标的包(稳定版本)。
275+
列出可用于STM32设备的包(稳定版本)。
278276

279-
```控制台
277+
```shell
280278
nanoff --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

Comments
 (0)