Micropython instructions for setup hard to find for NANO ESP32

[anglerfish27]

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]

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.

• The MicroPython 101 Course is listed in the "feature" section of the Nano ESP32 board's documentation page. This course is intended to be a linear course that introduces you to MicroPython as well as guiding you through the installation. The actual installation takes part in chapter 3 which I understand may need to be introduced earlier, and referenced better in the main page.
• The MicroPython Docs is the docs for all MicroPython boards, including the Nano ESP32. Under "board installation", you will find the generic instructions to install it at the top of the article, and further down the more "advanced", using esptool to flash the FW.
• To use MicroPython with IoT Cloud you can visit this guide. It lives in the "Cloud" documentation, but will probably also added to the MicroPython section.
• The tutorial you referenced (for Portenta H7) is a remnant of the past and should be removed. I believe we missed that, and it unfortunately shows up in the "Tutorials" page. @jacobhylen , could you take a look at removing it?

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