Luma3DS

Luma3ds

Nintendo 3DS "Firmware personnalisé"

Description

LUMA3DS Patche et réimplique des parties importantes du logiciel système fonctionnant sur tous les modèles de la famille de consoles Nintendo 3DS. Il vise à améliorer considérablement l'expérience utilisateur et à soutenir la 3DS bien au-delà de sa fin de vie. Les fonctionnalités incluent:

• Support de première classe pour les applications Homebrew
• Rosalina , un menu de superposition (déclenché par L + Down + SELECT par défaut), permettant des choses comme:
  • Prendre des captures d'écran pendant le jeu
  • Filtres de lumière bleue et autres filtres d'écran
  • Redirection d'entrée pour jouer avec des dispositifs externes, tels que les contrôleurs
  • Utilisation des codes de triche
  • Définition de l'heure et de la date avec précision du réseau (NTP)
  • ... et bien plus encore!
• De nombreuses fonctionnalités de modding de jeu , telles que, mais sans s'y limiter:
  • Plugins de jeu (au format 3GX)
  • Les remplacements du langage par match ("émulation des paramètres")
  • Redirection du chemin du contenu des actifs ("coucheseredfs")
• Prise en charge des correctifs fournis par l'utilisateur et / ou des "modules système" complets , une fonctionnalité essentielle pour les remplacements de réseau Nintendo (entre autres projets)
• Un talon GDB à part entière , permettant aux développeurs de homebrew et aux ingénieurs inverses de fonctionner beaucoup plus efficacement
• Capacité à charger d'autres fichiers de firmware, y compris d'autres versions de lui-même
• ... et bien plus encore!

Installation et mise à niveau

LUMA3DS nécessite Boot9Strap pour s'exécuter.

Une fois que Boot9strap a été installé, téléchargez simplement les dernières archives de version et extraire l'archive sur la racine de votre carte SD pour "installer" ou pour mettre à niveau LUMA3DS à côté du menu Homebrew et du bundle de certificats expédiés. Remplacez les fichiers existants et fusionnez les dossiers existants si nécessaire.

Utilisation de base

Le menu de configuration LUMA3DS principal est accessible en appuyant sur Sélectionner au démarrage. Le fichier de configuration est stocké dans /luma/config.ini sur la carte SD (ou /rw/luma/config.ini sur la partition Ctrnand si Luma3ds a été lancé à partir de la partition Ctrnand, qui se produit lorsqu'il est manquant).

Le menu Chainloader est accessible en appuyant sur Démarrer au démarrage ou dans le menu de configuration. Les charges utiles devraient être situées dans /luma/payloads avec l'extension .firm ; S'il n'y a qu'une seule charge utile, le menu de sélection susmentionné sera ignoré. Les raccourcis clavier peuvent être attribués à la charge utile, par exemple x_test.firm sera chargé de chaîne lorsque x est enfoncé au démarrage.

Le menu de superposition, Rosalina , a une combinaison de bouton par défaut: l + down + select . Pour une plus grande flexible, la plupart des paramètres de menu Rosalina ne sont pas enregistrés automatiquement, d'où l'option "Enregistrer les paramètres".

Les ports GDB , lorsqu'ils sont activés, sont 4000-4002 pour les ports normaux. L'utilisation de attach dans le mode "Extended-Remote", aux côtés info os processes est prise en charge et encouragée (pour l'ingénierie inverse, consultez également monitor getmemregions ). Le port de la fonction de démarrage de rupture est 4003 sans "Remote étendu". GDB et IDA Pro par Devkitarm par Devkitarm (sans "support de pas" activés) sont activement pris en charge.

Nous avons un wiki, mais il est actuellement très dépassé.

Composants

LUMA3DS se compose de plusieurs composants. Bien que le style de code de chaque composant soit principalement cohérent, ces composants ont été écrits sur de nombreuses années et peuvent ne pas refléter comment les mainteneurs écriraient un nouveau code dans de nouveaux composants / projets:

• ARM9 , ARM11 : Menu des paramètres principaux de BareMetal, Chainloader et Firmware Loader. En plus d'afficher les paramètres et le chargement de la chaîne vers d'autres fichiers de firmware à la demande, il est responsable du correctif du micrologiciel officiel pour modifier le code Process9 et pour injecter tous les autres composants personnalisés. C'était le premier composant jamais écrit pour ce projet, en 2015
• K11_Extension : Code étendant le noyau NATIVE_FIRM d'ARM11 ( Kernel11 ). Il est injecté par le chargeur de barmetal mentionné ci-dessus dans le noyau en accrochant son code de démarrage, puis s'accroche au reste du noyau. Ses fonctionnalités incluent les appels du système d'accrochage (SVC), l'introduction de nouveaux SVC et le raccordement aux communications d'interprocess, pour contourner les limitations de la conception du système de Nintendo. Il s'agit du composant qui permet à Rosalina de suspendre d'autres processus sur l'entrée du menu de superposition, par exemple. Cela a été écrit à une époque où nous n'avons pas complètement inversé les ingénieurs inversés, et nous sommes à l'origine sortis en 2017 aux côtés de Rosalina. D'autres crochets pour le support "Game Plugin" ont été fusionnés en 2023
• Sysmodules : réimplémentation des "modules système" (processus) du système d'exploitation de la 3DS (sauf pour la coutume Rosalina), actuellement uniquement les processus initiaux chargés directement en mémoire par le noyau ("processus initial du noyau", ou kip en bref)
  • Chargeur : processus qui charge les processus non KIP à partir du stockage. Parce que c'est l'endroit idéal pour patcher / remplacer le code exécutable, c'est là que tous les correctifs de processus sont terminés, permettant en particulier les fonctionnalités de "modding de jeu". Il s'agit également du chargement Sysmodule Gestion de 3DSX Homebrew. Présenté en 2016
  • Rosalina : Le composant le plus important de LUMA3DS et du menu Custom Kip: superposition, du serveur GDB, err:f (écran d'erreur fatal) réimplémentation, et bien plus encore. Introduit à la mi-2017, et a continué à subir des changements et a reçu de nombreuses contributions externes depuis
  • PXI : ARM11 <> ARM9 Communication Kip, réimplémenté juste pour le bien. Introduit fin 2017
  • SM : Service Manager Kip, réimplémenté pour supprimer les restrictions de contrôle d'accès aux services. Introduit fin 2017
  • PM : Process Manager KIP Reponible de démarrer / terminer les processus et de demander loader de les charger. La réimplémentation permet une fonction GDB de démarrage de rupture à Rosalina, ainsi que la levée des restrictions de contrôle d'accès FS à la bonne manière. Présenté en 2019

Maintient

• @Tuxsh : le développeur de lead, créé et maintient la plupart des fonctionnalités du projet. Rejoint en 2016
• @Aurorawright : auteur du projet, implémenté les fonctionnalités principales (la plupart du menu de paramètres de démarrage de baremetal et du code de chargement du micrologiciel) avec des décisions de conception réussies qui ont rendu le projet populaire. Créé le projet en 2015,
• @ Pablomk7 : le maintien de la fonction de chargeur de plugin a fusionné pour la version V13.0. Rejoint en 2023

Feuille de route

Il y a encore beaucoup plus de fonctionnalités et de consolidation prévues pour LUMA3DS! Voici une liste de ce qui est actuellement en magasin:

• Réimplémentation complète de TwlBg et AgbBg . Cela permettra une augmentation beaucoup mieux et plus configurable, pour l'écran supérieur dans les jeux DS et GBA (sauf sur Old 2DS). Ceci est actuellement développé en privé dans C ++ 23 (pas d'ETA). Bien que ce soit une entreprise assez difficile car cela nécessite de réécrire toute la pile de pilotes en semi-bare (noyau limité sans IPC), c'est la caractéristique la plus critique que Luma3D
• Remplémentation de Process9 pour TWL_FIRM et AGB_FIRM pour permettre plus de fonctionnalités en mode de compatibilité DS et GBA (celles qui nécessitent un accès au fichier)
• Finalement, une réimplémentation complète Kernel11

Problèmes connus

• Cheat Engine se bloque avec certaines applications, en particulier les jeux Pokémon : il y a une condition de course dans Kernel11 de Nintendo concernant la connexion d'un nouveau KDebugThread à un KThread sur la création de thread, et un autre thread-déréférencez- thread->debugThread . Cela fait que le moteur de triche écrase les jeux qui créent et détruisent de nombreux threads tout le temps (comme Pokémon).
  • Pour ces jeux, avoir un "plugin de jeu" dédié est la seule alternative jusqu'à ce que Kernel11 soit réimplémenté.
• Applications Réagissant au Button Rosalina Menu Button : Rosalina est simplement d'interroger l'entrée du bouton à un intervalle pour savoir quand afficher le menu. Cela signifie que le combo de menu Rosalina peut parfois être traité par le jeu / le processus qui sera interrompu.
  • Vous pouvez modifier le combo de menu dans le sous-menu "Divers Options" (puis l'enregistrer avec "Enregistrer les paramètres" dans le menu principal) pour contourner cela.

Bâtiment de Source

Pour construire Luma3DS, ce qui suit est nécessaire:

• git
• Makerom dans $PATH
• firmtool installé
• Devkitarm et Libctru à jour:
  • Installez dkp-pacman (ou, pour les distributions qui fournissent déjà Pacman, ajoutez des référentiels): https://devkitpro.org/wiki/devkitpro_pacman
  • Installez les packages à partir de MetaPackage 3ds-dev : sudo dkp-pacman -S 3ds-dev --needed
  • Bien que les versions Libctru et Luma3DS soient synchronisées, vous devrez peut-être construire Libctru à partir de la source pour les engins Luma3DS non libérés

Alors que les versions LUMA3DS sont regroupées avec 3ds-hbmenu , LUMA3DS se compile en un seul fichier: boot.firm . Il suffit de le copier sur la racine de votre carte SD (FTPD est le moyen le plus simple de le faire), et vous avez terminé.

Licence

Ce logiciel est sous licence des termes du GPLV3. Vous pouvez trouver une copie de la licence dans le fichier licence.txt.

Les fichiers du Stub GDB sont plutôt triples comme MIT ou "GPLV2 ou n'importe quelle version ultérieure", auquel cas il est spécifié dans l'en-tête de fichier. Les réimplémentations PM, SM, PXI sont également autorisées sous le MIT.

Crédits

LUMA3DS ne serait pas ce qu'il est sans les contributions et les commentaires constructifs de beaucoup. Nous tenons à remercier en particulier:

• @devkitpro (en particulier @Fincs , @wintermute et @mtheall ) pour avoir fourni des chaînes d'outils de qualité et faciles à utiliser avec un GCC de saignement, et pour leurs conseils techniques continus
• @Nanquitas pour la version initiale du code de chargeur de plugin de jeu ainsi que des contributions très utiles au stub gdb
• @ PIEPIE62 pour la mise en œuvre actuelle du moteur de triche Rosalina, Duckbill pour sa mise en œuvre d'origine
• @panicbit pour l'implémentation originale des filtres d'écran à Rosalina
• @jasondellaluce pour les couches
• @Liquidfenrir pour la visionneuse de mémoire dans la "liste de processus" de Rosalina
• Chan pour les FATF
• Tous ceux qui ont contribué au référentiel LUMA3DS
• Tous ceux qui ont aidé à dépanner les utilisateurs finaux
• Tous ceux qui ont fourni des commentaires constructifs à Luma3DS