RetrofficinaGLG

Questa pagina è in sola lettura. Puoi visualizzare il sorgente, ma non puoi modificarlo. Contatta l'amministratore se pensi che ci sia un errore.
====== tinyDisk][ ======

{{ :tinydiskii:tinydiskii.png?400 |}}

🇮🇹 Il tinyDisk][ (o //tinyDiskII//) è un emulatore di floppy disk per la serie di computer Apple II, sviluppato da RetrofficinaGLG.

Il progetto è in stato di **prototipo funzionante**, poiché è stata realizzata un'unica revisione hardware su cui sono state applicate diverse correzioni fisiche in post-produzione.
Una futura revisione hardware non è ancora stata programmata.
Se sei interessato a contribuire al progetto, scrivici tramite il [[contatti|form di contatto]].

🇬🇧 The tinyDisk][ (or //tinyDiskII//) is a floppy emulator for Apple II series computer, developed by RetrofficinaGLG.

The project is in a **working prototype** status since only one hardware revision does actually exists, and must be physically patched to be fully functional.
At the moment, a new hardware revision is not scheduled.
If you are interested to contribute to the project, write us through [[contatti|contact form]].

===== How does it work? =====

🇮🇹 //Come funziona?// Il tinyDiskII simula un lettore Apple Disk II in lettura e scrittura.

Il progetto è nato come una implementazione personalizzata dell'emulatore "SdiskII" di Koichi Nishida [[https://tulip-house.ddo.jp/digital/SDISK2/english.html|1]] [[https://github.com/suaide/SDisk2|2]], che ho usato come punto di partenza per lo sviluppo firmware.

Le immagini disco sono memorizzate in una scheda SD formattata in FAT16.
Ogni immagine disco deve essere una immagine floppy DOS3.3 convertita opportunamente in un file .NIC (come l'SdiskII).
La formattazione non è ancora pienamente supportata ed è in sviluppo.


🇬🇧 tinyDiskII is able to simulate an Apple Disk II both in reading and writing.

The whole projects borns as a custom implementation of Koichi Nishida's SdiskII [[https://tulip-house.ddo.jp/digital/SDISK2/english.html|1]] [[https://github.com/suaide/SDisk2|2]], which I used as a starting point for firmware developement.

Disk images are stored into a FAT16 formatted SD Card.
Each disk image must be a DOS 3.3 floppy image, saved as .NIC (like SdiskII). A cross platform .NIC <-> .DSK conversion tool will be available soon.
Floppy formatting is currently not supported, but it is currently under developement.

===== Hardware =====

🇮🇹 Puoi trovare le informazioni sull'hardware nella cartella ''schematics'' del [[https://github.com/GLGPrograms/tinyDiskII|repository github del progetto]].
Ricorda che la revisione hardware corrente (rev 1.0) ha alcune sviste, leggi anche le [[https://github.com/GLGPrograms/tinyDiskII#schematics-and-pcb|correzioni]] prima di procedere con una stampa del PCB.

🇬🇧 You can find hardware information in the ''schematics'' directory of the [[https://github.com/GLGPrograms/tinyDiskII|tinyDiskII github repository]], both to replicate the project or as reference for a new one.
Keep in mind that current hardware revision (rev 1.0) has some typos, be sure to read the [[https://github.com/GLGPrograms/tinyDiskII#schematics-and-pcb|errata]].

===== Firmware =====

🇮🇹 Il progetto è basato su un microcontrollore Atmel della serie Xmega.
È stata una scelta preferenziale rispetto ad un atmega per la possibilità di portare il clock a frequenze più elevate, per la disponibilità di periferiche più avanzate, e soprattutto perché era quello che avevo a disposizione ^_^

Il firmware gestisce, quasi interamente in software, il protocollo di comunicazione con la scheda di interfaccia floppy dell'Apple II.
Insieme a questo, gestisce la comunicazione con la scheda SD (ed il file system FAT16) ed una rudimentale interfaccia grafica su display OLED.

🇬🇧 The project is based on an Xmega series Atmel microcontroller.
I preferred it over an atmega because of the faster clock, the presence of advanced peripherals and, mainly, because I had nothing else ^_^

The firmware handles, almost entirely in software, the communication protocol with the floppy interface board of the Apple II.
Moreover, it handles the communication with the SD card (and the FAT16 file system) and a basic GUI on an OLED display.

==== Firmware TODO ====

  * Add a way to copy/delete floppy images without using a computer;
  * <del>Full support to format operation (i.e. using Xmega DMA)</del> Done, see branch [[https://github.com/GLGPrograms/tinyDiskII/tree/rev2.0|rev2.0]];
  * probable porting to RP2040?.


===== Software =====

🇮🇹 L'emulatore è stand-alone e non richiede un PC moderno per poter funzionare. L'unico software necessario è un programma di conversione da immagine .DSK (il formato più comune) a .NIC e viceversa.
Un .NIC è una copia bit-a-bit semplificata di ciò che la testina del floppy vedrebbe se si stesse muovendo sopra il floppy emulato.
Sul [[https://tulip-house.ddo.jp/digital/SDISK2/english.html|sido di Koichi Nishida]] è possibile trovare un software Java che converte da e verso .NIC.

🇬🇧 The tinyDisk][ is stand-alone, it doesn't need a modern computer to work. The only required software is a conversion tool from .DSK image to .NIC and viceversa.
.NIC is a simplified bit-to-bit copy of what a floppy head would see moving on the floppy.
On [[https://tulip-house.ddo.jp/digital/SDISK2/english.html|Koichi Nishida's website]] you can find a Java tool to convert from and to .NIC file format.