feat(gpio): new functional interrupt lambda example

[SuGlider]

Description:

This pull request introduces a comprehensive example for using lambda functions with FunctionalInterrupt in ESP32 GPIO interrupt handling. It includes both code and documentation updates to demonstrate advanced debouncing techniques, edge detection, and best practices for interrupt-safe lambda functions.

Code Enhancements:

• Added a complete example in FunctionalInterruptLambda.ino showcasing two interrupt handling patterns:
  • CHANGE mode lambda for dual-edge detection with state-based debouncing and object method integration.
  • FALLING mode lambda with pointer captures, LED control, and hardware debouncing.

Documentation Updates:

• Created a detailed README.md explaining:
  • The hardware setup and interrupt behavior on ESP32.
  • Lambda function patterns, debouncing strategies, and best practices for safe ISR handling.
  • Example outputs and expected behavior for the provided code.## Description of Change
    Please describe your proposed Pull Request and it's impact.

Tests scenarios

Tested using ESP32-S3 and the provided example

Related links

None

[github-actions]

	Messages
📖	🎉 Good Job! All checks are passing!

👋 Hello SuGlider, we appreciate your contribution to this project!

---

📘 Please review the project's Contributions Guide for key guidelines on code, documentation, testing, and more.

---

🖊️ Please also make sure you have read and signed the Contributor License Agreement for this project.

---

Click to see more instructions ...

This automated output is generated by the PR linter DangerJS, which checks if your Pull Request meets the project's requirements and helps you fix potential issues.

DangerJS is triggered with each push event to a Pull Request and modify the contents of this comment.

Please consider the following:
- Danger mainly focuses on the PR structure and formatting and can't understand the meaning behind your code or changes.
- Danger is not a substitute for human code reviews; it's still important to request a code review from your colleagues.
- To manually retry these Danger checks, please navigate to the Actions tab and re-run last Danger workflow.

Review and merge process you can expect ...

We do welcome contributions in the form of bug reports, feature requests and pull requests.

1. An internal issue has been created for the PR, we assign it to the relevant engineer.
2. They review the PR and either approve it or ask you for changes or clarifications.
3. Once the GitHub PR is approved we do the final review, collect approvals from core owners and make sure all the automated tests are passing.
- At this point we may do some adjustments to the proposed change, or extend it by adding tests or documentation.
4. If the change is approved and passes the tests it is merged into the default branch.

Generated by 🚫 dangerJS against e699b1a

[Copilot]

Pull Request Overview

This PR adds a complete ESP32 GPIO interrupt example using lambda functions with the FunctionalInterrupt library, showcasing dual-edge and single-edge patterns with advanced debouncing.

• Introduces a detailed README.md that explains hardware setup, lambda patterns, debouncing strategies, and best practices.
• Adds FunctionalInterruptLambda.ino, demonstrating two interrupt handlers: a CHANGE-mode lambda with object method integration and a FALLING-mode lambda with pointer captures and LED control.

Reviewed Changes

Copilot reviewed 2 out of 2 changed files in this pull request and generated 1 comment.

File	Description
libraries/ESP32/examples/GPIO/FunctionalInterruptLambda/README.md	New example documentation detailing setup, patterns, and advice
libraries/ESP32/examples/GPIO/FunctionalInterruptLambda/FunctionalInterruptLambda.ino	Arduino sketch with two lambda-based interrupt handlers and debouncing

Comments suppressed due to low confidence (3)

libraries/ESP32/examples/GPIO/FunctionalInterruptLambda/FunctionalInterruptLambda.ino:134

• [nitpick] The variable name handlerPtr is generic—consider renaming it to buttonHandlerPtr or globalHandlerPtr to clarify that it references the button interrupt handler instance.

  InterruptHandler* handlerPtr = &globalHandler;

libraries/ESP32/examples/GPIO/FunctionalInterruptLambda/README.md:20

• [nitpick] Consider adding a note that BOOT pin availability and pin number may vary between ESP32 board variants, and users should verify the correct pin definition (e.g., BOOT_PIN) for their board.

- Optionally connect a second button to BOOT pin for advanced examples

libraries/ESP32/examples/GPIO/FunctionalInterruptLambda/FunctionalInterruptLambda.ino:56

• Using BOOT_PIN directly may cause a compilation error if BOOT_PIN is not defined for the target board. Consider adding a fallback definition, e.g., #ifndef BOOT_PIN / #define BOOT_PIN 0 / #endif, or document that BOOT_PIN must be defined.

#define BUTTON2_PIN     BOOT_PIN // BOOT BUTTON - change as needed

[github-actions]

Memory usage test (comparing PR against master branch)

The table below shows the summary of memory usage change (decrease - increase) in bytes and percentage for each target.

Memory	FLASH [bytes]		FLASH [%]		RAM [bytes]		RAM [%]
Target	DEC	INC	DEC	INC	DEC	INC	DEC	INC
ESP32P4	0	0	0.00	0.00	0	0	0.00	0.00
ESP32S3	0	0	0.00	0.00	0	0	0.00	0.00
ESP32S2	0	0	0.00	0.00	0	0	0.00	0.00
ESP32C3	0	0	0.00	0.00	0	0	0.00	0.00
ESP32C6	0	0	0.00	0.00	0	0	0.00	0.00
ESP32H2	0	0	0.00	0.00	0	0	0.00	0.00
ESP32	0	0	0.00	0.00	0	0	0.00	0.00

Click to expand the detailed deltas report [usage change in BYTES]

Target	ESP32P4		ESP32S3		ESP32S2		ESP32C3		ESP32C6		ESP32H2		ESP32
Example	FLASH	RAM	FLASH	RAM	FLASH	RAM	FLASH	RAM	FLASH	RAM	FLASH	RAM	FLASH	RAM
libraries/ESP32/examples/GPIO/FunctionalInterruptLambda	-	-	-	-	-	-	-	-	-	-	-	-	-	-