Libav 0.7.1
libavdevice/libdc1394.c
Go to the documentation of this file.
00001 /*
00002  * IIDC1394 grab interface (uses libdc1394 and libraw1394)
00003  * Copyright (c) 2004 Roman Shaposhnik
00004  * Copyright (c) 2008 Alessandro Sappia
00005  *
00006  * This file is part of Libav.
00007  *
00008  * Libav is free software; you can redistribute it and/or
00009  * modify it under the terms of the GNU Lesser General Public
00010  * License as published by the Free Software Foundation; either
00011  * version 2.1 of the License, or (at your option) any later version.
00012  *
00013  * Libav is distributed in the hope that it will be useful,
00014  * but WITHOUT ANY WARRANTY; without even the implied warranty of
00015  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
00016  * Lesser General Public License for more details.
00017  *
00018  * You should have received a copy of the GNU Lesser General Public
00019  * License along with Libav; if not, write to the Free Software
00020  * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
00021  */
00022 
00023 #include "config.h"
00024 #include "libavformat/avformat.h"
00025 #include "libavutil/log.h"
00026 #include "libavutil/opt.h"
00027 #include "libavutil/parseutils.h"
00028 #include "libavutil/pixdesc.h"
00029 
00030 #if HAVE_LIBDC1394_2
00031 #include <dc1394/dc1394.h>
00032 #elif HAVE_LIBDC1394_1
00033 #include <libraw1394/raw1394.h>
00034 #include <libdc1394/dc1394_control.h>
00035 
00036 #define DC1394_VIDEO_MODE_320x240_YUV422 MODE_320x240_YUV422
00037 #define DC1394_VIDEO_MODE_640x480_YUV411 MODE_640x480_YUV411
00038 #define DC1394_VIDEO_MODE_640x480_YUV422 MODE_640x480_YUV422
00039 #define DC1394_FRAMERATE_1_875 FRAMERATE_1_875
00040 #define DC1394_FRAMERATE_3_75  FRAMERATE_3_75
00041 #define DC1394_FRAMERATE_7_5   FRAMERATE_7_5
00042 #define DC1394_FRAMERATE_15    FRAMERATE_15
00043 #define DC1394_FRAMERATE_30    FRAMERATE_30
00044 #define DC1394_FRAMERATE_60    FRAMERATE_60
00045 #define DC1394_FRAMERATE_120   FRAMERATE_120
00046 #define DC1394_FRAMERATE_240   FRAMERATE_240
00047 #endif
00048 
00049 #undef free
00050 
00051 typedef struct dc1394_data {
00052     AVClass *class;
00053 #if HAVE_LIBDC1394_1
00054     raw1394handle_t handle;
00055     dc1394_cameracapture camera;
00056     int channel;
00057 #elif HAVE_LIBDC1394_2
00058     dc1394_t *d;
00059     dc1394camera_t *camera;
00060     dc1394video_frame_t *frame;
00061 #endif
00062     int current_frame;
00063     int  frame_rate;        
00064     char *video_size;       
00065     char *pixel_format;     
00066     char *framerate;        
00068     AVPacket packet;
00069 } dc1394_data;
00070 
00071 struct dc1394_frame_format {
00072     int width;
00073     int height;
00074     enum PixelFormat pix_fmt;
00075     int frame_size_id;
00076 } dc1394_frame_formats[] = {
00077     { 320, 240, PIX_FMT_UYVY422, DC1394_VIDEO_MODE_320x240_YUV422 },
00078     { 640, 480, PIX_FMT_UYYVYY411, DC1394_VIDEO_MODE_640x480_YUV411 },
00079     { 640, 480, PIX_FMT_UYVY422, DC1394_VIDEO_MODE_640x480_YUV422 },
00080     { 0, 0, 0, 0 } /* gotta be the last one */
00081 };
00082 
00083 struct dc1394_frame_rate {
00084     int frame_rate;
00085     int frame_rate_id;
00086 } dc1394_frame_rates[] = {
00087     {  1875, DC1394_FRAMERATE_1_875 },
00088     {  3750, DC1394_FRAMERATE_3_75  },
00089     {  7500, DC1394_FRAMERATE_7_5   },
00090     { 15000, DC1394_FRAMERATE_15    },
00091     { 30000, DC1394_FRAMERATE_30    },
00092     { 60000, DC1394_FRAMERATE_60    },
00093     {120000, DC1394_FRAMERATE_120   },
00094     {240000, DC1394_FRAMERATE_240    },
00095     { 0, 0 } /* gotta be the last one */
00096 };
00097 
00098 #define OFFSET(x) offsetof(dc1394_data, x)
00099 #define DEC AV_OPT_FLAG_DECODING_PARAM
00100 static const AVOption options[] = {
00101 #if HAVE_LIBDC1394_1
00102     { "channel", "", offsetof(dc1394_data, channel), FF_OPT_TYPE_INT, {.dbl = 0}, 0, INT_MAX, AV_OPT_FLAG_DECODING_PARAM },
00103 #endif
00104     { "video_size", "A string describing frame size, such as 640x480 or hd720.", OFFSET(video_size), FF_OPT_TYPE_STRING, {.str = "qvga"}, 0, 0, DEC },
00105     { "pixel_format", "", OFFSET(pixel_format), FF_OPT_TYPE_STRING, {.str = "uyvy422"}, 0, 0, DEC },
00106     { "framerate", "", OFFSET(framerate), FF_OPT_TYPE_STRING, {.str = "ntsc"}, 0, 0, DEC },
00107     { NULL },
00108 };
00109 
00110 static const AVClass libdc1394_class = {
00111     .class_name = "libdc1394 indev",
00112     .item_name  = av_default_item_name,
00113     .option     = options,
00114     .version    = LIBAVUTIL_VERSION_INT,
00115 };
00116 
00117 
00118 static inline int dc1394_read_common(AVFormatContext *c, AVFormatParameters *ap,
00119                                      struct dc1394_frame_format **select_fmt, struct dc1394_frame_rate **select_fps)
00120 {
00121     dc1394_data* dc1394 = c->priv_data;
00122     AVStream* vst;
00123     struct dc1394_frame_format *fmt;
00124     struct dc1394_frame_rate *fps;
00125     enum PixelFormat pix_fmt;
00126     int width, height;
00127     AVRational framerate;
00128     int ret = 0;
00129 
00130     if ((pix_fmt = av_get_pix_fmt(dc1394->pixel_format)) == PIX_FMT_NONE) {
00131         av_log(c, AV_LOG_ERROR, "No such pixel format: %s.\n", dc1394->pixel_format);
00132         ret = AVERROR(EINVAL);
00133         goto out;
00134     }
00135 
00136     if ((ret = av_parse_video_size(&width, &height, dc1394->video_size)) < 0) {
00137         av_log(c, AV_LOG_ERROR, "Couldn't parse video size.\n");
00138         goto out;
00139     }
00140     if ((ret = av_parse_video_rate(&framerate, dc1394->framerate)) < 0) {
00141         av_log(c, AV_LOG_ERROR, "Couldn't parse framerate.\n");
00142         goto out;
00143     }
00144 #if FF_API_FORMAT_PARAMETERS
00145     if (ap->width > 0)
00146         width = ap->width;
00147     if (ap->height > 0)
00148         height = ap->height;
00149     if (ap->pix_fmt)
00150         pix_fmt = ap->pix_fmt;
00151     if (ap->time_base.num)
00152         framerate = (AVRational){ap->time_base.den, ap->time_base.num};
00153 #endif
00154     dc1394->frame_rate = av_rescale(1000, framerate.num, framerate.den);
00155 
00156     for (fmt = dc1394_frame_formats; fmt->width; fmt++)
00157          if (fmt->pix_fmt == pix_fmt && fmt->width == width && fmt->height == height)
00158              break;
00159 
00160     for (fps = dc1394_frame_rates; fps->frame_rate; fps++)
00161          if (fps->frame_rate == dc1394->frame_rate)
00162              break;
00163 
00164     if (!fps->frame_rate || !fmt->width) {
00165         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),
00166                                                                                                 width, height, dc1394->frame_rate);
00167         ret = AVERROR(EINVAL);
00168         goto out;
00169     }
00170 
00171     /* create a video stream */
00172     vst = av_new_stream(c, 0);
00173     if (!vst) {
00174         ret = AVERROR(ENOMEM);
00175         goto out;
00176     }
00177     av_set_pts_info(vst, 64, 1, 1000);
00178     vst->codec->codec_type = AVMEDIA_TYPE_VIDEO;
00179     vst->codec->codec_id = CODEC_ID_RAWVIDEO;
00180     vst->codec->time_base.den = framerate.num;
00181     vst->codec->time_base.num = framerate.den;
00182     vst->codec->width = fmt->width;
00183     vst->codec->height = fmt->height;
00184     vst->codec->pix_fmt = fmt->pix_fmt;
00185 
00186     /* packet init */
00187     av_init_packet(&dc1394->packet);
00188     dc1394->packet.size = avpicture_get_size(fmt->pix_fmt, fmt->width, fmt->height);
00189     dc1394->packet.stream_index = vst->index;
00190     dc1394->packet.flags |= AV_PKT_FLAG_KEY;
00191 
00192     dc1394->current_frame = 0;
00193 
00194     vst->codec->bit_rate = av_rescale(dc1394->packet.size * 8, fps->frame_rate, 1000);
00195     *select_fps = fps;
00196     *select_fmt = fmt;
00197 out:
00198     return ret;
00199 }
00200 
00201 #if HAVE_LIBDC1394_1
00202 static int dc1394_v1_read_header(AVFormatContext *c, AVFormatParameters * ap)
00203 {
00204     dc1394_data* dc1394 = c->priv_data;
00205     AVStream* vst;
00206     nodeid_t* camera_nodes;
00207     int res;
00208     struct dc1394_frame_format *fmt = NULL;
00209     struct dc1394_frame_rate *fps = NULL;
00210 
00211     if (dc1394_read_common(c,ap,&fmt,&fps) != 0)
00212         return -1;
00213 
00214 #if FF_API_FORMAT_PARAMETERS
00215     if (ap->channel)
00216         dc1394->channel = ap->channel;
00217 #endif
00218 
00219     /* Now let us prep the hardware. */
00220     dc1394->handle = dc1394_create_handle(0); /* FIXME: gotta have ap->port */
00221     if (!dc1394->handle) {
00222         av_log(c, AV_LOG_ERROR, "Can't acquire dc1394 handle on port %d\n", 0 /* ap->port */);
00223         goto out;
00224     }
00225     camera_nodes = dc1394_get_camera_nodes(dc1394->handle, &res, 1);
00226     if (!camera_nodes || camera_nodes[dc1394->channel] == DC1394_NO_CAMERA) {
00227         av_log(c, AV_LOG_ERROR, "There's no IIDC camera on the channel %d\n", dc1394->channel);
00228         goto out_handle;
00229     }
00230     res = dc1394_dma_setup_capture(dc1394->handle, camera_nodes[dc1394->channel],
00231                                    0,
00232                                    FORMAT_VGA_NONCOMPRESSED,
00233                                    fmt->frame_size_id,
00234                                    SPEED_400,
00235                                    fps->frame_rate_id, 8, 1,
00236                                    c->filename,
00237                                    &dc1394->camera);
00238     dc1394_free_camera_nodes(camera_nodes);
00239     if (res != DC1394_SUCCESS) {
00240         av_log(c, AV_LOG_ERROR, "Can't prepare camera for the DMA capture\n");
00241         goto out_handle;
00242     }
00243 
00244     res = dc1394_start_iso_transmission(dc1394->handle, dc1394->camera.node);
00245     if (res != DC1394_SUCCESS) {
00246         av_log(c, AV_LOG_ERROR, "Can't start isochronous transmission\n");
00247         goto out_handle_dma;
00248     }
00249 
00250     return 0;
00251 
00252 out_handle_dma:
00253     dc1394_dma_unlisten(dc1394->handle, &dc1394->camera);
00254     dc1394_dma_release_camera(dc1394->handle, &dc1394->camera);
00255 out_handle:
00256     dc1394_destroy_handle(dc1394->handle);
00257 out:
00258     return -1;
00259 }
00260 
00261 static int dc1394_v1_read_packet(AVFormatContext *c, AVPacket *pkt)
00262 {
00263     struct dc1394_data *dc1394 = c->priv_data;
00264     int res;
00265 
00266     /* discard stale frame */
00267     if (dc1394->current_frame++) {
00268         if (dc1394_dma_done_with_buffer(&dc1394->camera) != DC1394_SUCCESS)
00269             av_log(c, AV_LOG_ERROR, "failed to release %d frame\n", dc1394->current_frame);
00270     }
00271 
00272     res = dc1394_dma_single_capture(&dc1394->camera);
00273 
00274     if (res == DC1394_SUCCESS) {
00275         dc1394->packet.data = (uint8_t *)(dc1394->camera.capture_buffer);
00276         dc1394->packet.pts = (dc1394->current_frame * 1000000) / dc1394->frame_rate;
00277         res = dc1394->packet.size;
00278     } else {
00279         av_log(c, AV_LOG_ERROR, "DMA capture failed\n");
00280         dc1394->packet.data = NULL;
00281         res = -1;
00282     }
00283 
00284     *pkt = dc1394->packet;
00285     return res;
00286 }
00287 
00288 static int dc1394_v1_close(AVFormatContext * context)
00289 {
00290     struct dc1394_data *dc1394 = context->priv_data;
00291 
00292     dc1394_stop_iso_transmission(dc1394->handle, dc1394->camera.node);
00293     dc1394_dma_unlisten(dc1394->handle, &dc1394->camera);
00294     dc1394_dma_release_camera(dc1394->handle, &dc1394->camera);
00295     dc1394_destroy_handle(dc1394->handle);
00296 
00297     return 0;
00298 }
00299 
00300 #elif HAVE_LIBDC1394_2
00301 static int dc1394_v2_read_header(AVFormatContext *c, AVFormatParameters * ap)
00302 {
00303     dc1394_data* dc1394 = c->priv_data;
00304     dc1394camera_list_t *list;
00305     int res, i;
00306     struct dc1394_frame_format *fmt = NULL;
00307     struct dc1394_frame_rate *fps = NULL;
00308 
00309     if (dc1394_read_common(c,ap,&fmt,&fps) != 0)
00310        return -1;
00311 
00312     /* Now let us prep the hardware. */
00313     dc1394->d = dc1394_new();
00314     dc1394_camera_enumerate (dc1394->d, &list);
00315     if ( !list || list->num == 0) {
00316         av_log(c, AV_LOG_ERROR, "Unable to look for an IIDC camera\n\n");
00317         goto out;
00318     }
00319 
00320     /* FIXME: To select a specific camera I need to search in list its guid */
00321     dc1394->camera = dc1394_camera_new (dc1394->d, list->ids[0].guid);
00322     if (list->num > 1) {
00323         av_log(c, AV_LOG_INFO, "Working with the first camera found\n");
00324     }
00325 
00326     /* Freeing list of cameras */
00327     dc1394_camera_free_list (list);
00328 
00329     /* Select MAX Speed possible from the cam */
00330     if (dc1394->camera->bmode_capable>0) {
00331        dc1394_video_set_operation_mode(dc1394->camera, DC1394_OPERATION_MODE_1394B);
00332        i = DC1394_ISO_SPEED_800;
00333     } else {
00334        i = DC1394_ISO_SPEED_400;
00335     }
00336 
00337     for (res = DC1394_FAILURE; i >= DC1394_ISO_SPEED_MIN && res != DC1394_SUCCESS; i--) {
00338             res=dc1394_video_set_iso_speed(dc1394->camera, i);
00339     }
00340     if (res != DC1394_SUCCESS) {
00341         av_log(c, AV_LOG_ERROR, "Couldn't set ISO Speed\n");
00342         goto out_camera;
00343     }
00344 
00345     if (dc1394_video_set_mode(dc1394->camera, fmt->frame_size_id) != DC1394_SUCCESS) {
00346         av_log(c, AV_LOG_ERROR, "Couldn't set video format\n");
00347         goto out_camera;
00348     }
00349 
00350     if (dc1394_video_set_framerate(dc1394->camera,fps->frame_rate_id) != DC1394_SUCCESS) {
00351         av_log(c, AV_LOG_ERROR, "Couldn't set framerate %d \n",fps->frame_rate);
00352         goto out_camera;
00353     }
00354     if (dc1394_capture_setup(dc1394->camera, 10, DC1394_CAPTURE_FLAGS_DEFAULT)!=DC1394_SUCCESS) {
00355         av_log(c, AV_LOG_ERROR, "Cannot setup camera \n");
00356         goto out_camera;
00357     }
00358 
00359     if (dc1394_video_set_transmission(dc1394->camera, DC1394_ON) !=DC1394_SUCCESS) {
00360         av_log(c, AV_LOG_ERROR, "Cannot start capture\n");
00361         goto out_camera;
00362     }
00363     return 0;
00364 
00365 out_camera:
00366     dc1394_capture_stop(dc1394->camera);
00367     dc1394_video_set_transmission(dc1394->camera, DC1394_OFF);
00368     dc1394_camera_free (dc1394->camera);
00369 out:
00370     dc1394_free(dc1394->d);
00371     return -1;
00372 }
00373 
00374 static int dc1394_v2_read_packet(AVFormatContext *c, AVPacket *pkt)
00375 {
00376     struct dc1394_data *dc1394 = c->priv_data;
00377     int res;
00378 
00379     /* discard stale frame */
00380     if (dc1394->current_frame++) {
00381         if (dc1394_capture_enqueue(dc1394->camera, dc1394->frame) != DC1394_SUCCESS)
00382             av_log(c, AV_LOG_ERROR, "failed to release %d frame\n", dc1394->current_frame);
00383     }
00384 
00385     res = dc1394_capture_dequeue(dc1394->camera, DC1394_CAPTURE_POLICY_WAIT, &dc1394->frame);
00386     if (res == DC1394_SUCCESS) {
00387         dc1394->packet.data = (uint8_t *)(dc1394->frame->image);
00388         dc1394->packet.pts = (dc1394->current_frame  * 1000000) / (dc1394->frame_rate);
00389         res = dc1394->frame->image_bytes;
00390     } else {
00391         av_log(c, AV_LOG_ERROR, "DMA capture failed\n");
00392         dc1394->packet.data = NULL;
00393         res = -1;
00394     }
00395 
00396     *pkt = dc1394->packet;
00397     return res;
00398 }
00399 
00400 static int dc1394_v2_close(AVFormatContext * context)
00401 {
00402     struct dc1394_data *dc1394 = context->priv_data;
00403 
00404     dc1394_video_set_transmission(dc1394->camera, DC1394_OFF);
00405     dc1394_capture_stop(dc1394->camera);
00406     dc1394_camera_free(dc1394->camera);
00407     dc1394_free(dc1394->d);
00408 
00409     return 0;
00410 }
00411 
00412 AVInputFormat ff_libdc1394_demuxer = {
00413     .name           = "libdc1394",
00414     .long_name      = NULL_IF_CONFIG_SMALL("dc1394 v.2 A/V grab"),
00415     .priv_data_size = sizeof(struct dc1394_data),
00416     .read_header    = dc1394_v2_read_header,
00417     .read_packet    = dc1394_v2_read_packet,
00418     .read_close     = dc1394_v2_close,
00419     .flags          = AVFMT_NOFILE,
00420     .priv_class     = &libdc1394_class,
00421 };
00422 
00423 #endif
00424 #if HAVE_LIBDC1394_1
00425 AVInputFormat ff_libdc1394_demuxer = {
00426     .name           = "libdc1394",
00427     .long_name      = NULL_IF_CONFIG_SMALL("dc1394 v.1 A/V grab"),
00428     .priv_data_size = sizeof(struct dc1394_data),
00429     .read_header    = dc1394_v1_read_header,
00430     .read_packet    = dc1394_v1_read_packet,
00431     .read_close     = dc1394_v1_close,
00432     .flags          = AVFMT_NOFILE,
00433     .priv_class     = &libdc1394_class,
00434 };
00435 #endif