2026.07.11

Author: trip5

Hardware.md

@@ -305,26 +305,26 @@ for additional noise filtering.
 
 | Part                           | Qty | Purpose                                              | Alternatives |
 | ------------------------------ | --- | ---------------------------------------------------- | ------------ |
-| ESP32-S3-DevKitC-1 N16R8       | 1   | Main microcontroller with PSRAM                      | Any ESP32-S3 with 2MB+ PSRAM |
+| ESP32-S3-DevKitC-1 N16R8       | 1   | Main microcontroller with 16MB flash and 8MB PSRAM   | Any ESP32-S3 with minimum 8MB flash and 2MB PSRAM |
 | RS-15-5 (MEAN WELL)            | 1   | 5V 15W AC-DC power supply                            | USB-C PD trigger board (5V), any regulated 5V 3A+ supply |
-| F0505S-3WR2 (MORNSUN)          | 1   | Isolated 5V→5V DC-DC converter for digital isolation | B0505S-1WR2 (1W, lighter loads), CRE1S0505SC |
-| PLY17BN9612R0B2B               | 5   | KEMET PLY17 CM choke; EMI filter, one per power domain | ? |
+| F0505S-3WR2 (MORNSUN)          | 1   | Isolated 5V→5V DC-DC (3W, 600mA); ultra-low 20pF isolation capacitance for clean analog/digital separation | Requires ≥3W for ESP32-S3; cheaper converters lack both power and low isolation capacitance |
+| PLY17BN9612R0B2B               | 5   | Murata hybrid CM+DM choke (0.96mH CM, 47μH DM); filters common-mode and differential noise | Standard CM choke ≥2A, 0.5–2mH (e.g., Bourns 8111-RC); or separate CM choke + DM inductor |
 | LTK5128                        | 2   | Class AB 3W audio amplifier (Left + Right)           | PAM8406 (Class D, 5W), PAM8403 (3W), MAX98357A (I2S, 3W) |
-| LD06AJSA                       | 1   | LED constant-current driver / power indicator        | 220Ω resistor + LED (simpler), any 20mA LED driver |
+| LD06AJSA                       | 1   | LED constant-current driver; supports LED filaments for encoder illumination | 220Ω resistor + LED (simpler), any 20mA LED driver |
 | RCH664NP-100M                  | 1   | 100μH shielded power inductor for DC-DC filtering    | Any 100μH 1A+ shielded inductor |
 | EI14 600:600Ω                  | 1   | 1:1 audio isolation transformer (line-level)         | Any 600:600Ω audio transformer, 10μF DC blocking caps |
 | EC11                           | 1   | Rotary encoder (15 pulse/30 detent) with push switch | KY-040, PEC11, any quadrature encoder with switch |
 | VS1838B                        | 1   | 38kHz IR receiver                                    | TSOP38238, TSOP4838, TSOP31238 |
 | SD Card module                 | 1   | SPI microSD card reader for offline playback         | Built-in display SD slot (check for proper resistors!) |
-| XRR6H-6*10-3T                  | 5+  | 6-pin 2.54mm locking header connectors               | Standard 2.54mm Dupont headers, JST XH2.54 6-pin |
+| XRR6H-6*10-3T                  | 7   | 6-hole ferrite bead (6×10mm, 3-turn); EMI suppression on signal/power lines | Any 6-hole ferrite bead (6×10mm), clip-on ferrite choke, toroidal ferrite core |
 
 #### Capacitors & Resistors
 
 | Component                 | PCM5102 | VS1053 | Where Used                          | Notes |
 | ------------------------- | :-----: | :----: | ----------------------------------- | ----- |
-| 2200 μF 25V electrolytic  |    1    |   1    | Audio rail bulk decoupling          | Low ESR recommended |
-| 1000 μF 16V electrolytic  |    2    |   2    | Amp L+R power, PSU input            | Low ESR recommended |
-| 470 μF 16V electrolytic   |    3    |   3    | Digital rail, Display, LED power    |       |
+| 2200 μF 25V electrolytic  |    1    |   1    | Audio rail bulk decoupling          | Must use Low ESR |
+| 1000 μF 16V electrolytic  |    2    |   2    | Amp L+R power, PSU input            | Must use Low ESR |
+| 470 μF 16V electrolytic   |    3    |   3    | Digital rail, Display, LED power    | Should use Low ESR |
 | 100 μF 16V electrolytic   |    2    |   2    | LED driver, SD card                 |       |
 | 47 μF 10V electrolytic    |    2    |   2    | Digital rail, IR receiver           |       |
 | 10 μF 10V electrolytic    |    1    |   1    | DC-DC output filtering              |       |
