Skip to content

Commit a922a99

Browse files
author
Frank Klaassen
committed
Add hardware-conditional entities to Peblar docs
Documents new entities added in home-assistant/core#169188: buzzer volume and LED brightness selects, socket lock binary sensor, unlock socket button, and keep socket locked switch.
1 parent 1416194 commit a922a99

1 file changed

Lines changed: 48 additions & 3 deletions

File tree

source/_integrations/peblar.markdown

Lines changed: 48 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -94,20 +94,31 @@ to enable them first. See the [enabling or disabling entities](/common-tasks/gen
9494
documentation for information on how to do this.
9595
{% endimportant %}
9696

97+
- **Socket lock**: Indicates whether the socket of the charger is currently locked. When this sensor is on ({% term state %}: `on`), the socket is locked; when it is off ({% term state %}: `off`), the socket is unlocked.
98+
99+
{% note %}
100+
The **Socket lock** binary sensor is only available on Peblar chargers that are equipped with a socket.
101+
{% endnote %}
102+
97103
### Buttons
98104

99105
The buttons provided by this integration can be used to trigger an action on
100106
the charger. The following buttons are available:
101107

102108
- **Identify**: This button can be used to identify the charger. This can be useful if you have multiple chargers and want to identify which one is which. Once pressed, the LED on the charger will start blinking for a few seconds.
103109
- **Restart**: This button can be used to restart the charger. This can be useful if the charger is not responding as expected.
110+
- **Unlock socket**: This button unlocks the socket on the charger, allowing you to manually release the connector. This is useful when the socket is locked and you need to disconnect your vehicle.
104111

105112
{% important %}
106113
These buttons are disabled by default. If you want to use them, you need
107114
to enable them first. See the [enabling or disabling entities](/common-tasks/general/#enabling-or-disabling-entities)
108115
documentation for information on how to do this.
109116
{% endimportant %}
110117

118+
{% note %}
119+
The **Unlock socket** button is only available on Peblar chargers that are equipped with a socket.
120+
{% endnote %}
121+
111122
### Numbers
112123

113124
This integration provides a single number entity: **Charge limit**.
@@ -118,9 +129,38 @@ The minimum value for this entity is 6A, and the maximum value is depending on y
118129

119130
### Selects
120131

121-
This integration provides a single select entity: **Smart charging**.
132+
This integration provides the following select entities.
133+
134+
#### Buzzer volume
135+
136+
The **Buzzer volume** select entity controls the volume level of the charger's built-in buzzer. The following options are available:
122137

123-
It reflects the same smart charging state as is shown on the charger's local web interface, and allows you to control the charging behavior of the charger.
138+
- **Off** ({% term state %}: `off`): The buzzer is disabled.
139+
- **Low** ({% term state %}: `low`): The buzzer plays at a low volume.
140+
- **Medium** ({% term state %}: `medium`): The buzzer plays at a medium volume.
141+
- **High** ({% term state %}: `high`): The buzzer plays at a high volume.
142+
143+
{% note %}
144+
The **Buzzer volume** select entity is only available on Peblar chargers that are equipped with a buzzer.
145+
{% endnote %}
146+
147+
#### LED brightness
148+
149+
The **LED brightness** select entity controls the brightness of the status LED on the charger. The following options are available:
150+
151+
- **Automatic** ({% term state %}: `automatic`): The charger automatically adjusts the LED brightness based on ambient light conditions.
152+
- **Bright** ({% term state %}: `bright`): The LED is set to its maximum brightness.
153+
- **Medium** ({% term state %}: `medium`): The LED is set to a medium brightness.
154+
- **Dim** ({% term state %}: `dim`): The LED is set to a low brightness.
155+
- **Off** ({% term state %}: `off`): The LED is turned off.
156+
157+
{% note %}
158+
The **LED brightness** select entity is only available on Peblar chargers that support LED brightness control.
159+
{% endnote %}
160+
161+
#### Smart charging
162+
163+
The **Smart charging** select entity reflects the same smart charging state as is shown on the charger's local web interface, and allows you to control the charging behavior of the charger.
124164

125165
The following options are available:
126166

@@ -193,15 +233,20 @@ documentation for information on how to do this.
193233

194234
### Switches
195235

196-
This integration provides two switch entities:
236+
This integration provides the following switch entities:
197237

198238
- **Charge**: This switch allows you to start or stop/pause the charging of your electric vehicle. This can be helpful if you want to temporarily stop charging your electric vehicle, for example, to avoid charging during expensive peak hours.
199239
- **Force single phase**: This switch can be used to force the charger to use a single phase for charging your electric vehicle. This can be useful if you want to limit your current draw from the charger to a single phase, for example, to prevent overloading your electrical installation.
240+
- **Keep socket locked**: When enabled, the charger keeps the socket locked when no electric vehicle is connected. This can help prevent unauthorized use of the charger.
200241

201242
{% note %}
202243
The **Force single phase** switch is only available if your charger is connected to multiple phases. If your charger is connected to a single-phase power source, this switch will not be created.
203244
{% endnote %}
204245

246+
{% note %}
247+
The **Keep socket locked** switch is only available on Peblar chargers that are equipped with a socket.
248+
{% endnote %}
249+
205250
### Updates
206251

207252
The Peblar integration provides two update entities for the Peblar charger:

0 commit comments

Comments
 (0)