Add set_buffer to tm1637 #6021

tuct · 2026-02-01T20:50:26Z

Description:

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

Add buffer manipulation methods to TM1637Display class esphome#13686

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.md when creating new documents for new components or cookbook.

Added set_buffer to tm1637

* Add ir/rf proxy to ready made projects * copy Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> * Apply suggestions from code review Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> * Update themes/esphome-theme/layouts/_default/projects.html Co-authored-by: Jonathan Swoboda <154711427+swoboda1337@users.noreply.github.com> --------- Co-authored-by: Keith Burzinski <kbx81x@gmail.com> Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> Co-authored-by: Jonathan Swoboda <154711427+swoboda1337@users.noreply.github.com>

Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

Co-authored-by: Claude Opus 4.5 <noreply@anthropic.com>

esphome

As this is a feature matched with a PR in https://github.com/esphome/esphome, please target your PR to the next branch and rebase.

esphome · 2026-02-01T20:50:42Z

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.

Copilot

Pull request overview

Adds documentation for writing raw segment bytes to TM1637 displays via the new set_buffer API.

Changes:

Documented a new “Raw segment buffer” section describing set_buffer usage.
Added a YAML/lambda example showing raw segment values and decimal point (bit 7 / 0x80).

Copilot · 2026-02-01T20:52:00Z

content/components/display/tm1637.md

+
+

There are two consecutive empty lines here before the “Creating a digital clock” heading. Please remove the extra blank lines to keep spacing consistent with the rest of the document.

Suggested change

coderabbitai · 2026-02-01T20:53:28Z

Walkthrough

Added documentation for the TM1637 display's raw segment buffer feature, describing the set_buffer method that allows writing raw bytes directly to the display buffer to create custom glyphs and animations.

Changes

Cohort / File(s)	Summary
TM1637 Display Documentation `content/components/display/tm1637.md`	New "Raw segment buffer" section documenting direct buffer writing via `set_buffer`, including byte-per-digit format, decimal point bit positioning (0x80), and YAML usage example.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~12 minutes

🚥 Pre-merge checks | ✅ 3

✅ Passed checks (3 passed)

Check name	Status	Explanation
Title check	✅ Passed	The title 'Add set_buffer to tm1637' directly and accurately summarizes the main change: adding documentation for the set_buffer feature to the TM1637 display component.
Description check	✅ Passed	The description is related to the changeset, explaining that it adds documentation for a new TM1637 feature (set_buffer) with a corresponding code PR reference, which aligns with the documented changes.
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.

_{✏️ Tip: You can configure your own custom pre-merge checks in the settings.}

✨ Finishing touches

🧪 Generate unit tests (beta)

Create PR with unit tests
Post copyable unit tests in a comment

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

coderabbitai

Actionable comments posted: 2

🤖 Fix all issues with AI agents

In `@content/components/display/tm1637.md`:
- Around line 125-126: Remove the multiple consecutive blank lines in the TM1637
display markdown section and collapse them to a single blank line so the file no
longer has consecutive empty lines; edit the tm1637.md content around the
documented display section to leave only one blank line between
paragraphs/headings.
- Around line 191-198: Clarify that the TM1637::set_buffer call always expects
six bytes corresponding to the hardware's full 6-digit buffer (even if your
config uses length: 4), and update the example/description around the lambda and
set_buffer usage to state that unused digit positions must be padded (e.g., with
0x00) so callers know to always supply six values to set_buffer.

coderabbitai · 2026-02-01T20:53:32Z

content/components/display/tm1637.md

+
+

⚠️ Potential issue | 🟡 Minor

Remove extra blank lines to satisfy lint.

Lint reports multiple consecutive blank lines here. Collapse to a single blank line.

🔧 Proposed fix

- -

📝 Committable suggestion

‼️ IMPORTANT
Carefully review the code before committing. Ensure that it accurately replaces the highlighted code, contains no missing lines, and has no issues with indentation. Thoroughly test & benchmark the code to ensure it meets the requirements.

Suggested change

🧰 Tools

🪛 GitHub Check: Lint

[failure] 126-126:
Multiple consecutive blank lines [Expected: 1; Actual: 3]

[failure] 125-125:
Multiple consecutive blank lines [Expected: 1; Actual: 2]

🤖 Prompt for AI Agents

In `@content/components/display/tm1637.md` around lines 125 - 126, Remove the multiple consecutive blank lines in the TM1637 display markdown section and collapse them to a single blank line so the file no longer has consecutive empty lines; edit the tm1637.md content around the documented display section to leave only one blank line between paragraphs/headings.

coderabbitai · 2026-02-01T20:53:32Z

content/components/display/tm1637.md

+```yaml
+display:
+  - platform: tm1637
+    # ...
+    lambda: |-
+      // Raw segment values for "0123" with the dot on the last digit
+      it.set_buffer(0x3f, 0x06, 0x5b, 0x4f | 0x80, 0x00, 0x00);
+```


⚠️ Potential issue | 🟡 Minor

