Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Add Iotty #29624

Merged
merged 26 commits into from
Jul 22, 2024
Merged
Changes from all commits
Commits
Show all changes
26 commits
Select commit Hold shift + click to select a range
7e32b5b
Added iotty documentation
pburgio Oct 31, 2023
f42e0b7
Merge branch 'current' into iotty-initial-docs
pburgio Nov 1, 2023
ef8c5c3
Merge branch 'next' into iotty-initial-docs
pburgio Nov 2, 2023
1018c53
Merge branch 'next' into iotty-initial-docs
pburgio Nov 3, 2023
241037c
Merge branch 'next' into iotty-initial-docs
pburgio Nov 5, 2023
fddea58
Merge branch 'next' into iotty-initial-docs
pburgio Nov 6, 2023
b6f1b32
Merge branch 'next' into iotty-initial-docs
pburgio Nov 9, 2023
2f2eee3
Merge branch 'next' into iotty-initial-docs
pburgio Nov 13, 2023
656da8c
Merge branch 'next' into iotty-initial-docs
pburgio Nov 13, 2023
dfdc39e
Merge branch 'next' into iotty-initial-docs
pburgio Nov 20, 2023
764d12e
Merge branch 'next' into iotty-initial-docs
pburgio Nov 20, 2023
a119543
Merge branch 'next' into iotty-initial-docs
pburgio Nov 26, 2023
df481b4
Merge branch 'next' into iotty-initial-docs
pburgio Nov 30, 2023
6abce65
Merge branch 'next' into iotty-initial-docs
pburgio Dec 10, 2023
d811a11
Update release version and add header to supported devices section
c0ffeeca7 Jul 19, 2024
97c04ed
Add config flow
c0ffeeca7 Jul 19, 2024
25e8a08
add platform and integrration type to header
c0ffeeca7 Jul 19, 2024
fdf3988
Update source/_integrations/iotty.markdown
c0ffeeca7 Jul 19, 2024
3bebbe0
Add switch to category
c0ffeeca7 Jul 19, 2024
37d45fe
move config_flow up
c0ffeeca7 Jul 19, 2024
60ecac0
Update source/_integrations/iotty.markdown
c0ffeeca7 Jul 19, 2024
1c45070
Update source/_integrations/iotty.markdown
c0ffeeca7 Jul 19, 2024
cfa07b3
Add prerequisites, fix links so they are in markdown style, and add s…
shapournemati-iotty Jul 22, 2024
c5df637
fix spelling of Home Assistant
shapournemati-iotty Jul 22, 2024
b134bd3
Apply suggestions from code review
c0ffeeca7 Jul 22, 2024
9ddeb8b
Merge branch 'next' into iotty-initial-docs
pburgio Jul 22, 2024
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
49 changes: 49 additions & 0 deletions source/_integrations/iotty.markdown
Original file line number Diff line number Diff line change
@@ -0,0 +1,49 @@
---
title: iotty
description: "Instructions on how to connect iotty Smart Devices to Home Assistant."
ha_release: "2024.8"
ha_category:
- Switch
ha_iot_class: "Cloud Polling"
ha_quality_scale: no score
ha_config_flow: true
ha_codeowners:
- '@pburgio'
ha_domain: iotty
c0ffeeca7 marked this conversation as resolved.
Show resolved Hide resolved
ha_platforms:
- switch
ha_integration_type: hub
---

The iotty {% term integration%} lets you integrate iotty devices into Home Assistant. The iotty family includes the smart switch for lights and gates, the smart shades switch for blinds and shutters, and the smart outlet.

c0ffeeca7 marked this conversation as resolved.
Show resolved Hide resolved
c0ffeeca7 marked this conversation as resolved.
Show resolved Hide resolved

{% include integrations/config_flow.md %}

## Prerequisites

In order to use this integration, you must have an iotty account, and enter its credentials during account pairing.
To create an iotty account, you need to get the App from the [App Store](https://apps.apple.com/it/app/iotty-smart-home/id1230937401) or [Play Store](https://play.google.com/store/apps/details?id=com.dynamicait.iotty&hl=en).

## Supported devices
c0ffeeca7 marked this conversation as resolved.
Show resolved Hide resolved

This integration currently supports the following iotty devices:

- iotty Smart Switch \
US version:
- [1-Switch Controller](https://iottysmarthome.com/products/1-switch-controller?variant=43630747058389)
- [2-Switch Controller](https://iottysmarthome.com/products/2-switch-controller?variant=43630751219925)
- [3-Switch Controller](https://iottysmarthome.com/products/3-switch-controller?variant=43630760493269)
- [4-Switch Controller](https://iottysmarthome.com/products/4-switch-controller?variant=43630774386901)
EU version:
- [iotty Smart Switch](https://iotty.uk/collections/frontpage/products/iotty-smart-switch)
- [iotty Smart Switch (variant)](https://iotty.uk/collections/frontpage/products/iotty-smart-switch?variant=40820222460082)
- [iotty Plus Interruttore Intelligente](https://iotty.it/collections/frontpage/products/iotty-plus-interruttore-intelligente-per-luci-e-cancelli)

## Supported entities

Each iotty device gets mapped into one Home Assistant device per gang, each with its own Switch entity.
Copy link
Contributor

@c0ffeeca7 c0ffeeca7 Jul 22, 2024

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

what do you mean by "per gang"? group?

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Hi, "gang" is a pretty standard term used when referring to te single switches on a plate, as you can see in this wikipedia article: Light Switch.

I didn't want to reuse the word "Device" or "Switch" as it would be using the same word to define itself. Let me know if that is clear, or if you have any other suggestion to replace the word "gang"

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thank you for the explanation. Learned something today.


### Switches

The main, unnamed, switch entity controls the light switch, turning it on or off the gang related to it.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This sentence has incorrect grammar. I can't make a suggestion since it's not clear to me what meaning is meant.

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Hej Martin, thanks for the feedback. Since the PR has already been merged, what is the suggested course of action here? Open another PR to fix this? Wait for the next release in which some functionality will be added to my integration?

For what concerns the meaning, what I want to convey is:

  1. There is only one entity per device
  2. The main (and only) entity of the device is unnamed
  3. The switch entity is meant to control a light switch

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Please open a new PR and adjust the sentence.