Page 1 of 1

Lacking basic examples & documentation

Posted: Sat Dec 08, 2018 3:39 am
by Elijahg
Hi guys,
I come from an Arduino background (don't we all?) and the ESP SDKs are quite a step up on those. I would really like to use the ESP-MDF for my smart-home project, but I'm really struggling with the lack of documentation.

I've examined the mwifi example/function demo, but even that is quite complex; being full of custom Espressif functions such as MDF_ERROR_CONTINUE and MDF_LOGD. There are a lot of functions present with no documentation, for example both MDF_ERROR_CONTINUE and MDF_LOGD have no documentation at all on the SDK's API listing. Surely logging is one of the most basic functions that should be well documented! I realise the SDK is in active development, but even so it's pretty useless to give complex examples with the absolute minimum of documentation.

Would anyone be able to point me to some documentation for the most basic of mesh networks with the MDF SDK?
Many thanks :)

Re: Lacking basic examples & documentation

Posted: Mon Dec 10, 2018 10:06 am
by ESP_LBB
Hello Elijahg,

you may have the docs via this link, https://docs.espressif.com/projects/esp ... dge=latest.
This is marked on the readme "doc|passing" under the title, though it's not very obvious (even to me for the first time).

Hope this topic will help others who are also seeking for docs ;)
Please let us know if there is any other doc you will need, thanks.

Re: Lacking basic examples & documentation

Posted: Wed May 08, 2019 2:38 pm
by Mahdibr
hi thank you for document

i try to read but still confusing
i read API guide and also API reference but still a lot of your codes not define
like mdf_common.h
you use a lot of things in example but just a few was explained in the API reference
and there is no explanation for macro

and also still your example and code are very advance for me
do you have any suggestion to better understand your code and algorithms and patterns
like book or website or something ...

Re: Lacking basic examples & documentation

Posted: Thu May 09, 2019 8:26 am
by it_zzc
The improvement of our current documentation is still in progress.
If you have any questions, feel free to ask (https://github.com/espressif/esp-mdf/issues) and we will get back to you as soon as possible.
 
About `mcommon.h` is mainly a package for log management and data storage in esp-idf:
1. Log printing, error checking: This is the encapsulation of esp_log in esp-idf, you can refer to: https://docs.espressif.com/projects/esp ... system/log .html?highlight=esp_log
2. Data Storage: See: https://docs.espressif.com/projects/esp ... hlight=nvs

Re: Lacking basic examples & documentation

Posted: Thu May 23, 2019 3:23 pm
by socaltek
it_zzc wrote: The improvement of our current documentation is still in progress.
If you have any questions, feel free to ask (https://github.com/espressif/esp-mdf/issues) and we will get back to you as soon as possible.
Thank you, that helps a lot!