src/main.c

   1 /*
   2  * Media controller test application
   3  *
   4  * Copyright (C) 2010-2011 Ideas on board SPRL
   5  *
   6  * Contact: Laurent Pinchart <laurent.pinchart@ideasonboard.com>
   7  *
   8  * This program is free software; you can redistribute it and/or modify
   9  * it under the terms of the GNU Lesser General Public License as published
  10  * by the Free Software Foundation; either version 2.1 of the License, or
  11  * (at your option) any later version.
  12  *
  13  * This program is distributed in the hope that it will be useful,
  14  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  15  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  16  * GNU Lesser General Public License for more details.
  17  *
  18  * You should have received a copy of the GNU Lesser General Public License
  19  * along with this program. If not, see <http://www.gnu.org/licenses/>.
  20  */
  21
  22 #include <sys/ioctl.h>
  23 #include <sys/mman.h>
  24 #include <sys/stat.h>
  25 #include <sys/time.h>
  26
  27 #include <ctype.h>
  28 #include <errno.h>
  29 #include <fcntl.h>
  30 #include <stdbool.h>
  31 #include <stdio.h>
  32 #include <stdlib.h>
  33 #include <string.h>
  34 #include <unistd.h>
  35
  36 #include <linux/media.h>
  37 #include <linux/types.h>
  38 #include <linux/v4l2-mediabus.h>
  39 #include <linux/v4l2-subdev.h>
  40 #include <linux/videodev2.h>
  41
  42 #include "mediactl.h"
  43 #include "options.h"
  44 #include "tools.h"
  45 #include "v4l2subdev.h"
  46
  47 /* -----------------------------------------------------------------------------
  48  * Printing
  49  */
  50
  51 static void v4l2_subdev_print_format(struct media_entity *entity,
  52         unsigned int pad, enum v4l2_subdev_format_whence which)
  53 {
  54         struct v4l2_mbus_framefmt format;
  55         struct v4l2_rect rect;
  56         int ret;
  57
  58         ret = v4l2_subdev_get_format(entity, &format, pad, which);
  59         if (ret != 0)
  60                 return;
  61
  62         printf("\t\t[fmt:%s/%ux%u",
  63                v4l2_subdev_pixelcode_to_string(format.code),
  64                format.width, format.height);
  65
  66         ret = v4l2_subdev_get_selection(entity, &rect, pad,
  67                                         V4L2_SEL_TGT_CROP_BOUNDS,
  68                                         which);
  69         if (ret == 0)
  70                 printf("\n\t\t crop.bounds:(%u,%u)/%ux%u", rect.left, rect.top,
  71                        rect.width, rect.height);
  72
  73         ret = v4l2_subdev_get_selection(entity, &rect, pad,
  74                                         V4L2_SEL_TGT_CROP,
  75                                         which);
  76         if (ret == 0)
  77                 printf("\n\t\t crop:(%u,%u)/%ux%u", rect.left, rect.top,
  78                        rect.width, rect.height);
  79
  80         ret = v4l2_subdev_get_selection(entity, &rect, pad,
  81                                         V4L2_SEL_TGT_COMPOSE_BOUNDS,
  82                                         which);
  83         if (ret == 0)
  84                 printf("\n\t\t compose.bounds:(%u,%u)/%ux%u",
  85                        rect.left, rect.top, rect.width, rect.height);
  86
  87         ret = v4l2_subdev_get_selection(entity, &rect, pad,
  88                                         V4L2_SEL_TGT_COMPOSE,
  89                                         which);
  90         if (ret == 0)
  91                 printf("\n\t\t compose:(%u,%u)/%ux%u",
  92                        rect.left, rect.top, rect.width, rect.height);
  93
  94         printf("]\n");
  95 }
  96
  97 static const char *media_entity_type_to_string(unsigned type)
  98 {
  99         static const struct {
 100                 __u32 type;
 101                 const char *name;
 102         } types[] = {
 103                 { MEDIA_ENT_T_DEVNODE, "Node" },
 104                 { MEDIA_ENT_T_V4L2_SUBDEV, "V4L2 subdev" },
 105         };
 106
 107         unsigned int i;
 108
 109         type &= MEDIA_ENT_TYPE_MASK;
 110
 111         for (i = 0; i < ARRAY_SIZE(types); i++) {
 112                 if (types[i].type == type)
 113                         return types[i].name;
 114         }
 115
 116         return "Unknown";
 117 }
 118
 119 static const char *media_entity_subtype_to_string(unsigned type)
 120 {
 121         static const char *node_types[] = {
 122                 "Unknown",
 123                 "V4L",
 124                 "FB",
 125                 "ALSA",
 126                 "DVB",
 127         };
 128         static const char *subdev_types[] = {
 129                 "Unknown",
 130                 "Sensor",
 131                 "Flash",
 132                 "Lens",
 133         };
 134
 135         unsigned int subtype = type & MEDIA_ENT_SUBTYPE_MASK;
 136
 137         switch (type & MEDIA_ENT_TYPE_MASK) {
 138         case MEDIA_ENT_T_DEVNODE:
 139                 if (subtype >= ARRAY_SIZE(node_types))
 140                         subtype = 0;
 141                 return node_types[subtype];
 142
 143         case MEDIA_ENT_T_V4L2_SUBDEV:
 144                 if (subtype >= ARRAY_SIZE(subdev_types))
 145                         subtype = 0;
 146                 return subdev_types[subtype];
 147         default:
 148                 return node_types[0];
 149         }
 150 }
 151
 152 static const char *media_pad_type_to_string(unsigned flag)
 153 {
 154         static const struct {
 155                 __u32 flag;
 156                 const char *name;
 157         } flags[] = {
 158                 { MEDIA_PAD_FL_SINK, "Sink" },
 159                 { MEDIA_PAD_FL_SOURCE, "Source" },
 160         };
 161
 162         unsigned int i;
 163
 164         for (i = 0; i < ARRAY_SIZE(flags); i++) {
 165                 if (flags[i].flag & flag)
 166                         return flags[i].name;
 167         }
 168
 169         return "Unknown";
 170 }
 171
 172 static void media_print_topology_dot(struct media_device *media)
 173 {
 174         unsigned int i, j;
 175
 176         printf("digraph board {\n");
 177         printf("\trankdir=TB\n");
 178
 179         for (i = 0; i < media->entities_count; ++i) {
 180                 struct media_entity *entity = &media->entities[i];
 181                 unsigned int npads;
 182
 183                 switch (media_entity_type(entity)) {
 184                 case MEDIA_ENT_T_DEVNODE:
 185                         printf("\tn%08x [label=\"%s\\n%s\", shape=box, style=filled, "
 186                                "fillcolor=yellow]\n",
 187                                entity->info.id, entity->info.name, entity->devname);
 188                         break;
 189
 190                 case MEDIA_ENT_T_V4L2_SUBDEV:
 191                         printf("\tn%08x [label=\"{{", entity->info.id);
 192
 193                         for (j = 0, npads = 0; j < entity->info.pads; ++j) {
 194                                 if (!(entity->pads[j].flags & MEDIA_PAD_FL_SINK))
 195                                         continue;
 196
 197                                 printf("%s<port%u> %u", npads ? " | " : "", j, j);
 198                                 npads++;
 199                         }
 200
 201                         printf("} | %s", entity->info.name);
 202                         if (entity->devname)
 203                                 printf("\\n%s", entity->devname);
 204                         printf(" | {");
 205
 206                         for (j = 0, npads = 0; j < entity->info.pads; ++j) {
 207                                 if (!(entity->pads[j].flags & MEDIA_PAD_FL_SOURCE))
 208                                         continue;
 209
 210                                 printf("%s<port%u> %u", npads ? " | " : "", j, j);
 211                                 npads++;
 212                         }
 213
 214                         printf("}}\", shape=Mrecord, style=filled, fillcolor=green]\n");
 215                         break;
 216
 217                 default:
 218                         continue;
 219                 }
 220
 221                 for (j = 0; j < entity->num_links; j++) {
 222                         struct media_link *link = &entity->links[j];
 223
 224                         if (link->source->entity != entity)
 225                                 continue;
 226
 227                         printf("\tn%08x", link->source->entity->info.id);
 228                         if (media_entity_type(link->source->entity) == MEDIA_ENT_T_V4L2_SUBDEV)
 229                                 printf(":port%u", link->source->index);
 230                         printf(" -> ");
 231                         printf("n%08x", link->sink->entity->info.id);
 232                         if (media_entity_type(link->sink->entity) == MEDIA_ENT_T_V4L2_SUBDEV)
 233                                 printf(":port%u", link->sink->index);
 234
 235                         if (link->flags & MEDIA_LNK_FL_IMMUTABLE)
 236                                 printf(" [style=bold]");
 237                         else if (!(link->flags & MEDIA_LNK_FL_ENABLED))
 238                                 printf(" [style=dashed]");
 239                         printf("\n");
 240                 }
 241         }
 242
 243         printf("}\n");
 244 }
 245
 246 static void media_print_topology_text(struct media_device *media)
 247 {
 248         static const struct {
 249                 __u32 flag;
 250                 char *name;
 251         } link_flags[] = {
 252                 { MEDIA_LNK_FL_ENABLED, "ENABLED" },
 253                 { MEDIA_LNK_FL_IMMUTABLE, "IMMUTABLE" },
 254                 { MEDIA_LNK_FL_DYNAMIC, "DYNAMIC" },
 255         };
 256
 257         unsigned int i, j, k;
 258         unsigned int padding;
 259
 260         printf("Device topology\n");
 261
 262         for (i = 0; i < media->entities_count; ++i) {
 263                 struct media_entity *entity = &media->entities[i];
 264
 265                 padding = printf("- entity %u: ", entity->info.id);
 266                 printf("%s (%u pad%s, %u link%s)\n", entity->info.name,
 267                         entity->info.pads, entity->info.pads > 1 ? "s" : "",
 268                         entity->num_links, entity->num_links > 1 ? "s" : "");
 269                 printf("%*ctype %s subtype %s flags %x\n", padding, ' ',
 270                         media_entity_type_to_string(entity->info.type),
 271                         media_entity_subtype_to_string(entity->info.type),
 272                         entity->info.flags);
 273                 if (entity->devname[0])
 274                         printf("%*cdevice node name %s\n", padding, ' ', entity->devname);
 275
 276                 for (j = 0; j < entity->info.pads; j++) {
 277                         struct media_pad *pad = &entity->pads[j];
 278
 279                         printf("\tpad%u: %s\n", j, media_pad_type_to_string(pad->flags));
 280
 281                         if (media_entity_type(entity) == MEDIA_ENT_T_V4L2_SUBDEV)
 282                                 v4l2_subdev_print_format(entity, j, V4L2_SUBDEV_FORMAT_ACTIVE);
 283
 284                         for (k = 0; k < entity->num_links; k++) {
 285                                 struct media_link *link = &entity->links[k];
 286                                 struct media_pad *source = link->source;
 287                                 struct media_pad *sink = link->sink;
 288                                 bool first = true;
 289                                 unsigned int i;
 290
 291                                 if (source->entity == entity && source->index == j)
 292                                         printf("\t\t-> \"%s\":%u [",
 293                                                 sink->entity->info.name, sink->index);
 294                                 else if (sink->entity == entity && sink->index == j)
 295                                         printf("\t\t<- \"%s\":%u [",
 296                                                 source->entity->info.name, source->index);
 297                                 else
 298                                         continue;
 299
 300                                 for (i = 0; i < ARRAY_SIZE(link_flags); i++) {
 301                                         if (!(link->flags & link_flags[i].flag))
 302                                                 continue;
 303                                         if (!first)
 304                                                 printf(",");
 305                                         printf("%s", link_flags[i].name);
 306                                         first = false;
 307                                 }
 308
 309                                 printf("]\n");
 310                         }
 311                 }
 312                 printf("\n");
 313         }
 314 }
 315
 316 void media_print_topology(struct media_device *media, int dot)
 317 {
 318         if (dot)
 319                 media_print_topology_dot(media);
 320         else
 321                 media_print_topology_text(media);
 322 }
 323
 324 int main(int argc, char **argv)
 325 {
 326         struct media_device *media;
 327         int ret = -1;
 328
 329         if (parse_cmdline(argc, argv))
 330                 return EXIT_FAILURE;
 331
 332         /* Open the media device and enumerate entities, pads and links. */
 333         if (media_opts.verbose)
 334                 media = media_open_debug(
 335                         media_opts.devname,
 336                         (void (*)(void *, ...))fprintf, stdout);
 337         else
 338                 media = media_open(media_opts.devname);
 339         if (media == NULL) {
 340                 printf("Failed to open %s\n", media_opts.devname);
 341                 goto out;
 342         }
 343
 344         if (media_opts.print) {
 345                 printf("Media controller API version %u.%u.%u\n\n",
 346                        (media->info.media_version << 16) & 0xff,
 347                        (media->info.media_version << 8) & 0xff,
 348                        (media->info.media_version << 0) & 0xff);
 349                 printf("Media device information\n"
 350                        "------------------------\n"
 351                        "driver          %s\n"
 352                        "model           %s\n"
 353                        "serial          %s\n"
 354                        "bus info        %s\n"
 355                        "hw revision     0x%x\n"
 356                        "driver version  %u.%u.%u\n\n",
 357                        media->info.driver, media->info.model,
 358                        media->info.serial, media->info.bus_info,
 359                        media->info.hw_revision,
 360                        (media->info.driver_version << 16) & 0xff,
 361                        (media->info.driver_version << 8) & 0xff,
 362                        (media->info.driver_version << 0) & 0xff);
 363         }
 364
 365         if (media_opts.entity) {
 366                 struct media_entity *entity;
 367
 368                 entity = media_get_entity_by_name(media, media_opts.entity,
 369                                                   strlen(media_opts.entity));
 370                 if (entity == NULL) {
 371                         printf("Entity '%s' not found\n", media_opts.entity);
 372                         goto out;
 373                 }
 374
 375                 printf("%s\n", entity->devname);
 376         }
 377
 378         if (media_opts.pad) {
 379                 struct media_pad *pad;
 380
 381                 pad = media_parse_pad(media, media_opts.pad, NULL);
 382                 if (pad == NULL) {
 383                         printf("Pad '%s' not found\n", media_opts.pad);
 384                         goto out;
 385                 }
 386
 387                 v4l2_subdev_print_format(pad->entity, pad->index,
 388                                          V4L2_SUBDEV_FORMAT_ACTIVE);
 389         }
 390
 391         if (media_opts.print || media_opts.print_dot) {
 392                 media_print_topology(media, media_opts.print_dot);
 393                 printf("\n");
 394         }
 395
 396         if (media_opts.reset) {
 397                 if (media_opts.verbose)
 398                         printf("Resetting all links to inactive\n");
 399                 ret = media_reset_links(media);
 400                 if (ret) {
 401                         printf("Unable to reset links: %s (%d)\n",
 402                                strerror(-ret), -ret);
 403                         goto out;
 404                 }
 405         }
 406
 407         if (media_opts.links) {
 408                 ret = media_parse_setup_links(media, media_opts.links);
 409                 if (ret) {
 410                         printf("Unable to parse link: %s (%d)\n",
 411                                strerror(-ret), -ret);
 412                         goto out;
 413                 }
 414         }
 415
 416         if (media_opts.formats) {
 417                 ret = v4l2_subdev_parse_setup_formats(media,
 418                                                       media_opts.formats);
 419                 if (ret) {
 420                         printf("Unable to parse format: %s (%d)\n",
 421                                strerror(-ret), -ret);
 422                         goto out;
 423                 }
 424         }
 425
 426         if (media_opts.interactive) {
 427                 while (1) {
 428                         char buffer[32];
 429                         char *end;
 430
 431                         printf("Enter a link to modify or enter to stop\n");
 432                         if (fgets(buffer, sizeof buffer, stdin) == NULL)
 433                                 break;
 434
 435                         if (buffer[0] == '\n')
 436                                 break;
 437
 438                         ret = media_parse_setup_link(media, buffer, &end);
 439                         if (ret)
 440                                 printf("Unable to parse link: %s (%d)\n",
 441                                        strerror(-ret), -ret);
 442                 }
 443         }
 444
 445         ret = 0;
 446
 447 out:
 448         if (media)
 449                 media_close(media);
 450
 451         return ret ? EXIT_FAILURE : EXIT_SUCCESS;
 452 }
 453