h4 / LYWSD02-home-assistant

Home-Assistant sensor for LYWSD02 Thermometer
75 stars 12 forks source link

LYWSD02-home-assistant

Home-Assistant sensor for Xiaomi LYWSD02 Hygrometer Thermometer.

!WORK IN PROGRESS!

TODO: Add more documentation

Installation

  1. Copy custom_components/lywsd02_sensor directory into custom_components inside your HA directory (typically, where configuration.yaml is placed).
  2. Add this block into configuration.yaml
    lywsd02_sensor:
      mac: 3A:57:C8:89:70:BE
      sensor:
        - enabled: true
          name: 'My Thermometer'

    where mac property is you'r BT Thermometer mac address. See mitemp_bt docs for instructions.

  3. Update or create sensor templates (this step will be simplified in future)
    sensor:
       - platform: template
        sensors:
            my_temp:
                friendly_name: "Entrance Temperature"
                value_template: "{{ states.sensor.my_thermometer.attributes.temperature }}"
                unit_of_measurement: 'ºC'
            my_humid:
                friendly_name: "Entrance Humidity"
                value_template: "{{ states.sensor.my_thermometer.attributes.humidity }}"
                unit_of_measurement: '%'
  4. Restart Home-Assistant

Available attributes

Name Type Units Description
tetemperature float °C Temperature measured value
humidity int % Relative Humidity measured value
battery_level int % Experimental Device battery level. I'm not sure that it gets correct
time str time string Current time displayed on device

pixel