Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Gp8211 #4354

Draft
wants to merge 8 commits into
base: next
Choose a base branch
from
Draft

Gp8211 #4354

Show file tree
Hide file tree
Changes from all commits
Commits
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
4 changes: 3 additions & 1 deletion .github/workflows/docker.yml
Original file line number Diff line number Diff line change
Expand Up @@ -30,7 +30,9 @@ jobs:
repo: cloudcannon/pagefind
-
name: Checkout source code
uses: actions/[email protected]
gp8211
uses: actions/[email protected]

-
name: Set up QEMU
uses: docker/setup-qemu-action@v3
Expand Down
6 changes: 4 additions & 2 deletions .github/workflows/lint.yml
Original file line number Diff line number Diff line change
Expand Up @@ -23,8 +23,10 @@ jobs:
uses: jaxxstorm/[email protected]
with:
repo: cloudcannon/pagefind
- uses: actions/[email protected]
- name: Set up Python 3.12
gp8211
- uses: actions/[email protected]
- name: Set up Python 3.8

uses: actions/setup-python@v5
with:
python-version: 3.12
Expand Down
51 changes: 51 additions & 0 deletions components/output/gp8211.rst
Original file line number Diff line number Diff line change
@@ -0,0 +1,51 @@
GP8211 Component
================

.. seo::
:description: Instructions for setting up GP8211 outputs in ESPHome.
:image: gp8211.jpg

The ``gp8211`` is a single-channel DAC output module. It requires an :doc:`/components/i2c` to be setup. The GP8211 has a fixed I²C address of `0x58`.

.. figure:: images/gp8211.jpg
:align: center

GP8211 I2C 15-bit DAC Module (0-5V/10V)

Component/Hub
-------------

.. code-block:: yaml

gp8211:
id: my_gp8211
voltage: 5V

Configuration variables:

- **id** (*Optional*, :ref:`config-id`): Manually specify the ID used for code generation.
- **voltage** (**Required**, voltage): The output voltage range of the DAC. Must be one of ``5V`` or ``10V``.

Output
------

.. code-block:: yaml

output:
- platform: gp8211
id: my_gp8211_output
gp8211_id: my_gp8211

Configuration variables:

- **id** (*Optional*, :ref:`config-id`): Manually specify the ID used for code generation.
- **gp8211_id** (*Optional*, :ref:`config-id`): The ID of the GP8211 component.
Defaults to the only GP8211 component if there is only one.
- All other options from :ref:`config-output`.

See Also
--------

- :doc:`/components/output/esp32_dac`
- :doc:`/components/output/index`
- :ghedit:`Edit`
Binary file added components/output/images/gp8211.jpg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added images/gp8211.jpg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
41 changes: 41 additions & 0 deletions index.rst
Original file line number Diff line number Diff line change
Expand Up @@ -720,6 +720,47 @@ Miscellaneous
Tuya Binary Sensor, components/binary_sensor/tuya, tuya.png
WireGuard, components/wireguard, wireguard_custom_logo.svg, dark-invert


Output Components
-----------------

.. imgtable::

Output Core, components/output/index, folder-open.svg, dark-invert
Template Output, components/output/template, description.svg, dark-invert
AC Dimmer, components/output/ac_dimmer, ac_dimmer.svg, dark-invert
BLE Binary Output, components/output/ble_client, bluetooth.svg, dark-invert
BP1658CJ, components/output/bp1658cj, bp1658cj.svg
BP5758D, components/output/bp5758d, bp5758d.svg
DAC7678, components/output/dac7678, dac7678.svg
EMC2101, components/emc2101, emc2101.jpg
ESP32 DAC, components/output/esp32_dac, dac.svg
ESP32 LEDC, components/output/ledc, pwm.png
ESP8266 Software PWM, components/output/esp8266_pwm, pwm.png
GP8211, components/output/gp8211, gp8211.jpg
GP8403, components/output/gp8403, gp8403.svg
GPIO Output, components/output/gpio, gpio.svg
LibreTiny PWM, components/output/libretiny_pwm, pwm.png
MCP4725, components/output/mcp4725, mcp4725.jpg
MCP4728, components/output/mcp4728, mcp4728.jpg
MCP47A1, components/output/mcp47a1, mcp47a1.svg
Modbus Output, components/output/modbus_controller, modbus.png
MY9231/MY9291, components/output/my9231, my9231.svg
PCA9685, components/output/pca9685, pca9685.jpg
Sigma-Delta Output, components/output/sigma_delta_output, sigma-delta.svg, dark-invert
Slow PWM, components/output/slow_pwm, pwm.png
SM16716, components/output/sm16716, sm16716.svg
SM2135, components/output/sm2135, sm2135.svg
SM2235, components/output/sm2235, sm2235.svg
SM2335, components/output/sm2335, sm2335.svg
TLC59208F, components/output/tlc59208f, tlc59208f.jpg
TLC5947, components/output/tlc5947, tlc5947.jpg
TLC5971, components/output/tlc5971, tlc5971.jpg
X9C Potentiometer, components/output/x9c, x9c.jpg

Light Components
----------------

Alarm Control Panel Components
------------------------------

Expand Down