Table des matières
Fichier INI : Configuration
Ce fichier mister.ini permet de paramètrer son MiSTer assez finement.
Paramètres vidéo génériques
- video_mode : 0 à 13 ou custom, définition de la résolution et de la fréquence d’affichage
- 0 = 1280 x 720 en 60 Hz
- 1 = 1024 x 768 en 60 Hz
- 2 = 720 x 480 en 60 HZ
- 3 = 720 x 576 en 50 Hz
- 4 = 1280 x 1024 en 60Hz
- 5 = 800 x 600 en 60 HZ
- 6 = 640 x 480 en 60 HZ
- 7 = 1280 x 720 en 50 Hz
- 8 = 1920 x 1080 en 60 Hz
- 9 = 1920 x 1080 en 50 Hz
- 10 = 1366 x 768 en 60 Hz
- 11 = 1024 x 600 en 60 Hz
- 12 = 1920 x 1440 en 60 Hz
- 13 = 2048 x 1536 en 60 Hz
- custom mode: hact,hfp,hs,hbp,vact,vfp,vs,vbp,Fpix_in_KHz
- hact = horizontal active
- hfp = horizontal front porch
- hs = horizontal synch
- hbp = horizontal back porch
- vact = vertical active
- vfp = vertical front porch
- vs = vertical synch
- vbp = vertical back porch
- Fpix_in_Khz = fréquence de rafraîchissement (Pixel clock frequency) en Khz
- Ex : video_mode=1280,110,40,220,720,5,5,20,74250
- menu_pal : 0 ou 1, active le mode PAL pour le menu du mister
- dvi_mode : 0 ou 1, mode DVI, attention le son ne sera pas transmis par le HDMI si cette option est activée
- video_info : 1 à 10, nb de secondes pendant lesquelles sont affiché les infos vidéo au démarrage
- fb_terminal : 0 ou 1, active les fonctionnalités framebuffer qui permettent de changer la résolution dans le menu
- fb_size : 0 à 4, résolution dans le menu (ne fonctionne que si fb_terminal est à 1)
- 0 : automatique
- 1 : full size
- 2 : moitié de la résolution (½ * résolution)
- 4 : un quart de la résolution (¼ * résolution
- hdmi_limited : 0 à 2, définit la plage RGB utilisée en HDMI, utile notamment quand connecté à un DAC
- 0 : plage RGB complète : 0 - 255
- 1 : plage RGB limitée : 16 - 235 (peut être utile pour un convertisseur VGA)
- 2 : plage RGB limitée : 16 - 255 (peut être utile pour un convertisseur VGA)
- vsync_adjust : 0 à 2, ajustement du buffer pour la sortie HDMI (aucun effet sur les autres sorties : VGA, DVI, …), ce paramètre a une importance sur la latence car il joue sur le rafraîchissement de l’image. Tous les écrans HDMI ne supportent pas forcément un réglage latence faible, il est conseillé de partir de 0 et de tester progressivement jusqu’à 2
- 0 : 60Hz triple buffer, compatible avec la plupart des écrans HDMI (Valeur par défaut)
- 1 : ajuste la sortie HDMI comme le Vsync original, moins de latence mais moins de compatibilité
- 2 : Utilise la fréquence de rafraîchissement (pixel clock) native du système, le moins de latence possible mais encore moins compatible
- refresh_min : 0, si votre moniteur est NTSC et ne supporte pas la fréquences PAL (50Hz), pour que le paramètre vsync_adjust ne soit pas appliqué pour les rafraîchissements en dessous de cette valeur, (ne s’applique que si vsync_adjust est supérieur à 0)
- refresh_max : 0, si votre moniteur est PAL et ne supporte pas la fréquence NTSC (60Hz) pour que le paramètre vsync_adjust ne soit pas appliqué pour les rafraîchissements au dessus de cette valeur, (ne s’applique que si vsync_adjust est supérieur à 0)
- video_mode_ntsc : mêmes valeurs que pour video_mode, définit le mode vidéo pour le ntsc, nécessite que video_mode_pal soit définie pour que vsync_adjust puisse switcher entre les modes prédéfinis en tant que base. Cela permet de réduire la fréquence de rafraîchissement (pixel clock)
- video_mode_pal : mêmes valeurs que pour video_mode, définit le mode vidéo pour le pal, nécessite que video_mode_ntsc soit définie pour que vsync_adjust puisse switcher entre les modes prédéfinis en tant que base. Cela permet de réduire la fréquence de rafraîchissement (pixel clock)
- custom_aspect_ratio_1 : ratio “Original” dans le menu (ex: 16:10)
- custom_aspect_ratio_2 : ration “Full screen” dans le menu (ex: 1:1)
Paramètre vidéo : VGA
- forced_scandoubler : 0 ou 1, nécessaire pour la compatibilité avec les écrans vga modernes (question de fréquence envoyée par le mister), valable pour le menu du mister mais à régler par core. Force le 15hz en 31hz
- ypbpr : 0 ou 1, active le composite (YUV) ou si désactivé passe en RGB
- composite_sync : 0 ou 1, utilise le composite sync en tant que signal de synchro horizontal dans la sortie VGA, à utiliser avec un cable VGA to RGBHV ou un DAC
- vga_scaler : 0 ou 1, force le scaling sur la sortie VGA pour avoir la même résolution que le HMDI (1080p ou 720p, ou comme vos réglages vidéo généraux)
- 1 : la sortie VGA intègre le plein scaler
- 0 : la sortie VGA a un signal vidéo indépendant, séparé du scaler principal (cad 240p or 480p)
- direct_video : 0 ou 1, mode direct vidéo (HDMI2VGA), permet au port HDMI de sortir un signal video/audio brut et non transformé venant du core chargé et ainsi d’alimenter un DAC et de fournir un signal analogique à partir d’un port HDMI. ATTENTION si cette option est activée le port HDMI ne fonctionnera plus normalement en tant que port HDMI car ce n’est pas standard.
Video / Audio Scaling
- vscale_mode : 0 à 2, integer scaling
- 0 : s’adapte à la hauteur de l’écran
- 1 : utilisation du integer scaling
- 2 : utilisation du integer scaling avec un écart de 0.5
- 3 : utilisation du integer scaling avec un écart de 0.25
- vscale_border : 0 à 399 : ajoute une bordure verticale pour les TV qui cachent le bord de l’écran
- vfilter_default : chemin vers un fichier, filtre par défaut pour le scaler vidéo
- afilter_default : chemin vers un fichier, filtre par défaut pour le scaler audio
Paramètres audios
- hdmi_audio_96k : 0 ou 1
- 0 : HDMI audio 48khz/16bit
- 1 : HDMI audio 96khz/16 bit
- volumectl : 0 ou 1 : active le contrôle du son
Paramètres manettes / clavier / souris / joystick
- key_menu_as_rgui : 0 ou 1, active le mapping du menu sur le RGUI du minimig
- gamepad_defaults : 0 ou 1, mapping par défaut de la manette
- 0 : mapping par nom
- 1 : mapping par position physique
- keyrah_mode : VID PID du keyrah pour traduction spéciale du code
- 0x18d80002 par défaut
- 0x23418037 pour Arduino Micro
- reset_combo : 0 à 3, emulation au clavier du bouton USER, par défaut c’est le bouton reset
- 0 : ctrl gauche + alt gauche + alt droit (ctrl gauche + lgui + rgui dans keyrah)
- 1 : ctrl gauchel + lgui + rgui
- 2 : ctrl gauche + alt gauche + del
- 3 : comme 0 (ctrl gauche + alt gauche + alt droit dans keyrah)
- mouse_throttle : 1 à 100, diviseur de la vitesse de la souris. Utile pour les souris très sensibles.
- controller_info : 0 à 10, affichage (en secondes) du mapping des boutons de la manette lors de la première pression du bouton, 0 pour désactiver
- jamma_vid : VID du système utilisé, JammaSD/J-PAC/I-PAC
- jamma_pid : PID du système utilisé, JammaSD/J-PAC/I-PAC
- sniper_mode: 0 ou 1, vitesses de l’émulation de la souris en mode sniper et non-sniper par un joystick
- 0 : mouvements plus rapides en mode non sniper et plus lents en mode sniper (valeur par défaut)
- 1 : mouvements plus lents en mode non sniper et plus rapides en mode sniper
Spinner
Utiliser les VID/PID spécifiques à votre souris. Les mouvements de la souris sont comme un spinner et un paddle. Pour utiliser toutes les souris comme spinners : VID=0xFFFF/PID=0xFFFF
- spinner_vid
- spinner_pid
- spinner_throttle : valeur de base à 100 permet de donner au spinner un pas de 1 par tick, des valeurs plus grandes rendent le spinner plus lent, et une valeur en dessous de 100 rend le spinner plus rapide. Une valeur négative donne des directions opposées.
Police de caractère
- font : Il est possible de définir une police de caractère custom. format = bitmap 8×8. https://github.com/MiSTer-devel/Fonts_MiSTer
Tailles de police supportées :
- 768 octets - caractères 32 à 127 (alphanumérique seulement)
- 1024 octets - caractères 0 à 127
- 1136 octets - caractères 0-141
- up to 2048 - seuls les caractères 0 à 141 seront utilisés
Si les 32 premiers caractères sont vides (pour les tailles 1024 octets et plus) alors ils seront sautés
Autres paramètres
- rbf_hide_datecode : 0 ou 1, cache les datecodes des noms de fichiers rbf. Appuyez sur F2 pour un basculement rapide temporaire.
- bootscreen : 0 ou commenté (avec un point virgule ), décommenter pour désactiver l’écran de boot pour certains cores (minimig notamment)
- recents : 0 ou 1, permet d’accéder facilement aux fichiers récents ou montés. ATTENTION : cette option permet l’écriture sur la carte SD à chaque chargement/montage ce qui peut user la carte SD après plusieurs écritures au même endroit. Il y aussi un risque plus grand de corruption du système de fichier si le mister est réinitialisé ou éteint pendant l’écriture.
- osd_timeout : 5 à 3600, délai (en secondes) avant que l’OSD ne disparaisse dans le menu core. 30 secondes si non défini. L’image de fond va être plus sombre après que ce délai ait doublé
- osd_rotate : 0 à 2 : rotation du menu OSD
- 0 : pas de rotation
- 1 : rotation droite (+90°)
- 2 : rotation gauche (-90°)
- bootcore : décommentez pour charger automatiquement un core
- lastcore : démarre automatiquement sur le dernier core chargé (nom du core sauvegardé automatiquement dans le fichier CONFIG/lastcore.dat) trouvé en premier sur la carte SD ou sur l’USB (disque externe)
- lastexactcore : démarre automatiquement sur le dernier core chargé par son nom exact (corename_yyyymmdd.rbf sauvegardé automatiquement dans CONFIG/lastcore.dat) trouvé en premier sur la carte SD ou sur l’USB (disque externe)
- corename : démarre automatiquement sur le premier corename_*rbf trouvé en premier sur la carte SD ou sur l’USB (disque externe)
- corename_yyyymmdd.rbf : démarre automatiquement sur le premier corename_yyyymmdd.rbf trouvé en premier sur la carte SD ou sur l’USB (disque externe)
- bootcore_timeout : 10-30, délai en secondes avant le démarrage automatique, commentez pour un démarrage automatique sans délai.
- browse_expand : commenté ou 1, décommentez si vous ne voulez pas voir une seconde ligne sur les noms de fichiers longs dans les listes
- logo : 0 ou 1, active le logo mister dans le menu core 0
- shared_folder : chemin de dossier, dossier partagé customisé pour les core qui le supporte (minimig et ao486 essentiellement). Chemin relatif au répertoire home du core ou chemin absolue. Le chemin doit exister avant que le core commence à l’utiliser or cela échouera. Si vous utilisez un répertoire partagé sur USB, assurez vous que le système est bien monté avant son utilisation.
Configurations générales / par core
On peut faire des configurations générales pour le mister mais aussi des configurations spécifiques par core voire par jeu. Chacun de ses paramètres peut s’appliquer de façon générale ou par core.
Pour l’appliquer à un core spécifique :
[GBA] vscale_mode=1 custom_aspect_ratio_1=8:7
Changement de fichiers INI à la volée : Le Mister supporte actuellement jusqu’à 3 fichiers alternatifs en plus du main que l’on peut activer depuis le menu OSD, soit en allant dans “Misc. options” (appuyer sur flèche gauche dans le menu) ou en restant appuyer sur le button “back” sur la manette et en appuyant sur une direction).
mister_alt_1.ini activé par back + left mister_alt_2.ini activé par back + up mister_alt_3.ini activé par back + down De plus, on peut réactiver le mister.ini par défaut en appuyant sur back + right ou en sélectionnant Main. Votre fichier INI alternatif restera chargé malgré les reboots et changement de core jusqu’à l’extinction du mister. mister.ini sera toujours chargé par défaut à la mise en route. Si vous changez de fichier INI dans un core, alors le core sera réinitialisé.
Générateur de fichier ini
Voici un générateur de fichier ini mais attention c'est en anglais : https://ini.misterkun.io/
Exemples de configuration par core
Optimisation de l'affichage HD par core : Custom aspect ratios