DR HACK

Davide Rosa Hack

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

  1. USART HMI.exe carica 21 assembly .NET cifrati da ACTR.dll.
  2. Lo script li decifra con il decryptor del repo upstream (compilato in locale dal sorgente).
  3. Il programma in src/Patcher (Mono.Cecil) inserisce all'inizio del metodo hmitype.LanguageApp.Language(string) una chiamata a un helper (src/HmiTr, copiato dentro hmitype.dll: nessuna DLL aggiuntiva). L'helper cerca il testo cinese in c:\devel\hmi_translation.txt; se lo trova restituisce la traduzione, altrimenti prosegue il codice originale.
  4. I testi cinesi non ancora tradotti vengono scritti in c:\devel\hmi.log.
  5. 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

  1. Chiudi USART HMI.
  2. Clona questo repo:
    git clone https://github.com/<tuo-utente>/USART-HMI-to-ITA.git
    cd USART-HMI-to-ITA
  3. Apri PowerShell come amministratore ed esegui:
    Set-ExecutionPolicy -Scope Process Bypass
    .\scripts\Install.ps1
    Se la cartella di installazione è diversa: .\scripts\Install.ps1 -InstallDir "D:\USART HMI".
  4. 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

  1. Usa il programma e apri c:\devel\hmi.log: contiene i testi cinesi non tradotti.
  2. 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 struttura Nome: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.
  3. 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.

Apri il progetto su GitHub

Per il codice sorgente e gli altri progetti visita il profilo GitHub di rsodvd79 .