LUCKFOX DSI Capacitive 7 inch Touch Screen User Guide

LUCKFOX DSI Capacitive 7-inch Touch Screen

Specifications

• Product Name: Luckfox 7inch DSI Touchscreen
• Supported Systems: Bullseye/Buster, Ubuntu, Jetson Nano
• Touch Technology: DSI Touchscreen

Product Usage Instructions

Display Rotation

1. For Bullseye/Buster Systems:
   • Enter Screen Configuration.
   • Rotate the display as instructed.
2. For Other Systems:
   • Add the specified line in the config.txt file.
   • Save the file and reboot the Raspberry Pi.

Touch Rotation

1. Install libinput:sudo apt-get installxserver-xorg-input-libinput
2. Create xorg.conf.d directory: sudo mkdir /etc/X11/xorg.conf.d
3. Copy and edit the configuration file: sudo cp /usr/share/X11/xorg.conf.d/40-libinput.conf/etc/X11/xorg.conf.d/``sudo nano /etc/X11/xorg.conf.d/40-libinput.conf
   • Find the touchscreen part and add the specified sentence.
4. Reboot the Raspberry Pi to apply touch rotation changes: sudo reboot

FAQ

How can I rotate the touch 90 degrees on the Luckfox 7-inch DSI Touchscreen?

To rotate the touch 90 degrees, edit the xorg.conf.d file with the specified Option CalibrationMatrix values and reboot the Raspberry Pi.

What is the special requirement for rotating the display in Repertier systems?

For Repertier systems, you need to edit the cmdline.txt file and add the specific rotation command on the same line.

PRODUCT PAR AMETERS

INTERFACE

SPECIFICATION

• Luckfox 7″ OSI Touchscreen, 800×480 IPS screen
• 5-point capacitive touch, with tempered glass panel
• Supports Raspberry Pi OS / Ubuntu / Kali and Retropie when used with Raspberry Pi, driver-free.
• Supports Debian/Ubuntu when used with Core3566, driver-free.
• Supports Linux/Android when used with Tinker Board 2, driver-free.
• Supports Debian when used with VisionFive2, driver-free.
• Support brightness adjusted by the software.

ACCESSORIES

Before using the product. please check if all the accessories are packaged properly and in perfect condition. If any cables or acces­sories are missed or broken, please contact Luckfox immediately.

PRODUCT SIZE

HOW TO INSTALL

1. Connect the FPC cable to the display
2. Fix the Raspberry Pi with screws. Connect the FPC cable
3. Connect the power supply
4. For the version with case: attach the case and fix it

SOFTWARE SETTING

It is used for Raspberry Pi OS/Ubuntu/Kali and Retropie systems.

1. Connect the TF card to the PC.
2. Download the latest version of the Raspberry Pi image from the Raspberry Pi’s official website and install it.
3. 0pen Raspberry Pi image, Select the TF card to write the image to (note: it is best to remove other U disk devices to prevent the U disk files from being erased), and the desired operating system.
4. Click the burn button to write the data to the TF card.
5. After programming, open the config.txt file in the root directory of the TF card and enter the following codes at the end of config.txt.
   • Then, save and safely eject the TF card.
   • dtoverlay=vc4-kms-v3d
   • dtoverlay=vc4-kms-dsi-7inch
6. Insert the TF card into the Raspberry Pi, power up the Raspberry Pi, wait for a few seconds normally and then it will display normally.

FAQ

1. How to control the screen brightness?
   • Input the following commands in the terminal to control the brightness: echo X > /sys/class/backlight/rpi_backlight/brightness :
   • Where X denotes any number from O to 255. 0 means the backlight is the dimmest. and 255 means the backlight is the brightest. For example: echo 100 > /sys/class/backlight/rpi_backlight/brightness
   • echo O > /sys/class/backlight/rpi_backlight/brightness :
   • echo 255 > /sys/class/backlight/rpi_backlight/brightness :
   • Note: The paths of different system versions may be different, the actual brightness file path shall prevail.
2. How to control screen sleep?
   • Use the following command set dpms force off :
3. How to disable screen touch?
   • Add the code “disable_touchscreen=1” to the config.txt file, and the touch function will be disabled after reboot.
4. Encountered more unsolvable problems?
   • Please check the wiki page https://wiki.luckfox.com/intro for more real-time updated usage information.

Display Rotation

If the system you used is Bullseye/Buster, you can rotate it in the following ways:

1. Enter Screen Configuration.
2. Rotate it as shown below:

If you use other systems, you can rotate it as shown below:

1. Add the following sentence in the config.txt file. (The config file is in the root directory (/boot) of the TF card.): display_rotate=1 #1：90；2: 180； 3: 270
2.  Save it and then reboot the Raspberry Pi. sudo reboot

Touch Rotation

As the touch direction is different after rotating, you need to rotate the touch as shown below:

1. Install libinput sudo apt-get install xserver-xorg-input-libinput
   • If the system you want to install is Ubuntu or Jetson Nano, the installation command is: sudo apt install xserver-xorg-input-Synaptics
2. Create xorg.conf.d directory in /etc/X11/. (If the directory exists, you can directly skip to Step 3.) sudo mkdir /etc/X11/xorg.conf.d
3. Copy 40-libinput-conf file to the directory created just now. sudo cp /usr/share/X11/xorg.conf.d/40-libinput.conf /etc/X11/xo rg.conf.d/
4. Edit the file. sudo nano /etc/X11/xorg.conf.d/40-libinput.conf
   • Find the touchscreen part, add the following sentence, and then save. Option “CalibrationMatrix” “0 1 0 -1 0 1 0 0 1”
   • As shown below:
5. Reboot the Raspberry Pi. sudo reboot
   • After finishing the above steps, the touch can be rotated 90 degrees.

Note:

• 90-degree rotation: Option “CalibrationMatrix” “0 1 0 -1 0 1 0 0 1”

• 180-degree rotation: Option “CalibrationMatrix” “-1 0 1 0 -1 1 0 0 1”

• 270-degree rotation: Option “CalibrationMatrix” “0 -1 1 1 0 0 0 0 1”
  NOTE: The reporter system has a special requirement to rotate in cmdline.txt.

• For Repertier systems, the rotation of “Display” is as follows: sudo nano /boot/cmdline.txt

• Add on the same line: video=DSI-1:800x480M@60,rotate=180

CONTACT US

• STORE ADDRESS
  • Shenzhen Luckfox Technology Co.,Ltd 214, Building 428 Bagualing Industrial Park, No. 43, Bagua Road, Hualin Community, Yuanling Sub-District, Futian District Shenzhen Guangdong, China
• STORE HOURS
  • Our working time: 09:00-18:00 (Monday to Saturday)
  • There might be a delay of several hours in handling your order, depending on the time difference between your location and ours. Sincerely hoping your understanding!

Read User Manual Online (PDF format)

Download This Manual (PDF format)

Download this manual  >>