Why the Hell I have to do reverse engineering to use a commercial product?

https://docs.pycom.io/pycom_esp32/library/uos.html#uos.stat

This is standard micropython documentation and the returned values are actually documented in standard Python: https://docs.python.org/2/library/errno.html#module-errno

Does that help?

Hello,

This is standard micropython documentation and the returned values are actually documented in standard Python: https://docs.python.org/2/library/errno.html#module-errno

Does that help?

Why are you referring to the error codes?

In the Pycom doc there is nothing about return values. Without describing return values for a function it is not a documentation. You can say 'It is the same as in cPython' but even in this case why to refer to an external documention in your own doc?

As a developer, do you like to work with a product with useless documentation, unmet commitments, misleading brochures and product descriptions with missing features based on unstable beta hardware where even no any warranty that hw vendor will fix issues and no ETA it will ever work on acceptable level?
As a hobby DIY constructor you can play with such board in the evening in your free time but no way to use it for a product.

You can say it is up to the hw vendor which is probably true. But to release a product based on alpha unproven silicon with alpha fw is a bad decision op Pycom. During the last few month your documentation structure is still messy and nearly unusable. Yesterday I was looking for the documentation and at pycom.io site there are no single menu item for docs. You do not have to reinvent the wheel, just do what others are doing well. Not referring to big guns, but other KickStarters with similar products providing excellent docs.

I'm really unhappy and fior sure will never buy any Pycom product and do not advice others to do it.

The Pycom doc parts that refer to MicroPython are not modified to allow future merging. Here's the original MicroPython doc of uos.stat: http://docs.micropython.org/en/latest/pyboard/library/uos.html#uos.stat. As you see, there's nothing there. That's what I meant by standard MicroPython documentation. Perhaps we should improve the documentation of that function in our docs.

Without being the creator of MicroPython, I think that the fact that it is a port of Python 3 for microcontrollers means that the error codes of a function like stat must be the same (or at least close) to the error codes of standard Python. That's why I referred to Python's documentation.

About your rest points, I agree that a docs link should be added to pycom.io. And we are trying hard to improve both our documentation and our firmware.

Sorry to hear about your disappointment. I hope that we can change your mind.

>>> os.stat('/sd')
(16384, 0, 0, 0, 0, 0, 0, 12873600, 12873600, 12873600)

what are that values?
i need to know how big is sd card, free space ...

@bmarkus

About your rest points, I agree that a docs link should be added to pycom.io. And we are trying hard to improve both our documentation and our firmware.

After 21 days Pycom doc looks the same at https://docs.pycom.io/pycom_esp32/library/uos.html

saying only

Get the status of a file or directory.

So, question is still valid, what is the return value? It is a question related to your own commercial product, not related to chip vendor, LoRa Alliance, CIA, KGB, ...

What is about making a product usable for its customers and provide documentation? How do you expect to use it (expecting we get some free RAM and stable functions instead of changing it every week, introducing new bugs, etc.)?

Fair points. We are planning to release an update to our documentation this week and documenting the return values of os.stat will be part of it.

it work for you in that way?
like os.stat().ST_SIZE?

i must check this at home - i tested this previously and i remember that it does not know ST_SIZE

The symbolic indices are NOT set.

and that is the point

but as @sakis say it will change in this week

@soren @bmarkus I see this as a semi-commercial product.

It is a commercial product range offered in form of development and OEM moduls.