@@ -333,6 +333,9 @@ for additional noise filtering.
 | 33 Ω resistor (1/4W)      |    6    |   6    | SPI bus damping resistors           | On MOSI, SCLK, MISO, CS, DC lines |
 | 100 Ω resistor (1/4W)     |    2    |   5    | IR receiver, VS1053 control lines   |       |
 
+Kle7rx recommends using Low ESR for all electrolytic capacitors.
+It is also recommended to use metal film resistors but carbon film resistors are acceptable.
+
 #### PCM5102 Build — Additional Parts
 
 | Part        | Qty | Purpose                        | Alternatives |

README.md

@@ -283,6 +283,7 @@ For that and other major needed changes to the codebase, there is a `code-issues
 
 | Date       | Release Notes    |
 | ---------- | ---------------- |
+| 2026.07.11 | `not a release` minor fixes to PSRAM handling, documentation |
 | 2026.07.10 | SD Offline Mode added, `Hardware.md` added, Fixes to Deep Sleep, smart start, SD index, VS1053 volume curve |
 | 2026.07.05 | More fixes to VS1053, Wake from Deep Sleep now works on all RTC-capable pins |
 | 2026.07.01 | 🍁 Minor fixes: WebUI, Display, Locales, VS1053 patch, smart start (last station plays after OTA/flash upgrade) |
@@ -316,6 +317,7 @@ A full history of ёRadio from v0.4.177 to v0.9.533 can be seen in the [old Read
 ### Credit
 
 Thanks to:
+
   - [kle7rx](https://github.com/kle7rx) - `ru_RU` translation, debugging, VS1053, and amplifier schematics
   - [Kasperaitis](https://github.com/kasperaitis) - `lt_LT` translation, initiating locales (WebUI and display language) and a bunch of work for ES3C28P (including ES8311 decoder, ILI9341 battery widget, FT6336 touchscreen)
   - [e2002](https://github.com/e2002) - for [ёRadio](https://github.com/e2002/yoradio/) without which ehRadio would not be possible

src/core/config.cpp

@@ -71,7 +71,7 @@ bool Config::_wwwFilesExist() {
 
 void Config::init() {
   loadPreferences();
-  if (!config.store.lastBootGood) delay(1000);  // Allow serial monitor to connect before logging safe mode
+  if (!config.store.lastBootGood) delay(1000);  // Allow serial monitor to connect before logging in Safe mode
   bootInfo();
   #if RTCSUPPORTED
     BOOTLOG("RTC begin(SDA=%d,SCL=%d)", RTC_SDA, RTC_SCL);

src/core/options.h

@@ -300,6 +300,21 @@ Use this tool to setup connections:
 /* If using PRETEXT_ALLCAPS, why not do the same to your WebUI? */
 // #define WWW_CASETRANSFORM
 
+/* Other Transforms */
+// Frankly speaking, most of these go beyond regular display transforms.
+// They may hide the option in the WebUI completely.
+// It is not recommended to build without these options but here they are anyways.
+//#define HIDE_TITLE2
+//#define DSP_INVERT_TITLE
+//#define HIDE_VU
+//#define HIDE_VOLBAR
+//#define HIDE_BUFFERBAR
+//#define HIDE_VOL
+//#define HIDE_IP
+//#define HIDE_RSSI
+//#define HIDE_BATTERY
+//#define HIDE_WEATHER
+
 
 /* ============================== SPI BUSES AND PINS ============================== */
 
@@ -854,30 +869,23 @@ Use this tool to setup connections:
   #define USE_FBUFFER true // framebuffer: best to leave this on (will use PSRAM if available and SRAM if not)
 #endif
 
-// PSRAM Audio Buffer
-// WebUI files cache: (up to) 300KB + Decoder Output: 52KB + Display framebuffer (480×320): 74KB = 426KB... leaves 598KB free in 1MB or 1598 free in 2MB
-// To be fair, in real-world use, above 300KB may be excessive...
-#ifndef PSRAM_BUFSIZE
-  #if defined(ARDUINO_ESP32_DEV)
-    #define PSRAM_BUFSIZE 550
-  #else
-    #define PSRAM_BUFSIZE 1500
-  #endif
-#endif
+// PSRAM Buffers (highest-case estimates, in allocation order: display.init() → player.init() → netserver.begin())
+//   Display framebuffer (480×320): ~74 KB  (allocated first, display.init())
+//   VS1053 audio buffer:          ~293 KB  (300000 bytes, player.init())
+//   I2S audio buffer:             ~640 KB  (UINT16_MAX * 10, player.init())
+//   WebUI files cache:       up to 300 KB  (actually ~60KB if using .gz files, allocated last, netserver.begin(); dynamic, falls back to SPIFFS)
+// ---------------------------------------
+//   VS1053 total:                 ~667 KB  or ~427KB with .gz WebUI files
+//   I2S total:                   ~1014 KB  or ~774KB with .gz WebUI files
+// Note: WebUI cache is opportunistic so if PSRAM runs low, files stay in SPIFFS instead.
+
 // Since the audio buffer can never technically fill up (most streams prevent reading-ahead excessively),
 // the visual buffer bar should look "full" when the buffer is near to maximum potential (250KB is ~6 seconds at 320kbps)
+// there is no 
 #ifndef BUFFERBAR_VISUAL_FULL_KB
   #define BUFFERBAR_VISUAL_FULL_KB 250
 #endif
-#if BUFFERBAR_VISUAL_FULL_KB < 16 || BUFFERBAR_VISUAL_FULL_KB > 500
-  #warning BUFFERBAR_VISUAL_FULL_KB is outside 16 to 500 range, using default of 250KB
-  #undef BUFFERBAR_VISUAL_FULL_KB
-  #define BUFFERBAR_VISUAL_FULL_KB 250
-#endif
-#if PSRAM_BUFSIZE < BUFFERBAR_VISUAL_FULL_KB
-  #undef BUFFERBAR_VISUAL_FULL_KB
-  #define BUFFERBAR_VISUAL_FULL_KB (PSRAM_BUFSIZE)
-#endif
+
 
 /* --- CPU CORES --- */
 /* ESP32 and ESP32-S3 have 2 cores (Main loop runs on Core 1). ESP32-C3 has 1 core (Main loop runs on Core 0) .*/

src/core/sdmanager.cpp

@@ -134,7 +134,8 @@ void SDManager::listSD(File &plSDfile, File &plSDindex, const char* dirname, uin
       }
     } else {
       if (_endsWith(strlwr((char*)fn), ".mp3") || _endsWith(fn, ".m4a") || _endsWith(fn, ".aac") ||
-          _endsWith(fn, ".wav") || _endsWith(fn, ".flac")) {
+          _endsWith(fn, ".wav") || _endsWith(fn, ".flac") || _endsWith(fn, ".ogg") ||
+          _endsWith(fn, ".opus")) {
         pos = plSDfile.position();
         plSDfile.print(fn);
         plSDfile.print('\t');
@@ -212,7 +213,8 @@ uint32_t SDManager::_countAudioFilesRecursive(const char* dirname, uint8_t level
       }
     } else {
       if (_endsWith(strlwr((char*)fn), ".mp3") || _endsWith(fn, ".m4a") || _endsWith(fn, ".aac") ||
-          _endsWith(fn, ".wav") || _endsWith(fn, ".flac")) {
+          _endsWith(fn, ".wav") || _endsWith(fn, ".flac") || _endsWith(fn, ".ogg") ||
+          _endsWith(fn, ".opus")) {
         _sdFCount++;
       }
     }

src/libraries/I2S_Audio (ehRadio Maleksm v0.9.434m(04.04.25))/Audio.h

@@ -134,7 +134,7 @@ class AudioBuffer {
     bool     havePSRAM() { return m_f_psram; };
 
 protected:
-    size_t            m_buffSizePSRAM    = 1024 * PSRAM_BUFSIZE;
+    size_t            m_buffSizePSRAM    = UINT16_MAX * 10;   // most webstreams limit (65535 * 10)
     size_t            m_buffSizeRAM      = 1600 * AUDIOBUFFER_MULTIPLIER2;
     size_t            m_buffSize         = 0;
     size_t            m_freeSpace        = 0;

src/libraries/I2S_Audio/Audio.h

@@ -134,7 +134,7 @@ class AudioBuffer {
     bool     havePSRAM() { return m_f_psram; };
 
 protected:
-    size_t            m_buffSizePSRAM    = 1024 * PSRAM_BUFSIZE;
+    size_t            m_buffSizePSRAM    = UINT16_MAX * 10;   // most webstreams limit (65535 * 10)
     size_t            m_buffSizeRAM      = 1600 * AUDIOBUFFER_MULTIPLIER2;
     size_t            m_buffSize         = 0;
     size_t            m_freeSpace        = 0;

src/libraries/VS1053_Audio (ehRadio Maleksm v0.9.434m(04.04.25))/audioVS1053Ex.h

@@ -153,7 +153,7 @@ class AudioBuffer {
 
 protected:
 //    size_t m_buffSizePSRAM    = 327675;   // most webstreams limit the advance to 100...300Kbytes
-    size_t m_buffSizePSRAM    = 1024 * PSRAM_BUFSIZE;
+    size_t m_buffSizePSRAM    = 300000;   // most webstreams limit the advance to 100...300Kbytes
     size_t m_buffSizeRAM      = 1600 * AUDIOBUFFER_MULTIPLIER2;
     size_t       m_buffSize         = 0;
     size_t       m_freeSpace        = 0;

src/libraries/i2s-frankenstein-surgery-notes.md

@@ -103,8 +103,6 @@ void Audio::performAudioTask() {
 - No fallback to SRAM in v0.9.720m
 - `psram_unique_ptr.hpp` provides the allocation framework
 - `audiolib_structs.hpp` depends on it
-- **options.h adjustment needed**: PSRAM_BUFSIZE may need reduction to fit within 2MB (user's note)
-- Around `options.h` line 862: check PSRAM Audio Buffer section
 
 ### 5. Task / Core Assignment
 - `m_audioTaskCoreId = 1` (default)
@@ -160,7 +158,7 @@ Additionally, v0.9.720 I2S is a prerequisite for the v0.9.720 VS1053 library —
    - Add `#include "../../core/config.h"` if needed
    - Wire `m_audioTaskCoreId` to `AUDIO_CORE` from options.h
    - Add "Some adjustments by Trip5 for ehRadio" to header
