Katoomba Sound - Speaker Switch Owners Manual (SPKR7)


ContentsNoticesGetting StartedQuick Start GuideSpeaker WiringNetwork SetupGeneral SetupAdvanced SetupOperatingProgrammers GuideSoftware Release NotesHelp

Software Release Notes

Software Updates
Version 1.02r
Version 1.02q
Version 1.02p
Version 1.02o
Version 1.02n
Version 1.02m
Software Upgrades

Software Updates

Software updates do not modify the operating system software itself (which is LINUX based). Changes to the operating system are done via "upgrades" (see the section "Software Upgrades" below). Software updates do change the features of the speaker switch. Most of those features are integrated into the web pages coupled with scripts that run in the background. Also, the look and feel of the web pages can be changed (mostly through CSS files).

Software updates are provided in a single file that is a tar ball (.tar). The file name format is: Version-x.yyz.tar where x is the major version, yy is the minor version followed by a single letter for the subversion.

WARNING: The files contained within the tar ball should not be modified. Doing so will invalidate the device warranty.

Among other files, a software update *might* also contain a "defaults.tar" file. The defaults.tar file contains a copy of an entire previous software update that is "safe" (a previous known good version). Applying a defaults.tar will make that safe version the running software version after a factory reset. This means that it is necessary to reapply the most recent available software update after a factory reset has been performed. defaults.tar files are a way to ensure that the device is always able to be recovered from a "bad" software update.

NOTE: Applying a software update or a defaults.tar does not affect the settings of the device at all. Only a factory reset, or applying a valid settings file (*.dat), will change the device settings.

Updating the software to the latest version requires following these simple steps:
1) Backup your speaker switch configuration. On your speaker switch, go to the "Updates" page and click on the "settings.dat" link near the bottom of the page. You can use this configuration file to restore your custom settings in the future, if needed.
2) Download the latest (or preferred) version of the software for the speaker switch. The latest tarball version can be downloaded from: Katoomba Sound Support. Links to the most recent and previous versions are listed below.
3) Download the software update onto the speaker switch. Follow the instructions in the "Updates" instructions section.
4) Apply the software update onto the speaker switch. Follow the instructions in the "Updates" instructions section.
5) Some updates may require rebooting the speaker switch. The release notes for each version will indicate if a reboot is required.
6) Update Finished. The software update is completed.


Software Update Version: 1.02r - Released: January 23rd 2025

File - download version 1.02r from Version 1.02r. MD5 Checksum: 19f2db34bc6fab639eba62a201cd9e4b

Details
☑ - Software version 1.02r is a general (G) release of software for the Katoomba Sound speaker switch.
☑ - You must apply atleast version 1.02m or higher before applying this update.
☑ - No reboot is required after applying this software update.
New Features
☑ - Under "Advanced", there is now a check box "Midnight Device Restart" that when checked will have the speaker switch device reboot/restart at midnight each night.
Known Unfixed Bugs
☑ - None.
Bug Fixes
☑ - None.
Known Unfixed Bugs
☑ - None.



Software Update Version: 1.02q - Released: January 22nd 2025

File - download version 1.02q from Version 1.02q. MD5 Checksum: f18aca4ab281777ea0fdcdcb785c4097

Details
☑ - Software version 1.02q is a general (G) release of software for the Katoomba Sound speaker switch.
☑ - You must apply atleast version 1.02m or higher before applying this update.
☑ - No reboot is required after applying this software update.
New Features
☑ - Under "Logs"->"Log View", an option to view disk space use has been added.
☑ - You can now display all seven speaker control buttons on one page. Under "Options", there is a tick box (called "Show Buttons on two Pages") that allows selecting between displaying one or two pages.
☑ - The speaker button background color now automatically updates with a light green or light red to clearly show the zone status of each speaker zone.
☑ - Horizontal separators now show the user defind buttons and settings divided away from the speaker buttons for easier viewing.
☑ - All of the color schemes have been updated to reduce the height of all buttons to improve the visual appearance and to better suit mobile phones.
☑ - You can press and hold speaker zone button 7 and then simultaneously press and hold the "Factory Reset" button. Holding both buttons for atleast 10 seconds will initiate a software downgrade to the previously installed default software update. See the "Reset to Factory Defaults" section for details.
Known Unfixed Bugs
☑ - None.
Bug Fixes
☑ - The number of log files that can be generated and stored on the Speaker Switch has been limited to 24 (one day of log files).
Known Unfixed Bugs
☑ - None.



Software Update Version: 1.02p

File - download version 1.02p from Version 1.02p. MD5 Checksum: 8e0536ccbda99e4d80e75875ef1cc970

