Config.txt File

Introduction

Radios have a configuration file, which is named ConfigXXXX.txt, where XXXX is the hardware number of the radio, which you can find with 'Configure / Version'. For example, an IR-100 is 1012. The Radios page has known hardware numbers.

The configuration file can be changed to enable/disable certain features. Some of these may add a feature a particular user finds useful. For example, those using the alarm clock may prefer it to be higher in the menu structure, or the history feature might be useful to get back to a recent stream.

In addition to enabling / disabling features, the configuration file also tells the radio which software modules to load. These include network drivers, lcd display drivers etc... If you change these entries, it is possible that your radio will be unable to boot / unable to start the network / unable to display things on the lcd display. please DO NOT simply copy another config.txt file over the top of yours, hoping that your radio will take on the features of another manufacturers - the answer is that it will, including trying to load the wrong drivers

Process to edit configuration file

Even with the old firmwares, there are many features of radios which are disabled. to enable these features, you may not even have to upgrade the firmware, but you will have to be familiar with Linux Command Line and the editor 'vi'.

• Apply the sharpfin patch, see Enabling Login
• Log into the radio using telnet (user & password = admin)
• Look in('chdir /root/hwconfig/') /root or /root/hwconfig, depending on the current firmware version of your radio
• Find your configxxxx.txt file (The xxxx is the Hardware Id, which you can find in 'Configure / Version')
• Look in it and others in the same directory to work out what modifications you wish to make (such as enabling alarms)
• Issue the command 'mount / -orw,remount' to unprotect the partition
• Edit the configxxxx.txt file with 'vi configxxxx.txt'
• ':i<ENTER>' to enter Insert mode
• Double Check your edits
• Now treble check them!
• Hit <ESC> to leave Insert Mode and enter Command mode
• ':w<ENTER>' To write current file (if you are sure and wish to save it)
• ':q!<ENTER>' To exit 'vi'
• Write protect the drive with 'sync;mount / -oro,remount'
• Reboot the radio

Comments on the Config.txt file

Simbo has provided a list of all the Configuration Variables on his User talk:Simbo99 page

Space for commented config.txt file (can others add information as it is known and relevant comments please )

Confirmed edits to /root/hwconfig/config1012.txt on a Logik IR-100:

Option:
stations-history
on

Option:
history-size
20

...shows the last 20 streams listened to. History info gets stored in: /root/config/PRE_history.ini, and persists after a power cycle.

Option:
standby-text
*** Simbo ***

...replaces the 'Reciva Radio' text in standby. Use of UTF-8 encoded text in the private which is defined as special symbols in the reciva LCD driver (published by reciva as part of the GPL kernel source) is known to brick the radio. Other non-ASCII text may also have this effect, and there may be a length limit, so you should have a backup strategy before venturing beyond simple short ASCII sequences.

I have taken the standby text to 13 characters including spaces, which is one more than standard and it is OK. (M0AUR)

Option:
clock-in-config-menu
on

...adds Clock in Configure. - Did not appear when used with Firmware v. 257-a-421-a-057

Option:
clock-dst-menu
on

...adds DST(„Daylight Saving Time“) On/Off to Clock menu.

Option:
clock-format-menu
on

...lets you change from 24hr to AM/PM - Clock will default to 24hr if there is an active alarm.

Option:
stereo-mode
stereo

Option:
stereo-mode-menu
on

...this adds a Stereo menu in Configure with Stereo/Mono options.

Option:
aux-menu
on

...this adds the menu option Equalisation under Configure & with Treble -14/+14 and Bass -14/+14 - it did nothing to the treble/bass on an IR-100 & IPdio (962).

Option:
contrast-menu
on

...adds the menu option Contrast under Configure & counts up/down with the wheel, doesn't alter the contrast on an IR-100.

Option:
volume-control
on

Option:
initial-volume
28

...whilst listening to a stream, the wheel alters the volume with an on-screen graphic to indicate min/max Volume. Not much use on an IR-100 - which has the audio-amp volume knob. - Easiest to use with 'official' volume control at maximum and use select knob only - NOTE: This leads to a slightly audible background crackle even at low volumes.

I believe the 'initial-volume' refers to the volume of the alarm, changing the value does not appear to have any effect on an IR100 with 257-a-421-a-057 FW.

