NAME
qvplay − control Casio QV-10 digital camera.
SYNOPSIS
qvplay [ −D ttydevice ] [ −S speed ] [ −p num ] [ −o filename ] [ −F format ] [ −g num ] [ −s num ] [ −e num ] [ −d num ] [ −4 num1,num2,num3,num4 ] [ −9 num1,num2,num3,num4 ] [ −P num ] [ −U num ] [ −i num ] [ −y num ] [ −hrnavtV01I7VzZ ]
DESCRIPTION
This manual page applies to qvplay version 0.95 by ken-ichi HAYASHI and Jun-ichiro "itojun" ITOH.
qvplay allows the computer to control the Casio QV-10 digital camera. Use entirely at your own risk. Functions include downloading picture(s) from the camera, deleting camera image(s), report on camera and picture status, instruct the camera to take a photo, reset the camera etc.
QV-10 can take up to 96 pictures, each at 320x240 24-bit pixels. And QV-100/200/300/700/770 can take more pictures, and 640x480 pixel pictures. It can be linked to the serial port of a computer using the supplied cable (see under BUGS for wiring changes needed for some machines.
When switched on, the camera can be in one of three states - normally, it responds to its own control panel (Normal state) or it is in Command state when it only responds to commands from the computer. Finally, it can be Processing where it will only respond to the reset command. For this reason it is a good idea to reset the camera by running qvplay −r after using it with the computer.
If the camera does not respond, switch it off and then on again to do a ’hard’ reset. If the transfer times out, try using a slower speed.
Pictures of
QV-10 series(QV-10/10a/11/30/70) and ’Normal’
pictures of QV-100 series(QV-100/200/300)
are output as 480x240 so you should re-size them with
xv(1) or pipe through a converter, e.g.
qvplay -g 1 | djpeg | pnmscale -xsize 320 -ysize 240 | cjpeg
where djpeg(1) and cjpeg(1) are conversion routines from the International JPEG Group (often distributed with xv(1).
QV-700/770 are output as 640x480.
OPTIONS
Options are
processed from left to right so it is important to set the
serial line speed first, then any start and end parameters
before any −g or −a options.
−D ttydevice
Specify the serial port to use. Something like /dev/ttyS0 on Unix and COM1 on less sophisticated systems. The default is /dev/qvtty.
−S speed
Specify the baud rate for the transfer. Possible values are {normal, mid, high, top, light} or {1,2,3,4,5} for a corresponding {9600, 19200, 38400, 57600, 115200} baud rate. ´light speed’ is supported in Linux, OS2, and Win NT/95. With Old version Linux, use setserial(1) to achieve lightspeed e.g.
|
# set 57600baud |
qvplay -S top -o foo.jpg -g 1
or
|
# set 115200baud |
qvplay -S light -o foo.jpg -g 1
If you are using a PC/AT compatible computer, you will need a 16550A compatible serial controller to use more than 19200 baud (the ’mid’ setting).
|
−p num |
Instruct camera to display picture number num. |
−o basename
Use basename as the basis for filenames with the −a option instead of qv. For example, −o foo will cause files foo_001.jpg, foo_002.jpg to be created.
−F format
Governs the output format for the download. The format is determined by the first letter, so ’ppm’, ’picture’ and ´photo’ are equivalent.
Possible values are:
|
jpeg |
The default. JPEG (JFIF) format. | ||
|
ppm |
PPM format thumbnail picture | ||
|
PPM |
PPM format picture | ||
|
rgb |
RGB format thumbnail picture | ||
|
RGB |
RGB format picture | ||
|
bmp |
BMP format thumbnail picture | ||
|
BMP |
BMP format picture | ||
|
cam |
CAM format picture (thumbnail and picture format) - Casio’s proprietary format. | ||
|
−g num |
Download the num’th image from the camera. If the −o basename option is used, then the picture will be saved as basename.jpg, otherwise, the image is sent to stdout.
|
−s num |
Specify the starting number for a mass download of files. Must be used before the −a option. | ||
|
−e num |
Specify the ending number for a mass download of files. Must be used before the −a option. | ||
|
−d num |
Delete the num’th image in the camera. |
−4 num1,num2,num3,num4
Display 4 images on the camera screen at once.
−9 num1,num2,num3,num4
Display 9 images on the camera screen at once.
|
−P num |
Protect the num’th image. | ||
|
−U num |
Unprotect the num’th image. | ||
|
−i num |
Print information about the num’th picture. | ||
|
−y num |
Set num’th image as default picture, it shown when QV-10 is powered on or reseted. −a or −g. | ||
|
−h |
Print a help message and exit. | ||
|
−r |
Reset the camera and change baud rate to 9600 baud. | ||
|
−n |
Print the number of pictures in the camera’s memory. | ||
|
−a |
Download all pictures from the camera and save as files called qv_001.jpg, qv_002.jpg etc. See also the -F, -o, -s and -e options. | ||
|
−v |
Used with the -a and -g options, reports download verbosely on stderr. Reported information is downloaded bytes, not a filesize. | ||
|
−t |
Instruct camera to take a picture - sets camera switch to REC position. (This function dose not work at QV-700/770.) | ||
|
−I |
Print information about all pictures. | ||
|
−7 |
Display a colour bar on the camera. | ||
|
−0 |
Power off. | ||
|
−1 |
Disable auto power off function. | ||
|
−V |
Report approximate battery status. (This function dose not work at QV-700/770.) | ||
|
−z |
Report camera status. (This function dose not work at QV-700/770.) | ||
|
−Z |
Report camera revision. |
ENVIRONMENT
FILES
BUGS
Because the Casio QV-10 to PC link cable incorporates special electrical circuits to provide power to the camera’s serial port (level converter), some computers (see under AVAILABILITY ) will need a hardware hack.
The link cable uses CTS, DTR terminal as Vdd(+ side), and RTS terminal as Vss(- side). So qvplay(1), qvrec(1), and qvdelall(1) all turn CTS, DTR terminal on, RTS terminal off and hold them there. Since some operating systems change RTS terminal to off, this causes serial communicaton to stop. If your computer cannot hold the RTS terminal off, you must hack the PC link cable to connect the RTS signal pin to GND pin. This small hardware hack applies a voltage difference from CTS, DSR to RTS, so that the circit in the Casio PC link cable works all the time.
As an alternative to hacking the PC link cable, you can make up an RS-232c jumper box as follows:
JUMPER BOX
(PC/WS side) male female (PC link cable side)
(RTS) 4 +------ 4(RTS)
|
(GND) 7 -------+-------7(GND)
And connect like this:
[PC/WS serial port]--[JUMPER BOX]--[PC link cable]--[QV-10]
Take picture function(-t option) dose not work well at QV-100/200/300.
Take picture function(-t option) dose not work at QV-700/770.
COPYRIGHT
AUTHORS
Ken-ichi HAYASHI <xg2k-hys [AT] asahi-net.jp>
Jun-ichiro "itojun" Itoh <itojun [AT] csl.jp>
AVAILABILITY
Unix systems:
-PC/AT clone Linux 2.2.X, 2.3.X
-PC/AT clone Linux 1.2.13, 1.3.20, 2.0.35
-PC/AT clone BSD/OS 2.0
-Sony NEWS-3150U2 NEWS-OS 4.2.1RN
-Sony NEWS-1860 NEWS-OS 4.2C
-Sony NEWS-4000 NEWS-OS 6.1.2
-NEC EWS4800 Rel.4.4 Rev01
-Sun Sparc Station 20 Solaris2.3(SunOS 5.3)
-Sparc clone SunOS 4.1.4
-Apple Macintosh SE/30 NetBSD 1.0
-PC/AT clone FreeBSD 2.2.6R
-PC/AT clone FreeBSD 2.0.5R(*)
-PC/AT clone FreeBSD 2.1.0R(*)
-NeXT NeXTcube(M68040-25) NEXTSTEP 3.3J(*)
Non-Unix
systems:
-SHARP X68030 + Human68k 3.02
-PC/AT clone Windows NT 3.51(Intel)(work on DOS prompt)
-PC/AT clone Windows 95(work on DOS prompt)
-PC/AT clone OS/2 Warp 3.0(Intel)(work on DOS prompt)
Systems marked with (*) need the hardware hack described under BUGS above.
SPECIAL THANKS
Bob Hepple <bhepple [AT] pacific.sg> (Thanks for this man page.)
SEE ALSO
qvrec(1), qvalldel(1), cam2jpeg(1) by Jun-ichiro "itojun" Itoh <itojun [AT] csl.jp>.
camtoppm.pl(1) by Shuji Senda <senda [AT] kuis.jp>.