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  * Copyright (C) 2018-2019 Frank Stettner <frank-stettner@gmx.net>
   6  *
   7  * This program is free software: you can redistribute it and/or modify
   8  * it under the terms of the GNU General Public License as published by
   9  * the Free Software Foundation, either version 3 of the License, or
  10  * (at your option) any later version.
  11  *
  12  * This program is distributed in the hope that it will be useful,
  13  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  14  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  15  * GNU General Public License for more details.
  16  *
  17  * You should have received a copy of the GNU General Public License
  18  * along with this program.  If not, see <http://www.gnu.org/licenses/>.
  19  */
  20
  21 #ifndef LIBSIGROK_HARDWARE_KORAD_KAXXXXP_PROTOCOL_H
  22 #define LIBSIGROK_HARDWARE_KORAD_KAXXXXP_PROTOCOL_H
  23
  24 #include <stdint.h>
  25 #include <string.h>
  26 #include <glib.h>
  27 #include <libsigrok/libsigrok.h>
  28 #include "libsigrok-internal.h"
  29
  30 #define LOG_PREFIX "korad-kaxxxxp"
  31
  32 #define KAXXXXP_POLL_INTERVAL_MS 80
  33
  34 enum {
  35         KORAD_KA3005P,
  36         KORAD_KA3005P_0X01,
  37         KORAD_KA3005P_0XBC,
  38         KORAD_KA3005P_V42,
  39         KORAD_KA3005P_V55,
  40         KORAD_KD3005P_V20,
  41         KORAD_KD3005P_V20_NOSP,
  42         KORAD_KD3005P_V21_NOSP,
  43         KORAD_KD3005P_V41,
  44         KORAD_KD3005P_V68,
  45         KORAD_KD6005P,
  46         RND_320_KA3005P,
  47         RND_320_KD3005P,
  48         RND_320K30PV,
  49         STAMOS_SLS31_V20,
  50         TENMA_72_2535_V21,
  51         TENMA_72_2540_V20,
  52         TENMA_72_2540_V21,
  53         TENMA_72_2540_V52,
  54         TENMA_72_2550_V2,
  55         TENMA_72_2710_V66,
  56         VELLEMAN_LABPS3005D,
  57         VELLEMAN_PS3005D,
  58         /* Support for future devices with this protocol. */
  59 };
  60
  61 /* Information on single model */
  62 struct korad_kaxxxxp_model {
  63         int model_id; /**< Model info */
  64         const char *vendor; /**< Vendor name */
  65         const char *name; /**< Model name */
  66         const char *id; /**< Model ID, as delivered by interface */
  67         int channels; /**< Number of channels */
  68         double voltage[3]; /**< Min, max, step */
  69         double current[3]; /**< Min, max, step */
  70 };
  71
  72 /* Reply targets */
  73 enum {
  74         KAXXXXP_CURRENT,
  75         KAXXXXP_CURRENT_LIMIT,
  76         KAXXXXP_VOLTAGE,
  77         KAXXXXP_VOLTAGE_TARGET,
  78         KAXXXXP_STATUS,
  79         KAXXXXP_OUTPUT,
  80         KAXXXXP_BEEP,
  81         KAXXXXP_OCP,
  82         KAXXXXP_OVP,
  83         KAXXXXP_SAVE,
  84         KAXXXXP_RECALL,
  85 };
  86
  87 struct dev_context {
  88         const struct korad_kaxxxxp_model *model; /**< Model information. */
  89
  90         struct sr_sw_limits limits;
  91         int64_t req_sent_at;
  92         GMutex rw_mutex;
  93
  94         float current;          /**< Last current value [A] read from device. */
  95         float current_limit;    /**< Output current set. */
  96         float voltage;          /**< Last voltage value [V] read from device. */
  97         float voltage_target;   /**< Output voltage set. */
  98         gboolean cc_mode[2];    /**< Device is in CC mode (otherwise CV). */
  99
 100         gboolean output_enabled; /**< Is the output enabled? */
 101         gboolean beep_enabled;   /**< Enable beeper. */
 102         gboolean ocp_enabled;    /**< Output current protection enabled. */
 103         gboolean ovp_enabled;    /**< Output voltage protection enabled. */
 104
 105         gboolean cc_mode_1_changed;      /**< CC mode of channel 1 has changed. */
 106         gboolean cc_mode_2_changed;      /**< CC mode of channel 2 has changed. */
 107         gboolean output_enabled_changed; /**< Output enabled state has changed. */
 108         gboolean ocp_enabled_changed;    /**< OCP enabled state has changed. */
 109         gboolean ovp_enabled_changed;    /**< OVP enabled state has changed. */
 110
 111         int acquisition_target;  /**< What reply to expect. */
 112         int program;             /**< Program to store or recall. */
 113
 114         float set_current_limit;     /**< New output current to set. */
 115         float set_voltage_target;    /**< New output voltage to set. */
 116         gboolean set_output_enabled; /**< New output enabled to set. */
 117         gboolean set_beep_enabled;   /**< New enable beeper to set. */
 118         gboolean set_ocp_enabled;    /**< New OCP enabled to set. */
 119         gboolean set_ovp_enabled;    /**< New OVP enabled to set. */
 120 };
 121
 122 SR_PRIV int korad_kaxxxxp_send_cmd(struct sr_serial_dev_inst *serial,
 123                                         const char *cmd);
 124 SR_PRIV int korad_kaxxxxp_read_chars(struct sr_serial_dev_inst *serial,
 125                                         size_t count, char *buf);
 126 SR_PRIV int korad_kaxxxxp_set_value(struct sr_serial_dev_inst *serial,
 127                                         int target, struct dev_context *devc);
 128 SR_PRIV int korad_kaxxxxp_get_value(struct sr_serial_dev_inst *serial,
 129                                         int target, struct dev_context *devc);
 130 SR_PRIV int korad_kaxxxxp_get_all_values(struct sr_serial_dev_inst *serial,
 131                                         struct dev_context *devc);
 132 SR_PRIV int korad_kaxxxxp_receive_data(int fd, int revents, void *cb_data);
 133
 134 #endif