This is a Java wrapper around the Canon EOS Digital Software Development Kit EDSDK that gives you full access to your Canon SLR camera on Windows*. The features include:
- Taking and downloading pictures
- Manually adjusting focus
- Setting apperature, exposure, ISO
- Accessing live view
(*) With a few changes it might also work on Mac OSX.
- Open Source hosted at https://github.com/kritzikratzi/edsdk4j
- License based on license of libraries used - the rest is WTFPL http://www.wtfpl.net/
- Maven based Java project including JUnit 4 tests.
Available at Maven Central see
<dependency> <groupId>com.bitplan</groupId> <artifactId>edsdk4j</artifactId> <version>0.0.1</version> </dependency>
How to build
You might want to make sure that you have your ESDK in place - see "Applying with Canon for ESDK ..." below
git clone https://github.com/kritzikratzi/edsdk4j cd edsdk4j mvn install -Dgpg.skip=true
Before running the Unit Tests you might want to connect your camera with an USB cable and make sure that no other application is using the USB connection to your camera.
If you have a maven command line installed you can run the tests from the command line with:
or run the tests in you IDE.
- e.g. in Eclipse click pom.xml and choose "Run As/Maven test".
- e.g. in Eclipse you can run the src/main/test/TestSuite with "Run As/JUnit Test"
expected mvn test result
------------------------------------------------------- T E S T S ------------------------------------------------------- Running edsdk.TestCanonConstants Begin checking whether CanonConstants has all constants from EdSdkLibrary Completed checking Tests run: 1, Failures: 0, Errors: 0, Skipped: 0, Time elapsed: 0.382 sec Running edsdk.TestEDSDK Camera saved an image file Saved photo as: C:\Users\wf\AppData\Local\Temp\IMG_0001.JPG EdsImageQuality_LJF/1310479 EdsImageQuality_LJN/1244943 EdsImageQuality_MJF/18087695 EdsImageQuality_MJN/18022159 EdsImageQuality_SJF/34864911 EdsImageQuality_SJN/34799375 EdsImageQuality_LRLJF/6553619 EdsImageQuality_LR/6618895 Canon Camera: Canon EOS 1000D is connected Interrupt received in CanonCamera, stopping... EDSDK Dispatcher thread says bye! Tests run: 4, Failures: 0, Errors: 0, Skipped: 0, Time elapsed: 9.958 sec Running edsdk.TestJNA Tests run: 2, Failures: 0, Errors: 0, Skipped: 0, Time elapsed: 0 sec Running edsdk.TestLibrary Versions: ProductVersion FileVersion FileName -------------- ----------- -------- 184.108.40.20604 220.127.116.1104 C:\Users\wf\workspace\edsdk4j\EDSDK_64\EDS... Tests run: 1, Failures: 0, Errors: 0, Skipped: 0, Time elapsed: 2.346 sec Hello, World Argument 0: Welcome Argument 1: to Argument 2: JNA Results : Tests run: 8, Failures: 0, Errors: 0, Skipped: 0
Applying with Canon for ESDK Software Development kit access
Before you can use this library you need to obtain the EDSDK native library from Canon. You can do so via their developers program:
Once you were granted access - this may take a few days - download the latest version of their library and follow the usage instructions.
Using the EDSDK from Java directly is possible using the
but because of threading difficulties and the involved data types this can be a bit painful.
edsdk.utils package you find a small layer built on top of the EDSDK
that gives you more Java-like examples.
Most notably, all calls have synchroneous and async calls. The async variants give you a CanonTask and you can choose if you want to wait for the result or be notified when it's done.
CanonCamera slr = new CanonCamera(); slr.openSession(); // Use the blocking variant to get a result immediately. File file = slr.shoot(); System.out.println( "File: " + file.getAbsolutePath() ); // Use async handlers to continue your code immediately slr.shootAsync().whenDone( f -> System.out.println( f ) ); // close session is always blocking. // because commands are queued this won't be executed // until the above slr.shoot() finished it's work. slr.closeSession();
Pay attention to the parameters you're setting!
The EDSDK does not check whether the parameters you're setting are actually suitable for your camera model. This can lead to very strange and possibly unfixable configurations, in the worst case you can brick your camera with the infamous error 99.
I mostly tested with the EOS550/600 and had no problems so far, but one user reported a repair estimate of 400€ after bricking a 50D by just changing the quality setting. See https://github.com/kritzikratzi/edsdk4j/issues/20 It's hard to tell what happened exactly and I'm almost 100% certain that that's not normal, but please be aware there is a slim chance of this happening to you as well.
CanonCamera slr = new CanonCamera(); slr.openSession(); File file = slr.shoot(); // (*) slr.closeSession(); (*) If you have raw+jpeg enabled you'll have two images in that array. Usually it's just one.
For more look at the examples in src/gettingstarted.
In case you need to regenerate the JNA wrapper classes:
set EDSDK_HOME=path-to-edsdk ant generate-wrapper
This does not need to be run, unless you want to regenerate the bindings for the latest version of the EDSDK because you need to use the newest features.
- Currently JNAerator is not detecting __stdcall correctly so the Callbacks defined in EdSdkLibrary need to be manually modified to extend StdCallCallback. Technically EdSdkLibrary itself should also extend StdCallLibrary but it's possible to workaround this using options passed into the Native.loadLibrary() method (see CanonCamera class for this workaround).
: pre 2014-08 https://github.com/kritzikratzi/edsdk-processing
: 2014-08 https://github.com/kritzikratzi/edsdk4j
- 0.0.1: 2016-08-24 First mavenized release via GitHub / Maven central
EDSDK4J on github
Canon EDSDK questions on Stackoverflow