🧩 Analysis chain

🏁 Script executed:

# Find tm1637-related source files find . -type f \( -name "*tm1637*" -o -name "*TM1637*" \) | head -20

Repository: esphome/esphome-docs

Length of output: 361

🏁 Script executed:

# Search for set_buffer method definition in cpp/h files rg -l 'set_buffer' --type=cpp

Repository: esphome/esphome-docs

Length of output: 212

🏁 Script executed:

# Look for TM1637 class/component definition rg 'class.*TM1637' --type=cpp -A 10

Repository: esphome/esphome-docs

Length of output: 212

🏁 Script executed:

# Read the tm1637.md file to see the full context wc -l ./content/components/display/tm1637.md

Repository: esphome/esphome-docs

Length of output: 106

🏁 Script executed:

# Read the section around lines 191-198 to get more context sed -n '170,220p' ./content/components/display/tm1637.md

Repository: esphome/esphome-docs

Length of output: 1227

🏁 Script executed:

# Search for "set_buffer" in the documentation rg -n 'set_buffer' ./content/components/display/tm1637.md -B5 -A5

Repository: esphome/esphome-docs

Length of output: 825

🏁 Script executed:

# Search for "buffer" references to understand sizing rg -n -i 'buffer' ./content/components/display/tm1637.md

Repository: esphome/esphome-docs

Length of output: 280

🏁 Script executed:

# Check what's in the See Also section and look for API references sed -n '200,204p' ./content/components/display/tm1637.md

Repository: esphome/esphome-docs

Length of output: 252

🏁 Script executed:

# Search for any other mentions of buffer or configuration examples rg -n 'lambda' ./content/components/display/tm1637.md

Repository: esphome/esphome-docs

Length of output: 504

🏁 Script executed:

# Look for configuration documentation that might mention display dimensions rg -n -i 'digit\|config\|buffer' ./content/components/display/tm1637.md | head -20

Repository: esphome/esphome-docs

Length of output: 46

🏁 Script executed:

# Read the first part of the file to understand configuration structure sed -n '1,100p' ./content/components/display/tm1637.md

Repository: esphome/esphome-docs

Length of output: 4765

🏁 Script executed:

# Look for all lambda examples to see if there's a pattern rg -n 'it\.' ./content/components/display/tm1637.md

Repository: esphome/esphome-docs

Length of output: 596

Clarify set_buffer byte count to match TM1637 buffer capacity.

The example passes 6 bytes (the TM1637 hardware buffer size supporting up to 6 digits), but this isn't explained. Readers seeing a 4-digit length: 4 config may expect only 4 bytes. Add a note that set_buffer always requires 6 bytes representing the full buffer capacity, with unused positions padded as needed (e.g., 0x00).

🤖 Prompt for AI Agents

In `@content/components/display/tm1637.md` around lines 191 - 198, Clarify that the TM1637::set_buffer call always expects six bytes corresponding to the hardware's full 6-digit buffer (even if your config uses length: 4), and update the example/description around the lambda and set_buffer usage to state that unused digit positions must be padded (e.g., with 0x00) so callers know to always supply six values to set_buffer.

netlify · 2026-02-01T20:54:02Z

✅ Deploy Preview for esphome ready!

Name	Link
🔨 Latest commit	`3de0e43`
🔍 Latest deploy log	https://app.netlify.com/projects/esphome/deploys/6980f651deb95a0008eabc8e
😎 Deploy Preview	https://deploy-preview-6021--esphome.netlify.app
📱 Preview on mobile	Toggle QR Code... Use your smartphone camera to open QR code link.

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

Base branch has been corrected - dismissing previous review.

…sphome#5979)

* Add ir/rf proxy to ready made projects * copy Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> * Apply suggestions from code review Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> * Update themes/esphome-theme/layouts/_default/projects.html Co-authored-by: Jonathan Swoboda <154711427+swoboda1337@users.noreply.github.com> --------- Co-authored-by: Keith Burzinski <kbx81x@gmail.com> Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> Co-authored-by: Jonathan Swoboda <154711427+swoboda1337@users.noreply.github.com>

Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

Co-authored-by: Claude Opus 4.5 <noreply@anthropic.com>

…to origin/next

tuct · 2026-02-02T19:10:24Z

re-create clean

dhoeben and others added 12 commits January 29, 2026 22:42

