{"record":{"id":"e94d3fe10562359c","repo":"home-assistant/core","slug":"transmit-failed","errorCode":null,"errorMessage":"transmit_failed","messagePattern":"transmit_failed","errorType":"exception","errorClass":"HomeAssistantError","httpStatus":null,"severity":"error","filePath":"homeassistant/components/broadlink/radio_frequency.py","lineNumber":129,"sourceCode":"        \"\"\"Encode an OOK command and transmit it via the Broadlink device.\"\"\"\n        type_byte = _type_byte_for_frequency(command.frequency)\n        packet = encode_rf_packet(\n            type_byte=type_byte,\n            repeat_count=command.repeat_count,\n            timings_us=command.get_raw_timings(),\n        )\n        _LOGGER.debug(\n            \"Transmitting RF packet: %d bytes on %d Hz (repeat=%d)\",\n            len(packet),\n            command.frequency,\n            command.repeat_count,\n        )\n\n        device = self._device\n        try:\n            await device.async_request(device.api.send_data, packet)\n        except (BroadlinkException, OSError) as err:\n            raise HomeAssistantError(\n                translation_domain=DOMAIN,\n                translation_key=\"transmit_failed\",\n                translation_placeholders={\"error\": str(err)},\n            ) from err\n","sourceCodeStart":111,"sourceCodeEnd":134,"githubUrl":"https://github.com/home-assistant/core/blob/58a3fdb3ea0538617f0a07efcfba6294de64fd59/homeassistant/components/broadlink/radio_frequency.py#L111-L134","documentation":"HomeAssistantError with key transmit_failed, raised by the RF entity's async_send_command when device.api.send_data raises BroadlinkException or OSError while transmitting an encoded RF packet. The packet has already passed frequency validation and encoding; the failure is at the device/network layer. The 'error' placeholder contains the underlying exception text.","triggerScenarios":"Sending an RF command while the Broadlink device is unreachable, its auth session expired, or the device rejects the send_data request (e.g. malformed packet, device busy).","commonSituations":"Device off/ rebooted, changed IP, Wi-Fi congestion, sending an oversized RF packet, device that lacks RF transmit capability receiving RF-formatted data.","solutions":["Verify device connectivity and retry the transmission.","Reload the Broadlink integration to re-authenticate with the device.","Re-learn the RF code — corrupted learned data can produce packets the device rejects.","Check the 'error' placeholder / logs for the specific BroadlinkException to distinguish auth vs transport."],"exampleFix":null,"handlingStrategy":"retry","validationCode":null,"typeGuard":null,"tryCatchPattern":"try:\n    await rf_entity.async_send_command(command)\nexcept HomeAssistantError as err:\n    if err.translation_key == \"transmit_failed\":\n        if not device.available:\n            raise HomeAssistantErrorRetryLater from err  # device offline, retry later\n        raise  # persistent failure: re-learn the code\n    raise","preventionTips":["Gate RF automations on the Broadlink device's availability.","Re-learn RF codes after firmware/device changes instead of reusing stale captures.","Check the 'error' placeholder text before retrying blindly — auth errors need a reload, not a retry."],"tags":["home-assistant","broadlink","radio-frequency","network"],"backgroundTag":null,"analyzedSha":"58a3fdb3ea0538617f0a07efcfba6294de64fd59","analyzedAt":"2026-08-14T20:54:38.818Z","schemaVersion":2},"datasetVersion":"2026-08-15T22:17:37.221Z"}