From bf3fb306ac3b523647c979fba149bde3f86de74b Mon Sep 17 00:00:00 2001 From: poulou <48758557+poulou0@users.noreply.github.com> Date: Thu, 19 Feb 2026 23:59:46 +0100 Subject: [PATCH 1/2] Some README markdown improvements --- README.md | 104 ++++++++++++++++++++----------------- usr/fbcp-ili9341/README.md | 4 +- usr/rpi-fbcp/README.md | 42 +++++++-------- 3 files changed, 77 insertions(+), 73 deletions(-) diff --git a/README.md b/README.md index 5abc325..1fcfd3e 100755 --- a/README.md +++ b/README.md @@ -11,118 +11,120 @@ https://github.com/lcdwiki/LCD-show-retropie Install drivers in the Raspbian system
==================================================== -Update:
+Update:
v2.1-20191106
Update to support MHS35B
-Update:
+Update:
v2.0-20190704
Update to support rotate the display direction
-Update:
+Update:
v1.9-20181204
Update to support MHS40 & MHS32
-Update:
+Update:
v1.8-20180907
Update to support MHS35
-Update:
+Update:
v1.7-20180320
Update to support Raspbian Version: March 2018(Release date:2018-03-13)
-Update:
+Update:
v1.6-20170824
Update xserver to support Raspbian-2017-08-16
-Update:
+Update:
v1.5-20170706
Update to support Raspbian-2017-07-05, Raspbian-2017-06-21
-Update:
+Update:
v1.3-20170612
fixed to support Raspbian-2017-03-02, Raspbian-2017-04-10
-Update:
+Update:
v1.2-20170302
Add xserver-xorg-input-evdev_1%3a2.10.3-1_armhf.deb to support Raspbian-2017-03-02
-Update:
+Update:
v1.1-20160815

