CHDK Wiki
Register
(note > 4gb cards work.)
Line 44: Line 44:
 
In order to see the firmware version of your digital camera, you must create a special SD card.
 
In order to see the firmware version of your digital camera, you must create a special SD card.
   
You will need a regular SD card, with a maximum size of 4GB, and a computer equipped with a SD card reader.
+
You will need a regular SD card, with a maximum size of 4GB, and a computer equipped with a SD card reader. Note that CHDK does work with cards larger than 4GB, but this requires additional steps not covered here. See the [[FAQ]] for details.
   
 
Modern laptops usually have integrated SD card readers; if you have a computer or an older laptop, you will need a separate '''USB card reader''' connected to one of the free USB ports.
 
Modern laptops usually have integrated SD card readers; if you have a computer or an older laptop, you will need a separate '''USB card reader''' connected to one of the free USB ports.
Line 470: Line 470:
   
 
= The next step: [[FAQ]] =
 
= The next step: [[FAQ]] =
 
 
[[Category:Help]]
 
[[Category:Help]]

Revision as of 23:26, 27 June 2009

The Very First Steps

Buying a new camera

Limitations

If you're planning to buy a camera and use CHDK with it, you must pay attention to the following:

  • CHDK only works with Canon digital cameras. It is highly unlikely it will work with cameras from other manufacturers.
  • CHDK works only with P&S (Point And Shoot) digital cameras at the moment of this writing.

Point And Shoot cameras (also called Digital Compact in various countries) are small, pocket size, and simple to use digital cameras, without fancy lenses.
DSLR (Digital Single Lens Reflex) or SLR cameras are more complex, bigger, need spare lenses but also more expensive. These cameras are targeted towards semi-professionals and professionals and offer many CHDK-like features, like RAW files and bracketing, from the beginning.
First time camera users should purchase Point And Shoot cameras.
Good places to read about digital cameras are Dpreview (offers lots of camera reviews) or the Canon Forum, a website populated by people who love to talk about Canon cameras.
The CHDK forum also provides valuable tips: [Link 1], [Link 2] and [Link 3]

  • CHDK works only with specific camera models and specific firmware versions.

Each digital camera contains a small program inside it, called firmware, that controls various functions of the camera.
For each new digital camera, CHDK developers must extract this program from the digital camera's memory and make CHDK compatible with it.
Therefore, it may take some time until a very new digital camera is supported by CHDK, as developers usually need to have access to that digital camera model and firmware, to make sure nothing bad will happen with users' cameras.
CHDK must also be adapted by developers for various versions of the firmware program. If you buy a digital camera that started to be manufactured a while time ago, it's quite possible that the Canon programmers updated the firmware once or several times since then.
A method to determine the firmware version inside a camera is presented below (or read the FAQ entry).

You can see whether a digital camera and firmware version is currently supported by CHDK by checking the official CHDK camera list.

How to determine the firmware version of a Canon P&S camera

USBCardReader

USB Card Reader

FormatSDCardWindows

Format SD Card

CanonA580 Back

Canon Camera Back Side

Preparing the SD card

If the process below is hard to understand, please see the more detailed FAQ page.

In order to see the firmware version of your digital camera, you must create a special SD card.

You will need a regular SD card, with a maximum size of 4GB, and a computer equipped with a SD card reader. Note that CHDK does work with cards larger than 4GB, but this requires additional steps not covered here. See the FAQ for details.

Modern laptops usually have integrated SD card readers; if you have a computer or an older laptop, you will need a separate USB card reader connected to one of the free USB ports.

Now follow these simple steps:

  1. Insert the SD card into your card reader and copy all its contents into a safe place.
  2. Format the SD card by right clicking on the card's drive letter and selecting the Format option
    Note: step 2 is not always needed, presence of the ver.req file is sometimes sufficient.
  3. Create an empty file in the root of your SD card, called ver.req
You can do this by right clicking on an empty area in the root folder of you card and selecting the New > Text Document menu entries.

Type ver.req and, when asked, click on Yes to confirm that you want to change the file extension.

