Skip to content

Latest commit

 

History

History
157 lines (117 loc) · 3.94 KB

gryfsmart.markdown

File metadata and controls

157 lines (117 loc) · 3.94 KB
title description ha_release ha_category ha_iot_class ha_config_flow ha_domain ha_platforms ha_codeowners ha_integration_type
GryfSmart
Instructions on how to integrate GryfSmart components with Home Assistant.
2025.1
Binary sensor
Climate
Sensor
Switch
Light
Local Pushing
true
gryfsmart
Binary sensor
Climate
Sensor
Switch
Light
binary_sensor
@karlowiczpl
hub

The GryfSmart integration for Home Assistant allows you to connect to GryfSmart devices

This document describes how to configure and use the GryfSmart integration. The integration supports Config Flow (UI-based setup), and requires an RS-232 interface.

There is currently support for the following device types within Home Assistant:

  • Light
  • Switch
  • Thermostat
  • Binary Input
  • PWM
  • Thermometer
  • Input

{% include integrations/config_flow.md %}

1. Important Integration Information

1.1 How to Use the ID

The ID is a combination of the driver ID and the cell number (for outputs, inputs, etc.).

Example: 17

  • 1 is the driver ID
  • 7 is the cell number

1.2 Communication

To connect GryfSmart, you can use either a Physical RS-232 connection or a USB/RS-232 converter. You need to know the address of the device. Typically, it is "/dev/ttyS0" for a physical RS-232 port, or "/dev/ttyUSB0" for a converter.

1.3 Module Count

The module count is the number of modules in the network.

1.4 Entities

{% note %}

GryfSmart driver supports 5 types of functions:

  • Relay Output (O)
  • Input (I)
  • PWM
  • Temperature Input (T)
  • Cover Output

{% endnote %}

1.4.1 Light

  • Type of function: Relay Output
  • Services: turn_on, turn_off
  • Icon: lightbulb
  • Entity type: light
  • Configuration scheme: classic
  • Device class: None

1.4.2 Switch

  • Type of function: Relay Output
  • Services: turn_on, turn_off, toggle
  • Icon: switch, outlet
  • Entity type: switch
  • Device class: switch, outlet
  • Default device class: switch

1.4.3 Thermostat

  • Type of function: Relay Output and Temperature Input

  • Services: turn_on, turn_off, toggle, set_temperature

  • Entity type: climate In Config Flow, you enter the t_id into the "extra" parameter and the o_id into the "id" parameter.

  • Device class: None

1.4.4 Binary Input

  • Type of function: Input
  • Services: None
  • Icon: Specific for the chosen device class
  • Entity type: binary_sensor
  • Device class: door, garage_door, heat, light, motion, window, smoke, sound, power
  • Default device class: opening

1.4.5 PWM

  • Type of function: PWM
  • Services: turn_on, turn_off, toggle, set_value
  • Icon: lightbulb
  • Entity type: light
  • Device class: None

1.4.6 Thermometer

  • Type of function: Temperature Input
  • Services: None
  • Icon: thermometer
  • Entity type: sensor
  • Device class: None

1.4.7 Input

  • Type of function: Input
  • Services: None
  • Icon: switch
  • Entity type: sensor
  • Device class: None
  • Extra information:
    If the input is a short press and release, the sensor state is 2; if it is a long press, the state is 3.

2. Configuration via Config Flow

The "extra" parameter corresponds to the device_class if it exists. In the case of a thermostat, the "extra" parameter maps to t_id instead. Otherwise, this parameter is not required. Additionally, the integration supports editing of individual devices and configuration. Please note that after making changes, you must reload the integration for the changes to take effect.

4. Helper Entities

Additionally, the configuration automatically generates two entities—gryf_in and gryf_out. The gryf_in entity receives incoming messages, and the gryf_out entity handles outgoing messages. However, if you are not an experienced GryfSmart installer, you may ignore these details.