XTC 
Data relazione :29/08/2025 
Revisione      :3.0

Piccola guida all'uso.
PS. è un programma di libero uso inteso per testare le apparecchiature collegate via ArtNet TimeCode.
Da non utilizzare in live.
Non mi assumo alcuna responsabilita derivante da un suo utilizzo.
Non contiene traccianti, cookies o cose simili.
Licenza GNU...ma non approfittatene, ad esempio con reverse engineering per venderla sotto altre vesti!!!

IMPOSTAZIONI:
Occorre che il dispositivo android sia inserito sulla stessa rete ARTNET dei dispositivi da controllare.
Dalla versione 2.3 , il calcolo dell'indirizzo di broadcast viene automatizzato rendendo disponibile la trasmissione del TC
ragionevolmente, su qualsiasi rete.
Si consiglia comunque la rete ArtNet canonica (2.x.x.x)
All'avvio si collegherà con la porta ARTNET 6454 ed inviera il TC seguendo le specifiche
del protocollo ARTNET su indirizzo di broadcast con protocollo UDP.


IMPOSTAZIONE TC PER INZIARE A LAVORARE

Impostazione TIME CODE-
1>andare sul dito su una delle quatto linee presenti sopra il tasto RESET/CATTURA
 Da sinistra verso destra sono HH MM SS FF
2>si apre la tastiera e basterà scrivere il valore desiderato
 Per il campo "ore" ho deciso di andare oltre lo standard SMPTE e di espendere il range 
 da 0 a 98 (Chamsys è uno dei pochi programmi che legge offset > 24h)
 98 è un limite che ho imposto per l'utilizzo con il programma di gestione regia XAUDIO2

Tasto START.
 Sciacciandolo fa partire il generatore con le impostazioni sopra settate.
 I numeri colorati in verde , in alto,sono il TC trasmesso.

Tasto PAUSA.
 Mette in pausa il generatore.Rischiaccando verrà ripreso il tc dal punto di pausa.

Tasti 24-25-30
 Impostano i FPS del TC. Il valore verrà visualizzato in alto a SX in rosso di fianco 
 al TC trasmesso.Il frame di partenza è il numero 0 (ZERO)

Tasti AVANTI/INDITRO (+ e -)
 Sciacciandoli si aumenta/diminuisce di UNA unita il campo sopra interessato (hh mm ss ff):
 Ogni campo ha i suoi tasti + e -
 Raggiunto il limite superiore ammesso per il campo (98 per le ore,59 per i minuti,59 per i secondi,FPS per i frame) il valore viene impostato a 0

Tasto RESET
 Ferma ed azzera il generatore ed i campi di immissione del TC 

Tasti CATTURA e C
 CATTURA >
 Il tasto CATTURA  acquisisce i campi in cui si imposta il TC (le linee per intenderci)
 Verra chiesto di inserire un nome indetificativo per l'inserimento nella lista.
 Di default viene inserito un contatore autoincrementante (aumenta di 1 ad ogni inserimento) ma puo essere sovrascitto.
 E' solamente per rendere piu leggibile il testo in una lista
 C >
 Cattura il TC visualizzato in verde (tipo screenshot).
 Quest'ultimo puo essere utilizzato ad esempio per catturare sull'attimo , in LIVE, un evento altrimenti
 difficilmte individuabile con i settaggi.
 In questo caso, dato che è pensato per una cattura "live" non viene chiesto nessun nome per il salvataggio (vedi sotto per suggerimento tasto X)
 
Campo LISTA
 In questo campo vengono inseriti i TC registrati con le procedure precedenti oppure, se collegato ad XAUDIO2 viene 
 caricata la playlist inviata da pannello server.
 Per riprendere (utilizzare) un TC registrato,è sufficiente andare con il dito sulla riga interessata ed immediatamente il TC
 indicato nella riga,verrà riportato nei campi TC e quindi si potra utilizzare subito senza doverlo impostare manualmente.

Tasto X >
 Nel momento in cui si seleziona un riga, in questa casella viene indicato il numero corrispondente alla sua posizione nella lista.
 Schiacciando questo tasto, verrà avvia la procedura di cancellazione della riga stessa.
 Verrà chiesto di confermare o meno.
 La cancellazione NON interessa il file salvato e comunque il TC registrato viene impostato nei campi TC e quindi , anche se si cancella
 per sbaglio, basta schiacciare CATTURA e si risalva.
 SUGGERIMENTO
 Se si cattura un TC con il tasto C, si puo sfruttare questa provedura per dargli un identificativo:
 1>Selezionare il TC catturato.il TC verrà comunque impostato nei campi TC
 2>cancellare la riga
 3>schiacciare il tasto CATTURA
 4>nominare il tc e salvare

