Yamaha Musiccast - Add Troubleshooting section (#19280)

* Add Troubleshooting section

Add documentation for the resolution of corrupt UPD messages

* Update yamaha_musiccast.markdown

* Update source/_integrations/yamaha_musiccast.markdown

Co-authored-by: Martin Hjelmare <marhje52@gmail.com>

Co-authored-by: Martin Hjelmare <marhje52@gmail.com>
This commit is contained in:
micha91 2021-09-10 16:14:00 +02:00 committed by GitHub
parent bc65d0f823
commit 0ed8840760
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23

View File

@ -57,3 +57,14 @@ data:
media_content_id: "presets:1"
media_content_type: "music"
```
## Troubleshooting
In this section known problems and their resolution are documented.
### Errors on handling UDP messages
The Yamaha MusicCast integration is working with updates sent from the device to Home Assistant instead of pulling all information every few seconds. There is no error correction mechanism in these messages, so that only 100% correct messages can be processed. Whenever there is a corrupt message the Yamaha MusicCast integration will update all device information and log an error message like these:
* `Received invalid message: <message>`
* `Received non UTF-8 compliant message: b'<binary>'`
If you receive these errors frequently, you should first try to disconnect your MusicCast devices from the power, wait 30 seconds and reconnect them to the power. If this does not help, you can try to use a LAN cable instead of WiFi to connect the device to the network.