arduino / docs-content

Arduino documentation (docs.arduino.cc)
https://docs.arduino.cc/
Creative Commons Attribution Share Alike 4.0 International
157 stars 368 forks source link

Micropython instructions for setup hard to find for NANO ESP32 #1395

Open anglerfish27 opened 11 months ago

anglerfish27 commented 11 months ago

Good day,

This page: [https://docs.arduino.cc/hardware/nano-esp32]

Does not talk at all about the Arduino NANO ESP32 and loading/installing/updating Micropython. The big buttons highlighted on the page "Setup Guide" and "Getting Started" make no mention of Micropython.

You have to dig yourself into the Micropython 101 course to eventually find this page: https://docs.arduino.cc/micropython/basics/board-installation#nano-esp32

However you have a conflicting page for getting Micropython on and running on other boards where the ESP32 is not listed: The url suggests its for the Portenta only however it lists the various boards "supported" and the instructions on how to load Micropython on it and the NANOESP32 is nowhere to be found. https://docs.arduino.cc/tutorials/portenta-h7/micropython-installation#arduino-portenta-h7. I suspect this page is in direct conflict with the Micropython 101 course page and clean up needs to happen.

Also there needs to be much more detailed examples of how to connect to the IoT cloud using Micropython on the supported boards. Right now you have go to Github for any examples. This detailed information should be part of the "Setup Guide" and "Getting Started" on the first link mentioned above. Instead it assumes the use of Arduino's code and IDE only. Support for both must now be included as you have stated officially they are supported.

Micropython use out of the box cannot be an after thought in your documentation. It needs equal priority as Arduino IDE instructions.

At this point I am still unaware of how to update the WIFI drivers to the latest which I believe is 1.75. I found a way to do it from Adafruit's website, however this is not the same exact WIFI module. Instructions for checking the WIFI version in Micropython are needed which shouldn't be too hard if Adafruit was able to do it for Circuitpython.

Then instructions to ugprade the WIFI firmware should be a file that you keep on your Github site same as Adafruit does. See Adafruit as references: https://learn.adafruit.com/upgrading-esp32-firmware/overview https://github.com/adafruit/nina-fw/releases/tag/1.7.5

Currently I have no way of telling what version my WIFI version is at and what the latest even is since the NANO uses a NORA-W106 module but the Adafruit page speaks of 102.

karlsoderby commented 11 months ago

Hello there @anglerfish27 , and thank you for submitting a very detailed and good frame of your issues. I am going to try and answer it as good as possible, and list some actions we are planning to do.

Hopefully this provides some answers, and thanks again for the detailed report.