Pubblicato un nuovo aggiornamento per sys-patch, il noto modulo di sistema per Nintendo Switch utilizzato da moltissimi utenti della scena homebrew per applicare automaticamente le patch necessarie ai principali servizi interni di HorizonOS.

Anche se si tratta di un update relativamente rapido e mirato, la nuova versione introduce alcune modifiche molto interessanti che migliorano ulteriormente la flessibilità dello strumento e risolvono un problema specifico legato alla compatibilità delle cartucce cinesi con i firmware globali della console.

1 di 4

Per chi non lo conoscesse, sys-patch è un modulo progettato per operare direttamente durante l’avvio della Nintendo Switch, caricando automaticamente le patch necessarie ai componenti fondamentali del sistema come fs, es, ldr e nifm.

A differenza delle tradizionali patch applicate manualmente, questo sistema lavora in maniera completamente trasparente e integrata, consentendo alla console di avviare i servizi modificati già nelle primissime fasi del boot.

Questo approccio garantisce una maggiore stabilità e riduce sensibilmente il rischio di errori legati a file mancanti, configurazioni errate o patch non caricate correttamente.

Uno degli aspetti che nel tempo ha reso sys-patch particolarmente apprezzato all’interno della community è la sua capacità di generare un log dettagliato di tutte le modifiche applicate.

Lo strumento infatti elenca con precisione le patch caricate, indicando quali sono state applicate con successo e quali invece hanno riscontrato problemi.

Questa funzione si rivela estremamente utile non solo per verificare l’integrità del sistema, ma anche per diagnosticare eventuali incompatibilità dopo aggiornamenti del firmware o modifiche alla configurazione della console.

La nuova release introduce innanzitutto un miglioramento importante nel sistema di ricerca dei pattern. Fino ad ora, quando un pattern produceva più risultati possibili, sys-patch si limitava generalmente al primo elemento individuato.

Con questo aggiornamento, invece, il modulo acquisisce la capacità di gestire e indirizzare più risultati contemporaneamente, rendendo il processo di patching molto più flessibile e affidabile soprattutto nelle situazioni in cui strutture di memoria o firme interne del firmware risultano differenti rispetto alle versioni precedenti.

Tra le novità più interessanti spicca anche l’introduzione di una nuova patch dedicata al modulo NS di HorizonOS. Questa modifica forza il valore restituito dalla funzione GetGameCardCompatibilityType a 0 ogni volta che il sistema effettua il controllo di compatibilità delle cartucce.

In termini pratici, questa patch permette agli utenti in possesso di gamecard della regione cinese, conosciuta internamente come “terra”, di avviare correttamente i propri giochi anche utilizzando versioni globali del firmware HorizonOS, comprese tutte quelle successive alla release cinese 19.0.2.

Si tratta di una correzione particolarmente utile per chi utilizza console importate o possiede titoli distribuiti esclusivamente sul mercato cinese, eliminando una limitazione che fino ad oggi impediva l’avvio corretto di alcune cartucce su firmware internazionali.

L’aggiornamento introduce inoltre una piccola ma significativa modifica alla numerazione delle versioni del progetto. sys-patch passa infatti dalla versione 1.6.1 alla nuova nomenclatura 1.6.2.0, aggiungendo un ulteriore livello numerico dedicato alle patch minori.

Questo cambiamento consentirà agli sviluppatori di distribuire aggiornamenti più piccoli senza dover incrementare immediatamente la versione principale.

In futuro, ad esempio, eventuali fix leggeri o modifiche non particolarmente invasive potranno essere pubblicati come versioni 1.6.2.1, mentre un aggiornamento più sostanzioso che richieda modifiche ai pattern di compatibilità porterà direttamente alla versione 1.6.3.0.

Si tratta di un cambiamento apparentemente semplice, ma che migliora notevolmente la gestione dello sviluppo e permette agli utenti di comprendere immediatamente la natura degli aggiornamenti installati, distinguendo più facilmente tra hotfix minori e revisioni più importanti legate al supporto dei nuovi firmware Nintendo Switch.

Configurazione

Il sysmodule sys-patch presenta una semplice configurazione. Questo può essere modificato o aggiornato manualmente utilizzando l’overlay.

Il file di configurazione può essere trovato in /config/sys-patch/config.ini, se il file non esiste, il file verrà creato quando il sysmodule sys-patch viene eseguito.

[options]
patch_sysmmc=1 ; 1=(default) patch sysmmc, 0=don't patch sysmmc
patch_emummc=1 ; 1=(default) patch emummc, 0=don't patch emummc
logging=1 ; 1=(default) output /config/sys-patch/log.inim 0=no log
version_skip=1 ; 1=(default) skips out of date patterns, 0=search all patterns