( Please edit / add more configuration options as known )

From "grepping" through the configxxx.txt

Option:
alarm-clock
off|config1|config2|no-alarm

off: no clock at all, no-alarm: just a clock, no alarm. config1&config2: alarm clock functionality enabled, difference between settings not yet known. 'config1' = alarm goes straight to radio without buzzer (IR100 257-a-421-a-057)

Option:
number-of-alarms
5

This allows you to set multiple alarms and choose weekdays, weekends etc and whether to use the buzzer or a preset - NOTE - Any selected preset must remain tuned to the same channel for the alarm to continue to tune to radio - NOTE - All alarms start with a buzzer, which sounds for 20-30 secs and then tunes to a chosen station, which as to be selected from the 5 presets - Can be switched at will by pressing the Select knob. Buzzer can be disabled by using the alarm clock/config2 hack above.

Option:
power-on-select-key
on

This allows a select spinner press to turn the radio on

Option:
menu-timeout
10

This controls how long a menu is shown before dropping back to the now playing screen

Option:
back-as-menu-item
on

Adds a <<Back option to every menu

Option:
presets-as-menu-items
on

This shows all your presets in "My stuff" list

Option:
off-in-main-menu
on

This shows an off option at the bottom of the main menu

Option:
long-select-action
popup

This enables an equalizer menu accessed with a long press of the Select button - Note this is visible but completely non functional on the IR100.

 Option:
 snooze-key
 power

This option produces a 5min snooze on the alarm when you press the power key, I guess it could be mapped elsewhere, the alarm time shown in brackets advances 5 mins to confirm,

IR100 - FW v.257-a-421-a-057 - This works, but makes switching off by the power button rather difficult - the radio seems confused as to what it is supposed to do, press once and sound will break up for about 30secs before powering down.

I also detected a change in the level (up) of the transformer hum while trying this one.

 Option:
 force-metadata
 on

Depending on the station/stream etc, you get track and artist information as a scrolling line - directly after the "REAL ENABLED" it will read something like "REAL ENABLED - xxxx artist - xxx track" This is totally dependent on the stream/podcast station and what they decide to transmit.

Option:
show-busy-bar-on-samba-scan
on

Shows a progress bar as samba scans a share for media.

Option:
acpoweron-state
network

...on AC power on, radio connects to network then goes to standby, staying connected to network. Only works if "Go to standby after power cycle" under 'My Radios' on the Reciva site is *unticked*.

Option:
dynamic-mute
off

...(Can someone else try this & confirm then delete/edit this text - taa Simbo99) Keeps the audio amp powered on, so doesn't chop first few seconds of MP3s. Makes Modifying time delay when starting a track redundant?

Cannot comment on mp3s from PC, but it does look like it works! I logged onto an MP3 stream which plays a set file (beatlesradio.com) before you get the stream and for the first time, had the whole thing! (Tried on two IR100s with 257-a-421-a-057 FW.)

Changes to /root/hwconfig/all_radios.txt

Most if not all models seem to refer to this file in their main config, so it's contents are presumably referenced as if they were in the main configxxx.txt

Option:
reply-button-function
on

Pressing the reply button when tuned to a stream calls up an add to favourites menu, which adds the stream to 'My Stations' on the radio and your Reciva account.

It may work if you place it in the main configxxx.txt for your radio, but I have not tested it.

Tested on a IR100 with v.257-a-421-a-057 firmware, the text was already there, I just had to change the instruction from 'off' to 'on'

The only radio I know of with this feature as standard is the Tangent Quattro with up to date firmware.

Suggested combinations for various radios

The following known to work well and provide sensible User Interface benefits to Radio owners:

IR 100 with firmware 257-a-421-a-057 (Can someone enter a set of sensible suggestions ?) Max: clock-dst-menu:on | back-as-menu-item:on | number-of-alarms:5 | alarm-clock:config1 | back-as-menu-item: on

"number-of-alarms" is very useful

Further notes and observations

This thread on the Reciva website has a few clues ( which may now all be explained above ).

Here is a screen shot from a display with changes to the configXXXX.txt file http://sharpfin.zevv.nl/images/1/14/LCD-menu.jpg