update HA version requirement (esphome#5975)

03113cc

[web-api] Document SSE entity ID deprecation path with name_id field (e…

71099ef

…sphome#5979)

Bump docker/setup-buildx-action from 3.11.1 to 3.12.0 (esphome#5810)

ac68a93

Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

Bump actions/checkout from 5.0.1 to 6.0.2 (esphome#5970)

25674d3

Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

Bump dessant/lock-threads from 5.0.1 to 6.0.0 (esphome#5781)

5f1d660

Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

Bump actions/upload-artifact from 5.0.0 to 6.0.0 (esphome#5780)

957efe6

Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

Bump actions/setup-python from 6.0.0 to 6.2.0 (esphome#5969)

8ff4166

Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

Remove version from docker compose sample (esphome#5988)

9e834d3

[key_collector] Add missing start_keys documentation (esphome#5929)

32c8cfc

Co-authored-by: Claude Opus 4.5 <noreply@anthropic.com>

Add raw segment buffer support to TM1637 documentation

d6fafb0

Update TM1637 documentation to include raw segment buffer usage example

40dbe79

Copilot AI review requested due to automatic review settings February 1, 2026 20:50

esphome bot added component: tm1637 current has-parent wrong-base-branch labels Feb 1, 2026

esphome bot previously requested changes Feb 1, 2026

View reviewed changes

esphome bot marked this pull request as draft February 1, 2026 20:50

Copilot started reviewing on behalf of tuct February 1, 2026 20:50 View session

tuct mentioned this pull request Feb 1, 2026

Add buffer manipulation methods to TM1637Display class esphome/esphome#13686

Open

16 tasks

Copilot AI reviewed Feb 1, 2026

View reviewed changes

coderabbitai bot reviewed Feb 1, 2026

View reviewed changes

tuct changed the base branch from current to next February 2, 2026 18:45

esphome bot added the next label Feb 2, 2026

esphome bot removed the wrong-base-branch label Feb 2, 2026

esphome bot removed the current label Feb 2, 2026

dhoeben and others added 15 commits February 2, 2026 19:50

update HA version requirement (esphome#5975)

7630248

[web-api] Document SSE entity ID deprecation path with name_id field (e…

2b8f1dc

…sphome#5979)

Bump docker/setup-buildx-action from 3.11.1 to 3.12.0 (esphome#5810)

f029cca

Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

Bump actions/checkout from 5.0.1 to 6.0.2 (esphome#5970)

c22d14c

Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

Bump dessant/lock-threads from 5.0.1 to 6.0.0 (esphome#5781)

daa0ef2

Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

Bump actions/upload-artifact from 5.0.0 to 6.0.0 (esphome#5780)

15803de

Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

Bump actions/setup-python from 6.0.0 to 6.2.0 (esphome#5969)

f2d6ab7

Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

Remove version from docker compose sample (esphome#5988)

df77fb6

[key_collector] Add missing start_keys documentation (esphome#5929)

c180fe0

Co-authored-by: Claude Opus 4.5 <noreply@anthropic.com>

Add raw segment buffer support to TM1637 documentation

aecfd56

Update TM1637 documentation to include raw segment buffer usage example

f6d85eb

Merge branch 'origin/next' of https://github.com/tuct/esphome-docs in…

7c95e5a

…to origin/next

Add raw segment buffer support to TM1637 documentation

554b872

Update TM1637 documentation to include raw segment buffer usage example

460d745

tuct force-pushed the origin/next branch from 7c95e5a to 460d745 Compare February 2, 2026 18:56

tuct added 2 commits February 2, 2026 20:07

Update TM1637 documentation to clarify raw segment buffer usage

4f6998e

Merge branch 'origin/next' of https://github.com/tuct/esphome-docs in…

3de0e43

…to origin/next

tuct closed this Feb 2, 2026

github-actions bot locked and limited conversation to collaborators Feb 4, 2026

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

Add set_buffer to tm1637 #6021

Add set_buffer to tm1637 #6021

Uh oh!

tuct commented Feb 1, 2026

Uh oh!

esphome bot left a comment

Uh oh!

esphome bot commented Feb 1, 2026

Uh oh!

Copilot AI left a comment

Uh oh!

Copilot AI Feb 1, 2026

Uh oh!

coderabbitai bot commented Feb 1, 2026

Uh oh!

coderabbitai bot left a comment

Uh oh!

coderabbitai bot Feb 1, 2026

Uh oh!

coderabbitai bot Feb 1, 2026

Uh oh!

netlify bot commented Feb 1, 2026 •

edited

Loading

Uh oh!

tuct commented Feb 2, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

6 participants

Uh oh!

Add set_buffer to tm1637 #6021

Add set_buffer to tm1637 #6021

Uh oh!

Conversation

tuct commented Feb 1, 2026

Description:

Checklist:

Uh oh!

esphome bot left a comment

Choose a reason for hiding this comment

Uh oh!

esphome bot commented Feb 1, 2026

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Uh oh!

Copilot AI Feb 1, 2026

Choose a reason for hiding this comment

Uh oh!

coderabbitai bot commented Feb 1, 2026

Walkthrough

Changes

Estimated code review effort

Uh oh!

coderabbitai bot left a comment

Choose a reason for hiding this comment

Uh oh!

coderabbitai bot Feb 1, 2026

Choose a reason for hiding this comment

Uh oh!

coderabbitai bot Feb 1, 2026

Choose a reason for hiding this comment

Uh oh!

netlify bot commented Feb 1, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

✅ Deploy Preview for esphome ready!

Uh oh!

tuct commented Feb 2, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

6 participants

netlify bot commented Feb 1, 2026 •

edited

Loading