Cette page vous montrera comment configurer votre second écran TFT pour afficher les scrapes et vidéos. Ceci s'adresses aux personnes qui possède un boitier OGST ou un petit écran TFT.
Recalbox supporte quasi nativement l'affichage des vidéos et scrapes des systèmes émulés, les images et vidéos des jeux installés (quand ils sont scrapés) sur un second écran connecté sur le port GPIO (SPI/DPI, l'écran OGST d'Odroid).
L'opération de l'affichage procède comme ceci :
Un écran tel sur Module de port série de module d'affichage LCD 2.8 pouces 240x320 SPI TFT avec PCB ILI9341 5V / 3.3V ira très bien.
Ce genre d'écran ne coûte pas cher (< 15€). Le branchement sur le port GPIO est le suivant :
(image manquante, si vous avez ce matériel et possédez une image de câblage, vous pouvez l'insérez ici !)
Module TFT | Raspberry Pi |
---|---|
VCC | +3,3V (pin 1) |
GND | GND (pin 6) |
CS | SPI0 CE0 (pin 24) |
RESET | GPIO 25 (pin 22) |
DC | GPIO 24 (pin 18) |
SDA | SPI0 MOSI (pin 19) |
SCL | SPI0 SCLK (pin 23) |
LED | GPIO 18 (pin 12) |
SDO | SPI0 MISO (pin 21) |
(image manquante, si vous avez ce matériel et possédez une image de câblage, vous pouvez l'insérez ici !)
Le support du deuxième mini écran TFT est intégré dans Recalbox 7. Il est toujours nécessaire de configurer le mini écran TFT Arduino spécifiquement. Pour cela, vous devez modifier le fichier recalbox-user-config.txt
comme indiqué ci-dessous pour ajouter le support de l'écran via un overlay.
dtparam=spi=on
#small tft spi 2.8 adafruit type (for arduino)
dtoverlay=rpi-display,reset=25,dc=24,led=18,rotate=90,speed=48000000
Le support du bus SPI est activé et l'affichage est configuré via l'overlay approprié. Vous avez plus qu'à configurer le fichier recalbox.conf pour activer le support de l'écran. Pour cela, configurez les options comme ceci :
#Second miniTFT screen as marquee to display scrapes and videos
#Enable it with system.secondMiniTFT.enabled=1, disable with system.secondMiniTFT.enabled=0
system.secondminitft.enabled=1
#Type of mini TFT : OGST, unknown
#for Support of XU4 OGSTCase mini screen, just configure it secondminitft.type=ogst
#Most of spi tft screen are enabled thanks to overlays in /boot/config.txt
#please check the specific configuration of your screen
#Some examples are available on the page .....
# values are :
# - overlay : screen configured through overlays in /boot/config.txt
# - ogst : screen of the XU4 OGST case. Supported out of the box
# - default : the rest of the world
system.secondminitft.type=overlay
#Choose the resolution of your screen
#miniTFT resolution 320x240 -> 240p, 480x320 -> 320p
system.secondminitft.resolution=240p
#Scraped image aspect on tft screen : fbv display option
# options available : stretch, ignore-aspect, enlarge.
# stretch : Strech (using a simple resizing routine) the image to fit onto screen if necessary
# alpha : use the alpha channel (if applicable)
# ignore-aspect : Ignore the image aspect while resizing
# enlarge : Enlarge the image to fit the whole screen if necessary
# 1 = enabled, 0 = disabled
system.secondminitft.imagestretchenabled=1
system.secondminitft.imageenlargeenabled=0
system.secondminitft.imagealphaenabled=1
system.secondminitft.imageignoreaspectenabled=1
#When activating the second TFT screen, you may want to display
#game scraped video only on the second screen. This variable
#allows you to disable scraped video playing in ES during game browsing
#system.secondminitft.disablevideoines=1 disable video playing in ES
#system.secondminitft.disablevideoines=0 enable video playing in ES
system.secondminitft.disablevideoines=1
#if the backlight of your your screen can be manage by PWM,
#indicates the GPIO value of your PWM control
#WiringPi and its gpio program will be used to control the backlight
#when RB goes in SLEEP mode, and when it wakes up.
#On raspberry pi, PWMs cannot be used simultaneously with Jack sound output.
#If your are using HDMI or a Audio hat you can use backlight PWM control for the second screen
#If you are using Jack output please leave commented.
#The Screen will be switch down in Sleep mode, and switch on when it wakes up.
#On OGST, only this mode is available.
;system.secondminitft.backlightcontrol=18
Normalement, tout est OK. Redémarrez et votre écran doit afficher les images et vidéos des jeux scrapés.
Vous pouvez voir les tests de développement sur un Pi3 dans cette vidéo.
Ici, vous pouvez voir la façon dont GameMakers utilise cette fonctionnalité sur une de leur création : une mini New Astro City.
Cet écran se trouve ici.
PIN NO. | SYMBOLE | DESCRIPTION |
---|---|---|
1, 17 | 3.3V | Power positive (3.3V power input) |
2, 4 | 5V | Power positive (5V power input) |
3, 5, 7, 8, 10, 12, 13, 15, 16 | NC | NC |
6, 9, 14, 20, 25 | GND | Ground |
11 | TP_IRQ | Touch Panel interrupt, low level while the Touch Panel detects touching |
18 | LCD_RS | Command/data register selection |
19 | LCD_SI / TP_SI | LCD display/SPI data input of Touch Panel |
21 | TP_SO | SPI data output of Touch Panel |
22 | RST | Reset |
23 | LCD_SCK / TP_SCK | LCD display/SPI clock of Touch Panel |
24 | LCD_CS | LCD chip selection, low active |
26 | TP_CS | Touch Panel chip selection, low active |
La procédure de configuration est identique à l'écran 2.8" Arduino mais les paramètres sont différents.
Le support du deuxième mini écran TFT est intégré dans recalbox 7.0. Il est toujours nécessaire de configurer le mini écran TFT Waveshare (rev A/B) spécifiquement. Pour cela, vous devez modifier le fichier /boot/rcalbox-user-config.txt
comme indiqué ci-dessous pour ajouter le support de l'écran via un overlay.
#minitft 3.5 waveshare
dtparam=spi=on
dtoverlay=waveshare35a:rotate=270,speed=27000000 #for revA
dtoverlay=waveshare35b:rotate=270,speed=27000000 #for revB
Le support du bus SPI est activé et l'affichage est configuré via l'overlay approprié. Vous avez plus qu'à configurer le fichier recalbox.conf
pour activer le support de l'écran. Pour cela, configurez les options comme ceci :
#Second miniTFT screen as marquee to display scrapes and videos
#Enable it with system.secondMiniTFT.enabled=1, disable with system.secondMiniTFT.enabled=0
system.secondminitft.enabled=1
#Type of mini TFT : OGST, unknown
#for Support of XU4 OGSTCase mini screen, just configure it secondminitft.type=ogst
#Most of spi tft screen are enabled thanks to overlays in /boot/config.txt
#please check the specific configuration of your screen
#Some examples are available on the page .....
# values are :
# - overlay : screen configured through overlays in /boot/config.txt
# - ogst : screen of the XU4 OGST case. Supported out of the box
# - default : the rest of the world
system.secondminitft.type=overlay
#Choose the resolution of your screen
#miniTFT resolution 320x240 -> 240p, 480x320 -> 320p
system.secondminitft.resolution=320p
#Scraped image aspect on tft screen : fbv display option
# options available : stretch, ignore-aspect, enlarge.
# stretch : Strech (using a simple resizing routine) the image to fit onto screen if necessary
# alpha : use the alpha channel (if applicable)
# ignore-aspect : Ignore the image aspect while resizing
# enlarge : Enlarge the image to fit the whole screen if necessary
# 1 = enabled, 0 = disabled
system.secondminitft.imagestretchenabled=1
system.secondminitft.imageenlargeenabled=0
system.secondminitft.imagealphaenabled=1
system.secondminitft.imageignoreaspectenabled=1
#When activating the second TFT screen, you may want to display
#game scraped video only on the second screen. This variable
#allows you to disable scraped video playing in ES during game browsing
#system.secondminitft.disablevideoines=1 disable video playing in ES
#system.secondminitft.disablevideoines=0 enable video playing in ES
system.secondminitft.disablevideoines=1
#if the backlight of your your screen can be manage by PWM,
#indicates the GPIO value of your PWM control
#WiringPi and its gpio program will be used to control the backlight
#when RB goes in SLEEP mode, and when it wakes up.
#On raspberry pi, PWMs cannot be used simultaneously with Jack sound output.
#If your are using HDMI or a Audio hat you can use backlight PWM control for the second screen
#If you are using Jack output please leave commented.
#The Screen will be switch down in Sleep mode, and switch on when it wakes up.
#On OGST, only this mode is available.
;system.secondminitft.backlightcontrol=18
Normalement, tout est OK. Redémarrez et votre écran doit afficher les images et vidéos des jeux scrapés.
Vous pouvez obtenir cet écran ici et il est plutôt cher.
Vous pouvez consulter le tableau de câblage sur cette page.
La procédure de configuration est identique à l'écran 2.8" Arduino mais les paramètres sont différents.
Le support du deuxième mini écran TFT est intégré dans recalbox 7.0. Il est toujours nécessaire de configurer le mini écran TFT Adafruit spécifiquement. Pour cela, vous devez modifier le fichier /boot/config.txt
comme indiqué ci-dessous pour ajouter le support de l'écran via un overlay.
Vous devez ouvrir le fichier recalbox-user-config.txt avec nano ou vim et ajoutez les lignes suivantes :
#minitft 3.5 adafruit
dtparam=spi=on
dtoverlay=pitft35-resistive,rotate=270,fps=30
Le support du bus SPI est activé et l'affichage est configuré via l'overlay approprié. Vous avez plus qu'à configurer le fichier recalbox.conf pour activer le support de l'écran. Pour cela, configurez les options comme ceci :
#Second miniTFT screen as marquee to display scrapes and videos
#Enable it with system.secondMiniTFT.enabled=1, disable with system.secondMiniTFT.enabled=0
system.secondminitft.enabled=1
#Type of mini TFT : OGST, unknown
#for Support of XU4 OGSTCase mini screen, just configure it secondminitft.type=ogst
#Most of spi tft screen are enabled thanks to overlays in /boot/config.txt
#please check the specific configuration of your screen
#Some examples are available on the page .....
# values are :
# - overlay : screen configured through overlays in /boot/config.txt
# - ogst : screen of the XU4 OGST case. Supported out of the box
# - default : the rest of the world
system.secondminitft.type=overlay
#Choose the resolution of your screen
#miniTFT resolution 320x240 -> 240p, 480x320 -> 320p
system.secondminitft.resolution=320p
#Scraped image aspect on tft screen : fbv display option
# options available : stretch, ignore-aspect, enlarge.
# stretch : Strech (using a simple resizing routine) the image to fit onto screen if necessary
# alpha : use the alpha channel (if applicable)
# ignore-aspect : Ignore the image aspect while resizing
# enlarge : Enlarge the image to fit the whole screen if necessary
# 1 = enabled, 0 = disabled
system.secondminitft.imagestretchenabled=1
system.secondminitft.imageenlargeenabled=0
system.secondminitft.imagealphaenabled=1
system.secondminitft.imageignoreaspectenabled=1
#When activating the second TFT screen, you may want to display
#game scraped video only on the second screen. This variable
#allows you to disable scraped video playing in ES during game browsing
#system.secondminitft.disablevideoines=1 disable video playing in ES
#system.secondminitft.disablevideoines=0 enable video playing in ES
system.secondminitft.disablevideoines=1
#if the backlight of your your screen can be manage by PWM,
#indicates the GPIO value of your PWM control
#WiringPi and its gpio program will be used to control the backlight
#when RB goes in SLEEP mode, and when it wakes up.
#On raspberry pi, PWMs cannot be used simultaneously with Jack sound output.
#If your are using HDMI or a Audio hat you can use backlight PWM control for the second screen
#If you are using Jack output please leave commented.
#The Screen will be switch down in Sleep mode, and switch on when it wakes up.
#On OGST, only this mode is available.
;system.secondminitft.backlightcontrol=18
Normalement, tout est OK, redémarrez et votre écran doit afficher les images et vidéos des jeux scrapés
https://www.hardkernel.com/shop/ogst-gaming-console-kit-for-xu4/
Avec le boitier OGST, Il faudra modifier deux fichiers de configuration:
SHARE:\system\recalbox.conf
(/recalbox/share/system/recalbox.conf
sous SSH) etRECALBOX\config.ini
(/boot/config.ini
sous SSH).boot.ini.sample
en boot.ini
. Prenez soin de vérifier la configuration écran (les lignes qui commencent par setenv). En général, il suffit de d'enlever le # qui se trouve devant la résolution que vous désirez. (Notez qu'il est possible de commenter toutes les options setenv videoconfig, le XU4 prendra tout seul la meilleure résolution).config.ini.sample
en config.ini
toujours dans la partition RECALBOX (/boot
).mount -o remount,rw /boot
cp /boot/boot.ini.sample /boot/boot.ini
cp /boot/config.ini.sample /boot/config.ini
config.ini
de la partition RECALBOX.Une fois ouvert, trouvez la ligne suivante :
;overlay_profile=hktft_cs_ogst
Enlevez le ;
en début de ligne et sauvegardez. Vous devez avoir ce contenu :
[generic]
; Device Tree Overlay
overlay_resize=16384
; uncomment next line to enable Odroid XU4 OGST
overlay_profile=hktft_cs_ogst
overlays="spi0 i2c0 i2c1 uart0"
[overlay_hktft_cs_ogst]
overlays="hktft-cs-ogst i2c0"
Ci-dessous les commandes à lancer en SSH:
mount -o remount,rw /boot
sed -i '/overlay_profile=hktft_cs_ogst/s/^;//' /boot/config.ini
system/recalbox.conf
doivent être effectuées et cela est possible en accédant à la carte SD depuis Windows (partition SHARE). Il est aussi possible de faire cette modification par le manager ou en SSH.La configuration est effectuée avec les lignes suivantes dans le fichier recalbox.conf :
#Second miniTFT screen as marquee to display scrapes and videos
#Enable it with system.secondMiniTFT.enabled=1, disable with system.secondMiniTFT.enabled=0
#this configuration is REQUIRED
system.secondminitft.enabled=1
#Type of mini TFT : OGST, unknown
#Most of spi tft screen are enabled thanks to overlays in /boot/config.txt in rpi and /boot/config.ini on odroidxu4
#please check the specific configuration of your screen
#Some examples are available on the page .....
# values are :
# - overlay : screen configured through overlays in /boot/config.txt or /boot/config.ini (odroidxu4/ogst)
# - default : the rest of the world
#this configuration is REQUIRED if system.secondminitft.enabled=1
system.secondminitft.type=overlay
#Choose the resolution of your screen
#miniTFT resolution 320x240 -> 240p, 480x320 -> 320p
#this configuration is REQUIRED if system.secondminitft.enabled=1
system.secondminitft.resolution=240p
#Scraped image aspect on tft screen : fbv display option
# options available : stretch, ignore-aspect, enlarge.
# stretch : Strech (using a simple resizing routine) the image to fit onto screen if necessary
# alpha : use the alpha channel (if applicable)
# ignore-aspect : Ignore the image aspect while resizing
# enlarge : Enlarge the image to fit the whole screen if necessary
# 1 = enabled, 0 = disabled
#this configuration is REQUIRED if system.secondminitft.enabled=1
system.secondminitft.imagestretchenabled=1
system.secondminitft.imageenlargeenabled=0
system.secondminitft.imagealphaenabled=1
system.secondminitft.imageignoreaspectenabled=1
#When activating the second TFT screen, you may want to display
#game scraped video only on the second screen. This variable
#allows you to disable scraped video playing in ES during game browsing
#system.secondminitft.disablevideoines=1 disable video playing in ES
#system.secondminitft.disablevideoines=0 enable video playing in ES
#this configuration is OPTIONAL if system.secondminitft.enabled=1
;system.secondminitft.disablevideoines=1
#if the backlight of your your screen can be manage by PWM,
#indicates the GPIO value of your PWM control
#WiringPi and its gpio program will be used to control the backlight
#when RB goes in SLEEP mode, and when it wakes up.
#On raspberry pi, PWMs cannot be used simultaneously with Jack sound output.
#If your are using HDMI or a Audio hat you can use backlight PWM control for the second screen
#If you are using Jack output please leave commented.
#The Screen will be switch down in Sleep mode, and switch on when it wakes up.
#On OGST, only this mode is available.
#this configuration is OPTIONAL if system.secondminitft.enabled=1
;system.secondminitft.backlightcontrol=18
Tout d'abord, vérifiez les fichiers /boot/config.ini
et recalbox.conf
. Les deux fichiers de la partition de démarrage doivent s'appeler boot.ini
et config.ini
et non boot.ini.sample
et config.ini.sample
. (Windows peut cacher l'extension du fichier).
Si le XU4 démarre à partir d'une eMMC, vous devrez peut-être mettre à jour la partition de démarrage MMC. Exécutez ces commandes pour y parvenir :
echo 0 > /sys/block/mmcblk0boot0/force_ro
dd if=/dev/mmcblk0 of=/dev/mmcblk0boot0 bs=512 count=8192 skip=1
echo 1 > /sys/block/mmcblk0boot0/force_ro
reboot