From 0ed8840760b4bfe6548c063b389e03ae3bc52928 Mon Sep 17 00:00:00 2001 From: micha91 Date: Fri, 10 Sep 2021 16:14:00 +0200 Subject: [PATCH] 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 Co-authored-by: Martin Hjelmare --- source/_integrations/yamaha_musiccast.markdown | 11 +++++++++++ 1 file changed, 11 insertions(+) diff --git a/source/_integrations/yamaha_musiccast.markdown b/source/_integrations/yamaha_musiccast.markdown index 3e6115ded91..2356189114f 100644 --- a/source/_integrations/yamaha_musiccast.markdown +++ b/source/_integrations/yamaha_musiccast.markdown @@ -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: ` +* `Received non UTF-8 compliant message: b''` + +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.