Make the media_entity structure private
authorLaurent Pinchart <laurent.pinchart@ideasonboard.com>
Mon, 27 Jan 2014 01:11:47 +0000 (02:11 +0100)
committerLaurent Pinchart <laurent.pinchart@ideasonboard.com>
Mon, 10 Mar 2014 18:53:59 +0000 (19:53 +0100)
Signed-off-by: Laurent Pinchart <laurent.pinchart@ideasonboard.com>
Acked-by: Hans Verkuil <hans.verkuil@cisco.com>
Acked-by: Sakari Ailus <sakari.ailus@iki.fi>
src/main.c
src/mediactl-priv.h
src/mediactl.c
src/mediactl.h

index b0e2277..6f980b4 100644 (file)
@@ -171,7 +171,6 @@ static const char *media_pad_type_to_string(unsigned flag)
 
 static void media_print_topology_dot(struct media_device *media)
 {
 
 static void media_print_topology_dot(struct media_device *media)
 {
-       struct media_entity *entities = media_get_entities(media);
        unsigned int nents = media_get_entities_count(media);
        unsigned int i, j;
 
        unsigned int nents = media_get_entities_count(media);
        unsigned int i, j;
 
@@ -179,34 +178,41 @@ static void media_print_topology_dot(struct media_device *media)
        printf("\trankdir=TB\n");
 
        for (i = 0; i < nents; ++i) {
        printf("\trankdir=TB\n");
 
        for (i = 0; i < nents; ++i) {
-               struct media_entity *entity = &entities[i];
+               struct media_entity *entity = media_get_entity(media, i);
+               const struct media_entity_desc *info = media_entity_get_info(entity);
+               const char *devname = media_entity_get_devname(entity);
+               unsigned int num_links = media_entity_get_links_count(entity);
                unsigned int npads;
 
                switch (media_entity_type(entity)) {
                case MEDIA_ENT_T_DEVNODE:
                        printf("\tn%08x [label=\"%s\\n%s\", shape=box, style=filled, "
                               "fillcolor=yellow]\n",
                unsigned int npads;
 
                switch (media_entity_type(entity)) {
                case MEDIA_ENT_T_DEVNODE:
                        printf("\tn%08x [label=\"%s\\n%s\", shape=box, style=filled, "
                               "fillcolor=yellow]\n",
-                              entity->info.id, entity->info.name, entity->devname);
+                              info->id, info->name, devname);
                        break;
 
                case MEDIA_ENT_T_V4L2_SUBDEV:
                        break;
 
                case MEDIA_ENT_T_V4L2_SUBDEV:
-                       printf("\tn%08x [label=\"{{", entity->info.id);
+                       printf("\tn%08x [label=\"{{", info->id);
 
 
-                       for (j = 0, npads = 0; j < entity->info.pads; ++j) {
-                               if (!(entity->pads[j].flags & MEDIA_PAD_FL_SINK))
+                       for (j = 0, npads = 0; j < info->pads; ++j) {
+                               const struct media_pad *pad = media_entity_get_pad(entity, j);
+
+                               if (!(pad->flags & MEDIA_PAD_FL_SINK))
                                        continue;
 
                                printf("%s<port%u> %u", npads ? " | " : "", j, j);
                                npads++;
                        }
 
                                        continue;
 
                                printf("%s<port%u> %u", npads ? " | " : "", j, j);
                                npads++;
                        }
 
-                       printf("} | %s", entity->info.name);
-                       if (entity->devname)
-                               printf("\\n%s", entity->devname);
+                       printf("} | %s", info->name);
+                       if (devname)
+                               printf("\\n%s", devname);
                        printf(" | {");
 
                        printf(" | {");
 
-                       for (j = 0, npads = 0; j < entity->info.pads; ++j) {
-                               if (!(entity->pads[j].flags & MEDIA_PAD_FL_SOURCE))
+                       for (j = 0, npads = 0; j < info->pads; ++j) {
+                               const struct media_pad *pad = media_entity_get_pad(entity, j);
+
+                               if (!(pad->flags & MEDIA_PAD_FL_SOURCE))
                                        continue;
 
                                printf("%s<port%u> %u", npads ? " | " : "", j, j);
                                        continue;
 
                                printf("%s<port%u> %u", npads ? " | " : "", j, j);
@@ -220,19 +226,21 @@ static void media_print_topology_dot(struct media_device *media)
                        continue;
                }
 
                        continue;
                }
 
-               for (j = 0; j < entity->num_links; j++) {
-                       struct media_link *link = &entity->links[j];
+               for (j = 0; j < num_links; j++) {
+                       const struct media_link *link = media_entity_get_link(entity, j);
+                       const struct media_pad *source = link->source;
+                       const struct media_pad *sink = link->sink;
 
 
-                       if (link->source->entity != entity)
+                       if (source->entity != entity)
                                continue;
 
                                continue;
 
-                       printf("\tn%08x", link->source->entity->info.id);
-                       if (media_entity_type(link->source->entity) == MEDIA_ENT_T_V4L2_SUBDEV)
-                               printf(":port%u", link->source->index);
+                       printf("\tn%08x", media_entity_get_info(source->entity)->id);
+                       if (media_entity_type(source->entity) == MEDIA_ENT_T_V4L2_SUBDEV)
+                               printf(":port%u", source->index);
                        printf(" -> ");
                        printf(" -> ");
-                       printf("n%08x", link->sink->entity->info.id);
-                       if (media_entity_type(link->sink->entity) == MEDIA_ENT_T_V4L2_SUBDEV)
-                               printf(":port%u", link->sink->index);
+                       printf("n%08x", media_entity_get_info(sink->entity)->id);
+                       if (media_entity_type(sink->entity) == MEDIA_ENT_T_V4L2_SUBDEV)
+                               printf(":port%u", sink->index);
 
                        if (link->flags & MEDIA_LNK_FL_IMMUTABLE)
                                printf(" [style=bold]");
 
                        if (link->flags & MEDIA_LNK_FL_IMMUTABLE)
                                printf(" [style=bold]");
@@ -256,7 +264,6 @@ static void media_print_topology_text(struct media_device *media)
                { MEDIA_LNK_FL_DYNAMIC, "DYNAMIC" },
        };
 
                { MEDIA_LNK_FL_DYNAMIC, "DYNAMIC" },
        };
 
-       struct media_entity *entities = media_get_entities(media);
        unsigned int nents = media_get_entities_count(media);
        unsigned int i, j, k;
        unsigned int padding;
        unsigned int nents = media_get_entities_count(media);
        unsigned int i, j, k;
        unsigned int padding;
@@ -264,40 +271,45 @@ static void media_print_topology_text(struct media_device *media)
        printf("Device topology\n");
 
        for (i = 0; i < nents; ++i) {
        printf("Device topology\n");
 
        for (i = 0; i < nents; ++i) {
-               struct media_entity *entity = &entities[i];
-
-               padding = printf("- entity %u: ", entity->info.id);
-               printf("%s (%u pad%s, %u link%s)\n", entity->info.name,
-                       entity->info.pads, entity->info.pads > 1 ? "s" : "",
-                       entity->num_links, entity->num_links > 1 ? "s" : "");
+               struct media_entity *entity = media_get_entity(media, i);
+               const struct media_entity_desc *info = media_entity_get_info(entity);
+               const char *devname = media_entity_get_devname(entity);
+               unsigned int num_links = media_entity_get_links_count(entity);
+
+               padding = printf("- entity %u: ", info->id);
+               printf("%s (%u pad%s, %u link%s)\n", info->name,
+                       info->pads, info->pads > 1 ? "s" : "",
+                       num_links, num_links > 1 ? "s" : "");
                printf("%*ctype %s subtype %s flags %x\n", padding, ' ',
                printf("%*ctype %s subtype %s flags %x\n", padding, ' ',
-                       media_entity_type_to_string(entity->info.type),
-                       media_entity_subtype_to_string(entity->info.type),
-                       entity->info.flags);
-               if (entity->devname[0])
-                       printf("%*cdevice node name %s\n", padding, ' ', entity->devname);
+                       media_entity_type_to_string(info->type),
+                       media_entity_subtype_to_string(info->type),
+                       info->flags);
+               if (devname)
+                       printf("%*cdevice node name %s\n", padding, ' ', devname);
 
 
-               for (j = 0; j < entity->info.pads; j++) {
-                       struct media_pad *pad = &entity->pads[j];
+               for (j = 0; j < info->pads; j++) {
+                       const struct media_pad *pad = media_entity_get_pad(entity, j);
 
                        printf("\tpad%u: %s\n", j, media_pad_type_to_string(pad->flags));
 
                        if (media_entity_type(entity) == MEDIA_ENT_T_V4L2_SUBDEV)
                                v4l2_subdev_print_format(entity, j, V4L2_SUBDEV_FORMAT_ACTIVE);
 
 
                        printf("\tpad%u: %s\n", j, media_pad_type_to_string(pad->flags));
 
                        if (media_entity_type(entity) == MEDIA_ENT_T_V4L2_SUBDEV)
                                v4l2_subdev_print_format(entity, j, V4L2_SUBDEV_FORMAT_ACTIVE);
 
-                       for (k = 0; k < entity->num_links; k++) {
-                               struct media_link *link = &entity->links[k];
-                               struct media_pad *source = link->source;
-                               struct media_pad *sink = link->sink;
+                       for (k = 0; k < num_links; k++) {
+                               const struct media_link *link = media_entity_get_link(entity, k);
+                               const struct media_pad *source = link->source;
+                               const struct media_pad *sink = link->sink;
                                bool first = true;
                                unsigned int i;
 
                                if (source->entity == entity && source->index == j)
                                        printf("\t\t-> \"%s\":%u [",
                                bool first = true;
                                unsigned int i;
 
                                if (source->entity == entity && source->index == j)
                                        printf("\t\t-> \"%s\":%u [",
-                                               sink->entity->info.name, sink->index);
+                                               media_entity_get_info(sink->entity)->name,
+                                               sink->index);
                                else if (sink->entity == entity && sink->index == j)
                                        printf("\t\t<- \"%s\":%u [",
                                else if (sink->entity == entity && sink->index == j)
                                        printf("\t\t<- \"%s\":%u [",
-                                               source->entity->info.name, source->index);
+                                               media_entity_get_info(source->entity)->name,
+                                               source->index);
                                else
                                        continue;
 
                                else
                                        continue;
 
@@ -383,7 +395,7 @@ int main(int argc, char **argv)
                        goto out;
                }
 
                        goto out;
                }
 
-               printf("%s\n", entity->devname);
+               printf("%s\n", media_entity_get_devname(entity));
        }
 
        if (media_opts.pad) {
        }
 
        if (media_opts.pad) {
index 844acc7..37e60aa 100644 (file)
 
 #include "mediactl.h"
 
 
 #include "mediactl.h"
 
+struct media_entity {
+       struct media_device *media;
+       struct media_entity_desc info;
+       struct media_pad *pads;
+       struct media_link *links;
+       unsigned int max_links;
+       unsigned int num_links;
+
+       char devname[32];
+       int fd;
+};
+
 struct media_device {
        int fd;
        int refcount;
 struct media_device {
        int fd;
        int refcount;
index 304e185..dd5bd57 100644 (file)
@@ -111,9 +111,38 @@ unsigned int media_get_entities_count(struct media_device *media)
        return media->entities_count;
 }
 
        return media->entities_count;
 }
 
-struct media_entity *media_get_entities(struct media_device *media)
+struct media_entity *media_get_entity(struct media_device *media, unsigned int index)
 {
 {
-       return media->entities;
+       if (index >= media->entities_count)
+               return NULL;
+
+       return &media->entities[index];
+}
+
+const struct media_pad *media_entity_get_pad(struct media_entity *entity, unsigned int index)
+{
+       if (index >= entity->info.pads)
+               return NULL;
+
+       return &entity->pads[index];
+}
+
+unsigned int media_entity_get_links_count(struct media_entity *entity)
+{
+       return entity->num_links;
+}
+
+const struct media_link *media_entity_get_link(struct media_entity *entity, unsigned int index)
+{
+       if (index >= entity->num_links)
+               return NULL;
+
+       return &entity->links[index];
+}
+
+const char *media_entity_get_devname(struct media_entity *entity)
+{
+       return entity->devname[0] ? entity->devname : NULL;
 }
 
 const struct media_device_info *media_get_info(struct media_device *media)
 }
 
 const struct media_device_info *media_get_info(struct media_device *media)
@@ -126,6 +155,11 @@ const char *media_get_devnode(struct media_device *media)
        return media->devnode;
 }
 
        return media->devnode;
 }
 
+const struct media_entity_desc *media_entity_get_info(struct media_entity *entity)
+{
+       return &entity->info;
+}
+
 /* -----------------------------------------------------------------------------
  * Open/close
  */
 /* -----------------------------------------------------------------------------
  * Open/close
  */
index efa59d6..e2c93b8 100644 (file)
@@ -39,20 +39,8 @@ struct media_pad {
        __u32 padding[3];
 };
 
        __u32 padding[3];
 };
 
-struct media_entity {
-       struct media_device *media;
-       struct media_entity_desc info;
-       struct media_pad *pads;
-       struct media_link *links;
-       unsigned int max_links;
-       unsigned int num_links;
-
-       char devname[32];
-       int fd;
-       __u32 padding[6];
-};
-
 struct media_device;
 struct media_device;
+struct media_entity;
 
 /**
  * @brief Create a new media device.
 
 /**
  * @brief Create a new media device.
@@ -130,6 +118,66 @@ int media_device_enumerate(struct media_device *media);
  */
 struct media_pad *media_entity_remote_source(struct media_pad *pad);
 
  */
 struct media_pad *media_entity_remote_source(struct media_pad *pad);
 
+/**
+ * @brief Get information about a media entity
+ * @param entity - media entity.
+ *
+ * The information structure is owned by the media entity object and will be
+ * freed when the object is destroyed.
+ *
+ * @return A pointer to the media entity information
+ */
+const struct media_entity_desc *media_entity_get_info(struct media_entity *entity);
+
+/**
+ * @brief Get an entity pad
+ * @param entity - media entity.
+ * @param index - pad index.
+ *
+ * This function returns a pointer to the pad object identified by its index
+ * for the given entity. If the pad index is out of bounds it will return NULL.
+ *
+ * @return A pointer to the pad
+ */
+const struct media_pad *media_entity_get_pad(struct media_entity *entity,
+                                            unsigned int index);
+
+/**
+ * @brief Get the number of links
+ * @param entity - media entity.
+ *
+ * This function returns the total number of links that originate from or arrive
+ * at the the media entity.
+ *
+ * @return The number of links for the entity
+ */
+unsigned int media_entity_get_links_count(struct media_entity *entity);
+
+/**
+ * @brief Get an entity link
+ * @param entity - media entity.
+ * @param index - link index.
+ *
+ * This function returns a pointer to the link object identified by its index
+ * for the given entity. If the link index is out of bounds it will return NULL.
+ *
+ * @return A pointer to the link
+ */
+const struct media_link *media_entity_get_link(struct media_entity *entity,
+                                              unsigned int index);
+
+/**
+ * @brief Get the device node name for an entity
+ * @param entity - media entity.
+ *
+ * This function returns the full path and name to the device node corresponding
+ * to the given entity.
+ *
+ * @return A pointer to the device node name or NULL if the entity has no
+ * associated device node
+ */
+const char *media_entity_get_devname(struct media_entity *entity);
+
 /**
  * @brief Get the type of an entity.
  * @param entity - the entity.
 /**
  * @brief Get the type of an entity.
  * @param entity - the entity.
@@ -138,7 +186,7 @@ struct media_pad *media_entity_remote_source(struct media_pad *pad);
  */
 static inline unsigned int media_entity_type(struct media_entity *entity)
 {
  */
 static inline unsigned int media_entity_type(struct media_entity *entity)
 {
-       return entity->info.type & MEDIA_ENT_TYPE_MASK;
+       return media_entity_get_info(entity)->type & MEDIA_ENT_TYPE_MASK;
 }
 
 /**
 }
 
 /**
@@ -193,7 +241,7 @@ unsigned int media_get_entities_count(struct media_device *media);
  *
  * @return A pointer to an array of entities
  */
  *
  * @return A pointer to an array of entities
  */
-struct media_entity *media_get_entities(struct media_device *media);
+struct media_entity *media_get_entity(struct media_device *media, unsigned int index);
 
 /**
  * @brief Get the media device information
 
 /**
  * @brief Get the media device information