docs/library/os.rst: Clarify littlefs requirements for block erase.

pull/7773/head
Peter Hinch 2021-09-07 07:56:26 +01:00 zatwierdzone przez Damien George
rodzic 318c029d45
commit cc0884bb4f
1 zmienionych plików z 6 dodań i 0 usunięć

Wyświetl plik

@ -314,6 +314,12 @@ that the block device supports the extended interface.
``ioctl(6, ...)`` must also be intercepted. The need for others is
hardware dependent.
Prior to any call to ``writeblocks(block, ...)`` littlefs issues
``ioctl(6, block)``. This enables a device driver to erase the block
prior to a write if the hardware requires it. Alternatively a driver
might intercept ``ioctl(6, block)`` and return 0 (success). In this case
the driver assumes responsibility for detecting the need for erasure.
Unless otherwise stated ``ioctl(op, arg)`` can return ``None``.
Consequently an implementation can ignore unused values of ``op``. Where
``op`` is intercepted, the return value for operations 4 and 5 are as