-3. **Verify PSRAM macros**: Check `PSRAM_BUFSIZE`/`PSRAM_RES_BUFSIZE` work with `psram_unique_ptr.hpp`
+3. **Verify PSRAM allocation**: Ensure `psram_unique_ptr.hpp` allocates correctly
 4. **Build and test**: All I2S environments. Verify audio playback, VU meter, volume control.
 5. **If Stage 1 works**: PSRAM framework confirmed. Proceed to Stage 2.
 6. **If Stage 1 fails**: Problem is in PSRAM or decoder file changes. Fix before proceeding.

src/main.cpp

@@ -152,16 +152,13 @@ void loop() {
         if (psramFound()) {
           size_t psramTotal = ESP.getPsramSize();
           size_t psramUsed  = psramTotal - ESP.getFreePsram();
-          size_t known      = (1024 * PSRAM_BUFSIZE) + netserver.getFileCache().totalBytes() + psramFrameBufferBytes;
           size_t audioFill  = player.inBufferFilled();
-          FUNCTIONLOG("PSRAM", "Allocated: %uKB / %uKB total: Framebuffer: %uKB, WebUI Cache: %uKB, Other: %uKB, Audio: buffered %uKB / %uKB allocated",
+          FUNCTIONLOG("PSRAM", "Allocated: %uKB / %uKB total: Framebuffer: %uKB, WebUI Cache: %uKB, Audio buffered: %uKB",
               psramUsed / 1024,
               psramTotal / 1024,
               psramFrameBufferBytes / 1024,
               netserver.getFileCache().totalBytes() / 1024,
-              (psramUsed > known ? (psramUsed - known) / 1024 : 0),
-              audioFill / 1024,
-              PSRAM_BUFSIZE);
+              audioFill / 1024);
         }
       }
       cmLastPrint = millis();