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. Version 2 added DSPLoadSeg() and
DSPUnloadSeg() as one-stop functions for loading
and relocating DSP binaries.

Please see the code samples for more information.

Source and developer files included.


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 1987 or 2020 
by Thomas Winischhofer

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

Changelog:

1.03: (=210304 on github)
- numerous changes, additions and fixes for 
  dsp3210.library

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]                 2245    4893  45.9% -lh5- eb50 Mar  4 15:17 Changelog.txt
[unknown]                 1537    2440  63.0% -lh5- 3f40 Mar  4 15:17 devs/dsp3210.device
[unknown]                 1706    2768  61.6% -lh5- bd50 Mar  4 15:17 devs/dsp3210.resource
[unknown]                 9538   18316  52.1% -lh5- 0fdb Mar  4 15:17 dsp3210devtest
[unknown]                  966    2028  47.6% -lh5- c1b5 Mar  4 15:17 dsp3210libtest
[unknown]                  276     463  59.6% -lh5- 49c4 Mar  4 15:17 include/clib/dsp3210_protos.h
[unknown]                 1024    2800  36.6% -lh5- 0087 Mar  4 15:17 include/devices/dsp.h
[unknown]                 1367    3782  36.1% -lh5- ad6e Mar  4 15:17 include/devices/dsp.i
[unknown]                  231     475  48.6% -lh5- 45f6 Mar  4 15:17 include/libraries/dsp3210.h
[unknown]                  486    1028  47.3% -lh5- 4b61 Mar  4 15:17 include/libraries/dsp3210.i
[unknown]                 2564    7360  34.8% -lh5- 7182 Mar  4 15:17 include/resources/dsp.h
[unknown]                 2710    7955  34.1% -lh5- 6d58 Mar  4 15:17 include/resources/dsp.i
[unknown]                  202     472  42.8% -lh5- a486 Jan 31 08:52 install
[unknown]                  179     452  39.6% -lh5- 4810 Mar  4 15:17 lib/dsp3210.lib
[unknown]                 1175    1652  71.1% -lh5- bcae Mar  4 15:17 libs/dsp3210.library
[unknown]                  644    1616  39.9% -lh5- 0fe6 Mar  4 15:17 makeobjectfile
[unknown]                 1629    3557  45.8% -lh5- 11e4 Mar  4 15:17 readme
[unknown]                  386    1084  35.6% -lh5- 5cce Mar  4 15:17 src/dsp3210.lib.a
[unknown]                 5709   18880  30.2% -lh5- 717c Mar  4 15:17 src/dsp3210.library.a
[unknown]                 1628    3654  44.6% -lh5- 3ee5 Mar  4 15:17 src/dsp3210clibtest.c
[unknown]                 8099   36596  22.1% -lh5- c6ac Mar  4 15:17 src/dsp3210devtest.c
[unknown]                 2962    9132  32.4% -lh5- d8d8 Mar  4 15:17 src/dsp3210libtest.a
[unknown]                 1655    5835  28.4% -lh5- 171d Mar  4 15:17 src/makeobjectfile.a
---------- ----------- ------- ------- ------ ---------- ------------ ----------
 Total        23 files   48918  137238  35.6%            Mar  5 05:46