mqtt2ha
    Preparing search index...

    Interface CoverInfo

    Configuration interface for a cover component.

    interface CoverInfo {
        availability?: AvailabilityConfiguration;
        component: "cover";
        device?: DeviceConfiguration;
        device_class?: string;
        enabled_by_default?: boolean;
        entity_category?: "config" | "diagnostic" | "system";
        expire_after?: number;
        force_update?: boolean;
        icon?: string;
        json_attributes_template?: string;
        name?: string;
        object_id?: string;
        optimistic?: boolean;
        origin?: OriginConfiguration;
        payload_close?: string;
        payload_open?: string;
        payload_stop?: string;
        position_closed?: number;
        position_open?: number;
        position_template?: string;
        qos?: number;
        retain?: boolean;
        set_position_template?: string;
        state_closed?: string;
        state_closing?: string;
        state_open?: string;
        state_opening?: string;
        state_stopped?: string;
        tilt_closed_value?: number;
        tilt_max?: number;
        tilt_min?: number;
        tilt_opened_value?: number;
        unique_id?: string;
        value_template?: string;
        [key: string]: unknown;
    }

    Hierarchy (View Summary)

    Indexable

    • [key: string]: unknown

      Additional properties to serialize as part of the configuration payload. Typically used for command and state topics.

    Index
    availability? component device? device_class? enabled_by_default? entity_category? expire_after? force_update? icon? json_attributes_template? name? object_id? optimistic? origin? payload_close? payload_open? payload_stop? position_closed? position_open? position_template? qos? retain? set_position_template? state_closed? state_closing? state_open? state_opening? state_stopped? tilt_closed_value? tilt_max? tilt_min? tilt_opened_value? unique_id? value_template?
    availability?: AvailabilityConfiguration

    Configures the availability settings of the entity.

    component: "cover"

    The type of component, constrained to valid component types

    device?: DeviceConfiguration

    Information about the device this component is a part of to tie it into the device registry. Only works when unique_id is set. At least one of identifiers or connections must be present to identify the device.

    device_class?: string

    Sets the class of the device, changing the device state and icon that is displayed on the frontend. The device_class can be null. Different components have different valid device classes.

    enabled_by_default?: boolean

    Flag which defines if the entity should be enabled when first added. Default is true.

    entity_category?: "config" | "diagnostic" | "system"

    The category of the entity

    • "config": For configuration related entities.
    • "diagnostic": For read-only diagnostic entities.
    • "system": For system related entities.
    expire_after?: number

    If set, it defines the number of seconds after the sensor’s state expires, if it’s not updated. After expiry, the sensor’s state becomes unavailable. Default the sensors state never expires.

    force_update?: boolean

    Sends update events (which results in update of state object’s last_changed) even if the sensor’s state hasn’t changed. Useful if you want to have meaningful value graphs in history or want to create an automation that triggers on every incoming state message (not only when the sensor’s new state is different to the current one).

    icon?: string

    Icon to use for the entity in the frontend. Should be a Material Design Icon (format: mdi:icon-name).

    json_attributes_template?: string

    Template to extract the JSON dictionary from the json_attributes_topic.

    name?: string

    The name of the entity. This will be used for the entity name in the Home Assistant UI. Can be set to null if only the device name is relevant.

    object_id?: string

    Used instead of name for automatic generation of entity_id.

    optimistic?: boolean

    Flag that defines if the cover works in optimistic mode. Default: true if no state topic defined, else false.

    origin?: OriginConfiguration

    Information about the application that is the origin of the component.

    payload_close?: string

    The payload to close the cover. Default: "CLOSE".

    payload_open?: string

    The payload to open the cover. Default: "OPEN".

    payload_stop?: string

    The payload to stop the cover. Default: "STOP".

    position_closed?: number

    Number which represents the fully-closed position. Default: 0.

    position_open?: number

    Number which represents the fully-open position. Default: 100.

    position_template?: string

    A template to render the position received on position_topic.

    qos?: number

    The maximum QoS level to be used when receiving and publishing messages. Default is 0.

    retain?: boolean

    Defines if published messages should have the retain flag set. Default: false.

    set_position_template?: string

    A template to render the value sent to set_position_topic.

    state_closed?: string

    The payload received on state_topic that represents a closed cover. Default: "closed".

    state_closing?: string

    The payload received on state_topic that represents a closing cover. Default: "closing".

    state_open?: string

    The payload received on state_topic that represents an open cover. Default: "open".

    state_opening?: string

    The payload received on state_topic that represents an opening cover. Default: "opening".

    state_stopped?: string

    The payload received on state_topic that represents a stopped cover. Default: "stopped".

    tilt_closed_value?: number

    The tilt value that represents a fully-closed tilt. Default: value of tilt_min.

    tilt_max?: number

    The maximum tilt value. Default: 100.

    tilt_min?: number

    The minimum tilt value. Default: 0.

    tilt_opened_value?: number

    The tilt value that represents a fully-open tilt. Default: value of tilt_max.

    unique_id?: string

    An ID that uniquely identifies this entity. If two entities have the same unique ID, Home Assistant will raise an exception. Required when used with device-based discovery.

    value_template?: string

    Defines a template to extract the value from the payload. Useful when the payload isn't a simple value.

    Settings
    Member Visibility

    On This Page
    Properties