Details
☑ - Software version 1.02p is a general (G) release of software for the Katoomba Sound speaker switch.
☑ - You must apply version 1.02m or 1.02n before applying this update.
☑ - No reboot is required after applying this software update.
New Features
☑ - Under "Networks", an option called "Enable WiFi Network Recovery" has been added. When enabled, the speaker switch will ping the network default gateway every 20 seconds. If no ping responses are received back from the default gateway for ten minutes, then the speaker switch will assume that the WiFi network has failed for some reason, and will attempt to initialise and then reconnect to the WiFi network. This option should only be enabled if the speaker switch is becoming unreachable/inaccessible for some unknown reason. This option should only be enabled if the default gateway can respond to ICMP pings from the speaker switch unit. If this feature is enabled and the default gateway is not pingable, then the speaker switch unit will disconnect and reconnect to the WiFi every ten minutes (causing the speaker switch web pages to be inaccessible for about 15-30 seconds every ten minutes).
☑ - Under "Advanced", an option called "Enable 1 Hour Log Dump" has been added. When enabled, the speaker switch will automatically create a logs dump file every hour. This option should only be enabled for troubleshooting purposes and should NOT be left enabled for longer than a few days at a time.
☑ - Under "Logs"->"Log View", an option to view the dhcpcd.service logs has been added.
☑ - Under "Logs"->"Log View", an option to view the "spkrIo Log" has been added.
☑ - Under "Logs"->"Log View", an option to view the "spkrWatchdog Log" has been added.
☑ - Under "Logs"->"Log View", an option to view the (Apache) Web Service Status has been added.
☑ - Under "Logs"->"Log Files", a button to "Generate Log Dump File" has been added.
☑ - Under "Logs"->"Log Files", a button to "Delete Log Dump Files" has been added.
Known Unfixed Bugs
☑ - None.
Bug Fixes
☑ - None.
Known Unfixed Bugs
☑ - None.



Software Update Version: 1.02o

File - download version 1.02o from Version 1.02o. MD5 Checksum: be9b6e19d53370be1a669927dca14a41

Details
☑ - Software version 1.02o is an "interim" (I) release of software for the Katoomba Sound speaker switch.
☑ - You must apply version 1.02m or 1.02n before applying this update.
☑ - No reboot is required after applying this software update.
New Features
☑ - A "Logs" page has been added (in advanced mode) that allows viewing and downloading of various device log files.
Known Unfixed Bugs
☑ - None.
Bug Fixes
☑ - remotecontrol.php operation was improved to support FIFO speaker operation.
☑ - remotecontrol.php toggling operation was improved to show each switch status reported in the response page.
Known Unfixed Bugs
☑ - None.



Software Update Version: 1.02n

File - download version 1.02n from Version 1.02n. MD5 Checksum: 8d60839e0907900c57b607ebad552282

Details
☑ - Software version 1.02n is an "interim" (I) release of software for the Katoomba Sound speaker switch.
☑ - No reboot is required after applying this software update.
New Features
☑ - In the "Advanced" tab, a new section named "Advanced - Status" shows "WiFi Status" and the WiFi interface (wlan0) status and statistics are shown.
Known Unfixed Bugs
☑ - None.
Bug Fixes
☑ - The watchdog script was improved to use a single ping keep alive once per minute. This helps to keep the speaker switch online on the network for some routers and switches that time out inactive devices.
☑ - In the "Options" tab, the "Model Type" is forced to "Seven Speaker Switches (SPKR7) and cannot be changed by the user.
Known Unfixed Bugs
☑ - None.



Software Update Version: 1.02m

File - download version 1.02m from Version 1.02m. MD5 Checksum: a52d0f553b1db1fd733c703e5bab3d64

Details
☑ - Software version 1.02m is the first "general deployment" (GD) release of software for the Katoomba Sound speaker switch.
☑ - No reboot is required after applying this software update.
New Features
☑ - You can backup the speaker switch configuration settings by going to the "Updates" tab and clicking on the "settings.dat" link near the bottom of the page.
☑ - You can restore the speaker switch configuration settings by uploading a valid settings file (eg: settings.dat) and applying the settings file.
☑ - The "Advanced" page now has a button named "Cylon LEDs On" which allows toggling on and off a "scanning" LEDs effect which allows for finding the active speaker switch.
Bug Fixes
☑ - None.
Known Unfixed Bugs
☑ - In the "Options" tab, you must NOT select "Model Type"->"Four Speaker Switches (SPKR4). If you do, the speaker buttons will not operate correctly.



Software Upgrades

A software "upgrade" replaces or upgrades all or some of the underlying operating system programs and data of the speaker switch. Generally, it is not necessary to perform a software upgrade. However, if a speaker switch becomes completely unresponsive, it may need a complete software upgrade/replacement. In situations where this becomes necessary, a flash card containing all of the speaker switch operating system software can be obtained from technical support.