You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This PR adds backlight GPIO control to the ILI9341 display binding and introduces a comprehensive gaming performance benchmark sample. This work originated from AkiraOS - a retro-cyberpunk gaming console project built on Zephyr RTOS.
Motivation
During AkiraOS development, we identified critical needs for ILI9341-based gaming applications:
Power Management: Battery-powered gaming devices need backlight control for power saving
Performance Understanding: Gaming requires 30-60 FPS, but baseline full-screen updates take ~350ms
Documentation Gap: No existing samples demonstrated gaming-specific display usage
Changes Made
1. Devicetree Binding Enhancement
File: dts/bindings/display/ilitek,ili9341.yaml
Added optional bl-gpios property for backlight control:
bl-gpios:
type: phandle-arraydescription: | Backlight GPIO control pin (optional). Controls the display backlight on/off state for power management.
M dts/bindings/display/ilitek,ili9341.yaml
A samples/drivers/display/ili9341_gaming/CMakeLists.txt
A samples/drivers/display/ili9341_gaming/README.rst
A samples/drivers/display/ili9341_gaming/boards/esp32s3_devkitm_procpu.overlay
A samples/drivers/display/ili9341_gaming/prj.conf
A samples/drivers/display/ili9341_gaming/sample.yaml
A samples/drivers/display/ili9341_gaming/src/main.c
Checklist
Follows Zephyr coding style
Includes comprehensive documentation
Tested on target hardware
Includes sample.yaml for CI
Signed-off-by present
References real-world project (AkiraOS)
No breaking changes
Related Issues
This addresses the need for:
Display backlight control in gaming applications
Performance benchmarking for gaming workloads
Documentation of ILI9341 gaming usage patterns
Future Work
Based on AkiraOS development, potential future enhancements:
Hello @ArturR0k3r, and thank you very much for your first pull request to the Zephyr project!
Our Continuous Integration pipeline will execute a series of checks on your Pull Request commit messages and code, and you are expected to address any failures by updating the PR. Please take a look at our commit message guidelines to find out how to format your commit messages, and at our contribution workflow to understand how to update your Pull Request. If you haven't already, please make sure to review the project's Contributor Expectations and update (by amending and force-pushing the commits) your pull request if necessary.
If you are stuck or need help please join us on Discord and ask your question there. Additionally, you can escalate the review when applicable. 😊
Add optional backlight GPIO control property to ILI9341 display binding.
This enables power management and user comfort features essential for
battery-powered gaming devices.
Developed during AkiraOS project - a retro-cyberpunk gaming console on
Zephyr RTOS. Backlight control is critical for battery life and user
experience in portable gaming applications.
Features enabled:
- On/off backlight control for power saving
- User comfort adjustments
- Screen effects in gaming applications
Example usage:
&ili9341 {
bl-gpios = <&gpio0 27 GPIO_ACTIVE_HIGH>;
};
Tested-on: ESP32-S3 DevKitM with ILI9341 320x240 display
Project: https://github.com/ArturR0k3r/AkiraOS
Signed-off-by: ArturR0k3r <[email protected]>
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
zephyrbot
added
area: Boards/SoCs
area: Devicetree Bindings
area: Samples
ArturSir
force-pushed
the
feature/ili9341-akira-gaming-optimizations
branch
from
Overview
This PR adds backlight GPIO control to the ILI9341 display binding and introduces a comprehensive gaming performance benchmark sample. This work originated from AkiraOS - a retro-cyberpunk gaming console project built on Zephyr RTOS.
Motivation
During AkiraOS development, we identified critical needs for ILI9341-based gaming applications:
Changes Made
1. Devicetree Binding Enhancement
File:
dts/bindings/display/ilitek,ili9341.yamlAdded optional
bl-gpiosproperty for backlight control:Benefits:
2. Gaming Performance Sample
Directory:
samples/drivers/display/ili9341_gaming/Complete sample application demonstrating:
Key Features:
Testing
Hardware Tested:
Test Results:
Sample Configuration:
sample.yamlfor CI testingREADME.rstAkiraOS Project Context
Project: https://github.com/ArturR0k3r/AkiraOS
AkiraOS is an open-source retro-cyberpunk gaming console featuring:
This contribution demonstrates how Zephyr enables innovative gaming projects while identifying areas for optimization.
Why This Sample Matters
Performance Analysis Included
The sample documents critical gaming metrics:
Files Changed
Checklist
Related Issues
This addresses the need for:
Future Work
Based on AkiraOS development, potential future enhancements: