- sd2iec-0.10.3.9-ITS 09-Jul-2014: 
----------------------------------------------------------------------------
----------------------------------------------------------------------------

ENG.

Implemented functionality that allows to save a placeholder (unique for 
each .TAP file) pressing the red button on the back of the card. User 
can set back the read pointer at which TAP data is played back by 
pressing "Next" button on the card. Useful for multi load .TAP or
games asking to reset the counter of the tape and then to rewind the tape that 
specific point.

It is possible (separately for each .TAP file) :

- to set for example the placeholder (by pressing the red 
button) after the last loaded game in a multi load .TAP and then, when 
loading that .TAP from scratch again, load directly the game after the 
placeholder by pressing Next button when blue led flashes at the 
beginning of TAP load. This allows to load, in sequence, all the 
programs on the multi load TAP
- to set the placeholder when a game asks to reset the tape 
counter, then when the game asks to rewind back the tape to the point 
were counter is zero, press just "Next" button to get there
immediately. Very useful also with .TAP single files contatining both sides 
of the same cassette.

Notes:
- only one placeholder can be set for each .TAP file. If the red button 
is pressed more than once during the playback of the same .TAP file the 
placeholder position will be updated with the last position on tape of 
the last button press
- different .TAP files will have different placeholders
- if a TAP has a placeholder and user wants to reload it from the 
beginning it's enough not to press "Next" button and use the
FileBrowser (FB) or direct OPEN commands
- Placeholders CANNOT be set if pulses are being emitted by the card 
(i.e. blue LED is on). Placeholders can be recorded only if motor LED is 
off and/or Pulses LED is off (either of the two conditions or both). If 
pressing the Plaholder button nothing happens (no RED led flashing, no 
sound) it means placeholder cannot be set. If the placeholder is created 
successfully one beep will come from the card followed by other two 
bips. During Bips red LED will flash.
- On certain SD cards, when the first placeholder is saved from the 
moment the card has been plugged into C64SD, red LED can stay on for 
several seconds (even 20 seconds) after the first beep . This depends on 
the implementation of the wear levelling algorithm of the controller 
inside the SD card. This won't make placeholder save procedure fail. If 
three bips are heard placeholder has been saved correctly.Subsequent 
placeholder saving operations will be almost istantaneous.
- Setting placeholders will not make your loading operation fail you can 
press the red button in any moment without worrying about possibly 
breaking your load operations
- placeholders will NOT be lost by resetting or switching off the C64SD card
- "Next" button (the button to position back the read pointer to
the previously saved placeholder) will work only when motor is not active 
and/or no pulses are being emitted by the card. Additionally
"next" button can be pressed during the Blue LED flashing that precedes .TAP 
loading. If no Bips are heard and no red LED flashes are observed this 
means the positioning of the read pointer failed.
-it's not possible to set a placeholder at the end of the .TAP file.

Implemented confirmation of successful initialization of the C64SD card, 
When the card is successfully initialized and ITS has been detected two 
bips will be emitted by ITS piezo. Pretty much like BIOS bips in regular 
PCs.

Implemented end-of-virtual tape visual and audible indication. If the virtual tape 
is read till its end (the playback arrives at the end of the .TAP file) four
beeps are emitted and the blue LED flashes quickly to indicate end of tape. 
To restart using the card, C64SD must be reset either by pressing its reset button or
by switching it off and back on.

Implemented "Card Hide" function. Some protected programs distributed on tape 
may refuse to run if a disk unit is detected to be attached to the Commodore computer.
In this case executing the instruction:

OPEN 15,8,15,"H":CLOSE 15

Will set C64SD card into "Hide" mode and will allow to load the protected program
from datassette without any interference since C64SD presence will no longer be
detected by the program. "hide" mode will be indicated on the card by the red and
blue LEDs flashing alternatively. When it will be necessary to restart using the card we 
switched into Hide mode, C64SD card will have to be reset either by pressing 
its reset button or by switching it off and back on.
----------------------------------------------------------------------------
----------------------------------------------------------------------------

ITA.

Implementata funzionalit che permette di registrate un riferimento 
(indipendente per ciascun file .TAP) relativo alla posizione attuale del 
nastro premendo il tasto rosso sul retro della scheda durante l'utilizzo 
di un file .TAP. L'utente pu poi impostare il puntatore di lettura sul 
file .TAP alla posizione precedentemente salvata semplicemente premendo 
il tasto "Next" della scheda. Questa funzionalit pu essere
utilizzata durante il caricamento dei files .TAP contenenti pi programmi (Multi 
load .TAP) o con i giochi che richiedono di resettare il contatore sul 
registratore e, successivamente, di riavvolgere il nastro fino a quel 
punto specifico.

E' possibile (in maniera indipendente per ciascun file .TAP) :

