Tutorial Italian Language Quickstart Guide - Guida Rapida a SimTools

@RaceRay @yobuddy I don't know if this thread it's the right one, feel free to move it if necessary.
Just like I promised, I did found the time to translate the quickstart guide an to add the SCN5 setup part.

Guida Rapida a SimTools.
Seguire questa guida, passo-passo, è il metodo più facile per configurare il vostro simulatore e per poter sfruttare le prime funzioni basilari di SimTools.

Per informazioni più dettagliate, usare la guida completa (in inglese):
http://www.xsimulator.net/simtools-complete-documentation/

SimTools è stato progettato per essere un set di strumenti in grado di configurare un simulatore dinamico il più velocemente possibile, pur offrendo la possibilità di dare all'utente tutta la personalizzazione e flessibilità di cui avrà bisogno.

Una funzionalità davvero interessante di SimTools è l'opportunità di modificare il profilo "in diretta"! Crea un profilo per un gioco, e poi regolalo fino alla perfezione mentre stai giocando! Non avrai bisogno di fermare il gioco per fare le modifiche necessarie!

A PROPOSITO DI QUESTA GUIDA...

Seguite questa guida passo-passo dal punto 1 al punto 10 e riuscirete a far muovere il simulatore secondo il profilo di default! Buon divertimento!

Requisiti:
a) Obbligatori:

• Windows XP, Windows 7, Windows 8
• Microsoft .NET 4

b)Opzionali:

• Un secondo computer connesso al tuo computer da gioco, rende la regolazione del profilo molto comoda, ma è comunque non necessario.
• Connettere il secondo computer con un cavo ethernet crossover rende le prestazioni molto più elevate.

COSE DA FARE PER L'INSTALLAZIONE

Seguire questi passaggi in ordine.

Prima cosa da fare: il download.

1. ATTENZIONE: il pacchetto Microsoft Dot Net 4.0 è obbligatorio. Lo potete trovare a questo link http://www.microsoft.com/en-us/download/details.aspx?id=17851
2. Assicuratevi che la dimensione del testo del vostro Windows sia al 100% (le istruzioni possono essere trovate qui: link)
3. Installare SimTools
4. Scaricare i Plugins relativi ai vostri giochi preferiti che potrenno essere trovati nella resource section.
5. Non estraete gli Zip dei Plugin! Vanno usati zippati.
6. “Life For Speedtm” è il preset standard di SimTools, si può scaricare la versione demo del gioco qui: http://www.lfs.net/?page=downloads
7. Bisogna avviare il gioco almeno una volta per poterlo patchare in modo corretto.

Seconda cosa da fare:

• Scaricare l'ultima versione da qui: [link]
• Estrarre ed eseguire SimTools.
• La cartella tipica di installazione si troverà in “C:\Program Files (x86)\SimTools“
• Selezionare la Full Installation se avete intenzione di utilizzare un solo PC. Se volete usarlo con due PC, dovrete installare il programma su entrambe i computer. In quel caso selezionate il GameManager per il PC che esegue il gioco, e selezionate GameEngine per il PC che controllerà il simulatore.
• Selezionate Launch GameEngine e Launch GameManager prima di cliccare Finish nell'ultima schermata dell'installazione. Questo vi permetterà di avviare il programma subito dopo l'istallazione, ma se avete intenzione di utizzare altri titoli a parte Life for Speedtm, chiudete sia Game Manager che Game Engine prima di procedere.
• Adesso avrete 4 eseguibili: Game Engine, Game Manager, Game PluginUpdater e Uninstall.

Importazione Plugin

• Controllate se nella Tray Icon di Windows ci sia il GameEngine e il GameManager, e assicuratevi di terminarli, nel caso siano presenti
• Avviare il GamePlugin Updater.
  
• Questo programma può essere trovato nella cartella di installazione di SimTools (probabilmente in C:\Program Files(x86)\SimTools\SimTools_PluginUpdate.exe)
• Trascinate il file zippato del plugin dentro al PluginUpdater. Ci sarà un avviso di conferma se il plugin verrà installato correttamente.
• Se state usando una configurazione a due PC, installate il plugin in entrambe.
• Una volta fatto questo, il profilo sarà disponibile nel Game Engine e nel Game Manager.
• Chiudere SimTools GamePlugin Updater.

