DC210 SDK for Unix v1.2.2 User's Guide

Introduction

The audience of this documentationa and library is developers that wish to write applications for the Kodak DC range of cameras on the Unix Operating System.

This library is compatible with and provides the equivalent functionality of the Kodak Digital Camera DC210 Software Developer's Kit.

Other Notes

Installation
FAQ
Operating System Specifics

Changes

1.2.2

Corrected Exposure Time value
Corrected FNumber value

Added FreeBSD distribution, port configuration is

Command   Logical Port                   Physical Port
   Line                               Linux          Solaris        FreeBSD

     0          Auto (Port 1)  /dev/cua0   /dev/cua/a    /dev/cuaa0
     1          Port 1            /dev/cua0   /dev/cua/a    /dev/cuaa0
     2          Port 2            /dev/cua1   /dev/cua/b    /dev/cuaa1
     3          Port 3            /dev/cua2   /dev/cua/c    /dev/cuaa2
     4          Port 4            /dev/cua3   /dev/cua/d    /dev/cuaa3
     5          Port 5            /dev/ttyS0  /dev/term/a    /dev/ttyd0
     6          Port 6            /dev/ttyS1  /dev/term/b    /dev/ttyd1
     7          Port 7            /dev/ttyS2  /dev/term/c    /dev/ttyd2
     8          Port 8            /dev/ttyS3  /dev/term/d    /dev/ttyd3

1.1

Added origin and contact details to example source code
Added documentation to distribution

Added ports /dev/ttyS[0-3] to linux distribution

        Command   Logical Port         Physical Port
           Line                               Linux        Solaris

             0          Auto (Port 1)  /dev/cua0   /dev/cua/a
             1          Port 1            /dev/cua0   /dev/cua/a
             2          Port 2            /dev/cua1   /dev/cua/b
             3          Port 3            /dev/cua2   /dev/cua/c
             4          Port 4            /dev/cua3   /dev/cua/d
             5          Port 5            /dev/ttyS0  /dev/term/a
             6          Port 6            /dev/ttyS1  /dev/term/b
             7          Port 7            /dev/ttyS2  /dev/term/c
             8          Port 8            /dev/ttyS3  /dev/term/d

1.0 Beta 4

Corrected bug (introduced in Beta 3) in baud rate probe code which disabled operation with the DC200 camera.

1.0 Beta 3

Speed ! the Solaris download was very much slower than the Linux download. This has been corrected with both operating systems now downloading equivalently fast.

The DC210 SDK for Unix distributions now unpack into a directory bearing the product name and version of the release.

The algorithm to establish communications has been optimized to allow for waking the camera from sleep mode.

The algorithm to establish communications has been updated decreasing the time it takes to find and synchronize with the camera.

The algorithm to establish communications has been changed to use functions which do not cause battery degradation.

Extended help has been added to the stand-alone programs. This was to clarify the port (see below) and other parameters that can be used.

The -h command line flag will cause each program to dump informative text on ports, options and parameter values.

The -? command line flag will cause each program to simply dump it's possible arguments.

The DC210 SDK for Unix stand alone tools statically define the Auto port as Port 1 resulting in the following configuration.

        Command   Logical Port         Physical Port
           Line                               Linux        Solaris

             0          Auto (Port 1)   /dev/cua0  /dev/cua/a
             1          Port 1            /dev/cua0  /dev/cua/a
             2          Port 2            /dev/cua1  /dev/cua/b
             3          Port 3            /dev/cua2  /dev/cua/c
             4          Port 4            /dev/cua3  /dev/cua/d
             5          Port 5            /dev/cua0  /dev/term/a
             6          Port 6            /dev/cua1  /dev/term/b
             7          Port 7            /dev/cua2  /dev/term/c
             8          Port 8            /dev/cua3  /dev/term/d

1.0 Beta 2

A Linux version of this product is now available as well as the ever popular Solaris versions.

Additional serial ports have been added for flexibility. The port number selected can be from 0 (Auto) to 8.

        Solaris
           /dev/cua/[a-d]   ports 1..4
           /dev/term/[a-d]  ports 5..8

        Linux
           /dev/cua[0-3]    ports 1..4
           /dev/cua[0-3]    ports 5..8

