uos docs: the abstract block device SOLVED

[pythoncoder]

Maybe I'm being dumb but I find the doc rather opaque and I have two queries.

The doc seems to imply that a uos.AbstractBlockDev class exists. As far as I can see it does not, and the concept is merely a template for writing block devices. You can write a base class following the design of this template to produce devices which can be mounted as filesystems.

Secondly, in addition to the basic, aligned readblocks and writeblocks methods, the doc describes unaligned methods with an offset arg, but gives no reason why you might want to do this. In my efforts I've written only an ioctl and the aligned variants; the outcome appears to work correctly. Should I also provide unaligned methods?

Any clarification would be gratefully received.

[Christian Walther]

I haven’t checked, but the wording of this sentence seems to imply that littlefs requires the extended readblocks/writeblocks interface:

As it supports the extended interface, it can be used with littlefs

[pythoncoder]

Thank you, that does make sense and your conclusion is supported by the code examples.

I hadn't spotted that page in the docs

[jimmo]

Thanks, I agree this could do with a better explanation -- sent https://github.com/micropython/micropython/pull/5421

[pythoncoder]

That's great, but I've added some more suggestions. The doc is rather ambiguous as it stands.