src/hardware/sysclk-lwla/lwla.h

   1 /*
   2  * This file is part of the libsigrok project.
   3  *
   4  * Copyright (C) 2014 Daniel Elstner <daniel.kitta@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 #ifndef LIBSIGROK_HARDWARE_SYSCLK_LWLA_LWLA_H
  21 #define LIBSIGROK_HARDWARE_SYSCLK_LWLA_LWLA_H
  22
  23 #include <stdint.h>
  24 #include <libusb.h>
  25 #include <glib.h>
  26 #include <libsigrok/libsigrok.h>
  27
  28 struct sr_usb_dev_inst;
  29
  30 /* Rotate argument n bits to the left.
  31  * This construct is an idiom recognized by GCC as bit rotation.
  32  */
  33 #define LROTATE(a, n) (((a) << (n)) | ((a) >> (CHAR_BIT * sizeof(a) - (n))))
  34
  35 /* Convert 16-bit little endian LWLA protocol word to machine word order. */
  36 #define LWLA_TO_UINT16(val) GUINT16_FROM_LE(val)
  37
  38 /* Convert 32-bit mixed endian LWLA protocol word to machine word order. */
  39 #define LWLA_TO_UINT32(val) LROTATE(GUINT32_FROM_LE(val), 16)
  40
  41 /* Convert 16-bit argument to LWLA protocol word. */
  42 #define LWLA_WORD(val) GUINT16_TO_LE(val)
  43
  44 /* Extract 16-bit units in mixed endian order from 32/64-bit value. */
  45 #define LWLA_WORD_0(val) GUINT16_TO_LE(((val) >> 16) & 0xFFFF)
  46 #define LWLA_WORD_1(val) GUINT16_TO_LE((val) & 0xFFFF)
  47 #define LWLA_WORD_2(val) GUINT16_TO_LE(((val) >> 48) & 0xFFFF)
  48 #define LWLA_WORD_3(val) GUINT16_TO_LE(((val) >> 32) & 0xFFFF)
  49
  50 /* Maximum number of 16-bit words sent at a time during acquisition.
  51  * Used for allocating the libusb transfer buffer. Keep this even so that
  52  * subsequent members are always 32-bit aligned.
  53  */
  54 #define MAX_ACQ_SEND_LEN16      64 /* 43 for capture setup plus stuffing */
  55
  56 /* Maximum number of 32-bit words received at a time during acquisition.
  57  * This is a multiple of the endpoint buffer size to avoid transfer overflow
  58  * conditions.
  59  */
  60 #define MAX_ACQ_RECV_LEN32      (2 * 512 / 4)
  61
  62 /* Maximum length of a register read/write sequence.
  63  */
  64 #define MAX_REG_SEQ_LEN         16
  65
  66 /* Logic datafeed packet size in bytes.
  67  * This is a multiple of both 4 and 5 to match any model's unit size
  68  * and memory granularity.
  69  */
  70 #define PACKET_SIZE             (5000 * 4 * 5)
  71
  72 /** USB device end points.
  73  */
  74 enum usb_endpoint {
  75         EP_COMMAND = 2,
  76         EP_CONFIG  = 4,
  77         EP_REPLY   = 6 | LIBUSB_ENDPOINT_IN
  78 };
  79
  80 /** LWLA protocol command ID codes.
  81  */
  82 enum command_id {
  83         CMD_READ_REG    = 1,
  84         CMD_WRITE_REG   = 2,
  85         CMD_READ_MEM32  = 3,
  86         CMD_READ_MEM36  = 6,
  87         CMD_WRITE_LREGS = 7,
  88         CMD_READ_LREGS  = 8,
  89 };
  90
  91 /** LWLA capture state flags.
  92  * The bit positions are the same as in the LWLA1016 control register.
  93  */
  94 enum {
  95         STATUS_CAPTURING = 1 << 2,
  96         STATUS_TRIGGERED = 1 << 5,
  97         STATUS_MEM_AVAIL = 1 << 6,
  98 };
  99
 100 /** LWLA1034 run-length encoding states.
 101  */
 102 enum rle_state {
 103         RLE_STATE_DATA,
 104         RLE_STATE_LEN
 105 };
 106
 107 /** Register address/value pair.
 108  */
 109 struct regval {
 110         unsigned int reg;
 111         uint32_t val;
 112 };
 113
 114 /** LWLA sample acquisition and decompression state.
 115  */
 116 struct acquisition_state {
 117         uint64_t samples_max;   /* maximum number of samples to process */
 118         uint64_t samples_done;  /* number of samples sent to the session bus */
 119         uint64_t duration_max;  /* maximum capture duration in milliseconds */
 120         uint64_t duration_now;  /* running capture duration since trigger */
 121
 122         uint64_t sample;        /* last sample read from capture memory */
 123         uint64_t run_len;       /* remaining run length of current sample */
 124
 125         struct libusb_transfer *xfer_in;        /* USB in transfer record */
 126         struct libusb_transfer *xfer_out;       /* USB out transfer record */
 127
 128         unsigned int mem_addr_fill;     /* capture memory fill level */
 129         unsigned int mem_addr_done;     /* next address to be processed */
 130         unsigned int mem_addr_next;     /* start address for next async read */
 131         unsigned int mem_addr_stop;     /* end of memory range to be read */
 132         unsigned int in_index;          /* position in read transfer buffer */
 133         unsigned int out_index;         /* position in logic packet buffer */
 134         enum rle_state rle;             /* RLE decoding state */
 135
 136         gboolean rle_enabled;   /* capturing in timing-state mode */
 137         gboolean clock_boost;   /* switch to faster clock during capture */
 138         unsigned int status;    /* last received device status */
 139
 140         unsigned int reg_seq_pos;       /* index of next register/value pair */
 141         unsigned int reg_seq_len;       /* length of register/value sequence */
 142
 143         struct regval reg_sequence[MAX_REG_SEQ_LEN];    /* register buffer */
 144         uint32_t xfer_buf_in[MAX_ACQ_RECV_LEN32];       /* USB in buffer */
 145         uint16_t xfer_buf_out[MAX_ACQ_SEND_LEN16];      /* USB out buffer */
 146         uint8_t out_packet[PACKET_SIZE];                /* logic payload */
 147 };
 148
 149 static inline void lwla_queue_regval(struct acquisition_state *acq,
 150                                      unsigned int reg, uint32_t value)
 151 {
 152         acq->reg_sequence[acq->reg_seq_len].reg = reg;
 153         acq->reg_sequence[acq->reg_seq_len].val = value;
 154         acq->reg_seq_len++;
 155 }
 156
 157 SR_PRIV int lwla_send_bitstream(struct sr_context *ctx,
 158                                 const struct sr_usb_dev_inst *usb,
 159                                 const char *name);
 160
 161 SR_PRIV int lwla_send_command(const struct sr_usb_dev_inst *usb,
 162                               const uint16_t *command, int cmd_len);
 163
 164 SR_PRIV int lwla_receive_reply(const struct sr_usb_dev_inst *usb,
 165                                uint32_t *reply, int reply_len, int expect_len);
 166
 167 SR_PRIV int lwla_read_reg(const struct sr_usb_dev_inst *usb,
 168                           uint16_t reg, uint32_t *value);
 169
 170 SR_PRIV int lwla_write_reg(const struct sr_usb_dev_inst *usb,
 171                            uint16_t reg, uint32_t value);
 172
 173 SR_PRIV int lwla_write_regs(const struct sr_usb_dev_inst *usb,
 174                             const struct regval *regvals, int count);
 175
 176 #endif