2 * This file is part of the libsigrok project.
4 * Copyright (C) 2014 Daniel Elstner <daniel.kitta@gmail.com>
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.
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.
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/>.
22 #include "libsigrok-internal.h"
24 #include <glib/gstdio.h>
26 #define BITSTREAM_MAX_SIZE 262144 /* bitstream size limit for safety */
27 #define BITSTREAM_HEADER_SIZE 4 /* transfer header size in bytes */
29 /* Load a bitstream file into memory. Returns a newly allocated array
30 * consisting of a 32-bit length field followed by the bitstream data.
32 static unsigned char *load_bitstream_file(const char *filename, int *length_p)
36 unsigned char *stream;
39 /* Retrieve and validate the file size. */
40 if (g_stat(filename, &statbuf) < 0) {
41 sr_err("Failed to access bitstream file: %s.",
45 if (!S_ISREG(statbuf.st_mode)) {
46 sr_err("Bitstream is not a regular file.");
49 if (statbuf.st_size <= 0 || statbuf.st_size > BITSTREAM_MAX_SIZE) {
50 sr_err("Refusing to load bitstream of unreasonable size "
51 "(%" PRIu64 " bytes).", (uint64_t)statbuf.st_size);
55 /* The message length includes the 4-byte header. */
56 length = BITSTREAM_HEADER_SIZE + statbuf.st_size;
57 stream = g_try_malloc(length);
59 sr_err("Failed to allocate bitstream buffer.");
63 file = g_fopen(filename, "rb");
65 sr_err("Failed to open bitstream file: %s.", g_strerror(errno));
70 /* Write the message length header. */
71 *(uint32_t *)stream = GUINT32_TO_BE(length);
73 count = fread(stream + BITSTREAM_HEADER_SIZE,
74 length - BITSTREAM_HEADER_SIZE, 1, file);
76 sr_err("Failed to read bitstream file: %s.", g_strerror(errno));
87 /* Load a Raw Binary File (.rbf) from the firmware directory and transfer
90 SR_PRIV int lwla_send_bitstream(const struct sr_usb_dev_inst *usb,
94 unsigned char *stream;
99 if (!usb || !basename)
102 filename = g_build_filename(FIRMWARE_DIR, basename, NULL);
103 sr_info("Downloading FPGA bitstream at '%s'.", filename);
105 stream = load_bitstream_file(filename, &length);
111 /* Transfer the entire bitstream in one URB. */
112 ret = libusb_bulk_transfer(usb->devhdl, EP_BITSTREAM,
113 stream, length, &xfer_len, USB_TIMEOUT);
117 sr_err("Failed to transfer bitstream: %s.",
118 libusb_error_name(ret));
121 if (xfer_len != length) {
122 sr_err("Failed to transfer bitstream: incorrect length "
123 "%d != %d.", xfer_len, length);
126 sr_info("FPGA bitstream download of %d bytes done.", xfer_len);
128 /* This delay appears to be necessary for reliable operation. */
134 SR_PRIV int lwla_send_command(const struct sr_usb_dev_inst *usb,
135 const uint16_t *command, int cmd_len)
140 if (!usb || !command || cmd_len <= 0)
144 ret = libusb_bulk_transfer(usb->devhdl, EP_COMMAND,
145 (unsigned char *)command, cmd_len * 2,
146 &xfer_len, USB_TIMEOUT);
148 sr_dbg("Failed to send command %d: %s.",
149 LWLA_TO_UINT16(command[0]), libusb_error_name(ret));
152 if (xfer_len != cmd_len * 2) {
153 sr_dbg("Failed to send command %d: incorrect length %d != %d.",
154 LWLA_TO_UINT16(command[0]), xfer_len, cmd_len * 2);
160 SR_PRIV int lwla_receive_reply(const struct sr_usb_dev_inst *usb,
161 uint32_t *reply, int reply_len, int expect_len)
166 if (!usb || !reply || reply_len <= 0)
170 ret = libusb_bulk_transfer(usb->devhdl, EP_REPLY,
171 (unsigned char *)reply, reply_len * 4,
172 &xfer_len, USB_TIMEOUT);
174 sr_dbg("Failed to receive reply: %s.", libusb_error_name(ret));
177 if (xfer_len != expect_len * 4) {
178 sr_dbg("Failed to receive reply: incorrect length %d != %d.",
179 xfer_len, expect_len * 4);
185 SR_PRIV int lwla_read_reg(const struct sr_usb_dev_inst *usb,
186 uint16_t reg, uint32_t *value)
190 uint32_t reply[128]; /* full EP buffer to avoid overflows */
192 command[0] = LWLA_WORD(CMD_READ_REG);
193 command[1] = LWLA_WORD(reg);
195 ret = lwla_send_command(usb, command, G_N_ELEMENTS(command));
200 ret = lwla_receive_reply(usb, reply, G_N_ELEMENTS(reply), 1);
203 *value = LWLA_TO_UINT32(reply[0]);
208 SR_PRIV int lwla_write_reg(const struct sr_usb_dev_inst *usb,
209 uint16_t reg, uint32_t value)
213 command[0] = LWLA_WORD(CMD_WRITE_REG);
214 command[1] = LWLA_WORD(reg);
215 command[2] = LWLA_WORD_0(value);
216 command[3] = LWLA_WORD_1(value);
218 return lwla_send_command(usb, command, G_N_ELEMENTS(command));
221 SR_PRIV int lwla_write_regs(const struct sr_usb_dev_inst *usb,
222 const struct regval_pair *regvals, int count)
229 for (i = 0; i < count; ++i) {
230 ret = lwla_write_reg(usb, regvals[i].reg, regvals[i].val);