source/drv-api.c

   1 /*
   2  * This file is part of the libsigrok project.
   3  *
   4  * Copyright (C) ${year} ${author} <${email}>
   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 <glib.h>
  21 #include "libsigrok.h"
  22 #include "libsigrok-internal.h"
  23 #include "protocol.h"
  24
  25 SR_PRIV struct sr_dev_driver driver_info;
  26 static struct sr_dev_driver *di = &${lib}_driver_info;
  27
  28 /* Properly close and free all devices. */
  29 static int clear_instances(void)
  30 {
  31         struct sr_dev_inst *sdi;
  32         struct drv_context *drvc;
  33         struct dev_context *devc;
  34         GSList *l;
  35
  36         drvc = di->priv;
  37         for (l = drvc->instances; l; l = l->next) {
  38                 if (!(sdi = l->data))
  39                         continue;
  40                 if (!(devc = sdi->priv))
  41                         continue;
  42
  43                 /* TODO */
  44
  45                 sr_dev_inst_free(sdi);
  46         }
  47
  48         g_slist_free(drvc->instances);
  49         drvc->instances = NULL;
  50
  51         return SR_OK;
  52 }
  53
  54 static int hw_init(void)
  55 {
  56         struct drv_context *drvc;
  57
  58         if (!(drvc = g_try_malloc0(sizeof(struct drv_context)))) {
  59                 sr_err("${short}: Driver context malloc failed.");
  60                 return SR_ERR;
  61         }
  62
  63         /* TODO */
  64
  65         di->priv = drvc;
  66
  67         return SR_OK;
  68 }
  69
  70 static GSList *hw_scan(GSList *options)
  71 {
  72         struct drv_context *drvc;
  73         GSList *devices;
  74
  75         (void)options;
  76
  77         devices = NULL;
  78         drvc = di->priv;
  79         drvc->instances = NULL;
  80
  81         /* TODO */
  82
  83         return devices;
  84 }
  85
  86 static GSList *hw_dev_list(void)
  87 {
  88         struct drv_context *drvc;
  89
  90         drvc = di->priv;
  91
  92         return drvc->instances;
  93 }
  94
  95 static int hw_dev_open(struct sr_dev_inst *sdi)
  96 {
  97         /* TODO */
  98
  99         return SR_OK;
 100 }
 101
 102 static int hw_dev_close(struct sr_dev_inst *sdi)
 103 {
 104         /* TODO */
 105
 106         return SR_OK;
 107 }
 108
 109 static int hw_cleanup(void)
 110 {
 111         clear_instances();
 112
 113         /* TODO */
 114
 115         return SR_OK;
 116 }
 117
 118 static int hw_info_get(int info_id, const void **data,
 119                        const struct sr_dev_inst *sdi)
 120 {
 121         switch (info_id) {
 122         /* TODO */
 123         default:
 124                 return SR_ERR_ARG;
 125         }
 126
 127         return SR_OK;
 128 }
 129
 130 static int hw_dev_config_set(const struct sr_dev_inst *sdi, int hwcap,
 131                              const void *value)
 132 {
 133         int ret;
 134
 135         if (sdi->status != SR_ST_ACTIVE)
 136                 return SR_ERR;
 137
 138         ret = SR_OK;
 139         switch (hwcap) {
 140         /* TODO */
 141         default:
 142                 ret = SR_ERR_ARG;
 143         }
 144
 145         return ret;
 146 }
 147
 148 static int hw_dev_acquisition_start(const struct sr_dev_inst *sdi,
 149                                     void *cb_data)
 150 {
 151         /* TODO */
 152
 153         return SR_OK;
 154 }
 155
 156 static int hw_dev_acquisition_stop(const struct sr_dev_inst *sdi,
 157                                    void *cb_data)
 158 {
 159         (void)cb_data;
 160
 161         if (sdi->status != SR_ST_ACTIVE)
 162                 return SR_ERR;
 163
 164         /* TODO */
 165
 166         return SR_OK;
 167 }
 168
 169 SR_PRIV struct sr_dev_driver ${lib}_driver_info = {
 170         .name = "${short}",
 171         .longname = "${name}",
 172         .api_version = 1,
 173         .init = hw_init,
 174         .cleanup = hw_cleanup,
 175         .scan = hw_scan,
 176         .dev_list = hw_dev_list,
 177         .dev_clear = clear_instances,
 178         .dev_open = hw_dev_open,
 179         .dev_close = hw_dev_close,
 180         .info_get = hw_info_get,
 181         .dev_config_set = hw_dev_config_set,
 182         .dev_acquisition_start = hw_dev_acquisition_start,
 183         .dev_acquisition_stop = hw_dev_acquisition_stop,
 184         .priv = NULL,
 185 };