Overlay

L’overlay può essere utilizzato per modificare le opzioni di configurazione e per vedere quali patch vengono applicate (se presenti).

• Unpatched – Significa che la patch non è stata applicata (probabilmente non trovata).
• Patched (verde) – Significa che è stato patchato da sys-patch.
• Patched (giallo) – Significa che è già stato patchato, probabilmente da sigpatches o da una creazione di un’atmosphère personalizzata.

Cosa viene patchato?

Ecco un breve riassunto di ciò che è stato patchato:

• fs
• es
• ldr

fs ed es necessitano di nuove patch dopo ogni nuova versione del firmware. ldr d’altra parte ha bisogno di nuove patch dopo ogni rilascio di una nuova versione di Atmosphère, ciò è dovuto al fatto che il servizio ldr è stato reimplementato da Atmosphère.

In particolare, nel firmware 10.0.0 è stato aggiunto un nuovo controllo nel firmware originale che richiedeva una correzione immediata. Atmosphère ha quindi introdotto questo stesso controllo, rendendo necessaria una nuova patch per quel firmware specifico.

Questa necessità di applicare nuove patch in modo specifico per ldr dopo ogni aggiornamento di Atmosphère è dovuta alla stretta integrazione tra Atmosphère e il firmware originale, garantendo la compatibilità e il corretto funzionamento del modulo ldr.

Come funziona?

Sys-patch utilizza una raccolta di modelli per individuare il pezzo di codice che deve essere corretto. Questo approccio consente di individuare le aree problematiche senza dover fare affidamento solo sugli offset, il che sarebbe inefficiente e richiederebbe aggiornamenti frequenti dopo ogni nuovo aggiornamento del firmware. L’utilizzo di modelli consente di individuare e correggere i problemi in modo più accurato.

Quando le patch vengono applicate all’avvio, il sysmod smette di funzionare, il che è normale poiché le modifiche vengono apportate per correggere i problemi.

Nonostante ciò, l’impronta di memoria del sysmod è estremamente piccola, utilizzando solo 16 kib in totale. La dimensione del file binario stesso è di soli ~50 kib, il che è un risultato notevole e dimostra l’efficienza del codice.

Questo significa che dovrei smettere di scaricare/usare le sigpatch?

È comprensibile che l’utente preferisca continuare a utilizzare le sigpatch attuali anziché passare alle sys-patch. Il motivo di questa scelta è la preoccupazione che, nel caso in cui il sysmodule sys-patch dovesse presentare dei problemi, potrebbe non essere risolto prontamente.

Se sto già usando sigpatch, ha senso usare anche questo?

Sì, in 2 casi di nicchia.

1. Una nuova patch ldr deve essere creata dopo ogni aggiornamento di Atmosphère. A volte viene rilasciato un nuovo aggiornamento silenzioso di Atmosphère. Questo strumento correggerà sempre ldr senza dover aggiornare le patch.
2. La creazione di Atmosphère dal src richiederà di generare una nuova patch ldr per quella versione personalizzata di Atmosphère. Questo è abbastanza facile grazie agli script/strumenti pubblici che esistono là fuori, tuttavia sarà sempre possibile.

Inoltre, se dimentichi di aggiornare le tue patch quando aggiorni il firmware o l’Atmosphère, questo sysmod dovrebbe essere in grado di correggere tutto bene! quindi è bello averlo come ripiego.

Changelog

• Aggiunta la possibilità di gestire più risultati invece di limitarsi solo al primo, nel caso in cui i pattern restituiscano più corrispondenze.
• Aggiunta una patch per il modulo NS che forza il valore restituito da GetGameCardCompatibilityType a 0 ogni volta che NS effettua la chiamata. Questo permette agli utenti che possiedono gamecard della regione cinese (“terra”) di avviare correttamente le proprie cartucce utilizzando versioni globali del firmware HorizonOS, ovvero qualsiasi firmware successivo alla versione cinese 19.0.2.
• Aggiunta inoltre un’ulteriore cifra nella numerazione delle versioni, così da poter pubblicare patch minori che non richiedono un vero aggiornamento principale.

Versione:
1.6.1 → 1.6.2.0

Le future versioni minori seguiranno quindi questo schema:
1.6.2.1

Mentre un aggiornamento che richiederà modifiche ai pattern compatibili porterà alla versione successiva desiderata:
1.6.3.0

Download: sys-patch v1.6.2.0

Download: Source code sys-patch v1.6.2.0

Alcune parti di questo articolo sono state generate con l’aiuto dell’intelligenza artificiale.

Ultimo aggiornamento 2026-06-10 / Link di affiliazione / Immagini da Amazon Product Advertising API