Skip to content

[sdl] Document mouse wheel encoder sensor and mouse button binary sensor#6715

Open
clydebarrow wants to merge 1 commit into
esphome:nextfrom
clydebarrow:sdl-mousewheel
Open

[sdl] Document mouse wheel encoder sensor and mouse button binary sensor#6715
clydebarrow wants to merge 1 commit into
esphome:nextfrom
clydebarrow:sdl-mousewheel

Conversation

@clydebarrow
Copy link
Copy Markdown
Contributor

@clydebarrow clydebarrow commented Jun 1, 2026

  • Add new sensor/sdl page for the mouse wheel rotary encoder
  • Document mouse_button option on the SDL binary sensor
  • Document newly-functional rotation option on the SDL display
  • Add SDL mouse wheel sensor to the component index
  • Clarify display requirement wording on the touchscreen page

Co-Authored-By: Claude Opus 4.8 noreply@anthropic.com

Description

Related issue (if applicable): fixes

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 /src/content/docs/components/index.mdx when creating new documents for new components or cookbook.

New Component Images

If you are adding a new component to ESPHome, you can automatically generate a standardized black and white component name image for the documentation.

To generate a component image:

  1. Comment on this pull request with the following command, replacing component_name with your component name in lower_case format with underscores (e.g., bme280, sht3x, dallas_temp):

    @esphomebot generate image component_name
    
  2. The ESPHome bot will respond with a downloadable ZIP file containing the SVG image.

  3. Extract the SVG file and place it in the /public/images/ folder of this repository.

  4. Use the image in your component's index table entry in /src/content/docs/components/index.mdx.

Example: For a component called "DHT22 Temperature Sensor", use:

@esphomebot generate image dht22

Note: All images used in ImgTable components must be placed in /public/images/ as the component resolves them to absolute paths.

- Add new sensor/sdl page for the mouse wheel rotary encoder
- Document mouse_button option on the SDL binary sensor
- Document newly-functional rotation option on the SDL display
- Add SDL mouse wheel sensor to the component index
- Clarify display requirement wording on the touchscreen page

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

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

Pull request overview

Documentation update for the SDL host platform: adds a new sensor page for the mouse wheel rotary encoder, documents the new mouse_button option on the SDL binary sensor, documents the now-functional rotation option on the SDL display, registers the new sensor in the component index, and clarifies the SDL display requirement on the touchscreen page.

Changes:

  • New sensor/sdl.mdx page documenting the mouse wheel encoder sensor and adding it to the component index.
  • Updated binary_sensor/sdl.mdx to document mouse_button and make key optional.
  • Updated display/sdl.mdx for the new rotation option and added a See Also link; touchscreen page wording clarified.

Reviewed changes

Copilot reviewed 5 out of 5 changed files in this pull request and generated no comments.

Show a summary per file
File Description
src/content/docs/components/sensor/sdl.mdx New page documenting SDL mouse wheel rotary encoder sensor.
src/content/docs/components/binary_sensor/sdl.mdx Adds mouse_button option and adjusts key to optional.
src/content/docs/components/display/sdl.mdx Documents rotation option and adds link to new sensor page.
src/content/docs/components/touchscreen/sdl.mdx Clarifies wording about required SDL display.
src/content/docs/components/index.mdx Registers new SDL mouse wheel sensor entry.

@netlify
Copy link
Copy Markdown

netlify Bot commented Jun 1, 2026

Deploy Preview for esphome ready!

Name Link
🔨 Latest commit af892fd
🔍 Latest deploy log https://app.netlify.com/projects/esphome/deploys/6a1cda5227e7390008993475
😎 Deploy Preview https://deploy-preview-6715--esphome.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.
🤖 Make changes Run an agent on this branch

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

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.

2 participants