2009-12-09 04:40:00 -07:00
|
|
|
/*
|
|
|
|
* Media entity
|
|
|
|
*
|
|
|
|
* Copyright (C) 2010 Nokia Corporation
|
|
|
|
*
|
|
|
|
* Contacts: Laurent Pinchart <laurent.pinchart@ideasonboard.com>
|
|
|
|
* Sakari Ailus <sakari.ailus@iki.fi>
|
|
|
|
*
|
|
|
|
* This program is free software; you can redistribute it and/or modify
|
|
|
|
* it under the terms of the GNU General Public License version 2 as
|
|
|
|
* published by the Free Software Foundation.
|
|
|
|
*
|
|
|
|
* 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 General Public License for more details.
|
|
|
|
*
|
|
|
|
* You should have received a copy of the GNU General Public License
|
|
|
|
* along with this program; if not, write to the Free Software
|
|
|
|
* Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
|
|
|
|
*/
|
|
|
|
|
|
|
|
#ifndef _MEDIA_ENTITY_H
|
|
|
|
#define _MEDIA_ENTITY_H
|
|
|
|
|
2013-06-07 09:45:11 -06:00
|
|
|
#include <linux/bitops.h>
|
2013-12-13 04:58:37 -07:00
|
|
|
#include <linux/kernel.h>
|
2009-12-09 04:40:00 -07:00
|
|
|
#include <linux/list.h>
|
2009-12-09 04:40:01 -07:00
|
|
|
#include <linux/media.h>
|
2009-12-09 04:40:00 -07:00
|
|
|
|
2015-08-25 07:28:36 -06:00
|
|
|
/* Enums used internally at the media controller to represent graphs */
|
|
|
|
|
|
|
|
/**
|
|
|
|
* enum media_gobj_type - type of a graph object
|
|
|
|
*
|
2015-08-14 09:47:48 -06:00
|
|
|
* @MEDIA_GRAPH_ENTITY: Identify a media entity
|
2015-08-14 09:50:08 -06:00
|
|
|
* @MEDIA_GRAPH_PAD: Identify a media pad
|
2015-08-14 09:54:36 -06:00
|
|
|
* @MEDIA_GRAPH_LINK: Identify a media link
|
2015-08-20 06:07:34 -06:00
|
|
|
* @MEDIA_GRAPH_INTF_DEVNODE: Identify a media Kernel API interface via
|
|
|
|
* a device node
|
2015-08-25 07:28:36 -06:00
|
|
|
*/
|
|
|
|
enum media_gobj_type {
|
2015-08-14 09:47:48 -06:00
|
|
|
MEDIA_GRAPH_ENTITY,
|
2015-08-14 09:50:08 -06:00
|
|
|
MEDIA_GRAPH_PAD,
|
2015-08-14 09:54:36 -06:00
|
|
|
MEDIA_GRAPH_LINK,
|
2015-08-20 06:07:34 -06:00
|
|
|
MEDIA_GRAPH_INTF_DEVNODE,
|
2015-08-25 07:28:36 -06:00
|
|
|
};
|
|
|
|
|
|
|
|
#define MEDIA_BITS_PER_TYPE 8
|
|
|
|
#define MEDIA_BITS_PER_LOCAL_ID (32 - MEDIA_BITS_PER_TYPE)
|
|
|
|
#define MEDIA_LOCAL_ID_MASK GENMASK(MEDIA_BITS_PER_LOCAL_ID - 1, 0)
|
|
|
|
|
|
|
|
/* Structs to represent the objects that belong to a media graph */
|
|
|
|
|
|
|
|
/**
|
|
|
|
* struct media_gobj - Define a graph object.
|
|
|
|
*
|
2015-08-29 20:43:03 -06:00
|
|
|
* @mdev: Pointer to the struct media_device that owns the object
|
2015-08-25 07:28:36 -06:00
|
|
|
* @id: Non-zero object ID identifier. The ID should be unique
|
|
|
|
* inside a media_device, as it is composed by
|
|
|
|
* MEDIA_BITS_PER_TYPE to store the type plus
|
|
|
|
* MEDIA_BITS_PER_LOCAL_ID to store a per-type ID
|
|
|
|
* (called as "local ID").
|
2015-08-29 20:43:03 -06:00
|
|
|
* @list: List entry stored in one of the per-type mdev object lists
|
2015-08-25 07:28:36 -06:00
|
|
|
*
|
|
|
|
* All objects on the media graph should have this struct embedded
|
|
|
|
*/
|
|
|
|
struct media_gobj {
|
2015-08-13 11:42:42 -06:00
|
|
|
struct media_device *mdev;
|
2015-08-25 07:28:36 -06:00
|
|
|
u32 id;
|
2015-08-23 04:51:33 -06:00
|
|
|
struct list_head list;
|
2015-08-25 07:28:36 -06:00
|
|
|
};
|
|
|
|
|
2010-08-25 06:00:41 -06:00
|
|
|
struct media_pipeline {
|
|
|
|
};
|
|
|
|
|
2015-08-29 20:43:03 -06:00
|
|
|
/**
|
|
|
|
* struct media_link - A link object part of a media graph.
|
|
|
|
*
|
|
|
|
* @graph_obj: Embedded structure containing the media object common data
|
|
|
|
* @list: Linked list associated with an entity or an interface that
|
|
|
|
* owns the link.
|
|
|
|
* @gobj0: Part of a union. Used to get the pointer for the first
|
|
|
|
* graph_object of the link.
|
|
|
|
* @source: Part of a union. Used only if the first object (gobj0) is
|
|
|
|
* a pad. In that case, it represents the source pad.
|
|
|
|
* @intf: Part of a union. Used only if the first object (gobj0) is
|
|
|
|
* an interface.
|
|
|
|
* @gobj1: Part of a union. Used to get the pointer for the second
|
|
|
|
* graph_object of the link.
|
|
|
|
* @source: Part of a union. Used only if the second object (gobj1) is
|
|
|
|
* a pad. In that case, it represents the sink pad.
|
|
|
|
* @entity: Part of a union. Used only if the second object (gobj1) is
|
|
|
|
* an entity.
|
|
|
|
* @reverse: Pointer to the link for the reverse direction of a pad to pad
|
|
|
|
* link.
|
|
|
|
* @flags: Link flags, as defined in uapi/media.h (MEDIA_LNK_FL_*)
|
2015-08-30 06:53:57 -06:00
|
|
|
* @is_backlink: Indicate if the link is a backlink.
|
2015-08-29 20:43:03 -06:00
|
|
|
*/
|
2009-12-09 04:40:00 -07:00
|
|
|
struct media_link {
|
2015-08-14 09:54:36 -06:00
|
|
|
struct media_gobj graph_obj;
|
[media] media: convert links from array to list
The entire logic that represent graph links were developed on a
time where there were no needs to dynamic remove links. So,
although links are created/removed one by one via some
functions, they're stored as an array inside the entity struct.
As the array may grow, there's a logic inside the code that
checks if the amount of space is not enough to store
the needed links. If it isn't the core uses krealloc()
to change the size of the link, with is bad, as it
leaves the memory fragmented.
So, convert links into a list.
Also, currently, both source and sink entities need the link
at the graph traversal logic inside media_entity. So there's
a logic duplicating all links. That makes it to spend
twice the memory needed. This is not a big deal for today's
usage, where the number of links are not big.
Yet, if during the MC workshop discussions, it was said that
IIO graphs could have up to 4,000 entities. So, we may
want to remove the duplication on some future. The problem
is that it would require a separate linked list to store
the backlinks inside the entity, or to use a more complex
algorithm to do graph backlink traversal, with is something
that the current graph traversal inside the core can't cope
with. So, let's postpone a such change if/when it is actually
needed.
It should also be noticed that the media_link structure uses
44 bytes on 32-bit architectures and 84 bytes on 64-bit
architecture. It will thus be allocated out of the 64-bytes and
96-bytes pools respectively. That's a 12.5% memory waste on
64-bit architectures and 31.25% on 32-bit architecture.
A linked list is less efficient than an array in this case, but
this could later be optimized if we can get rid of the reverse
links (with would reduce memory allocation by 50%).
Signed-off-by: Mauro Carvalho Chehab <mchehab@osg.samsung.com>
2015-08-07 03:55:40 -06:00
|
|
|
struct list_head list;
|
2015-08-20 06:10:07 -06:00
|
|
|
union {
|
|
|
|
struct media_gobj *gobj0;
|
|
|
|
struct media_pad *source;
|
2015-08-07 07:36:25 -06:00
|
|
|
struct media_interface *intf;
|
2015-08-20 06:10:07 -06:00
|
|
|
};
|
|
|
|
union {
|
|
|
|
struct media_gobj *gobj1;
|
|
|
|
struct media_pad *sink;
|
2015-08-07 07:36:25 -06:00
|
|
|
struct media_entity *entity;
|
2015-08-20 06:10:07 -06:00
|
|
|
};
|
2015-08-29 20:43:03 -06:00
|
|
|
struct media_link *reverse;
|
|
|
|
unsigned long flags;
|
2015-08-30 06:53:57 -06:00
|
|
|
bool is_backlink;
|
2009-12-09 04:40:00 -07:00
|
|
|
};
|
|
|
|
|
2015-08-29 20:43:03 -06:00
|
|
|
/**
|
|
|
|
* struct media_pad - A media pad graph object.
|
|
|
|
*
|
|
|
|
* @graph_obj: Embedded structure containing the media object common data
|
|
|
|
* @entity: Entity this pad belongs to
|
|
|
|
* @index: Pad index in the entity pads array, numbered from 0 to n
|
|
|
|
* @flags: Pad flags, as defined in uapi/media.h (MEDIA_PAD_FL_*)
|
|
|
|
*/
|
2009-12-09 04:40:00 -07:00
|
|
|
struct media_pad {
|
2015-08-20 06:10:07 -06:00
|
|
|
struct media_gobj graph_obj; /* must be first field in struct */
|
2015-08-29 20:43:03 -06:00
|
|
|
struct media_entity *entity;
|
|
|
|
u16 index;
|
|
|
|
unsigned long flags;
|
2009-12-09 04:40:00 -07:00
|
|
|
};
|
|
|
|
|
2014-03-25 21:01:44 -06:00
|
|
|
/**
|
|
|
|
* struct media_entity_operations - Media entity operations
|
|
|
|
* @link_setup: Notify the entity of link changes. The operation can
|
|
|
|
* return an error, in which case link setup will be
|
|
|
|
* cancelled. Optional.
|
|
|
|
* @link_validate: Return whether a link is valid from the entity point of
|
|
|
|
* view. The media_entity_pipeline_start() function
|
|
|
|
* validates all links by calling this operation. Optional.
|
|
|
|
*/
|
2009-12-09 04:40:03 -07:00
|
|
|
struct media_entity_operations {
|
|
|
|
int (*link_setup)(struct media_entity *entity,
|
|
|
|
const struct media_pad *local,
|
|
|
|
const struct media_pad *remote, u32 flags);
|
2012-01-11 02:25:15 -07:00
|
|
|
int (*link_validate)(struct media_link *link);
|
2009-12-09 04:40:03 -07:00
|
|
|
};
|
|
|
|
|
2015-08-29 20:43:03 -06:00
|
|
|
/**
|
|
|
|
* struct media_entity - A media entity graph object.
|
|
|
|
*
|
|
|
|
* @graph_obj: Embedded structure containing the media object common data.
|
|
|
|
* @name: Entity name.
|
2015-09-06 06:33:39 -06:00
|
|
|
* @function: Entity main function, as defined in uapi/media.h
|
|
|
|
* (MEDIA_ENT_F_*)
|
2015-08-29 20:43:03 -06:00
|
|
|
* @revision: Entity revision - OBSOLETE - should be removed soon.
|
|
|
|
* @flags: Entity flags, as defined in uapi/media.h (MEDIA_ENT_FL_*)
|
|
|
|
* @group_id: Entity group ID - OBSOLETE - should be removed soon.
|
|
|
|
* @num_pads: Number of sink and source pads.
|
|
|
|
* @num_links: Total number of links, forward and back, enabled and disabled.
|
|
|
|
* @num_backlinks: Number of backlinks
|
|
|
|
* @pads: Pads array with the size defined by @num_pads.
|
|
|
|
* @links: List of data links.
|
|
|
|
* @ops: Entity operations.
|
|
|
|
* @stream_count: Stream count for the entity.
|
|
|
|
* @use_count: Use count for the entity.
|
|
|
|
* @pipe: Pipeline this entity belongs to.
|
|
|
|
* @info: Union with devnode information. Kept just for backward
|
|
|
|
* compatibility.
|
|
|
|
* @major: Devnode major number (zero if not applicable). Kept just
|
|
|
|
* for backward compatibility.
|
|
|
|
* @minor: Devnode minor number (zero if not applicable). Kept just
|
|
|
|
* for backward compatibility.
|
|
|
|
*
|
|
|
|
* NOTE: @stream_count and @use_count reference counts must never be
|
|
|
|
* negative, but are signed integers on purpose: a simple WARN_ON(<0) check
|
|
|
|
* can be used to detect reference count bugs that would make them negative.
|
|
|
|
*/
|
2009-12-09 04:40:00 -07:00
|
|
|
struct media_entity {
|
2015-08-20 06:10:07 -06:00
|
|
|
struct media_gobj graph_obj; /* must be first field in struct */
|
2015-08-29 20:43:03 -06:00
|
|
|
const char *name;
|
2015-09-06 06:33:39 -06:00
|
|
|
u32 function;
|
2015-08-29 20:43:03 -06:00
|
|
|
u32 revision;
|
|
|
|
unsigned long flags;
|
|
|
|
u32 group_id;
|
2009-12-09 04:40:00 -07:00
|
|
|
|
2015-08-29 20:43:03 -06:00
|
|
|
u16 num_pads;
|
|
|
|
u16 num_links;
|
|
|
|
u16 num_backlinks;
|
2009-12-09 04:40:00 -07:00
|
|
|
|
2015-08-29 20:43:03 -06:00
|
|
|
struct media_pad *pads;
|
|
|
|
struct list_head links;
|
2009-12-09 04:40:00 -07:00
|
|
|
|
2015-08-29 20:43:03 -06:00
|
|
|
const struct media_entity_operations *ops;
|
2009-12-09 04:40:03 -07:00
|
|
|
|
2010-03-07 11:04:59 -07:00
|
|
|
/* Reference counts must never be negative, but are signed integers on
|
|
|
|
* purpose: a simple WARN_ON(<0) check can be used to detect reference
|
|
|
|
* count bugs that would make them negative.
|
|
|
|
*/
|
2015-08-29 20:43:03 -06:00
|
|
|
int stream_count;
|
|
|
|
int use_count;
|
2010-03-07 11:04:59 -07:00
|
|
|
|
2015-08-29 20:43:03 -06:00
|
|
|
struct media_pipeline *pipe;
|
2010-08-25 06:00:41 -06:00
|
|
|
|
2009-12-09 04:40:00 -07:00
|
|
|
union {
|
|
|
|
struct {
|
|
|
|
u32 major;
|
|
|
|
u32 minor;
|
[media] media: Fix DVB devnode representation at media controller
The previous provision for DVB media controller support were to
define an ID (likely meaning the adapter number) for the DVB
devnodes.
This is just plain wrong. Just like V4L, DVB devices (and any other
device node)) are uniquely identified via a (major, minor) tuple.
This is enough to uniquely identify a devnode, no matter what
API it implements.
So, before we go too far, let's mark the old v4l, fb, dvb and alsa
"devnode" info as deprecated, and just call it as "dev".
We can latter add fields specific to each API if needed.
As we don't want to break compilation on already existing apps,
let's just keep the old definitions as-is, adding a note that
those are deprecated at media-entity.h.
Signed-off-by: Mauro Carvalho Chehab <mchehab@osg.samsung.com>
2015-01-02 08:18:23 -07:00
|
|
|
} dev;
|
2011-11-05 15:42:01 -06:00
|
|
|
} info;
|
2009-12-09 04:40:00 -07:00
|
|
|
};
|
|
|
|
|
2015-08-20 06:07:34 -06:00
|
|
|
/**
|
2015-08-29 20:43:03 -06:00
|
|
|
* struct media_interface - A media interface graph object.
|
2015-08-20 06:07:34 -06:00
|
|
|
*
|
|
|
|
* @graph_obj: embedded graph object
|
2015-08-07 07:36:25 -06:00
|
|
|
* @links: List of links pointing to graph entities
|
2015-08-29 20:43:03 -06:00
|
|
|
* @type: Type of the interface as defined in the
|
2015-08-20 06:07:34 -06:00
|
|
|
* uapi/media/media.h header, e. g.
|
|
|
|
* MEDIA_INTF_T_*
|
2015-08-29 20:43:03 -06:00
|
|
|
* @flags: Interface flags as defined in uapi/media/media.h
|
2015-08-20 06:07:34 -06:00
|
|
|
*/
|
|
|
|
struct media_interface {
|
|
|
|
struct media_gobj graph_obj;
|
2015-08-07 07:36:25 -06:00
|
|
|
struct list_head links;
|
2015-08-20 06:07:34 -06:00
|
|
|
u32 type;
|
|
|
|
u32 flags;
|
|
|
|
};
|
|
|
|
|
|
|
|
/**
|
2015-08-29 20:43:03 -06:00
|
|
|
* struct media_intf_devnode - A media interface via a device node.
|
2015-08-20 06:07:34 -06:00
|
|
|
*
|
|
|
|
* @intf: embedded interface object
|
|
|
|
* @major: Major number of a device node
|
|
|
|
* @minor: Minor number of a device node
|
|
|
|
*/
|
|
|
|
struct media_intf_devnode {
|
|
|
|
struct media_interface intf;
|
2015-08-23 05:28:21 -06:00
|
|
|
|
|
|
|
/* Should match the fields at media_v2_intf_devnode */
|
2015-08-20 06:07:34 -06:00
|
|
|
u32 major;
|
|
|
|
u32 minor;
|
|
|
|
};
|
|
|
|
|
2015-08-14 07:42:05 -06:00
|
|
|
static inline u32 media_entity_id(struct media_entity *entity)
|
|
|
|
{
|
2015-08-14 09:47:48 -06:00
|
|
|
return entity->graph_obj.id;
|
2015-08-14 07:42:05 -06:00
|
|
|
}
|
|
|
|
|
2015-08-25 07:28:36 -06:00
|
|
|
static inline enum media_gobj_type media_type(struct media_gobj *gobj)
|
|
|
|
{
|
|
|
|
return gobj->id >> MEDIA_BITS_PER_LOCAL_ID;
|
|
|
|
}
|
|
|
|
|
|
|
|
static inline u32 media_localid(struct media_gobj *gobj)
|
|
|
|
{
|
|
|
|
return gobj->id & MEDIA_LOCAL_ID_MASK;
|
|
|
|
}
|
|
|
|
|
|
|
|
static inline u32 media_gobj_gen_id(enum media_gobj_type type, u32 local_id)
|
|
|
|
{
|
|
|
|
u32 id;
|
|
|
|
|
|
|
|
id = type << MEDIA_BITS_PER_LOCAL_ID;
|
|
|
|
id |= local_id & MEDIA_LOCAL_ID_MASK;
|
|
|
|
|
|
|
|
return id;
|
|
|
|
}
|
|
|
|
|
2015-08-21 09:17:40 -06:00
|
|
|
static inline bool is_media_entity_v4l2_io(struct media_entity *entity)
|
|
|
|
{
|
|
|
|
if (!entity)
|
|
|
|
return false;
|
|
|
|
|
2015-09-06 06:33:39 -06:00
|
|
|
switch (entity->function) {
|
2015-12-10 12:25:41 -07:00
|
|
|
case MEDIA_ENT_F_IO_V4L:
|
|
|
|
case MEDIA_ENT_F_IO_VBI:
|
|
|
|
case MEDIA_ENT_F_IO_SWRADIO:
|
2015-08-21 09:17:40 -06:00
|
|
|
return true;
|
|
|
|
default:
|
|
|
|
return false;
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
static inline bool is_media_entity_v4l2_subdev(struct media_entity *entity)
|
|
|
|
{
|
|
|
|
if (!entity)
|
|
|
|
return false;
|
|
|
|
|
2015-09-06 06:33:39 -06:00
|
|
|
switch (entity->function) {
|
2015-12-10 12:25:41 -07:00
|
|
|
case MEDIA_ENT_F_V4L2_SUBDEV_UNKNOWN:
|
|
|
|
case MEDIA_ENT_F_CAM_SENSOR:
|
|
|
|
case MEDIA_ENT_F_FLASH:
|
|
|
|
case MEDIA_ENT_F_LENS:
|
|
|
|
case MEDIA_ENT_F_ATV_DECODER:
|
|
|
|
case MEDIA_ENT_F_TUNER:
|
2015-08-21 09:17:40 -06:00
|
|
|
return true;
|
|
|
|
|
|
|
|
default:
|
|
|
|
return false;
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2010-03-07 12:14:14 -07:00
|
|
|
#define MEDIA_ENTITY_ENUM_MAX_DEPTH 16
|
2013-06-07 09:45:11 -06:00
|
|
|
#define MEDIA_ENTITY_ENUM_MAX_ID 64
|
2010-03-07 12:14:14 -07:00
|
|
|
|
2015-10-01 15:07:53 -06:00
|
|
|
/*
|
|
|
|
* The number of pads can't be bigger than the number of entities,
|
|
|
|
* as the worse-case scenario is to have one entity linked up to
|
|
|
|
* MEDIA_ENTITY_ENUM_MAX_ID - 1 entities.
|
|
|
|
*/
|
|
|
|
#define MEDIA_ENTITY_MAX_PADS (MEDIA_ENTITY_ENUM_MAX_ID - 1)
|
|
|
|
|
2010-03-07 12:14:14 -07:00
|
|
|
struct media_entity_graph {
|
|
|
|
struct {
|
|
|
|
struct media_entity *entity;
|
[media] media: convert links from array to list
The entire logic that represent graph links were developed on a
time where there were no needs to dynamic remove links. So,
although links are created/removed one by one via some
functions, they're stored as an array inside the entity struct.
As the array may grow, there's a logic inside the code that
checks if the amount of space is not enough to store
the needed links. If it isn't the core uses krealloc()
to change the size of the link, with is bad, as it
leaves the memory fragmented.
So, convert links into a list.
Also, currently, both source and sink entities need the link
at the graph traversal logic inside media_entity. So there's
a logic duplicating all links. That makes it to spend
twice the memory needed. This is not a big deal for today's
usage, where the number of links are not big.
Yet, if during the MC workshop discussions, it was said that
IIO graphs could have up to 4,000 entities. So, we may
want to remove the duplication on some future. The problem
is that it would require a separate linked list to store
the backlinks inside the entity, or to use a more complex
algorithm to do graph backlink traversal, with is something
that the current graph traversal inside the core can't cope
with. So, let's postpone a such change if/when it is actually
needed.
It should also be noticed that the media_link structure uses
44 bytes on 32-bit architectures and 84 bytes on 64-bit
architecture. It will thus be allocated out of the 64-bytes and
96-bytes pools respectively. That's a 12.5% memory waste on
64-bit architectures and 31.25% on 32-bit architecture.
A linked list is less efficient than an array in this case, but
this could later be optimized if we can get rid of the reverse
links (with would reduce memory allocation by 50%).
Signed-off-by: Mauro Carvalho Chehab <mchehab@osg.samsung.com>
2015-08-07 03:55:40 -06:00
|
|
|
struct list_head *link;
|
2010-03-07 12:14:14 -07:00
|
|
|
} stack[MEDIA_ENTITY_ENUM_MAX_DEPTH];
|
2013-06-07 09:45:11 -06:00
|
|
|
|
|
|
|
DECLARE_BITMAP(entities, MEDIA_ENTITY_ENUM_MAX_ID);
|
2010-03-07 12:14:14 -07:00
|
|
|
int top;
|
|
|
|
};
|
|
|
|
|
2015-08-25 07:28:36 -06:00
|
|
|
#define gobj_to_entity(gobj) \
|
|
|
|
container_of(gobj, struct media_entity, graph_obj)
|
|
|
|
|
2015-08-13 11:42:42 -06:00
|
|
|
#define gobj_to_pad(gobj) \
|
|
|
|
container_of(gobj, struct media_pad, graph_obj)
|
|
|
|
|
|
|
|
#define gobj_to_link(gobj) \
|
|
|
|
container_of(gobj, struct media_link, graph_obj)
|
|
|
|
|
2015-08-20 06:07:34 -06:00
|
|
|
#define gobj_to_link(gobj) \
|
|
|
|
container_of(gobj, struct media_link, graph_obj)
|
|
|
|
|
|
|
|
#define gobj_to_pad(gobj) \
|
|
|
|
container_of(gobj, struct media_pad, graph_obj)
|
|
|
|
|
|
|
|
#define gobj_to_intf(gobj) \
|
|
|
|
container_of(gobj, struct media_interface, graph_obj)
|
|
|
|
|
|
|
|
#define intf_to_devnode(intf) \
|
|
|
|
container_of(intf, struct media_intf_devnode, intf)
|
|
|
|
|
2015-08-25 07:28:36 -06:00
|
|
|
void media_gobj_init(struct media_device *mdev,
|
|
|
|
enum media_gobj_type type,
|
|
|
|
struct media_gobj *gobj);
|
|
|
|
void media_gobj_remove(struct media_gobj *gobj);
|
|
|
|
|
2009-12-09 04:40:00 -07:00
|
|
|
int media_entity_init(struct media_entity *entity, u16 num_pads,
|
[media] media: convert links from array to list
The entire logic that represent graph links were developed on a
time where there were no needs to dynamic remove links. So,
although links are created/removed one by one via some
functions, they're stored as an array inside the entity struct.
As the array may grow, there's a logic inside the code that
checks if the amount of space is not enough to store
the needed links. If it isn't the core uses krealloc()
to change the size of the link, with is bad, as it
leaves the memory fragmented.
So, convert links into a list.
Also, currently, both source and sink entities need the link
at the graph traversal logic inside media_entity. So there's
a logic duplicating all links. That makes it to spend
twice the memory needed. This is not a big deal for today's
usage, where the number of links are not big.
Yet, if during the MC workshop discussions, it was said that
IIO graphs could have up to 4,000 entities. So, we may
want to remove the duplication on some future. The problem
is that it would require a separate linked list to store
the backlinks inside the entity, or to use a more complex
algorithm to do graph backlink traversal, with is something
that the current graph traversal inside the core can't cope
with. So, let's postpone a such change if/when it is actually
needed.
It should also be noticed that the media_link structure uses
44 bytes on 32-bit architectures and 84 bytes on 64-bit
architecture. It will thus be allocated out of the 64-bytes and
96-bytes pools respectively. That's a 12.5% memory waste on
64-bit architectures and 31.25% on 32-bit architecture.
A linked list is less efficient than an array in this case, but
this could later be optimized if we can get rid of the reverse
links (with would reduce memory allocation by 50%).
Signed-off-by: Mauro Carvalho Chehab <mchehab@osg.samsung.com>
2015-08-07 03:55:40 -06:00
|
|
|
struct media_pad *pads);
|
2009-12-09 04:40:00 -07:00
|
|
|
void media_entity_cleanup(struct media_entity *entity);
|
2010-08-25 06:00:41 -06:00
|
|
|
|
2015-09-04 13:08:24 -06:00
|
|
|
__must_check int media_create_pad_link(struct media_entity *source,
|
|
|
|
u16 source_pad, struct media_entity *sink,
|
|
|
|
u16 sink_pad, u32 flags);
|
2013-05-09 05:29:32 -06:00
|
|
|
void __media_entity_remove_links(struct media_entity *entity);
|
|
|
|
void media_entity_remove_links(struct media_entity *entity);
|
|
|
|
|
2009-12-09 04:40:03 -07:00
|
|
|
int __media_entity_setup_link(struct media_link *link, u32 flags);
|
|
|
|
int media_entity_setup_link(struct media_link *link, u32 flags);
|
|
|
|
struct media_link *media_entity_find_link(struct media_pad *source,
|
|
|
|
struct media_pad *sink);
|
2013-06-03 02:16:13 -06:00
|
|
|
struct media_pad *media_entity_remote_pad(struct media_pad *pad);
|
2009-12-09 04:40:00 -07:00
|
|
|
|
2010-03-07 11:04:59 -07:00
|
|
|
struct media_entity *media_entity_get(struct media_entity *entity);
|
|
|
|
void media_entity_put(struct media_entity *entity);
|
|
|
|
|
2010-03-07 12:14:14 -07:00
|
|
|
void media_entity_graph_walk_start(struct media_entity_graph *graph,
|
|
|
|
struct media_entity *entity);
|
|
|
|
struct media_entity *
|
|
|
|
media_entity_graph_walk_next(struct media_entity_graph *graph);
|
2012-01-11 02:25:15 -07:00
|
|
|
__must_check int media_entity_pipeline_start(struct media_entity *entity,
|
|
|
|
struct media_pipeline *pipe);
|
2010-08-25 06:00:41 -06:00
|
|
|
void media_entity_pipeline_stop(struct media_entity *entity);
|
2010-03-07 12:14:14 -07:00
|
|
|
|
2015-09-04 12:34:19 -06:00
|
|
|
struct media_intf_devnode *
|
|
|
|
__must_check media_devnode_create(struct media_device *mdev,
|
|
|
|
u32 type, u32 flags,
|
2015-09-09 05:19:25 -06:00
|
|
|
u32 major, u32 minor);
|
2015-08-20 06:07:34 -06:00
|
|
|
void media_devnode_remove(struct media_intf_devnode *devnode);
|
2015-09-04 12:34:19 -06:00
|
|
|
struct media_link *
|
|
|
|
__must_check media_create_intf_link(struct media_entity *entity,
|
|
|
|
struct media_interface *intf,
|
|
|
|
u32 flags);
|
2015-08-29 18:23:44 -06:00
|
|
|
void __media_remove_intf_link(struct media_link *link);
|
2015-08-07 07:36:25 -06:00
|
|
|
void media_remove_intf_link(struct media_link *link);
|
2015-08-24 05:46:46 -06:00
|
|
|
void __media_remove_intf_links(struct media_interface *intf);
|
|
|
|
void media_remove_intf_links(struct media_interface *intf);
|
|
|
|
|
2015-08-07 07:36:25 -06:00
|
|
|
|
2009-12-09 04:40:03 -07:00
|
|
|
#define media_entity_call(entity, operation, args...) \
|
|
|
|
(((entity)->ops && (entity)->ops->operation) ? \
|
|
|
|
(entity)->ops->operation((entity) , ##args) : -ENOIOCTLCMD)
|
|
|
|
|
2009-12-09 04:40:00 -07:00
|
|
|
#endif
|