From 9420c45a01f3a324a36927ef195b18c3ab9d89d2 Mon Sep 17 00:00:00 2001 From: Guillermo Ruffino Date: Sun, 7 Feb 2021 13:35:39 -0300 Subject: [PATCH] Fix format consistency (#989) --- components/binary_sensor/mpr121.rst | 4 ++-- components/canbus.rst | 14 +++++++------- components/climate/tuya.rst | 6 +++--- components/ethernet.rst | 14 +++++++------- components/fan/speed.rst | 6 +++--- components/fan/tuya.rst | 2 +- components/light/index.rst | 4 ++-- components/mcp23Sxx.rst | 4 ++-- components/mqtt.rst | 8 ++++---- components/output/template.rst | 6 +++--- components/remote_transmitter.rst | 4 ++-- components/sensor/as3935.rst | 2 +- components/sx1509.rst | 4 ++-- components/wifi.rst | 10 +++++----- 14 files changed, 44 insertions(+), 44 deletions(-) diff --git a/components/binary_sensor/mpr121.rst b/components/binary_sensor/mpr121.rst index aadcf5ae3..62c584c17 100644 --- a/components/binary_sensor/mpr121.rst +++ b/components/binary_sensor/mpr121.rst @@ -57,9 +57,9 @@ Base Configuration: Binary Sensor Configuration: -- **name** (**Optional**, string): The name for the binary sensor. +- **name** (*Optional*, string): The name for the binary sensor. - **id** (*Optional*, :ref:`config-id`): Manually specify the ID used for code generation. -- **channel** (*Required*, integer): The channel number at the MPR121 the touchkey is connected to. +- **channel** (**Required**, integer): The channel number at the MPR121 the touchkey is connected to. - **touch_threshold** (*Optional*, integer): A per-channel override of the global touch_threshold value. If not specified, uses the global value. - **release_threshold** (*Optional*, integer): A per-channel override of the global release_threshold value. If not specified, uses the global value. - All other options from :ref:`Binary Sensor `. diff --git a/components/canbus.rst b/components/canbus.rst index 641c63722..cced53cb0 100644 --- a/components/canbus.rst +++ b/components/canbus.rst @@ -56,7 +56,7 @@ Configuration variables: - **id** (*Optional*, :ref:`config-id`): Manually specify the ID used for code generation. - **can_id** (**Required**, integer): default *can id* used for transmitting frames. -- **use_extended_id** (*Optional*, boolean): default *False* identifies the type of *can_id*: +- **use_extended_id** (*Optional*, boolean): default *False* identifies the type of *can_id*: *False*: Standard 11 bits IDs, *True*: Extended 29 bits ID - **bit_rate** (*Optional*, one of the supported bitrates= defaults to ``125KBPS``. @@ -132,13 +132,13 @@ There are several forms to use it: Configuration variables: -- **data** (*Required*, binary data): Data to transmit, up to 8 bytes or +- **data** (**Required**, binary data): Data to transmit, up to 8 bytes or characters are supported by can bus per frame. - **canbus_id** (*Optional*): Optionally set the can bus id to use for transmitting the frame. Not needed if you are using only 1 can bus. - **can_id** (*Optional*, int): Allows to override the can id configured in the can bus device. -- **use_extended_id** (*Optional*, boolean): default *False* identifies the type of *can_id*: +- **use_extended_id** (*Optional*, boolean): default *False* identifies the type of *can_id*: *False*: Standard 11 Bit IDs, *True*: Extended 29Bit ID MCP2515 @@ -217,7 +217,7 @@ Standard IDs and Extended IDs can coexist on the same segment. - seconds: /1 then: - canbus.send: - # Extended ID explicit + # Extended ID explicit use_extended_id: True can_id: 0x100 data: [0x01, 0x02, 0x03, 0x04, 0x05, 0x06, 0x07, 0x08] @@ -290,11 +290,11 @@ Buttons are connected on the CAN-Node and also the motor is connected via CAN. .. epigraph:: - | **Button 1:** ID 0x50B - 1 byte payload + | **Button 1:** ID 0x50B - 1 byte payload | (0: Button release, 1: Button down, 2: long down, 3: long release, 4 double click) - | **Button 2:** ID 0x50C - 1 byte payload + | **Button 2:** ID 0x50C - 1 byte payload | (0: Button release, 1: Button down, 2: long down, 3: long release, 4 double click) - | **Motor:** ID 0x51A - 1 byte payload + | **Motor:** ID 0x51A - 1 byte payload | (0: off, 1: open, 2: close) .. code-block:: yaml diff --git a/components/climate/tuya.rst b/components/climate/tuya.rst index 169606b9b..d14f906e2 100644 --- a/components/climate/tuya.rst +++ b/components/climate/tuya.rst @@ -48,11 +48,11 @@ Configuration variables: - **switch_datapoint** (**Required**, int): The datapoint id number of the climate switch. - **target_temperature_datapoint** (**Required**, int): The datapoint id number of the target temperature. - **current_temperature_datapoint** (**Required**, int): The datapoint id number of the current temperature. -- **temperature_multiplier** (**Optional**, float): A multiplier to modify the incoming and outgoing temperature values - :ref:`see below `. +- **temperature_multiplier** (*Optional*, float): A multiplier to modify the incoming and outgoing temperature values - :ref:`see below `. If the device has different multipliers for current and target temperatures, **temperature_multiplier** can be replaced with both of: - - **current_temperature_multiplier** (**Optional**, float): A multiplier to modify the current temperature value. - - **target_temperature_multiplier** (**Optional**, float): A multiplier to modify the target temperature value. + - **current_temperature_multiplier** (*Optional*, float): A multiplier to modify the current temperature value. + - **target_temperature_multiplier** (*Optional*, float): A multiplier to modify the target temperature value. - All other options from :ref:`Climate `. .. _temperature-multiplier: diff --git a/components/ethernet.rst b/components/ethernet.rst index 4ba201415..0d6b68bdf 100644 --- a/components/ethernet.rst +++ b/components/ethernet.rst @@ -48,9 +48,9 @@ Configuration variables: - **manual_ip** (*Optional*): Manually configure the static IP of the node. - - **static_ip** (*Required*, IPv4 address): The static IP of your node. - - **gateway** (*Required*, IPv4 address): The gateway of the local network. - - **subnet** (*Required*, IPv4 address): The subnet of the local network. + - **static_ip** (**Required**, IPv4 address): The static IP of your node. + - **gateway** (**Required**, IPv4 address): The gateway of the local network. + - **subnet** (**Required**, IPv4 address): The subnet of the local network. - **dns1** (*Optional*, IPv4 address): The main DNS server to use. - **dns2** (*Optional*, IPv4 address): The backup DNS server to use. @@ -63,10 +63,10 @@ Configuration variables: .. note:: If your ethernet board is not designed with an ESP32 built in, chances are that you are going - to use flying leads, dupont wires, etc. to connect the ethernet to the ESP32. This is - probably to fail as the ethernet interface uses a high frequency clock signal. For more + to use flying leads, dupont wires, etc. to connect the ethernet to the ESP32. This is + probably to fail as the ethernet interface uses a high frequency clock signal. For more information and wiring details refer to the the link in the *See also* section. - + Configuration for wESP32 board ------------------------------ @@ -114,7 +114,7 @@ Configuration for OpenHacks LAN8720 mdc_pin: GPIO23 mdio_pin: GPIO18 phy_addr: 1 - + Note: This board has an issue that might cause the ESP32 to boot in program mode. When testing, make sure you are monitoring the serial output and reboot the device several times to see if it boots into the program properly. diff --git a/components/fan/speed.rst b/components/fan/speed.rst index 03c4c790c..59716e4b7 100644 --- a/components/fan/speed.rst +++ b/components/fan/speed.rst @@ -32,11 +32,11 @@ Configuration variables: :ref:`output ` to use for the direction state of the fan. Default is empty. - **speed** (*Optional*): Set the float values for each speed setting: - - **low** (*Required*, float): Set the value for the low speed + - **low** (**Required**, float): Set the value for the low speed setting. Must be in range 0 to 1. Defaults to 0.33. - - **medium** (*Required*, float): Set the value for the medium speed + - **medium** (**Required**, float): Set the value for the medium speed setting. Must be in range 0 to 1. Defaults to 0.66. - - **high** (*Required*, float): Set the value for the high speed + - **high** (**Required**, float): Set the value for the high speed setting. Must be in range 0 to 1. Defaults to 1. - **id** (*Optional*, :ref:`config-id`): Manually specify the ID used for code generation. diff --git a/components/fan/tuya.rst b/components/fan/tuya.rst index 65bb611ae..8fb4e8299 100644 --- a/components/fan/tuya.rst +++ b/components/fan/tuya.rst @@ -53,7 +53,7 @@ Configuration variables: - **name** (**Required**, string): The name of the fan. - **speed_datapoint** (**Required**, int): The datapoint id number of the fan speed. - **switch_datapoint** (**Required**, int): The datapoint id number of the fan switch. -- **oscillation_datapoint** (**Optional**, int): The datapoint id number of the oscillation +- **oscillation_datapoint** (*Optional*, int): The datapoint id number of the oscillation switch. Probably not supported on any Tuya controllers currently, but it's there if need be. - All other options from :ref:`Fan `. diff --git a/components/light/index.rst b/components/light/index.rst index da9c43e04..90c5e0f4f 100644 --- a/components/light/index.rst +++ b/components/light/index.rst @@ -741,7 +741,7 @@ Available variables in the lambda: for (int i = it.size() - 1; i > 0; i--) { it[i] = it[i - 1].get(); } - it[0] = ESPColor::random_color(); + it[0] = ESPColor::random_color(); // Bonus: use .range() and .all() to set many LEDs without having to write a loop. it.range(0, 50) = ESPColor::BLACK; @@ -841,7 +841,7 @@ JINX_ can be used to control E1.31_ enabled ESPHome. Configuration variables: - **method** (*Optional*): Listening method, one of ``multicast`` or ``unicast``. Defaults to ``multicast``. -- **universe** (*Required*, integer): The value of universe, between 1 to 512. +- **universe** (**Required**, integer): The value of universe, between 1 to 512. - **channels** (*Optional*): The type of data. This is used to specify if it is a ``MONO``, ``RGB`` or ``RGBW`` light and in which order the colors are. Defaults to ``RGB``. diff --git a/components/mcp23Sxx.rst b/components/mcp23Sxx.rst index 71f4f35d4..2a8f9f8d5 100644 --- a/components/mcp23Sxx.rst +++ b/components/mcp23Sxx.rst @@ -57,7 +57,7 @@ Configuration variables: ~~~~~~~~~~~~~~~~~~~~~~~~ - **id** (**Required**, :ref:`config-id`): The id to use for this MCP23S08 component. -- **cs_pin** (*Required*, int): The SPI chip select pin to use +- **cs_pin** (**Required**, int): The SPI chip select pin to use - **deviceaddress** (*Optional*, int): The address of the chip. Defaults to ``0``. @@ -112,7 +112,7 @@ Configuration variables: ~~~~~~~~~~~~~~~~~~~~~~~~ - **id** (**Required**, :ref:`config-id`): The id to use for this MCP23S17 component. -- **cs_pin** (*Required*, int): The SPI chip select pin to use. +- **cs_pin** (**Required**, int): The SPI chip select pin to use. - **deviceaddress** (*Optional*, int): The address of the chip. Defaults to ``0``. diff --git a/components/mqtt.rst b/components/mqtt.rst index 75d229a06..740c51fb7 100644 --- a/components/mqtt.rst +++ b/components/mqtt.rst @@ -440,9 +440,9 @@ Publish an MQTT message on a topic using this action in automations. Configuration options: -- **topic** (*Required*, string, :ref:`templatable `): +- **topic** (**Required**, string, :ref:`templatable `): The MQTT topic to publish the message. -- **payload** (*Required*, string, :ref:`templatable `): The message content. +- **payload** (**Required**, string, :ref:`templatable `): The message content. - **qos** (*Optional*, int, :ref:`templatable `): The `Quality of Service `__ level of the topic. Defaults to 0. @@ -491,9 +491,9 @@ as seen below. Configuration options: -- **topic** (*Required*, string, :ref:`templatable `): +- **topic** (**Required**, string, :ref:`templatable `): The MQTT topic to publish the message. -- **payload** (*Required*, :ref:`lambda `): The message content. +- **payload** (**Required**, :ref:`lambda `): The message content. - **qos** (*Optional*, int): The `Quality of Service `__ level of the topic. Defaults to 0. diff --git a/components/output/template.rst b/components/output/template.rst index d2905087b..1ba6d20aa 100644 --- a/components/output/template.rst +++ b/components/output/template.rst @@ -38,7 +38,7 @@ Configuration variables: - **id** (**Required**, :ref:`config-id`): The id to use for this output component. - **type** (**Required**, string): The type of output. One of ``binary`` and ``float``. -- **on_write_action** (*Required*, :ref:`Action `): The action that should +- **on_write_action** (**Required**, :ref:`Action `): The action that should be performed when the state of the output is updated. - All other options from :ref:`Output `. @@ -54,10 +54,10 @@ See :apiclass:`output::BinaryOutput` and :apiclass:`output::FloatOutput`. ``output.template.on_write`` Action ----------------------------------- -When the state for this output is updated, the on_write action is executed. +When the state for this output is updated, the on_write action is executed. It is possible to access the state value inside Lambdas: -.. code-block:: yaml +.. code-block:: yaml - platform: template id: my_output diff --git a/components/remote_transmitter.rst b/components/remote_transmitter.rst index a2334fcb9..1d1253d35 100644 --- a/components/remote_transmitter.rst +++ b/components/remote_transmitter.rst @@ -74,7 +74,7 @@ Configuration variables: - **transmitter_id** (*Optional*, :ref:`config-id`): The remote transmitter to send the remote code with. Defaults to the first one defined in the configuration. - + If you're looking for the same functionality as is default in the ``rpi_rf`` integration in Home Assistant, you'll want to set the **times** to 10 and the **wait_time** to 0s. @@ -244,7 +244,7 @@ This :ref:`action ` sends a Pioneer infrared remote code to a rem Configuration variables: - **rc_code_1** (**Required**, int): The remote control code to send, see dumper output for more details. -- **rc_code_2** (**Optional**, int): The secondary remote control code to send; some codes are sent in +- **rc_code_2** (*Optional*, int): The secondary remote control code to send; some codes are sent in two parts. - Note that ``repeat`` is still optional, however **Pioneer devices may require that a given code is received multiple times before they will act on it.** Add this if your device does not respond to diff --git a/components/sensor/as3935.rst b/components/sensor/as3935.rst index 7d7224a1c..f8ccb4fe5 100644 --- a/components/sensor/as3935.rst +++ b/components/sensor/as3935.rst @@ -161,7 +161,7 @@ Use this if you want to use your AS3935 in SPI mode. - platform: as3935 name: "Storm Alert" -- **cs_pin** (*Required*, :ref:`Pin Schema `): The chip select pin. +- **cs_pin** (**Required**, :ref:`Pin Schema `): The chip select pin. See Also -------- diff --git a/components/sx1509.rst b/components/sx1509.rst index 1d213d192..0340af738 100644 --- a/components/sx1509.rst +++ b/components/sx1509.rst @@ -53,9 +53,9 @@ up to 8x8 matrix (i.e. 64 keys). - **keypad** (*Optional*): Add this to enable the keypad. - - **key_row** (*Required*, int): The number of keypad rows to use. This enables any number of the first 7 pins. + - **key_row** (**Required**, int): The number of keypad rows to use. This enables any number of the first 7 pins. So a value of 3 enables pins 0,1,2 to be used as the rows for the keypad matrix. This value must be between 1 and 8. - - **key_columns** (*Required*, int): The number of keypad columns to use. This enables any number of the last 7 pins. + - **key_columns** (**Required**, int): The number of keypad columns to use. This enables any number of the last 7 pins. So a value of 4 enables pins 8,9,10,11 to be used as the columns for the keypad matrix. This value must be between 1 and 8. - **sleep_time** (*Optional*, int): No key press within this time will set keypad engine to sleep. - **scan_time** (*Optional*, int): Scan time per row (must be set above debounce time). diff --git a/components/wifi.rst b/components/wifi.rst index a4738e46c..90c71b5c1 100644 --- a/components/wifi.rst +++ b/components/wifi.rst @@ -38,9 +38,9 @@ Configuration variables: that is reachable will be connected to. See :ref:`wifi-networks`. - **manual_ip** (*Optional*): Manually configure the static IP of the node. - - **static_ip** (*Required*, IPv4 address): The static IP of your node. - - **gateway** (*Required*, IPv4 address): The gateway of the local network. - - **subnet** (*Required*, IPv4 address): The subnet of the local network. + - **static_ip** (**Required***, IPv4 address): The static IP of your node. + - **gateway** (**Required**, IPv4 address): The gateway of the local network. + - **subnet** (**Required**, IPv4 address): The subnet of the local network. - **dns1** (*Optional*, IPv4 address): The main DNS server to use. - **dns2** (*Optional*, IPv4 address): The backup DNS server to use. @@ -49,8 +49,8 @@ Configuration variables: - **ap** (*Optional*): Enable an access point mode on the node. - - **ssid** (*Required*, string): The name of the access point to create. - - **password** (*Optional* string): The password for the access point. Leave empty for + - **ssid** (**Required**, string): The name of the access point to create. + - **password** (*Optional*, string): The password for the access point. Leave empty for no password. - **channel** (*Optional*, int): The channel the AP should operate on from 1 to 14. Defaults to 1.