AminetAminet
Search:
83548 packages online
About
Recent
Browse
Search
Upload
Setup
Services

driver/other/dsp3210.lha

Mirror:Random
Showing:m68k-amigaosgeneric
No screenshot available
Short:DSP 3210 drivers and tools
Author:Thomas Winischhofer
Uploader:thomas winischhofer net (Thomas Winischhofer)
Type:driver/other
Version:4.05
Architecture:m68k-amigaos
Date:2021-07-21
Download:http://aminet.net/driver/other/dsp3210.lha - View contents
Readme:http://aminet.net/driver/other/dsp3210.readme
Downloads:1221

DSP 3210 drivers & tools

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

Samples and Demos **********************************

dsp3210devtest: A tool for comprehensively testing the DSP drivers
(dsp3210.device and dsp3210.resource) and the hardware as regards
CPU vs DSP memory access. It executes DSP programs that hammer host
memory in all directions and of all kinds (ChipRAM and FastRAM). If
this shows errors (other than IO errors), there is a hardware problem
at hand, most likely GAL timing issues. To make sure, the timing of
the GALs is correct, let this run for at least 1000 passes. It
should exit with zero errors.
This tool has two important limitations:
1) The FastRAM tests are performed with FastRAM of the highest
priority. If you have an accelerator board with local RAM, it will
usually use that - timing errors with motherboard or Zorro RAM might
therefore not be detected.
2) What this tool is incapable to uncover are potential issues with
the onboard SCSI controller in connection with the DSP.
Please see docs/STATUS.doc for more information.

examples/dsp3210mandel: A Mandelbrot application using the DSP via
dsp3210.device and dsp3210.library. This is an adaption of Wrangler's
"mandel_dsp", with all hardware hacks removed and replaced by driver
functions. Comes in three versions that differ in how the DSP tells
the CPU it's finished. Meant as demos for the different methods the
drivers support and offer.
Based on dsp3210run (used as DSP-handling skeleton), Mandel by Erik
Trulsson, ARTABROT by George T Warner.

examples/dsp3210run: Runs a given DSP program. Is a sample and skeleton
for new applications at the same time. It fully utilizes the drivers in
this package. A suitable demo DSP program is DSP/testprogram.

examples/dsp3210libtest and examples/dsp3210clibtest:
Show usage of dsp3210.library, by loading and relocating the DSP
programs in examples/DSP.

makeobjectfile: This utility 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.

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

This library helps applications to use the DSP by handling binaries created
by the d32 tools (eg d32as and d32cc).

It currently supports
- calculating the required memory for the relocated binary
- relocating a DSP binary to a target memory address
- loading and relocating a DSP binary in one single step (DSPLoadMod())
- resolving local and global symbols accross several DSP binaries
- additional application-provided global symbols
- searching for global symbols
- converting a binary with little-endian file structures to big-endian

Please see the code samples for more information, first and foremost
dsp3210run.

Source and developer files included.

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

Low level drivers for the DSP.

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. It creates the dsp3210.resource.

2) dsp3210.device

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

Please see the included documentation and examples for more information
on how to use this.


All files in this archive are written in 1987 or 2020/2021 by Thomas
Winischhofer, except as noted.

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

Changelog:

4.05: (=210722 on github)
- dsp3210.device (40.25), dsp3210.resource (40.25)
  Fixed bug in device (message handling)
  Added SETSTARTADDR command
  etc. (see ChangeLog)

4.04: (=210715 on github)
- dsp3210.device is now a hybrid of device and library
- Added longwordcopy convenience DSP function, used in the same way as
  the triggerintx functions.
- Device and resource are now multi-DSP capable (in theory)
- dsp3210.library (4.0):
  Changed arguments to LoadMod()/LoadModChip()/UnloadMod() in order
  to support address translation and driver-private memory management

4.03
- skipped

4.02:  (=210705 on github)
- minor changes, no new functions
- documentation cleanup and update

4.01:  (=210702 on github)
- dsp3210.resource, dsp3210.library:
  Added CompatMode, in light of the recently discovered issues
  with the onboard SCSI controller in connection with
  accelerator boards with local RAM. The library and resource
  use exclusively ChipRAM for DSP code if in Compat-Mode.
  This mode is enabled by setting the global environment variable
  DSPCOMPAT (ie "setenv DSPCOMPAT 1").
- Added docs/STATUS.doc with detailed information on hardware
  and software status.

4.00: (=210627 on github)
- API cleanup (again) (hence the version jump)
- Added DSP ID
- Minor other changes
- Reminder: Needs updated U124.

3.00: (=210620 on github)
- Added PLD and JEDs for GALs needed on AA3000+
- Added dsp3210mandel (in various flavors)
- Fixed triggering of CPU interrupts in drivers and all sample programs
- New commands for dsp3210.device
- New data structures for dsp3210.device
- SwapEndian function for dsp3210.library
- Added README to examples
- Added lots of documentation

