$VER: mhimdev.library 1.3 (Mon 03-Oct-2011)



 #features
   mhimdev.library is a driver for the MHI system. It doesn't support any
   specific MPEG audio hardware decoder directly, instead it sends the data
   to an mpeg.device driver. It's an "interface converter" or "wrapper" that
   allows you to use your existing MPEG hardware and drivers in applications
   which support the new MHI interface only. (such as AmigaAMP)

   This program is free software, full source code included.



 #requirements
   -AmigaOS V37+
   -MPEG audio hardware decoder with mpeg.device support
    (eg. CD32 FMV, Delfina DSP, MAS Player, Melody and possibly some more)

   -developed on A1200 - OS3.1/68030+88240MHz/16MBFastRAM/Delfina1200DSP
   -tested with delfinampeg.device 1.2 and AmigaAMP 2.9-beta1
   -tested with AmigaAMP 2.24



 #changes since previous release
    -fixed a crash when playing songs in a row using a device which replies the
play
     command immediately (like delfinampeg.device and possibly others as well)



 #reason for version 1.2
   I used the mhi_mdev.library and noticed a problem with the MPEGCMD_PLAY.
   The library uses DoIO to send it to the device, which I think is not
   compatible with the Commodore standard, where the command instead will
   be aborted later.
   I asked Michael to change this. But he can't do this any more. As source
   is available, I did it.
   Now, the MPEGCMD_PLAY is issued with SendIO and later aborted. This should
   not cause any problems with mpeg devices that already worked with the
   mhi_mdev.library. But now also the devices that wait for the MPEGCMD_PLAY
   to be aborted (if there are any), which is I think so according to the
   Commodore documentation, will also work.



 #how to use
   1) install library
        > makedir LIBS:MHI
        > copy mhimdev.library LIBS:MHI/

   2) configure library
      two parameters must be set in the environment variable MHIMDEV
        -name of your specific mpeg.device
        -unit number (usually 0, but may be different for your hardware)
      example from my system:
        > setenv MHIMDEV delfinampeg.device 0
        > copy ENV:MHIMDEV ENVARC:

   3) configure application(s)
      at the moment only AmigaAMP uses the new MHI interface.
        -start AmigaAMP prefs program
        -go to System page
        -select engine: MHI-Driver
        -select driver: LIBS:MHI/mhimdev.library

   4) have fun. ;-)



 #known problems
   -MHI defines a few extensions that are NOT SUPPORTED by the mpeg.device
    standard so they are simply ignored. Currently they are:
      -tone control (bass/mid/treble)
      -crossmixing control (stereo channel separation)

   -mhimdev.library was written according to the mpeg.device specification so
    it should work with all MPEG decoders which support this interface.
    Due to lack of other hardware decoders I can test it only with my Delfina
    using delfinampeg.device. I would like to know what other mpeg.devices are
    used with this MHI driver. (please report successful usage, too)



 #acknowledgements
   -idea and source by Michael Henke
   mhimdev.library uses ideas/code from:
   -MHI developers package by Paul Qureshi and Thomas Wenzel
   -Melody developers package by Thorsten Hansen
   -CLib-SDI example.library by Dirk Stoecker, Andreas R. Kleinert and others



 #author
   version 1.2 up to current:
   
   Andreas Barth (andreas_barthgmx.net)



   up to version 1.1:

   mailto: smack42web.de  or  smacksmack.de

   mhimdev.library - MHI driver for mpeg.device
   Copyright (C) 2001  Michael Henke

   This program is free software; you can redistribute it and/or modify
   it under the terms of the GNU General Public License as published by
   the Free Software Foundation; either version 2 of the License, or
   (at your option) any later version.

   This program is distributed in the hope that it will be useful,
   but WITHOUT ANY WARRANTY; without even the implied warranty of
   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
   GNU General Public License for more details.

   You should have received a copy of the GNU General Public License
   along with this program; if not, write to the Free Software
   Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA

 PERMSSN    UID  GID    PACKED    SIZE  RATIO METHOD CRC     STAMP          NAME
---------- ----------- ------- ------- ------ ---------- ------------ -------------
[generic]                 2138    4563  46.9% -lh5- e941 Oct  3  1980 mhimdev/.svn/text-base/README.svn-base
[generic]                  332     520  63.8% -lh5- 644a Oct  3  1980 mhimdev/CHANGES
[generic]                 7000   18113  38.6% -lh5- 9ad4 Oct  3  1980 mhimdev/COPYING
[generic]                 1732    2560  67.7% -lh5- 686c Oct  3  1980 mhimdev/mhimdev.library
[generic]                 2138    4563  46.9% -lh5- e941 Oct  3  1980 mhimdev/README
[generic]                  337     801  42.1% -lh5- 9228 Oct  3  1980 mhimdev/source/.svn/entries
[generic]                 1539    4301  35.8% -lh5- 77dd Oct  3  1980 mhimdev/source/.svn/text-base/library.c.svn-base
[generic]                 3390   13098  25.9% -lh5- 1d29 Oct  3  1980 mhimdev/source/.svn/text-base/mhimdev.c.svn-base
[generic]                 1056    2832  37.3% -lh5- 9708 Oct  3  1980 mhimdev/source/.svn/text-base/mhimdev.h.svn-base
[generic]                  169     448  37.7% -lh5- 41b5 Oct  3  1980 mhimdev/source/.svn/text-base/RegVar.h.svn-base
[generic]                 1539    4301  35.8% -lh5- 77dd Oct  3  1980 mhimdev/source/library.c
[generic]                 3390   13098  25.9% -lh5- 1d29 Oct  3  1980 mhimdev/source/mhimdev.c
[generic]                 1056    2832  37.3% -lh5- 9708 Oct  3  1980 mhimdev/source/mhimdev.h
[generic]                  169     448  37.7% -lh5- 41b5 Oct  3  1980 mhimdev/source/RegVar.h
[generic]                  312     671  46.5% -lh5- 724e Oct  3  1980 mhimdev/.svn/entries
[generic]                  332     520  63.8% -lh5- 644a Oct  3  1980 mhimdev/.svn/text-base/CHANGES.svn-base
[generic]                 7000   18113  38.6% -lh5- 9ad4 Oct  3  1980 mhimdev/.svn/text-base/COPYING.svn-base
[generic]                  152     238  63.9% -lh5- 5441 Oct  3  1980 mhimdev/project/.svn/entries
[generic]                  215     398  54.0% -lh5- 819d Oct  3  1980 mhimdev/project/StormC4/.svn/entries
[generic]                  681    2058  33.1% -lh5- 7e32 Oct  3  1980 mhimdev/project/StormC4/.svn/text-base/mhimdev_library.¶.svn-base
[generic]                  681    2058  33.1% -lh5- 7e32 Oct  3  1980 mhimdev/project/StormC4/mhimdev_library.¶
[generic]                  154     239  64.4% -lh5- 040d Oct  3  1980 mhimdev/project/StormC4/output/.svn/entries
---------- ----------- ------- ------- ------ ---------- ------------ -------------
 Total        22 files   35512   96773  36.7%            Oct  3 20:05