output/common.c

   1 /*
   2  * This file is part of the sigrok project.
   3  *
   4  * Copyright (C) 2010 Uwe Hermann <uwe@hermann-uwe.de>
   5  *
   6  * This program is free software; you can redistribute it and/or modify
   7  * it under the terms of the GNU General Public License as published by
   8  * the Free Software Foundation; either version 2 of the License, or
   9  * (at your option) any later version.
  10  *
  11  * This program is distributed in the hope that it will be useful,
  12  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  13  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  14  * GNU General Public License for more details.
  15  *
  16  * You should have received a copy of the GNU General Public License
  17  * along with this program; if not, write to the Free Software
  18  * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301 USA
  19  */
  20
  21 #include <stdint.h>
  22 #include <stdlib.h>
  23 #include <string.h>
  24 #include <sigrok.h>
  25
  26 /**
  27  * Convert a numeric samplerate value to its "natural" string representation.
  28  *
  29  * E.g. a value of 3000000 would be converted to "3 MHz", 20000 to "20 kHz".
  30  *
  31  * @param samplerate The samplerate in Hz.
  32  * @return A malloc()ed string representation of the samplerate value,
  33  *         or NULL upon errors. The caller is responsible to free() the memory.
  34  */
  35 char *sigrok_samplerate_string(uint64_t samplerate)
  36 {
  37         char *o;
  38         int r;
  39
  40         o = malloc(30 + 1); /* Enough for a uint64_t as string + " GHz". */
  41         if (!o)
  42                 return NULL;
  43
  44         if (samplerate >= GHZ(1))
  45                 r = snprintf(o, 30, "%" PRIu64 " GHz", samplerate / 1000000000);
  46         else if (samplerate >= MHZ(1))
  47                 r = snprintf(o, 30, "%" PRIu64 " MHz", samplerate / 1000000);
  48         else if (samplerate >= KHZ(1))
  49                 r = snprintf(o, 30, "%" PRIu64 " kHz", samplerate / 1000);
  50         else
  51                 r = snprintf(o, 30, "%" PRIu64 " Hz", samplerate);
  52
  53         if (r < 0) {
  54                 /* Something went wrong... */
  55                 free(o);
  56                 return NULL;
  57         }
  58
  59         return o;
  60 }
  61
  62 /**
  63  * Convert a numeric samplerate value to the "natural" string representation
  64  * of its period.
  65  *
  66  * E.g. a value of 3000000 would be converted to "3 us", 20000 to "50 ms".
  67  *
  68  * @param frequency The frequency in Hz.
  69  * @return A malloc()ed string representation of the frequency value,
  70  *         or NULL upon errors. The caller is responsible to free() the memory.
  71  */
  72 char *sigrok_period_string(uint64_t frequency)
  73 {
  74         char *o;
  75         int r;
  76
  77         o = malloc(30 + 1); /* Enough for a uint64_t as string + " ms". */
  78         if (!o)
  79                 return NULL;
  80
  81         if (frequency >= GHZ(1))
  82                 r = snprintf(o, 30, "%" PRIu64 " ns", frequency / 1000000000);
  83         else if (frequency >= MHZ(1))
  84                 r = snprintf(o, 30, "%" PRIu64 " us", frequency / 1000000);
  85         else if (frequency >= KHZ(1))
  86                 r = snprintf(o, 30, "%" PRIu64 " ms", frequency / 1000);
  87         else
  88                 r = snprintf(o, 30, "%" PRIu64 " s", frequency);
  89
  90         if (r < 0) {
  91                 /* Something went wrong... */
  92                 free(o);
  93                 return NULL;
  94         }
  95
  96         return o;
  97 }