]> sigrok.org Git - libsigrok.git/blobdiff - src/hardware/gmc-mh-1x-2x/protocol.c
Add APIs to query libsigrok build information.
[libsigrok.git] / src / hardware / gmc-mh-1x-2x / protocol.c
index 93f28e80d01a62142edf8b0894935701eb6156b8..10fe9c09e102b6505a96e047fb1cf3c829bcf2c9 100644 (file)
  * along with this program.  If not, see <http://www.gnu.org/licenses/>.
  */
 
-/** @file
- *  Gossen Metrawatt Metrahit 1x/2x drivers
- *  @internal
+/**
+ * @file
+ *
+ * Gossen Metrawatt Metrahit 1x/2x drivers
+ *
+ * @internal
  */
 
 #include <config.h>
@@ -92,10 +95,7 @@ static void decode_ctmv_16(uint8_t ctmv, struct dev_context *devc)
        case 0x0d: /* 1101 µF (15S/16S only) */
                devc->mq = SR_MQ_CAPACITANCE;
                devc->unit = SR_UNIT_FARAD;
-               if (ctmv == 0x0c)
-                       devc->scale1000 = -3;
-               else
-                       devc->scale1000 = -2;
+               devc->scale1000 = (ctmv == 0x0c) ? -3 : -2;
                break;
        case 0x0e: /* mA, µA */
                devc->scale1000 = -1; /* Fall through. */
@@ -121,12 +121,8 @@ static void decode_rs_16(uint8_t rs, struct dev_context *devc)
        if (rs & 0x04) /* Sign */
                devc->scale = -devc->scale;
 
-       if (devc->mq == SR_MQ_CURRENT) {
-               if (rs & 0x08) /* Current is AC */
-                       devc->mqflags |= SR_MQFLAG_AC;
-               else
-                       devc->mqflags |= SR_MQFLAG_DC;
-       }
+       if (devc->mq == SR_MQ_CURRENT)
+               devc->mqflags |= (rs & 0x08) ? SR_MQFLAG_AC : SR_MQFLAG_DC;
 
        switch (rs & 0x03) {
        case 0:
@@ -287,10 +283,7 @@ static void decode_rs_18(uint8_t rs, struct dev_context *devc)
                        devc->scale += range - 5;
                break;
        case SR_MQ_CURRENT:
-               if (devc->scale1000 == -1)
-                       devc->scale += range - 5;
-               else
-                       devc->scale += range - 4;
+               devc->scale += (devc->scale1000 == -1) ? range - 5 : range - 4;
                break;
        case SR_MQ_RESISTANCE:
                devc->scale += range - 2;
@@ -527,10 +520,7 @@ static void decode_rs_2x(uint8_t rs, struct dev_context *devc)
        range = rs & 0x07;
        switch (devc->mq) {
        case SR_MQ_VOLTAGE:
-               if (devc->unit == SR_UNIT_DECIBEL_VOLT)
-                       devc->scale += -3;
-               else
-                       devc->scale += range - 6;
+               devc->scale += (devc->unit == SR_UNIT_DECIBEL_VOLT) ? -3 : range - 6;
                break;
        case SR_MQ_CURRENT:
                if (devc->scale1000 != -1) /* uA, mA */
@@ -783,7 +773,7 @@ static void process_msg_inf_10(struct sr_dev_inst *sdi)
                devc->value += pow(10.0, cnt) * dgt;
        }
        sr_spew("process_msg_inf_10() value=%f scale=%d scalet=%d",
-               devc->value, devc->scale,  devc->scale1000);
+               devc->value, devc->scale, devc->scale1000);
 
        if (devc->value != NAN)
                devc->value *= pow(10, devc->scale) * pow(1000.0, devc->scale1000);
@@ -880,9 +870,11 @@ static void process_msg_inf_13(struct sr_dev_inst *sdi)
        send_value(sdi);
 }
 
-/** Dump contents of 14-byte message.
- *  @param buf Pointer to array of 14 data bytes.
- *  @param[in] raw Write only data bytes, no interpretation.
+/**
+ * Dump contents of 14-byte message.
+ *
+ * @param buf Pointer to array of 14 data bytes.
+ * @param[in] raw Write only data bytes, no interpretation.
  */
 static void dump_msg14(guchar *buf, gboolean raw)
 {
@@ -903,10 +895,11 @@ static void dump_msg14(guchar *buf, gboolean raw)
                                buf[12], buf[13]);
 }
 
