Clarify config options

Author: clydebarrow

content/components/display/epaper_spi.md

@@ -26,18 +26,30 @@ display:
       it.filled_circle(it.get_width() / 2, it.get_height() / 2, 50, Color::BLACK);
 ```
 
-## Supported displays
+## Supported display controllers
 
-| Model name             | Manufacturer | Product Description                                                                                                        |
-| ---------------------- |--------------|----------------------------------------------------------------------------------------------------------------------------|
-| Spectra-E6             | Eink         | <https://www.eink.com/brand/detail/Spectra6>                                                                               |
-| Seeed-reTerminal-E1002 | Seeed Studio | <https://www.seeedstudio.com/reTerminal-E1002-p-6533.html>                                                                 |
-| SSD1677                | Solomon      | <https://www.solomon-systech.com/product/ssd1677/>                                                                         |
-| Seeed-ee04-mono-4.26   | Seeed Studio | Seeed EE04 board with Waveshare 4.26" mono epaper. <https://www.seeedstudio.com/XIAO-ePaper-Display-Board-EE04-p-6560.html> |
+These are the supported controller chips. Using just the chip name as the model will require full configuration with
+pins and dimensions specified.
+
+| Chip name              | Manufacturer | Product Description                                                                                                          |
+|------------------------|--------------|------------------------------------------------------------------------------------------------------------------------------|
+| Spectra-E6             | Eink         | <https://www.eink.com/brand/detail/Spectra6>                                                                                 |
+| SSD1677                | Solomon      | <https://www.solomon-systech.com/product/ssd1677/>                                                                           |
+
+## Supported integrated display boards
+
+These models correspond to displays integrated with a microcontroller, and have a full configuration predefined, so at
+a minimum only the model name need be configured. Other options can be overridden in the configuration if needed.
+
+
+| Model name             | Manufacturer | Product Description                                                                                                          |
+| ---------------------- |--------------| ---------------------------------------------------------------------------------------------------------------------------- |
+| Seeed-reTerminal-E1002 | Seeed Studio | <https://www.seeedstudio.com/reTerminal-E1002-p-6533.html>                                                                   |
+| Seeed-ee04-mono-4.26   | Seeed Studio | Seeed EE04 board with Waveshare 4.26" mono epaper. <https://www.seeedstudio.com/XIAO-ePaper-Display-Board-EE04-p-6560.html>  |
 
 ## Configuration variables
 
-When using a model defining an integrated ESP32 display board most of the configuration such as the pins and dimensions will be set by default,
+When using a model defining an integrated display board most of the configuration such as the pins and dimensions will be set by default,
 but can be overridden if needed.
 
 - **model** (**Required**): The model of the ePaper display. See the table above for options (case is not significant).
@@ -47,7 +59,7 @@ but can be overridden if needed.
 - **reset_pin** (*Optional*, [Pin Schema](/guides/configuration-types#pin-schema)): The RESET pin, if used.
   Make sure you pull this pin high (by connecting it to 3.3V with a resistor) if not connected to a GPIO pin.
 - **dimensions** (**Required**, dict): Dimensions of the screen, specified either as *width* **x** *height* (e.g `320x240`  )
-  or with separate config keys. For models with full pre-defined configuration this is optional and will be preset by
+  or with separate config keys. For integrated boards with full pre-defined configuration this is optional and will be preset by
   the model selected. The dimensions are specified in pixels, and the width and height must be greater than 0.
 
   - **height** (**Required**, int): Specifies height of display.
@@ -71,6 +83,27 @@ but can be overridden if needed.
   configuration defines multiple SPI buses. If only a single SPI bus is configured, this is optional.
 - **id** (*Optional*, [ID](/guides/configuration-types#id)): Manually specify the ID used for code generation.
 
+### Full configuration example
+
+```yaml
+display:
+  - platform: epaper_spi
+    model: SSD1677
+    full_update_every: 10
+    update_interval: 5s
+    dimensions:
+      width: 800
+      height: 480
+    transform:
+      mirror_x: true
+      mirror_y: false
+    rotation: 90 # Rotate to portrait
+    cs_pin: GPIOXX
+    dc_pin: GPIOXX
+    reset_pin: GPIOXX
+    busy_pin: { number: GPIOXX, inverted: False, mode: { input: True, pulldown: True } }
+```
+
 ## See Also
 
 - {{< apiref "epaper_spi/epaper_spi.h" "epaper_spi/epaper_spi.h" >}}