The low level communications routines have been updated to handle waking up the camera when it falls to sleep. This allows for running the camera on batteries, which after 5 minutes with no activity will fall to sleep (turn off.)
This does not occur when the camera is run on its mains adapter.
A side effect of this functionality is a longer communications establishment period while the software probes and tests the camera for its current baud rate and state (awake, asleep.)

The stand-alone programs have been updated to take a baud rate as a parameter (-s argument.) When writing a shell script using these programs the user can specify a common baud rate for all the programs reducing the start-up and initialisation time of each program.

1.0 Beta 1

This release of DC210 SDK for Unix includes all the functions included in the Kodak Win32 DC210 SDK.

Several stand-alone programs are included in this release which can be used to program and manipulate the Kodak DC200 and DC210 Camera's from the command line. This can be useful for applications such as CGI or batch processing.

Platforms

Operating Systems and Cameras are directly supported with this release (or reported working.)

Operating Systems	Solaris (SPARC) 2.6 Solaris (SPARC) 2.7 Solaris (Intel) 2.6 Linux (Intel) Red Hat 5.1 Linux (Intel) Suse 6.3 FreeBSD (Intel) 3.1
Cameras	Kodak DC200 Kodak DC210 Kodak DC210+ Kodak DC215+

Operating Systems and Cameras that may work with this release but have not been tested.

Operating Systems	Solaris (SPARC) 2.5/2.5.1 Solaris (Intel) 2.5/2.5.1
Cameras	Kodak DC200 plus

Operating Systems and Cameras that WILL NOT WORK.

Operating Systems
Cameras	Kodak DC240 Kodak DC280

DC210 SDK for Unix License & Legals

License

Permission is hereby granted to download and use this software (version 1.2.2) for any purpose, without fee.

Permission is NOT granted for re-distribution or copying of this software and documentation in any form.

Note: there may be a charge for future versions.

Copyright

Acknowledgements

The DC210 SDK for Unix is based upon the Kodak Digital Science DC200/DC210 Zoom Camera, Software Development Kit Library API.

FreeBSD Testing & Feedback

Ian Holland
Toby Hutton

DC200 Testing & Feedback

thi
Stefan Kapusniak

DC210 Testing & Feedback

Chris Brown
Leon Brooks

After the compressed file has been downloaded, it must be unpacked with the gunzip utility. Once unpacked the library, header files and example code need to be extracted with the tar(1) utility (see below.)

    $ cd /tmp
    $ ls
    sdk-1.2.2-solaris-5.6-sparc.tar.gz
    $ gzcat sdk-1.2.2-solaris-5.6-sparc.tar.gz | tar xvf -
    x sdk-1.2.2, 0 bytes, 0 tape blocks
    x sdk-1.2.2/include, 0 bytes, 0 tape blocks
    x sdk-1.2.2/include/wdc.h, 53514 bytes, 105 tape blocks
    x sdk-1.2.2/include/log.h, 12063 bytes, 24 tape blocks
    x sdk-1.2.2/lib, 0 bytes, 0 tape blocks
    x sdk-1.2.2/lib/libsdk.a, 61932 bytes, 121 tape blocks
    x sdk-1.2.2/example, 0 bytes, 0 tape blocks
    x sdk-1.2.2/example/Makefile, 345 bytes, 1 tape blocks
    x sdk-1.2.2/example/example.c, 10236 bytes, 20 tape blocks
    x sdk-1.2.2/htdocs, 0 bytes, 0 tape blocks
    x sdk-1.2.2/htdocs/about.html, 1846 bytes, 4 tape blocks
    x sdk-1.2.2/htdocs/documentation.html, 17089 bytes, 34 tape blocks
    x sdk-1.2.2/htdocs/download.html, 2479 bytes, 5 tape blocks
    x sdk-1.2.2/htdocs/images, 0 bytes, 0 tape blocks
    x sdk-1.2.2/htdocs/images/aus.gif, 627 bytes, 2 tape blocks
    x sdk-1.2.2/htdocs/images/further.gif, 3264 bytes, 7 tape blocks
    x sdk-1.2.2/htdocs/images/header.gif, 8212 bytes, 17 tape blocks
    x sdk-1.2.2/htdocs/images/here.gif, 1146 bytes, 3 tape blocks
    x sdk-1.2.2/htdocs/images/news.gif, 1551 bytes, 4 tape blocks
    x sdk-1.2.2/htdocs/index.html, 4384 bytes, 9 tape blocks
    x sdk-1.2.2/bin, 0 bytes, 0 tape blocks
    x sdk-1.2.2/bin/dump, 123452 bytes, 242 tape blocks
    x sdk-1.2.2/bin/delete, 66732 bytes, 131 tape blocks
    x sdk-1.2.2/bin/reset, 66272 bytes, 130 tape blocks
    x sdk-1.2.2/bin/configure, 72868 bytes, 143 tape blocks
    x sdk-1.2.2/bin/snap, 71268 bytes, 140 tape blocks
    x sdk-1.2.2/bin/status, 69176 bytes, 136 tape blocks
    x sdk-1.2.2/bin/zoom.sh, 956 bytes, 2 tape blocks
    $