2.00: (=210609 on github)
- massive changes and additions, see ChangeLog
- add dsp3210run, a fully featured sample program to run DSP programs

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




Contents of driver/other/dsp3210.lha
PERMISSION  UID  GID    PACKED    SIZE  RATIO METHOD CRC     STAMP     NAME
---------- ----------- ------- ------- ------ ---------- ------------ ----------
[unknown]                 6005   14072  42.7% -lh5- e30f Jul 21 23:33 Changelog.txt
[unknown]                 1958    3284  59.6% -lh5- ff35 Jul 21 23:32 devs/dsp3210.device
[unknown]                 2178    3832  56.8% -lh5- e490 Jul 21 23:32 devs/dsp3210.resource
[unknown]                11442   58017  19.7% -lh5- 3b9c Jul 21 23:33 doc/dsp3210_device.doc
[unknown]                 5070   17213  29.5% -lh5- 9bed Jul 21 23:33 doc/dsp3210_library.doc
[unknown]                 3149    7931  39.7% -lh5- 344a Jul 21 23:33 doc/interrupts.doc
[unknown]                  646    1184  54.6% -lh5- 4860 Jul 21 23:33 doc/makeobjectfile.doc
[unknown]                 2134    6020  35.4% -lh5- a50d Jul 21 23:33 doc/Overview.doc
[unknown]                 3106    7389  42.0% -lh5- 3b13 Jul 21 23:33 doc/STATUS.doc
[unknown]                12472   23012  54.2% -lh5- 1c3f Jul 21 23:32 dsp3210devtest
[unknown]                  331     800  41.4% -lh5- 389c Jul 21 23:32 examples/DSP/build
[unknown]                  314     618  50.8% -lh5- 76c7 Jul 21 23:32 examples/DSP/example1
[unknown]                  412     766  53.8% -lh5- d95f Jul 21 23:32 examples/DSP/example1.s
[unknown]                  363     713  50.9% -lh5- 0d8a Jul 21 23:32 examples/DSP/example2
[unknown]                  274     555  49.4% -lh5- 4307 Jul 21 23:32 examples/DSP/example2.s
[unknown]                  354     674  52.5% -lh5- 091a Jul 21 23:32 examples/DSP/longwordcopy.s
[unknown]                 1141    4083  27.9% -lh5- 0325 Jul 21 23:32 examples/DSP/mandel
[unknown]                 1037    3642  28.5% -lh5- 8a5c Jul 21 23:32 examples/DSP/mandel-noint
[unknown]                 3317   11609  28.6% -lh5- b5fe Jul 21 23:32 examples/DSP/mandel-noint.s
[unknown]                 3573   12119  29.5% -lh5- c586 Jul 21 23:32 examples/DSP/mandel.s
[unknown]                  319     637  50.1% -lh5- 82e8 Jul 21 23:32 examples/DSP/testprogram
[unknown]                  714    2508  28.5% -lh5- 801c Jul 21 23:32 examples/DSP/testprogram.s
[unknown]                  765    2438  31.4% -lh5- 5bb1 Jul 21 23:32 examples/DSP/triggerhostint.s
[unknown]                 6195    9772  63.4% -lh5- c73e Jul 21 23:32 examples/dsp3210clibtest
[unknown]                 3022    8758  34.5% -lh5- ce63 Jul 21 23:32 examples/dsp3210clibtest.c
[unknown]                 1063    2180  48.8% -lh5- 40c6 Jul 21 23:32 examples/dsp3210libtest
[unknown]                 3636   11505  31.6% -lh5- 8735 Jul 21 23:32 examples/dsp3210libtest.a
[unknown]                12199   21008  58.1% -lh5- f4d4 Jul 21 23:33 examples/dsp3210mandel-flag
[unknown]                12063   20728  58.2% -lh5- da6d Jul 21 23:33 examples/dsp3210mandel-si
[unknown]                 9884   28488  34.7% -lh5- 8f53 Jul 21 23:33 examples/dsp3210mandel-si.c
[unknown]                12202   21008  58.1% -lh5- 9660 Jul 21 23:33 examples/dsp3210mandel-signal
[unknown]                10072   29402  34.3% -lh5- adee Jul 21 23:33 examples/dsp3210mandel.c
[unknown]                 7696   20980  36.7% -lh5- 79c5 Jul 21 23:32 examples/dsp3210run
[unknown]                 6302   18002  35.0% -lh5- 2d58 Jul 21 23:32 examples/dsp3210run.c
[unknown]                  820    1768  46.4% -lh5- 3138 Jul 21 23:32 examples/dsp3210swapendian
[unknown]                 2036    6610  30.8% -lh5- 8d00 Jul 21 23:32 examples/dsp3210swapendian.a
[unknown]                 1219    2903  42.0% -lh5- 08c9 Jul 21 23:33 examples/README
[unknown]                  195     469  41.6% -lh5- 2de7 Jul 21 23:32 fd/dsp3210_dev.fd
[unknown]                  215     464  46.3% -lh5- 490f Jul 21 23:32 fd/dsp3210_lib.fd
[unknown]                 1834    4632  39.6% -lh5- ee88 Feb  8 07:50 hardware/PLD/U122_ATF22V10.pld
[unknown]                 1830    4531  40.4% -lh5- 74a0 Jun 26 14:57 hardware/PLD/U123_ATF22V10.pld
[unknown]                 1311    4129  31.8% -lh5- fc84 Jun 19 12:01 hardware/PLD/U124_ATF22V10.pld
[unknown]                 1231    3000  41.0% -lh5- d2dd Nov 30  2020 hardware/PLD/U701_ATF16V8-R8.pld
[unknown]                 1256    3050  41.2% -lh5- 9852 Feb 23 11:41 hardware/PLD/U701_ATF16V8-R9.pld
[unknown]                  991    1729  57.3% -lh5- df0f Jul  9 10:00 hardware/README.txt
[unknown]                89942   89942 100.0% -lh0- 9f9d Jun 19 23:23 hardware/RW-R_W.jpg
[unknown]                  694    3026  22.9% -lh5- 095c Feb  8 07:50 hardware/U122_ATF22V10.jed
[unknown]                  542    2311  23.5% -lh5- 3471 Feb  8 07:53 hardware/U123_ATF22V10.jed
[unknown]                  687    2816  24.4% -lh5- b222 Jun 19 12:01 hardware/U124_ATF22V10.jed
[unknown]                  393    1289  30.5% -lh5- 0986 Nov 30  2020 hardware/U701_ATF16V8-R8.jed
[unknown]                  394    1289  30.6% -lh5- 0ce3 Feb 23 11:44 hardware/U701_ATF16V8-R9.jed
[unknown]                  395    1077  36.7% -lh5- b58b Jul 21 23:32 include/clib/dsp3210_dev_protos.h
[unknown]                  398     855  46.5% -lh5- a6af Jul 21 23:32 include/clib/dsp3210_protos.h
[unknown]                 1803    5221  34.5% -lh5- 66df Jul 21 23:32 include/devices/dsp3210.h
[unknown]                 1978    6312  31.3% -lh5- 6f6a Jul 21 23:32 include/devices/dsp3210.i
[unknown]                  471     969  48.6% -lh5- 07f4 Jul 21 23:32 include/libraries/dsp3210.h
[unknown]                  611    1357  45.0% -lh5- 5ac7 Jul 21 23:32 include/libraries/dsp3210.i
[unknown]                  149     550  27.1% -lh5- a0d7 Jul 21 23:32 include/pragmas/dsp3210_dev_pragmas.h
[unknown]                  162     496  32.7% -lh5- 0190 Jul 21 23:32 include/pragmas/dsp3210_pragmas.h
[unknown]                  144     214  67.3% -lh5- 1f43 Jul 21 23:32 include/proto/dsp3210.h
[unknown]                  153     237  64.6% -lh5- 8cc7 Jul 21 23:32 include/proto/dsp3210_dev.h
[unknown]                 7089   23776  29.8% -lh5- 01cf Jul 21 23:32 include/resources/dsp3210.h
[unknown]                 6956   22660  30.7% -lh5- 3cc7 Jul 21 23:32 include/resources/dsp3210.i
[unknown]                  286     654  43.7% -lh5- 5b53 Jul 21 23:33 install
[unknown]                  258     840  30.7% -lh5- 5d2f Jul 21 23:32 lib/dsp3210.lib
[unknown]                 2645    4340  60.9% -lh5- e7e4 Jul 21 23:32 libs/dsp3210.library
[unknown]                  753    1980  38.0% -lh5- a9ca Jul 21 23:33 makeobjectfile
[unknown]                 2684    6142  43.7% -lh5- 7955 Jul 21 23:33 readme
[unknown]                  532    1935  27.5% -lh5- b7cb Jul 21 23:32 src/dsp3210.lib.a
[unknown]                14528   53485  27.2% -lh5- 81f7 Jul 21 23:32 src/dsp3210.library.a
[unknown]                 9218   42481  21.7% -lh5- bb7c Jul 21 23:32 src/dsp3210devtest.c
[unknown]                 1990    7193  27.7% -lh5- 479c Jul 21 23:33 src/makeobjectfile.a
---------- ----------- ------- ------- ------ ---------- ------------ ----------
 Total        72 files  304201  691679  44.0%            Jul 21 23:31

Aminet © 1992-2021 Urban Müller and the Aminet team. Aminet contact address: <aminetaminet net>