\ No newline at end of file
diff --git a/ESP32-S3-DevKitC-1_44Pin/ESP32-S3-DevKitC-1_44Pin-Preview.png b/ESP32-S3-DevKitC-1_44Pin/ESP32-S3-DevKitC-1_44Pin-Preview.png
new file mode 100644
index 0000000..d14353a
Binary files /dev/null and b/ESP32-S3-DevKitC-1_44Pin/ESP32-S3-DevKitC-1_44Pin-Preview.png differ
diff --git a/ESP32-S3.html b/ESP32-S3.html
new file mode 100644
index 0000000..a166c9a
--- /dev/null
+++ b/ESP32-S3.html
@@ -0,0 +1,18 @@
+
commandments
+
+
+
ESP32-S3 boards vary on which GPIOs are used by HSPI bus (SCK, MISO, MOSI). Usually, no VSPI bus is available.
+
Do not use GPIOs 35 to 37 on boards with 8MB or more of PSRAM.
+
Empty value = error.
+
GPIOs 22-34, 45, and 46 are either reserved or not usable.
+
GPIOs 19 and 20 are used by USB port, 43 and 44 are usually used by USB and Serial. Some boards may use other GPIOs. Please double-check.
+
Connect display and VS RST-pin to board's RST/EN/ST pin (value -1).
+
GPIOs 0 (BOOT) and 3 (JTAG) are strapping pins and must be kept HIGH at boot (might be okay for push-buttons).
\ No newline at end of file
diff --git a/ESP32.js b/ESP32.js
new file mode 100644
index 0000000..fb5c1d6
--- /dev/null
+++ b/ESP32.js
@@ -0,0 +1,5 @@
+// This file handles which pins need to be banned from use for certain board types
+var BanPinsInfo = "Auxiliary section that allows you to prohibit the appointment of GPIOs 16-17 when choosing ESP32-WROVER module.";
+var noBanPinsLabel = "WROOM";
+var BanPinsLabel = "WROVER";
+var BanPins = [16, 17];
diff --git a/ESP32_Module/ESP32_Module-Board.jpg b/ESP32_Module/ESP32_Module-Board.jpg
new file mode 100644
index 0000000..a180d50
Binary files /dev/null and b/ESP32_Module/ESP32_Module-Board.jpg differ
diff --git a/ESP32_Module/ESP32_Module-Pins.js b/ESP32_Module/ESP32_Module-Pins.js
new file mode 100644
index 0000000..ddaa941
--- /dev/null
+++ b/ESP32_Module/ESP32_Module-Pins.js
@@ -0,0 +1,13 @@
+var defaultValues = {
+ "TFT_DC": 4, "TFT_CS": 5, "TFT_RST": -1, "BRIGHTNESS_PIN": 255,
+ "I2C_SDA": 21, "I2C_SCL": 22,
+ "I2S_DOUT": 27, "I2S_BCLK": 26, "I2S_LRC": 25,
+ "VS1053_CS": 255, "VS1053_DCS": 25, "VS1053_DREQ": 26, "VS1053_RST": -1,
+ "TS_CS": 13, "TS_SDA": 33, "TS_SCL": 32, "TS_INT": 21, "TS_RST": 25,
+ "LED_BUILTIN": 2, "MUTE_PIN": 255, "WAKE_PIN": 255, "LIGHT_SENSOR": 255, "IR_PIN": 255,
+ "ENC_BTNR": 255, "ENC_BTNL": 255, "ENC_BTNB": 255, "ENC2_BTNR": 255, "ENC2_BTNL": 255, "ENC2_BTNB": 255,
+ "BTN_LEFT": 255, "BTN_CENTER": 255, "BTN_RIGHT": 255, "BTN_UP": 255, "BTN_DOWN": 255, "BTN_MODE": 255
+};
+var validGPIOs = [-1, 0, 2, 4, 5, 12, 13, 14, 15, 16, 17, 18, 19, 21, 22, 23, 25, 26, 27, 32, 33, 34, 35, 36, 39, 255];
+var vspiGPIOs = [ 18, 19, 23 ]; // SCK, MISO, MOSI
+var hspiGPIOs = [ 14, 12, 13 ]; // SCK, MISO, MOSI
diff --git a/ESP32_Module/ESP32_Module-Preview.css b/ESP32_Module/ESP32_Module-Preview.css
new file mode 100644
index 0000000..ed63aef
--- /dev/null
+++ b/ESP32_Module/ESP32_Module-Preview.css
@@ -0,0 +1,20 @@
+#preview-pins ul {
+ padding-top: 118px;
+ padding-bottom: 0px;
+}
+#preview-pins ul li {
+ padding: 0 6px;
+ height: 23.3px;
+ line-height: 23.3px;
+}
+#preview-pins-center {
+ width: 555px;
+ height: 600px;
+ background: #000 url(ESP32_Module-Preview.png) center center no-repeat;
+}
+.preview-pin {
+ line-height: 16px;
+ font-size: 15px;
+ margin: 0 2px;
+ padding: 0 8px;
+}
\ No newline at end of file
diff --git a/ESP32_Module/ESP32_Module-Preview.html b/ESP32_Module/ESP32_Module-Preview.html
new file mode 100644
index 0000000..a5d1779
--- /dev/null
+++ b/ESP32_Module/ESP32_Module-Preview.html
@@ -0,0 +1,57 @@
+
+
+
+
LOST PINS
+
+
+
+
GND
+
3v3
+
X
+
+
+
+
+
+
+
+
+
+
+
+
+
GND
+
+
X
+
X
+
X
+
+
+
+
+
+
GND
+
+
+
X
+
X
+
+
X
+
+
+
+
+
+
+
+
X
+
+
+
X
+
X
+
X
+
+
+
+
ок
+
diff --git a/ESP32_Module/ESP32_Module-Preview.png b/ESP32_Module/ESP32_Module-Preview.png
new file mode 100644
index 0000000..e1586ec
Binary files /dev/null and b/ESP32_Module/ESP32_Module-Preview.png differ
diff --git a/README.md b/README.md
index 6a4839f..bf71420 100644
--- a/README.md
+++ b/README.md
@@ -1,13 +1,35 @@
-### Some tools to help you set up and flash the [ёRadio](https://github.com/e2002/yoradio) esp32 web-radio project
----
-#### 1. ёRadio - [simple myoptions.h generator](https://e2002.github.io/docs/myoptions-generator.html)
+# ёRadio - simple myoptions.h generator
+
+This is a tool to help you set up and flash the [ёRadio](https://github.com/e2002/yoradio) ESP32 web-radio project
+
+This is a dynamic html page that runs in a browser (chrome, firefox, opera) or online. After some actions, using the mouse and keyboard, the output is the configuration file **myoptions.h**, completely ready for use in the project.
+
+[Click here to use the tool!](https://e2002.github.io/docs/myoptions-generator.html)
+
+## Notes
+
+Original Layout and format and coding by e2002 for yoRadio (for ESP32), made dynamic by Trip5 (for ESP32-S3, ESP32-C3, more).
+
+### Features
+
+* Dropdown selector to change boards (includes ESP32, ESP32-S3, ESP32-C3 boards including modules in case no board is appropriate)
+
+* Adds correct MCU type to options export
+
+* Previews of all boards available in selector
+
+* A board pinout now included so you can see which pins are available (click to zoom)
+
+* Dynamic Javascript / HTML so that certain text is shown / hidden according to board or MCU type
+
+* Handles HSPI which is default of ESP32-S3 and ESP32-C3 boards correctly (both for selecting and exporting)
+
+* Adds Neopixel pin and option under LED to use an RGB Neopixel - also exports correctly
-**myoptions.h** file generator for the [ёRadio](https://github.com/e2002/yoradio) project.
-It is a single html file that runs in a browser (chrome, firefox, opera) or online.
-After some actions with which, using the mouse and keyboard, the output is the configuration file **myoptions.h**, completely ready for use in the project.
+* 100% compatible (probably) with current options
-https://e2002.github.io/docs/myoptions-generator.html
+### The to-do list
----
+* Add some more ESP32 and ESP32-S3 and ESP32-C3 boards
diff --git a/Template/ESP32-S3-C3-Modules.pptx b/Template/ESP32-S3-C3-Modules.pptx
new file mode 100644
index 0000000..eb4e3c3
Binary files /dev/null and b/Template/ESP32-S3-C3-Modules.pptx differ
diff --git a/Template/Notes.txt b/Template/Notes.txt
new file mode 100644
index 0000000..c2fcb6b
--- /dev/null
+++ b/Template/Notes.txt
@@ -0,0 +1,11 @@
+You can see the naming scheme by other folders. The folder and file prefixes must match!
+Three files have -Preview as a suffix. They help display the board and pin preview.
+The preview graphic must be a .png file with a transparency layer (256 colors will save disk space).
+The board graphic must be a .jpg file and has -Board as a suffix.
+Finally the -Pins suffix is a javascript file loaded by the main webpage to show which pins are valid and defaults.
+
+I recommend hosting the page locally with the VSCode Studio extension called "Live Preview".
+
+Add your board name to the board-select in myoptions-generator.html and then you can do a live preview.
+Especially with the preview graphic and while checking pins, it is useful to first select your board,
+and click >> link to this configuration << on the bottom so your board loads by default with every edit.
diff --git a/Template/Template-Pins.js b/Template/Template-Pins.js
new file mode 100644
index 0000000..e92b220
--- /dev/null
+++ b/Template/Template-Pins.js
@@ -0,0 +1,18 @@
+// MOSI, MISO, SCK mandatory, SDA & SCL from board profile, LED if exists, recommended pins for some, all others 255
+var defaultValues = {
+ "TFT_DC": 255, "TFT_CS": 255, "TFT_RST": -1, "BRIGHTNESS_PIN": 255,
+ "I2C_SDA": 42, "I2C_SCL": 41,
+ "I2S_DOUT": 255, "I2S_BCLK": 255, "I2S_LRC": 255,
+ "VS1053_CS": 255, "VS1053_DCS": 255, "VS1053_DREQ": 255, "VS1053_RST": -1,
+ "TS_CS": 255, "TS_SDA": 255, "TS_SCL": 255, "TS_INT": 255, "TS_RST": 255,
+ "LED_BUILTIN": 48, "MUTE_PIN": 255, "WAKE_PIN": 255, "LIGHT_SENSOR": 255, "IR_PIN": 255,
+ "ENC_BTNR": 255, "ENC_BTNL": 255, "ENC_BTNB": 255, "ENC2_BTNR": 255, "ENC2_BTNL": 255, "ENC2_BTNB": 255,
+ "BTN_LEFT": 255, "BTN_CENTER": 255, "BTN_RIGHT": 255, "BTN_UP": 255, "BTN_DOWN": 255, "BTN_MODE": 255,
+};
+
+// include all usable pins (including optionally banned pins like 35 to 37 on ESP32-S3 with PSRAM 8MB+) - do not include any with X in the html
+var validGPIOs = [-1, 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 21, 35, 36, 37, 38, 39, 40, 41, 42, 47, 48, 255];
+
+// use 255 if unknown (modules only) // use all -1 if not available (ESP32-S3/C3 use HSPI only)
+var vspiGPIOs = [-1, -1, -1]; // SCK, MISO, MOSI Not available
+var hspiGPIOs = [36, 37, 35]; // SCK, MISO, MOSI
diff --git a/Template/Template-Preview.css b/Template/Template-Preview.css
new file mode 100644
index 0000000..3578558
--- /dev/null
+++ b/Template/Template-Preview.css
@@ -0,0 +1,20 @@
+#preview-pins ul {
+ padding-top: 0px; /* Pushes the lists down */
+ padding-bottom: 0px; /* Pushes the lists up */
+}
+#preview-pins ul li {
+ padding: 0 6px;
+ height: 27.5px; /* Increase/decrease the space between pin names */
+ line-height: 27.5px; /* Keep these 2 numbers the same */
+}
+#preview-pins-center {
+ width: 306px; /* Image width - 400 or less is ideal, 500 is too much */
+ height: 600px; /* resize the Preview image to 600 pixels high */
+ background: #000 url(Template-Preview.png) center center no-repeat; /* You must edit this to match the file name */
+}
+.preview-pin {
+ line-height: 20px; /* 20 pixel line height is good, only make less if necessary (not more) */
+ font-size: 15px; /* 15 pixel font is good, only make less if necessary (not more) */
+ margin: 0 2px; /* Shouldn't need to edit but here if needed */
+ padding: 0 8px; /* Shouldn't need to edit but here if needed */
+}
\ No newline at end of file
diff --git a/Template/Template-Preview.html b/Template/Template-Preview.html
new file mode 100644
index 0000000..23fc247
--- /dev/null
+++ b/Template/Template-Preview.html
@@ -0,0 +1,50 @@
+
+
+
+
+
LOST PINS
+
+
+
+
GND
+
GND
+
3v3
+
3v3
+
3v3
+
5v
+
5v
+
X
+
+
X
+
X
+
+
+
+
+
+
+
+
+
GND
+
+
+
+
X
+
+
+
+
+
+
+
+
X
+
+
+
+
+
ок
+
diff --git a/Template/Unmade/ESP32-Lolin32_Lite/ESP32-Lolin32_Lite-Board.jpg b/Template/Unmade/ESP32-Lolin32_Lite/ESP32-Lolin32_Lite-Board.jpg
new file mode 100644
index 0000000..f4d8b64
Binary files /dev/null and b/Template/Unmade/ESP32-Lolin32_Lite/ESP32-Lolin32_Lite-Board.jpg differ
diff --git a/Template/Unmade/ESP32-Lolin32_Lite/ESP32-Lolin32_Lite-Preview.png b/Template/Unmade/ESP32-Lolin32_Lite/ESP32-Lolin32_Lite-Preview.png
new file mode 100644
index 0000000..80727df
Binary files /dev/null and b/Template/Unmade/ESP32-Lolin32_Lite/ESP32-Lolin32_Lite-Preview.png differ
diff --git a/Template/Unmade/ESP32-S3-DevKitM-1_44Pin/ESP32-S3-DevKitM-1_44Pin-Board.jpg b/Template/Unmade/ESP32-S3-DevKitM-1_44Pin/ESP32-S3-DevKitM-1_44Pin-Board.jpg
new file mode 100644
index 0000000..5128bd7
Binary files /dev/null and b/Template/Unmade/ESP32-S3-DevKitM-1_44Pin/ESP32-S3-DevKitM-1_44Pin-Board.jpg differ
diff --git a/Template/Unmade/ESP32-S3-DevKitM-1_44Pin/ESP32-S3-DevKitM-1_44Pin-Preview.png b/Template/Unmade/ESP32-S3-DevKitM-1_44Pin/ESP32-S3-DevKitM-1_44Pin-Preview.png
new file mode 100644
index 0000000..90e78b8
Binary files /dev/null and b/Template/Unmade/ESP32-S3-DevKitM-1_44Pin/ESP32-S3-DevKitM-1_44Pin-Preview.png differ
diff --git a/Template/Unmade/ESP32-S3-DevKitM-1_44Pin/EST-ESP32-S3-DevKitPinOut_44PinAlt.webp b/Template/Unmade/ESP32-S3-DevKitM-1_44Pin/EST-ESP32-S3-DevKitPinOut_44PinAlt.webp
new file mode 100644
index 0000000..73ba1e8
Binary files /dev/null and b/Template/Unmade/ESP32-S3-DevKitM-1_44Pin/EST-ESP32-S3-DevKitPinOut_44PinAlt.webp differ
diff --git a/Template/Unmade/ESP32-S3-DevKit_38Pin/ESP32-Lolin32_Lite-Board.png b/Template/Unmade/ESP32-S3-DevKit_38Pin/ESP32-Lolin32_Lite-Board.png
new file mode 100644
index 0000000..5d87dad
Binary files /dev/null and b/Template/Unmade/ESP32-S3-DevKit_38Pin/ESP32-Lolin32_Lite-Board.png differ
diff --git a/Template/Unmade/upscale.media - Sharpen images.url b/Template/Unmade/upscale.media - Sharpen images.url
new file mode 100644
index 0000000..ca8f561
--- /dev/null
+++ b/Template/Unmade/upscale.media - Sharpen images.url
@@ -0,0 +1,2 @@
+[InternetShortcut]
+URL=https://www.upscale.media/tools/sharpen-image
diff --git a/esp32dev.png b/esp32dev.png
new file mode 100644
index 0000000..8027279
Binary files /dev/null and b/esp32dev.png differ
diff --git a/docs/myoptions-generator.html b/generator.html
similarity index 72%
rename from docs/myoptions-generator.html
rename to generator.html
index 8895f71..13de59e 100644
--- a/docs/myoptions-generator.html
+++ b/generator.html
@@ -1,730 +1,66 @@
+
+
ёRadio - simple myoptions.h generator
-
-
+
+
+
-
-
-
-
LOST PINS
-
-
-
-
3v3
-
-
-
-
-
-
-
-
-
-
-
-
-
GND
-
-
X
-
X
-
X
-
5v
-
-
-
-
-
-
GND
-
-
-
X
-
X
-
-
GND
-
-
-
-
-
-
-
-
-
-
X
-
X
-
X
-
-
-
-
ок
-
+
+
+
+
ёRadio - myoptions generator
-
feel difference
+
...share your config...
+
+
+
+
+
-
commandments
-
-
-
Do not use 16-17 GPIOs on WROVER module.
-
Do not pullup the 12th GPIO from the outside.
-
Empty value = error.
-
GPIOs 34 to 39 are GPIs – input only pins. These pins don’t have internal pull-up or pull-down resistors. They can’t be used as outputs, so use these pins only as inputs.
-
Connect display and VS RST-pin to EN ESP32 pin (value -1).
Auxiliary section that allows you to prohibit the appointment of GPIOs 16-17 when choosing ESP32-WROVER module.
+
+
Auxiliary section that allows you to prohibit the appointment of certain GPIOs when choosing the board type.
Values in this section are not included in myoptions.h
@@ -1083,18 +420,22 @@
SD SPI BUS
Depending on the selected display type above, its connection options are displayed here.
-
If you have any questions about choosing VSPI vs HSPI, please read this article or leave the default value of this setting.
+
If you have any questions about choosing VSPI vs HSPI, please read this article or leave the default value of this setting.
+
ESP32-S3 and ESP32-C3 board have only one SPI to choose from, which is HSPI - but do not set DSP_HSPI to true in your config because it will cause compilation errors.
+
If you are using a module to create a configuration, the board definition will set the pins for SCK, MISO, MOSI. You can check your board definition here. Do not use those 3 pins for other purposes.
Parameters added to myoptions.h (default value specified):
SPI Displays
-
+
/* VSPI PINS.
- SCL(SCK, CLK) must be connected to pin 18
- SDA(MOSI, DIN, SDI) must be connected to pin 23 */
-/* HSPI PINS. Set DSP_HSPI to true
- SCL(SCK, CLK) must be connected to pin 14
- SDA(MOSI, DIN, SDI) must be connected to pin 13 */
-#define DSP_HSPI false /* Use HSPI for display */
-#define TFT_CS 5 /* SPI CS pin */
+ SCL(SCK, CLK) must be connected to pin 18
+ SDA(MOSI, DIN, SDI) must be connected to pin 23 */
+/* HSPI PINS. Set DSP_HSPI to true
+/* HSPI PINS.
+ SCL(SCK, CLK) must be connected to pin 14
+ SDA(MOSI, DIN, SDI) must be connected to pin 13 */
+#define DSP_HSPI false /* Use HSPI for display */
+#define DSP_HSPI false /* must be false for ESP32-S3/C3 boards */
+#define TFT_CS 5 /* SPI CS pin */
#define TFT_RST -1 /* SPI RST pin */
#define TFT_DC 4 /* SPI DC/RS pin */
#define BRIGHTNESS_PIN 255 /* BRIGHTNESS Pin */
@@ -1133,20 +474,24 @@
SD SPI BUS
Depending on the selected audio decoder type above, its connection options are displayed here.
-
If you have any questions about choosing VSPI vs HSPI, please read this article or leave the default value of this setting.
+
If you have any questions about choosing VSPI vs HSPI, please read this article or leave the default value of this setting.
+
ESP32-S3 and ESP32-C3 board have only one SPI to choose from, which is HSPI - but do not set DSP_HSPI to true in your config because it will cause compilation errors.
+
If you are using a module to create a configuration, the board definition will set the pins for SCK, MISO, MOSI. You can check your board definition here. Do not use those 3 pins for other purposes.
Parameters added to myoptions.h (default value specified):
VS1053B
-
+
/* VS1053 VSPI PINS.
- VS1053 SCK must be connected to pin 18
- VS1053 MISO must be connected to pin 19
- VS1053 MOSI must be connected to pin 23 */
-/* VS1053 HSPI PINS.
- VS1053 SCK must be connected to pin 14
- VS1053 MISO must be connected to pin 12
- VS1053 MOSI must be connected to pin 13 */
-#define VS_HSPI false /* Use HSPI for VS */
-#define VS1053_CS 255 /* XCS pin */
+ VS1053 SCK must be connected to pin 18
+ VS1053 MISO must be connected to pin 19
+ VS1053 MOSI must be connected to pin 23 */
+/* VS1053 HSPI PINS. Set VS_HSPI to true
+/* VS1053 HSPI PINS.
+ VS1053 SCK must be connected to pin 14
+ VS1053 MISO must be connected to pin 12
+ VS1053 MOSI must be connected to pin 13 */
+#define VS_HSPI false /* Use HSPI for VS */
+#define VS_HSPI false /* must be false for ESP32-S3/C3 boards */
+#define VS1053_CS 255 /* XCS pin */
#define VS1053_DCS 25 /* XDCS pin. */
#define VS1053_DREQ 26 /* DREQ pin. */
#define VS1053_RST -1 /* XRESET pin. */
@@ -1208,21 +553,26 @@
SD SPI BUS
Currently two touchscreen controllers are supported - XPT2046 and GT911
-
If you have any questions about choosing VSPI vs HSPI, please read this article or leave the default value of this setting.
+
If you have any questions about choosing VSPI vs HSPI, please read this article or leave the default value of this setting.
+
ESP32-S3 and ESP32-C3 board have only one SPI to choose from, which is HSPI - but do not set DSP_HSPI to true in your config because it will cause compilation errors.
+
If you are using a module to create a configuration, the board definition will set the pins for SCK, MISO, MOSI. You can check your board definition here. Do not use those 3 pins for other purposes.
Parameters added to myoptions.h (default value specified):
Resistive SPI touch screen (XPT2046)
-
+
/* TS VSPI PINS.
- CLK must be connected to pin 18
- DIN must be connected to pin 23
- DO must be connected to pin 19
+ CLK must be connected to pin 18
+ DIN must be connected to pin 23
+ DO must be connected to pin 19
IRQ - not connected */
-/* TS HSPI PINS.
- CLK must be connected to pin 14
- DIN must be connected to pin 13
- DO must be connected to pin 12
+/* TS HSPI PINS. Set TS_HSPI to true
+/* TS HSPI PINS
+ CLK must be connected to pin 14
+ DIN must be connected to pin 13
+ DO must be connected to pin 12
IRQ - not connected */
-#define TS_CS 255 /* Touch screen CS pin */
+#define TS_HSPI false /* Use HSPI for Touch screen */
+#define TS_HSPI false /* must be false for ESP32-S3/C3 boards */
+#define TS_CS 255 /* Touch screen CS pin */
#define TS_HSPI false /* Use HSPI for Touch screen */
Capacitive I2C touch screen (GT911)
@@ -1238,22 +588,26 @@
SD SPI BUS
-
If you have any questions about choosing VSPI vs HSPI, please read this article or leave the default value of this setting.
+
If you have any questions about choosing VSPI vs HSPI, please read this article or leave the default value of this setting.
+
ESP32-S3 and ESP32-C3 board have only one SPI to choose from, which is HSPI - but do not set DSP_HSPI to true in your config because it will cause compilation errors.
+
If you are using a module to create a configuration, the board definition will set the pins for SCK, MISO, MOSI. You can check your board definition here. Do not use those 3 pins for other purposes.
Parameters added to myoptions.h (default value specified):
-/* MISO is the same as D0, MOSI is the same as D1 */
+/* MISO is the same as D0, MOSI is the same as D1 */
/* SD VSPI PINS.
- SD SCK must be connected to pin 18
- SD MISO must be connected to pin 19
- SD MOSI must be connected to pin 23 */
-/* SD HSPI PINS.
- SD SCK must be connected to pin 14
- SD MISO must be connected to pin 12
- SD MOSI must be connected to pin 13 */
+ SD SCK must be connected to pin 18
+ SD MISO must be connected to pin 19
+ SD MOSI must be connected to pin 23 */
+/* SD HSPI PINS. Set SD_HSPI to true
+/* SD HSPI PINS.
+ SD SCK must be connected to pin 14
+ SD MISO must be connected to pin 12
+ SD MOSI must be connected to pin 13 */
/* SD CUSTOM SPI.
- #define SD_SPIPINS PIN, PIN, PIN /* SCK, MISO, MOSI */
-#define SD_HSPI false
-#define SDC_CS 255 /* SDCARD CS pin */
+#define SD_SPIPINS PIN, PIN, PIN /* SCK, MISO, MOSI */
+#define SD_HSPI false /* Use HSPI for SD Card */
+#define SD_HSPI false /* must be false for ESP32-S3/C3 boards */
+#define SDC_CS 255 /* SDCARD CS pin */
@@ -1269,25 +623,25 @@
SD SPI BUS
Settings for built-in LED, IR receiver and other pins.
Parameters added to myoptions.h (default value specified):
-#define LED_BUILTIN 255 /* Onboard LED Pin */
-#define IR_PIN 255 /* More about IR Receiver */
-#define MUTE_PIN 55 /* MUTE Pin */
-#define WAKE_PIN 255 /* Wake Pin (for manual wakeup from sleep mode) */
-/* can match with BTN_XXXX, ENC_BTNB, ENC2_BTNB. must be one of: 0,2,4,12,13,14,15,25,26,27,32,33,34,35,36,39) */
-#define LIGHT_SENSOR 255 /* Light sensor */
+#define LED_BUILTIN 255 /* Onboard LED Pin */
+#define USE_BUILTIN_LED false /* Cancels Onboard LED Pin */
+#define LED_BUILTIN_S3 255 /* Neopixel RGB LED (must be used with USE_BUILTIN_LED false) */
+#define IR_PIN 255 /* More about IR Receiver */
+#define MUTE_PIN 255 /* MUTE Pin */
+#define WAKE_PIN 255 /* Wake Pin (for manual wakeup from sleep mode) */
+/* can match with BTN_XXXX, ENC_BTNB, ENC2_BTNB. ESP32 must be one of: 0,2,4,12,13,14,15,25,26,27,32,33,34,35,36,39 */
+#define LIGHT_SENSOR 255 /* Light sensor */
Settings currently not processed by the generator (you can specify them manually in the finished file myoptions.h:
Add them only if there is a real need.
Parameters added to myoptions.h (default value specified):
-#define LED_INVERT false /* Invert Onboard LED? */
-#define MUTE_VAL HIGH /* Write this to MUTE_PIN when player is stopped */
-/* Autobacklight function. See options.h for exsample */
-#define AUTOBACKLIGHT(x) *function*
-/* IR_TIMEOUT. See kTimeout description in IRremoteESP8266 exsample */
-#define IR_TIMEOUT 80
+#define LED_INVERT false /* Invert Onboard LED? */
+#define MUTE_VAL HIGH /* Write this to MUTE_PIN when player is stopped */
+/* IR_TIMEOUT. See kTimeout description in IRremoteESP8266 example */
+#define IR_TIMEOUT 80
-#define BTN_LONGPRESS_LOOP_DELAY 200 /* Delay between calling DuringLongPress event */
+#define BTN_LONGPRESS_LOOP_DELAY 200 /* Delay between calling DuringLongPress event */
#define BTN_CLICK_TICKS 300 /* Event Timing https://github.com/mathertel/OneButton#event-timing */
#define BTN_PRESS_TICKS 500 /* Event Timing https://github.com/mathertel/OneButton#event-timing */
@@ -1299,20 +653,212 @@
+This is a dynamic html page that runs in a browser (chrome, firefox, opera) or online. After some actions, using the mouse and keyboard, the output is the configuration file **myoptions.h**, completely ready for use in the project.
+
+[Click here to use the tool!](https://e2002.github.io/docs/myoptions-generator.html)
+
+## Notes
+
+Original Layout and format and coding by e2002 for yoRadio (for ESP32), made dynamic by Trip5 (for ESP32-S3, ESP32-C3, more).
+
+### Features
+
+* Dropdown selector to change boards (includes ESP32, ESP32-S3, ESP32-C3 boards including modules in case no board is appropriate)
+
+* Adds correct MCU type to options export
+
+* Previews of all boards available in selector
+
+* A board pinout now included so you can see which pins are available (click to zoom)
+
+* Dynamic Javascript / HTML so that certain text is shown / hidden according to board or MCU type
+
+* Handles HSPI which is default of ESP32-S3 and ESP32-C3 boards correctly (both for selecting and exporting)
+
+* Adds Neopixel pin and option under LED to use an RGB Neopixel - also exports correctly
-**myoptions.h** file generator for the [ёRadio](https://github.com/e2002/yoradio) project.
-It is a single html file that runs in a browser (chrome, firefox, opera) or online.
-After some actions with which, using the mouse and keyboard, the output is the configuration file **myoptions.h**, completely ready for use in the project.
+* 100% compatible (probably) with current options
-https://e2002.github.io/docs/myoptions-generator.html
+### The to-do list
----
+* Add some more ESP32 and ESP32-S3 and ESP32-C3 boards
diff --git a/Template/ESP32-S3-C3-Modules.pptx b/Template/ESP32-S3-C3-Modules.pptx
new file mode 100644
index 0000000..eb4e3c3
Binary files /dev/null and b/Template/ESP32-S3-C3-Modules.pptx differ
diff --git a/Template/Notes.txt b/Template/Notes.txt
new file mode 100644
index 0000000..c2fcb6b
--- /dev/null
+++ b/Template/Notes.txt
@@ -0,0 +1,11 @@
+You can see the naming scheme by other folders. The folder and file prefixes must match!
+Three files have -Preview as a suffix. They help display the board and pin preview.
+The preview graphic must be a .png file with a transparency layer (256 colors will save disk space).
+The board graphic must be a .jpg file and has -Board as a suffix.
+Finally the -Pins suffix is a javascript file loaded by the main webpage to show which pins are valid and defaults.
+
+I recommend hosting the page locally with the VSCode Studio extension called "Live Preview".
+
+Add your board name to the board-select in myoptions-generator.html and then you can do a live preview.
+Especially with the preview graphic and while checking pins, it is useful to first select your board,
+and click >> link to this configuration << on the bottom so your board loads by default with every edit.
diff --git a/Template/Template-Pins.js b/Template/Template-Pins.js
new file mode 100644
index 0000000..e92b220
--- /dev/null
+++ b/Template/Template-Pins.js
@@ -0,0 +1,18 @@
+// MOSI, MISO, SCK mandatory, SDA & SCL from board profile, LED if exists, recommended pins for some, all others 255
+var defaultValues = {
+ "TFT_DC": 255, "TFT_CS": 255, "TFT_RST": -1, "BRIGHTNESS_PIN": 255,
+ "I2C_SDA": 42, "I2C_SCL": 41,
+ "I2S_DOUT": 255, "I2S_BCLK": 255, "I2S_LRC": 255,
+ "VS1053_CS": 255, "VS1053_DCS": 255, "VS1053_DREQ": 255, "VS1053_RST": -1,
+ "TS_CS": 255, "TS_SDA": 255, "TS_SCL": 255, "TS_INT": 255, "TS_RST": 255,
+ "LED_BUILTIN": 48, "MUTE_PIN": 255, "WAKE_PIN": 255, "LIGHT_SENSOR": 255, "IR_PIN": 255,
+ "ENC_BTNR": 255, "ENC_BTNL": 255, "ENC_BTNB": 255, "ENC2_BTNR": 255, "ENC2_BTNL": 255, "ENC2_BTNB": 255,
+ "BTN_LEFT": 255, "BTN_CENTER": 255, "BTN_RIGHT": 255, "BTN_UP": 255, "BTN_DOWN": 255, "BTN_MODE": 255,
+};
+
+// include all usable pins (including optionally banned pins like 35 to 37 on ESP32-S3 with PSRAM 8MB+) - do not include any with X in the html
+var validGPIOs = [-1, 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 21, 35, 36, 37, 38, 39, 40, 41, 42, 47, 48, 255];
+
+// use 255 if unknown (modules only) // use all -1 if not available (ESP32-S3/C3 use HSPI only)
+var vspiGPIOs = [-1, -1, -1]; // SCK, MISO, MOSI Not available
+var hspiGPIOs = [36, 37, 35]; // SCK, MISO, MOSI
diff --git a/Template/Template-Preview.css b/Template/Template-Preview.css
new file mode 100644
index 0000000..3578558
--- /dev/null
+++ b/Template/Template-Preview.css
@@ -0,0 +1,20 @@
+#preview-pins ul {
+ padding-top: 0px; /* Pushes the lists down */
+ padding-bottom: 0px; /* Pushes the lists up */
+}
+#preview-pins ul li {
+ padding: 0 6px;
+ height: 27.5px; /* Increase/decrease the space between pin names */
+ line-height: 27.5px; /* Keep these 2 numbers the same */
+}
+#preview-pins-center {
+ width: 306px; /* Image width - 400 or less is ideal, 500 is too much */
+ height: 600px; /* resize the Preview image to 600 pixels high */
+ background: #000 url(Template-Preview.png) center center no-repeat; /* You must edit this to match the file name */
+}
+.preview-pin {
+ line-height: 20px; /* 20 pixel line height is good, only make less if necessary (not more) */
+ font-size: 15px; /* 15 pixel font is good, only make less if necessary (not more) */
+ margin: 0 2px; /* Shouldn't need to edit but here if needed */
+ padding: 0 8px; /* Shouldn't need to edit but here if needed */
+}
\ No newline at end of file
diff --git a/Template/Template-Preview.html b/Template/Template-Preview.html
new file mode 100644
index 0000000..23fc247
--- /dev/null
+++ b/Template/Template-Preview.html
@@ -0,0 +1,50 @@
+
+
+