===========================================================================
          Página de desarrollo del gestor Catweasel para AmigaOS
                              de Ian Gledhill

    Traducción libre y sin garantías al español v1.2 (06/04/2012)
           de © Dámaso Domínguez (AmiSpaTra) de la dirección
                http://www.retroreview.com/iang/Catweasel/

      Todos los derechos reservados sobre esta traducción al español
             All rights reserved over this spanish translation
===========================================================================

Este  gestor  está  basado  en  el  originalmente escrito para AmigaOS4 por
Kjetil  Hvalstrand,  basado  a  su  vez en el código fuente para Linux.  El
dispositivo  Catweasel, "catweasel.device", está completamente sujeto a las
condiciones GPL y el código fuente está disponible bajo petición.

  ¡Descargue la versión más reciente disponible para AmigaOS 4 y MorphOS!

                ¡Descargue la versión 1.02 del programa
      de preferencias para AmigaOS 4, que incluye las pruebas SID!

         ¡Descargue Vice 2.2 compilado para utilizar Catweasel!
                 (ejecute la instalación de Vice 2.2 y
          selecione la opción "Catweasel Mk3" en el menú SID)

                                   NOTA
                Este gestor está aún en fase de desarrollo.
 No soy responsable de nada de lo que le suceda utilizando este logicial.
           ¡Le estaría muy agradecido de que me informase de
       todos los éxitos y fracasos de este desarrollo o cualquier
        comentario general de peticiones sobre sus prestaciones!

                                 NOTA Nº 2
           Estos gestores no han sido escritos ni son soportados
         por Jens Schoenfeld, el creador de la tarjeta Catweasel.
        Sin embargo, quiero agradecerle que me haya suministrado
                   documentos técnicos de esta placa.

                                 NOTA Nº 3
              Si utiliza MorphOS, ¡no olvide que necesita que
                sus sistemas de ficheros estén instalados!
         Las versiones 68K de FastFileSystem, CrossDOSFileSystem,
                     fs1541, etc. deberían funcionar,
         ¡así que recuerde colocarlos en la unidad asignada "L:"!


          ¡¡AHORA CON SOPORTE DE DISCOS PROTEGIDOS CONTRA COPIA!!
          ¡Ejecute sus juegos originales de Amiga bajo AmigaOS4!
                ¡Más información en este mismo documento
           en su versión en inglés, en la sección histórica!

                                 [...]

Instrucciones para configurar su Catweasel
==========================================

En primer lugar, instale su tarjeta Catweasel Mk4 tal como indica su manual
de  instrucciones.   No  debe  conectar  la  tarjeta a la interfaz de disco
flexible de la placa madre, pues aún no está soportada.

Si piensa utilizar los circuitos integrados de sonido SID, ASEGÚRESE de que
los  pines  situados  al  lado  de  los zócalos de los integrados SID están
puenteados  como  corresponde  según el manual.  Si no va a utilizar ningún
circuito integrado SID, no se preocupe de dichos pines.

La  tarjeta  Catweasel  ahora  deberá  conectarla  a  su(s)  unidad(es)  de
disco(s).   Su tarjeta puede no tener conectada ninguna unidad o conectarse
a  ella  una o dos unidades.  Como con otras interfaces de disco, la unidad
nº  0 es la unidad conectada tras el cable con un segmento de éste volteado
(algunos  cables modernos sólo tienen dos conectores con un trozo volteado,
doblado  o retorcido en el medio; este conector es el de unidad nº 0):  Las
unidades  de  discos  flexibles de 3,5" están configuradas para actuar como
unidad nº 1, de manera que colocar la unidad tal como hemos comentado, tras
el segmento de cable volteado, hará que actúe como unidad nº 0.  Si conecta
una  unidad  de  5,25",  asegúrese de que está configurada como unidad nº 1
(algunas  unidades  no  tienen pines/contactos para esta función, de manera
que en este caso casi con total seguridad estará configurada como unidad nº
1).  Si conecta una unidad de 3", estará configurada irremediablemente como
unidad nº 0 o 1 y el cable no tendrá el volteo citado, así que la unidad nº
0 puede no estar disponible, pero la unidad nº 1 funcionará.

