Documentation for controlling and preserving Bose SoundTouch devices
The SoundTouch service currently relies heavily on local network connectivity for device discovery and management:
/info endpointThe /power_on endpoint provides rich device data that could eliminate network dependencies:
<device-data>
<device id="A81B6A536A98"> <!-- ✅ Device MAC -->
<serialnumber>I6332527703739342000020</serialnumber> <!-- ✅ Serial -->
<firmware-version>27.0.6.46330.5043500...</firmware-version> <!-- ✅ FW -->
<product product_code="SoundTouch 10 sm2" type="5"> <!-- ✅ Model -->
<serialnumber>069231P63364828AE</serialnumber> <!-- ✅ Product Serial -->
</product>
</device>
<diagnostic-data>
<device-landscape>
<rssi>Excellent</rssi> <!-- ✅ Signal -->
<gateway-ip-address>192.168.178.1</gateway-ip-address> <!-- ✅ Network -->
<macaddresses> <!-- ✅ All MACs -->
<macaddress>A81B6A536A98</macaddress>
<macaddress>A81B6A849D99</macaddress>
</macaddresses>
<ip-address>192.168.178.35</ip-address> <!-- ✅ Current IP -->
<network-connection-type>Wireless</network-connection-type> <!-- ✅ Connection -->
</device-landscape>
</diagnostic-data>
</device-data>
| Data | Current Source | Available in /power_on | Impact |
|——|—————-|———————-|———|
| User-friendly name | Registration | ❌ Missing | High - UI/UX |
| Account association | Registration | ❌ Missing | Critical - Authorization |
| Service URLs | /info | ❌ Missing | High - Migration |
| Regional settings | /info | ❌ Missing | Medium - Localization |
/power_on handler to process full device data// Enhanced flow
Device -> POST /power_on -> Service identifies by MAC -> Update/Create device record
graph TD
PowerOn[Device /power_on] --> Identify[MAC-based Identification]
Identify --> New{New Device?}
New -->|Yes| Create[Create Device Record]
New -->|No| Update[Update Existing Record]
Create --> CheckAccount{Account Known?}
CheckAccount -->|No| RegisterFlow[Trigger Registration]
CheckAccount -->|Yes| LinkAccount[Link to Account]
Update --> DetectChanges[Detect Changes]
DetectChanges --> Migration{Migration Needed?}
Migration -->|Yes| SendInstructions[Send Migration Instructions]
LinkAccount --> Response[Send Configuration Response]
SendInstructions --> Response
RegisterFlow --> Response
The /power_on enhancement represents a strategic opportunity to:
Recommendation: Proceed with hybrid implementation approach, prioritizing network independence while preserving existing user workflows and system reliability.
Timeline: Phase 1 implementation feasible within 2-3 sprints, with Phases 2-3 extending capabilities based on user feedback and firmware enhancement opportunities.