mqtt2ha
    Preparing search index...

    Interface SirenInfo

    Configuration interface for a siren component

    interface SirenInfo {
        availability?: AvailabilityConfiguration;
        available_tones?: string[];
        component: "siren";
        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_off?: string;
        payload_on?: string;
        qos?: number;
        retain?: boolean;
        state_off?: string;
        state_on?: string;
        support_duration?: boolean;
        support_volume_set?: boolean;
        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? available_tones? component device? device_class? enabled_by_default? entity_category? expire_after? force_update? icon? json_attributes_template? name? object_id? optimistic? origin? payload_off? payload_on? qos? retain? state_off? state_on? support_duration? support_volume_set? unique_id? value_template?
    availability?: AvailabilityConfiguration

    Configures the availability settings of the entity.

    available_tones?: string[]

    A list of available tones the siren supports. When set, enables the selection of a tone.

    component: "siren"

    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

    If true, assumes state changes immediately without waiting for confirmation. Default is false.

    origin?: OriginConfiguration

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

    payload_off?: string

    The payload to publish to turn the siren off. Default is "OFF".

    payload_on?: string

    The payload to publish to turn the siren on. Default is "ON".

    qos?: number

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

    retain?: boolean

    Whether to retain the last published state. Default is false.

    state_off?: string

    The payload received on state_topic that represents an OFF state. Default is "OFF".

    state_on?: string

    The payload received on state_topic that represents an ON state. Default is "ON".

    support_duration?: boolean

    Whether the siren supports a duration parameter when turned on. Default is true.

    support_volume_set?: boolean

    Whether the siren supports a volume parameter when turned on. Default is true.

    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