# How to install the LCD driver of Raspberry Pi - -1.)Step1, Install Raspbian official mirror
+ +1.) Step1, Install Raspbian official mirror
==================================================== - a)Download Raspbian official mirror:
+ a) Download Raspbian official mirror:
https://www.raspberrypi.org/downloads/
- b)Use“SDFormatter.exe”to Format your TF Card
- c)Use“Win32DiskImager.exe” Burning mirror to TF Card
- + b) Use "SDFormatter.exe" to Format your TF Card
+ c) Use "Win32DiskImager.exe" Burning mirror to TF Card
+ 2.) Step2, Clone my repo onto your pi
==================================================== Use SSH to connect the Raspberry Pi,
And Ensure that the Raspberry Pi is connected to the Internet before executing the following commands: ----------------------------------------------------------------------------------------------------- -```sudo rm -rf LCD-show```
-```git clone https://github.com/goodtft/LCD-show.git```
-```chmod -R 755 LCD-show```
-```cd LCD-show/```
- -3.)Step3, According to your LCD's type, excute the corresponding driver: +```bash +sudo rm -rf LCD-show +git clone https://github.com/goodtft/LCD-show.git +chmod -R 755 LCD-show +cd LCD-show/ +``` + +3.) Step3, According to your LCD's type, execute the corresponding driver: ==================================================== -# 2.4” RPi Display (MPI2401): +# 2.4" RPi Display (MPI2401): ### Driver install: sudo ./LCD24-show ### WIKI: CN: http://www.lcdwiki.com/zh/2.4inch_RPi_Display
EN: http://www.lcdwiki.com/2.4inch_RPi_Display - -# 2.4” RPi Display For RPi 3A+ (MPI2411): + +# 2.4" RPi Display For RPi 3A+ (MPI2411): ### Driver install: sudo ./LCD24-3A+-show ### WIKI: CN: http://www.lcdwiki.com/zh/2.4inch_RPi_Display_For_RPi_3A+
EN: http://www.lcdwiki.com/2.4inch_RPi_Display_For_RPi_3A+ -# 2.8” RPi Display (MPI2801): +# 2.8" RPi Display (MPI2801): ### Driver install: sudo ./LCD28-show ### WIKI: CN: http://www.lcdwiki.com/zh/2.8inch_RPi_Display
EN: http://www.lcdwiki.com/2.8inch_RPi_Display - -# 3.2” RPi Display (MPI3201): + +# 3.2" RPi Display (MPI3201): ### Driver install: sudo ./LCD32-show ### WIKI: CN: http://www.lcdwiki.com/zh/3.2inch_RPi_Display
EN: http://www.lcdwiki.com/3.2inch_RPi_Display -# MHS-3.2” RPi Display (MHS3232): +# MHS-3.2" RPi Display (MHS3232): ### Driver install: sudo ./MHS32-show ### WIKI: CN: http://www.lcdwiki.com/zh/MHS-3.2inch_Display
EN: http://www.lcdwiki.com/MHS-3.2inch_Display -# 3.5” RPi Display(MPI3501): +# 3.5" RPi Display(MPI3501): ### Driver install: sudo ./LCD35-show ### WIKI: CN: http://www.lcdwiki.com/zh/3.5inch_RPi_Display
EN: http://www.lcdwiki.com/3.5inch_RPi_Display - -# 3.5” HDMI Display-B(MPI3508): + +# 3.5" HDMI Display-B(MPI3508): ### Driver install: sudo ./MPI3508-show ### WIKI: CN: http://www.lcdwiki.com/zh/3.5inch_HDMI_Display-B
EN: http://www.lcdwiki.com/3.5inch_HDMI_Display-B - -# MHS-3.5” RPi Display(MHS3528): + +# MHS-3.5" RPi Display(MHS3528): ### Driver install: sudo ./MHS35-show ### WIKI: CN: http://www.lcdwiki.com/zh/MHS-3.5inch_RPi_Display
EN:http://www.lcdwiki.com/MHS-3.5inch_RPi_Display -# MHS-3.5” RPi Display-B(MHS35XX): +# MHS-3.5" RPi Display-B(MHS35XX): ### Driver install: sudo ./MHS35B-show ### WIKI: @@ -135,42 +137,42 @@ sudo ./MPI4008-show ### WIKI: CN: http://www.lcdwiki.com/zh/4inch_HDMI_Display-C
EN: http://www.lcdwiki.com/4inch_HDMI_Display-C - + # MHS-4.0" HDMI Display-B(MHS4001): ### Driver install: sudo ./MHS40-show ### WIKI: CN: http://www.lcdwiki.com/zh/MHS-4.0inch_Display-B
EN: http://www.lcdwiki.com/MHS-4.0inch_Display-B - -# 5.0” HDMI Display(Resistance touch)(MPI5008): + +# 5.0" HDMI Display(Resistance touch)(MPI5008): ### Driver install: sudo ./LCD5-show ### WIKI: CN: http://www.lcdwiki.com/zh/5inch_HDMI_Display
EN: http://www.lcdwiki.com/5inch_HDMI_Display - + # 5inch HDMI Display-B(Capacitor touch)(MPI5001): ### Driver install: sudo ./MPI5001-show ### WIKI: CN: http://www.lcdwiki.com/zh/5inch_HDMI_Display-B
EN: http://www.lcdwiki.com/5inch_HDMI_Display-B - + # 7inch HDMI Display-B-800X480(MPI7001): ### Driver install: sudo ./LCD7B-show ### WIKI: CN: http://www.lcdwiki.com/zh/7inch_HDMI_Display-B
EN: http://www.lcdwiki.com/7inch_HDMI_Display-B - + # 7inch HDMI Display-C-1024X600(MPI7002): ### Driver install: sudo ./LCD7C-show ### WIKI: CN: http://www.lcdwiki.com/zh/7inch_HDMI_Display-C
EN: http://www.lcdwiki.com/7inch_HDMI_Display-C - + Wait for a moment after executing the above command, then you can use the corresponding raspberry LCD. @@ -182,19 +184,23 @@ This method only applies to the Raspberry Pi series of display screens, other di ### Method 1, If the driver is not installed, execute the following command (Raspberry Pi needs to connected to the Internet): -sudo rm -rf LCD-show
-git clone https://github.com/goodtft/LCD-show.git
-chmod -R 755 LCD-show
-cd LCD-show/
-sudo ./XXX-show 90
+```bash +sudo rm -rf LCD-show +git clone https://github.com/goodtft/LCD-show.git +chmod -R 755 LCD-show +cd LCD-show/ +sudo ./XXX-show 90 +``` After execution, the driver will be installed. The system will automatically restart, and the display screen will rotate 90 degrees to display and touch normally.
( ' XXX-show ' can be changed to the corresponding driver, and ' 90 ' can be changed to 0, 90, 180 and 270, respectively representing rotation angles of 0 degrees, 90 degrees, 180 degrees, 270 degrees)
### Method 2, If the driver is already installed, execute the following command: -cd LCD-show/
-sudo ./rotate.sh 90
+```bash +cd LCD-show/ +sudo ./rotate.sh 90 +``` After execution, the system will automatically restart, and the display screen will rotate 90 degrees to display and touch normally.
( ' 90 ' can be changed to 0, 90, 180 and 270, respectively representing rotation angles of 0 degrees, 90 degrees, 180 degrees, 270 degrees)
diff --git a/usr/fbcp-ili9341/README.md b/usr/fbcp-ili9341/README.md index cfe85d1..b79ebd0 100644 --- a/usr/fbcp-ili9341/README.md +++ b/usr/fbcp-ili9341/README.md @@ -114,7 +114,7 @@ When using one of the displays that stack on top of the Pi that are already reco - `-DADAFRUIT_HX8357D_PITFT=ON`: If you have the [Adafruit PiTFT - Assembled 480x320 3.5" TFT+Touchscreen for Raspberry Pi](https://www.adafruit.com/product/2097) display, add this line. - `-DFREEPLAYTECH_WAVESHARE32B=ON`: If you are running on the [Freeplay CM3 or Zero](https://www.freeplaytech.com/product/freeplay-cm3-diy-kit/) device, pass this flag. (this is not a hat, but still a preconfigured pin assignment) - `-DWAVESHARE35B_ILI9486=ON`: If specified, targets a [Waveshare 3.5" 480x320 ILI9486](https://www.amazon.co.uk/dp/B01N48NOXI/ref=pe_3187911_185740111_TE_item) display. -- `-DTONTEC_MZ61581=ON`: If you are running on the [Tontec 3.5" 320x480 LCD Display](https://www.ebay.com/p/Tontec-3-5-Inches-Touch-Screen-for-Raspberry-Pi-Display-TFT-Monitor-480x320-LCD/1649448059) display, pass this. +- `-DTONTEC_MZ61581=ON`: If you are running on the [Tontec 3.5" 320x480 LCD](https://www.ebay.com/p/Tontec-3-5-Inches-Touch-Screen-for-Raspberry-Pi-Display-TFT-Monitor-480x320-LCD/1649448059) display, pass this. - `-DWAVESHARE_ST7789VW_HAT=ON`: If specified, targets a [240x240, 1.3inch IPS LCD display HAT for Raspberry Pi](https://www.waveshare.com/1.3inch-lcd-hat.htm) with ST7789VW display controller. - `-DWAVESHARE_ST7735S_HAT=ON`: If specified, targets a [128x128, 1.44inch LCD display HAT for Raspberry Pi](https://www.waveshare.com/1.3inch-lcd-hat.htm) with ST7735S display controller. - `-DKEDEI_V63_MPI3501=ON`: If specified, targets a [KeDei 3.5 inch SPI TFTLCD 480*320 16bit/18bit version 6.3 2018/4/9](https://github.com/juj/fbcp-ili9341/issues/40) display with MPI3501 display controller. @@ -511,7 +511,7 @@ If the color channels are mixed (red is blue, blue is red, green is green) like If the color intensities look wrong (white is black, black is white, color looks like a negative image) like seen in the middle image, pass the CMake option `-DDISPLAY_INVERT_COLORS=ON` to the build. -If the colors looks off in some other fashion, it is possible that the display is just being driven at a too high SPI bus speed, in which case try making the display run slower by choosing a higher `-DSPI_BUS_CLOCK_DIVISOR=` option to CMake. Especially on ILI9486 displays it has been observed that the colors on the display can become distorted if the display is run too fast beyond its maximum capability. +If the colors look off in some other fashion, it is possible that the display is just being driven at a too high SPI bus speed, in which case try making the display run slower by choosing a higher `-DSPI_BUS_CLOCK_DIVISOR=` option to CMake. Especially on ILI9486 displays it has been observed that the colors on the display can become distorted if the display is run too fast beyond its maximum capability. #### Failed to allocate GPU memory! diff --git a/usr/rpi-fbcp/README.md b/usr/rpi-fbcp/README.md index ec533ef..9736022 100644 --- a/usr/rpi-fbcp/README.md +++ b/usr/rpi-fbcp/README.md @@ -1,6 +1,6 @@ Raspberry Pi Framebuffer Copy ============================= -This program used for copy primary framebuffer to secondary framebuffer (eg. FBTFT). It require lastest raspberry pi firmware (> 2013-07-11) to working properly. +This program is used for copying the primary framebuffer to secondary framebuffer (e.g. FBTFT). It requires the lastest raspberry pi firmware (> 2013-07-11) to work properly. Tested on Raspberry Pi 3 ======================== @@ -10,32 +10,30 @@ Tested on Raspberry Pi 3 Requirement ----------- cmake - -$ sudo apt-get install cmake - +```bash +sudo apt-get install cmake +``` Build ----- - - $ mkdir build - - $ cd build - - $ cmake .. - - $ make - - +```bash +mkdir build +cd build +cmake .. +make +``` How To Use ---------- -$ ./fbcp - -Wanna to run from booting +```bash +./fbcp +``` +Wanna run at boot ------------------------- -$ sudo cp fbcp /usr/bin -$ sudo chmod +x /usr/bin/fbcp -$ sudo nano /etc/rc.local -> add new line before "exit 0" with "/usr/bin/fbcp &" without quote -$ sudo reboot - +```bash +sudo cp fbcp /usr/bin +sudo chmod +x /usr/bin/fbcp +sudo nano /etc/rc.local -> add new line before "exit 0" with "/usr/bin/fbcp &" without quote +sudo reboot +``` License ------- From 9af79eff3c0ec2acc652a5add5c1f73c57318d8a Mon Sep 17 00:00:00 2001 From: poulou <48758557+poulou0@users.noreply.github.com> Date: Fri, 20 Feb 2026 00:08:27 +0100 Subject: [PATCH 2/2] adjust command comment --- usr/rpi-fbcp/README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/usr/rpi-fbcp/README.md b/usr/rpi-fbcp/README.md index 9736022..5e5c975 100644 --- a/usr/rpi-fbcp/README.md +++ b/usr/rpi-fbcp/README.md @@ -31,7 +31,7 @@ Wanna run at boot ```bash sudo cp fbcp /usr/bin sudo chmod +x /usr/bin/fbcp -sudo nano /etc/rc.local -> add new line before "exit 0" with "/usr/bin/fbcp &" without quote +sudo nano /etc/rc.local # add new line before "exit 0" with "/usr/bin/fbcp &" without quote sudo reboot ```