You are now ready to test. The following example assumes that the DC210 camera has been attached to the first serial port (/dev/cua/a in Solaris speak) and will retrieve the camera's status at 38400 baud.

    $ cd example

    $ make
    gcc -I../include -L../lib -o dcstat example.c -lsdk

    $ ./dcstat -?
    Usage: dcstat  [ -l  log level    (0-2) ]
                   [ -p  port number  (1-2) ]
                   [ -s  baud rate    (1-5) ]
                   [ -x  extended help      ]

    $ ./dcstat -p1 -s3

    DC210 generic status:
      camera time                Tue May 19 13:17:00 1998
      firmware version:          1.51
      total pictures taken:      6
      total pictures remaining:  76
      memory pictures taken:     -1
      memory pictures remaining: -1
      card pictures taken:       6
      card pictures remaining:   76
      thumbnail size:            96x72
      picture size:              1152x864

    DC210 specific status:
      battery:              ok
      ac adapter:           on
      memory card:          inserted, formatted
      flash:                charged
      total pictures taken: 6
      communication mode:   serial
      pictures left:        33/48/76

    $

FAQ

Tell me about the DC200 Plus and DC240 Cameras

These look like great camera's and should work just fine with this toolkit. Unfortunately I can't get my hands on these camera's to verify this so they remain unsupported.

Why can't I access the DC210+ features from software

Kodak have specifically hidden these features from the software (as far as I can determine) so that compatability is maintained with previous releases.

This means that access to this functionality by software is impossible.

How much of the SDK's functionality is implemented ?

All the functions that are defined in the Kodak DC210 SDK definition.

The following list shows the functions that have been implemented.

DC210_Initialise
DC210_OpenCamera
DC210_CloseCamera
DC210_GetStatus
DC210_GetConfig
DC210_SetConfig
DC210_ContolCameraTime
DC210_ContolCameraID
DC210_ContolTakePicture
DC210_ResetCamera
DC210_TakePicture
DC210_DeletePicture
DC210_GetAllPictureName
DC210_GetCameraPictInfo
DC210_GetNativePicture

Some minor functionality may be missing within functions (such as image rotation, etc.) but all major functionality is present.

DC210_Initialise() looks like something new ?

This is an additional function which initialises a tracing and logging library. It has a format similar to that of printf(3s) but allows flexibility of the amount and destination of output.

This function must be called first as the DC210 SDK for Unix uses this library extensively.

The logging functions can be used in conjunction with the sdk. See the example program for more details and the log.h header file for the exact syntax.

Ok, I've written a great application but need it run under Win95

Simply get hold of the Kodak Digital Camera DC210 Software Developer's Kit, recompile and relink !

Is it that easy ? Not quite, but that's the aim of this sdk, a compatible sdk for unix !

What are the stand alone programs and what do they do ?

The following stand alone programs are included.

dump: downloads one or more photos and optionally thumbnails
delete: deletes one or more photos
reset: resets the camera to system defaults
configure: sets and optionally prints the configuration of the camera
snap: sets the configuration and snaps a picture
status: prints the current status of the camera
zoom.sh: simple shell script showing how to snap several photos, adjusting the zoom position as it goes

Operating System Specifics

At present there are no functional differences in the SDK between the different operating systems. However, there are minor operational differences due to serial port specifications.

last updated 10-Aug-2000

Back