在sensor下创建一个新platform 修正

在sensor下创建一个新platform 修正

homeassistant-HA文档-第6课 在sensor下创建一个新platform 修正

"""
文件名：sensor.py.
 
文件位置：HomeAssistant配置目录/custom_components/hachina/sensor.py
演示程序，在sensor下创建一个新platform.
 
"""
# 引入一个产生随机数的库
from random import randint
import logging
 
# 在homeassistant.const中定义了一些常量，我们在程序中会用到
from homeassistant.const import (
    ATTR_ATTRIBUTION, ATTR_FRIENDLY_NAME, TEMP_CELSIUS)
from homeassistant.helpers.entity import Entity
 
_LOGGER = logging.getLogger(__name__)
 
# 定义实体的OBJECT_ID与一些属性值
OBJECT_ID = "hachina_temperature"
ICON = "mdi:yin-yang"
ATTRIBUTION = "随机显示的温度"
FRIENDLY_NAME = "温度"
 
 
def setup_platform(hass, config, add_devices, discovery_info=None):
    """配置文件在sensor域下出现hachina平台时，会自动调用hachina目录下sensor.py中的setup_platform函数."""
    _LOGGER.info("setup platform sensor.hachina...")
 
    # 定义一个设备组，在其中装入了一个我们定义的设备HAChinaTemperatureSensor
    dev = []
    sensor = HAChinaTemperatureSensor()
    dev.append(sensor)
 
    # 将设备加载入系统中
    add_devices(dev, True)
 
 
class HAChinaTemperatureSensor(Entity):
    """定义一个温度传感器的类，继承自HomeAssistant的Entity类."""
 
    def __init__(self):
        """初始化，状态值为空."""
        self._state = None
 
    @property
    def name(self):
        """返回实体的名字。通过python装饰器@property，使访问更自然（方法变成属性调用，可以直接使用xxx.name）."""
        return OBJECT_ID
 
    @property
    def registry_name(self):
        """返回实体的friendly_name属性."""
        return FRIENDLY_NAME
 
    @property
    def state(self):
        """返回当前的状态."""
        return self._state
 
    @property
    def icon(self):
        """返回icon属性."""
        return ICON
 
    @property
    def unit_of_measurement(self):
        """返回unit_of_measuremeng属性."""
        return TEMP_CELSIUS
 
    @property
    def device_state_attributes(self):
        """设置其它一些属性值."""
        if self._state is not None:
            return {
                ATTR_ATTRIBUTION: ATTRIBUTION,
            }
 
    def update(self):
        """更新函数，在sensor组件下系统会定时自动调用（时间间隔在配置文件中可以调整，缺省为30秒）."""
        _LOGGER.info("Update the state...")
        self._state = randint(-100, 100)

注意：此段代码开头注释部分已经被我更改了目录说明。大家按照我这个目录来创建。包括文件名也改成了sensor.py .

这个demo 是组件sensor 配置在hachina平台的应用。

那么这样就需要在hachina的目录下配置3个文件：

- __init__.py
- manifest.json
- sensor.py

init.py: 不需要编写核心逻辑，空着就行。

manifest.json 代码如下：

{
  "domain": "hachina",
  "name": "hachina",
  "documentation": "https://www.hachina.io/3973.html#comments",
  "requirements": ["requests"],
  "codeowners": [],
  "dependencies": []
}

sensor.py: 就是最上面的代码。

最后就是配置根目录下的configuration.yaml文件

sensor: 
  - platform: hachina
    scan_interval: 3

就这样关掉服务 然后hass 重启就可以了