For Raspberry Pi OS/Ubuntu/Kali and Retropie system:
1. Connect the TF card to the PC, download and use Raspberry Pi Imager to program the corresponding system.2. After installing the imager, open the "config.txt" file on the TF card root directory, add the following codes at the end of "config.txt", and then safely remove the TF card.Note: as there are two MIPI DSI interfaces on the Pi5/CM4/CM3+/CM3, please pay attention to using the correct DSI interface and commands, and the DSI1 interface is recommended. dtoverlay=vc4-kms-v3d#DSI1 Usedtoverlay=vc4-kms-dsi-7inch#DSI0 Use#dtoverlay=vc4-kms-dsi-7inch,dsi03. Insert the TF card into the Raspberry Pi, power it up, and wait for a few seconds for the display. Once the system boots up, you should be able to interact with it normally, including touchscreen functionality.Backlight ControlWaveShare provides the corresponding demo for the application (only supports Bookworm and Bullseye systems). Users can install it by the following commands:
wget https://files.waveshare.com/upload/f/f4/Brightness.zipunzip Brightness.zipcd Brightnesssudo chmod +x install.sh./install.shAfter installation, you can open it: Menu -》Accessories -》Brightness:
In addition, you can also input the following commands to control the backlight brightness:
echo X | sudo tee /sys/class/backlight/*/brightnessWhere X indicates any number from 0 to 255. 0 means the backlight is the darkest, and 255 means the backlight is the brightest. For example:
echo 100 | sudo tee /sys/class/backlight/*/brightnessecho 0 | sudo tee /sys/class/backlight/*/brightnessecho 255 | sudo tee /sys/class/backlight/*/brightnessBookworm Touchscreen Rotation1. Open "Screen Configuration" application:2. Enter "Screen" -> "DS-1" -> "Touchscreen", and select "6-0038 generic ft5x06(79)".3. Click "Apply", and then close the current window. Reboot according to the pop-up prompts to complete the specified touchscreen;4. Enter "Screen" -> "DS-1"->"Orientation", and select the rotation direction. Then click on "Apply".
Note: Only the Bookworm system supports the above-synchronized rotation method, for Bullseye and Butser systems, after displaying the rotation, you need to set the touch rotation additionally.
Bullseye/Buster Display Rotation1. Open "Screen Configuration" application:2. Enter "Screen"->"DS-1"->"Orientation", select the rotation direction, and then click on "Apply". Stretch/Jessie Display RotationFor some older systems, which do not use the vc4-kms-v3d or vc4-fkms-v3d driver modes, the display rotation method is as follows:
1. Add statements to the config.txt file (the config file is located in the root directory of the TF card, i.e. /boot)：display_rotate=1 #1：90；2: 180； 3: 2702. Just save and reboot the Raspberry Pi:sudo rebootTouch RotationSome systems show inconsistent touch direction after rotation, requiring touch rotation as below:1. Install libinput
sudo apt-get install xserver-xorg-input-libinput2. If the system you installed is an Ubuntu system, or Jetson Nano, the installation command is:
sudo apt install xserver-xorg-input-synaptics3. .Create the xorg.conf.d directory under /etc/X11/ (if this directory already exists, this goes directly to step 3):
sudo mkdir /etc/X11/xorg.conf.d4. Copy "40-libinput-conf" file to the directory just created:
sudo cp /usr/share/X11/xorg.conf.d/40-libinput.conf /etc/X11/xorg.conf.d/5. Edit:
sudo nano /etc/X11/xorg.conf.d/40-libinput.conf #Find the touchscreen part, add the corresponding commands to rotate, and then save: #90°Right touch rotation: Option "CalibrationMatrix" "0 1 0 -1 0 1 0 0 1"#180° Inverted touch rotation:#Option "CalibrationMatrix" "-1 0 1 0 -1 1 0 0 1"#270° Left rotation:#Option "CalibrationMatrix" "0 -1 1 1 0 0 0 0 1"As shown below:6. Reboot the Raspberry Pi:
sudo rebootThe touch will be rotated after completing the above steps.
SleepRun the following commands on the Raspberry Pi terminal, and the screen will enter sleep mode:
xset dpms force offThe above command is only for Bullseye and Buster systems.
Disable touchAt the end of the config.txt file, add the following command corresponding to disabling touch (the config file is located in the root directory of the TF card and can also be accessed via the command: sudo nano /boot/config.txt):
disable_touchscreen=1Note: Reboot to take effect after adding the command.
ResourcesSoftwarePanasonic SDFormatterWin32DiskImagerPuTTYDrawing4.3inch DSI LCD 3D DrawingFAQQuestion:When using the Bookworm system with Pi5, encountering an issue where the DSI LCD is not displaying. How can this be resolved? Answer:Check the system version using "uname --all". If it's kernel version 6.6.20, run "sudo apt-get update""sudo apt-get full-upgrade -y" to fix it.Note: Take care to back up any important data in your image before updating it in case there is a regression.
{{{5}}}
Question:How to use 4.3inch DSI LCD on Raspberry Pi 5? Answer:The hardware connection between DSI LCD and Pi5:(1) A DSI cable (official Raspberry Pi cable or Waveshare Pi5-Display-Cable-200mm) for Pi 5 is required. Please ensure the proper orientation with the SODIMM.(2) Priority usage for Pi5's DSI1 interface.
If use the DSI0 interface, you need to add "dtoverlay=vc4-kms-dsi-7inch,dsi0" in the config.txt file2. Check the DSI LCD version.(1) The latest DSI LCD version compatible with Pi5 is Rev2.2, which can be directly used.(2) If you purchased the product earlier, such as the Rev2.1 version (or older), due to the power detection mechanism of Pi5, it may misidentify the capacitors on the DSI LCD as a false short-circuit state, preventing the system from booting. In this situation, you can manually remove the large capacitors at the four positions marked in red circles in the image below.3. Software Setup:For the Pi5, use the Bookworm system. (Please note, Pi5 currently only supports Bookworm, not Bullseye or Buster).(1) Go to the Raspberry Pi official website: https://www.raspberrypi.com/software/operating-systems/. Download the latest version of the Bookworm image. Download the compressed file to your PC and extract it to obtain the .img file.(2) Connect the microSD card (TF card) to your PC and use the SDFormatter software to format the microSD card.(3) Open the Win32DiskImager software. Select the system image prepared in Step 1 and click 'Write' to burn the system image.(4) After the writing process is complete, open the "config.txt" file in the root directory of the microSD card. Add the following code at the end of "config.txt", save it, and safely eject the microSD card.
dtoverlay=vc4-kms-v3ddtoverlay=vc4-kms-dsi-7inch(5) Insert the TF card into the Raspberry Pi, power it, and then enter after waiting for a few seconds. Then, the system boots and can be touched.
Note that if use the DSI0 interface at the same time, you need to add the additional commands: "dtoverlay=vc4-kms-dsi-7inch,dsi0"{{{5}}}
Question: What is the power consumption of 4.3inch DSI LCD? Answer:Power supply using Raspberry Pi DSI interface, power consumption about 1.2W or so.
{{{5}}}
Question: What is the maximum brightness of a 4.3inch DSI LCD? Answer:370cd/m²
{{{3}}}{{{4}}}{{{5}}}
Question: What is the overall thickness of the 4.3inch DSI LCD? Answer:14.05mm
{{{3}}}{{{4}}}{{{5}}}
Question:How to adjust the backlight? Answer:You need to remove the resistor, wire the left pad to P1 of Raspberry Pi, and control it by PWM.
gpio -g pwm 18 0gpio -g mode 18 pwmgpio pwmc 1000gpio -g pwm 18 X（X is in range 0~1024, 0: Darkest, 1024: brightest）PS: To ensure a good customer experience, the default factory minimum brightness is the visible state. If you need to completely turn off the backlight to achieve a black screen effect, please manually change the 100K resistor in the picture below to a 68K resistor (Chip resistor 68K 0603 ±1%).For Rev2.2:As shown in the diagram, first remove the originally soldered resistor, then connect the solder pad of the resistor (left solder pad) to the P1 pin of the Raspberry Pi, enabling control of the backlight using GPIO.PS: The default factory minimum brightness for the visual state, if you need to completely turn off the backlight to realize the black screen effect, you can change the 100K resistor to 68K resistor manually in the following picture:
{{{3}}}{{{4}}}{{{5}}}
Question:Does this screen not automatically rest, or must the command be executed to rest the screen? Answer:It depends on the system. If the system is hibernated, the screen will also be black. If it is the official Raspberry Pi system, the default ten minutes or so without action is to have hibernation.
{{{5}}}
Anti-PiracySince the first-generation Raspberry Pi released, Waveshare has been working on designing, developing, and producing various fantastic touch LCDs for the Pi. Unfortunately, there are quite a few pirated/knock-off products in the market. They're usually some poor copies of our early hardware revisions, and comes with none support service.
To avoid becoming a victim of pirated products, please pay attention to the following features when purchasing:
(Click to enlarge)
Beware of knock-offsPlease note that we've found some poor copies of this item in the market. They are usually made of inferior materials and shipped without any testing.
You might be wondering if the one you're watching or you've purchased in other non-official stores is original, feel free to contact us.
SupportTechnical Support
If you need technical support or have any feedback/review, please click the Submit Now button to submit a ticket, Our support team will check and reply to you within 1 to 2 working days. Please be patient as we make every effort to help you to resolve the issue.Working Time: 9 AM - 6 PM GMT+8 (Monday to Friday)
Submit Now