Sfoglia il codice sorgente

Merge pull request #149 from SummerLife/update_docs_1113

[add] docs/micropython-mpy.md
朱天龙 (Armink) 6 anni fa
parent
commit
70ea0f3d31

BIN
docs/assets/open_filesync_option.png


+ 10 - 2
docs/firmware-develop.md

@@ -43,14 +43,22 @@ RT-Thread MicroPython mini 版本占用资源最大不超过:
 
 ![config_runtime](assets/config_runtime.png)
 
-### 在根目录挂载文件系统
+### 在系统根目录挂载文件系统
 
-最后要确保系统中 `/` 目录挂载了文件系统。有了文件系统,后续才能使用 [**MicroPython 开发环境**](https://marketplace.visualstudio.com/items?itemName=RT-Thread.rt-thread-micropython) 将 Python 代码文件同步到板卡中来运行,本次示例中将使用 elm-fat 文件系统,需要对系统进行如下配置:
+最后要确保系统中 `/` 目录挂载了文件系统。有了文件系统,后续才能使用 [**MicroPython 开发环境**](https://marketplace.visualstudio.com/items?itemName=RT-Thread.rt-thread-micropython) 将 Python 代码文件同步到板卡中来运行。
+
+1. 打开 MicroPython 的文件同步功能选项
+
+![open filesync option](assets/open_filesync_option.png)
+
+2. 本次示例使用的开发板,文件系统存放在 SPI Flash 上,BSP 对该存储设备的支持已经做好了,在这里只需开启 elm-fat 文件系统即可,对系统进行如下配置:
 
 ![mount_fs](assets/mount_fs.png)
 
 配置完成后,记得要使用 `scons --target=mkd5` 重新生成工程,使配置在工程中生效。
 
+当你在自己的板卡上运行 MicroPython 时,你可以自由选择文件系统的存储介质,但是有一点很重要,文件系统要被挂载到根目录 / 上,这样才能保证在后续使用 MicroPython IDE 进行文件传输时不会出错。
+
 ### 在 main 线程中启动 MicroPython 
 
 最后要在 main 线程中启动 MicroPython,代码修改如下所示:

+ 6 - 0
docs/micropython-mpy.md

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