Odroid-Go-Radio

Latest updates

20230218

• compatibility issues found with recent ESP32 core 2.0.x. Currently the only workaround is to use core 1.0.6. See a bit more in section Compiling
• The blue onboard-LED can now flicker following the beat of the music. See below.
• Some changes to improve overall robustness.

20220528 You can now use your Odroid-Go-Radio as Bluetooth stream player.

Some bugfixes/changes/improvements...

2021 You can now play stations from genre lists (i. e. Pop, Rock, etc...) that are synchronized using a public radio database server (https://www.radio-browser.info/#/). This database has more than 27,000 stations organised in different categories (by region or genre tags). With this addition, you can download stations from that radio database as given by their genre-tag. As a result you can have more station lists (in addition to the default preset list in NVS) to chose from. By now, that lists are organized by genre tag only. So you can create lists like "Pop", "Rock", etc. but not for instance by country.

The Genre lists will be stored in Flash using LITTLEFS. Therefore, you want to have a SPIFFS partition as big as possible. The Odroid has 16MB Flash, unfortunately the default partitions suggested in Arduino for the Odroid do not make use of those MBs for flash. Workaround (tested) is to set the board "M5Stack-FIRE" and Partition Scheme "Large SPIFFS" in the Arduino Tools-Menu.

Three more libraries are needed compared to the previous release, see Compiling below.

Before using Genre playlists, you must download the playlists from the radio database. See Using Genres below.

I also rebased to the latest version of the ESP32-Radio (see https://github.com/Edzelf/ESP32-Radio).

Some minor improvements include:

• the spectrum analyzer will now show on stations where it did not show in the first release.
• text that is to long for its section (namely radio text and station name) will be cut to fit and not overlap in the next section

In the /pic directory of this repository is a (very) short demo that shows switching from playing a preset from preferences to the genre "disco" (if you do not like the appearance of the spectrum analyzer: do not worry, you can configure the layout and behaviour, up to switching it off completely).

Basic Idea

This is a project to port the ESP32-Radio by Edzelf (see https://github.com/Edzelf/ESP32-Radio) to the Odroid-Go to use the display and the buttons to control the radio.

It also features a very cool 14 channel spectrum analyzer (see Menu3 below). The spectrum analyzer will not work if VS1053 is not connected (i. e. if radio is in demo mode).

For testing, the SW runs in demo mode without a VS1053 module connected. All buttons are fully functional, but there will be no noticable audio output...

It will compile in Arduino-IDE.

Note that this project is going on for quite some time already. I originally branched from Version "Thu, 14 Oct 2018 07:22:32 GMT".

The connection to the VS1053 is done through the Odroid-header pins as follows (schematic to follow):

• Pin 1 to VS1053 GND
• Pin 2 to VS1053 SCK
• Pin 3 to VS1053 CS
• Pin 4 to VS1053 DCS
• Pin 5 to VS1053 DREQ
• Pin 6 not connected (switch pin 3V3 can be used to add a power controller for VS1053, see Limitations below)
• Pin 7 to VS1053 MISO
• Pin 8 to VS1053 MOSI
• Pin 9 not connected
• Pin 10 to VS1053 VCC and Reset

Compiling

• Arduino-IDE v1.8 or later (tested v1.8.5, required at least v1.8.0)

• ESP32-Core (tested v1.0.6) WILL NOT COMPILE/RUN using core v2.0.x or above! You have to explicitely switch back to core v1.0.6 (open menu Tools/Board "xxx"/Boards manager, search for ESP32 and install version 1.0.6 for compiling). Main reason: the integration of LittleFS has changed (was a library before core v2.0.x and is now integrated into the core). At compile time there is no way to identify the current core version to integrate the correct API. As I also had another serious issue with the new core (endless reset loop) I suspect that there might be even more incompatibilities under the hood. Therefore the decision (as of now) was to stick with the older core as it is running fine otherwise.

• Other libraries needed:

  • time.h (Michael Margolis, maintainer Paul Stoffregen, v1.5.0)
  • PubSubClient.h (by Nick O'Leary, v2.7.0)
  • Base64 (by Arturo Guadalupi, v1.0.0) (new for this release)
  • ArduinoJson (by Benoit Blanchon, v6.13.0) (new for this release)
  • LittleFS_esp32 (by lorol v1.0.6)
  • https://github.com/pschatzmann/ESP32-A2DP.git (v1.0.7) for Bluetooth-playpack. It looks like this library is not available from the Arduino library manager. You have to download it to your libraries folder fom github yourself.

• Other versions might work too, its just untested. Please let me know if you encounter any difficulties.

• Select Board "M5Stack-FIRE" and Partition Scheme "Large SPIFFS". In fact, any board definition should be fine, however the ones with PSRAM enabled and a large SPIFFS should be preferred ("ODROID ESP32" as usual will work fine, too with less space for genre playlists in SPIFFS).

• All other settings should be standard (Flash Mode QIO, Partition Scheme Standard, Flash Frequency 80 Mhz, Upload Speed 921600 in my case)

Limitations

• The initial setup (connecting to your WiFi) needs to be done through the WebInterface as usual. Please read the doc https://github.com/Edzelf/ESP32-Radio/blob/master/doc/ESP32-radio.pdf namely section "Configuration". Note that the name and password of the Access Point are changed to "ODROIDRadio". The IP will be the same 192.168.194.1
  • To start, it is sufficient to configure your WiFi credentials.
  • Connect your desktop PC to access point ODROIDRadio (Password ODROIDRadio) and open http://192.168.4.1/config.html
  • Press Button (Default) to load the initial values.
  • Search for the entry wifi_00 = and set the line to wifi_00 = YourSSID/YourPassword
  • Press buttons (Save) and (Restart) and you should be done (Observe screen output to check for success or Serial output for more verbose debug information).
• There are no available pins for attaching functions to. Any settings in the configuration file are ignored.
• Also the pin assignments (for VS1053) are fixed by the limitations of the header pin. Any pin settings in the config file are ignored.
• The most important settings are thus the WiFi credentials in wifi_00 (or wifi_01 etc. if you want WiFiMulti) and the radio presets in preset_00 through preset_99. Some examples are already in the default config.
• The SD slot of the VS1053 cannot be used. The internal SD-card is wired, but I did put no effort whatsoever on the mp3-player. It might work, but can only be controlled through the web-Interface and might interfere with the button and screen-API for the radio.
• The VS1053 board is powered with 5V. Thus USB needs to be connected to the Odroid to supply that 5V through the header pins. You can not power from the battery.
• The connection is done through the header pin on top. In my application I built a "docking station" to connect. Therefore the display is flipped. If buttons "(Left)", "(Right)", "(Up)", "(Down)" are referred later on that will be from that Upside-down perspective as well. The four buttons (Start, Menu etc.) on top of the screen (again, from upside-down perspective) will be referred to as "(1)" to "(4)" (from left to right upside down view).

Possible Startup-Issue

The VS1053 must be powered through USB. At least one of the GPIO header pins is connected to a strapping pin that alters the bootup sequence. Sometimes (that depends: I have tested several combinations of Odroids and VS modules. For some that means always, for others there was no issue at all) the Odroid will not start properly when USB and VS1053 are connected and the Odroid is switched on. The safe sequence is to connected Odroid to VS1053, switch on the Odroid from battery and after this switch on USB power supply (and thus power the VS1053). The timeframe between switching Odroid On and Power Up USB is in the range 0.5 to 4 seconds (roughly).

There is a SW-solution: If you switch the Odroid ON (from Battery, USB not yet powered) press and hold button (A). A screen will show "Release (A) to continue...". If you do so, next prompt will be "Now press (B) to start...". Now you have all the time you need to power USB. After you press (B), startup will commence. That does the trick for me.

I have also a HW-solution involving an ATTINY. Details to follow.

Again, if you get lucky you will not encounter that issue at all.

Normal Operation

Screen layout

The radio screen is mainly similar to the default ESP32-Radio-Screen.

• Top line shows Application name and the current time.
• Middle section shows Radio Text as provided as metadata in stream
• Bottom section (yellow. Original colors look brighter than my pictures taken with mobile) has Station info
• Bottom line shows current "bank" for favorite stations.

Changing Volume

Press/hold (Left) or (Right) to decrease/increase the volume. The current volume setting is shown on button of screen. The range is limited by a configurable Minimum and Maximum.

Changing Station

By favorites

When in normal radio screen, you can press "(1)" to "(4)" to select one of four stations out of the currrent "favorite bank". There are 6 banks in total (A1..A3, B1..B3). You switch between that banks by pressing (A) (sequence will be A1->A2->A3->A1->... on repeated single presses or longpress) or (B) (to switch between B1/B2/B3).

Note that pressing (A) or (B) will not change the station but only the stations assigned to Buttons (1) to (4). That change will happen only if you press either one of (1) to (4). (There are also Menues linked to (1) to (4) which will appear after longpress (>1sec) to a button. The buttons (1) to (4) are a bit fiddely with their haptics, so you might have to practice a bit to apply the right amount of pressure and timing).

If you press (A) or (B) or any of (1) to (4) a popup will show the stations in current bank. This popup will disapear after a (configurable) timeout.

The favorites are linked directly to preset_00 to preset_23 as configured. A1/(1) starts preset_00, A1/(2) preset_01 and so on till B3/(4) for preset_23.

Presets that are not assigned will show as empty line. If selected, the radio will skip to the next available station in the preset list.

By Preset list

By pressing (Up) or (Down) in normal screen, a Preset List will appear that allows to browse through all defined presets. Empty (not defined) presets are not shown in this list (also not the preset number). A station can be started by pressing (Right). The list will be cancelled if (Left) is pressed or after a timeout without any user input.

Using Genres

Loading Genres

Befor using genre playlists, you must download them to the Odroid. The playlists will be stored in the Flash-Filesystem, so you probably want to use a huge SPIFFS partition (see Compiling above. The size of the Flash file system can not be changed at runtime!!)

The genre playlists of the Odroid are maintained using the public radio database server (https://www.radio-browser.info/#/). This database has more than 27,000 stations organised in different categories (by reagion or genre tags). With this addition, you can download stations from that radio database as given by their genre-tag. As a result you can have more station lists (in addition to the default preset list in NVS) to chose from. By now, that lists are organized by genre tag only. So you can create lists like "Pop", "Rock", etc. but not for instance by country.

Downloading the genre playlists will be done from a web-interface. The main reason is that there is quite a lot of data to handle, that is better left to a more powerful desktop computer and not the ESP32.

Javascript must be enabled for the download process. Also, the download process might take some time (depending on the number of stations you plan to download). Make sure the website stays open all the time the download is in process (the progress will be shown on the webpage). If you stop the download (by closing the page) the file system should still be in a valid state, just it might contain less than expected.

Currently there is no explicit error message when the file system is full. The website will pretend to progress just fine. From Serial command line you can run genre=--test to check the available space on the file system.

If something goes wrong, you can use the command genre=--format from Serial command line to format the Filesystem. This will (without further confirmation) erase everything on the filesystem!

If you do not get a connection to the radio database server (a popup should tell so), you can try to use another server (see [below] (#configuring-anything-around-genres) how to change the default setting).

Creating genre playlists

A specific playlist can contain up to 65.534 stations, as long as there is free flash left in the flash file system. Unlike the preset list, the station URLs are not entered direct, but are downloaded from the database above. For maintaining the genre playlist, you need to open the URL http://RADIO-IP/genre.html. The first time you do so you should see the following.

There are two main parts on that page:

• on top (currently empty) is the list of genres that are already loaded into the radio.
• the bottom section is the interface to the internet radio database.

You first should start with the interface to the radio database. In the leftmost input, enter (part) of a genre tag name, e. g. "rock". Enter a minimum number of stations that should be returned for each list (if the number of stations is less than that number, that specific list is not returned). Can be left empty, try 20 for now. If you press "Apply Filter" (ignore the right input field for now) you should see the result of the database request after a few moments:

The result list at the bottom just shows the result of the request, the lists are not yet loaded to the radio. In the dropdown at the right side of the result list you can choose which entries you want to "Load" to the radio. When decided, press the button labelled "HERE" at the bottom of the page. Only then the station lists selected will be loaded into the radio. The website will show the progress:

While you see that page, do not reload the page or load any other page into this tab as otherwise transfer will be cancelled. If you accidentially cancel the tansfer, the radio will still be in a consistent state. Just the list(s) of stations will be truncated/incomplete. After the transfer is completed, the page will automatically reload and should look like this:

More often than not, you will notice that the stations of your interest are distributed over several genre groups on the database. Like in our example "indie rock", "pop rock" and "progressive rock" we just loaded would be an example of "subgenres" for rock.

As you will see later, you can only select one of those genres. You can however cluster the result list from the database into a "Cluster" called "Rock". There is only requirement for the clustername: it must start with a letter. And that first letter will be converted into uppercase automatically. All genre names in the database are returned in always lowercase letters. That way, you can have a cluster called "Rock" that can be distinguished from the "native" genre "rock".

So instead of loading 3 seperate genres, you could chose the Action "Add to:" for the genres of choice. You must enter the desired cluster name ("Rock" in our example) into the input field right of the button "Apply Filter".

Clusters must not be created in one step, you can always add more stations from another database request later. You can however not delete a subgenre from a cluster (but only delete the whole cluster). If you press on the station number of a Cluster in the page section "Maintain loaded Genres" a popup will show which genres from the database are clustered into.

In the maintenance section you can also Delete or Refresh any or all of the genres loaded into the database (a cyclic refresh is needed to throw out station URLS that got nonoperational in between).

If you click on a genre name on the left side in this list, the radio will play a (random) station from that genre. (If you press again, another random station from that list will be played). That is currently the only way to play from a genre using the web-interface.

Some details: Each genre name (either if coming direct from the database or a user defined clustername) must be unique. From the database that is guaranteed. The API does not allow to download the same genre twice. Clusternames are different from loaded genre names because they always start with an uppercase letter. You can use the same cluster name again in further database requests to add more genres into it. You cannot add the same genre twice to the same cluster, but you can add the same genre to more than one cluster. You cannot edit the resulting playlist any further. You can not add single station URLs "by hand", you can not delete a genre from a cluster. You can only delete the full cluster (or a whole genre).

With the default partition the file system is big enough to support (estimate) between 10,000 and 12,000 stations in total. With the "Large SPIFFS" partition I currently (at time of writing) have 26925 stations stored in 192 genres and still have 3.084.288 of the total 7.274.496 bytes of the Filesystem available (roughly 60% used). (From Serial command line, use commands genre=--test and genre=--lsjson to get some insights.)

The final estimate is a bit tricky, as a rule of thumb, the same number of stations will use less space if stored in less genres. So having fewer but bigger (with more stations each) genres is better for filesystem space usage.

The Web interface can hande extended unicode characters. The only thing thats not working currently is if the genre name of the database contains the '/'-character. That I have seen on one genre so far and already forgotten again what it was, so it is currently no priority...

On the Odroid display special Unicode characters can not be displayed properly. As a result, list entries will be shortened (even to zero length) before shown on the Odroid display. However, such entries can be selected correctly nonetheless. The same applies to station names including unicode characters.

Using genre playlists

Selecting from the Odroid API

The radio will always start with playing from the presets. To select a genre, enter the preset list by pressing (Up) or (Down). The preset list opens, allowing to scroll between the presets as usual. While within this list, press (B) and the Genre list will open (if any genres have been loaded). This list can be scrolled using (Up) and (Down) as usual. And as usual, you can cancel the list pressing (LEFT) or select a genre by pressing (Right). In addition you can use (A) to switch back to the preset list.

If a Genre has been selected, the radio will play a random preset from the selected genre. While playing from a genre, the name of the genre and the station number (as well as the total number of stations in the selected genre) are shown at the bottom.

You can change the station with in the genre by selecting the same genre from the genre list again (another random station will play) or use the buttons (1) to (4) to select a station from the current genre. The assignment to (1) and (4) can be changed by pressing (A) or (B). Basically there will always be 4 stations from the current genre available through buttons (1) and (4). If you press (A) you will have 4 different stations assigned (assumend there are at least 8 stations in that genre). If you press (A), there will be for more and so on. If you press (B) you will get back to the 4 stations that have been assigned before and so on. In either (A) or (B) direction the assignemnt will never stop, just wrap around.

You can switch to a different genre by selecting a new genre from the list using (Up) or (Down). Or you can switch back to playing from preferences by pressing (A) while the genre selection list is shown.

Selecting from Serial command line

• use genre=name from command line on Serial monitor to switch to a genre (Unicode characters are fine here, you can copy a genre name from the Web interface). Remember that names are case sensitive. So 'rock' is different from 'Rock'.
• whenever a genre is chosen that way, a new random station will play. The Odroid will update the display and on the bottom line you the number n of stations in that genre as well as the number of the current station (note that this number starts from 0, so the n stations are in fact numbered starting with '0' to 'n-1').
• you can chose a different station from the current genre by using the command gpreset=x, where x should be a number in the range '0' up to 'n-1'.

Configuring anything around genres

The genre settings can be configured using the web-interface (after pressing the "Edit Settings" button at the bottom of the website) or the Serial command interface.

To configure genre settings from Serial command interface, use the command gcfg.subcommand=value

The command can be used from command line or from the preference settings in NVS. If not set in the preferences (NVS) all settings are set to the defaults described below.

The following commands (including subcommands) are defined:

• gcfg.disable=0|1 Disable genre on the Odroid API. Defaults to 0. If set, genre list can not be accessed from the preset list. Does not stop playing from genre station, if genre is already active when set to 1. Genres can also still be played from website or from Serial command interface.

• gcfg.rdbs=hostURL Set the host to RDBS. Defaults to 'de1.api.radio-browser.info' if not set. 'de', 'nl', 'fr' can be used (as short cuts) to address 'de1.api.radio-browser.info', 'nl1.api.radio-browser.info' or 'fr1.api.radio-browser.info' respectively. Otherwise full server name must be given.

• gcfg.showid=0|1 Show the numerical ID of each genre on website. Defaults to 0. The ID shown for each genre can be used to switch to that genre by issuing the command genre=--id n, where n is the respective ID. Can be helpful for long genre names or genre names containing special characters.

• gcfg.verbose=1|0 Show verbose info on Serial. Defaults to 1. Some information about whats going on for debugging.

• gcfg.store Takes no parameter. Stores the current genre configuration settings to NVS so they will be recalled at next start of the radio.

To configure genre settings from the Web-Interface, press the "Edit Settings" button at the bottom of the website http://x.y.i.p/genre.html

It allows for the same settings as from Serial command interface. Pressing "Cancel" will abort and discard any possible changes. "Apply" will apply the current configuration settings as shown in the input fields. "Store to NVS preferences will apply the current configuration settings as shown in the input fields and will also store these settings to NVS for the next start of the radio.

Considerations (and limitations) around using genre playlists

The total number of genre lists is limited (to 1000). This is a compile time limitation that can not be changed by a command or a preference setting.

For faster access, some information is cached. For caching, PSRAM is preferred. If PSRAM is not available, normal heap is used. PSRAM should be plenty, however, if there is no sufficient heap, operation might be slower. (Use command test from the Serial input. If the reported Free Memory is below 100.000, it is likely that RAM caching is not available.)

When in genre play mode, you can not use the preset=n command to play a preset. To go back to the "preset-mode", you must open the Genre List and then press (A) to return to the Preset list.

The genre tags in the database are assigned by the stations self. They might sometimes not match with your expectations (it is possible that a station in genre "disco" plays AC/DC. Which is not bad, but unexpected may be.)

Some stations have multiple tags assigned. Therefore (especially if you create "Cluster playlists") it is possible that the very same station is included more than once in a specific playlist.

The data structure is aligned to support fast switching between stations in playback mode. Downloading however takes some time. You can speed things up (a little) if you stop debug output to serial monitor by entering debug=0 on the Serial command line. And may be stop playback using the command stop.

For reference, I measured the download of all genre lists with at least 50 stations. It took about 25 minutes (with all debug output and playing). As a result, I had 26.570 stations in 190 genre playlists to chose from.

REMEMBER TO KEEP THE WEBSITE OPEN WHILE DOWNLOAD IS IN PROGRESS.

After downloading, the stations should be readily available from the genre list. If not, try turning it off and on again...

And remember, if something goes wrong/looks suspicious, you can always use genre=--format to clean the mess.

MENUs

General

• Menus allow to edit certain parameters of the radio.
• Menus can be reached by a longpress (ca. 1 sec) on (1) to (4) within radio mode. In Bluetooth mode, any press on (1) to (4) will start the corresponding menu direct.
• You scroll through the menu entries using (Up) and (Down).
• The value of the selected entry can be changed using (Left) or (Right).
• Changes need to be stored to NVS to become persistent. Within the menu, use (A) to store updated values to NVS.
• Use (B) to cancel menu without writing the changes to NVS.
• There is a (configurable) timeout that also closes the menu without saving/cancelling.

Menu 1: Settings

• Preset at Start: Select the station to be played at Power On. Can be any preset from A1/(1) to Bx/(4) or LAST to start with last station played (like standard ESP32-Radio implementation)
• Volume at Start: Select the volume at Power On.
• Minimum Volume: Select the lower limit of Volume that can be set by pressing (Left) in playing mode. (Can be 0, but depending on the amplifier/headphones used anything below around 50 is probably not audible at all).
• Maximum Volume: Select the uper limit of Volume can be set by pressing (Right) in playing mode. (Max. 100)
• Life Volume Update: if set to Yes, playing volume will be adjusted to the current value of the menu entry if either of the former 3 Volume entries is the current menu entry. (Can be annoying as this will adjust volume direct if you select any of these entries).
• Brightness Normal: Display backlight setting for normal operation. 255 is maximum, 0 is invisible.
• Brightness Dimmed: after a configurable timeout the display will be dimmed down to this value. Again, this is only for the "Normal mode", if the radio is playing with the default radio screen (no menu/popup shown).
• Brightn run-down (s): in seconds: timeout for no user interaction (key press) the display will stay on full brightness before dimming down to the dimmed level in normal play mode.
• Brightn run-up (ms): if dimmed down, time to ramp up to normal brightness after key press. Can be adjusted in steps of 50 ms from 0 (direct) to 500 msec.
• Timeout Volume popup: how long (secs) will the volume information stay on display after being changed by pressing (Left) or (Right). Valid range*: 0 to 60
• Timeout Menu popup: how long will the menus stay on display without user input (in seconds). Range: 10..32767
• Timeout Channel list: how long will the Channel list stay on the screen without user input before being cancelled. Range: 5..32767
• Timeout Favorites: how long will the contents of the current favorite bank stay on display after a favorite has been selected by a shortpress on (1) to (4) or the bank has been switched by pressing (A) or (B) in normal play mode. (3..32767)
• ChanSelect closes list: If set to "No", the Channel list will stay active after a channel has been selected by pressing (Right).
• Number fav. Banks: how many banks are associated to button (A) and (B). Defaults to 3, which means there is the possibility to select 24 favorites from A1/(1)...B3(4). If you are happy with just 8 stations, you can set this value to 1 (to have the first 8 presets linked to A1(1)..A1/(4), B1/(1)..B1(4). Maximum value is 9 for 72 presets linked to A1/(1) ... B9/(4).
• JoyPad speed: set the speed of the JoyPad buttons to Low, Medium or High. This affects all functions these buttons are linked to (updating volume, updating menu entry, selection from list...)
• Ignore SD-card: if set to Yes, the lengthy search for mp3-files on SD card will be skipped. Suggested setting if you do not plan to use the media-player (as there is currently no support in this version to control the player by Odroid buttons).
• Show debug on Serial: if set to yes, some debug output is shown on Serial. (There is no real reason to set this to No)
• Display flipped: if set to yes, display will show upside down
• Audio at start: can be toggled between Radio (default) and Bluetooth to start either in radio-mode (default) or as Bluetooth player
• Connect last BT-source: if set to yes then in BT mode the last known BT source will be connected if awailable (defaults to no)
• BT volume: can be used to set a different start volume for Bluetooth mode. Defaults to 100
• Reset on Vol-Max/Min: set a timeout (in seconds) after which the radio will reset if the Vol-Up or Vol-Dn button are still pressed even though if already at the maximum (Vol-Up) or minimum (Vol-Dn) volume level. Reset will toggle to the other audio-mode (from Bluetooth to Radio or vice versa). If set to 0 (default) the reset will be disabled.
• For information purposes, the current IP is shown at the end of the menu list (only in radio-Mode, in BT-mode WiFi is not available).

Menu 2: Preset list

• Shows all defined presets (from preset_00 to preset_99)
• Is station is mapped to a favorite button, it is labelled Ax/1..4 or Bx/1..4 accordingly. Otherwise its number (up to 99) is shown in addition to the station name.
• If a preset is not defined, an empty string will be displayed (so there are always 100 entries in this list).
• This menu allows to change the order of the preset.
• Select the preset you want to change in position. Press (Right). Now that station is locked and will follow if you press (Up) or (Down). As long as the entry is locked, the word "MOVE" will be displayed at the right side of that entry.
• You can release the locked entry by pressing (Left).
• During the move, the position indicator is updated accordingly. That allows to conveniently re-organize the favorite banks.
• You have to confirm the changes by pressing (A). This change requires a restart of the radio (will be prompted on screen).

(You can not enter new stations here. That needs to be done through the configuration webpage as usual.)

Menu 3: Spectrum analyzer

• Show Spectrum Analyzer: if switched to yes, a 14 (sometimes 12) channel spectrum analyzer will be shown in the radiotext section.
• Analyzer Speed: defines the update speed of the analyzer from "Disco" (very fast) to "Slug" (about 2 frames per second).
• Dynamic Brightness: if set to "yes", the brightness of channel bars is altered by its value (the higher the brighter a bar will appear).
• Show Peaks: show additional peak indicator on top of the channel bar.
• Bar width: the width of channel bars (from 0 to 20). Bars are always shown equidistant (20 points away from each other). Smaller bars will have spacing in between.
• Bar color: set the color of channel bars.
• Peak width: the width of the peak indicator (from 0 to 20 or set to "same" to follow the width of the channel bar.
• Segment Divider width: divides the channel bar in equal segments. Width can be 0 (means no divider) up to 20 or "same" to follow the channel bar width.
• Segm.Divider color: color of segment divider.
• Show Radiotext: Show radiotext in addition to spectrum analyzer.
• Disable Text refresh: Often the radiotext is just two lines or less on the display and usally will not interfere with the spectrum analyzer that stays below normally. However with high peaks or lengthy text, the text might get (partly) erased by the analyzer. Therefore the text will be refreshed twice a second, unless this parameter here is set to yes (then it will only be refreshed once updated by the source host).
• Blue LED: controls the behaviour of the blue onboard-LED (see below for details).

Just play around with the settings to adjust to your liking. Note that any change in the menu will be applied directly. If you find the settings to your liking, remember to press (A) to store the settings for next Power On. With few stations the equalizer will not work (reproducible). I have not yet found the reason for that issue.

Blue LED

The menu item "Blue LED" of the spectrum analyzer menu defines the behaviour of the blue onboard-LED:

• off: the LED will stay off (this is the default setting).
• beat: the blue LED will always flicker to the beat of the music.
• if Spectrum: the blue LED will flicker, but only if the spectrum analyzer is enabled.
• if NOT Spectr.: the blue LED will flicker, if the spectrum analyzer is NOT enabled.
• if Sp. hidden: the blue LED will flicker, if the spectrum analyzer is enabled but currently hidden (by a menu for instance).
• if NOT hidden: LED will flicker, if the spectrum analyzer is enabled and currently visible (i. e. not hidden by another screen).
• always ON: LED is always lit at full brightness (independent of sound level).

The brightness is not influenced by the current volume setting. The update rate is always the same, no matter what the current speed setting of the spectrum analyzer is.

Menu 4: Sleep timer

• Sleep time: from now on in this many minutes the volume will dim to minimum value (and then to 0)
• Start volume: from now on this volume will will be ramped down to minimum/0 in the remaining time
• Dark after 1 min: if set to yes, the display will be switched off completely after 1 minute (otherwise it will just dim down to brightness 1, which is still pretty dark).
• This menu will stay on until cancelled by pressing (B), which cancels the sleep function alltogether.
• Pressing (A) will write the current settings as default values. Note that over time the values for sleep time and volume will adjust according to the elapsed time.

Using Bluetooth

Preconditions

• You need to install one additional library (pschatzmann/ESP32-ADP) before compiling. It looks like this library is not available from the Arduino library manager. You have to download it to your libraries folder fom github (https://github.com/pschatzmann/ESP32-A2DP.git) yourself.
• I suggest to use the Board setting "M5Stack-FIRE" and Partition Scheme "Large SPIFFS" for compilation.

Limitations

• You can not start BT and WiFi at the same time. You have to decide (at startup) wether you want to use BT or Radio functionality.
• You can also not switch from one mode to another without a reset (SW or PowerOn).

Entering Bluetooth playback

• The default mode at startup can be defined using Menu 1 There are a few more entries now in this menu:
  • Audio at start: can be toggled between Radio (default) and Bluetooth
  • Connect last BT-source: if set to yes then in BT mode the last known BT source will be connected if available (defaults to no)
  • BT volume: can be used to set a different start volume for Bluetooth mode. Defaults to 100
  • Reset on Vol-Max/Min: sets a timeout (in seconds) after which the radio will do a SW-reset if the Vol-Up or Vol-Dn button are still pressed even though if already at the maximum (Vol-Up) or minimum (Vol-Dn) volume level. Reset will toggle to the other audio-mode (from Bluetooth to Radio or vice versa). If set to 0 (default) this SW-reset will be disabled.
• At startup time, you can press Button (B) to switch to the other mode, i. e. if radio is defined in the configuration settings, you can start Bluetooth mode (and vice versa). Please observe the screen, the first line at start should now read Starting Radio or Starting Bluetooth. If you see this line, you can release button (B) again (roundabout after less than one second).
• A SW-reset (as described above with Vol-Up/Vol-Dn) will override the Audio at start-setting (and consequently also ignore the state of button (B))
• If the VS1053 module could not be initialized correctly (either not at all or only at slow SPI speed which is insufficient for the BT data stream) the BT-mode will be ignored and the Odroid will start in Radio-mode.

The following will apply if the radio successfully started in Bluetooth mode:

• The screen has four segments. The top line shows the word "Bluetooth" instead on the right (clock is dependend on WiFi hence not available in BT-Mode). The big second segment will show title info and spectrum analyzer (if enabled in Menu 3) and BT is playing. The third segment will show the current Bluetooth-connection status and the bottom line will show the current volume.
• There is no button functionality to control the BT audio source from the Odroid. You can only change the volume (but this will change the volume of the OdroidRadio and not affect the volume setting of the BT-source)
• As there is no favorite to play after a shortpress on any of (1) to (4) there is no need to differentiate a shortpress or longpress on (1) to (4) in BT mode. Therefore the associated menu is started direct as a result of pressing either (1) to (4).