/* * Media controller interface library * * Copyright (C) 2010-2011 Ideas on board SPRL * * Contact: Laurent Pinchart * * This program is free software; you can redistribute it and/or modify * it under the terms of the GNU Lesser General Public License as published * by the Free Software Foundation; either version 2.1 of the License, or * (at your option) any later version. * * This program is distributed in the hope that it will be useful, * but WITHOUT ANY WARRANTY; without even the implied warranty of * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the * GNU Lesser General Public License for more details. * * You should have received a copy of the GNU Lesser General Public License * along with this program. If not, see . */ #include "config.h" #include #include #include #include #include #include #include #include #include #include #include #include #include "mediactl.h" #include "tools.h" struct media_pad *media_entity_remote_source(struct media_pad *pad) { unsigned int i; if (!(pad->flags & MEDIA_PAD_FL_SINK)) return NULL; for (i = 0; i < pad->entity->num_links; ++i) { struct media_link *link = &pad->entity->links[i]; if (!(link->flags & MEDIA_LNK_FL_ENABLED)) continue; if (link->sink == pad) return link->source; } return NULL; } struct media_entity *media_get_entity_by_name(struct media_device *media, const char *name, size_t length) { unsigned int i; /* A match is impossible if the entity name is longer than the maximum * size we can get from the kernel. */ if (length >= FIELD_SIZEOF(struct media_entity_desc, name)) return NULL; for (i = 0; i < media->entities_count; ++i) { struct media_entity *entity = &media->entities[i]; if (strncmp(entity->info.name, name, length) == 0 && entity->info.name[length] == '\0') return entity; } return NULL; } struct media_entity *media_get_entity_by_id(struct media_device *media, __u32 id) { bool next = id & MEDIA_ENT_ID_FLAG_NEXT; unsigned int i; id &= ~MEDIA_ENT_ID_FLAG_NEXT; for (i = 0; i < media->entities_count; ++i) { struct media_entity *entity = &media->entities[i]; if ((entity->info.id == id && !next) || (entity->info.id > id && next)) return entity; } return NULL; } int media_setup_link(struct media_device *media, struct media_pad *source, struct media_pad *sink, __u32 flags) { struct media_link *link; struct media_link_desc ulink; unsigned int i; int ret; for (i = 0; i < source->entity->num_links; i++) { link = &source->entity->links[i]; if (link->source->entity == source->entity && link->source->index == source->index && link->sink->entity == sink->entity && link->sink->index == sink->index) break; } if (i == source->entity->num_links) { media_dbg(media, "%s: Link not found\n", __func__); return -ENOENT; } /* source pad */ ulink.source.entity = source->entity->info.id; ulink.source.index = source->index; ulink.source.flags = MEDIA_PAD_FL_SOURCE; /* sink pad */ ulink.sink.entity = sink->entity->info.id; ulink.sink.index = sink->index; ulink.sink.flags = MEDIA_PAD_FL_SINK; ulink.flags = flags | (link->flags & MEDIA_LNK_FL_IMMUTABLE); ret = ioctl(media->fd, MEDIA_IOC_SETUP_LINK, &ulink); if (ret == -1) { media_dbg(media, "%s: Unable to setup link (%s)\n", __func__, strerror(errno)); return -errno; } link->flags = ulink.flags; link->twin->flags = ulink.flags; return 0; } int media_reset_links(struct media_device *media) { unsigned int i, j; int ret; for (i = 0; i < media->entities_count; ++i) { struct media_entity *entity = &media->entities[i]; for (j = 0; j < entity->num_links; j++) { struct media_link *link = &entity->links[j]; if (link->flags & MEDIA_LNK_FL_IMMUTABLE || link->source->entity != entity) continue; ret = media_setup_link(media, link->source, link->sink, link->flags & ~MEDIA_LNK_FL_ENABLED); if (ret < 0) return ret; } } return 0; } static struct media_link *media_entity_add_link(struct media_entity *entity) { if (entity->num_links >= entity->max_links) { struct media_link *links = entity->links; unsigned int max_links = entity->max_links * 2; unsigned int i; links = realloc(links, max_links * sizeof *links); if (links == NULL) return NULL; for (i = 0; i < entity->num_links; ++i) links[i].twin->twin = &links[i]; entity->max_links = max_links; entity->links = links; } return &entity->links[entity->num_links++]; } static int media_enum_links(struct media_device *media) { __u32 id; int ret = 0; for (id = 1; id <= media->entities_count; id++) { struct media_entity *entity = &media->entities[id - 1]; struct media_links_enum links; unsigned int i; links.entity = entity->info.id; links.pads = calloc(entity->info.pads, sizeof(struct media_pad_desc)); links.links = calloc(entity->info.links, sizeof(struct media_link_desc)); if (ioctl(media->fd, MEDIA_IOC_ENUM_LINKS, &links) < 0) { media_dbg(media, "%s: Unable to enumerate pads and links (%s).\n", __func__, strerror(errno)); free(links.pads); free(links.links); return -errno; } for (i = 0; i < entity->info.pads; ++i) { entity->pads[i].entity = entity; entity->pads[i].index = links.pads[i].index; entity->pads[i].flags = links.pads[i].flags; } for (i = 0; i < entity->info.links; ++i) { struct media_link_desc *link = &links.links[i]; struct media_link *fwdlink; struct media_link *backlink; struct media_entity *source; struct media_entity *sink; source = media_get_entity_by_id(media, link->source.entity); sink = media_get_entity_by_id(media, link->sink.entity); if (source == NULL || sink == NULL) { media_dbg(media, "WARNING entity %u link %u from %u/%u to %u/%u is invalid!\n", id, i, link->source.entity, link->source.index, link->sink.entity, link->sink.index); ret = -EINVAL; } else { fwdlink = media_entity_add_link(source); fwdlink->source = &source->pads[link->source.index]; fwdlink->sink = &sink->pads[link->sink.index]; fwdlink->flags = link->flags; backlink = media_entity_add_link(sink); backlink->source = &source->pads[link->source.index]; backlink->sink = &sink->pads[link->sink.index]; backlink->flags = link->flags; fwdlink->twin = backlink; backlink->twin = fwdlink; } } free(links.pads); free(links.links); } return ret; } #ifdef HAVE_LIBUDEV #include static inline int media_udev_open(struct udev **udev) { *udev = udev_new(); if (*udev == NULL) return -ENOMEM; return 0; } static inline void media_udev_close(struct udev *udev) { if (udev != NULL) udev_unref(udev); } static int media_get_devname_udev(struct udev *udev, struct media_entity *entity) { struct udev_device *device; dev_t devnum; const char *p; int ret = -ENODEV; if (udev == NULL) return -EINVAL; devnum = makedev(entity->info.v4l.major, entity->info.v4l.minor); media_dbg(entity->media, "looking up device: %u:%u\n", major(devnum), minor(devnum)); device = udev_device_new_from_devnum(udev, 'c', devnum); if (device) { p = udev_device_get_devnode(device); if (p) { strncpy(entity->devname, p, sizeof(entity->devname)); entity->devname[sizeof(entity->devname) - 1] = '\0'; } ret = 0; } udev_device_unref(device); return ret; } #else /* HAVE_LIBUDEV */ struct udev; static inline int media_udev_open(struct udev **udev) { return 0; } static inline void media_udev_close(struct udev *udev) { } static inline int media_get_devname_udev(struct udev *udev, struct media_entity *entity) { return -ENOTSUP; } #endif /* HAVE_LIBUDEV */ static int media_get_devname_sysfs(struct media_entity *entity) { struct stat devstat; char devname[32]; char sysname[32]; char target[1024]; char *p; int ret; sprintf(sysname, "/sys/dev/char/%u:%u", entity->info.v4l.major, entity->info.v4l.minor); ret = readlink(sysname, target, sizeof(target)); if (ret < 0) return -errno; target[ret] = '\0'; p = strrchr(target, '/'); if (p == NULL) return -EINVAL; sprintf(devname, "/dev/%s", p + 1); ret = stat(devname, &devstat); if (ret < 0) return -errno; /* Sanity check: udev might have reordered the device nodes. * Make sure the major/minor match. We should really use * libudev. */ if (major(devstat.st_rdev) == entity->info.v4l.major && minor(devstat.st_rdev) == entity->info.v4l.minor) strcpy(entity->devname, devname); return 0; } static int media_enum_entities(struct media_device *media) { struct media_entity *entity; struct udev *udev; unsigned int size; __u32 id; int ret; ret = media_udev_open(&udev); if (ret < 0) media_dbg(media, "Can't get udev context\n"); for (id = 0, ret = 0; ; id = entity->info.id) { size = (media->entities_count + 1) * sizeof(*media->entities); media->entities = realloc(media->entities, size); entity = &media->entities[media->entities_count]; memset(entity, 0, sizeof(*entity)); entity->fd = -1; entity->info.id = id | MEDIA_ENT_ID_FLAG_NEXT; entity->media = media; ret = ioctl(media->fd, MEDIA_IOC_ENUM_ENTITIES, &entity->info); if (ret < 0) { ret = errno != EINVAL ? -errno : 0; break; } /* Number of links (for outbound links) plus number of pads (for * inbound links) is a good safe initial estimate of the total * number of links. */ entity->max_links = entity->info.pads + entity->info.links; entity->pads = malloc(entity->info.pads * sizeof(*entity->pads)); entity->links = malloc(entity->max_links * sizeof(*entity->links)); if (entity->pads == NULL || entity->links == NULL) { ret = -ENOMEM; break; } media->entities_count++; /* Find the corresponding device name. */ if (media_entity_type(entity) != MEDIA_ENT_T_DEVNODE && media_entity_type(entity) != MEDIA_ENT_T_V4L2_SUBDEV) continue; /* Try to get the device name via udev */ if (!media_get_devname_udev(udev, entity)) continue; /* Fall back to get the device name via sysfs */ media_get_devname_sysfs(entity); } media_udev_close(udev); return ret; } static void media_debug_default(void *ptr, ...) { } void media_debug_set_handler(struct media_device *media, void (*debug_handler)(void *, ...), void *debug_priv) { if (debug_handler) { media->debug_handler = debug_handler; media->debug_priv = debug_priv; } else { media->debug_handler = media_debug_default; media->debug_priv = NULL; } } struct media_device *media_open_debug( const char *name, void (*debug_handler)(void *, ...), void *debug_priv) { struct media_device *media; int ret; media = calloc(1, sizeof(*media)); if (media == NULL) return NULL; media_debug_set_handler(media, debug_handler, debug_priv); media_dbg(media, "Opening media device %s\n", name); media->fd = open(name, O_RDWR); if (media->fd < 0) { media_close(media); media_dbg(media, "%s: Can't open media device %s\n", __func__, name); return NULL; } ret = ioctl(media->fd, MEDIA_IOC_DEVICE_INFO, &media->info); if (ret < 0) { media_dbg(media, "%s: Unable to retrieve media device " "information for device %s (%s)\n", __func__, name, strerror(errno)); media_close(media); return NULL; } media_dbg(media, "Enumerating entities\n"); ret = media_enum_entities(media); if (ret < 0) { media_dbg(media, "%s: Unable to enumerate entities for device %s (%s)\n", __func__, name, strerror(-ret)); media_close(media); return NULL; } media_dbg(media, "Found %u entities\n", media->entities_count); media_dbg(media, "Enumerating pads and links\n"); ret = media_enum_links(media); if (ret < 0) { media_dbg(media, "%s: Unable to enumerate pads and linksfor device %s\n", __func__, name); media_close(media); return NULL; } return media; } struct media_device *media_open(const char *name) { return media_open_debug(name, NULL, NULL); } void media_close(struct media_device *media) { unsigned int i; if (media->fd != -1) close(media->fd); for (i = 0; i < media->entities_count; ++i) { struct media_entity *entity = &media->entities[i]; free(entity->pads); free(entity->links); if (entity->fd != -1) close(entity->fd); } free(media->entities); free(media); } struct media_pad *media_parse_pad(struct media_device *media, const char *p, char **endp) { unsigned int entity_id, pad; struct media_entity *entity; char *end; for (; isspace(*p); ++p); if (*p == '"') { for (end = (char *)p + 1; *end && *end != '"'; ++end); if (*end != '"') return NULL; entity = media_get_entity_by_name(media, p + 1, end - p - 1); if (entity == NULL) return NULL; ++end; } else { entity_id = strtoul(p, &end, 10); entity = media_get_entity_by_id(media, entity_id); if (entity == NULL) return NULL; } for (; isspace(*end); ++end); if (*end != ':') return NULL; for (p = end + 1; isspace(*p); ++p); pad = strtoul(p, &end, 10); for (p = end; isspace(*p); ++p); if (pad >= entity->info.pads) return NULL; for (p = end; isspace(*p); ++p); if (endp) *endp = (char *)p; return &entity->pads[pad]; } struct media_link *media_parse_link(struct media_device *media, const char *p, char **endp) { struct media_link *link; struct media_pad *source; struct media_pad *sink; unsigned int i; char *end; source = media_parse_pad(media, p, &end); if (source == NULL) return NULL; if (end[0] != '-' || end[1] != '>') return NULL; p = end + 2; sink = media_parse_pad(media, p, &end); if (sink == NULL) return NULL; *endp = end; for (i = 0; i < source->entity->num_links; i++) { link = &source->entity->links[i]; if (link->source == source && link->sink == sink) return link; } return NULL; } int media_parse_setup_link(struct media_device *media, const char *p, char **endp) { struct media_link *link; __u32 flags; char *end; link = media_parse_link(media, p, &end); if (link == NULL) { media_dbg(media, "%s: Unable to parse link\n", __func__); return -EINVAL; } p = end; if (*p++ != '[') { media_dbg(media, "Unable to parse link flags\n"); return -EINVAL; } flags = strtoul(p, &end, 10); for (p = end; isspace(*p); p++); if (*p++ != ']') { media_dbg(media, "Unable to parse link flags\n"); return -EINVAL; } for (; isspace(*p); p++); *endp = (char *)p; media_dbg(media, "Setting up link %u:%u -> %u:%u [%u]\n", link->source->entity->info.id, link->source->index, link->sink->entity->info.id, link->sink->index, flags); return media_setup_link(media, link->source, link->sink, flags); } int media_parse_setup_links(struct media_device *media, const char *p) { char *end; int ret; do { ret = media_parse_setup_link(media, p, &end); if (ret < 0) return ret; p = end + 1; } while (*end == ','); return *end ? -EINVAL : 0; }