MENU 
##SALVA LISTA.
 salva la lista che viene creata sfruttando i tasti CATTURA e C
 
##CARICA LISTA
 Carica la lista precedentemente salvata.

##CANCELLA FILE
 (ATTENZIONE) Cancella il panello lista ed il file presente nella memoria del telefono.

##AZZERA LISTA
 Cancella il panello lista
 
##CONTROLLA IP
 Come indicato nella premessa per la versione 2.3, la trasmissione broadcast viene estesa ragionevolmente a tutti i tipi di rete.
 Con questo tasto viene visualizzato l'IP assegnato al telefono e l'indirizzo di broadcast calcolato per la rete su cui si è collegati.

##ARTNET TC IN
 Con questa opzione è possibile leggere il TC in transito sulla rete a cui è collegato XTC.
 Il campo di testo in cui è visualizzato normalmente il TC diventerà nero e la scritta rossa.
 tornerà al consueto funzionamento.
 Durante il funzionamento TEST IN, nella casella in alto a SX, verrà visualizzato il formato del TC in ingresso
 preceduta dalla lettera I .
 Qui di seguito gli esempio : I24 (24frs-Video),I25 (25frs-EBU), IDF (29.3 Drop Frame), I30 (30frs-SMPTE)(
 
##ARTNET DMX IN
 Con questa opzione si ha ha disposizione un piccolo viewer del dato DMX presente sulla rete artnet.
 I tasti +- del campo ORE permettono di scegliere l'universo da monitorare (da 1 a 99)
 I tasti +- del campo MINUTI permettono di scegliere la CENTINAIA del canale DMX da monitorare (es 100)
 I tasti +- del campo SECONDI permettono di scegliere le DECINE del canale DMX da monitorare (es 10 )
 I tasti +- del campo FRAME permettono di scegliere le UNITA del canale DMX da monitorare (es 1)
 La somma dei valori sopra selezionati (centinaia+decine+unita) da il numero del canale in esame.
 Esempio di calcolo (con i valori sopra indicati): canale in esame 111
 Il tasto RESET riporta il canale in esame al volore 1

##INFO
 Informazioni varie sul programma

##APRI HELP
 Apre questa piccola guida.
 ATTENZIONE: se la lista delle registrazioni non è stata salvata,verrà persa.

##CHIUDI HELP
 Chiude il panello di HELP e ricarica la schermata principale.
 ATTENZIONE: la lista , nel caso fosse popolata prima di apri l'HELP,sarà vuota ed occorrera ricaricarla.

NOTA
 La pressione di un qualsiasi tasto presente sul pannello disattiverà le funzioni IN in essere e farà
 tornare XTC  alla modilita di generatore di TC ARTNET
 Il tasto RESET non ha questa ultima proprietà.

NOTE PER ESPERTI
Il file con i TC registrati nella lista ,viene salvato nella cartella ANDROID/DATA/B4AEXAMPLE/FILES/XTC
E' un semplice file di testo.Puo essere che a seconda del sistema operativo , la posizione possa essere differente.
Se si volesse editarla, basta usare un editor per testo.
ATTENZIONE. il carattere # (cancelletto) è il separatore utilizzato per dividere il campo testo dal campo orario.
Se si vuole aggiungere/modificare del testo occorre farlo PRIMA del carattere #
Ricapitolando: a sinistra del # è presente il testo (esempio BASE02) a destra l'offset TC.

ATTEZIONE:Non è possibile creare piu liste con nomi differenti questo vuol dire che se 
 ad esempio un TC di un spettacolo è salvato insieme ad altri TC.
 Nel momento in cui si SALVA la lista, il file presente sul telefono viene CANCELLATO/SOVRASCRITTO.
 
NOTA per XAUDIO2
 Dal menu SERVER > SMARTPHONE è possibile caricare nella lista tutta la playlist dello spettacolo
 con i relativi offset in modo da aver sotto mano tutto il materiale.

MODIFICE REV

2.1 > 01/04/25 aggiunta HELP e correzione divisore decimale per 24 e 30FPS
2.2 > 02/05/25 aggiunta opzione menu AZZERA LISTA e Modifica CANCELLA FILE
2.3 > 04/06/25 Calcolo automatico dell'indirizzo di broadcast per permetterne l'uso anche su reti civili. Si consiglia comunque la rete canonica.
2.4 > 04/07/25 Aggiunto controllo per tenere il telefono attivo durante il lavoro.Se andava in screensaver si interrompeva la generazione del TC
2.5 > 25/08/25 Aggiunto la possibilita di testare il TC in ingresso (Comando attivato da una voce nel menu) 
3.0 > 29/08/25 Possibilita di poter visionare anche il dato DMX di canale/universo ,selezionabile,presente sulla rete ARTNET ed SACN.