SoundTouch Model Notes - thlucas1/homeassistantcomponent_soundtouchplus GitHub Wiki

The following are notes on specific models of SoundTouch devices that I put together. They try to document the various capabilities and limitations of each of the SoundTouch device models that I have tested with and fielded questions for.

This information will grow over time. Please send me a message if you have information on SoundTouch models not listed below, or if something is listed incorrectly.

SoundTouch 10

The SoundTouch 10 supports most features of the integration. I have 4 of these devices in my home, and regularly use them for testing the integration.

ST-10 Factory Reset

Use the following steps to factory reset an ST-10 device:

  • Press and hold BOTH the "preset 1" and "volume -" keys down for @15 seconds.
    All 4 front LED's should go solid within 10-15 seconds.
    Keep holding the 2 keys down until all 4 front LED's start blinking.
  • Release the 2 keys after all 4 front LED's start blinking.
  • The 4 front LED's will go through various phases, but will end up with LED1 a solid orange.
    This indicates the device is in setup mode.

ST-10 Add Wireless Profile to a Factory Reset Device

Use the following steps to add a wireless profile while an ST-10 device is in factory reset mode; factory reset mode is indicated by LED1 being a solid orange.

  • This assumes you have reset your device to factory defaults.
  • Ensure the SoundTouchApp is not running!
  • Plug in the device to electrical power; LED1 should be solid orange indicating setup mode.
  • Bring up your list of wifi networks (on your desktop or phone - I tested using desktop Windows 11 Pro with Chrome browser).
    Within 30 seconds, you should see a new network appear under your wifi settings.
    Also ensure that it's not saved as a "remembered" network (forget the network if so).
  • The new network will be named similar to the following:
    "Bose ST 10 (XXXXXX)"
    • XXXXXX is device serial number (e.g. "3265AC").
  • Connect to the "Bose ST 10 (XXXXXX)" network.
  • If it does not connect initially, retry a few times (it took my Windows 11 Pro 2 times).
    Also ensure you do not have wireless access control (in router settings) blocking the connection.
  • Once connected, it should assign the device to IP=192.0.2.2, Default Gateway=192.0.2.1.
  • Open up a new browser window (or tab) to the Default Gateway address: http://192.0.2.1.
  • This should display a page where you can select your wifi network, enter the password, and click submit.

You can also use the following if you can't use the http://192.0.2.1 web page to add the wireless profile:

  • ** IMPORTANT ** - you have to send the command to the default gateway address (192.0.2.1) from the computer (or phone) that established the wifi connection to the SoundTouch device.
curl -X POST "http://192.0.2.1:8090/addWirelessProfile" \
  -H "Content-Type: application/xml" \
  -d '<AddWirelessProfile timeout="30"><profile ssid="YourSSIDName" password="YourSSIDPassword" securityType="wpa_or_wpa2" /></AddWirelessProfile>'

Links (ST-10)

SoundTouch 20, Series II

Capabilities

TODO

Limitations

  • device does not support websockets. This has been confirmed by owners of this device.
  • does not support recent list caching of played content, as websocket support is not supported.

Links (ST-20)

SoundTouch 30

TODO

SoundTouch 300

The SoundTouch 300 supports most features of the integration. I have 1 of these devices in my home, and regularly use it for testing the integration.

Links (ST-300)

SoundTouch 120

The CineMate 120 Home Theater System utilizes the SoundTouch Wireless Adapter to provide limited functionality. Per the manual (see links) ... "Once you have set up SoundTouch, you can use the remote to control a subset of features on your system".

Refer to the SoundTouch Wireless Adapter section of this document for more information on the capabilities and limitations of the SoundTouch Wireless Adapter.

Capabilities

None of the following have been verified, but I suspect they behave the same as the ST-520 device since they both use the SoundTouch Wireless Adapter.

  • control power on \ off via media_player.turn_on\turn_off services.
  • control volume up \ down \ mute via media_player.volume_up\down\mute services.
  • control playback via the media_player.media_play\pause\stop\next\etc services (play, pause, stop, skip to the next track, etc).
  • play Presets via the soundtouchplus.remote_keypress service.
  • control source switch to inputs on the Wireless Adapter via media_player.select_source service (e.g. BLUETOOTH, AIRPLAY, etc).

Limitations

  • cannot switch to sources on the 120 main console via media_player.select_source service (e.g. AUX, HDMI1-5, etc).

Links (ST-120)

SoundTouch 520

The SoundTouch 520 5.1 Home Cinema System utilizes the SoundTouch Wireless Adapter to provide limited functionality. Per the manual (see links) ... "Once you have set up SoundTouch, you can use the remote to control a subset of features on your system".

