decode: accept annotation rows for -A specs
authorGerhard Sittig <gerhard.sittig@gmx.net>
Fri, 19 Apr 2019 14:50:39 +0000 (16:50 +0200)
committerUwe Hermann <uwe@hermann-uwe.de>
Thu, 9 May 2019 12:58:19 +0000 (14:58 +0200)
Extend the logic which parses -A annotation selection specs. Lookup
annotation classes first for backwards compatibility. Then lookup rows
when classes don't match.

Users can mix classes and rows in -A specs as they like. This is a
convenience feature, to eliminate the tedium of spelling out many
classes when a row is to be shown. Which is useful to only see the
"summary", the uppermost protocol layer within a protocol decoder, while
the individual bits on lower layers of that same protocol decoder are
not of interest. It's more accessible to specify

  -A ir_rc5=fields
  -A ac97=slots-out
  -A i2c=addr-data

instead of

  -A ir_rc5=startbit1:startbit2:togglebit-0:togglebit-1:address:command
  -A ac97=slot-out-tag:slot-out-cmd-addr:slot-out-cmd-data:slot-out-03:slot-out-04:slot-out-05:slot-out-06:slot-out-07:slot-out-08:slot-out-09:slot-out-10:slot-out-11:slot-out-io-ctrl
  -A i2c=start:repeat-start:stop:ack:nack:address-read:address-write:data-read:data-write

As an additional benefit row specs remain stable across decoder updates
which introduce new annotation classes on existing rows.

decode.c

index c885824..225162a 100644 (file)
--- a/decode.c
+++ b/decode.c
@@ -313,6 +313,8 @@ int setup_pd_annotations(char *opt_pd_annotations)
        const char *dec_id;
        const char *ann_txt;
        const char *ann_id;
+       const struct srd_decoder_annotation_row *row_desc;
+       char **ann_diag;
 
        /* Set up custom list of PDs and annotations to show. */
        pds = g_strsplit(opt_pd_annotations, ",", 0);
@@ -336,6 +338,7 @@ int setup_pd_annotations(char *opt_pd_annotations)
                        annlist = g_strsplit(ann_txt, ":", 0);
                        for (ann = annlist; *ann && **ann; ann++) {
                                ann_id = *ann;
+                               g_debug("cli: Lookup decoder %s annotation %s.", dec_id, ann_id);
                                /* Lookup annotation class. */
                                ann_class = 0;
                                for (l = dec->annotations; l; l = l->next, ann_class++) {
@@ -352,6 +355,32 @@ int setup_pd_annotations(char *opt_pd_annotations)
                                                        "class %d (%s).", dec_id, ann_class, ann_descr[0]);
                                        continue;
                                }
+                               /* Lookup annotation row. */
+                               for (l = dec->annotation_rows; l; l = l->next) {
+                                       row_desc = l->data;
+                                       if (!canon_cmp(row_desc->id, ann_id))
+                                               break;
+                               }
+                               if (l) {
+                                       g_debug("cli: Showing decoder %s annotation row %s (%s).",
+                                               dec_id, row_desc->id, row_desc->desc);
+                                       l_ann = g_hash_table_lookup(pd_ann_visible, dec_id);
+                                       for (l = row_desc->ann_classes; l; l = l->next) {
+                                               /*
+                                                * This could just be:
+                                                *   l_ann = g_slist_append(l_ann, l->data);
+                                                * But we are explicit for readability
+                                                * and to access details for diagnostics.
+                                                */
+                                               ann_class = GPOINTER_TO_INT(l->data);
+                                               l_ann = g_slist_append(l_ann, GINT_TO_POINTER(ann_class));
+                                               ann_diag = g_slist_nth_data(dec->annotations, ann_class);
+                                               g_debug("cli: Adding class %d/%s from row %s.",
+                                                       ann_class, ann_diag[0], row_desc->id);
+                                       }
+                                       g_hash_table_replace(pd_ann_visible, g_strdup(dec_id), l_ann);
+                                       continue;
+                               }
                                /* No match found. */
                                g_critical("Annotation '%s' not found "
                                                "for protocol decoder '%s'.", ann_id, dec_id);