DSP 3210 drivers & tools

This package contains several tools to use and operate
the DSP 3210 on AA3000/AA3000+ motherboards.

DSP 3210 Resource & Device ***************************

Based on concepts by Erik Lavitsky and others
Written by Thomas Winischhofer (A10001986) in 2020

The new replacements are fully compatible with the
original concepts as published. If those were
changed later (such as for Zorro DSP cards),
they might be incompatible. No warranty. My basis
were mainly the conference docs from 1993.

1) dsp3210.resource

The dsp3210.resource ("resource") is the base layer.

dsp3210.resource is an executable which is run from
CLI at startup, for example from user-startup.

This executable creates the dsp3210.resource.

If an onboard DSP is found (such as on the original
AA3000 or the new AA3000+), it creates a corresponding
DSPEntry and installs an interrupt server.

If no onboard DSP is found, the resource is created
empty, ready for third party drivers to add their
DSPEntry (including an optional interrupt handler
task).

The original concept of the onboard DSP had SuperDMAC
version 4 in mind. This version of SuperDMAC has
a register for reading various DSP control signals.

Since SuperDMAC 4 is not widely available (yes, I am
aware this is an understatement), the resource, by 
default, installs in SuperDMAC 2 mode. This means 
the resource does not use the control signals.

If dsp3210.resource is run on a machine with Super-
DMAC 4, the resource can be installed in SuperDMAC
4 mode by using the command line switch "SDMAC4".

The resource offers an infrastructure to let the DSP
trigger hardware interrupts 2 and/or 6. Please see
dsp3210devtest.c for an example on how to use this.

2) dsp3210.device

This is placed in devs: and is a middle layer between
the dsp3210.resource and the user application.

Please see dsp3210devtest.c for more information on
how to use this.

dsp3210.library *************************************

This library helps applications to use the DSP by
handling binaries created by d32as and d32cc. It
currently supports calculating the require memory
for the binary, and relocating it to its target
memory address.

Please see the code samples for more information.


Other stuff *****************************************

makeobjectfile: This creates an object file out of any
binary, and the main purpose here is to create object
files out of DSP binaries, ready to link to your own
application with blink, slink or and other Amiga
standard linker. You need specify a label name that
will resolve to the start of the file.

Example: makeobjectfile file.bin file.o label=mylabel

In your code you simply do

  xref mylabel

  lea.l mylabel,a0 ; a0 now points to the start of
  ....             ; the linked binary


All files in this archive are written in 2020 by
Thomas Winischhofer

Newer versions of this package might be found at
https://github.com/realA10001986/Amiga

Changelog:

1.02: (=210213 on github)
- dsp3210.resource: disable interrupts while
  writing to $dd0080 if started with r4 or r10
  parameters. 
  
1.01: (=210210 on github)
- dsp3210.resource: By default, write byte to 
  DSP control register only once. 
- Added read tests to dsp3210devtest
- Moved dsp3210.resource to devs:
  (Please delete c:dsp3210.resource after installing)

1.00
- Initial release

PERMISSION  UID  GID    PACKED    SIZE  RATIO METHOD CRC     STAMP     NAME
---------- ----------- ------- ------- ------ ---------- ------------ ----------
[unknown]                 2301    4986  46.1% -lh5- e1e4 Feb 13 16:45 Changelog.txt
[unknown]                 1520    2432  62.5% -lh5- ff03 Feb 13 16:45 devs/dsp3210.device
[unknown]                 1706    2768  61.6% -lh5- bd50 Feb 13 16:45 devs/dsp3210.resource
[unknown]                 9458   18084  52.3% -lh5- bb76 Feb 13 16:45 dsp3210devtest
[unknown]                  914    1944  47.0% -lh5- 2ff4 Feb 13 16:45 dsp3210libtest
[unknown]                  237     376  63.0% -lh5- a0e0 Feb 13 16:45 include/clib/dsp3210_protos.h
[unknown]                 1045    2854  36.6% -lh5- c898 Feb 13 16:45 include/devices/dsp.h
[unknown]                 1367    3782  36.1% -lh5- ad6e Feb 13 16:45 include/devices/dsp.i
[unknown]                  233     475  49.1% -lh5- 1672 Feb 13 16:45 include/libraries/dsp3210.h
[unknown]                  355     723  49.1% -lh5- 386f Feb 13 16:45 include/libraries/dsp3210.i
[unknown]                 2496    7195  34.7% -lh5- 694a Feb 13 16:45 include/resources/dsp.h
[unknown]                 2633    7771  33.9% -lh5- 09b5 Feb 13 16:45 include/resources/dsp.i
[unknown]                  202     472  42.8% -lh5- a486 Jan 31 08:52 install
[unknown]                  136     232  58.6% -lh5- 87a2 Feb 13 16:45 lib/dsp3210.lib
[unknown]                  889    1180  75.3% -lh5- 7a67 Feb 13 16:45 libs/dsp3210.library
[unknown]                  644    1616  39.9% -lh5- 0fe6 Feb 13 16:45 makeobjectfile
[unknown]                 1570    3421  45.9% -lh5- 1900 Feb 13 16:45 readme
[unknown]                  278     627  44.3% -lh5- f1cf Feb 13 16:45 src/dsp3210.lib.a
[unknown]                 4124   13281  31.1% -lh5- ffae Feb 13 16:45 src/dsp3210.library.a
[unknown]                  683    1453  47.0% -lh5- 289e Feb 13 16:45 src/dsp3210clibtest.c
[unknown]                 7405   34877  21.2% -lh5- df32 Feb 13 16:45 src/dsp3210devtest.c
[unknown]                 2372    7584  31.3% -lh5- 7151 Feb 13 16:45 src/dsp3210libtest.a
[unknown]                 1655    5835  28.4% -lh5- 171d Feb 13 16:45 src/makeobjectfile.a
---------- ----------- ------- ------- ------ ---------- ------------ ----------
 Total        23 files   44223  123968  35.7%            Feb 16 21:45