sysclk-lwla: Implement support for the LWLA1034.

[libsigrok.git] / hardware / sysclk-lwla / lwla.h

diff --git a/hardware/sysclk-lwla/lwla.h b/hardware/sysclk-lwla/lwla.h
new file mode 100644 (file)
index 0000000..78c1183
--- /dev/null
+++ b/hardware/sysclk-lwla/lwla.h
@@ -0,0 +1,122 @@
+/*
+ * This file is part of the libsigrok project.
+ *
+ * Copyright (C) 2014 Daniel Elstner <daniel.kitta@gmail.com>
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with this program.  If not, see <http://www.gnu.org/licenses/>.
+ */
+
+#ifndef LIBSIGROK_HARDWARE_SYSCLK_LWLA_LWLA_H
+#define LIBSIGROK_HARDWARE_SYSCLK_LWLA_LWLA_H
+
+#include "libsigrok.h"
+#include <stdint.h>
+#include <libusb.h>
+#include <glib.h>
+
+struct sr_usb_dev_inst;
+
+/* Read mixed endian words from a buffer of 16-bit units. */
+#define LWLA_READ16(buf) GUINT16_FROM_LE(*(buf))
+#define LWLA_READ32(buf) \
+       (((uint32_t)GUINT16_FROM_LE((buf)[0]) << 16) | \
+        ((uint32_t)GUINT16_FROM_LE((buf)[1])))
+#define LWLA_READ64(buf) \
+       (((uint64_t)LWLA_READ32((buf))) | \
+        ((uint64_t)LWLA_READ32((buf) + 2) << 32))
+
+/* Convert 16-bit argument to little endian. */
+#define LWLA_WORD(val) GUINT16_TO_LE(val)
+
+/* Extract 16-bit units from 32/64-bit value in mixed endian order. */
+#define LWLA_WORD_0(val) GUINT16_TO_LE(((val) & 0xFFFF0000u) >> 16)
+#define LWLA_WORD_1(val) GUINT16_TO_LE(((val) & 0x0000FFFFu))
+#define LWLA_WORD_2(val) \
+       GUINT16_TO_LE(((val) & G_GUINT64_CONSTANT(0xFFFF000000000000)) >> 48)
+#define LWLA_WORD_3(val) \
+       GUINT16_TO_LE(((val) & G_GUINT64_CONSTANT(0x0000FFFF00000000)) >> 32)
+
+/** USB device end points.
+ */
+enum {
+       EP_COMMAND   = 2,
+       EP_BITSTREAM = 4,
+       EP_REPLY     = 6 | LIBUSB_ENDPOINT_IN
+};
+
+/** LWLA protocol command ID codes.
+ */
+enum {
+       CMD_READ_REG    = 1,
+       CMD_WRITE_REG   = 2,
+       CMD_READ_MEM    = 6,
+       CMD_CAP_SETUP   = 7,
+       CMD_CAP_STATUS  = 8,
+};
+
+/** LWLA capture state flags.
+ */
+enum {
+       STATUS_CAPTURING = 1 << 1,
+       STATUS_TRIGGERED = 1 << 4,
+       STATUS_MEM_AVAIL = 1 << 5,
+       STATUS_FLAG_MASK = 0x3F
+};
+
+/** LWLA register addresses.
+ */
+enum {
+       REG_MEM_CTRL2   = 0x1074, /* capture buffer control ??? */
+       REG_MEM_FILL    = 0x1078, /* capture buffer fill level */
+       REG_MEM_CTRL4   = 0x107C, /* capture buffer control ??? */
+
+       REG_DIV_BYPASS  = 0x1094, /* bypass clock divider flag */
+
+       REG_CMD_CTRL1   = 0x10B0, /* command control ??? */
+       REG_CMD_CTRL2   = 0x10B4, /* command control ??? */
+       REG_CMD_CTRL3   = 0x10B8, /* command control ??? */
+       REG_CMD_CTRL4   = 0x10BC, /* command control ??? */
+
+       REG_FREQ_CH1    = 0x10C0, /* channel 1 live frequency */
+       REG_FREQ_CH2    = 0x10C4, /* channel 2 live frequency */
+       REG_FREQ_CH3    = 0x10C8, /* channel 3 live frequency */
+       REG_FREQ_CH4    = 0x10CC, /* channel 4 live frequency */
+};
+
+/** Register/value pair.
+ */
+struct regval_pair {
+       unsigned int reg;
+       unsigned int val;
+};
+
+SR_PRIV int lwla_send_bitstream(const struct sr_usb_dev_inst *usb,
+                               const char *filename);
+
+SR_PRIV int lwla_send_command(const struct sr_usb_dev_inst *usb,
+                             const uint16_t *command, int cmd_len);
+
+SR_PRIV int lwla_receive_reply(const struct sr_usb_dev_inst *usb,
+                              uint16_t *reply, int reply_len, int expect_len);
+
+SR_PRIV int lwla_read_reg(const struct sr_usb_dev_inst *usb,
+                         uint16_t reg, uint32_t *value);
+
+SR_PRIV int lwla_write_reg(const struct sr_usb_dev_inst *usb,
+                          uint16_t reg, uint32_t value);
+
+SR_PRIV int lwla_write_regs(const struct sr_usb_dev_inst *usb,
+                           const struct regval_pair *regvals, int count);
+
+#endif /* !LIBSIGROK_HARDWARE_SYSCLK_LWLA_LWLA_H */