On some very new digital cameras, you may need to create a file called vers.req instead of ver.req, to see the firmware version.
In the store

With this special card, you can go the store and kindly ask the salesman to put this card in the camera, for a test.

  1. Switch the camera in Play mode and start the camera. Remember: camera must be in Play mode before you start it!
  2. Wait until the camera starts completely
  3. Locate the FUNC SET and DISP buttons (see picture on the left)
  4. Press and hold the FUNC SET.
  5. Still pressing the FUNC SET, press DISP once.
  6. Look at the display. You will see something like this:
Canon PowerShot A650 IS

P-ID:315B NT D

Firmware Ver GM1.00D

NoError

Jul 6 2007 12:41:33

The GM1.00D part is the firmware version. If you see B1.xx listed, this usually means the firmware is beta.

Write down the camera model and the firmware version, remove your SD card from the camera and thank the salesman nicely for helping you out.

Check the official CHDK Camera list to see if this particular camera model and firmware version is supported.


Will CHDK damage my camera?

CHDK is designed in such a way that it does not make any changes to the programs inside the digital camera. This means that as soon as you remove the SD card, the digital camera will be like new.
You normally can not damage your camera, but nobody can guarantee it. So far, it has never been reported that a camera was damaged by any official version of CHDK.
In the worst case, it is possible to crash the digital camera (camera hangs up). This can be easily fixed by turning off the digital camera and removing the battery for approximately one minute.

Be aware that experimental versions of CHDK aren't fully tested. So, if you are afraid of that possibility, use only official, stable and tested versions.

Certain combinations of script commands are believed to be capable of causing damage to the zoom motors. But only advanced users dare to use them. Still, there have been no reports of impairment. Standard scripts are safe.

More technical info at: What is the worst that can happen?


I have the camera already!

SD Card with Card Reader

SD Card & Card Reader

Check List

  • one SD card (Max. 4 GB !)
  • one card reader
  • one personal computer plus one free USB port
  • simple computer navigation knowledge
USB connector

USB Connector


Let's put the CHDK in the card

Mac users should go to Mac FAQ.

Please keep in mind that this method will erase all files from the card.

  1. Connect the card reader to your [USB port].
  2. Put the SD card in the card reader.
  3. Open My Computer and verify that you can see the card unit. It will be a removable device. Put the mouse pointer over the icon, and see if the size matches your SD card's size. If not, check your card reader installation procedure. Don't go any further until you are sure you have this reader working and your card accessed.
  4. Download CardTricks from Wiki or look Card Tricks thread and save it to a specific computer folder. Or just create one, if you wish. Locate the download folder and simply double click the file: Card Tricks will open.
  5. Check the Auto box.
    Card Tricks 1

    Card Tricks

  6. Click the card stamp (below the Auto box) and select the card's drive unit.
    Pay attention: is the drive corresponding to the previously identified card reader unit.
  7. The Card Info & Selection section is updated now. Read and check one more time if it actually is your card: the card size is a good sign. If it has no size (not formated) and you just bought your card, it's positive feedback: you picked your SD card correctly.
  8. Click the Format as FAT button, read and accept the notice. Card Tricks will format your card in the best way for CHDK. Wait until it ends.
  9. Click the Make Bootable button, read and accept the notice. Card Tricks will prepare your card for camera autoload.
  10. Click Download CHDK. Your browser will open at the CHDK official download page. Pick your camera model's ZIP file. Just remember where you saved it!
    It is possible that there is more than one file per camera: Choose which one by referencing your camera's firmware version, go back here if you are unsure which version you need.
  11. Click the CHDK->Card button, select the ZIP file you downloaded, confirm and wait until the unzipping message disappears.
  12. Remove the card from the card reader.
  13. Lock the card! (the little plastic switch on the side of the SD card)
    01update03

    CHDK splash screen

  14. Your card is now autoload and ready to use.
  15. Place the write protected card back in camera and turn on. If everything went right the CHDK splash screen will blink.

Obs.: If you are curious about how this process happens, start with this: How does CHDK start running

Last chance: If you still don't get it, try CHDK For Newbies - How To Install. It's a fun step by step video tutorial.

Tip: It is preferable to use a card reader, if you can, rather than the USB cable. There are many situations where the camera USB port may confuse you.


CHDK is loaded!

First thing you'll notice using CHDK is your OSD (On-Screen Display) changes. You'll see now, left to right a number, two icons and a percent.

  • First number is your available card space in MB.
  • Next to it you'll see your battery icon and below the charge remaining capacity in percent.
    A720 back buttons

    CHDK buttons

  • The top right one is the iconic representation of the free space amount of your SD memory card in MB.
Menu Navigation - Enabling Histogram
Enabling Histogram
Histogram

Histogram Menu

  1. Press the print button (called Alt from now on) once.
  2. Press Menu once. The Main Menu will show.
  3. Press Down until you highlight Histogram parameters.
  4. Press FUNC SET to activate it, the Histogram menu will appear.
  5. Go Down to the very first option Show live histogram
  6. Press Right to change, choose Always
  7. Press Menu
  8. Press Alt
  9. Go to Record mode if you are not there yet

You are now seeing a live RGB histogram. Point your camera around and see the how the different lighting changes it

Setting the Histogram Mode

(continuing from above...)

  1. Now press Alt once, note that a blue bar with the ALT letters appears in the center bottom of your screen.
  2. Press Menu and go to Histogram menu as you did above (steps 3-4)
  3. Navigate to Histogram layout and press Right until RGB all appears.
  4. Press Alt directly, it's the fastest way to return to Canon operation mode.
Placing the Histogram

(continuing from above...) You'll now see a more complex histogram, but partially hidden on your OSD. To correct this

Layout editor

OSD Layout Editor

  1. Went back to the CHDK Main Menu (you know now, Alt then Menu buttons)
  2. This time navigate to OSD parameters and activate it (press FUNC SET)
  3. Now in the OSD menu, Go down to OSD layout editor press FUNC SET to activate it. You'll see a lot of info on your screen. Don't panic!
  4. Press FUNC SET repeatedly and observe that each time you press it, one set of screen info is selected with a green highlight. Press until you have the histogram graphic selected.
  5. Now, with the navigation buttons - Up, Down, Left and Right - move the histogram around the screen until the histogram is shown in a nice place on the screen.
  6. Press Alt to save and exit.

Now you have the live RGB all histogram on your screen.

You have now learned how to navigate in CHDK.

  • For more information about histogram settings go there.
  • For a wonderful explanation about what a histogram is go there.

RAW
Raw

RAW menu

A few words about RAW

You have probably already watched those nature programs where they show us the world through the eyes of bees, dogs, flies and spiders. Your camera sensor works in a similar way. Like the human eye, the camera eye - the Charge-Coupled Device (CCD) or the Complementary Metal–Oxide–Semiconductor (CMOS) sensor - sees the light, but in a different way. Therefore, to bring that vision to our natural way of seeing light, some math needs to be done. So, after the camera hardware has done some processing, the OSD can show us an understandable and expected result. The final product is a photo file that you print, send or store in your computer - the JPEG image file. On the other side, this very first and odd looking from the camera's sensor is called RAW. CHDK saves that information in a file for further uses.

Activate RAW
  1. Go Record mode.
  2. Press Alt.
  3. Press Menu
  4. Highlight Save RAW.
  5. Press FUNC SET and you'll see this [•]
  6. Press Alt for exit.

Your screen will now show 'RAW' and a number. This number is the amount of RAW shots that you could take with your available free card space. Note that this number is far below the number of normal shots that Canon info tells you is possible, since RAW files are larger. Trust the CHDK number now.

CHDK RAW in the real World

CHDK generates a 10 bit non standard RAW file; few commercial programs support this format yet. But you can always convert your CHDK_RAW files to a standard DNG or TIFF file by using this program: DNG4PS-2 and read DNG4PS2 for more information. If you don't have any preference yet, give PhotoLine a try, it already supports CHDK_RAW files. Lately, some people have proclaimed good results with Raw Therapee and UFRaw


More links
About RAW settings RAW parameters menu and RAW Develop.
About camera sensors Digital Camera Sensors.
About RAW editions and compatibilities Raw image format.


CHDK Features

Bracketing

Concept

It's a way of using a series of shots of the same subject, generally at distinctly adjusted settings, to achieve, usually at a later time, a different and better result. Basically, there are three kinds of bracketing: luminance, focus and noise reduction. With many technical variations on each. The first and third can be done internally by a P&S camera with some CHDK processing (RAW Develop).

Try this simple and valuable bracketing technique. If you understand and master it, you could, by just changing some parameters, solve a lot of bracketing situations.

Bracketing and HDR

This is a simple way to do luminance bracketing, using Tv (Time value) priority, without any knowledge of scripts. It's a good option for in a hurry moments. Follow the recipe below:

  • CHDK navigation:
    • Press Alt to enter
    • Extra Photo Operations / Bracketing in continuous mode / Tv bracketing value: 2 Ev
    • Extra Photo Operations / Bracketing in continuous mode / Bracketing type: +/-
    • Press Alt to exit

+

  • Canon navigation:
    • Put in Record Mode
    • Put the mode Dial to P or select the Manual mode on cameras without a mode dial, e.g. on the Ixus series
    • Press FUNC SET
    • Navigate to Drive Mode / C ustom
    • Press DISP
    • Choose Delay: 1
    • Choose Shots: 3
    • Press FUNC SET to exit

You are now ready to shoot.

Some tips:

  • If you can, use a tripod. It'll avoid a lot of extra PP (Post Processing) work.
  • Before the shot, halfway-press and hold the shoot button to adjust focus and light. Continue and press the shoot button fully when you are happy with the settings.
  • Remember to take your finger or hands completely off the camera, if you are using a tripod. With this setup, there will be a short interval before the shutter actually fires.
  • The camera will do the first shot with your ((P)ersonal) best light standards; then it will slow the Tv to +2 Ev equivalence and take a shot; and finally -2 Ev equivalence.
  • If you want smoother intervals you should change the Tv bracketing value to 1 Ev and number of shots to 5. You will get the same interval with more steps.

Now you can go for some HDR (High Dynamic Range) imaging edits.

Bracketing and DOF

There is a good start tutorial at DoF Stacking.

Bracketing and Resolution
Bracketing and Noise

The easiest way to remove noise of low light photos is by using the internal Raw Develop CHDK functions, there you will find a concept explanation.

Obs.: Noise is a mess... with a lot of variations. If you wanna start this war you must know with what bandit you are fighting against:

CHDK Bracketing Techniques
Tv Bracketing
Av Bracketing
ISO Bracketing
RAW Develop

Some thoughts about RAW Sum and RAW Average
This is not exactly a dummy topic, but let's get the principles.

  • When we see these big live broadcast concerts with thousands of people, sometimes the camera shows the crowd singing loud and beautifully. But hey! We can always see one or two guys chanting the "other" part of the song! Nevertheless, we hear the chorus singing perfectly. The uneven voices still exist, but they are minority. So, the TV brings us the "correct" - the average - song.
    This is RAW Average, a clean version of the scene.
  • In a similar way, if you live some blocks far from the concert place and your TV is off, you can still hear the crowd singing the songs. It's perfectly impossible listen a human voice at this distance, but the whole mass of voices is something bigger.
    This is RAW Sum, a brighter version of a scene.


If you want more:

Useful links

Scripts

Concept

By definition script is a programming language that controls a software application.

It's like a taxicab: there is the car, the driver and there is you. Once inside, you can order the direction you wanna go. Also, you can tell the driver to go from here to there, to avoid this or that streets, to go fast or slow etc. So, the driver drives the wheel, the gas pedal, the breaks, the clutch, car light signals, avoid other cars or some potentially dangerous obstacles and, finally, brings you to your destination. The main power that moves this process come, almost exclusively, from the car itself. But all this power would be useless without the taxi driver expertize. And, of course, none of that would have even started if not been for your command. Our camera's hardware is the car, your camera's firmware (plus CHDK) is the driver and the script is you.

CHDK scripts are written in a modified versions of ubasic or Lua. Scripts allow control of many CHDK and camera functions.

For more information see:

How to load
How to use
How to change
Useful links

Grids

Concept
Useful links

CHDK Video features

Similarly as the RAW -> JPG procedure, Canon cameras transform real motion action in video format. This format is named Motion JPEG - similar to JPEG, the static image format. There are many video compression formats used nowadays: Moving Picture Experts Group Type 2 (MPEG-2) for DVDs and cable TV, MPEG-4 for Blue-ray DVD discs, Windows Media Video (WMV) for some computer video files, Flash Video (FLV) for YouTube videos, etc. M-JPEG has a significantly higher bitrate than these formats. That's bad, because the same amount of video time will take more storage space than other formats. But that's also good, because you lose less information in the compression activity and can edit more easily at your computer.

How to use
  1. Press the Alt button once.
  2. Press Menu once. The Main Menu will show.
  3. Press Down until you highlight Video Parameters.
  4. Press FUNC SET to activate it, the Video Parameters menu will appears.
  5. Go Down to the very first option Video Mode.
  6. Press Left or Right to alternate the options.

The first thing you'll see is Video Mode. There are two options: Bitrate and Quality.

  • Bitrate means that Canon will record your motion at a constant compression rate. The more bitrate, the more space will be used in your SD card and better will be the video quality. 1x is near the Canon default compression.
  • Quality means the Canon will record your motion at a constant quality. It means that, if necessary, the camera, by itself, will increase or decrease the compression rate to mantain the video quality constant. The more quality, more space will use at your card and better will be the video. 84% is the Canon default compression.


Remember:

  • When you choose Bitrate, the Video Bitrate number is the active setting.
  • When you choose Quality, the Video Quality number is the active setting.


Obs.: S5 do not have these CHDK video mode options, until now.

Enable optical zoom
Digital cameras have two types of zoom available: The optical zoom and the digital zoom.

  • The optical zoom uses lens refractions to magnify the objects, resulting in clear, sharp images.
  • And the digital zoom approximates zoom by magnifiying the pixel size. It does some math to improve the result, but will always produce worse results when compared to the optical zoom. Objects will appear larger, but can lack definition and appear blocky.

Canon blocks the optical zoom during video shoots. That's bad because you will lose quality when you zoom things digitally. CHDK unleashes the optical zoom that the Canon's engineers blocked, but the drawback is that the zoom mechanism noise is recorded in your video as well.
Do some tests to get the best combination for you.


Versions

What's the best version(build)?

There's no such thing as a best version. There's only the best version for you. CHDK versions are like a suit, if it fits, feels comfortable and you are happy with it:
- That's the best suit!
- But if this is your first suit and your unsure of what you need, you should click here and at the top of that page click on the link that says "CHDK Autobuild Downloads". At this time (2008 10 27) many of the great innovations are included in it and it has all the features a newbie needs and then some.

Why they exist?

Each little genius here thinks in his/her particular way - and desires different things too. So, they take the core of CHDK and change it to fit his/her particular needs or ideas. They are all like sculptors that take wood and shape it like they want to. Because they aren't greedy, they share their efforts with everybody in the forum threads or wikia postings.

Besides that, there is a group of members that works at maintaining the core/wood of CHDK, like GrAnd, cail, EWAVR, Fingalo, Allbest, jeff666, nirschi, DataGhost and a lot of other remarkable members. Along them other sharp minds work in related tasks.

Remembering that it all started, years ago, with a one man only task, done by the mysterious Vitaly.

Useful links

