Libav
bktr.c
Go to the documentation of this file.
1 /*
2  * *BSD video grab interface
3  * Copyright (c) 2002 Steve O'Hara-Smith
4  * based on
5  * Linux video grab interface
6  * Copyright (c) 2000,2001 Gerard Lantau
7  * and
8  * simple_grab.c Copyright (c) 1999 Roger Hardiman
9  *
10  * This file is part of Libav.
11  *
12  * Libav is free software; you can redistribute it and/or
13  * modify it under the terms of the GNU Lesser General Public
14  * License as published by the Free Software Foundation; either
15  * version 2.1 of the License, or (at your option) any later version.
16  *
17  * Libav is distributed in the hope that it will be useful,
18  * but WITHOUT ANY WARRANTY; without even the implied warranty of
19  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
20  * Lesser General Public License for more details.
21  *
22  * You should have received a copy of the GNU Lesser General Public
23  * License along with Libav; if not, write to the Free Software
24  * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
25  */
26 
27 #include "libavformat/avformat.h"
28 #include "libavformat/internal.h"
29 #include "libavutil/internal.h"
30 #include "libavutil/log.h"
31 #include "libavutil/opt.h"
32 #include "libavutil/parseutils.h"
33 #include "libavutil/time.h"
34 #if HAVE_DEV_BKTR_IOCTL_METEOR_H && HAVE_DEV_BKTR_IOCTL_BT848_H
35 # include <dev/bktr/ioctl_meteor.h>
36 # include <dev/bktr/ioctl_bt848.h>
37 #elif HAVE_MACHINE_IOCTL_METEOR_H && HAVE_MACHINE_IOCTL_BT848_H
38 # include <machine/ioctl_meteor.h>
39 # include <machine/ioctl_bt848.h>
40 #elif HAVE_DEV_VIDEO_METEOR_IOCTL_METEOR_H && HAVE_DEV_VIDEO_BKTR_IOCTL_BT848_H
41 # include <dev/video/meteor/ioctl_meteor.h>
42 # include <dev/video/bktr/ioctl_bt848.h>
43 #elif HAVE_DEV_IC_BT8XX_H
44 # include <dev/ic/bt8xx.h>
45 #endif
46 #include <unistd.h>
47 #include <fcntl.h>
48 #include <sys/ioctl.h>
49 #include <sys/mman.h>
50 #include <sys/time.h>
51 #include <signal.h>
52 #include <stdint.h>
53 
54 typedef struct VideoData {
55  AVClass *class;
56  int video_fd;
57  int tuner_fd;
58  int width, height;
59  uint64_t per_frame;
60  int standard;
61  char *video_size;
62  char *framerate;
63 } VideoData;
64 
65 
66 #define PAL 1
67 #define PALBDGHI 1
68 #define NTSC 2
69 #define NTSCM 2
70 #define SECAM 3
71 #define PALN 4
72 #define PALM 5
73 #define NTSCJ 6
74 
75 /* PAL is 768 x 576. NTSC is 640 x 480 */
76 #define PAL_HEIGHT 576
77 #define SECAM_HEIGHT 576
78 #define NTSC_HEIGHT 480
79 
80 #ifndef VIDEO_FORMAT
81 #define VIDEO_FORMAT NTSC
82 #endif
83 
84 static int bktr_dev[] = { METEOR_DEV0, METEOR_DEV1, METEOR_DEV2,
85  METEOR_DEV3, METEOR_DEV_SVIDEO };
86 
89 uint64_t last_frame_time;
90 volatile sig_atomic_t nsignals;
91 
92 
93 static void catchsignal(int signal)
94 {
95  nsignals++;
96  return;
97 }
98 
99 static av_cold int bktr_init(const char *video_device, int width, int height,
100  int format, int *video_fd, int *tuner_fd, int idev, double frequency)
101 {
102  struct meteor_geomet geo;
103  int h_max;
104  long ioctl_frequency;
105  char *arg;
106  int c;
107  struct sigaction act = { 0 }, old;
108  int ret;
109  char errbuf[128];
110 
111  if (idev < 0 || idev > 4)
112  {
113  arg = getenv ("BKTR_DEV");
114  if (arg)
115  idev = atoi (arg);
116  if (idev < 0 || idev > 4)
117  idev = 1;
118  }
119 
120  if (format < 1 || format > 6)
121  {
122  arg = getenv ("BKTR_FORMAT");
123  if (arg)
124  format = atoi (arg);
125  if (format < 1 || format > 6)
126  format = VIDEO_FORMAT;
127  }
128 
129  if (frequency <= 0)
130  {
131  arg = getenv ("BKTR_FREQUENCY");
132  if (arg)
133  frequency = atof (arg);
134  if (frequency <= 0)
135  frequency = 0.0;
136  }
137 
138  sigemptyset(&act.sa_mask);
139  act.sa_handler = catchsignal;
140  sigaction(SIGUSR1, &act, &old);
141 
142  *tuner_fd = avpriv_open("/dev/tuner0", O_RDONLY);
143  if (*tuner_fd < 0)
144  av_log(NULL, AV_LOG_ERROR, "Warning. Tuner not opened, continuing: %s\n", strerror(errno));
145 
146  *video_fd = avpriv_open(video_device, O_RDONLY);
147  if (*video_fd < 0) {
148  ret = AVERROR(errno);
149  av_strerror(ret, errbuf, sizeof(errbuf));
150  av_log(NULL, AV_LOG_ERROR, "%s: %s\n", video_device, errbuf);
151  return ret;
152  }
153 
154  geo.rows = height;
155  geo.columns = width;
156  geo.frames = 1;
157  geo.oformat = METEOR_GEO_YUV_422 | METEOR_GEO_YUV_12;
158 
159  switch (format) {
160  case PAL: h_max = PAL_HEIGHT; c = BT848_IFORM_F_PALBDGHI; break;
161  case PALN: h_max = PAL_HEIGHT; c = BT848_IFORM_F_PALN; break;
162  case PALM: h_max = PAL_HEIGHT; c = BT848_IFORM_F_PALM; break;
163  case SECAM: h_max = SECAM_HEIGHT; c = BT848_IFORM_F_SECAM; break;
164  case NTSC: h_max = NTSC_HEIGHT; c = BT848_IFORM_F_NTSCM; break;
165  case NTSCJ: h_max = NTSC_HEIGHT; c = BT848_IFORM_F_NTSCJ; break;
166  default: h_max = PAL_HEIGHT; c = BT848_IFORM_F_PALBDGHI; break;
167  }
168 
169  if (height <= h_max / 2)
170  geo.oformat |= METEOR_GEO_EVEN_ONLY;
171 
172  if (ioctl(*video_fd, METEORSETGEO, &geo) < 0) {
173  ret = AVERROR(errno);
174  av_strerror(ret, errbuf, sizeof(errbuf));
175  av_log(NULL, AV_LOG_ERROR, "METEORSETGEO: %s\n", errbuf);
176  return ret;
177  }
178 
179  if (ioctl(*video_fd, BT848SFMT, &c) < 0) {
180  ret = AVERROR(errno);
181  av_strerror(ret, errbuf, sizeof(errbuf));
182  av_log(NULL, AV_LOG_ERROR, "BT848SFMT: %s\n", errbuf);
183  return ret;
184  }
185 
186  c = bktr_dev[idev];
187  if (ioctl(*video_fd, METEORSINPUT, &c) < 0) {
188  ret = AVERROR(errno);
189  av_strerror(ret, errbuf, sizeof(errbuf));
190  av_log(NULL, AV_LOG_ERROR, "METEORSINPUT: %s\n", errbuf);
191  return ret;
192  }
193 
194  video_buf_size = width * height * 12 / 8;
195 
196  video_buf = (uint8_t *)mmap((caddr_t)0, video_buf_size,
197  PROT_READ, MAP_SHARED, *video_fd, (off_t)0);
198  if (video_buf == MAP_FAILED) {
199  ret = AVERROR(errno);
200  av_strerror(ret, errbuf, sizeof(errbuf));
201  av_log(NULL, AV_LOG_ERROR, "mmap: %s\n", errbuf);
202  return ret;
203  }
204 
205  if (frequency != 0.0) {
206  ioctl_frequency = (unsigned long)(frequency*16);
207  if (ioctl(*tuner_fd, TVTUNER_SETFREQ, &ioctl_frequency) < 0)
208  av_log(NULL, AV_LOG_ERROR, "TVTUNER_SETFREQ: %s\n", strerror(errno));
209  }
210 
211  c = AUDIO_UNMUTE;
212  if (ioctl(*tuner_fd, BT848_SAUDIO, &c) < 0)
213  av_log(NULL, AV_LOG_ERROR, "TVTUNER_SAUDIO: %s\n", strerror(errno));
214 
215  c = METEOR_CAP_CONTINOUS;
216  ioctl(*video_fd, METEORCAPTUR, &c);
217 
218  c = SIGUSR1;
219  ioctl(*video_fd, METEORSSIGNAL, &c);
220 
221  return 0;
222 }
223 
224 static void bktr_getframe(uint64_t per_frame)
225 {
226  uint64_t curtime;
227 
228  curtime = av_gettime();
229  if (!last_frame_time
230  || ((last_frame_time + per_frame) > curtime)) {
231  if (!usleep(last_frame_time + per_frame + per_frame / 8 - curtime)) {
232  if (!nsignals)
234  "SLEPT NO signals - %d microseconds late\n",
235  (int)(av_gettime() - last_frame_time - per_frame));
236  }
237  }
238  nsignals = 0;
239  last_frame_time = curtime;
240 }
241 
242 
243 /* note: we support only one picture read at a time */
245 {
246  VideoData *s = s1->priv_data;
247 
248  if (av_new_packet(pkt, video_buf_size) < 0)
249  return AVERROR(EIO);
250 
252 
253  pkt->pts = av_gettime();
254  memcpy(pkt->data, video_buf, video_buf_size);
255 
256  return video_buf_size;
257 }
258 
260 {
261  VideoData *s = s1->priv_data;
262  AVStream *st;
263  int width, height;
265  int ret = 0;
266 
267  if ((ret = av_parse_video_size(&width, &height, s->video_size)) < 0) {
268  av_log(s1, AV_LOG_ERROR, "Could not parse video size '%s'.\n", s->video_size);
269  goto out;
270  }
271 
272  if (!s->framerate)
273  switch (s->standard) {
274  case PAL: s->framerate = av_strdup("pal"); break;
275  case NTSC: s->framerate = av_strdup("ntsc"); break;
276  case SECAM: s->framerate = av_strdup("25"); break;
277  default:
278  av_log(s1, AV_LOG_ERROR, "Unknown standard.\n");
279  ret = AVERROR(EINVAL);
280  goto out;
281  }
282  if ((ret = av_parse_video_rate(&framerate, s->framerate)) < 0) {
283  av_log(s1, AV_LOG_ERROR, "Could not parse framerate '%s'.\n", s->framerate);
284  goto out;
285  }
286 
287  st = avformat_new_stream(s1, NULL);
288  if (!st) {
289  ret = AVERROR(ENOMEM);
290  goto out;
291  }
292  avpriv_set_pts_info(st, 64, 1, 1000000); /* 64 bits pts in use */
293 
294  s->width = width;
295  s->height = height;
296  s->per_frame = ((uint64_t)1000000 * framerate.den) / framerate.num;
297 
301  st->codecpar->width = width;
302  st->codecpar->height = height;
304 
305 
306  if (bktr_init(s1->filename, width, height, s->standard,
307  &s->video_fd, &s->tuner_fd, -1, 0.0) < 0) {
308  ret = AVERROR(EIO);
309  goto out;
310  }
311 
312  nsignals = 0;
313  last_frame_time = 0;
314 
315 out:
316  return ret;
317 }
318 
320 {
321  VideoData *s = s1->priv_data;
322  int c;
323 
324  c = METEOR_CAP_STOP_CONT;
325  ioctl(s->video_fd, METEORCAPTUR, &c);
326  close(s->video_fd);
327 
328  c = AUDIO_MUTE;
329  ioctl(s->tuner_fd, BT848_SAUDIO, &c);
330  close(s->tuner_fd);
331 
332  munmap((caddr_t)video_buf, video_buf_size);
333 
334  return 0;
335 }
336 
337 #define OFFSET(x) offsetof(VideoData, x)
338 #define DEC AV_OPT_FLAG_DECODING_PARAM
339 static const AVOption options[] = {
340  { "standard", "", offsetof(VideoData, standard), AV_OPT_TYPE_INT, {.i64 = VIDEO_FORMAT}, PAL, NTSCJ, AV_OPT_FLAG_DECODING_PARAM, "standard" },
341  { "PAL", "", 0, AV_OPT_TYPE_CONST, {.i64 = PAL}, 0, 0, AV_OPT_FLAG_DECODING_PARAM, "standard" },
342  { "NTSC", "", 0, AV_OPT_TYPE_CONST, {.i64 = NTSC}, 0, 0, AV_OPT_FLAG_DECODING_PARAM, "standard" },
343  { "SECAM", "", 0, AV_OPT_TYPE_CONST, {.i64 = SECAM}, 0, 0, AV_OPT_FLAG_DECODING_PARAM, "standard" },
344  { "PALN", "", 0, AV_OPT_TYPE_CONST, {.i64 = PALN}, 0, 0, AV_OPT_FLAG_DECODING_PARAM, "standard" },
345  { "PALM", "", 0, AV_OPT_TYPE_CONST, {.i64 = PALM}, 0, 0, AV_OPT_FLAG_DECODING_PARAM, "standard" },
346  { "NTSCJ", "", 0, AV_OPT_TYPE_CONST, {.i64 = NTSCJ}, 0, 0, AV_OPT_FLAG_DECODING_PARAM, "standard" },
347  { "video_size", "A string describing frame size, such as 640x480 or hd720.", OFFSET(video_size), AV_OPT_TYPE_STRING, {.str = "vga"}, 0, 0, DEC },
348  { "framerate", "", OFFSET(framerate), AV_OPT_TYPE_STRING, {.str = NULL}, 0, 0, DEC },
349  { NULL },
350 };
351 
352 static const AVClass bktr_class = {
353  .class_name = "BKTR grab interface",
354  .item_name = av_default_item_name,
355  .option = options,
356  .version = LIBAVUTIL_VERSION_INT,
357 };
358 
360  .name = "bktr",
361  .long_name = NULL_IF_CONFIG_SMALL("video grab"),
362  .priv_data_size = sizeof(VideoData),
366  .flags = AVFMT_NOFILE,
367  .priv_class = &bktr_class,
368 };
int av_parse_video_rate(AVRational *rate, const char *arg)
Parse str and store the detected values in *rate.
Definition: parseutils.c:127
AVOption.
Definition: opt.h:234
int tuner_fd
Definition: bktr.c:57
int av_parse_video_size(int *width_ptr, int *height_ptr, const char *str)
Parse str and put in width_ptr and height_ptr the detected values.
Definition: parseutils.c:100
uint8_t * video_buf
Definition: bktr.c:87
void avpriv_set_pts_info(AVStream *s, int pts_wrap_bits, unsigned int pts_num, unsigned int pts_den)
Set the time base and wrapping info for a given stream.
Definition: utils.c:2986
#define SECAM_HEIGHT
Definition: bktr.c:77
size_t video_buf_size
Definition: bktr.c:88
enum AVCodecID codec_id
Specific type of the encoded data (the codec used).
Definition: avcodec.h:3483
int num
numerator
Definition: rational.h:44
av_log(ac->avr, AV_LOG_TRACE, "%d samples - audio_convert: %s to %s (%s)\, len, av_get_sample_fmt_name(ac->in_fmt), av_get_sample_fmt_name(ac->out_fmt), use_generic ? ac->func_descr_generic :ac->func_descr)
static int bktr_dev[]
Definition: bktr.c:84
#define DEC
Definition: bktr.c:338
AVInputFormat ff_bktr_demuxer
Definition: bktr.c:359
int video_fd
Definition: bktr.c:56
Format I/O context.
Definition: avformat.h:940
const char * class_name
The name of the class; usually it is the same name as the context structure type to which the AVClass...
Definition: log.h:39
uint8_t
#define av_cold
Definition: attributes.h:66
int width
Video only.
Definition: avcodec.h:3525
AVOptions.
static void bktr_getframe(uint64_t per_frame)
Definition: bktr.c:224
AVStream * avformat_new_stream(AVFormatContext *s, const AVCodec *c)
Add a new stream to a media file.
Definition: utils.c:2648
int avpriv_open(const char *filename, int flags,...)
A wrapper for open() setting O_CLOEXEC.
Definition: file_open.c:66
uint8_t * data
Definition: avcodec.h:1346
static int flags
Definition: log.c:50
static av_cold int read_close(AVFormatContext *ctx)
Definition: libcdio.c:145
#define NTSC_HEIGHT
Definition: bktr.c:78
char * framerate
Set by a private option.
Definition: bktr.c:62
volatile sig_atomic_t nsignals
Definition: bktr.c:90
int av_new_packet(AVPacket *pkt, int size)
Allocate the payload of a packet and initialize its fields with default values.
Definition: avpacket.c:84
static const AVClass bktr_class
Definition: bktr.c:352
#define AV_LOG_ERROR
Something went wrong and cannot losslessly be recovered.
Definition: log.h:124
char * video_size
String describing video size, set by a private option.
Definition: bktr.c:61
#define AVERROR(e)
Definition: error.h:43
#define NULL_IF_CONFIG_SMALL(x)
Return NULL if CONFIG_SMALL is true, otherwise the argument without modification. ...
Definition: internal.h:148
enum AVMediaType codec_type
General type of the encoded data.
Definition: avcodec.h:3479
int width
Definition: bktr.c:58
Definition: bktr.c:54
static void catchsignal(int signal)
Definition: bktr.c:93
AVRational avg_frame_rate
Average framerate.
Definition: avformat.h:781
#define PAL_HEIGHT
Definition: bktr.c:76
common internal API header
int height
Definition: bktr.c:58
char filename[1024]
input or output filename
Definition: avformat.h:1016
uint64_t per_frame
Definition: bktr.c:59
uint64_t last_frame_time
Definition: bktr.c:89
#define SECAM
Definition: bktr.c:70
LIBAVUTIL_VERSION_INT
Definition: eval.c:55
static int read_header(FFV1Context *f)
Definition: ffv1dec.c:546
int64_t av_gettime(void)
Get the current time in microseconds.
Definition: time.c:40
Stream structure.
Definition: avformat.h:705
static int grab_read_packet(AVFormatContext *s1, AVPacket *pkt)
Definition: bktr.c:244
NULL
Definition: eval.c:55
#define AV_LOG_INFO
Standard information.
Definition: log.h:135
char * av_strdup(const char *s)
Duplicate the string s.
Definition: mem.c:219
static av_cold int bktr_init(const char *video_device, int width, int height, int format, int *video_fd, int *tuner_fd, int idev, double frequency)
Definition: bktr.c:99
av_default_item_name
Definition: dnxhdenc.c:55
static int read_packet(AVFormatContext *ctx, AVPacket *pkt)
Definition: libcdio.c:114
int standard
Definition: bktr.c:60
const char * format
Definition: movenc.c:47
Describe the class of an AVClass context structure.
Definition: log.h:34
#define NTSC
Definition: bktr.c:68
rational number numerator/denominator
Definition: rational.h:43
#define AV_OPT_FLAG_DECODING_PARAM
a generic parameter which can be set by the user for demuxing or decoding
Definition: opt.h:265
static int grab_read_header(AVFormatContext *s1)
Definition: bktr.c:259
misc parsing utilities
#define PALN
Definition: bktr.c:71
#define VIDEO_FORMAT
Definition: bktr.c:81
static const AVOption options[]
Definition: bktr.c:339
int av_strerror(int errnum, char *errbuf, size_t errbuf_size)
Put a description of the AVERROR code errnum in errbuf.
Definition: error.c:23
#define OFFSET(x)
Definition: bktr.c:337
Main libavformat public API header.
planar YUV 4:2:0, 12bpp, (1 Cr & Cb sample per 2x2 Y samples)
Definition: pixfmt.h:59
#define AVFMT_NOFILE
Demuxer will use avio_open, no opened file should be provided by the caller.
Definition: avformat.h:412
#define PALM
Definition: bktr.c:72
#define NTSCJ
Definition: bktr.c:73
int den
denominator
Definition: rational.h:45
void * priv_data
Format private data.
Definition: avformat.h:968
#define PAL
Definition: bktr.c:66
FILE * out
Definition: movenc.c:54
const char * name
A comma separated list of short names for the format.
Definition: avformat.h:529
AVCodecParameters * codecpar
Definition: avformat.h:831
static int grab_read_close(AVFormatContext *s1)
Definition: bktr.c:319
This structure stores compressed data.
Definition: avcodec.h:1323
int64_t pts
Presentation timestamp in AVStream->time_base units; the time at which the decompressed packet will b...
Definition: avcodec.h:1339