Patchare il Gioco

• Avviare il GameManager e il GameEngine. Nota: se ci saranno problemi nel patchare il gioco, cliccare sull'icona con il tasto destro e selezionare "Esegui come amministratore".
  
• Se la finestra del GameManager non si aprirà automaticamente, fare doppio click sull'icona in basso a destra.
• Selelzionare il gioco che si vuole utilizzare dalla lista del menu.
• Premere “Patching” per patchare il programma. Seguire le istruzioni del plugin e premere Patch Game.
• Ci dovrebbe essere un messaggio di conferma quando l'operazione va a buon fine (“Patch Installed!”).

CONFIGURARE GLI ASSI
a) Definizione

Se il vostro simulatore è mosso da diversi attuatori, considerate che ogni attuatore è visto da SimTools come un asse. SimTools può estrarre fino a 9 dati di telemetria (da DOF1 fino a DOF9) dai giochi e può gestire fino a 6 attuatori (da "Axis1 fino a "Axis6"). Questa parte della guida vi permetterà di indicare a SimTools quale mix di dati dovrà analizzare prima di mandare le istruzioni all'interfaccia del simulatore. Ci sono alcuni confiurazioni standard già pronti per l'utilizzo, come il “SimForce GT”, un simulatore di movimento con due attuatori collegati al retro del sedile.

b) Configurare gli assi di "Default"

Per prima cosa, dobbiamo definire la configurazione di “Default”, quella che vogliamo SimTools utilizzi, successivamente si potrà regolare in dettaglio.

• Cliccare col pulsante sinistro del mouse sull'icona del GameEngine.
  
• Cliccare su Axis Assignments.
• Sotto la lista Game List Axis Assignment 1) selezionare "Default".

• Cliccare sul pulsante Preset.
• Selezionare un preset dalla lista.

La scheda tornerà automaticamente sulla Axis Assignments Tab 1

• Selzionare "Default" dalla Game List e poi cliccare su "Save Settings".

Questo è il primo basilare setup che potrà usare il roll e il pitch del gioco.

Con un po di esperienza potrete aggiungere qualche altro effetto, come il Surge per simulare l'accelerazione e la frenata, oppure l'Heave per le buche della strada.

c) Attenzione

Assicuratevi di configurare il profilo di "Default" perchè sarà quello utilizzato quando si installa un nuovo plugin:

1. Quando si usa l'Output Testing, l'Axis Assignments Profile che sarà utilizzato è quello di "Default”. Se non avete configurato questo profilo, non si potrà ottenere nessun movimento.
2. Il profilo di "Defalut" è quello utilizzato per i giochi che saranno installati successivamente.

Ricorda:

• L'Axis 1 fino al 6 sono gli attuatori del tuo simulatore.
• Il DOF 1 fino al 9 sono i valori estratti dal gioco attraverso il plugin.

Comunicare con il simulatore

Sim Tools supporta fino a 6 differenti interfacce!

Sono selezionabili nelle 6 schede.
Interface 1 - Interface 6.

a) Quante interfacce servono?

Per un simulatore a 2 DOF, come il SimForceGT, c'è bisogno soltanto di 1 interfaccia se si utilizza Arduino, che riesce a pilotare 2 attuatori.

Questi sono i passaggi d'esempio per la configurazione delle interfacce Arduino, JRK e SCN5. Ci sono altre interfacce disponibili, come per esempio SimAxe o Kangaroo Controller. Consultare il forum per maggiori informazioni.

Esempi per Arduino:

Arduino è connesso a Windows attraverso la porta COM3.
SimTools “Interface 1″ manda alla porta COM3 le informazioni dell'Axis 1 e dell'Axis 2.
Arduino manderà le informazioni ai relativi attuatori.


Esempi per l'interfaccia JRK.

Avrete bisogno di 2 schede JRK 12v12. Ugni scheda guiderà un attuatore.

• La JRK1 connessa alla porta COM4
• SimTools “interface 1″ manda le informazioni all'Axis1 alla porta COM4.
• JRK1 manda i comandi dell'Axis1 all'attuatore 1.

