src/hardware/korad-kaxxxxp/protocol.h

   1 /*
   2  * This file is part of the libsigrok project.
   3  *
   4  * Copyright (C) 2015 Hannu Vuolasaho <vuokkosetae@gmail.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 /**
  21  * @file
  22  * Korad KAxxxxP power supply driver
  23  * @internal
  24  */
  25
  26 #ifndef LIBSIGROK_HARDWARE_KORAD_KAXXXXP_PROTOCOL_H
  27 #define LIBSIGROK_HARDWARE_KORAD_KAXXXXP_PROTOCOL_H
  28
  29 #include <stdint.h>
  30 #include <string.h>
  31 #include <glib.h>
  32 #include <libsigrok/libsigrok.h>
  33 #include "libsigrok-internal.h"
  34
  35 #define LOG_PREFIX "korad-kaxxxxp"
  36
  37 #define KAXXXXP_POLL_INTERVAL_MS 80
  38
  39 enum {
  40         VELLEMAN_PS3005D,
  41         VELLEMAN_LABPS3005D,
  42         KORAD_KA3005P,
  43         /* Support for future devices with this protocol. */
  44 };
  45
  46 /* Information on single model */
  47 struct korad_kaxxxxp_model {
  48         int model_id; /**< Model info */
  49         const char *vendor; /**< Vendor name */
  50         const char *name; /**< Model name */
  51         const char *id; /**< Model ID, as delivered by interface */
  52         int channels; /**< Number of channels */
  53         double voltage[3]; /**< Min, max, step */
  54         double current[3]; /**< Min, max, step */
  55 };
  56
  57 /* Reply targets */
  58 enum {
  59         KAXXXXP_CURRENT,
  60         KAXXXXP_CURRENT_MAX,
  61         KAXXXXP_VOLTAGE,
  62         KAXXXXP_VOLTAGE_MAX,
  63         KAXXXXP_STATUS,
  64         KAXXXXP_OUTPUT,
  65         KAXXXXP_BEEP,
  66         KAXXXXP_OCP,
  67         KAXXXXP_OVP,
  68         KAXXXXP_SAVE,
  69         KAXXXXP_RECALL,
  70 };
  71
  72 /** Private, per-device-instance driver context. */
  73 struct dev_context {
  74         /* Model-specific information */
  75         const struct korad_kaxxxxp_model *model; /**< Model information. */
  76
  77         /* Acquisition settings */
  78         uint64_t limit_samples;
  79         uint64_t limit_msec;
  80         uint64_t num_samples;
  81         int64_t starttime;
  82         int64_t req_sent_at;
  83         gboolean reply_pending;
  84
  85         void *cb_data;
  86
  87         /* Operational state */
  88         float current;          /**< Last current value [A] read from device. */
  89         float current_max;      /**< Output current set. */
  90         float voltage;          /**< Last voltage value [V] read from device. */
  91         float voltage_max;      /**< Output voltage set. */
  92         gboolean cc_mode[2];    /**< Device is in CC mode (otherwise CV). */
  93
  94         gboolean output_enabled; /**< Is the output enabled? */
  95         gboolean beep_enabled;   /**< Enable beeper. */
  96         gboolean ocp_enabled;    /**< Output current protection enabled. */
  97         gboolean ovp_enabled;    /**< Output voltage protection enabled. */
  98
  99         /* Temporary state across callbacks */
 100         int target;              /**< What reply to expect. */
 101         int program;             /**< Program to store or recall. */
 102         char reply[6];
 103 };
 104
 105 SR_PRIV int korad_kaxxxxp_send_cmd(struct sr_serial_dev_inst *serial,
 106                                         const char *cmd);
 107 SR_PRIV int korad_kaxxxxp_read_chars(struct sr_serial_dev_inst *serial,
 108                                         int count, char *buf);
 109 SR_PRIV int korad_kaxxxxp_set_value(struct sr_serial_dev_inst *serial,
 110                                         struct dev_context *devc);
 111 SR_PRIV int korad_kaxxxxp_query_value(struct sr_serial_dev_inst *serial,
 112                                         struct dev_context *devc);
 113 SR_PRIV int korad_kaxxxxp_get_reply(struct sr_serial_dev_inst *serial,
 114                                         struct dev_context *devc);
 115 SR_PRIV int korad_kaxxxxp_get_all_values(struct sr_serial_dev_inst *serial,
 116                                         struct dev_context *devc);
 117 SR_PRIV int korad_kaxxxxp_receive_data(int fd, int revents, void *cb_data);
 118
 119 #endif