Skip to content

Commit 70ea0f3

Browse files
authored
Merge pull request #149 from SummerLife/update_docs_1113
[add] docs/micropython-mpy.md
2 parents ab1f031 + 5472f7e commit 70ea0f3

File tree

3 files changed

+16
-2
lines changed

3 files changed

+16
-2
lines changed
44.2 KB
Loading

docs/firmware-develop.md

Lines changed: 10 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -43,14 +43,22 @@ RT-Thread MicroPython mini 版本占用资源最大不超过:
4343

4444
![config_runtime](assets/config_runtime.png)
4545

46-
### 在根目录挂载文件系统
46+
### 在系统根目录挂载文件系统
4747

48-
最后要确保系统中 `/` 目录挂载了文件系统。有了文件系统,后续才能使用 [**MicroPython 开发环境**](https://marketplace.visualstudio.com/items?itemName=RT-Thread.rt-thread-micropython) 将 Python 代码文件同步到板卡中来运行,本次示例中将使用 elm-fat 文件系统,需要对系统进行如下配置:
48+
最后要确保系统中 `/` 目录挂载了文件系统。有了文件系统,后续才能使用 [**MicroPython 开发环境**](https://marketplace.visualstudio.com/items?itemName=RT-Thread.rt-thread-micropython) 将 Python 代码文件同步到板卡中来运行。
49+
50+
1. 打开 MicroPython 的文件同步功能选项
51+
52+
![open filesync option](assets/open_filesync_option.png)
53+
54+
2. 本次示例使用的开发板,文件系统存放在 SPI Flash 上,BSP 对该存储设备的支持已经做好了,在这里只需开启 elm-fat 文件系统即可,对系统进行如下配置:
4955

5056
![mount_fs](assets/mount_fs.png)
5157

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

60+
当你在自己的板卡上运行 MicroPython 时,你可以自由选择文件系统的存储介质,但是有一点很重要,文件系统要被挂载到根目录 / 上,这样才能保证在后续使用 MicroPython IDE 进行文件传输时不会出错。
61+
5462
### 在 main 线程中启动 MicroPython
5563

5664
最后要在 main 线程中启动 MicroPython,代码修改如下所示:

docs/micropython-mpy.md

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,6 @@
1+
# MicroPython .mpy 文件详解
2+
3+
MicroPython 定义了 `.mpy` 文件的概念,该文件是一种二进制容器文件格式,在其中包含了预编译的 Python 代码,这种类型的文件可以像普通的 `.py` 模块一样被导入到 MicroPython 程序中。举个例子来说明这种类型文件的使用方法。例如,只要 `foo.mpy` 存在于指定的路径中,我们就可以通过 `import foo` 语句来导入 `foo.mpy` 文件。
4+
5+
这种类型文件的导入规则是这样的,首先按顺序搜索 `sys.path` 中列出的每个目录。当搜索特定目录时,首先查找 `foo.py`,如果找不到该目录,则查找 `foo.mpy`,如果没有找到,则在下一个目录中继续搜索。通过这种方式,`foo.py` 文件的优先级将高于 `foo.mpy` 文件。这些 `.mpy` 文件中的主要内容是字节码,这种类型的文件可以通过 `mpy-cross` 程序从 Python 源文件(`.py`文件)生成。
6+

0 commit comments

Comments
 (0)