up-to-date EG915U spi nor flash &EG915UEUABR01A01V02M08_OCPU_QPY

Author: Reinhardt Peng(彭成名)

en-us/api/pythonStdlib.md

@@ -204,7 +204,7 @@ b'\xb3\xc9Y\x1b\xe9'
 
 
 
-##### Initialize SD card driver（SPI mode）
+##### Register storage device - SPI - SD card
 
 At present, it is only supported by ec600n / ec800n platforms.
 
@@ -233,49 +233,7 @@ Initialize SD card and communicate with SD card. Use SPI communication mode.
 
 
 
-##### Mount file system
-
-> **uos.mount(vfs_obj, path)**
-
-Mount the underlying file system to VFS.
-
-* Parameters
-
-|Parameter | parameter type | parameter description|
-| ------- | ---------- | ---------------- |
-| vfs_ Obj | VFS object | file system object|
-|Path | str | root directory of file system|
-
-* Return Value
-
-  * None
-
-* Example
-
-```python
->>> cdev = uos.VfsFat(1, 0, 4, 1)
->>> uos.mount(cdev, '/sd')
-```
-
--SD card usage example(SPI mode)
-
-  At present, it is only supported by ec600n / ec800n platforms.
-
-```python
->>> cdev = uos.VfsFat(1, 0, 4, 1)
->>> uos.mount(cdev, '/sd')
->>> f = open('/sd/test.txt','w+')
->>> f.write('0123456')
->>> f.close()
->>> uos.listdir('/sd')
->>> f = open('/sd/test.txt','r')
->>> f.read()
->>> f.close()
-```
-
-
-
-##### Initialize SD card driver(SDIO mode)
+##### Register storage device - SDIO - SD card 
 
 At present,it is only supported by EC600U/EC200U platforms.
 
@@ -306,7 +264,7 @@ Return vfs object if the execution is successful, otherwise report error.
 >>> udev = VfsSd("sd_fs")
 ```
 
-##### Set detection pin
+###### Set detection pin
 
 > **set_det(vfs_obj.GPIOn,mode)**
 
@@ -332,7 +290,7 @@ Return 0 if the execution is successful, otherwise return -1.
 >>> udev.set_det(udev.GPIO10,0)#Use gpio10 as the card detection pin, insert the SD card, the detection port is low level, plug out the SD card, the detection port is high level(the actual use depends on the hardware).
 ```
 
-##### Setting the card insertion and removal callback function
+###### Setting the card insertion and removal callback function
 
 > **set_callback(fun)**
 
@@ -380,6 +338,93 @@ def call_back(para):
 udev.set_callback(call_back)
 ```
 
+
+
+##### **Register storage device - SPI NOR FLASH**
+
+At present,it is only supported by EG915U platforms.
+
+> uos.VfsLfs1(readsize,progsize,lookahead,pname,spi_port,spi_clk)
+
+Initialize spi nor flash and Plug-in nor flash communication. Use SPI communication mode.
+
+* Parameter
+
+| Parameter | Type | Description                                                  |
+| --------- | ---- | ------------------------------------------------------------ |
+| readsize  | int  | Reserved, not used yet                                       |
+| progsize  | int  | Reserved, not used yet                                       |
+| lookahead | int  | Reserved, not used yet                                       |
+| pname     | str  | Fixed to "ext_fs". Subsequent expansion                      |
+| spi_port  | int  | Supported ports refer to the SPI chapter description         |
+| spi_clk   | int  | clock frequency：<br />EG915U：0：6.25M 1:12.5M  2:25M  3:50M  4:3.125M 5:1.5625M  6:781.25K |
+
+* Return value
+
+  VfsLfs1 object will be returned if successful, and OSError 19 will be returned if failed.
+
+* Example
+
+  ```python
+  >>>ldev = uos.VfsLfs1(32, 32, 32, "ext_fs",1,0)
+  >>>uos.mount(ldev,'/ext')
+  >>>f = open('/ext/test.txt','w+')
+  >>>f.write('hello world!!!')
+  >>>f.close()
+  
+  >>>uos.listdir('ext')
+  
+  >>>f = open('/ext/test.txt','r')
+  >>>f.read()
+  >>>f.close()
+  
+  ```
+
+  
+
+
+##### Mount file system
+
+> **uos.mount(vfs_obj, path)**
+
+Mount the underlying file system to VFS.
+
+* Parameters
+
+| Parameter | parameter type | parameter description         |
+| --------- | -------------- | ----------------------------- |
+| vfs_ Obj  | VFS object     | file system object            |
+| Path      | str            | root directory of file system |
+
+* Return Value
+
+  * None
+
+* Example
+
+```python
+>>> cdev = uos.VfsFat(1, 0, 4, 1)
+>>> uos.mount(cdev, '/sd')
+```
+
+-SD card usage example(SPI mode)
+
+  At present, it is only supported by ec600n / ec800n platforms.
+
+```python
+>>> cdev = uos.VfsFat(1, 0, 4, 1)
+>>> uos.mount(cdev, '/sd')
+>>> f = open('/sd/test.txt','w+')
+>>> f.write('0123456')
+>>> f.close()
+>>> uos.listdir('/sd')
+>>> f = open('/sd/test.txt','r')
+>>> f.read()
+>>> f.close()
+```
+
+
+
 #### gc - Control the Garbage Collector
 
 This module provides an interface to the optional garbage collector. This module implements a subset of the corresponding [CPython](https://docs.micropython.org/en/latest/reference/glossary.html#term-CPython) module, as described below. For more information, refer to the original CPython documentation: [gc](https://docs.python.org/3.5/library/gc.html#module-gc)

zh-cn/api/pythonStdlib.md

@@ -201,7 +201,7 @@ b'\xb3\xc9Y\x1b\xe9'
 
 
 
-##### 初始化SD卡驱动(SPI接口)
+##### 注册存储设备 - SPI - SD卡
 
 目前仅EC600N/EC800N平台支持。
 
@@ -230,49 +230,7 @@ b'\xb3\xc9Y\x1b\xe9'
 
 
 
-##### 挂载文件系统
-
-> **uos.mount(vfs_obj, path)**
-
-挂载底层文件系统到VFS。
-
-* 参数
-
-| 参数    | 参数类型   | 参数说明         |
-| ------- | ---------- | ---------------- |
-| vfs_obj | vfs object | 文件系统对象     |
-| path    | str        | 文件系统的根目录 |
-
-* 返回值
-
-无。
-
-* 示例
-
-```python
->>> cdev = uos.VfsFat(1, 0, 4, 1)
->>> uos.mount(cdev, '/sd')
-```
-
-- SD卡（SPI接口）使用示例
-
-  目前仅EC600N/EC800N平台支持。
-
-```python
->>> cdev = uos.VfsFat(1, 0, 4, 1)
->>> uos.mount(cdev, '/sd')
->>> f = open('/sd/test.txt','w+')
->>> f.write('0123456')
->>> f.close()
->>> uos.listdir('/sd')
->>> f = open('/sd/test.txt','r')
->>> f.read()
->>> f.close()
-```
-
-
-
-##### 初始化SD卡驱动（SDIO接口）
+##### 注册存储设备 - SDIO - SD卡
 
 目前仅EC600U/EC200U平台支持。
 
@@ -304,7 +262,7 @@ b'\xb3\xc9Y\x1b\xe9'
 >>> udev = VfsSd("sd_fs")
 ```
 
