diff --git a/components/ble_client.rst b/components/ble_client.rst index 53d38f63f..44b2c03d2 100644 --- a/components/ble_client.rst +++ b/components/ble_client.rst @@ -97,7 +97,7 @@ This automation is triggered when the client disconnects from a BLE device. ------------------------------- This action triggers a write to a specified BLE characteristic. The write is attempted in -a best-effort fashion and will only succeed if the `ble_client`'s connection has been +a best-effort fashion and will only succeed if the ``ble_client``'s connection has been established and the peripheral exposes the expected BLE service and characteristic. Example usage: diff --git a/components/climate/bedjet.rst b/components/climate/bedjet.rst index e7e38abcc..1af5220eb 100644 --- a/components/climate/bedjet.rst +++ b/components/climate/bedjet.rst @@ -68,10 +68,10 @@ From :ref:`lambdas `, you can call methods to do some advanced st - lambda: |- id(bedjet_1).upgrade_firmware(); -``bedjet`` Climate Platform ---------------------------- +``bedjet`` Climate +------------------ -The `climate` platform exposes the BedJet's climate-related functionality, including +The ``climate`` platform exposes the BedJet's climate-related functionality, including setting the mode and target temperature. .. code-block:: yaml @@ -89,12 +89,15 @@ Configuration variables: - **name** (**Required**, string): The name of the climate device. - **bedjet_id** (**Required**, :ref:`config-id`): The ID of the Bedjet component. - **heat_mode** (*Optional*, string): The primary heating mode to use for ``HVACMode.HEAT``: - - ``"heat"`` (Default) - Setting ``hvac_mode=heat`` uses the BedJet "HEAT" mode. - - ``"extended"`` - Setting ``hvac_mode=heat`` uses BedJet "EXT HEAT" mode. - - Whichever is not selected will be made available as a custom preset. + + - ``heat`` (Default) - Setting ``hvac_mode=heat`` uses the BedJet "HEAT" mode. + - ``extended`` - Setting ``hvac_mode=heat`` uses BedJet "EXT HEAT" mode. + + Whichever is not selected will be made available as a custom preset. + - All other options from :ref:`Climate `. -- ``.send_local_time``: If `time_id` is set, attempt to sync the clock now. +- ``.send_local_time``: If ``time_id`` is set, attempt to sync the clock now. .. code-block:: yaml @@ -106,7 +109,7 @@ Configuration variables: - lambda: |- id(my_bedjet_fan).send_local_time(); -- ``.set_clock``: Set the BedJet clock to a specified time; works with or without a `time_id`. +- ``.set_clock``: Set the BedJet clock to a specified time; works with or without a ``time_id``. .. code-block:: yaml diff --git a/components/esp32_camera.rst b/components/esp32_camera.rst index 678cb87ca..73e402401 100644 --- a/components/esp32_camera.rst +++ b/components/esp32_camera.rst @@ -151,7 +151,7 @@ Automations: - **on_stream_start** (*Optional*, :ref:`Automation `): An automation to perform when a stream starts. -- **on_stream_end** (*Optional*, :ref:`Automation `): An automation to perform +- **on_stream_stop** (*Optional*, :ref:`Automation `): An automation to perform when a stream stops. Test Setting: diff --git a/components/media_player/i2s_audio.rst b/components/media_player/i2s_audio.rst index 981d150fb..7d01e3bf3 100644 --- a/components/media_player/i2s_audio.rst +++ b/components/media_player/i2s_audio.rst @@ -23,7 +23,7 @@ via the I2S bus. This platform only works on ESP32 based chips. Configuration variables: ------------------------ -- **dac_type** (**Required**, enum) +- **dac_type** (**Required**, enum): - ``external``: Use an external DAC, for example the NS4168, or UDA1334A. - ``internal``: Use the internal DAC diff --git a/components/output/dac7678.rst b/components/output/dac7678.rst index 440dfeb1c..01ed69e15 100644 --- a/components/output/dac7678.rst +++ b/components/output/dac7678.rst @@ -45,8 +45,8 @@ Configuration variables: .. _dac7678-output: -DAC Output ----------- +DAC7678 Output +-------------- The DAC7678 output component exposes a DAC7678 DAC channel of a global :ref:`DAC7678 hub ` as a float diff --git a/components/sensor/sgp4x.rst b/components/sensor/sgp4x.rst index 404b3ae79..8d49d2ff3 100644 --- a/components/sensor/sgp4x.rst +++ b/components/sensor/sgp4x.rst @@ -5,8 +5,8 @@ SGP40 Volatile Organic Compound Sensor and SGP41 VOC and NOx Sensor :description: Instructions for setting up SGP40/SGP41 Volatile Organic Compound and NOx sensor :image: sgp40.jpg -The ``sgp4x`` sensor platform allows you to use your Sensirion SGP40 -(`datasheet `__) or SGP41 +The ``sgp4x`` sensor platform allows you to use your Sensirion SGP40 +(`datasheet `__) or SGP41 (`datasheet `__) with ESPHome. The type of sensor used is automatically detected. The :ref:`I²C Bus ` is required to be set up in your configuration for this sensor to work. @@ -43,13 +43,13 @@ Configuration variables: - **id** (*Optional*, :ref:`config-id`): Manually specify the ID used for code generation. - **algorithm_tuning** (*Optional*): The VOC algorithm can be customized by tuning 6 different parameters. For more details see `Engineering Guidelines for SEN5x `__ - - **index_offset** (*Optional*): VOC index representing typical (average) conditions. Allowed values are in range 1..250. The default value is 100. + - **index_offset** (*Optional*): VOC index representing typical (average) conditions. Allowed values are in range 1..250. The default value is 100. - **learning_time_offset_hours** (*Optional*): Time constant to estimate the VOC algorithm offset from the history in hours. Past events will be forgotten after about twice the learning time. Allowed values are in range 1..1000. The default value is 12 hour - - **learning_time_gain_hours** (*Optional*): Time constant to estimate the VOC algorithm gain from the history in hours. Past events will be forgotten after about twice the learning time. Allowed values are in range 1..1000. The default value is 12 hours. + - **learning_time_gain_hours** (*Optional*): Time constant to estimate the VOC algorithm gain from the history in hours. Past events will be forgotten after about twice the learning time. Allowed values are in range 1..1000. The default value is 12 hours. - **gating_max_duration_minutes** (*Optional*): Maximum duration of gating in minutes (freeze of estimator during high VOC index signal). Zero disables the gating. Allowed values are in range 0..3000. The default value is 180 minutes - **std_initial** (*Optional*): Initial estimate for standard deviation. Lower value boosts events during initial learning period, but may result in larger device-todevice variations. Allowed values are in range 10..5000. The default value is 50. - - **gain_factor:** (*Optional*): Gain factor to amplify or to attenuate the VOC index output. Allowed values are in range 1..1000. The default value is 230. - + - **gain_factor** (*Optional*): Gain factor to amplify or to attenuate the VOC index output. Allowed values are in range 1..1000. The default value is 230. + - All other options from :ref:`Sensor `. @@ -58,13 +58,13 @@ Configuration variables: - **name** (**Required**, string): The name of the sensor. - **id** (*Optional*, :ref:`config-id`): Manually specify the ID used for code generation. - **algorithm_tuning** (*Optional*): The NOx algorithm can be customized by tuning 5 different parameters.For more details see `Engineering Guidelines for SEN5x `__ - - - **index_offset** (*Optional*): NOx index representing typical (average) conditions. Allowed values are in range 1..250. The default value is 100. + + - **index_offset** (*Optional*): NOx index representing typical (average) conditions. Allowed values are in range 1..250. The default value is 100. - **learning_time_offset_hours** (*Optional*): Time constant to estimate the NOx algorithm offset from the history in hours. Past events will be forgotten after about twice the learning time. Allowed values are in range 1..1000. The default value is 12 hour - - **learning_time_gain_hours** (*Optional*): Time constant to estimate the NOx algorithm gain from the history in hours. Past events will be forgotten after about twice the learning time. Allowed values are in range 1..1000. The default value is 12 hours. + - **learning_time_gain_hours** (*Optional*): Time constant to estimate the NOx algorithm gain from the history in hours. Past events will be forgotten after about twice the learning time. Allowed values are in range 1..1000. The default value is 12 hours. - **gating_max_duration_minutes** (*Optional*): Maximum duration of gating in minutes (freeze of estimator during high NOx index signal). Zero disables the gating. Allowed values are in range 0..3000. The default value is 180 minutes - **std_initial** (*Optional*): The initial estimate for standard deviation parameter has no impact for NOx. This parameter is still in place for consistency reasons with the VOC tuning parameters command. This parameter must always be set to 50. - - **gain_factor:** (*Optional*) + - **gain_factor** (*Optional*): Gain factor to amplify or to attenuate the VOC index output. Allowed values are in range 1..1000. The default value is 230. - All other options from :ref:`Sensor `. diff --git a/components/sensor/smt100.rst b/components/sensor/smt100.rst index 801b1c63d..93e7567fc 100644 --- a/components/sensor/smt100.rst +++ b/components/sensor/smt100.rst @@ -42,12 +42,12 @@ The communication with this integration is done over a UART bus using a simple A Configuration variables: ------------------------ -- **counts** (*Optional*): Raw measurement data from the sensor electronics (dimensionless quantity). Higher counts mean less moisture. May be used for material specific calibrations. +- **counts** (*Optional*): Raw measurement data from the sensor electronics (dimensionless quantity). Higher counts mean less moisture. May be used for material specific calibrations. - **name** (**Required**): Sensor name. - All other options from :ref:`Sensor `. -- **Permittivity** (*Optional*): Permittivity or dielectric coefficient of the material to be measured (dimensionless quantity. Higher permittivity means higher water content. May be used for material specific calibration. +- **dielectric_constant** (*Optional*): Dielectric coefficient or permittivity of the material to be measured (dimensionless quantity). Higher permittivity means higher water content. May be used for material specific calibration. - **name** (**Required**): Sensor name. - All other options from :ref:`Sensor `. @@ -66,7 +66,7 @@ Configuration variables: - **name** (**Required**): Sensor name. - All other options from :ref:`Sensor `. - + - **uart_id** (*Optional*, :ref:`config-id`): Manually specify the ID of the :ref:`UART Component ` if you want to use multiple UART buses. diff --git a/components/sprinkler.rst b/components/sprinkler.rst index 7d274e89c..894a2eeab 100644 --- a/components/sprinkler.rst +++ b/components/sprinkler.rst @@ -78,12 +78,12 @@ examples that are ready for you to copy and paste! Configuration variables: ------------------------ -- **main_switch** (**Required** with more than one valve, *string*): The name for the sprinkler +- **main_switch** (*Optional*, *string*): Required with more than one valve. The name for the sprinkler controller's main switch as it will appear in the front end. This switch, when turned on, calls the ``sprinkler.resume_or_start_full_cycle`` action; when turned off, it calls the ``sprinkler.shutdown`` action (see below). It will appear to be "on" when any valve on the controller is active. This switch will not appear in the front end if the controller is configured with only one valve. -- **auto_advance_switch** (**Required** with more than one valve, *string*): The name for the +- **auto_advance_switch** (*Optional*, *string*): Required with more than one valve. The name for the sprinkler controller's "auto-advance" switch as it will appear in the front end. When this switch is turned on while a valve is active, when the valve's ``run_duration`` is reached, the sprinkler controller will automatically advance to the next enabled valve as a part of a "full cycle" of the