ESP32-S2-Saola-1 Arduino installation

ESP32-S2-Saola-1 Arduino installation - Windows 10

This may work on other platforms; do not ask me how. This should be a portable installation.
It is incompatible with Arduino for other boards.

Download Arduino 1.8.16 Windows ZIP file
- not (yet) Arduino 2.0
Right-click the downloaded zip file; select Extract All...
- set a destination, preferably with a short path (e.g. D:\my\Arduino)
- Extract
In that installation folder, be sure to add a portable folder:
Launch arduino.exe (or a shortcut to it)
- File > Preferences > Sketchbook location:
- must differ from install destination or other Arduino Sketchbook locations;
- usually in Documents\; I used a separate D:\my\Documents\
There are 2 ways to proceed. Do you feel lucky?
- using (experimental) GitHub esp32 core and TinyUSB library for ESP32-S2,
  which worked one time for me, then failed badly a second time...
- using Arduino core and library, as described here, which still involves some faffing.
In Arduino > File > > Preferences, set Additional Boards Manager URLs: to
https://raw.githubusercontent.com/espressif/arduino-esp32/gh-pages/package_esp32_index.json
In Arduino Sketch > Include Library > Manage Libraries.. search for tinyusb
and select ESP32TinyUSB
Eliminate Arduino build warnings for "CFG_TUSB_*" redefined in sketches using midiusb.h :
- In my\arduino-1.8.16\portable\packages\esp32\hardware\esp32\2.0.1\tools\sdk\esp32s2\include\arduino_tinyusb\include\tusb_config.h:
- move all unconditional #define's (COMMON CONFIGURATION and DRIVER CONFIGURATION)
  from near the file end to before #include "tusb_option.h" like this.
Enable USB MIDI traffic:
In my\Documents\libraries\ESP32TinyUSB\src\device\midi\midiusb.cpp,
change midiusb.cpp://#define EPNUM_MIDI 0x05 to 0x04 like this
In Arduino: Tools > Board: "ESP32S2 Dev Module"
To install custom Arduino libraries from GitHub, using GitHub Desktop
... which handles submodule automagically...
In [GitHub Desktop](https://desktop.github.com):
- File > Clone repository... - URL - fill in username/repository, e.g. chegewara/EspTinyUSB - fill in Local path. e.g. D:\my\Documents\libraries - click clone - Arduino's IDE console window will show invalid library complaints if this fails.
Install these additional libraries



supplementary information


Arduino ESP32S2 Dev Module board options are somewhat documented at the
 platformio Esprissif32 page,

 with some information in platform-espressif32/boards/esp32-s2-saola-1.json

While PlatformIO generally runs down-level versions of Arduino code,

Espressif appears to implement Arduino stuff there first,

perhaps an easier intermediate step from their proprietary esp-idf.

Upload Speed (what determines?)
921600
115200 *
256000
230400
512000
USB CDC On Boot (native USB?)
Disabled *
Enabled
USB Firmware MSC On Boot (mass storage class)
Disabled *
Enabled
USB DFU On Boot (native USB?)
Disabled *
Enabled
Upload Mode (Boot ROM?)
UART0 *
Internal USB
CPU Frequency (what determines?)
240MHz (WiFi)
160MHz (WiFi)
80MHz (WiFi)
40MHz
20MHz
10MHz
Flash Frequency (what determines?)
80MHz
40MHz *
Flash Mode (what determines?)
QIO *
DIO
QOUT
DOUT
Flash Size
4MB (32Mb) *
8MB (64Mb)
2MB (16Mb)
16MB (128Mb)
Partition Scheme
Default 4MB with spiffs (1.2MB APP/1.5MB SPIFFS) *
Default 4MB with ffat (1.2MB APP/1.5MB FATFS)
8M Flash (3MB APP/1.5MB FATFS)
Minimal (1.3MB APP/700KB SPIFFS)
No OTA (2MB APP/2MB SPIFFS)
No OTA (1MB APP/3MB SPIFFS)
No OTA (2MB APP/2MB FATFS)
No OTA (1MB APP/3MB FATFS)
Huge APP (3MB No OTA/1MB SPIFFS)
Minimal SPIFFS (1.9MB APP with OTA/190KB SPIFFS)
16MB Flash (2MB APP/12.5MB FAT)
16MB Flash (3MB APP/9MB FATFS)
Core Debug Level
None *
Error
Warn
Info
Debug
Verbose
PSRAM
Disabled (WROOM) *
Enabled  (WROVER)
Port
Serial ports
Get Board Info
(App option?)

Programmer (can one be configured?)
No programmers available for this board
Burn Bootloader
(applicable?)



SparkFun's hookup guide
 includes the Silicon Labs'
 Windows VCP driver for Arduino loading.
UnexpectedMaker describes using
 esptool to flash ESP32-S2.
espressif installing ESP32-S2 board manager support
Arduino custom board definitions
     instructables:   Creating Arduino IDE Custom Boards
Custom board configurations can be available under the Tools > Processor menu.

     Arduino forum reference: How
 to specify unique compiling options for multiple sketches?

   Official documentation:  Custom board options

     Arduino forum reference: Multiple board’s configuration options
 

Oct 21, 2021 Install
 arduino-esp32 2.0.0 on Arduino IDE, to program ESP32-S2/C3
For ESP32-S2-Saola-1, select board of
 "ESP32S2 Dev Module"
Driving
 on-board RGB LED (WS2812) on GPIO 18


With 31 Aug 2021 release of ESP32 Arduino 2.0.0,

ESP32-S2 can be added to Arduino IDE using board manager,

but espressif still publishes beta board support.


OTG USB cable
Sadly, ESP32-S2-Saola-1 board USB pins GPIO19+20 are not near a ground.



iPhone "harmonica" connectors may never come back into fashion;

one with a thick cable was sacrificed:




It was double-shielded.                        
       
 I don't crochet, but a small hook helps sort fine wires.



A pair of pins are wanted:





Power leads were easily distinguished from signal by strand count, if not color.

Note: black wire is NOT connected to shield.



A broken DIP socket helps serve up pins for tack soldering:



Hot glue comes next, for insulation and mechanical support.

maintained by blekenbleu