Refer to the SoundTouch Wireless Adapter section of this document for more information on the capabilities and limitations of the SoundTouch Wireless Adapter.

Capabilities

All of the following have been verified with service calls via the HA Developer Tools \ Services tab by 520 owners (thank you Bingo2023).

  • control power on \ off via media_player.turn_on\turn_off services.
  • control volume up \ down \ mute via media_player.volume_up\down\mute services.
  • control playback via the media_player.media_play\pause\stop\next\etc services (play, pause, stop, skip to the next track, etc).
  • play Presets via the soundtouchplus.remote_keypress service.
  • control source switch to inputs on the Wireless Adapter via media_player.select_source service (e.g. BLUETOOTH, AIRPLAY, etc).

Limitations

  • cannot switch to sources on the 520 main console via media_player.select_source service (e.g. AUX, HDMI1-5, etc).

Links (ST-520)

SoundTouch Wave System IV

The SoundTouch Wave System IV ... TODO UPDATE

utilizes the SoundTouch Wireless Adapter to provide limited functionality. Per the manual (see links) ... "Once you have set up SoundTouch, you can use the remote to control a subset of features on your system".

Refer to the SoundTouch Wireless Adapter section of this document for more information on the capabilities and limitations of the SoundTouch Wireless Adapter.

Capabilities

All of the following have been verified with service calls via the HA Developer Tools \ Services tab by 520 owners (thank you Bingo2023).

  • control power on \ off via media_player.turn_on\turn_off services.
  • control volume up \ down \ mute via media_player.volume_up\down\mute services.
  • control playback via the media_player.media_play\pause\stop\next\etc services (play, pause, stop, skip to the next track, etc).
  • play Presets via the soundtouchplus.remote_keypress service.
  • control source switch to inputs on the Wireless Adapter via media_player.select_source service (e.g. BLUETOOTH, AIRPLAY, etc).

Limitations

  • cannot switch to sources on the 520 main console via media_player.select_source service (e.g. AUX, HDMI1-5, etc).

Links (ST-520)

SoundTouch Wireless Adapter

The SoundTouch Wireless Adapter is an add-on product that can be purchased to add SoundTouch capabilities to some of the older Bose devices (e.g. Cinemate, Companion, etc).

What I have found (thus far) is that the SoundTouch Wireless Adapter box simply adds SoundTouch sources (e.g. Bluetooth, Pandora, Spotify, TuneIn, etc) that get fed into the main console (ST-120, ST-520, etc) via the dedicated "Bose Link" input. Note that the main console sources (e.g. AUX, HDMI1-5, etc) are not controllable from the SoundTouch WebServices API for these devices (only the Wireless Adapter sources are controllable).

For example, you cannot switch to the console's HDMI 1 input via the soundtouchplus integration nor via services calls (e.g. media_player.select_source).

You can switch to the LOCAL source (e.g. the dedicated SoundTouch input) like so:

# select dedicated SoundTouch source.
service: media_player.select_source
data:
  source: LOCAL
target:
  entity_id: media_player.soundtouch_520_1

User Notes

2024/01/11 - zdale59 - Community Forum post ...

FYI for anyone who has the Bose 520, cinemate, ST-520, or whatever name may be referenced, it would appear the 412451 is the SoundTouch wireless adapter version 1. This adapter was limited using HA. Some features worked. However I just upgraded to version 2 adapter the model number ends with “SM2”. This adapter adds Bluetooth and gives more options within HA. You still will not be able to control local source selection like TV, AUX, etc, but everything else seems to be great!

Capabilities

  • control power on \ off via media_player.turn_on\turn_off services.
  • control volume up \ down \ mute via media_player.volume_up\down\mute services.
  • control playback via the media_player.media_play\pause\stop\next\etc services (play, pause, stop, skip to the next track, etc).
  • play Presets via the soundtouchplus.remote_keypress service.
  • control source switch to inputs on the Wireless Adapter via media_player.select_source service (e.g. BLUETOOTH, SPOTIFY, TUNEIN, etc).

Limitations

  • cannot switch to sources on the main console via media_player.select_source service (e.g. AUX, HDMI1-5, etc).
  • state simply reports as unknown when the LOCAL source is selected. This is not considered a bug, as the Wireless Adapter does not report any detailed nowplaying information when SOURCE="LOCAL" (hence the unknown status). It's state is not off, but is unknown (e.g. it could be playing, paused, etc, but we don't know because it can't tell us that information).

Links (ST-WA)