Skip to content
View in the app

A better way to browse. Learn more.

Armbian Community Forums

A full-screen app on your home screen with push notifications, badges and more.

To install this app on iOS and iPadOS
  1. Tap the Share icon in Safari
  2. Scroll the menu and tap Add to Home Screen.
  3. Tap Add in the top-right corner.
To install this app on Android
  1. Tap the 3-dot menu (⋮) in the top-right corner of the browser.
  2. Tap Add to Home screen or Install app.
  3. Confirm by tapping Install.

Banana Pi Pro: LeMaker LCD panels (3.5"/5"/7" + touch) on mainline kernel, WIP

Featured Replies

Hi,

I'm working on bringing back support for the original LeMaker LCD
panels on the Banana Pi Pro (LeMaker Banana Pro, A20) with current
Armbian kernels. The old script.bin / fex files only worked with
sunxi-3.4, so I ported the settings to device tree overlays:

- 3.5" RGB 320x240 (BL035-RGB-002, already in panel-simple)
- 5" RGB 800x480 (panel-dpi)
- 7" LVDS 1024x600 (panel-lvds)
- FT5x06 touch for all three (edt-ft5x06 driver)

Repository: https://github.com/cyryllo/fex_configuration

The overlays compile and apply cleanly to sun7i-a20-bananapro.dtb
(kernel 6.18). I'm now building a Debian 13 (trixie) minimal image
with the Armbian build framework that includes the overlays and the
edt-ft5x06 module, and I'll test it on my 5" and 7" panels.
I don't have the 3.5" panel, so testers are welcome.

Plan once it's tested:
- enable CONFIG_TOUCHSCREEN_EDT_FT5X06=m in the sunxi kernel config
- submit the overlays, so the panels work on standard images

I've also applied to become the maintainer of this board, as it
currently has none.
 

Feedback and test reports are very welcome.
 

  • Author

Quick update: the LeMaker panels work on current kernels!

I've tested the 5" and 7" panels on real hardware, and both work on the Banana Pi Pro as well as on the original Banana Pi (non-Pro), using the same image (Armbian Debian 13 trixie, kernel 6.18). The picture appears as soon as the kernel starts, the backlight works too. The 3.5" panel is still untested since I don't have it, but it shares almost everything with the 5" one, so it will most likely work as well.

The minimal image has no desktop, so I couldn't check touch yet. I'm now preparing an image with the XFCE desktop, which also includes a simple script to switch panels after boot (sudo lemaker-lcd 5 / 7 / 35 / off), so a single image will work with every panel. I'll post soon whether touch works too.

Overlays, build scripts and images: https://github.com/cyryllo/fex_configuration
 

IMG20261026222353.jpg

IMG20261026220905.jpg

  • Author

Update: touch works now!

The LeMaker 7" panel works completely on the Banana Pi Pro with a current kernel (Armbian Debian 13 trixie, kernel 6.18): display, backlight and touch. The 5" panel works too (display confirmed, touch uses exactly the same controller and wiring as the 7"), and the same image also runs on the original Banana Pi.

Getting touch to work needed two fixes. First, the pin called ctp_wakeup in the old fex files (PH7) is actually the RESET line of the FT5x06 controller. Described as a "wake" pin, the edt-ft5x06 driver only waits 5 ms after power-up, and the controller doesn't answer yet. Described as reset-gpios, the driver waits 300 ms and the controller responds. Second, at boot the driver's first probe always fails with an I2C bus error (mv64xxx Ctlr Error, status 0x0, error -11), while the same probe a moment later succeeds. For now a small systemd service retries binding the driver after boot, so touch works right away. If anyone has an idea what causes that first I2C error on the A20, I'd be happy to hear it.

There's now a single image for all panels with the XFCE desktop. The 7" panel is enabled by default, and you can switch panels with sudo lemaker-lcd 5 (or 35, 7, off) followed by a reboot, or by uncommenting one line in /boot/armbianEnv.txt.

Image, overlays and build scripts: https://github.com/cyryllo/fex_configuration/releases

 

https://photos.app.goo.gl/pM8WR9rU6tHn9ESh9

Edited by Cyryl Sochacki

Hey @Cyryl Sochacki ,

thanks a lot for this work. Now my 12 year old SBCs can continue working.

I have one problem: When I boot the Banana without connected HDMI the display works, but with HDMI connected I get the flicker und no stable picture on the lcd.

Steffen

Edited by sgei

  • Author

17 hours ago, sgei said:

I have one problem: When I boot the Banana without connected HDMI the display works, but with HDMI connected I get the flicker und no stable picture on the lcd.

Thanks a lot for the kind words and for the report!

I found the cause: in the mainline kernel the LCD and HDMI share the same clock (PLL3). When HDMI is connected at boot, it reprograms that clock after the LCD has been set up, so the LCD ends up with a wrong pixel clock and the picture becomes unstable.

I’ll fix this in the next version of the overlays. Until then, the simplest workaround is to boot without the HDMI cable connected.

Could you tell me which screen you are using (5" or 7")? That will help me test the fix.

  • Author

@sgei
New images are up: v0.5, with the LCD and an HDMI monitor working at the same time.

Thanks for reporting the flickering. The cause was in the kernel: the LCD and HDMI share one clock source (PLL3) on the A20. When HDMI starts, it changes that clock after the LCD has already set it, so the LCD ends up with a wrong pixel clock and the picture flickers or isn't stable. The LCD clocks are now chosen so that they come from the same 297 MHz that HDMI uses, so they no longer fight over it. HDMI is set to 1920x1080 by default (1080p and 720p are the modes that match the LCD).

There are two images. The XFCE image has the 7" panel enabled by default (the new 7-hdmi variant, it works with and without an HDMI monitor, about 50 Hz). The minimal image has no desktop and the LCD disabled, as a base for your own setup. You can switch panels with sudo lemaker-lcd 7-hdmi (or 7, 5, 35, off) followed by a reboot. If you don't need HDMI at all, there's also an overlay that turns it off. The release notes also explain how to change the brightness.

I've tested the 7" together with an HDMI monitor and it works fine for me now. Could you please flash the new image and confirm that the flickering is gone on your setup too? If something is still wrong, please tell me which panel you use, which HDMI resolution, and post the output of dmesg | grep -iE "sun4i|lvds|panel|hdmi" and cat /boot/armbianEnv.txt.

Download: https://github.com/cyryllo/fex_configuration/releases

The 5" panel got the same fix (29.7 MHz instead of 30 MHz), but I haven't tested it with HDMI yet, so reports from 5" users are very welcome too.

Hello @Cyryl Sochacki

First of all, thank you for your hard work, support, and efforts in providing operating system images and instructions for the Banana Pi and Banana Pi Pro. I really appreciate the work you have done to make these boards usable and accessible to the community.

I would like to ask if you have any plans to release an official, stable operating system version for the Banana Pi and Banana Pi Pro, preferably based on Debian and Ubuntu.

If possible, could you also share an estimated release date or development timeline for these official versions?

I have been using your unofficial OS images and following the instructions available online. Although I have managed to get things working, I am still relatively new to Linux, and some of the configuration steps are a little challenging for me.

It would be extremely helpful if you could also provide separate, easy-to-use scripts or utilities in English to configure the LCD and touchscreen features, including:

  1. Enable LCD: A script to install and enable the LCD display.

  2. Disable LCD: An option to disable the LCD when it is not needed.

  3. Enable Touchscreen: A script to install and enable touchscreen functionality when required.

  4. Disable Touchscreen: An option to disable touchscreen functionality if needed.

  5. Compatibility: Ideally, these scripts would work with standard Debian and Ubuntu installations, allowing users to configure the LCD and touchscreen without having to use a specially modified or unofficial OS image.

My goal is to use the Banana Pi and Banana Pi Pro with a clean, stable, and officially supported Linux operating system while still being able to use the LCD and touchscreen features whenever needed.

Having official Debian or Ubuntu images, along with simple English configuration scripts, would make these boards much easier to use, especially for beginners and users who prefer a standard Linux environment.

Thank you again for your time, dedication, and continued support of the Banana Pi community. I look forward to hearing about your plans for future official OS releases.

  • Author

Hi, and thank you for the kind words!

Official Armbian images
I have already submitted the LCD and touchscreen support directly to the Armbian project, and all of it has been accepted and merged into their repository. Armbian builds its images automatically, so it is only a matter of time before the official Armbian images (Debian and Ubuntu based) include this support out of the box. I can’t give you an exact date, because that depends on Armbian’s build schedule, not on me.

Until then, you can use the ready images from my repository: https://github.com/cyryllo/banana-a20 (Releases page). They work the same way as the official ones will.

How to switch the LCD today
Armbian has a standard way of turning hardware features on and off: one line in a configuration file. Open it:

sudo nano /boot/armbianEnv.txt

Find (or add) the overlays= line and set your panel, for example:

overlays=lemaker-lcd7

Then save and reboot (sudo reboot). The available values are:

  • lemaker-lcd5: 5" panel (works together with HDMI)

  • lemaker-lcd7: 7" panel, without HDMI

  • lemaker-lcd7-hdmi: 7" panel, when an HDMI monitor is also connected

To turn the LCD off, remove the lemaker-lcd... value and reboot. The touchscreen is included and turns on and off together with the panel, so there is nothing extra to install. If you prefer menus over editing files, sudo armbian-config can switch overlays too.

A few tips:

  • Use only one lemaker-lcd... value at a time.

  • If you use LCD and HDMI together, keep HDMI at 1920x1080 or 1280x720, otherwise the LCD may flicker.

  • The /boot folder is on the Linux partition, so you can’t edit it from Windows. Boot once with an HDMI monitor, or log in over SSH, to change the setting.

  • The official kernel update available right now does not contain the LCD support yet. If you use my image, keep its kernel until a newer official one is released: sudo apt-mark hold linux-image-current-sunxi linux-dtb-current-sunxi

Easy scripts are coming
Thank you for the idea with the scripts, it makes a lot of sense for beginners. When I have some free time, I will add them to my repository as a .deb package. It will let you switch the LCD and touchscreen on and off with simple commands, and it will come with instructions in English. I’ll post an update here when it’s ready.

Everything also works on the original Banana Pi (non-Pro). More details are in the README.

Thanks again, and enjoy your Banana Pi!

  • Author

Hi @randomperson007,

I made a small tool for the LeMaker LCD panels on the Banana Pi / Banana Pro with Armbian. It's called lemaker-screen, and with it you don't need to edit /boot/armbianEnv.txt by hand. It can:

  • choose the screen: no LCD (HDMI only), 5", 7", or 7" together with an HDMI monitor,

  • set the backlight brightness,

  • reset the touch controller when touch stops working or reacts on its own,

  • turn on the HDMI 1920x1080 mode needed when the LCD and HDMI work together.

There is a small window (menu → Settings → LeMaker screen) and the same functions as commands, for systems without a desktop or over SSH.

Description: https://github.com/cyryllo/banana-a20/tree/master/lemaker-screen

To install it on the board:

wget https://github.com/cyryllo/banana-a20/raw/master/lemaker-screen/dist/lemaker-screen_1.0.1_all.deb
sudo apt install --install-recommends ./lemaker-screen_1.0.1_all.deb

It needs an up-to-date Armbian with the lemaker-lcd overlays (sudo apt update && sudo apt full-upgrade). If something doesn't work for you, let me know.

Edited by Cyryl Sochacki

Join the conversation

You can post now and register later. If you have an account, sign in now to post with your account.
Note: Your post will require moderator approval before it will be visible.

Guest
Reply to this topic...

Account

Navigation

Search

Search

Configure browser push notifications

Chrome (Android)
  1. Tap the lock icon next to the address bar.
  2. Tap Permissions → Notifications.
  3. Adjust your preference.
Chrome (Desktop)
  1. Click the padlock icon in the address bar.
  2. Select Site settings.
  3. Find Notifications and adjust your preference.