Skip to content
Closed
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
58 commits
Select commit Hold shift + click to select a range
4d32dcf
Linked entities for HomeKit valve duration characteristics (#40222)
fabiandev Aug 1, 2025
ae3dfc9
Add sensor to Qbus integration (#40130)
thomasddn Aug 2, 2025
f481684
Add direct message notifier to PlayStation Network (#40249)
tr4nt0r Aug 3, 2025
f808556
Add jitter sensor to Ping integration (#40259)
jpbede Aug 4, 2025
3f4c977
Update Telegram bot events (#39983)
hanwg Aug 4, 2025
be12f7e
Add zeroconf to Homee (#40246)
Taraman17 Aug 4, 2025
afa5b1e
Reset cutting blade usage time in Husqvarna Automower (#40260)
Thomas55555 Aug 4, 2025
61eb9d8
Add support for Inkbird IAM-T2 (#40314)
bdraco Aug 7, 2025
038cb59
Remove linear_garage_door integration docs (#40302)
gjohansson-ST Aug 8, 2025
f02077a
Document select platform for LetPot integration (#40323)
jpelgrom Aug 8, 2025
e640f8a
Document `layout: auto` for "energy-sankey" card (#40322)
MindFreeze Aug 8, 2025
fdb4bd9
Add absolute humidity to Awair documentation (#40304)
mbo18 Aug 8, 2025
6e8eeab
Add ToGrill documentation (#40291)
elupus Aug 8, 2025
d603675
Add binary_sensor to UISP airOS (#40242)
CoMPaTech Aug 9, 2025
352bb7f
Add event platform to Husqvarna Automower (#39863)
Thomas55555 Aug 9, 2025
0d2a358
Remove Mercury NZ Limited from docs (#40348)
tronikos Aug 10, 2025
46cc580
Add documentation for humidity control Huum (#40356)
vincentwolsink Aug 10, 2025
e961ac7
Update solarlog documentation for new sensors (#40366)
dontinelli Aug 10, 2025
b6f1c27
Support `multiple` for StateSelector (#39419)
karwosts Aug 11, 2025
f0e8c2b
Smarla integration doc sensor platform (#39276)
rlint-explicatis Aug 11, 2025
3cc7648
Add fan-direction dashboard feature documentation (#40367)
pcan08 Aug 11, 2025
5e837f8
Add media browsing to Russound RIO (#39876)
noahhusby Aug 11, 2025
a3925c1
add valve entity (#40387)
zzysszzy Aug 12, 2025
bd36e68
Add notify entity for Telegram bot (#40284)
hanwg Aug 12, 2025
4cf008c
Add valve open/close card feature (#40372)
timmo001 Aug 12, 2025
84e9372
Add a note on new `number` platform for `airq` integration (#40390)
Sibgatulin Aug 12, 2025
ee7a78f
Update Snapcast to remove references to old join/unjoin actions (#39568)
mill1000 Aug 12, 2025
9056377
Document `not` and `location` conditions. (#40396)
karwosts Aug 13, 2025
3647de8
Add party-related entities to Habitica integration (#40203)
tr4nt0r Aug 13, 2025
5d1e513
Add Sleep as Android integration (#38465)
tr4nt0r Aug 13, 2025
321cf14
Add valve postion card feature (#40393)
timmo001 Aug 13, 2025
70dd5d4
Extend UnitOfApparentPower with 'mVA' (#40381)
lboue Aug 13, 2025
89cd21e
Switchbot Cloud: Add cover entity description 0718 (#40060)
XiaoLing-git Aug 14, 2025
24d4e7d
Extend UnitOfReactivePower with 'mvar' (#40377)
lboue Aug 14, 2025
062d98b
Add enphase envoy collar and combiner descriptions (#40452)
catsmanac Aug 15, 2025
04eb987
Add binary sensor to 1-Wire DS2405 (#40455)
epenet Aug 15, 2025
0d76435
Add additional sensors for airOS (#40467)
CoMPaTech Aug 16, 2025
8eee346
Add binary sensor platform to qbus integration (#40273)
thomasddn Aug 16, 2025
e18423f
Add Sonos speech enhancement select (#40453)
PeteRager Aug 17, 2025
32c7c4b
Add mention of number entity (#40426)
elupus Aug 18, 2025
46190c5
Add documentation for new extra attributes for fyta (#40410)
dontinelli Aug 18, 2025
8e72596
Add date card feature docs (#40441)
timmo001 Aug 18, 2025
717bd96
Add bronze quality scale to Mastodon (#40491)
andrew-codechimp Aug 18, 2025
a08b300
Updated the list of models supported by YoLink integration (#40510)
matrixd2 Aug 19, 2025
40f89f1
Add mention of event entity (#40488)
elupus Aug 19, 2025
0dea6db
Update todo-list.markdown (#40473)
karwosts Aug 20, 2025
2aa28af
Add fan-oscillate dashboard feature documentation (#40403)
pcan08 Aug 20, 2025
0797710
Add history chart card feature docs (#40461)
MindFreeze Aug 20, 2025
c0b0b46
Add configuration for analog clock style
timmo001 Aug 20, 2025
9ad5327
Change to standard config
timmo001 Aug 20, 2025
5a36085
Fix
timmo001 Aug 20, 2025
b9a115a
Fix
timmo001 Aug 20, 2025
c812bd6
Make lists
timmo001 Aug 20, 2025
24d2f60
Add examples
timmo001 Aug 20, 2025
81a09fe
Add example with title
timmo001 Aug 20, 2025
f9bc84d
Crop
timmo001 Aug 20, 2025
e215da1
Fix
timmo001 Aug 20, 2025
520eb78
Typo
timmo001 Aug 20, 2025
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
120 changes: 111 additions & 9 deletions source/_dashboards/clock.markdown
Original file line number Diff line number Diff line change
Expand Up @@ -19,21 +19,73 @@ Screenshot of the clock card

All options for this card can be configured via the user interface.


## Card settings

{% configuration_basic %}
Title:
{% configuration %}
title:
description: Adds a title to the top of the card
Clock Size:
type: string
required: false
clock_style:
description: Allows the clock to be displayed in a digital or analog style. Defaults to digital.
type: list
required: false
default: digital
keys:
digital:
description: Digital clock style.
analog:
description: Analog clock style.
clock_size:
description: Adjusts the size of the text allowing a wider range of use with different types of dashboards. Defaults to small.
Display Seconds:
type: list
required: false
default: small
keys:
small:
description: Small clock size.
medium:
description: Medium clock size.
large:
description: Large clock size.
show_seconds:
description: Shows seconds alongside the clock, providing the time format is in a 12-hour format.
Time Format:
type: boolean
required: false
default: false
time_format:
description: Allows the time format to be changed on a per-card level. Defaults to the user profile setting.
Time Zone:
type: string
required: false
time_zone:
description: Change the timezone used for the time on a per-card level. Defaults to the user profile setting.
{% endconfiguration_basic %}
type: string
required: false
analog_options:
description: When using the analog clock style, this allows the user to configure the appearance of the clock.
type: map
required: false
keys:
border:
description: Shows a border around the clock face. Defaults to false.
type: boolean
required: false
default: false
ticks:
description: Shows ticks (indices) on the clock face. Defaults to hour.
type: list
required: false
default: hour
keys:
none:
description: No ticks are shown.
quarter:
description: Quarter hour ticks are shown.
hour:
description: Hour ticks are shown.
minute:
description: Minute ticks are shown.
{% endconfiguration %}

### Examples

Expand All @@ -48,7 +100,6 @@ type: clock
Screenshot of the basic clock card
</p>


Example of a larger clock card for tablet dashboards:

```yaml
Expand Down Expand Up @@ -107,3 +158,54 @@ title: New York 🦅
<img src='/images/dashboards/clock_card_new_york.png' alt='Screenshot of a medium sized, 12 hour clock showing am/pm and seconds based in New York along with a title'>
Screenshot of a medium sized, 12 hour clock showing am/pm and seconds based in New York along with a title
</p>

Analog clock with no border and hour ticks:

```yaml
type: clock
clock_style: analog
clock_size: medium
analog_options:
border: false
ticks: hour
```

<p class='img'>
<img src='/images/dashboards/clock_card_analog_hour_ticks.png' alt='Screenshot of a medium sized, analog clock and hour ticks'>
Screenshot of a medium sized, analog clock and hour ticks
</p>

Analog clock with border and minute ticks showing seconds:

```yaml
type: clock
clock_style: analog
clock_size: medium
show_seconds: true
analog_options:
border: true
ticks: minute
```

<p class='img'>
<img src='/images/dashboards/clock_card_analog_minute_ticks_border.png' alt='Screenshot of a medium sized, analog clock and minute ticks showing seconds'>
Screenshot of a medium sized, analog clock and minute ticks showing seconds
</p>

Analog clock with a title, no ticks and border with seconds:

```yaml
type: clock
clock_style: analog
clock_size: medium
show_seconds: true
analog_options:
border: true
ticks: none
title: Mountain Time
```

<p class='img'>
<img src='/images/dashboards/clock_card_analog_no_ticks_border_title_mountain_time.png' alt='Screenshot of a medium sized, analog clock with a title, no ticks and border showing seconds'>
Screenshot of a medium sized, analog clock with a title, no ticks and border showing seconds
</p>
47 changes: 46 additions & 1 deletion source/_dashboards/conditional.markdown
Original file line number Diff line number Diff line change
Expand Up @@ -198,9 +198,31 @@ users:
type: list
{% endconfiguration %}

### Location

Specify the visibility of the card based on the current user's current location. The location is based on the state of the `person` entity associated with the current user. If the current user does not have a `person` entity, this condition will always resolve to false.

```yaml
condition: location
locations:
- home
- Home Neigborhood
```

{% configuration %}
condition:
required: true
description: "`location`"
type: string
locations:
required: true
description: A list of zones, which if any match the current state of the `person`, will cause this condition to be true.
type: list
{% endconfiguration %}

### And

Specify that both conditions must be met.
Specify that all conditions must be met.

```yaml
condition: and
Expand Down Expand Up @@ -248,4 +270,27 @@ conditions:
type: list
{% endconfiguration %}

### Not

Specify that at least one of the conditions must not be met.

```yaml
condition: not
conditions:
- condition: numeric_state
above: 0
- condition: user
users:
- 581fca7fdc014b8b894519cc531f9a04
```

{% configuration %}
condition:
required: true
description: "`not`"
type: string
conditions:
required: false
description: List of conditions to check. See [available conditions](#conditions-options).
type: list
{% endconfiguration %}
3 changes: 2 additions & 1 deletion source/_dashboards/energy.markdown
Original file line number Diff line number Diff line change
Expand Up @@ -259,8 +259,9 @@ title:
type: string
layout:
required: false
description: "`vertical` or `horizontal`. Determines the orientation (flow direction) of the card"
description: "`vertical`, `horizontal` or `auto`. Determines the orientation (flow direction) of the card. `auto` changes it based on the screen size."
type: string
default: auto
group_by_area:
required: false
description: Whether to group the devices by area
Expand Down
5 changes: 5 additions & 0 deletions source/_dashboards/todo-list.markdown
Original file line number Diff line number Diff line change
Expand Up @@ -76,6 +76,11 @@ display_order:
description: "Optionally sorts the items in the to-do list for display. Options are: `none`: Show the list in its original order. `alpha_asc`: Sort the list in alphabetical order. `alpha_desc`: Sort the list in reverse alphabetical order. `duedate_asc`: Sort the list by due date (soonest first). `duedate_desc`: Sort the list by reverse due date (soonest last)."
type: string
default: "none"
item_tap_action:
required: false
description: "Defines the behavior when an item's body is clicked. Options are: `edit` (opens the edit dialog), `toggle` (marks or unmarks the item as completed, hiding the edit dialog)."
type: string
default: "edit"
{% endconfiguration %}

### Examples
Expand Down
10 changes: 8 additions & 2 deletions source/_docs/blueprint/selectors.markdown
Original file line number Diff line number Diff line change
Expand Up @@ -1414,7 +1414,7 @@ would return ["Green"] and in the last example it returns ["g"].
## State selector

The state selector shows a list of states for a provided entity of which
one can be selected.
one or more can be selected.

![Screenshot of an state selector](/images/blueprints/selector-state.png)

Expand All @@ -1427,10 +1427,16 @@ hide_states:
description: The states to exclude from the list of options
type: list
required: false
multiple:
description: >
Allows selecting multiple states. If set to `true`, the resulting value of
this selector will be a list instead of a single string value.
type: boolean
default: false
{% endconfiguration %}

The output of this selector is the select state (not the translated or
prettified name shown in the frontend).
prettified name shown in the frontend), or a list of states if `multiple` is true.

For example: `heat_cool`.

Expand Down
43 changes: 40 additions & 3 deletions source/_integrations/airos.markdown
Original file line number Diff line number Diff line change
Expand Up @@ -19,8 +19,9 @@ Ubiquiti <abbr title="Ubiquity Internet Service Provider">UISP</abbr>-range of [

A common use-case is establishing wireless <abbr title="Point-to-Point">PtP</abbr> or <abbr title="Point-to-Multi-Point">PtMP</abbr> links between buildings, remote sites, neighbours or even your shed. This is highly advantageous when traditional fiber-optic or copper network cabling is either impractical or the distance is too far for copper cabling. With <abbr title="Line-of-sight">LoS</abbr> between airOS devices, a stable and high-bandwidth "beam" can be established, eliminating any need for additional infrastructure. This can be an improvement over extending your WiFi coverage using meshing of Access Points, as meshing potentially reduces the capacity and performance of your WiFi network.

There is currently support for the following plaforms within Home Assistant:
There is currently support for the following platforms within Home Assistant:

- [Binary sensor](#binary-sensor)
- [Sensor](#sensor)

This integration allows users to pull network metrics and statuses directly into their Home Assistant dashboards, enabling advanced automation, notifications, and comprehensive network oversight within their smart home ecosystem.
Expand Down Expand Up @@ -65,14 +66,46 @@ For stations in particular, they can operate in either a 'Bridge' or 'Router' ro

The choice between Bridge and Router mode depends on the network architecture and whether the device is intended to extend an existing network (Bridge) or create a new subnet (Router).

## Sensor
## Binary sensor

### Port forwarding

Active if any port forwarding is enabled when operating in 'router' mode.

### DHCP client

Active if the device configured to use DHCP for its network settings, inactive if IP address is statically assigned.

### DHCP server

Active if the device itself is configured and acting as a DHCP server.

### DHCPv6 server

Active if the device itself is configured and acting as a DHCP server for IPv6.

### PPPoE

This integration exposes the following sensor entities for your airOS devices:
Active if the device is configured for PPPoE and the PPPoE link state is active.

## Sensor

### Network Role

Indicates the role of the device in your network, either 'bridge' or 'router' (see [operating roles](#operating-roles) for more information.

### Wireless Role

Indicates the role of the device in relation to your wireless network, either 'Access point' or 'Station'.

### Wireless Mode

Indicates the mode your device is in 'point-to-point' just two devices connecting to eachother or 'point-to-multipoint' for multiple devices connecting to this device.

### Wireless Distance

The reported distance between your devices.

### Wireless Frequency

The base frequency set for this device.
Expand All @@ -93,6 +126,10 @@ These sensors show the actual data transfer rate (receive and transmit) for this

Performance in <abbr title="decibels">dB</abbr> for the device antenna. See [Gain](https://en.wikipedia.org/wiki/Gain_(antenna)) on Wikipedia.

### Uptime

Time since the device was last started.

## Data updates

Data is polled from devices every 60 seconds.
Expand Down
5 changes: 5 additions & 0 deletions source/_integrations/airq.markdown
Original file line number Diff line number Diff line change
Expand Up @@ -14,6 +14,7 @@ ha_domain: airq
ha_config_flow: true
ha_platforms:
- sensor
- number
ha_integration_type: hub
---

Expand Down Expand Up @@ -96,6 +97,10 @@ After the integration has been initialized, the user can configure any of the fo

- **Clip negative values**. Default: `on`. For baseline calibration purposes, certain sensor values may briefly become negative. The default behavior is to clip such values to 0.

## LED Control

In addition to sensor readings, this integration exposes the brightness of the device’s LED strips as a `number` entity named `number.<device_name>_led_brightness`. You can set the brightness (0–100) manually from the Overview panel or in automations. Setting it to 0 will turn the LEDs off.

## Troubleshooting

For troubleshooting or when reporting an issue, please enable [debug logging](/docs/configuration/troubleshooting/#debug-logs-and-diagnostics) and restart the integration. As soon as the issue reoccurs stop the debug logging, which will trigger the download of the debug log file.
Expand Down
5 changes: 3 additions & 2 deletions source/_integrations/awair.markdown
Original file line number Diff line number Diff line change
Expand Up @@ -7,8 +7,8 @@ ha_config_flow: true
ha_release: 0.84
ha_iot_class: Local Polling
ha_codeowners:
- '@ahayworth'
- '@danielsjf'
- "@ahayworth"
- "@danielsjf"
ha_domain: awair
ha_platforms:
- sensor
Expand Down Expand Up @@ -39,6 +39,7 @@ The integration will fetch data from each device. The following sensors are supp
- Temperature
- Humidity
- Dew point
- Absolute humidity
- Carbon dioxide
- Total volatile organic compounds
- PM2.5 density
Expand Down
Loading