Speaker Switch Owners Manual (SPKR7)

Contents Notices Getting Started Speaker Wiring Network Setup General Setup Advanced Setup Operating Help

Advanced Setup

Accessing Advanced Settings
Enabling/Disabling SSH
Processor
Actions
Updates

Accessing Advanced Settings

CAUTION: You should not use or change the advanced settings unless you understand:

The risks associated with Internet security and SSH.
The risks associated with updating the speaker switch software.

There are two advanced options pages. Normally these pages are not reachable and there are no tabs visible for them either. Advanced settings are found in two pages, the "Advanced" page and the "Updates" page.

☑The "Advanced" page allows:

Enabling or disabling SSH.
Viewing the selected SBC (single board computer).

☑The "Updates" page allows:

Downloading and installing software updates.
Downloading and installing CSS (cascading style sheet) files.
Installing "default" software packages.

Access to the pages is available by clicking on the "Options" tab, scrolling down to the bottom of the page and then clicking on the "Show Advanced" button. The button will change to "Hide Advanced". At the same time, the two tabs will appear and become accessible.

Accessing Advanced Settings

CAUTION: You should not use or change the advanced settings unless you understand:

The risks associated with Internet security and SSH.
The risks associated with updating the speaker switch software.

There are two advanced options pages. Normally these pages are not reachable and there are no tabs visible for them either. Access to the pages is made available by clicking on the "Options" tab, scrolling down to the bottom of the page and clicking on the "Show Advanced" button.

The picture below shows the "Options" page button that needs to be clicked in order to show the advanced tabs.

The picture below shows the menu with the "Advanced" and "Update" tabs showing.

Enabling/Disabling SSH

You can enable SSH on the speaker switch. When SSH is enabled, computers may make SSH connections to the speaker switch and then use LINUX commands to change the running configuration of the speaker switch. It is also possible to use SCP to transfer files to and from the speaker switch.

CAUTION: You should not enable SSH unless you understand the risks associated with Internet security and SSH:

In most cases, the speaker switch will be located behind your home router and will not be reachable from the Internet. This means that SSH may be enabled and any remaining security issues will be limited to within the local network.
Exposing the SSH (TCP port 22) to the Internet is NOT recommended.

WARNING: Making changes to any files on the speaker switch may cause it to become inoperable and may not be recoverable. Do NOT make changes to the file system unless instructed to do so by katoombasound technical support.
To enable SSH, go to the "Advanced" page, check the "Enable SSH" tick box and apply changes. Disable SSH by unchecking the "Enable SSH" tick box and applying the changes.

To login to the speaker switch via SSH, use the following credentials:

For Banana Pi processor - username: pi with password: bananapi
For Orange Pi processor - username: pi with password: orangepi

You can find the processor by viewing the "Processor" field directly below the "Enable SSH" check box.

Processor

The "Advanced" page shows a "Processor" field that is a drop down list box. When the speaker switch is operating correctly there is no need to change the processor and the processor is automatically set.

Actions

The "Advanced" page shows an "Actions" section that has six (6) buttons that allow carrying out various tasks. A picture of the page section is shown below.

The button functions are as follows:

Factory Defaults - Pressing this button, and confirming it, will cause the speaker switch to reset all configuration settings back to the original settings that came from the factory.
Reboot Device - Pressing this button, and confirming it, will cause the speaker switch to go through a reboot cycle.
Flash LEDS 10x - Pressing this button will flash the front panel LEDs 10 times. Pressing this button does not require user confirmation.
Halt Device - Pressing this button, and confirming it, will cause the speaker switch CPU to stop all processing in preparation for power to be removed.
Phone Home - Pressing this button will instruct the speaker switch to register by phoning home to the Katoomba Sound "Find My Speaker Switch" service. Pressing this button does not require user confirmation.
Restart Service - Restart the LEDs and Switches Service. If the front panel buttons on the front of the speaker switch become unresponsive then restarting this service may help to fix the issue.

Updates

The Software Updates pages allows for downloading and applying (installing) software update files (.tar) and CSS files (.css). Katoomba Sound may release software updates that improve the operation or visual presentation of the speaker switch. It is also possible to create custom CSS (cascading style sheets) files that enhance the visual presentation of the speaker switch. Updates that come from Katoomba Sound will be tarballs (*.tar). CSS files will be *.css. WARNING: Do NOT download or apply files unless they are genuine Katoomba Sound file packages. Or, ensure that any CSS files have all of the needed attributes that will guarantee correct web page operations.

Steps to download and install Katoomba Sound updates include:

Download the appropriate Katoomba Sound update from the Katoomba Sound download page to a location on your computer.
From the speaker switch "Updates" page, press the "Browse" button which is shown in the picture below. Then, select the updates file that you downloaded from Katoomba Sound. In the screenshot below right, the desired file is "Version-1.02a.tar". Select the file and then press "Open".

The file name should now appear next to the "Browse" button. In the picture below, the file is shown to the right of the "Browse" button. You can now press the "Download" button that is shown to the right in the picture below. When the pop up box asks for confirmation, press "OK" and the file will be downloaded to the speaker switch.

The chosen file (Example: "Version-1.02a.tar") will be downloaded to the speaker switch. The picture below shows the file (within the red box) in the list of available downloaded files.

Now that the file has been downloaded, the software upgrade package can be installed by pressing the "Apply" button.
When a Katoomba Sound tarball package is "Applied", it will expand and copy the contents into the speaker switch for four reasons. They are:
- Updating the operations of the speaker switch
- Updating the web pages (presentation) of the speaker switch
- Installing any new CSS files (for modifying the look of the web pages). New (or modified) CSS files will be moved into the CSS file folder
- Providing a new factory defaults file (defaults.tar). The defaults.tar file will be moved into the defaults folder.
The file (and others) can be deleted by pressing the respective "Delete" button.