Una  vez  que  Catweasel  se ha instalado correctamente, ponga en marcha su
ordenador.   Cuando  el escritorio aparezca [1], descomprima el archivo [2]
en  la  unidad  de  disco  RAM y arrastre los contenidos [3] del directorio
"Catweasel"  a  su  unidad  de  arranque  [4]  (en  él  encontrará  algunos
directorios como "DEVS" y "Utilities").

Instalados  los  ficheros, diríjase a su directorio "Prefs" en la unidad de
arranque y ejecute el programa llamado "Catweasel".  Le permitirá decirle a
su tarjeta qué tipo de dispositivos le ha conectado.  Es importante que los
defina  correctamente;  habitualmente  se  definirán  como  unidad  de alta
densidad  de  3,5"  o  de  alta  densidad  de  5,25"  al  ser los tipos más
habituales  y  el estándar en máquinas IBM compatibles durante muchos años.
Para la mayoría de los casos, no necesitará cambiar el valor por defecto de
la  función  del  pin  nº  34.   Aquí  también podrá definir qué zócalos ha
ocupado con circuitos integrados SID.

                          Grupo "Disk Interface"
                          ----------------------

Los  botones  cíclicos "Disk 0" y "Disk 1" le permitirán informar al gestor
qué tipo de unidad de discos tiene conectada.

La  barra deslizante o corredera "Step time (mS)" permite ajustar el tiempo
que tarda el motor paso a paso en mover el cabezal una pista.  Si se define
demasiado  bajo,  las  operaciones de disco no serán fiables.  Si se define
demasiado alto, el rendimiento será más bajo de lo necesario.  El valor por
defecto  habitual  es de 6 milisegundos que es el estándar en la mayoría de
las  unidades.   Algunas  unidades Amstrad de 3", requieren, sin embargo un
tiempo  más  largo.   Los valores definidos por defecto funcionarán para la
mayoría de los casos.

Los   botones   cíclicos   "Pin  34"  con  su  valor  por  defecto  estarán
habitualmente  bien  definidos.  Si su unidad se comporta incorrectamente y
cree  que  los  discos  han sido cambidos sin razón, puede probar a cambiar
este    ajuste.    Información   técnica:    algunas   unidades   antiguas,
especialmente  las  unidades de 3" Amstrad y las unidades de 40 pistas para
IBM  compatibles,  utilizan  el  pin  nº 34 como señal "READY" (o RDY), que
indica a la controladora que están listas para escribir datos (la señal del
pin  era  el  equivalente  lógico  a  un 0, lo que implicaba que el cabezal
estaba  en  su posición correcta y el motor rotaba a una velocidad superior
al  85%  de su velocidad máxima).  Otras unidades utilizan este pin para la
señal  "DISK  CHANGE"  (o  DSKCHG)  que  con  una  señal lógica equivalente
indicaban  que  el  disco  se  había cambiado desde el último acceso.  Esta
señal  es actualizada cuando la unidad solicita realizar una operación como
el movimiento de un paso del cabezal...  y por eso las unidades de Amiga, y
por  extensión,  el  gestor de la Catweasel, genera ese ruido en la unidad:
moviendo el cabezal, se actualiza la señal de cambio de disco y se notifica
al  controlador  si un disco ha sido insertado o extraído.  Tenga en cuenta
que  cuando  las  unidades utilizan el pin nº 34 como señal RDY, el sistema
operativo no podrá determinar cuando se realiza el cambio de disco; en este
caso,  cuando  utilice  una  unidad montada, tendrá que ejecutar el comando
"diskchange", por ejemplo desde una ventana Shell como a continuación...

 1.RAM Disk:> diskchange OS0:

                           Grupo "SID Interface"
                           ---------------------

