Skip to content

Conversation

@jonau
Copy link

@jonau jonau commented Jul 22, 2025

Description:

The PCA9685 chip allows for flexible phase angles. Currently the component uses this ability to set the phase angles equidistantly for all output channels. So 3 output channels would have a phase angle of 0°, 120° and 240°. This however can cause flickering of the LEDs when animating / fading, because when the output changes and the start angle is higher than the end angle of the output the chip will need an additional frame where no signal is outputted (as indicated by the (datasheet)[https://cdn-shop.adafruit.com/datasheets/PCA9685.pdf#page=20]

This pull requests documents a new configuration option phase_balancer with the options of linear, which keeps the current behavior and is the default. And none which sets all phase angles to 0°, so that the problem described above does not happen.

Pull request in esphome with YAML changes (if applicable):

Checklist:

  • I am merging into next because this is new documentation that has a matching pull-request in esphome as linked above.
    or

  • I am merging into current because this is a fix, change and/or adjustment in the current documentation and is not for a new component or feature.

  • Link added in /components/index.rst when creating new documents for new components or cookbook.

@netlify
Copy link

netlify bot commented Jul 22, 2025

Deploy Preview for esphome ready!

Name Link
🔨 Latest commit beeef49
🔍 Latest deploy log https://app.netlify.com/projects/esphome/deploys/687f61cb0a5b900008f2280a
😎 Deploy Preview https://deploy-preview-5157--esphome.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

@swoboda1337
Copy link
Member

Docs need to be updated from rst to md

Copy link
Member

@jesserockz jesserockz left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

As above, please rebase the docs. I tried but it wont let me push to your fork.

Update: I just noticed it is a fork in an org which for some reason GitHub doesn't allow pushes by maintainers.

@esphome esphome bot marked this pull request as draft October 21, 2025 03:00
@esphome
Copy link

esphome bot commented Oct 21, 2025

Please take a look at the requested changes, and use the Ready for review button when you are done, thanks 👍

Learn more about our pull request process.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants