2 * IIDC1394 grab interface (uses libdc1394 and libraw1394)
3 * Copyright (c) 2004 Roman Shaposhnik
4 * Copyright (c) 2008 Alessandro Sappia
6 * This file is part of Libav.
8 * Libav is free software; you can redistribute it and/or
9 * modify it under the terms of the GNU Lesser General Public
10 * License as published by the Free Software Foundation; either
11 * version 2.1 of the License, or (at your option) any later version.
13 * Libav is distributed in the hope that it will be useful,
14 * but WITHOUT ANY WARRANTY; without even the implied warranty of
15 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
16 * Lesser General Public License for more details.
18 * You should have received a copy of the GNU Lesser General Public
19 * License along with Libav; if not, write to the Free Software
20 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
24 #include "libavformat/avformat.h"
25 #include "libavutil/log.h"
26 #include "libavutil/mathematics.h"
27 #include "libavutil/opt.h"
28 #include "libavutil/parseutils.h"
29 #include "libavutil/pixdesc.h"
32 #include <dc1394/dc1394.h>
33 #elif HAVE_LIBDC1394_1
34 #include <libraw1394/raw1394.h>
35 #include <libdc1394/dc1394_control.h>
37 #define DC1394_VIDEO_MODE_320x240_YUV422 MODE_320x240_YUV422
38 #define DC1394_VIDEO_MODE_640x480_YUV411 MODE_640x480_YUV411
39 #define DC1394_VIDEO_MODE_640x480_YUV422 MODE_640x480_YUV422
40 #define DC1394_FRAMERATE_1_875 FRAMERATE_1_875
41 #define DC1394_FRAMERATE_3_75 FRAMERATE_3_75
42 #define DC1394_FRAMERATE_7_5 FRAMERATE_7_5
43 #define DC1394_FRAMERATE_15 FRAMERATE_15
44 #define DC1394_FRAMERATE_30 FRAMERATE_30
45 #define DC1394_FRAMERATE_60 FRAMERATE_60
46 #define DC1394_FRAMERATE_120 FRAMERATE_120
47 #define DC1394_FRAMERATE_240 FRAMERATE_240
52 typedef struct dc1394_data {
55 raw1394handle_t handle;
56 dc1394_cameracapture camera;
58 #elif HAVE_LIBDC1394_2
60 dc1394camera_t *camera;
61 dc1394video_frame_t *frame;
64 int frame_rate; /**< frames per 1000 seconds (fps * 1000) */
65 char *video_size; /**< String describing video size, set by a private option. */
66 char *pixel_format; /**< Set by a private option. */
67 char *framerate; /**< Set by a private option. */
72 struct dc1394_frame_format {
75 enum PixelFormat pix_fmt;
77 } dc1394_frame_formats[] = {
78 { 320, 240, PIX_FMT_UYVY422, DC1394_VIDEO_MODE_320x240_YUV422 },
79 { 640, 480, PIX_FMT_UYYVYY411, DC1394_VIDEO_MODE_640x480_YUV411 },
80 { 640, 480, PIX_FMT_UYVY422, DC1394_VIDEO_MODE_640x480_YUV422 },
81 { 0, 0, 0, 0 } /* gotta be the last one */
84 struct dc1394_frame_rate {
87 } dc1394_frame_rates[] = {
88 { 1875, DC1394_FRAMERATE_1_875 },
89 { 3750, DC1394_FRAMERATE_3_75 },
90 { 7500, DC1394_FRAMERATE_7_5 },
91 { 15000, DC1394_FRAMERATE_15 },
92 { 30000, DC1394_FRAMERATE_30 },
93 { 60000, DC1394_FRAMERATE_60 },
94 {120000, DC1394_FRAMERATE_120 },
95 {240000, DC1394_FRAMERATE_240 },
96 { 0, 0 } /* gotta be the last one */
99 #define OFFSET(x) offsetof(dc1394_data, x)
100 #define DEC AV_OPT_FLAG_DECODING_PARAM
101 static const AVOption options[] = {
103 { "channel", "", offsetof(dc1394_data, channel), FF_OPT_TYPE_INT, {.dbl = 0}, 0, INT_MAX, AV_OPT_FLAG_DECODING_PARAM },
105 { "video_size", "A string describing frame size, such as 640x480 or hd720.", OFFSET(video_size), FF_OPT_TYPE_STRING, {.str = "qvga"}, 0, 0, DEC },
106 { "pixel_format", "", OFFSET(pixel_format), FF_OPT_TYPE_STRING, {.str = "uyvy422"}, 0, 0, DEC },
107 { "framerate", "", OFFSET(framerate), FF_OPT_TYPE_STRING, {.str = "ntsc"}, 0, 0, DEC },
111 static const AVClass libdc1394_class = {
112 .class_name = "libdc1394 indev",
113 .item_name = av_default_item_name,
115 .version = LIBAVUTIL_VERSION_INT,
119 static inline int dc1394_read_common(AVFormatContext *c, AVFormatParameters *ap,
120 struct dc1394_frame_format **select_fmt, struct dc1394_frame_rate **select_fps)
122 dc1394_data* dc1394 = c->priv_data;
124 struct dc1394_frame_format *fmt;
125 struct dc1394_frame_rate *fps;
126 enum PixelFormat pix_fmt;
128 AVRational framerate;
131 if ((pix_fmt = av_get_pix_fmt(dc1394->pixel_format)) == PIX_FMT_NONE) {
132 av_log(c, AV_LOG_ERROR, "No such pixel format: %s.\n", dc1394->pixel_format);
133 ret = AVERROR(EINVAL);
137 if ((ret = av_parse_video_size(&width, &height, dc1394->video_size)) < 0) {
138 av_log(c, AV_LOG_ERROR, "Could not parse video size '%s'.\n", dc1394->video_size);
141 if ((ret = av_parse_video_rate(&framerate, dc1394->framerate)) < 0) {
142 av_log(c, AV_LOG_ERROR, "Could not parse framerate '%s'.\n", dc1394->framerate);
145 #if FF_API_FORMAT_PARAMETERS
151 pix_fmt = ap->pix_fmt;
152 if (ap->time_base.num)
153 framerate = (AVRational){ap->time_base.den, ap->time_base.num};
155 dc1394->frame_rate = av_rescale(1000, framerate.num, framerate.den);
157 for (fmt = dc1394_frame_formats; fmt->width; fmt++)
158 if (fmt->pix_fmt == pix_fmt && fmt->width == width && fmt->height == height)
161 for (fps = dc1394_frame_rates; fps->frame_rate; fps++)
162 if (fps->frame_rate == dc1394->frame_rate)
165 if (!fps->frame_rate || !fmt->width) {
166 av_log(c, AV_LOG_ERROR, "Can't find matching camera format for %s, %dx%d@%d:1000fps\n", av_get_pix_fmt_name(pix_fmt),
167 width, height, dc1394->frame_rate);
168 ret = AVERROR(EINVAL);
172 /* create a video stream */
173 vst = av_new_stream(c, 0);
175 ret = AVERROR(ENOMEM);
178 av_set_pts_info(vst, 64, 1, 1000);
179 vst->codec->codec_type = AVMEDIA_TYPE_VIDEO;
180 vst->codec->codec_id = CODEC_ID_RAWVIDEO;
181 vst->codec->time_base.den = framerate.num;
182 vst->codec->time_base.num = framerate.den;
183 vst->codec->width = fmt->width;
184 vst->codec->height = fmt->height;
185 vst->codec->pix_fmt = fmt->pix_fmt;
188 av_init_packet(&dc1394->packet);
189 dc1394->packet.size = avpicture_get_size(fmt->pix_fmt, fmt->width, fmt->height);
190 dc1394->packet.stream_index = vst->index;
191 dc1394->packet.flags |= AV_PKT_FLAG_KEY;
193 dc1394->current_frame = 0;
195 vst->codec->bit_rate = av_rescale(dc1394->packet.size * 8, fps->frame_rate, 1000);
203 static int dc1394_v1_read_header(AVFormatContext *c, AVFormatParameters * ap)
205 dc1394_data* dc1394 = c->priv_data;
207 nodeid_t* camera_nodes;
209 struct dc1394_frame_format *fmt = NULL;
210 struct dc1394_frame_rate *fps = NULL;
212 if (dc1394_read_common(c,ap,&fmt,&fps) != 0)
215 #if FF_API_FORMAT_PARAMETERS
217 dc1394->channel = ap->channel;
220 /* Now let us prep the hardware. */
221 dc1394->handle = dc1394_create_handle(0); /* FIXME: gotta have ap->port */
222 if (!dc1394->handle) {
223 av_log(c, AV_LOG_ERROR, "Can't acquire dc1394 handle on port %d\n", 0 /* ap->port */);
226 camera_nodes = dc1394_get_camera_nodes(dc1394->handle, &res, 1);
227 if (!camera_nodes || camera_nodes[dc1394->channel] == DC1394_NO_CAMERA) {
228 av_log(c, AV_LOG_ERROR, "There's no IIDC camera on the channel %d\n", dc1394->channel);
231 res = dc1394_dma_setup_capture(dc1394->handle, camera_nodes[dc1394->channel],
233 FORMAT_VGA_NONCOMPRESSED,
236 fps->frame_rate_id, 8, 1,
239 dc1394_free_camera_nodes(camera_nodes);
240 if (res != DC1394_SUCCESS) {
241 av_log(c, AV_LOG_ERROR, "Can't prepare camera for the DMA capture\n");
245 res = dc1394_start_iso_transmission(dc1394->handle, dc1394->camera.node);
246 if (res != DC1394_SUCCESS) {
247 av_log(c, AV_LOG_ERROR, "Can't start isochronous transmission\n");
254 dc1394_dma_unlisten(dc1394->handle, &dc1394->camera);
255 dc1394_dma_release_camera(dc1394->handle, &dc1394->camera);
257 dc1394_destroy_handle(dc1394->handle);
262 static int dc1394_v1_read_packet(AVFormatContext *c, AVPacket *pkt)
264 struct dc1394_data *dc1394 = c->priv_data;
267 /* discard stale frame */
268 if (dc1394->current_frame++) {
269 if (dc1394_dma_done_with_buffer(&dc1394->camera) != DC1394_SUCCESS)
270 av_log(c, AV_LOG_ERROR, "failed to release %d frame\n", dc1394->current_frame);
273 res = dc1394_dma_single_capture(&dc1394->camera);
275 if (res == DC1394_SUCCESS) {
276 dc1394->packet.data = (uint8_t *)(dc1394->camera.capture_buffer);
277 dc1394->packet.pts = (dc1394->current_frame * 1000000) / dc1394->frame_rate;
278 res = dc1394->packet.size;
280 av_log(c, AV_LOG_ERROR, "DMA capture failed\n");
281 dc1394->packet.data = NULL;
285 *pkt = dc1394->packet;
289 static int dc1394_v1_close(AVFormatContext * context)
291 struct dc1394_data *dc1394 = context->priv_data;
293 dc1394_stop_iso_transmission(dc1394->handle, dc1394->camera.node);
294 dc1394_dma_unlisten(dc1394->handle, &dc1394->camera);
295 dc1394_dma_release_camera(dc1394->handle, &dc1394->camera);
296 dc1394_destroy_handle(dc1394->handle);
301 #elif HAVE_LIBDC1394_2
302 static int dc1394_v2_read_header(AVFormatContext *c, AVFormatParameters * ap)
304 dc1394_data* dc1394 = c->priv_data;
305 dc1394camera_list_t *list;
307 struct dc1394_frame_format *fmt = NULL;
308 struct dc1394_frame_rate *fps = NULL;
310 if (dc1394_read_common(c,ap,&fmt,&fps) != 0)
313 /* Now let us prep the hardware. */
314 dc1394->d = dc1394_new();
315 dc1394_camera_enumerate (dc1394->d, &list);
316 if ( !list || list->num == 0) {
317 av_log(c, AV_LOG_ERROR, "Unable to look for an IIDC camera\n\n");
321 /* FIXME: To select a specific camera I need to search in list its guid */
322 dc1394->camera = dc1394_camera_new (dc1394->d, list->ids[0].guid);
324 av_log(c, AV_LOG_INFO, "Working with the first camera found\n");
327 /* Freeing list of cameras */
328 dc1394_camera_free_list (list);
330 /* Select MAX Speed possible from the cam */
331 if (dc1394->camera->bmode_capable>0) {
332 dc1394_video_set_operation_mode(dc1394->camera, DC1394_OPERATION_MODE_1394B);
333 i = DC1394_ISO_SPEED_800;
335 i = DC1394_ISO_SPEED_400;
338 for (res = DC1394_FAILURE; i >= DC1394_ISO_SPEED_MIN && res != DC1394_SUCCESS; i--) {
339 res=dc1394_video_set_iso_speed(dc1394->camera, i);
341 if (res != DC1394_SUCCESS) {
342 av_log(c, AV_LOG_ERROR, "Couldn't set ISO Speed\n");
346 if (dc1394_video_set_mode(dc1394->camera, fmt->frame_size_id) != DC1394_SUCCESS) {
347 av_log(c, AV_LOG_ERROR, "Couldn't set video format\n");
351 if (dc1394_video_set_framerate(dc1394->camera,fps->frame_rate_id) != DC1394_SUCCESS) {
352 av_log(c, AV_LOG_ERROR, "Couldn't set framerate %d \n",fps->frame_rate);
355 if (dc1394_capture_setup(dc1394->camera, 10, DC1394_CAPTURE_FLAGS_DEFAULT)!=DC1394_SUCCESS) {
356 av_log(c, AV_LOG_ERROR, "Cannot setup camera \n");
360 if (dc1394_video_set_transmission(dc1394->camera, DC1394_ON) !=DC1394_SUCCESS) {
361 av_log(c, AV_LOG_ERROR, "Cannot start capture\n");
367 dc1394_capture_stop(dc1394->camera);
368 dc1394_video_set_transmission(dc1394->camera, DC1394_OFF);
369 dc1394_camera_free (dc1394->camera);
371 dc1394_free(dc1394->d);
375 static int dc1394_v2_read_packet(AVFormatContext *c, AVPacket *pkt)
377 struct dc1394_data *dc1394 = c->priv_data;
380 /* discard stale frame */
381 if (dc1394->current_frame++) {
382 if (dc1394_capture_enqueue(dc1394->camera, dc1394->frame) != DC1394_SUCCESS)
383 av_log(c, AV_LOG_ERROR, "failed to release %d frame\n", dc1394->current_frame);
386 res = dc1394_capture_dequeue(dc1394->camera, DC1394_CAPTURE_POLICY_WAIT, &dc1394->frame);
387 if (res == DC1394_SUCCESS) {
388 dc1394->packet.data = (uint8_t *)(dc1394->frame->image);
389 dc1394->packet.pts = (dc1394->current_frame * 1000000) / (dc1394->frame_rate);
390 res = dc1394->frame->image_bytes;
392 av_log(c, AV_LOG_ERROR, "DMA capture failed\n");
393 dc1394->packet.data = NULL;
397 *pkt = dc1394->packet;
401 static int dc1394_v2_close(AVFormatContext * context)
403 struct dc1394_data *dc1394 = context->priv_data;
405 dc1394_video_set_transmission(dc1394->camera, DC1394_OFF);
406 dc1394_capture_stop(dc1394->camera);
407 dc1394_camera_free(dc1394->camera);
408 dc1394_free(dc1394->d);
413 AVInputFormat ff_libdc1394_demuxer = {
415 .long_name = NULL_IF_CONFIG_SMALL("dc1394 v.2 A/V grab"),
416 .priv_data_size = sizeof(struct dc1394_data),
417 .read_header = dc1394_v2_read_header,
418 .read_packet = dc1394_v2_read_packet,
419 .read_close = dc1394_v2_close,
420 .flags = AVFMT_NOFILE,
421 .priv_class = &libdc1394_class,
426 AVInputFormat ff_libdc1394_demuxer = {
428 .long_name = NULL_IF_CONFIG_SMALL("dc1394 v.1 A/V grab"),
429 .priv_data_size = sizeof(struct dc1394_data),
430 .read_header = dc1394_v1_read_header,
431 .read_packet = dc1394_v1_read_packet,
432 .read_close = dc1394_v1_close,
433 .flags = AVFMT_NOFILE,
434 .priv_class = &libdc1394_class,