• JRK2 connessa alla porta COM6
• SimTools “interface 2″ manda le informazioni all'Axis2 alla porta COM6
• JRK2 manda i comandi dell'Axis2 all'attuatore 2.

b) Altri tipi di interfacce.

In pratica si utilizzerà la “USB Serial interface” per controllare Arduino/JRK (le interfacce NET sono utilizzate per connessioni attraverso la rete, e la SCN è utilzzata per gli attuatori SCN5 che verranno analizzati al punto "e").

Cliccare sul pulante Interface Settings.

• Selezionare Interface 1 per configurare la prima interfaccia.
• Selezionare Output Type - di solito “SER”.

c) Configurazione per JRK.

• Se si vuole utilizzare una scheda JRK, selezionare JRK 12bit dalla lista dei preset. Altrimenti selezionare la porta corretta come indicato sul manuale del controller.
• Selezionare la porta COM a cui è connesso il controller.

Cliccare su "Save".

• Cliccare sul pulsante Interface 2.
• Come prima, selezionare SER, e la porta COM corretta.
• Selezionare <Axis2> su Interface - Output.

Cliccare "Save".

d) Configurazione per ARDUINO.

Interface 1:


e) Configurazione per SCN5.

• Cliccare su Interface Settings, poi su Interface1, e su Output Type selezionare SCN.
• Sotto ComPort, selezionare una delle porte a cui i vostri SCN5 sono connessi (nel caso non sappiate quali sono, centrollate su "Gestione Dispositivi" di Windows, sotto la voce "Porte COM e LPT")
  
• Sotto Packet Rate selezionare 10 ms.
• Sotto Assignment Axis, selezionate Axis 1.
• Nella barra Speed si regola la velocità dell'attuatore, impostate un valore temporaneo di 10.000 (valore che potrà essere gradualmente aumentato successivamente).
• Nella barra Acceleration si regola l'accelerazione dell'attuatore, impostate un valore temporaneo di 500 (anche questo valore si potrà modificare successivamente).
• Adesso rifare la stessa operazione con l'Interface2, utilizzando la porta COM non selezionata precedentemente, e assegnando Axis2 sotto la voce Assigned Axis (importante!).
• Come ultima cosa cliccare su Axis Assignment, poi su Axis Limiting ed assegnare ai valori Axis1 e Axis2 (e più in genarale ad ogni asse utilizzato da un SCN5) un valore di 90. Questo è molto importante per aumentare la vita dell'attuatore, perchè se non si limita questo valore, l'attuatore potrebbe danneggiarsi quando raggiunge il fine corsa della meccanica.

Muovere il simulatore (con il mouse).

Muoviamo il simualtore con il nostro mouse!

Si consiglia di provare il simulatore manualmente prima di fare dei test su un videogame.

1. Controllare che sia tutto collegato nel modo corretto.
2. Andare su Game Engine / Output Testing.

Clicare su Turn on.
Selezionare Axis Testing.

Ora selezionare un Axis, e con il mouse muovere il cursore lentamente a destra e a sinistra, così facendo potrete osservare il movimento del vostro simulatore a seconda degli assi che entrano in gioco. Considerate che la limitazione dell'asse non è abilitata per questo utilizzo.

La morbidezza dipende dal refresh rate (provate un valore inferiore ai 10 ms).

Controllare la direzione del movimento.

Ora dobbiamo verificare se il simualtore si comporta nel modo corretto: se il plugin del gioco manda l'informazione "inclinati a sinistra" il simulatore deve inclinarsi a sinistra, e non a destra!

Si può sempre invertire l'elettronica dell'attuatore, ma è molto più semplice invertire l'asse su Axis Assignments.

Con gli slider ci assicuriamo che il movimento sia nella giusta direzione.

Per esempio.

Roll : 100% - Inclinazione a Sinistra
Roll : – 100% – Inclinazione a Destra
Pitch : 100% – Inclinazione in Avanti
Pitch : – 100% – Inclinazione all'Indietro

Dobbiamo seguire il sistema di coordinate utilizzate da SimTools. Sim Tools Plugin API reference – http://www.xsimulator.net/co-ordinate-system/