Los botones cíclicos SID le permitirán informar al gestor de qué zócalo SID
está  ocupado.   De  esta forma, cuando abra la unidad nº 0 del dispositivo
"catweaselsid.device"  siempre dispondrá de un circuito integrado SID si ha
instalado  al menos uno, independientemente del zócalo elegido.  Si dispone
de ambos, se podrá generar sonido estéreo cuando la aplicación lo soporte.

Ficheros incluidos
==================

* Utilities/SuperDiskImage,
  el creador de imágenes con entorno gráfico
* Storage/DOSDrivers,
  incluye los ficheros de montaje para el AmigaDOS
* Prefs/Catweasel,
  el programa de preferencias para configurar la tarjeta
* Devs/catweaselsid.device y Devs/catweasel.device,
  los controladores de los dispositivos

                          Montando un dispositivo
                          -----------------------

Los  dispositivos  bajo  AmigaOS y sistemas compatibles se montan pinchando
con  rapidez  doblemente  sobre  el  icono  correspondiente en la ubicación
"SYS:Storage/DOSDrivers"  o con el comando "mount" desde una ventana Shell.
Los nombres de los dispositivos acaban en cero ("0") para las unidades nº 0
(lo  habitual  para  las  unidades  conectadas  tras  la  sección del cable
volteado)  o en uno ("1") para las unidades nº 1 (como las conectadas antes
de  la  sección  comentada del cable volteado).  Los siguientes ficheros de
montaje se incluyen en el paquete:

 Nombre del dispositivo  Formato
 ¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨  ¨¨¨¨¨¨¨
 TD0:                    Doble densidad - Amiga            880 Ko
 TH0:                    Alta densidad  - Amiga          1.76  Mo
 PD0:                    Doble densidad - MS-DOS           720 Ko
 PH0:                    Alta densidad  - MS-DOS         1.44  Mo
 OD0:                    Doble densidad - MS-DOS (5.25")   360 Ko
 OH0:                    Alta densidad  - MS-DOS (5.25") 1.2   Mo
 OS0:                    Doble densidad - MS-DOS (5.25")   320 Ko
 CBM0:                   CBM 1541 (C64, VIC-20, etc.)
                         (soporte de escritura parcial,
                         requiere el archivo "cbm1541_fs.lha").
 SAM0:                   MGT Sam Coupe
                         (actuamente sólo soporta la lectura,
                         requiere el archivo "samdos_fs.lha").

                        Desmontando un dispositivo
                        --------------------------

Los  dispositivos  pueden ser desmontados desde una ventana Shell tecleando
(por ejemplo):

 1.RAM Disk:> dismount SAM0:

¡Percatese  de  que para  ser posible, el sistema de ficheros debe permitir
dicho desmontaje y muchos no lo soportan!  Si el AmigaDOS devuelve un error
diciendo "Invalid Packet Request" (o sea, petición de paquete inválido), el
sistema de ficheros no soporta el desmontaje.

Ejecutando  "Assign  SAM0:  dismount" se desmontará la unidad extrayendo su
nombre  de  la  lista  de dispositivos disponibles para el sistema, pero NO
cerrará   el   dispositivo,  de  manera  que  continuará  oyendo  el  ruido
característico de las unidades de disco.

                   La tarea de apoyo "catweasel.device"
                   ------------------------------------

Cuando  se  abre  el  dispositivo  se  pondrá en marcha una tarea de nombre
similar  que  controlará  los  cambios  de  disco.   Cada dos segundos, las
unidades buscarán (o "gruñirán") para comprobar si hay un nuevo disco en la
unidad.   Si  se  inserta  un disco, la unidad abandorá dicha comprobación.
Cuando se cierre el dispositivo, la tarea de apoyo finalizará.

        Leyendo y escribiendo imágenes de disco con SuperDiskImage
        ----------------------------------------------------------

SuperDiskImage es un programa con interfaz gráfica para manejar imágenes de
disco, con el cual podrá leerlas o escribirlas en diferentes formatos.

Para crear una imagen de disco (disco real > fichero):

  * Teclee  el nombre del fichero (que contendrá la imagen del disco) en
    el campo de texto "Image:" (Imagen)

  * Elija  el  nº  de  unidad  de  discos a utilizar en el botón cíclico
    correspondiente (0 ó 1)

  * Elija el formato a utilizar con el botón cíclico "Catweasel format:"
    (Formato Catweasel).

  * Defina  las  pistas y caras a leer cuando sea necesario (normalmente
    no lo es) utilizando las botones deslizantes "Start" (Inicio), "End"
    (Final) y el botón cíclico "Side" (Cara).

  * Presione el botón "Read Disk" (Leer el disco).

Si  el formato del disco es correcto, los bloques se pondrán de color verde
en  cuanto  hayan sido leídos correctamente desde el disco.  Una vez que el
disco   haya   sido  leído,  el  fichero  será  guardado  en  la  ubicación
especificada.  Tenga en cuenta que si ha especificado leer sólo una sección
del  disco,  el  fichero  con  la  imagen  será  actualizado  en  lugar  de
reemplazado.   Si  un  bloque  no  puede ser leído, porque el disco no está
presente, está estropeado/defectuoso o protegido contra copia, el bloque se
mostrará  en  color rojo (en gris aparecerán los bloques que no se utilizan
para  el formato actual).

Para recrear un disco a partir de una imagen (fichero > disco real):

  * Teclee  el nombre del fichero (que contendrá la imagen del disco) en
    el  campo de texto "Image:" (Imagen) o utilice el botón situado a su
    derecha para seleccionarlo utilizando una petición de ficheros.

  * Elija  el  nº  de  unidad  de  discos a utilizar en el botón cíclico
    correspondiente (0 ó 1)

  * Elija el formato a utilizar con el botón cíclico "Catweasel format:"
    (Formato Catweasel).

  * Defina  las  pistas y caras a leer cuando sea necesario (normalmente
    no lo es) utilizando las botones deslizantes "Start" (Inicio), "End"
    (Final) y el botón cíclico "Side" (Cara).

  * Presione el botón "Write Disk" (Escribir en el disco).

Así,  el  programa utilizará los datos del fichero-imagen para grabarlos en
el disco (o la parte seleccionada de éste).  Mientras se escribe un bloque,
éste  aparecerá  en color naranja.  SuperDiskImage verificará que el bloque
se  ha  grabado  correctamente  tras  cada  escritura:   Si la verificación
fracasa,  el  bloque  adquirirá  el  color  rojo y SuperDiskImage volverá a
intentarlo;  si  tras  el tercer intento el bloque sigue sin ser válido, se
abortará  la escritura del disco.  Si desea saltarse un bloque problemático
defina como bloque inicial el siguiente, pero tenga en cuenta que ¡su disco
no  contendrá  todos  los  datos!   Una  vez  que  el  bloque  es grabado y
verificado, el bloque cambiará a un color verde y SuperDiskImage continuará
con el siguiente bloque.


      El botón "Show Disk Parameters" (Mostrar parámetros del disco)
      --------------------------------------------------------------

Presione  este  botón  para  ver  los  parámetros del disco para el formato
actualmente  seleccionado  como puede ser el tamaño del bloque y su número,
las caras, etc.


          El botón cíclico "Catweasel format" (Formato Catweasel)
          -------------------------------------------------------

Los  formatos  soportados  están disponibles a través de este botón cíclico
para  la  unidad seleccionado.  Si el formato que quiere leer o escribir no
está  en la lista, asegúrese de que ha seleccionado la unidad correcta.  Si
el  formato continúa sin aparecer, compruebe las preferencias de su tarjeta
Catwesel (SYS:Prefs/Catweasel).

Los formatos (actualmente) disponibles son:

 ID  Unidad de discos necesaria
     Formato - Espacio tras el formato
 ¨¨  ¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨

  0  Cualquiera de doble cara y 80 pistas de 3.5" o 5.25"
     Amiga de doble densidad - 880 Ko

  1  Alta densidad de 3.5"
     Amiga de alta densidad - 1,76 Mo

  2  Cualquiera de doble cara de 3.5"
     MS-DOS de doble densidad - 720 Ko

  3  Alta densidad de 3.5"
     MS-DOS de alta densidad - 1.44 Mo

  9  Cualquiera de 3.5" de doble cara
     Apple Macintosh de doble cara, velocidad variable - 800 Ko

 10  Cualquiera de 3.5"
     Apple Macintosh de doble cara, velocidad variable - 400 Ko

 15  Cualquiera de doble cara de 5,25"
     MS-DOS de 40 pistas, doble cara, doble densidad, 8 sectores - 320 Ko

 16  Cualquiera de 5.25"
     Commodore 1541 (PET/C64/VIC-20/+4 ...) 35 pistas - 190 Ko

 17  Alta densidad de 5.25"
     MS-DOS de 80 pistas, doble cara, doble densidad - 1.2 Mo

 18  Cualquiera de doble cara de 5.25"
     MS-DOS de 40 pistas, doble cara, doble densidad, 9 sectores - 360 Ko

 19  Cualquiera de doble cara de 5.25" y 80 pistas
     Amiga doble densidad - 880 Ko

 28  Cualquiera de 80 pistas y doble cara de 3.5"
     MGT Sam Coupé - 800 Ko

 29  Cualquiera de 5.25"
     Texas Instruments TI-99/4(a) - 90 Ko

 30  Cualquiera de 5.25"
     Atari 810, simple cara, simple densidad - 90 Ko

 31  Cualquiera de 5.25"
     Acorn BBC Micro de 40 pistas, simple cara, simple densidad - 100 Ko

 36  Cualquiera de 5.25" y 80 pistas
     Acorn BBC Micro de 80 pistas, simple cara, simple densidad - 200 Ko

 37  Cualquiera de 3.5"
     Acorn BBC Micro de 40 pistas, simple cara, simple densidad - 100 Ko

 38  Cualquiera de 3.5"
     Acorn BBC Micro de 80 pistas, simple cara, simple densidad - 200 Ko

 39  Cualquiera de 3.5"
     Sinclair Spectrum MGT +D - 800 Ko

 40  Cualquiera de 3.0"
     Amstrad CPC / Sinclair Spectrum + 3 - 180 Ko

 41  Cualquiera de 3.0"
     Tatung Einstein TC-01/TC-256 - 200 Ko

 42  Cualquiera de 3.0"
     Amstrad PCW 8256/8512 - 180 Ko

 43  Cualquiera de doble cara de 3.5"
     Atari ST, doble cara, doble densidad - 720 Ko

 44  Cualquiera de 3.5"
     Atari ST, simple cara, doble densidad - 360 Ko

 45  Cualquiera de 5.25"
     Triumph-Adler Alphatronic PC - 360 Ko

 46  Cualquiera de simple cara de 3.5"
     MS-DOS de doble densidad y 8 sectores - 640 Ko

Preparando el AmigaOS 4 para trabajar con discos protegidos
===========================================================

Utilizando  WHDLoad,  ¡ahora  puede también instalar discos protegidos!  La
mayoría  de  los  programas  del  paquete  WHDLoad  asumen  que  usted está
utilizando  el dispositivo clásico "trackdisk.device", pero ese dispositivo
NO  existe  a  día de hoy bajo AmigaOS 4 (¡al menos hasta ahora!  ;).  Para
solventar este "problemilla":

  * Cargue con un editor el fichero "DEVS:NSDPatch.cfg".

  * Añada  las  siguientes  líneas (ajustadas para <tipodemáquina>; eche
    una ojeada a otras líneas de dicho fichero para las palabras clave):

    DEVICE trackdisk.device UNIT 0 MAPTODEVICE catweasel.device MAPTOUNIT 0 MACHINE=<tipodemáquina>
    DEVICE trackdisk.device UNIT 1 MAPTODEVICE catweasel.device MAPTOUNIT 1 MACHINE=<tipodemáquina>

  * Instale  el  programa  NSDPatch  si no lo ha hecho ya (probablemente
    baste  con copiar "NSDPatch" en la unidad asignada "C:" y ejecutarlo
    directamente   desde   el   fichero   "S:Startup-Sequence"  tras  la
    instrucción "SetPatch").

  * Copie el fichero
    "SYS:Storage/DOSDrivers/TD0"
    como
    "SYS:Storage/DOSDrivers/DF0",
    o en "DEVS:DOSDrivers/DF0" si se siente afortunado.

  * Reinicie el equipo.

¡Su  sistema  ahora  estará listo para leer discos protegidos contra copia!
Como  efecto  colateral  todos  los  comandos para manejo de los discos por
pistas  ahora  serán  enviados  a  la  tarjeta  Catweasel  en  lugar  de al
dispositivo  "trackdisk.device"  original.   Esto podría generar problemas,
así  que si necesita detener esta redirección de llamadas, basta que vuelva
a  editar  el  fichero  y  convierta las líneas anteriores en comentarios o
desactivando en el fichero "S:Startup-Sequence" la llamada a "NSDPatch".

Utilizando WHDLoad
==================

¡Ésta  es  la parte fácil!  Basta con que instale WHDLoad de la forma usual
(descárguelo  de  http://www.whdload.de/).   Ahora  descargue el instalador
concreto  del  juego que desea instalar y (asegúrese de que está montada la
unidad  "DF0:"  y)  ejecútelo  normalmente.   ¡Su  juego debería instalarse
exactamente  como  en  un  Amiga  real!   Si además lo combina con RunInUAE
(descargable  de  OS4Depot), ¡podrá ejecutar el juego directamente desde el
Workbench!

Utilizando el dispositivo "catweasel.device"
============================================

Para  mantener  la  compatibilidad  con  el  dispositivo "multidisk.device"
utilizado  con  tarjetas  Catweasel  anteriores en el Amiga, el dispositivo
soporta  los mismos comandos para discos por pistas y los mismos atributos.
Para  indicarle  a  la  Catweasel qué formato se utiliza, el dispositivo es
abierto con un identificador (ID) en el campo de atributos, tal como se vió
en la tabla anterior.

El  dispositivo "catweasel.device" utiliza un juego de comandos compatibles
con  el dispositivo "trackdisk.device", así que los programas escritos para
el  Amiga que utilizan limpiamente el dispositivo clásico deberán funcionar
también con "catweasel.device".

Utilizando el dispositivo "catweaselsid.device"
===============================================

Este  dispositivo  es  la  interfaz para acceder a los circuitos integrados
SID.   Para  poder  funcionar  se  exige  que  esté presente el dispositivo
"catweasel.device".   Abriendo  la  unidad  nº  0  siempre se accederá a un
circuito   SID,  independientemente  del  zócalo  en  que  esté  instalado.
Abriendo la unidad nº 1 se accederá al segundo circuito integrado SID.  Una
vez  que  el  circuito  integrado  SID  es  "abierto"  para  su  acceso, la
programación  de  éste  es  igual  que  el método utilizado en Windows para
escribir  datos,  o  sea,  una corriente de datos que consiste en registros
seguidos de su valor.  Así que escribir una corriente hexadecimal de:

00 01 09 13

definiría  el  registro  0x00  con  el valor 0x01 y el registro 0x09 con el
valor  0x13.  De esta forma, el SID puede ser programador de forma rápida y
fácil.   Leer  un SID se realiza de forma similar, pero el valor de retorno
es  colocado  en  la  parte  del  valor, por ejemplo, leyendo la cadena del
ejemplo  anterior,  se  colocaría  el  valor en el registro 0x00 donde está
"0x01".

[... Evolución histórica/noticias suprimidas...]


                                 ---===---

  1. En Amiga se conoce como "Workbench" X-D

  2. Descargable de la página del autor
     (la dirección en la cabecera de este documento).

  3. Las carpetas "DEVS", "Prefs", "Storage" y "Utilities".

  4. En Amiga conocida como unidad "SYS:"