VRmagic USB Camera Development Kit, International Edition
=========================================================

Contact Address:
  VRmagic GmbH  
  Augustaanlage 32  
  68165 Mannheim  
  Phone +49 (0) 621 - 400416 20
  Fax +49 (0) 621 - 400416 99
  E-mail: service.imaging@vrmagic.com
  Web: http://www.vrmagic-imaging.com

1. Description:

        This package includes:
        1. VRmagic VRmUsbCam API v2
        2. Demo applications for VrmUsbCam API
        3. VRmagic CamServer (Ethernet Transmission)
       
2. Release Date:

        08/11/2010

3. Revision Numbers:

        VRmagic USB Camera Development Kit 3.13e includes:
        1. VRmagic VRmUsbCam C API: 2.7.2.5
        2. VRmagic CamServer: 2.7.2.5

4. Hardware and Firmware Requirements:

        VRmDC-8, VRmDC-9/BW and VRmDC-12(/BW) with the following firmware revisions:
        1. U-Boot Bootloader: 2009.06-VRmDR[1|2]-1.11
        2. Linux Kernel: 2.6.27-davinci-VRm-1.10 or -1.11
        3. Root Filesystem: 1.15

5. Supported Operating Systems:
        
        Host:
        - Microsoft Windows 2000/XP/VISTA
        - any Linux with kernel 2.6.xx
      
        Device:
        - Debian 5.0 root filesystem with adapted Davinci Linux kernel 2.6.27

6. Development Platforms:
        
        Microsoft Visual Studio 2005 or later        
        gcc 4.2.3 ARM Toolchain
        TI Code Generation Tools 6.1.13 or later 
        TI Codec Engine 2.25.01
        TI XDC Tools 3.16.02
        TI DSP/BIOS 5.41.03
        
7. Directory Layout & Contents:

        demos -> examples which show the API usage
        docs -> Documentation of the VRmagic camera API v2
        include -> VRmagic API include files
        lib -> VRmagic API development library 
        toolchains -> Manuals and software regarding ARM and DSP Cross-Compilers 
        
8. Installation:

        Install the ARM and DSP toolchains as described in the toolchains directory
        to be able to compile the demos. Though all demos can be compiled by using nmake
        or gmake, it is recommended to use MS Visual Studio 2005 (Express) to work with 
        them.
        
9. Update of an older Development Kit:
        
        Remove your old toolchains and get the new ones as described in the toolchains 
        directory. Do not try to use the new demos with the old toolchains or vice versa.
        
        Be aware, that to make your new programs work on the camera, you have to install
        the new camera firmware from the davinci/firmware folder on the CD. See there for
        further instructions how to do so.
        
10. Known Limitations:

        All current formats of the intelligent camera are using a Davinci 
        built-in A-Law table to convert from 10 bit to 8 bit pixels. Since the 
        table is not linear, the VRmagic software applies a LUT which partially
        compensates its effects. But this is not loss-less. This is a hardware
        related issue and will be fixed in future revisions.

11. History:

        Version 3.13e (08/11/2010)      fixed multithreading issue in "UnlockNextImage"

        Version 3.13d (08/09/2010)      added support for gray 16bit and BGR 48bit target formats

        Version 3.13c (06/02/2010)      added support for zeroconfig IP addresses

        Version 3.13b (05/07/2010)      fixed sync-freerunning mode of VRmDC-12
                                        fixed issues in Video input driver of VRmDC-x

        Version 3.13a (04/16/2010)      fixed DSP demos
                                        fixed minor documentation issues

        Version 3.13 (04/14/2010)       added support for VRmDC-8, VRmDC-9/BW, VRmDC-12
                                        added support for ethernet receiving to all APIs
                                        added CamServer application for ethernet transmission