platformio / platformio-docs

PlatformIO Documentation
https://docs.platformio.org
Apache License 2.0
240 stars 325 forks source link

Better explanation for the initial upload for ESP OTA. #222

Closed HubKing closed 2 years ago

HubKing commented 2 years ago

If you search Google, it shows this page. I, like most people, already know the basic idea of OTA, and just wanted to know the instructions to enable it on the ESP. But the documentation, instead of give the concise information about the preparation step, just tells the user to read the "What is OTA? How to use it?" link.

That leads users to a very length web page. The problem is that the page only explanations the step for the Arduino IDE. It asks the user to run the BasicOTA.ini under examples, but Platform IO has no such menu. After watching the lengthy linked YouTube video, I heard that the video author has his own documentation page. In that page, it has link for the BasicOTA.ini file.

Either the PlatformIO's documentation page should link that page right below "Firstly, please read What is OTA? How to use it?" or add concise explanation for the steps to upload the initial binary using PlatformIO, not the Arduino IDE.

ivankravets commented 2 years ago

@valeros please add a link to https://github.com/esp8266/Arduino/blob/master/libraries/ArduinoOTA/examples/BasicOTA/BasicOTA.ino