-/** Calc checksum for 14 byte message type.
+/**
+ * Calc checksum for 14 byte message type.
  *
- *  @param[in] dta Pointer to array of 13 data bytes.
- *  @return Checksum.
+ * @param[in] dta Pointer to array of 13 data bytes.
+ * @return Checksum.
  */
 static guchar calc_chksum_14(guchar *dta)
 {
@@ -924,7 +917,7 @@ static int chk_msg14(struct sr_dev_inst *sdi)
        struct dev_context *devc;
        int retc;
        gboolean isreq; /* Message is request to multimeter (otherwise response) */
-       uint8_t addr;  /* Adaptor address */
+       uint8_t addr; /* Adaptor address */
 
        retc = SR_OK;
 
@@ -1024,7 +1017,7 @@ SR_PRIV int process_msg14(struct sr_dev_inst *sdi)
                        sr_spew("Measurement Function: %d ", (int)devc->buf[7]);
                        decode_ctmv_2x(devc->buf[7], devc);
                        sr_spew("Range: 0x%x", devc->buf[8]);
-                       decode_rs_2x_TR2(devc->buf[8] & 0x0f, devc);  /* Docs wrong, uses conversion table TR_2! */
+                       decode_rs_2x_TR2(devc->buf[8] & 0x0f, devc); /* Docs wrong, uses conversion table TR_2! */
                        devc->autorng = (devc->buf[8] & 0x20) == 0;
                        // TODO 9, 10: 29S special functions
                        devc->ubatt = 0.1 * (float)devc->buf[11];
@@ -1035,7 +1028,7 @@ SR_PRIV int process_msg14(struct sr_dev_inst *sdi)
                        sr_spew("Internal version %d.%d", (int)devc->buf[5], (int)devc->buf[4]);
                        sr_spew("Comm mode: 0x%x", (int)devc->buf[6]);
                        sr_spew("Block cnt%%64: %d", (int)devc->buf[7]);
-                       sr_spew("drpCi: %d  drpCh: %d", (int)devc->buf[8], (int)devc->buf[9]);
+                       sr_spew("drpCi: %d drpCh: %d", (int)devc->buf[8], (int)devc->buf[9]);
                        // Semantics undocumented. Possibly Metrahit 29S dropouts stuff?
                        break;
                default:
@@ -1248,13 +1241,15 @@ SR_PRIV int gmc_mh_2x_receive_data(int fd, int revents, void *cb_data)
        return TRUE;
 }
 
-/** Create 14 (42) byte command for Metrahit 2x multimeter in bidir mode.
+/**
+ * Create 14 (42) byte command for Metrahit 2x multimeter in bidir mode.
+ *
+ * Actually creates 42 bytes due to the encoding method used.
  *
- *  Actually creates 42 bytes due to the encoding method used.
- *  @param[in] addr Device address (0=adapter, 1..15 multimeter; for byte 0).
- *  @param[in] func Function code (byte 3).
- *  @param[in] params Further parameters (9 bytes)
- *  @param[out] buf Buffer to create msg in (42 bytes).
+ * @param[in] addr Device address (0=adapter, 1..15 multimeter; for byte 0).
+ * @param[in] func Function code (byte 3).
+ * @param[in] params Further parameters (9 bytes)
+ * @param[out] buf Buffer to create msg in (42 bytes).
  */
 static void create_cmd_14(guchar addr, guchar func, guchar *params, guchar *buf)
 {
@@ -1316,8 +1311,11 @@ int req_meas14(const struct sr_dev_inst *sdi)
        return SR_OK;
 }
 
-/** Request status from 2x multimeter (msg 3).
- *  @param[in] power_on Try to power on powered off multimeter by sending additional messages.
+/**
+ * Request status from 2x multimeter (msg 3).
+ *
+ * @param[in] power_on Try to power on powered off multimeter by sending
+ *                     additional messages.
  */
 int req_stat14(const struct sr_dev_inst *sdi, gboolean power_on)
 {
@@ -1412,20 +1410,18 @@ SR_PRIV int gmc_decode_model_sm(uint8_t mcode)
        }
 }
 
-/** Convert GMC model code in bidirectional mode to sigrok-internal one.
+/**
+ * Convert GMC model code in bidirectional mode to sigrok-internal one.
  *
- *  @param[in] mcode Model code.
+ * @param[in] mcode Model code.
  *
- *  @return Model code.
+ * @return Model code.
  */
 SR_PRIV int gmc_decode_model_bd(uint8_t mcode)
 {
        switch (mcode & 0x1f) {
        case 2:
-               if (mcode & 0x20)
-                       return METRAHIT_22M;
-               else
-                       return METRAHIT_22S;
+               return (mcode & 0x20) ? METRAHIT_22M : METRAHIT_22S;
        case 3:
                return METRAHIT_23S;
        case 4:
@@ -1433,10 +1429,7 @@ SR_PRIV int gmc_decode_model_bd(uint8_t mcode)
        case 5:
                return METRAHIT_25S;
        case 1:
-               if (mcode & 0x20)
-                       return METRAHIT_26M;
-               else
-                       return METRAHIT_26S;
+               return (mcode & 0x20) ? METRAHIT_26M : METRAHIT_26S;
        case 12:
                return METRAHIT_28S;
        case 14:
@@ -1447,11 +1440,12 @@ SR_PRIV int gmc_decode_model_bd(uint8_t mcode)
        }
 }
 
-/** Convert sigrok-internal model code to string.
+/**
+ * Convert sigrok-internal model code to string.
  *
- *  @param[in] mcode Model code.
+ * @param[in] mcode Model code.
  *
- *  @return Model code string.
+ * @return Model code string.
  */
 SR_PRIV const char *gmc_model_str(enum model mcode)
 {