Skip to content

Commit f90c2a2

Browse files
committed
【完善】IDE 介绍文档
1 parent 2d2fad6 commit f90c2a2

File tree

1 file changed

+34
-46
lines changed

1 file changed

+34
-46
lines changed

docs/MicroPythonPlug-in/README.md

Lines changed: 34 additions & 46 deletions
Original file line numberDiff line numberDiff line change
@@ -2,17 +2,31 @@
22

33
VSCode 最好用的 MicroPython 插件,为 MicroPython 开发提供了强大的开发环境,主要特性如下:
44

5-
- 支持通过网络连接远程调试
6-
- 支持网络、USB 或串口的方式连接开发板
7-
- 支持基于 MicroPython 的代码智能补全
5+
- 便捷的开发板连接方式
6+
- 支持基于 MicroPython 的代码智能补全与语法检查
87
- 支持 MicroPython REPL 交互环境
9-
- 提供丰富的代码示例
10-
- 支持自动同步工程代码
11-
- 支持在设备上运行示例代码
12-
- 支持运行选中的代码片段
13-
- 支持多款 MicroPython 开发板
8+
- 提供丰富的代码示例与 demo 程序
9+
- 支持工程同步功能
10+
- 支持直接在设备上运行示例代码文件
11+
- 支持代码片段运行功能
12+
- 支持主流 MicroPython 开发板
1413
- 支持在 windows 以及 ubuntu 操作系统下运行
1514

15+
## 开发板支持列表
16+
17+
| 编号 | 开发板名称 | 固件获取方式 |
18+
| ---- | ------------------------------------------------------------ | ------------------------------------------------------------ |
19+
| 1 | [STM32L4 Pandora IoT Board](https://github.com/RT-Thread/IoT_Board/tree/master/examples/31_micropython) | [RT-Thread 论坛固件汇总贴](https://www.rt-thread.org/qa/forum.php?mod=viewthread&tid=12305&page=1&extra=#pid52954) |
20+
| 2 | [W601 IoT Board](https://github.com/RT-Thread/W601_IoT_Board/tree/master/examples/15_component_micropython) | [RT-Thread 论坛固件汇总贴 ](https://www.rt-thread.org/qa/forum.php?mod=viewthread&tid=12305&page=1&extra=#pid52954) |
21+
| 3 | [ESP8266](https://micropython.org/download#esp8266) | 点击开发板名称链接获取 |
22+
| 4 | [ESP32](https://micropython.org/download#esp32) | 点击开发板名称链接获取 |
23+
| 5 | [PYboard](https://micropython.org/download#pyboard) | 点击开发板名称链接获取 |
24+
| 6 | [others](https://micropython.org/download#other) | 点击开发板名称链接获取 |
25+
26+
`STM32L4 Pandora IoT Board``W601 IoT Board` 开发板的固件由 RT-Thread 官方提供,同时针对 MicroPython 插件开发环境进行深度优化,提供强大的工程同步功能以及更加丰富的固件功能。
27+
28+
欢迎加入RT-Thread MicroPython 交流 QQ 群 **703840633** 获取最新固件,进行技术交流。
29+
1630
## 准备工作
1731

1832
1. 在 windows 操作系统下使用插件需要将 vscode 的默认终端修改为 powershell,如下图所示:
@@ -37,61 +51,41 @@ VSCode 最好用的 MicroPython 插件,为 MicroPython 开发提供了强大
3751

3852
注意:配置修改后需要 **重启一下操作系统** 使配置生效。
3953

40-
## 快速入门
54+
## 快速上手
55+
56+
### 创建 MicroPython 工程
4157

42-
### 创建一个 MicroPython 工程
58+
#### 创建一个空白 MicroPython 工程
4359

4460
![create_blank_dir](assets/create_blank_prj.gif)
4561

62+
#### 创建一个基于demo 的 MicroPython 工程
63+
4664
![create_demo_dir](assets/create_demo_prj.gif)
4765

4866
### 连接开发板
4967

50-
可以通过多种方式与开发板建立连接,现支持 USB 和网络连接方式。
51-
52-
- 串口连接方式
53-
5468
![uart_connect](assets/uart_connect.gif)
5569

56-
- USB 连接方式
57-
58-
直接将开发板通过 USB 连接到 PC 机,将会自动通过 USB 连接设备,如下图所示:
59-
60-
![usb_connect_device](assets/usb_connect.gif)
61-
62-
- 网络连接方式
63-
64-
点击连接按钮,然后选择想要连接的设备名称,如下图所示:
65-
66-
![connect_device](assets/connect_device.gif)
67-
68-
注意:第一次连接网络时请先用 USB 或者串口连接电脑,然后参考 network 例程进行网络连接。
69-
7070
### 运行示例代码
7171

7272
和开发板建立连接后,可以直接运行示例代码,并观察代码在开发板上的运行效果,如下图所示:
7373

7474
![run_example](assets/run_example.gif)
7575

76-
## 功能介绍
77-
78-
- 通过网络、USB 或串口的方式连接开发板
79-
80-
- 提供丰富的 MicroPython 代码示例程序
76+
### 丰富的 MicroPython 代码示例程序
8177

8278
![example_code](assets/example_code.png)
8379

84-
- 支持在设备上直接运行示例代码
80+
### 在设备上直接运行示例代码文件
8581

8682
![run_example_code](assets/run_example_code.png)
8783

88-
- 支持运行代码片段
84+
### 使用运行代码片段功能
8985

9086
![run_code_snippet](assets/run_code_snippet.gif)
9187

92-
- 支持 STM32L4 Pandora IoT Board 、W601 IoT Board 等多款开发板
93-
- 优秀的代码编辑环境
94-
- 基于 MicroPython 的代码智能补全
88+
### 基于 MicroPython 的代码智能补全
9589

9690
![auto_complete](assets/auto_complete.gif)
9791

@@ -103,16 +97,10 @@ VSCode 最好用的 MicroPython 插件,为 MicroPython 开发提供了强大
10397
- [RT-Thread MicroPython 论坛](https://www.rt-thread.org/qa/forum.php?mod=forumdisplay&fid=2&filter=typeid&typeid=20)
10498
- [MicroPython IDE 用户指南](https://www.rt-thread.org/document/site/submodules/micropython/docs/MicroPythonPlug-in/MicroPython_IDE_User_Manual/)
10599
- [MicroPython 固件开发指南](https://www.rt-thread.org/document/site/submodules/micropython/docs/MicroPythonPlug-in/MicroPython_Firmware_Development_Guide/)
106-
- RT-Thread MicroPython 交流 QQ 群:703840633
100+
- RT-Thread MicroPython 技术交流 QQ 群:703840633
107101

108102
## 注意事项
109103

110-
- 请选择 PowerShell 作为默认终端
111-
112-
在 PowerShell 终端中输入 `Set-ItemProperty HKCU:\Console VirtualTerminalLevel -Type DWORD 1` 可以解决退格键等显示乱码的问题。
113-
114-
- 不要删除工程目录下的 `.mpyproject.json` 文件
115-
116-
该文件是 MicroPython 工程的配置文件,删除后将无法正常运行 MicroPython 代码程序。
104+
- 不要删除工程目录下的 `.mpyproject.json` 文件,该文件是 MicroPython 工程的配置文件,删除后将无法正常运行 MicroPython 代码程序。
117105

118106

0 commit comments

Comments
 (0)