USART-HMI-to-ITA
USART HMI to ITA
Traduzione in italiano dell'interfaccia di USART HMI (software cinese per display TJC / Nextion‑compatibili), che esiste solo in cinese.
Il metodo si basa sul lavoro di audiobrian/usart_hmi_english_translation (traduzione inglese): ne riusa il decryptor di ACTR.dll, ma sostituisce la modifica manuale con dnSpy con una patch automatica e fornisce traduzioni italiane.
Avvertenze
- Strumento per uso personale/educativo (localizzazione). Non contiene né ridistribuisce il software USART HMI né i suoi file decifrati.
- Modifica file in
C:\Program Files (x86)\USART HMI. Viene creato un backup, ma usalo a tuo rischio.- Testato su USART HMI 1.68.1 (Windows 10/11).
Come funziona
USART HMI.execarica 21 assembly .NET cifrati daACTR.dll.- Lo script li decifra con il decryptor del repo upstream (compilato in locale dal sorgente).
- Il programma in
src/Patcher(Mono.Cecil) inserisce all'inizio del metodohmitype.LanguageApp.Language(string)una chiamata a un helper (src/HmiTr, copiato dentrohmitype.dll: nessuna DLL aggiuntiva). L'helper cerca il testo cinese inc:\devel\hmi_translation.txt; se lo trova restituisce la traduzione, altrimenti prosegue il codice originale. - I testi cinesi non ancora tradotti vengono scritti in
c:\devel\hmi.log. - Le DLL decifrate/patchate vengono copiate nella cartella di installazione, che ha la precedenza su
ACTR.dll.
Requisiti
- USART HMI installato in
C:\Program Files (x86)\USART HMI - Windows con PowerShell e privilegi di amministratore
- Git e .NET SDK 9 nel
PATH - Connessione internet (clone del repo upstream e pacchetto NuGet Mono.Cecil)
Installazione
- Chiudi USART HMI.
- Clona questo repo:
git clone https://github.com/<tuo-utente>/USART-HMI-to-ITA.git cd USART-HMI-to-ITA
- Apri PowerShell come amministratore ed esegui:
Se la cartella di installazione è diversa:
Set-ExecutionPolicy -Scope Process Bypass .\scripts\Install.ps1
.\scripts\Install.ps1 -InstallDir "D:\USART HMI". - Avvia USART HMI: menu, barre e toolbox sono in italiano.
Lo script esegue: backup delle DLL originali in backup_original, decifratura, patch, copia dei file, creazione di c:\devel\ e installazione di hmi_translation.txt (se esisteva già, viene salvato come .bak).
Aggiungere o correggere traduzioni
- Usa il programma e apri
c:\devel\hmi.log: contiene i testi cinesi non tradotti. - Aggiungi righe a
c:\devel\hmi_translation.txt:testo cinese<TAB>traduzione italiana- codifica UTF-8, separatore TAB (non spazi)
- corrispondenza esatta e case‑sensitive; vale la prima occorrenza
- Proprietà a tendina (chiave del tipo
Nome:0-a;1-b;2-c): l'app ricava le voci dal testo tradotto, quindi la traduzione deve mantenere la strutturaNome:0-x;1-y;2-z, con un solo:, voci separate da;e senza-,:,;o~dentro i nomi delle voci. Altrimenti la tendina risulta vuota.
- Riavvia USART HMI (il file viene riletto quando cambia).
Se aggiungi traduzioni utili, copiale anche in translation/hmi_translation.txt e apri una pull request.
Disinstallazione / ripristino
Da PowerShell come amministratore:
.\scripts\Restore.ps1
Ripristina le DLL originali dal backup e rimuove quelle aggiunte, così l'app torna a caricare ACTR.dll. Puoi eliminare c:\devel\ a mano.
Avviso anti-manomissione (non traducibile)
Durante l'uso, specie dopo aver applicato questa patch, può comparire un messagebox con titolo "错误" (Errore) e questo testo:
版权声明:尊敬的用户,您当前正在使用的软件遭到暴力篡改,本软件为深圳市淘晶驰电子有限公司开发并申请软件著作权,我司将采取法律手段对篡改人进行法律诉讼,为保障您的个人权益,请立即卸载当前破解软件,如果继续使用,您的数据随时会有自毁风险,请务必立即停止使用并卸载软件.
Traduzione: "Dichiarazione di copyright: gentile utente, il software in uso ha subito una manomissione forzata. Il software è sviluppato da Shenzhen Topdisplay (TJC) Electronics Co., Ltd., che ne detiene i diritti d'autore. L'azienda intraprenderà azioni legali contro chi lo ha manomesso. A tutela dei tuoi dati, disinstalla subito il software craccato: continuando a usarlo rischi la perdita permanente dei dati. Interrompi immediatamente l'uso e disinstalla il software."
Questo messaggio non viene tradotto intenzionalmente e non è gestibile con questo progetto. Non passa dal metodo hmitype.LanguageApp.Language() usato per tutte le altre stringhe tradotte: è generato da achmiface.dll, un modulo di protezione anti-tampering del produttore (Shenzhen TJC) che rileva le modifiche apportate ai file del programma (incluse quelle di questa patch) e mostra l'avviso come deterrente. Sopprimerlo o modificarlo richiederebbe di disattivare un meccanismo di protezione/anti-manomissione del produttore, cosa che esula dallo scopo di questo repo (localizzazione dell'interfaccia) e che non viene supportata qui.
Se compare e preferisci non vederlo, l'unica opzione è ripristinare i file originali con scripts\Restore.ps1.
Risoluzione dei problemi
Struttura del repo
scripts/Install.ps1 installazione automatica
scripts/Restore.ps1 ripristino
src/HmiTr/T.cs helper di traduzione (target .NET 3.5, incorporato in hmitype.dll)
src/Patcher/Program.cs patcher Mono.Cecil
translation/hmi_translation.txt traduzioni cinese → italiano
Crediti e licenza
- Idea e decryptor: audiobrian/usart_hmi_english_translation (scaricato a runtime, non incluso qui).
- USART HMI è proprietà dei rispettivi titolari. Il codice e le traduzioni di questo repo sono rilasciati con licenza MIT.
Per il codice sorgente e gli altri progetti visita il profilo GitHub di rsodvd79 .