mirror of
https://github.com/esphome/esphome-docs.git
synced 2024-09-04 00:50:41 +02:00
105 lines
3.3 KiB
ReStructuredText
105 lines
3.3 KiB
ReStructuredText
|
BedJet
|
||
|
======
|
||
|
|
||
|
.. seo::
|
||
|
:description: Instructions for setting up a BedJet climate device.
|
||
|
:image: bedjet.png
|
||
|
|
||
|
The ``bedjet`` climate platform creates a climate device which can be used to control
|
||
|
a BedJet V3 Climate Comfort Sleep System.
|
||
|
|
||
|
This component supports the following functionality:
|
||
|
|
||
|
- Set the operating mode: off, heat, cool, turbo (boost)
|
||
|
- Set the desired target temperature
|
||
|
- Set the desired fan speed
|
||
|
- Start one of the saved memory presets, including "Biorhythm" programs
|
||
|
- Show the current status of the BedJet
|
||
|
|
||
|
This platform uses the BLE peripheral on an ESP32, so you also need to enable
|
||
|
this component. Please see the :doc:`/components/ble_client` docs for how to discover the MAC
|
||
|
address of your BedJet device, or you can find the list of paired MAC addresses in
|
||
|
the "DEVICE LIST" section of the BedJet mobile application.
|
||
|
|
||
|
.. code-block:: yaml
|
||
|
|
||
|
ble_client:
|
||
|
- mac_address: 11:22:33:aa:bb:cc
|
||
|
id: ble_bedjet
|
||
|
|
||
|
climate:
|
||
|
- platform: bedjet
|
||
|
id: my_bedjet_fan
|
||
|
name: "My BedJet Fan"
|
||
|
ble_client_id: ble_bedjet
|
||
|
|
||
|
Configuration variables:
|
||
|
------------------------
|
||
|
|
||
|
- **id** (*Optional*, :ref:`config-id`): Manually specify the ID used for code generation.
|
||
|
- **name** (**Required**, string): The name of the climate device.
|
||
|
- **ble_client_id** (**Required**, :ref:`config-id`): The ID of the BLE Client.
|
||
|
- **time_id** (*Optional*, :ref:`config-id`): The ID of a :ref:`Time Component <time>` which
|
||
|
can be used to set the time on the BedJet device.
|
||
|
- All other options from :ref:`Climate <config-climate>`.
|
||
|
|
||
|
lambda calls
|
||
|
************
|
||
|
|
||
|
From :ref:`lambdas <config-lambda>`, you can call methods to do some advanced stuff.
|
||
|
|
||
|
- ``.upgrade_firmware``: Check for and install updated BedJet firmware.
|
||
|
|
||
|
.. code-block:: yaml
|
||
|
|
||
|
button:
|
||
|
- platform: template
|
||
|
name: "Check Bedjet Firmware"
|
||
|
on_press:
|
||
|
then:
|
||
|
- lambda: |-
|
||
|
id(my_bedjet_fan).upgrade_firmware();
|
||
|
|
||
|
Known issues:
|
||
|
-------------
|
||
|
|
||
|
.. warning::
|
||
|
|
||
|
BedJet V2 and other devices are not currently supported. Only BedJet V3 is supported.
|
||
|
|
||
|
.. note::
|
||
|
|
||
|
Only one client can be connected to the BedJet BLE service at a time, so you cannot
|
||
|
use the BedJet mobile app to monitor or control the BedJet device while this component
|
||
|
is connected. To use the mobile app, you should disconnect the ESP client first.
|
||
|
|
||
|
To set up a (dis-)connect switch, see :doc:`/components/switch/ble_client`.
|
||
|
|
||
|
.. note::
|
||
|
|
||
|
When more than one device is configured and connected, the ESP device may become
|
||
|
overwhelmed and lead to timeouts while trying to install an updated version of the
|
||
|
configuration. If this occurs, see the previous note about adding disconnect switches,
|
||
|
and toggle those off while performing the installation. This will free up resources
|
||
|
on the ESP and allow the installation to complete.
|
||
|
|
||
|
Additionally, you may use an :ref:`ota.on_begin <ota-on_begin>` :ref:`Automation<automation>`
|
||
|
to do this automatically:
|
||
|
|
||
|
.. code-block:: yaml
|
||
|
|
||
|
ota:
|
||
|
on_begin:
|
||
|
then:
|
||
|
- logger.log: "Disconnecting clients for OTA update..."
|
||
|
- switch.turn_off: bedjet_1_monitor
|
||
|
- switch.turn_off: bedjet_2_monitor
|
||
|
|
||
|
See Also
|
||
|
--------
|
||
|
|
||
|
- :doc:`/components/ble_client`
|
||
|
- :doc:`/components/climate/index`
|
||
|
- :apiref:`bedjet/bedjet.h`
|
||
|
- :ghedit:`Edit`
|