- impostare per esempio il riferimento posizionandolo (premendo il tasto 
rosso) dopo l'ultimo gioco gi caricato di un file .TAP contenente pi 
programmi, in modo che, quando si ricarica quel file .TAP da capo, si 
possa cominciare a caricare il programma successivo all'ultimo gi 
caricato in precedenza, semplicemente premendo il tasto "Next"
mentre il led blu dei dati lampeggia all'inizio del caricamento. .
- impostare il riferimento quando un gioco o un programma chiedono di 
azzerare il contatore in modo che quando, successivamente, viene 
richiesto di riposizionare il nastro in quel punto si possa facilmente 
effettuare questa operazione premendo semplicemente il tasto
"Next". Molto utile per esempio anche nel caso di files .TAP che contengono i 
due lati della cassetta in un unico file.

Note:
- solo un riferimento pu essere attivo per ogni file .TAP. Se il 
bottono rosso viene premuto durante l'utilizzo di un file .TAP che gi 
aveva un riferimento registrato, il nuovo riferimento sostituir quello 
precedentemente registrato
- Ogni riferimento viene registrato per lo specifico file .TAP in 
caricamento al momento che il tasto rosso viene premuto
- Il fatto che esista un riferimento per un file .TAP non obbliga al suo 
utilizzo. E' possibile caricare dall'inizio un file .TAP per cui si
era registrato un riferimento usando la procedura standard (comando Open o 
Filebrowser) semplicemente evitando di premere il tasto "Next"
- Il riferimento non pu essere registrato mentre la scheda sta inviando 
dati al computer (cio quando il led blu dei dati  acceso). Il 
riferimento pu essere salvato solo mentre il LED blu dei dati  spento 
oppure mentre il LED blu del motor  spento (entrambi le condizioni vere 
allo stesso momento o comunque anche una sola delle due). Se premendo il 
tasto rosso del salvataggio del riferimento non si sentono beeps e il 
LED rosso non si accende/lampeggia significa che il salvataggio del 
riferimento  fallito. Se il riferimento  stato registrato con successo 
si sentir un beep segutio da altri due. Il LED rosso lampegger in 
corrispondenza con i beeps.
- Su certe memorie SDCard, quando il primo placeholder viene registrato 
dal momento che la scheda SD  stata inserit nella C64SD, il LED rosso 
potrebbe rimanere acceso anche per 20 secondi dopo il primo beep.Ci 
dipende dal controller della scheda SDCard e dalla sua strategia di 
livellamento dell'usura delle celle di memoria che la compongono.La 
procedura di salvataggio del riferimento verr comunque portata a 
termine con successo. Se si sentono 3 beeps vuol dire che il riferimento 
 stato correttamente salvato. Gli accessi successivi alla card saranno 
comunque praticamente istantanei.
- Il pulsante di salvataggio del riferimento pu essere premuto in 
qualsiasi momento senza effetti negativi sul caricamento del .TAP in uso
- I riferimenti dei files .TAP non vengono persi spegnendo o resettando 
la scheda C64SD
- Il pulsante "Next" (quello che serve per riportare la lettura
del nastro al riferimento precedentemente salvato) funziona soltanto quando 
il motore del nastro non  attivo (cio il LED blu del motor  spento), 
quando la scheda SDCard non sta inviando dati la computer (cio il LED 
blue dei dati  spento) o durante il lampeggiamento iniziale del LED blu 
all'inizio del caricamento. Se alla pressione del tasto"
Next" non si sentono beeps e il LED rosso non lampeggia significa che l'operazione
di riposizionamento del nastro al riferimento non  stata eseguita.
- Non  possibile impostare un riferimento alla fine del file .TAP.

Implementata la conferma di inizializzazione della scheda tramite il buzzer
integrato. Se la scheda C64SD viene inizializzata con successo 2 beeps vengono 
emessi dal suo piezo esattamente come succede per il BIOS dei PC.

Implementata la funzione audio-visulae per indicare che il playback del nastro 
virtuale ha raggiunto la fine del file .TAP. Quando viene raggiunta la fine del
file .TAP vengono emessi 4 beeps e il led blu lampeggia rapidamente. Per poter
riutilizzare la scheda a questo punto  necessario resettarla tramite l'apposito
pulsante o spegnendola e riaccendendola.

Implementata la funzione di mascheramento della presenza della scheda. Alcuni programmi
distribuiti su nastro, come sorta di protezione dalla copia, rifiutano di funzionare
nel caso venga identificata ub'unit disco connessa al computer Commodore.
Prima di caricare tali programmi  sufficiente eseguire l'istruzione:

OPEN 15,8,15,"H":CLOSE 15

In modo da mettere la C64SD in modalit "Hide" (nascosta) quindi si potr procedere
al caricamento tramite datassette del programma protetto senza nessuna interferenza
perch la C64SD non potr pi essere rilevata dal programma. Quando sar necessario poter
riutilizzare la scheda sar necessario resettarla tramite l'apposito pulsante oppure
spegnendola e riaccendendola.
