A light entity for Homex

Implements a Homex.Entity. See module for available callbacks.

https://www.home-assistant.io/integrations/light.mqtt/

Options

• :name (String.t/0) - Required. the name of the entity

• :update_interval - the interval in milliseconds in which handle_timer/1 get's called. Can also be :never to disable the timer callback The default value is :never.

• :modes - a list of supported light modes. Available: [brightness] The default value is [].

• :retain (boolean/0) - if the last state should be retained The default value is true.

Overridable Functions

The following functions can be overridden in your entity:

• handle_init/1 - From Homex.Entity
• handle_timer/1 - From Homex.Entity
• handle_on/1 - From Homex.Entity.Light
• handle_off/1 - From Homex.Entity.Light
• handle_brightness/1 - From Homex.Entity.Light

Default Implementations

All overridable functions have safe default implementations that return the entity unchanged. You only need to override the functions you want to customize.

Example

defmodule MyLight do
  use Homex.Entity.Light, name: "my-light", modes: [:brightness]

  def handle_brightness(entity, brightness) do
    IO.puts("Light set to #{brightness}%")
    entity
  end
end