uos – 基本“文件系统”服务

概要

  本节简要介绍Waffle Nano上的文件系统uos，详细介绍如何使用python对Waffle Nano内部的SPIFFS文件系统进行操作。

注意：

  1.文件系统在执行任务过程中异常掉电，存在造成正在写入的文件被损坏的风险。对掉电保护要求高的场景，不建议往文件系统中对文件进行任何操作，或者须根据应用场景做好数据备份。

  2.文件系统底层依赖的FLASH存储器件存在常温下10万次读写寿命的限制，建议用户程序尽可能避免对其长期反复进行操作。

  3.目前文件系统不支持多级目录，所有文件都同一保存在根目录下。

  4.文件系统所能管理的文件名最长不能超过31byte。

  5.此文件系统最大支持同时打开32个文件,且删除文件时，如果已经打开32个文件，则必须调用python的File close()方法关闭其中任意一个文件，否则将无法删除文件。

  6.文件系统分区大小虽然有44kb,但其并非全部能用于存储文件数据，有效利用率比较低，具体存储空间大小按照实际使用为准，与文件本身有关。

函数

uos.remove(path)

  函数说明：删除一个文件。

  函数参数：path文件名字符串。

  函数返回：

  示例：从Waffle Nano中删除一个名为a.txt的文件。

>>>import uos
>>>uos.remove("a.txt")
True

uos.uname()

  函数说明：获取系统信息

  函数返回：系统信息字典

  示例：从Waffle Nano中获取当前系统信息。

>>>import uos
>>>uos.uname()
(sysname='BlackWalnutOS', release='OpenHarmony-v1.1.1-LTS', version='v0.8.0-beta on 2021-07-22', machine='Waffle Nano with Hi3861V100')

uos.move(old_path, new_path)

  函数说明：移动文件(文件重命名)。

  函数参数：old_path旧文件名字符串。new_path新文件名字符串。

  函数返回：

  示例：将Waffle Nano中的一个名为a.txt的文件重命名为b.txt。

>>>import uos
>>>uos.move('a.txt','b.txt')
True

uos.copy(old_path, new_path)

  函数说明：文件复制。

  函数参数：old_path待复制的文件名字符串。new_path新文件的文件名字符串。

  函数返回：

  示例：将Waffle Nano中的一个名为a.txt的文件复制成为一个名为b.txt的文件，并依然保留原有的a.txt文件。

>>>import uos
>>>uos.copy('a.txt','b.txt')
True

uos.stat(path)

  函数说明：获取文件大小。

  函数参数：文件名字符串。

  函数返回：文件字节数

  示例：显示Waffle Nano中的一个名为a.txt的文件大小，如下所示，其大小为1498字节。

>>>import uos
>>>uos.stat("b.txt")
1498

uos.list()

  函数说明：浏览当前Waffle Nano上的所有文件。

  函数返回：文件名字符列表。

  示例：显示Waffle Nano中所有文件。下述代码运行结果表示在这块Waffle Nano上存在b.txt和a.txt两个文件。

>>>import uos
>>>uos.list()
['b.txt', 'a.txt']