Merge branch 'main' of https://github.com/codingABI/DFR0534

Author: s-light

DFR0534.pdf

@@ -74,7 +74,7 @@ This library is licensed under the terms of the 2-Clause BSD License [Copyright
 For function details see comments in [DFR0534.cpp](src/DFR0534.cpp)
 
 
-### DF0534 pinout
+### DFR0534 pinout
 ![DFR0534](assets/images/DFR0534.jpg)
 
 Minimal schematic to use this library

README.md

@@ -26,22 +26,20 @@ void setup() {
    * - All characters in upper case
    * - maximal 8 characters
    * - Every file and folder whose name length is shorter then 8 chars 
-   *   must be filled up to the 8 chars length by spaces.
+   *   must be filled up to the 8 chars length by space chars
    * - must end with WAV or MP3
    * - Only WAV and MP3 files are supported
-   * - Wildcards 
-   *   * (=multiple arbitrary characters) and 
-   *   ? (=one single arbitrary character) 
-   *   are allowed and can be used to reduce filling spaces.
+   * - Wildcards * (=multiple arbitrary characters) and ? (=one single arbitrary character) 
+   *   are allowed and can be used to reduce the filling space chars
    *
    * Valid examples:
    * - "/01      WAV" for file '/01.wav'
    * - "/99-AFR~1MP3" for a file '/99-Africa.mp3'
-   * - "/SUN*MP3" for first* file matching /sun*.mp3, for example '/sun.mp3'
-   * - "/99-AFR*MP3" for first* file matching '/99-Afr*.mp3'
+   * - "/SUN*MP3" for first file matching /sun*.mp3, for example '/sun.mp3'
+   * - "/99-AFR*MP3" for first file matching '/99-Afr*.mp3'
    * - "/10*" for first* audio file matching /10*.*
    * - "/10      /20      WAV" for the file /10/20.wav
-   * - first* = first in copy order
+   * - first in copy order
    *
    * You can get example files from
    * https://github.com/codingABI/DFR0534/tree/main/assets/exampleContent

examples/playFileByName/playFileByName.ino

@@ -229,13 +229,18 @@ void DFR0534::playNext()
  * in format which looks like a special unix 8+3 format:
  * - Without the dot for the file extension
  * - All characters in upper case
- * - Every file and folder whose length is shorter then 8 chars must be filled up to the 8 chars length by spaces.
+ * - maximal 8 characters
+ * - Every file and folder whose name length is shorter then 8 chars 
+ *   must be filled up to the 8 chars length by space chars
+ * - must end with WAV or MP3
  * - Only WAV and MP3 files are supported
- * Wildcards * (=multiple arbitrary characters) and ? (=one single arbitrary character) are allowed and can be used to reduce filling spaces.
- *
+ * - Wildcards * (=multiple arbitrary characters) and ? (=one single arbitrary character) 
+ *   are allowed and can be used to reduce the filling space chars
+ * 
  * Valid examples:
  * - "/01      WAV" for file 01.wav
  * - "/99-AFR~1MP3" for a file /99-Africa.mp3
+ * - "/SUN*MP3" for first file matching /sun*.mp3, for example '/sun.mp3' (in this order for example: sun0.mp3 sun.mp3 sun1.mp3) 
  * - "/99-AFR*MP3" for first file matching /99-Afr*.mp3
  * - "/10*" for first audio file matching /10*.*
  * - "/10      /20      WAV" for the file /10/20.wav

src/DFR0534.cpp

@@ -19,7 +19,7 @@
 #pragma once
 
 /** Library version */
-#define DFR0534_VERSION "1.0.1"
+#define DFR0534_VERSION "1.0.2"
 
 #include <Arduino.h>
 #include <Stream.h>