Gli assi virtuali si trovano di fianco a “Axis Testing”e possono essere attivati cliccando su “Turn On”.

Una volta che avremo concluso la configurazione potremo patchare il gioco e cominciare la regolazione vera e propria del nostro profilo.

Visualizzare l'estrazione dati.

Cliccate su Output Testing.
Non collegate gli attuatori.

• Cliccare su Virtual Axes e premere Turn on.
• Avviare il gioco.

Se è stato confiturato tutto nel modo corretto, gli slider dovrebbero muoversi.
Ora potrete vedere SimTools che legge la telemetria della vostra auto virtuale!



Nota: se si vuole testare il movimento degli slider e non si hanno 6 Porte COM, scrivere
<Axis1><Axis2><Axis3><Axis4><Axis5><Axis6>
sul Interface – Output line.

Accendere il simulatore.

a) Approccio in sicurezza.

Per prima cosa, la sicurezza: per evitare danneggiamenti al vostro hardware, cominciate i test mantenendo un range limitato e un'intensità ridotta.

• Da GameEngine / Axis Assigments / Axis Limiting : riducete il valore al 50%

• Dal GameManager, aprite il “Profile Editor” e in Game tab / Main settings impostate il Main Level al 20% per protegere i vostri attuatori.

b) Secondo punto, avviare la sequenza.

1. Avviare il Game Engine.
2. Avviare il Game Manager, selezionare il Game Profile dalla lista.
   
3. Avviare il gioco, entrate in pista e il simulatore prende vita.

c) Aumentare i valori.

- IMPORTANTE -
Incrementate i valori fino a che non li troverete soddisfacenti.

Per le prestazioni migliori, assicuratevi che il valore del Main Level sia al 100%. Assicuratevi inoltre che il valore dell' Axes Limiting sia al 100% (a meno che non abbiate un attuatore SCN, in questo caso si consiglia di mettere 90%, per evitare danni a lungo termine).

Conclusione
Congratulazioni, avete completato la guida rapida!

I want to give a big Thanks to my friend @bsft that's help me a lot. Thx you dude!

AH Ard info is for only one of the codes, there are three majors.
Just a little note its for RacingMats code only.
Well Done.

E pensare che stavo per tradurre con google....sai che pastrocchio ne usciva menomale che è stata tradotta da te in italiano e non da google...grazie mille nclabs


And to think I was going to translate with google .... you know that mess came out: luckily that has been translated into Italian by you and not by google ... thanks a lot

arrivo in ritardo ma ti ringrazio profondamente per averci evitato un altro tutorial googletraslato dal quale non si capisce una.....XXXXX

late arrival but I thank you deeply for having avoided another tutorial googletraslato from which you do not understand a.....XXXXX

grazie, non è mai troppo tardi a qualcuno prima o poi serve.

thanks, it's never too late to someone sooner or later is needed.

Infinitamente grazie. ..

Una mano?ho arduino e monstermotor shield si muovono i motori wiper ma appena parte il gioco già pacchato non si muove più nulla

Cmq grazie per la traduzione

Grazie Mille

salve ...dove posso prendere lo sketch per arduino ?

non mi risponde nessuno ? grazie

My suggestion: Post your question in the original English thread: https://www.xsimulator.net/simtools-quickstart/
and use the English language. This could increase your chance to get an answer.

hello ... where can i get the arduino sketch?

@@RaceRay@@yobuddy
you did a masterpiece !! thanks for everything, I managed to make my 2dof dynamic work on the first try.

Hello, I saw a scheme in which a single Arduino R3 can drive up to 3 engines (pwm1, pwm2, pwm3).
But in this post I read that Arduino can drive up to 2 engines.
I didn't understand, I'm confused, can you explain me?
Thank you

absolutely yes, the excellent SCM3 firmware can drive 3 motors. pwm1 and pwm2 with modifiable frequency, while pwm3 sets to limit calculus arduino.
use 3 dof without any problem.
find all the clear documentation on the smc3 discussion

Thanks you are very kind.
Can you tell me which is the latest version (the newest) of the sketch for Arduino Uno R3?
Can you attach the download link?