session_driver.c

   1 /*
   2  * This file is part of the sigrok project.
   3  *
   4  * Copyright (C) 2010-2012 Bert Vermeulen <bert@biot.com>
   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 3 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, see <http://www.gnu.org/licenses/>.
  18  */
  19
  20 #include <sys/types.h>
  21 #include <sys/stat.h>
  22 #include <fcntl.h>
  23 #include <unistd.h>
  24 #include <sys/time.h>
  25 #include <zip.h>
  26 #include "libsigrok.h"
  27 #include "libsigrok-internal.h"
  28
  29 /* size of payloads sent across the session bus */
  30 #define CHUNKSIZE (512 * 1024)
  31
  32 struct session_vdev {
  33         char *sessionfile;
  34         char *capturefile;
  35         struct zip *archive;
  36         struct zip_file *capfile;
  37         int bytes_read;
  38         uint64_t samplerate;
  39         int unitsize;
  40         int num_probes;
  41 };
  42
  43 static GSList *dev_insts = NULL;
  44 static const int hwcaps[] = {
  45         SR_HWCAP_CAPTUREFILE,
  46         SR_HWCAP_CAPTURE_UNITSIZE,
  47         0,
  48 };
  49
  50 /**
  51  * TODO.
  52  *
  53  * @param dev_index TODO.
  54  */
  55 static struct session_vdev *get_vdev_by_index(int dev_index)
  56 {
  57         struct sr_dev_inst *sdi;
  58         struct session_vdev *vdev;
  59
  60         /* TODO: Sanity checks on dev_index. */
  61
  62         if (!(sdi = sr_dev_inst_get(dev_insts, dev_index))) {
  63                 sr_err("session driver: %s: device instance with device "
  64                        "index %d was not found", __func__, dev_index);
  65                 return NULL;
  66         }
  67
  68         /* TODO: Is sdi->priv == NULL valid? */
  69
  70         vdev = sdi->priv;
  71
  72         return vdev;
  73 }
  74
  75 /**
  76  * TODO.
  77  *
  78  * @param fd TODO.
  79  * @param revents TODO.
  80  * @param cb_data TODO.
  81  *
  82  * @return TODO.
  83  */
  84 static int receive_data(int fd, int revents, void *cb_data)
  85 {
  86         struct sr_dev_inst *sdi;
  87         struct session_vdev *vdev;
  88         struct sr_datafeed_packet packet;
  89         struct sr_datafeed_logic logic;
  90         GSList *l;
  91         void *buf;
  92         int ret, got_data;
  93
  94         /* Avoid compiler warnings. */
  95         (void)fd;
  96         (void)revents;
  97
  98         sr_dbg("session_driver: feed chunk");
  99
 100         got_data = FALSE;
 101         for (l = dev_insts; l; l = l->next) {
 102                 sdi = l->data;
 103                 vdev = sdi->priv;
 104                 if (!vdev)
 105                         /* already done with this instance */
 106                         continue;
 107
 108                 if (!(buf = g_try_malloc(CHUNKSIZE))) {
 109                         sr_err("session driver: %s: buf malloc failed",
 110                                __func__);
 111                         return FALSE; /* TODO: SR_ERR_MALLOC */
 112                 }
 113
 114                 ret = zip_fread(vdev->capfile, buf, CHUNKSIZE);
 115                 if (ret > 0) {
 116                         got_data = TRUE;
 117                         packet.type = SR_DF_LOGIC;
 118                         packet.payload = &logic;
 119                         logic.length = ret;
 120                         logic.unitsize = vdev->unitsize;
 121                         logic.data = buf;
 122                         vdev->bytes_read += ret;
 123                         sr_session_send(cb_data, &packet);
 124                 } else {
 125                         /* done with this capture file */
 126                         zip_fclose(vdev->capfile);
 127                         g_free(vdev->capturefile);
 128                         g_free(vdev);
 129                         sdi->priv = NULL;
 130                 }
 131         }
 132
 133         if (!got_data) {
 134                 packet.type = SR_DF_END;
 135                 sr_session_send(cb_data, &packet);
 136         }
 137
 138         return TRUE;
 139 }
 140
 141 /* driver callbacks */
 142 static int hw_cleanup(void);
 143
 144 /**
 145  * TODO.
 146  *
 147  * @param devinfo TODO.
 148  *
 149  * @return TODO.
 150  */
 151 static int hw_init(void)
 152 {
 153
 154         return SR_OK;
 155 }
 156
 157 /**
 158  * TODO.
 159  */
 160 static int hw_cleanup(void)
 161 {
 162         GSList *l;
 163
 164         for (l = dev_insts; l; l = l->next)
 165                 sr_dev_inst_free(l->data);
 166         g_slist_free(dev_insts);
 167         dev_insts = NULL;
 168
 169         sr_session_source_remove(-1);
 170
 171         return SR_OK;
 172 }
 173
 174 static int hw_dev_open(int dev_index)
 175 {
 176         struct sr_dev_inst *sdi;
 177
 178         sdi = sr_dev_inst_new(dev_index, SR_ST_INITIALIZING,
 179                               NULL, NULL, NULL);
 180         if (!sdi)
 181                 return SR_ERR;
 182
 183         if (!(sdi->priv = g_try_malloc0(sizeof(struct session_vdev)))) {
 184                 sr_err("session driver: %s: sdi->priv malloc failed", __func__);
 185                 return SR_ERR_MALLOC;
 186         }
 187
 188         dev_insts = g_slist_append(dev_insts, sdi);
 189
 190         return SR_OK;
 191 }
 192
 193 static const void *hw_dev_info_get(int dev_index, int dev_info_id)
 194 {
 195         struct session_vdev *vdev;
 196         void *info;
 197
 198         if (dev_info_id != SR_DI_CUR_SAMPLERATE)
 199                 return NULL;
 200
 201         if (!(vdev = get_vdev_by_index(dev_index)))
 202                 return NULL;
 203
 204         info = &vdev->samplerate;
 205
 206         return info;
 207 }
 208
 209 static int hw_dev_status_get(int dev_index)
 210 {
 211         /* Avoid compiler warnings. */
 212         (void)dev_index;
 213
 214         if (sr_dev_list() != NULL)
 215                 return SR_OK;
 216         else
 217                 return SR_ERR;
 218 }
 219
 220 /**
 221  * Get the list of hardware capabilities.
 222  *
 223  * @return A pointer to the (hardware) capabilities of this virtual session
 224  *         driver. This could be NULL, if no such capabilities exist.
 225  */
 226 static const int *hw_hwcap_get_all(void)
 227 {
 228         return hwcaps;
 229 }
 230
 231 static int hw_dev_config_set(int dev_index, int hwcap, const void *value)
 232 {
 233         struct session_vdev *vdev;
 234         const uint64_t *tmp_u64;
 235
 236         if (!(vdev = get_vdev_by_index(dev_index)))
 237                 return SR_ERR;
 238
 239         switch (hwcap) {
 240         case SR_HWCAP_SAMPLERATE:
 241                 tmp_u64 = value;
 242                 vdev->samplerate = *tmp_u64;
 243                 sr_info("session driver: setting samplerate to %" PRIu64,
 244                         vdev->samplerate);
 245                 break;
 246         case SR_HWCAP_SESSIONFILE:
 247                 vdev->sessionfile = g_strdup(value);
 248                 sr_info("session driver: setting sessionfile to %s",
 249                         vdev->sessionfile);
 250                 break;
 251         case SR_HWCAP_CAPTUREFILE:
 252                 vdev->capturefile = g_strdup(value);
 253                 sr_info("session driver: setting capturefile to %s",
 254                         vdev->capturefile);
 255                 break;
 256         case SR_HWCAP_CAPTURE_UNITSIZE:
 257                 tmp_u64 = value;
 258                 vdev->unitsize = *tmp_u64;
 259                 break;
 260         case SR_HWCAP_CAPTURE_NUM_PROBES:
 261                 tmp_u64 = value;
 262                 vdev->num_probes = *tmp_u64;
 263                 break;
 264         default:
 265                 sr_err("session driver: %s: unknown capability %d requested",
 266                        __func__, hwcap);
 267                 return SR_ERR;
 268         }
 269
 270         return SR_OK;
 271 }
 272
 273 static int hw_dev_acquisition_start(int dev_index, void *cb_data)
 274 {
 275         struct zip_stat zs;
 276         struct session_vdev *vdev;
 277         struct sr_datafeed_header *header;
 278         struct sr_datafeed_packet *packet;
 279         struct sr_datafeed_meta_logic meta;
 280         int ret;
 281
 282         if (!(vdev = get_vdev_by_index(dev_index)))
 283                 return SR_ERR;
 284
 285         sr_info("session_driver: opening archive %s file %s", vdev->sessionfile,
 286                 vdev->capturefile);
 287
 288         if (!(vdev->archive = zip_open(vdev->sessionfile, 0, &ret))) {
 289                 sr_err("session driver: Failed to open session file '%s': "
 290                        "zip error %d\n", vdev->sessionfile, ret);
 291                 return SR_ERR;
 292         }
 293
 294         if (zip_stat(vdev->archive, vdev->capturefile, 0, &zs) == -1) {
 295                 sr_err("session driver: Failed to check capture file '%s' in "
 296                        "session file '%s'.", vdev->capturefile, vdev->sessionfile);
 297                 return SR_ERR;
 298         }
 299
 300         if (!(vdev->capfile = zip_fopen(vdev->archive, vdev->capturefile, 0))) {
 301                 sr_err("session driver: Failed to open capture file '%s' in "
 302                        "session file '%s'.", vdev->capturefile, vdev->sessionfile);
 303                 return SR_ERR;
 304         }
 305
 306         /* freewheeling source */
 307         sr_session_source_add(-1, 0, 0, receive_data, cb_data);
 308
 309         if (!(packet = g_try_malloc(sizeof(struct sr_datafeed_packet)))) {
 310                 sr_err("session driver: %s: packet malloc failed", __func__);
 311                 return SR_ERR_MALLOC;
 312         }
 313
 314         if (!(header = g_try_malloc(sizeof(struct sr_datafeed_header)))) {
 315                 sr_err("session driver: %s: header malloc failed", __func__);
 316                 return SR_ERR_MALLOC;
 317         }
 318
 319         /* Send header packet to the session bus. */
 320         packet->type = SR_DF_HEADER;
 321         packet->payload = (unsigned char *)header;
 322         header->feed_version = 1;
 323         gettimeofday(&header->starttime, NULL);
 324         sr_session_send(cb_data, packet);
 325
 326         /* Send metadata about the SR_DF_LOGIC packets to come. */
 327         packet->type = SR_DF_META_LOGIC;
 328         packet->payload = &meta;
 329         meta.samplerate = vdev->samplerate;
 330         meta.num_probes = vdev->num_probes;
 331         sr_session_send(cb_data, packet);
 332
 333         g_free(header);
 334         g_free(packet);
 335
 336         return SR_OK;
 337 }
 338
 339 SR_PRIV struct sr_dev_driver session_driver = {
 340         .name = "session",
 341         .longname = "Session-emulating driver",
 342         .api_version = 1,
 343         .init = hw_init,
 344         .cleanup = hw_cleanup,
 345         .dev_open = hw_dev_open,
 346         .dev_close = NULL,
 347         .dev_info_get = hw_dev_info_get,
 348         .dev_status_get = hw_dev_status_get,
 349         .hwcap_get_all = hw_hwcap_get_all,
 350         .dev_config_set = hw_dev_config_set,
 351         .dev_acquisition_start = hw_dev_acquisition_start,
 352         .dev_acquisition_stop = NULL,
 353 };