The big bucket: here (if you haven't look yet...).
Other Mods:
Jucifer's
DataGhost's

Interesting links:
View from the core: Trunk history.
More answers.

Obs: If someone was forgotten, please excuse. I apologize. Just edit and update for more correct info.


Problems: Searching and Posting

- It doesn't work!
At this moment some people have difficulty with staying calm and reviewing their previous steps, looking for simple mistakes. If you do so and still can't make it work, I suggest a few steps for you to follow.

Searching

It is very likely that you're not the first person with this particular problem. So, start searching for others with the same problem, and you are likely to find solutions and advice.

Here on CHDK wikia: The search bar is in the top left of this page.
At the official CHDK forum you'll find the Setepontos Search tool.

Try searching from general to specific. Stop narrowing when your results become easily browseable.

Ex.: Let's say you have problems working with RAW. First try

  • RAW -> You'll get a lot of info about it! But your problem is to get the RAW from the camera to your computer.
  • RAW download -> But hey, you're a Windows user, so...
  • RAW download explorer -> Now pick some and see if it fits.

Some times you have to limit your search with a minus (-) sign to exclude some words. Ex.: You're having color problems in your pictures. So if you do the bottom search

  • color -> You'll have too much. Your problem is about JPG color problems, not RAW.
  • color JPG -> But RAW references keep coming.
  • color JPG -RAW -> now you get more suitable results.


Caution: The search function in the CHDK wikia (this site) needs at least 4 chars in search expression !

Posting

- Still doesn't work!

If your problem doesn't seem to be covered yet, you can open a thread at the CHDK forum about it.

  1. Be careful in choosing the correct section/subsection. If you have specific problems dealing with CHDK, this isn't exactly a developer matter. So, don't post at CHDK Development, go Using CHDK/General Help and Assistance on using CHDK stable releases.
  2. Put a short descriptive title in your thread.
    HELP HERE! or SOME AID!! or I'M DESPERATE!!!
    usually don't receive good feedbacks.
  3. Describe your problem as accurately as possible.
  4. List at least:
    1. Camera model and firmware version
    2. CHDK brand and version
    3. Operating system
    4. Card size and brand
  5. Wait.
    There is no Help Desk service. You have to count on the goodwill of other CHDK users like you.
  6. Don't beg for urgent help. But don't give up. Check answers on a daily basis.
  7. After someone answers you, reply and say if the proposed solution worked or not, and why. This will help others searching for answers in the future!
  8. Thank the person who helped you!
  9. Be polite and friendly, don't argue with others trying to help, it's a waste of your time.
  10. And when you know and can, help others.

Is there a manual?

  • A new user guide is now available (April 2009), go to New User Guide. It is a compilation of Allbest 50 and Morebest guides, with updated
content and images, in .pdf format. (To print as a book or booklet with higher resolution, download from http://drop.io/chdk_new_UserGuide_booklet_pdf)
Edited 16th May 2009.

Odd and Tricky cameras

SD870IS / IXUS 860

Below are some limitations with this camera:

Power up in playback mode

The camera always powers up in playback mode and shows the last captured pic. For record mode press (or half press) the shutter.
With 'Clock Display' set to '0 sec' in the Canon menu, the camera can be started direct in record mode by the following workaround:
Hold FUNC while pressing POWER, release FUNC immediately when the Canon clock display appears

OSD disappears after ~10 seconds

By default (or after a reset to the Canon standard settings) the Canon OSD symbols disappear after ~10 seconds in record mode.
With the DISP button you can toggle between two states: [OSD always on] or [OSD off after 10s. The last used setting is saved for standard.

Doesn't support long filenames in file browser

As on all DryOS-based cameras the filenames in the filebrowser are shown in 8.3 convention (old MS-DOS style), longer filenames existing on the card will be shown in the corresponding short term.
Example: the filename "DefaultScript1.bas" on the SD card is shown as "DEFAUL~1.BAS" in the file browser dialog.


Some Hints:

  • The display can be switched off in record mode by long-pressing the PRINT key. To set this, in the Canon menu (in record mode, menu item "Set PRINT Button...") the PRINT key should be assigned to "Display Off". This can also be usefull for saving battery lifetime in scripts: to shut off the display a sequenze of
    press "print"
    sleep 100
    release "print"
       can be used after each shot.
    Turning off the display this way in a script can lead to 3 times longer battery lifetime.
    → Beware - this method turns also off the image sensor, the MD (Motion Detection) will not work with this method !
  • The short key for enable/disable RAW is Alt-DISP-Alt

S5

  • No video (compression) mode options

SD750

  • The OSD menus flicker on and off oddly. Disabling the "touch icons" in the camera's settings helps somewhat.

The next step: FAQ