-##### 设置检测管脚
+###### 设置检测管脚
 
 > **set_det(vfs_obj.GPIOn,mode)**
 
@@ -330,7 +288,7 @@ b'\xb3\xc9Y\x1b\xe9'
 >>> udev.set_det(udev.GPIO10,0)#使用GPIO10作为卡检测管脚，sd卡插上，检测口为低电平，sd卡取出，检测口为高电平（实际使用根据硬件）
 ```
 
-##### 设置插拔卡回调函数
+###### 设置插拔卡回调函数
 
 > **set_callback(fun)**
 
@@ -378,6 +336,93 @@ def call_back(para):
 udev.set_callback(call_back)
 ```
 
+
+
+##### **注册存储设备 - SPI NOR FLASH**
+
+目前仅EG915U支持
+
+> uos.VfsLfs1(readsize,progsize,lookahead,pname,spi_port,spi_clk)
+
+初始化spi nor flash,和外挂nor flash通信。使用SPI通信方式。
+
+* 参数
+
+| 参数      | 参数类型 | 参数说明                                                     |
+| --------- | -------- | ------------------------------------------------------------ |
+| readsize  | int      | 预留，暂未使用                                               |
+| progsize  | int      | 预留，暂未使用                                               |
+| lookahead | int      | 预留，暂未使用                                               |
+| pname     | str      | 固定为“ext_fs”。后续扩展                                     |
+| spi_port  | int      | 支持的端口参照SPI章节说明                                    |
+| spi_clk   | int      | 时钟频率：<br />EG915U：0：6.25M 1:12.5M  2:25M  3:50M  4:3.125M 5:1.5625M  6:781.25K |
+
+* 返回值
+
+  成功则返回VfsLfs1 object,失败则 OSError 19。
+
+* 示例
+
+  ```python
+  >>>ldev = uos.VfsLfs1(32, 32, 32, "ext_fs",1,0)
+  >>>uos.mount(ldev,'/ext')
+  >>>f = open('/ext/test.txt','w+')
+  >>>f.write('hello world!!!')
+  >>>f.close()
+  
+  >>>uos.listdir('ext')
+  
+  >>>f = open('/ext/test.txt','r')
+  >>>f.read()
+  >>>f.close()
+  
+  ```
+
+  
+
+
+##### 挂载文件系统
+
+> **uos.mount(vfs_obj, path)**
+
+挂载底层文件系统到VFS。
+
+* 参数
+
+| 参数    | 参数类型   | 参数说明         |
+| ------- | ---------- | ---------------- |
+| vfs_obj | vfs object | 文件系统对象     |
+| path    | str        | 文件系统的根目录 |
+
+* 返回值
+
+无。
+
+* 示例
+
+```python
+>>> cdev = uos.VfsFat(1, 0, 4, 1)
+>>> uos.mount(cdev, '/sd')
+```
+
+- SD卡（SPI接口）使用示例
+
+  目前仅EC600N/EC800N平台支持。
+
+```python
+>>> cdev = uos.VfsFat(1, 0, 4, 1)
+>>> uos.mount(cdev, '/sd')
+>>> f = open('/sd/test.txt','w+')
+>>> f.write('0123456')
+>>> f.close()
+>>> uos.listdir('/sd')
+>>> f = open('/sd/test.txt','r')
+>>> f.read()
+>>> f.close()
+```
+
+
+
 #### gc - 内存碎片回收
 
 gc 模块实现内存垃圾回收机制，该模块实现了CPython模块相应模块的子集。更多信息请参阅阅CPython文档：[gc](https://docs.python.org/3.5/library/gc.html#module-gc)