Skip to content

Commit 88022c2

Browse files
committed
[update] micropython docs
1 parent a4f9675 commit 88022c2

15 files changed

+73
-36
lines changed
528 KB
Loading

docs/assets/IoT_Board.png

530 KB
Loading
31.5 KB
Loading

docs/figures/IoT_Board.png

-1.9 MB
Binary file not shown.

docs/firmware-develop.md

Lines changed: 16 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -2,19 +2,30 @@
22

33
如果手上没有官方支持固件的开发板,就需要自己来动手制作 MicroPython 固件了。由于 RT-Thread 官方提供了 MicroPython 软件包,并且 MicroPython 底层和硬件绑定时对接了 RT-Thread 驱动框架,所以我们可以很方便地在运行了 RT-Thread 的板卡上将 MicroPython 跑起来。
44

5+
**注意**:RT-Thread MicroPython 需要运行在 **RT-Thread 3.0** 版本以上。
6+
7+
### 选择合适的 BSP 平台
8+
9+
RT-Thread MicroPython mini 版本占用资源最大不超过:
10+
11+
- ROM : 190KB
12+
- RAM : 20KB
13+
14+
只要系统资源满足上述要求,常见的许多开发板都可以运行 MicroPython,例如 STM32 系列 BSP。
15+
516
接下来我们以 `rt-thread\bsp\stm32\stm32f407-atk-explorer` 上的 MDK 工程为例,讲解如何在 BSP 的基础上制作 MicroPython 固件。
617

718
### 获取 MicroPython 软件包
819

920
先使用 `pkgs --upgrade` 命令更新软件包列表,然后通过 env 工具选中 MicroPython 软件包,最后使用 `pkgs -update` 命令将软件包拉取到本地。
1021

11-
![select_mpy_package](figures/select_mpy_package.png)
22+
![select_mpy_package](assets/select_mpy_package.png)
1223

1324
### 增大 main 线程栈
1425

1526
为了能后续在 main 线程中启动 MicroPython 运行时环境,需要增大 main 线程的栈大小,这里我们将栈大小增加到 8k。
1627

17-
![add_main_stack](figures/add_main_stack.png)
28+
![add_main_stack](assets/add_main_stack.png)
1829

1930
### 配置 MicroPython 运行环境堆大小
2031

@@ -24,19 +35,19 @@
2435

2536
重新生成工程,编译下载后通过 `msh``free` 命令来查看内存使用情况。
2637

27-
![check_memory](figures/check_memory.png)
38+
![check_memory](assets/check_memory.png)
2839

2940
#### 配置系统
3041

3142
通过上一步查询的内存分配情况,对系统 RAM 资源有了一定的了解。在本次示例中,我们分配 20k 内存用于 MicroPython 运行时环境。后续如果想要运行更多 MicroPython 代码,可以将更多空余内存分配给 MicroPython 运行时环境,配置如下图所示:
3243

33-
![config_runtime](figures/config_runtime.png)
44+
![config_runtime](assets/config_runtime.png)
3445

3546
### 在根目录挂载文件系统
3647

3748
最后要确保系统中 `/` 目录挂载了文件系统。有了文件系统,后续才能使用 [**MicroPython 开发环境**](https://marketplace.visualstudio.com/items?itemName=RT-Thread.rt-thread-micropython) 将 Python 代码文件同步到板卡中来运行,本次示例中将使用 elm-fat 文件系统,需要对系统进行如下配置:
3849

39-
![mount_fs](figures/mount_fs.png)
50+
![mount_fs](assets/mount_fs.png)
4051

4152
配置完成后,记得要使用 `scons --target=mkd5` 重新生成工程,使配置在工程中生效。
4253

0 commit comments

Comments
 (0)