blob: db4e39ff9e6f023a797380dc9a66d0b8d87c233d [file] [log] [blame]
Carl-Daniel Hailfingerd38fac82010-01-19 11:15:48 +00001/*
2 * This file is part of the flashrom project.
3 *
4 * Copyright (C) 2010 Carl-Daniel Hailfinger
Simon Glass557eb4f2015-07-05 16:53:22 +00005 * Copyright (C) 2015 Simon Glass
6 * Copyright (C) 2015 Stefan Tauner
Carl-Daniel Hailfingerd38fac82010-01-19 11:15:48 +00007 *
8 * This program is free software; you can redistribute it and/or modify
9 * it under the terms of the GNU General Public License as published by
10 * the Free Software Foundation; version 2 of the License.
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.
Carl-Daniel Hailfingerd38fac82010-01-19 11:15:48 +000016 */
17
Nico Huber4d440a72017-08-15 11:26:48 +020018#include <sys/types.h>
Stefan Tauner5c316f92015-02-08 21:57:52 +000019#include <stdlib.h>
Mathias Krausedb7afc52010-11-09 23:30:43 +000020#include <stdio.h>
Carl-Daniel Hailfingerd38fac82010-01-19 11:15:48 +000021#include <string.h>
Stefan Taunere34e3e82013-01-01 00:06:51 +000022#include <limits.h>
Nathan Laredo21541a62012-12-24 22:07:36 +000023#include <errno.h>
Nico Huberd99a2bd2016-02-18 21:42:49 +000024#include <libusb.h>
Carl-Daniel Hailfingerd38fac82010-01-19 11:15:48 +000025#include "flash.h"
Sean Nelson14ba6682010-02-26 05:48:29 +000026#include "chipdrivers.h"
Carl-Daniel Hailfinger5b997c32010-07-27 22:41:39 +000027#include "programmer.h"
Carl-Daniel Hailfingerd38fac82010-01-19 11:15:48 +000028#include "spi.h"
29
Nico Huberd99a2bd2016-02-18 21:42:49 +000030/* LIBUSB_CALL ensures the right calling conventions on libusb callbacks.
31 * However, the macro is not defined everywhere. m(
32 */
33#ifndef LIBUSB_CALL
34#define LIBUSB_CALL
35#endif
36
Stefan Reinauer915b8402011-01-28 09:00:15 +000037#define FIRMWARE_VERSION(x,y,z) ((x << 16) | (y << 8) | z)
Carl-Daniel Hailfingerd38fac82010-01-19 11:15:48 +000038#define DEFAULT_TIMEOUT 3000
Nico Hubera96aaa32024-03-05 12:56:13 +010039#define MAX_BLOCK_COUNT 65535
Nico Huberd99a2bd2016-02-18 21:42:49 +000040#define DEDIPROG_ASYNC_TRANSFERS 8 /* at most 8 asynchronous transfers */
David Hendricksc3685182020-06-23 17:36:09 -070041#define REQTYPE_OTHER_OUT (LIBUSB_ENDPOINT_OUT | LIBUSB_REQUEST_TYPE_VENDOR | LIBUSB_RECIPIENT_OTHER) /* 0x43 */
Nico Huberd99a2bd2016-02-18 21:42:49 +000042#define REQTYPE_OTHER_IN (LIBUSB_ENDPOINT_IN | LIBUSB_REQUEST_TYPE_VENDOR | LIBUSB_RECIPIENT_OTHER) /* 0xC3 */
43#define REQTYPE_EP_OUT (LIBUSB_ENDPOINT_OUT | LIBUSB_REQUEST_TYPE_VENDOR | LIBUSB_RECIPIENT_ENDPOINT) /* 0x42 */
44#define REQTYPE_EP_IN (LIBUSB_ENDPOINT_IN | LIBUSB_REQUEST_TYPE_VENDOR | LIBUSB_RECIPIENT_ENDPOINT) /* 0xC2 */
David Woodhouse7f3b89f2016-02-18 21:42:15 +000045
46enum dediprog_devtype {
47 DEV_UNKNOWN = 0,
48 DEV_SF100 = 100,
Jay Thompsoncabe3202018-08-17 14:30:04 -050049 DEV_SF200 = 200,
David Woodhouse7f3b89f2016-02-18 21:42:15 +000050 DEV_SF600 = 600,
Nico Huber00578222024-03-02 14:00:53 +010051 DEV_SF600PG2 = 600+2,
52 DEV_SF700 = 700,
David Woodhouse7f3b89f2016-02-18 21:42:15 +000053};
Carl-Daniel Hailfingerd38fac82010-01-19 11:15:48 +000054
Simon Glass25e9f402015-06-28 13:31:19 +000055enum dediprog_leds {
56 LED_INVALID = -1,
57 LED_NONE = 0,
58 LED_PASS = 1 << 0,
59 LED_BUSY = 1 << 1,
60 LED_ERROR = 1 << 2,
61 LED_ALL = 7,
62};
63
Simon Glass557eb4f2015-07-05 16:53:22 +000064/* IO bits for CMD_SET_IO_LED message */
65enum dediprog_ios {
66 IO1 = 1 << 0,
67 IO2 = 1 << 1,
68 IO3 = 1 << 2,
69 IO4 = 1 << 3,
70};
71
72enum dediprog_cmds {
73 CMD_TRANSCEIVE = 0x01,
74 CMD_POLL_STATUS_REG = 0x02,
75 CMD_SET_VPP = 0x03,
76 CMD_SET_TARGET = 0x04,
77 CMD_READ_EEPROM = 0x05,
78 CMD_WRITE_EEPROM = 0x06,
79 CMD_SET_IO_LED = 0x07,
80 CMD_READ_PROG_INFO = 0x08,
81 CMD_SET_VCC = 0x09,
82 CMD_SET_STANDALONE = 0x0A,
David Hendricksc05900f2016-02-18 21:42:41 +000083 CMD_SET_VOLTAGE = 0x0B, /* Only in firmware older than 6.0.0 */
Simon Glass557eb4f2015-07-05 16:53:22 +000084 CMD_GET_BUTTON = 0x11,
85 CMD_GET_UID = 0x12,
86 CMD_SET_CS = 0x14,
87 CMD_IO_MODE = 0x15,
88 CMD_FW_UPDATE = 0x1A,
89 CMD_FPGA_UPDATE = 0x1B,
90 CMD_READ_FPGA_VERSION = 0x1C,
91 CMD_SET_HOLD = 0x1D,
92 CMD_READ = 0x20,
93 CMD_WRITE = 0x30,
94 CMD_WRITE_AT45DB = 0x31,
95 CMD_NAND_WRITE = 0x32,
96 CMD_NAND_READ = 0x33,
97 CMD_SET_SPI_CLK = 0x61,
98 CMD_CHECK_SOCKET = 0x62,
99 CMD_DOWNLOAD_PRJ = 0x63,
100 CMD_READ_PRJ_NAME = 0x64,
101 // New protocol/firmware only
102 CMD_CHECK_SDCARD = 0x65,
103 CMD_READ_PRJ = 0x66,
104};
105
106enum dediprog_target {
107 FLASH_TYPE_APPLICATION_FLASH_1 = 0,
108 FLASH_TYPE_FLASH_CARD,
109 FLASH_TYPE_APPLICATION_FLASH_2,
110 FLASH_TYPE_SOCKET,
111};
112
113enum dediprog_readmode {
114 READ_MODE_STD = 1,
115 READ_MODE_FAST = 2,
116 READ_MODE_ATMEL45 = 3,
117 READ_MODE_4B_ADDR_FAST = 4,
118 READ_MODE_4B_ADDR_FAST_0x0C = 5, /* New protocol only */
119};
120
121enum dediprog_writemode {
Elyes HAOUASac01baa2018-05-28 16:52:21 +0200122 WRITE_MODE_PAGE_PGM = 1,
Simon Glass557eb4f2015-07-05 16:53:22 +0000123 WRITE_MODE_PAGE_WRITE = 2,
124 WRITE_MODE_1B_AAI = 3,
125 WRITE_MODE_2B_AAI = 4,
126 WRITE_MODE_128B_PAGE = 5,
127 WRITE_MODE_PAGE_AT26DF041 = 6,
128 WRITE_MODE_SILICON_BLUE_FPGA = 7,
Simon Glassae616512016-01-23 23:27:58 +0000129 WRITE_MODE_64B_PAGE_NUMONYX_PCM = 8, /* unit of 512 bytes */
Simon Glass557eb4f2015-07-05 16:53:22 +0000130 WRITE_MODE_4B_ADDR_256B_PAGE_PGM = 9,
Simon Glassae616512016-01-23 23:27:58 +0000131 WRITE_MODE_32B_PAGE_PGM_MXIC_512K = 10, /* unit of 512 bytes */
Simon Glass557eb4f2015-07-05 16:53:22 +0000132 WRITE_MODE_4B_ADDR_256B_PAGE_PGM_0x12 = 11,
133 WRITE_MODE_4B_ADDR_256B_PAGE_PGM_FLAGS = 12,
134};
135
David Woodhouse7f3b89f2016-02-18 21:42:15 +0000136enum dediprog_standalone_mode {
137 ENTER_STANDALONE_MODE = 0,
138 LEAVE_STANDALONE_MODE = 1,
139};
140
David Hendricksf73f8a72018-02-21 07:34:34 -0800141/*
Nico Huberc3b02dc2023-08-12 01:13:45 +0200142 * These are not official designations; they are for use in flashprog only.
David Hendricksf73f8a72018-02-21 07:34:34 -0800143 * Order must be preserved so that comparison operators work.
144 */
145enum protocol {
146 PROTOCOL_UNKNOWN,
147 PROTOCOL_V1,
148 PROTOCOL_V2,
149 PROTOCOL_V3,
150};
151
Thomas Heijligencc853d82021-05-04 15:32:17 +0200152static const struct dev_entry devs_dediprog[] = {
Jay Thompsoncabe3202018-08-17 14:30:04 -0500153 {0x0483, 0xDADA, OK, "Dediprog", "SF100/SF200/SF600"},
Stefan Taunerfdec7472016-02-22 08:59:27 +0000154
155 {0},
156};
Simon Glass557eb4f2015-07-05 16:53:22 +0000157
Anastasia Klimchukb31f7ac2021-07-12 14:18:37 +1000158struct dediprog_data {
159 struct libusb_context *usb_ctx;
Anastasia Klimchuk7d973882021-07-14 09:33:50 +1000160 libusb_device_handle *handle;
161 int in_endpoint;
162 int out_endpoint;
163 int firmwareversion;
Nico Huber274e6552024-03-24 12:34:57 +0100164 char devicestring[32+1];
Anastasia Klimchuk7d973882021-07-14 09:33:50 +1000165 enum dediprog_devtype devicetype;
Anastasia Klimchukb31f7ac2021-07-12 14:18:37 +1000166};
Simon Glass557eb4f2015-07-05 16:53:22 +0000167
Nico Huberd99a2bd2016-02-18 21:42:49 +0000168#if defined(LIBUSB_MAJOR) && defined(LIBUSB_MINOR) && defined(LIBUSB_MICRO) && \
169 LIBUSB_MAJOR <= 1 && LIBUSB_MINOR == 0 && LIBUSB_MICRO < 9
170/* Quick and dirty replacement for missing libusb_error_name in libusb < 1.0.9 */
171const char * LIBUSB_CALL libusb_error_name(int error_code)
172{
173 if (error_code >= INT16_MIN && error_code <= INT16_MAX) {
174 /* 18 chars for text, rest for number (16 b should be enough), sign, nullbyte. */
175 static char my_libusb_error[18 + 5 + 2];
176 sprintf(my_libusb_error, "libusb error code %i", error_code);
177 return my_libusb_error;
178 } else {
179 return "UNKNOWN";
180 }
181}
182#endif
183
Anastasia Klimchukb31f7ac2021-07-12 14:18:37 +1000184static enum protocol protocol(const struct dediprog_data *dp_data)
Carl-Daniel Hailfingerd38fac82010-01-19 11:15:48 +0000185{
David Hendricksf73f8a72018-02-21 07:34:34 -0800186 /* Firmware version < 5.0.0 is handled explicitly in some cases. */
Anastasia Klimchuk7d973882021-07-14 09:33:50 +1000187 switch (dp_data->devicetype) {
David Woodhouse7f3b89f2016-02-18 21:42:15 +0000188 case DEV_SF100:
Jay Thompsoncabe3202018-08-17 14:30:04 -0500189 case DEV_SF200:
Anastasia Klimchuk7d973882021-07-14 09:33:50 +1000190 if (dp_data->firmwareversion < FIRMWARE_VERSION(5, 5, 0))
David Hendricksf73f8a72018-02-21 07:34:34 -0800191 return PROTOCOL_V1;
192 else
193 return PROTOCOL_V2;
David Woodhouse7f3b89f2016-02-18 21:42:15 +0000194 case DEV_SF600:
Anastasia Klimchuk7d973882021-07-14 09:33:50 +1000195 if (dp_data->firmwareversion < FIRMWARE_VERSION(6, 9, 0))
David Hendricksf73f8a72018-02-21 07:34:34 -0800196 return PROTOCOL_V1;
Anastasia Klimchuk7d973882021-07-14 09:33:50 +1000197 else if (dp_data->firmwareversion <= FIRMWARE_VERSION(7, 2, 21))
David Hendricksf73f8a72018-02-21 07:34:34 -0800198 return PROTOCOL_V2;
199 else
200 return PROTOCOL_V3;
Nico Huber00578222024-03-02 14:00:53 +0100201 case DEV_SF700:
202 case DEV_SF600PG2:
203 return PROTOCOL_V3;
David Woodhouse7f3b89f2016-02-18 21:42:15 +0000204 default:
David Hendricksf73f8a72018-02-21 07:34:34 -0800205 return PROTOCOL_UNKNOWN;
David Woodhouse7f3b89f2016-02-18 21:42:15 +0000206 }
Carl-Daniel Hailfingerd38fac82010-01-19 11:15:48 +0000207}
Simon Glassae616512016-01-23 23:27:58 +0000208
Nico Huberd99a2bd2016-02-18 21:42:49 +0000209struct dediprog_transfer_status {
Richard Hughes842d6782021-01-15 09:48:12 +0000210 struct flashctx *flash;
Nico Huberd99a2bd2016-02-18 21:42:49 +0000211 int error; /* OK if 0, ERROR else */
212 unsigned int queued_idx;
213 unsigned int finished_idx;
214};
215
216static void LIBUSB_CALL dediprog_bulk_read_cb(struct libusb_transfer *const transfer)
217{
218 struct dediprog_transfer_status *const status = (struct dediprog_transfer_status *)transfer->user_data;
219 if (transfer->status != LIBUSB_TRANSFER_COMPLETED) {
220 status->error = 1;
221 msg_perr("SPI bulk read failed!\n");
222 }
Richard Hughes842d6782021-01-15 09:48:12 +0000223 flashprog_progress_add(status->flash, transfer->actual_length);
Nico Huberd99a2bd2016-02-18 21:42:49 +0000224 ++status->finished_idx;
225}
226
Anastasia Klimchukb31f7ac2021-07-12 14:18:37 +1000227static int dediprog_bulk_read_poll(struct libusb_context *usb_ctx,
228 const struct dediprog_transfer_status *const status,
229 const int finish)
Nico Huberd99a2bd2016-02-18 21:42:49 +0000230{
231 if (status->finished_idx >= status->queued_idx)
232 return 0;
233
234 do {
235 struct timeval timeout = { 10, 0 };
236 const int ret = libusb_handle_events_timeout(usb_ctx, &timeout);
237 if (ret < 0) {
238 msg_perr("Polling read events failed: %i %s!\n", ret, libusb_error_name(ret));
239 return 1;
240 }
241 } while (finish && (status->finished_idx < status->queued_idx));
242 return 0;
243}
244
Anastasia Klimchukb31f7ac2021-07-12 14:18:37 +1000245static int dediprog_read(libusb_device_handle *dediprog_handle,
246 enum dediprog_cmds cmd, unsigned int value, unsigned int idx,
247 uint8_t *bytes, size_t size)
Simon Glassae616512016-01-23 23:27:58 +0000248{
Nico Huberd99a2bd2016-02-18 21:42:49 +0000249 return libusb_control_transfer(dediprog_handle, REQTYPE_EP_IN, cmd, value, idx,
250 (unsigned char *)bytes, size, DEFAULT_TIMEOUT);
Simon Glassae616512016-01-23 23:27:58 +0000251}
252
Anastasia Klimchukb31f7ac2021-07-12 14:18:37 +1000253static int dediprog_write(libusb_device_handle *dediprog_handle,
254 enum dediprog_cmds cmd, unsigned int value, unsigned int idx,
255 const uint8_t *bytes, size_t size)
Simon Glassae616512016-01-23 23:27:58 +0000256{
Nico Huberd99a2bd2016-02-18 21:42:49 +0000257 return libusb_control_transfer(dediprog_handle, REQTYPE_EP_OUT, cmd, value, idx,
258 (unsigned char *)bytes, size, DEFAULT_TIMEOUT);
Simon Glassae616512016-01-23 23:27:58 +0000259}
Carl-Daniel Hailfingerd38fac82010-01-19 11:15:48 +0000260
Nico Huberd99a2bd2016-02-18 21:42:49 +0000261
Simon Glass25e9f402015-06-28 13:31:19 +0000262/* This function sets the GPIOs connected to the LEDs as well as IO1-IO4. */
Anastasia Klimchukb31f7ac2021-07-12 14:18:37 +1000263static int dediprog_set_leds(int leds, const struct dediprog_data *dp_data)
Stefan Reinauer915b8402011-01-28 09:00:15 +0000264{
Simon Glass25e9f402015-06-28 13:31:19 +0000265 if (leds < LED_NONE || leds > LED_ALL)
266 leds = LED_ALL;
Stefan Reinauer915b8402011-01-28 09:00:15 +0000267
Simon Glassae616512016-01-23 23:27:58 +0000268 /* Older Dediprogs with 2.x.x and 3.x.x firmware only had two LEDs, assigned to different bits. So map
269 * them around if we have an old device. On those devices the LEDs map as follows:
Stefan Reinauer915b8402011-01-28 09:00:15 +0000270 * bit 2 == 0: green light is on.
Simon Glassae616512016-01-23 23:27:58 +0000271 * bit 0 == 0: red light is on.
272 *
273 * Additionally, the command structure has changed with the "new" protocol.
274 *
275 * FIXME: take IO pins into account
Stefan Reinauer915b8402011-01-28 09:00:15 +0000276 */
Simon Glassae616512016-01-23 23:27:58 +0000277 int target_leds, ret;
Anastasia Klimchukb31f7ac2021-07-12 14:18:37 +1000278 if (protocol(dp_data) >= PROTOCOL_V2) {
Simon Glassae616512016-01-23 23:27:58 +0000279 target_leds = (leds ^ 7) << 8;
Anastasia Klimchuk7d973882021-07-14 09:33:50 +1000280 ret = dediprog_write(dp_data->handle, CMD_SET_IO_LED, target_leds, 0, NULL, 0);
Stefan Reinauer915b8402011-01-28 09:00:15 +0000281 } else {
Anastasia Klimchuk7d973882021-07-14 09:33:50 +1000282 if (dp_data->firmwareversion < FIRMWARE_VERSION(5, 0, 0)) {
Simon Glassae616512016-01-23 23:27:58 +0000283 target_leds = ((leds & LED_ERROR) >> 2) | ((leds & LED_PASS) << 2);
284 } else {
285 target_leds = leds;
286 }
287 target_leds ^= 7;
288
Anastasia Klimchuk7d973882021-07-14 09:33:50 +1000289 ret = dediprog_write(dp_data->handle, CMD_SET_IO_LED, 0x9, target_leds, NULL, 0);
Stefan Reinauer915b8402011-01-28 09:00:15 +0000290 }
291
Stefan Reinauer915b8402011-01-28 09:00:15 +0000292 if (ret != 0x0) {
Nico Huberd99a2bd2016-02-18 21:42:49 +0000293 msg_perr("Command Set LED 0x%x failed (%s)!\n", leds, libusb_error_name(ret));
Stefan Reinauer915b8402011-01-28 09:00:15 +0000294 return 1;
295 }
296
Stefan Reinauer915b8402011-01-28 09:00:15 +0000297 return 0;
298}
299
Anastasia Klimchukb31f7ac2021-07-12 14:18:37 +1000300static int dediprog_set_spi_voltage(libusb_device_handle *dediprog_handle, int millivolt)
Carl-Daniel Hailfingerd38fac82010-01-19 11:15:48 +0000301{
302 int ret;
Carl-Daniel Hailfingerc2441382010-11-09 22:00:31 +0000303 uint16_t voltage_selector;
Carl-Daniel Hailfingerd38fac82010-01-19 11:15:48 +0000304
Carl-Daniel Hailfingerc2441382010-11-09 22:00:31 +0000305 switch (millivolt) {
306 case 0:
Carl-Daniel Hailfingerd38fac82010-01-19 11:15:48 +0000307 /* Admittedly this one is an assumption. */
Carl-Daniel Hailfingerc2441382010-11-09 22:00:31 +0000308 voltage_selector = 0x0;
Carl-Daniel Hailfingerd38fac82010-01-19 11:15:48 +0000309 break;
Carl-Daniel Hailfingerc2441382010-11-09 22:00:31 +0000310 case 1800:
311 voltage_selector = 0x12;
Carl-Daniel Hailfingerd38fac82010-01-19 11:15:48 +0000312 break;
Carl-Daniel Hailfingerc2441382010-11-09 22:00:31 +0000313 case 2500:
314 voltage_selector = 0x11;
Carl-Daniel Hailfingerd38fac82010-01-19 11:15:48 +0000315 break;
Carl-Daniel Hailfingerc2441382010-11-09 22:00:31 +0000316 case 3500:
317 voltage_selector = 0x10;
Carl-Daniel Hailfingerd38fac82010-01-19 11:15:48 +0000318 break;
319 default:
Carl-Daniel Hailfingerc2441382010-11-09 22:00:31 +0000320 msg_perr("Unknown voltage %i mV! Aborting.\n", millivolt);
Carl-Daniel Hailfingerd38fac82010-01-19 11:15:48 +0000321 return 1;
322 }
Carl-Daniel Hailfingerc2441382010-11-09 22:00:31 +0000323 msg_pdbg("Setting SPI voltage to %u.%03u V\n", millivolt / 1000,
324 millivolt % 1000);
Carl-Daniel Hailfingerd38fac82010-01-19 11:15:48 +0000325
Nico Huber4099a8a2012-06-16 00:02:27 +0000326 if (voltage_selector == 0) {
327 /* Wait some time as the original driver does. */
328 programmer_delay(200 * 1000);
329 }
Anastasia Klimchukb31f7ac2021-07-12 14:18:37 +1000330 ret = dediprog_write(dediprog_handle, CMD_SET_VCC, voltage_selector, 0, NULL, 0);
Carl-Daniel Hailfingerd38fac82010-01-19 11:15:48 +0000331 if (ret != 0x0) {
Uwe Hermann91f4afa2011-07-28 08:13:25 +0000332 msg_perr("Command Set SPI Voltage 0x%x failed!\n",
333 voltage_selector);
Carl-Daniel Hailfingerd38fac82010-01-19 11:15:48 +0000334 return 1;
335 }
Nico Huber4099a8a2012-06-16 00:02:27 +0000336 if (voltage_selector != 0) {
337 /* Wait some time as the original driver does. */
338 programmer_delay(200 * 1000);
339 }
Carl-Daniel Hailfingerd38fac82010-01-19 11:15:48 +0000340 return 0;
341}
342
Nico Huber77fa67d2013-02-20 18:03:36 +0000343struct dediprog_spispeeds {
344 const char *const name;
345 const int speed;
346};
347
348static const struct dediprog_spispeeds spispeeds[] = {
349 { "24M", 0x0 },
350 { "12M", 0x2 },
351 { "8M", 0x1 },
352 { "3M", 0x3 },
353 { "2.18M", 0x4 },
354 { "1.5M", 0x5 },
355 { "750k", 0x6 },
356 { "375k", 0x7 },
357 { NULL, 0x0 },
358};
359
Anastasia Klimchukb31f7ac2021-07-12 14:18:37 +1000360static int dediprog_set_spi_speed(unsigned int spispeed_idx, const struct dediprog_data *dp_data)
Carl-Daniel Hailfingerd38fac82010-01-19 11:15:48 +0000361{
Nico Huber00578222024-03-02 14:00:53 +0100362 if (dp_data->devicetype < DEV_SF600PG2 && dp_data->firmwareversion < FIRMWARE_VERSION(5, 0, 0)) {
Patrick Georgiefe2d432013-05-23 21:47:46 +0000363 msg_pwarn("Skipping to set SPI speed because firmware is too old.\n");
364 return 0;
365 }
Carl-Daniel Hailfingerd38fac82010-01-19 11:15:48 +0000366
Simon Glass557eb4f2015-07-05 16:53:22 +0000367 const struct dediprog_spispeeds *spispeed = &spispeeds[spispeed_idx];
368 msg_pdbg("SPI speed is %sHz\n", spispeed->name);
Carl-Daniel Hailfingerd38fac82010-01-19 11:15:48 +0000369
Anastasia Klimchuk7d973882021-07-14 09:33:50 +1000370 int ret = dediprog_write(dp_data->handle, CMD_SET_SPI_CLK, spispeed->speed, 0, NULL, 0);
Carl-Daniel Hailfingerd38fac82010-01-19 11:15:48 +0000371 if (ret != 0x0) {
Simon Glass557eb4f2015-07-05 16:53:22 +0000372 msg_perr("Command Set SPI Speed 0x%x failed!\n", spispeed->speed);
Carl-Daniel Hailfingerd38fac82010-01-19 11:15:48 +0000373 return 1;
374 }
375 return 0;
376}
377
Nico Huber7eb38aa2019-03-21 15:42:54 +0100378static int prepare_rw_cmd(
Nico Huber93db6e12018-09-30 01:18:43 +0200379 struct flashctx *const flash, uint8_t *data_packet, unsigned int count,
Nico Huber477e1692019-06-18 23:56:01 +0200380 uint8_t dedi_spi_cmd, unsigned int *value, unsigned int *idx, unsigned int start, int is_read)
381{
Nico Huber9a11cbf2023-01-13 01:19:07 +0100382 const struct dediprog_data *dp_data = flash->mst.spi->data;
Anastasia Klimchukb31f7ac2021-07-12 14:18:37 +1000383
Nico Hubera96aaa32024-03-05 12:56:13 +0100384 if (count > MAX_BLOCK_COUNT) {
Nico Huberac90af62022-12-18 00:22:47 +0000385 msg_perr("%s: Unsupported transfer length of %u blocks!\n"
Nico Huberc3b02dc2023-08-12 01:13:45 +0200386 "Please report a bug at flashprog@flashprog.org\n",
Nico Huber477e1692019-06-18 23:56:01 +0200387 __func__, count);
388 return 1;
389 }
390
Simon Glassae616512016-01-23 23:27:58 +0000391 /* First 5 bytes are common in both generations. */
392 data_packet[0] = count & 0xff;
393 data_packet[1] = (count >> 8) & 0xff;
394 data_packet[2] = 0; /* RFU */
395 data_packet[3] = dedi_spi_cmd; /* Read/Write Mode (currently READ_MODE_STD, WRITE_MODE_PAGE_PGM or WRITE_MODE_2B_AAI) */
396 data_packet[4] = 0; /* "Opcode". Specs imply necessity only for READ_MODE_4B_ADDR_FAST and WRITE_MODE_4B_ADDR_256B_PAGE_PGM */
397
Anastasia Klimchukb31f7ac2021-07-12 14:18:37 +1000398 if (protocol(dp_data) >= PROTOCOL_V2) {
Nico Huber93db6e12018-09-30 01:18:43 +0200399 if (is_read && flash->chip->feature_bits & FEATURE_4BA_FAST_READ) {
400 data_packet[3] = READ_MODE_4B_ADDR_FAST_0x0C;
401 data_packet[4] = JEDEC_READ_4BA_FAST;
402 } else if (dedi_spi_cmd == WRITE_MODE_PAGE_PGM
403 && (flash->chip->feature_bits & FEATURE_4BA_WRITE)) {
Nico Huberfb176d22024-03-25 15:55:13 +0100404 if (protocol(dp_data) >= PROTOCOL_V3)
405 data_packet[3] = WRITE_MODE_4B_ADDR_256B_PAGE_PGM;
406 else
407 data_packet[3] = WRITE_MODE_4B_ADDR_256B_PAGE_PGM_0x12;
Nico Huber93db6e12018-09-30 01:18:43 +0200408 data_packet[4] = JEDEC_BYTE_PROGRAM_4BA;
409 }
410
Simon Glassae616512016-01-23 23:27:58 +0000411 *value = *idx = 0;
412 data_packet[5] = 0; /* RFU */
413 data_packet[6] = (start >> 0) & 0xff;
414 data_packet[7] = (start >> 8) & 0xff;
415 data_packet[8] = (start >> 16) & 0xff;
416 data_packet[9] = (start >> 24) & 0xff;
Anastasia Klimchukb31f7ac2021-07-12 14:18:37 +1000417 if (protocol(dp_data) >= PROTOCOL_V3) {
David Hendricksf73f8a72018-02-21 07:34:34 -0800418 if (is_read) {
419 data_packet[10] = 0x00; /* address length (3 or 4) */
420 data_packet[11] = 0x00; /* dummy cycle / 2 */
421 } else {
422 /* 16 LSBs and 16 HSBs of page size */
423 /* FIXME: This assumes page size of 256. */
424 data_packet[10] = 0x00;
425 data_packet[11] = 0x01;
426 data_packet[12] = 0x00;
427 data_packet[13] = 0x00;
428 }
429 }
Simon Glassae616512016-01-23 23:27:58 +0000430 } else {
Nico Huber9bb8a322022-05-24 15:07:34 +0200431 if (flash->chip->feature_bits & FEATURE_4BA_EAR_ANY) {
Nico Huber7eb38aa2019-03-21 15:42:54 +0100432 if (spi_set_extended_address(flash, start >> 24))
433 return 1;
434 } else if (start >> 24) {
435 msg_cerr("Can't handle 4-byte address with dediprog.\n");
436 return 1;
437 }
438 /*
439 * We don't know how the dediprog firmware handles 4-byte
440 * addresses. So let's not tell it what we are doing and
441 * only send the lower 3 bytes.
442 */
443 *value = start & 0xffff;
444 *idx = (start >> 16) & 0xff;
Simon Glassae616512016-01-23 23:27:58 +0000445 }
Nico Huber7eb38aa2019-03-21 15:42:54 +0100446
447 return 0;
Simon Glassae616512016-01-23 23:27:58 +0000448}
449
Carl-Daniel Hailfinger482e9742010-11-16 21:25:29 +0000450/* Bulk read interface, will read multiple 512 byte chunks aligned to 512 bytes.
451 * @start start address
452 * @len length
453 * @return 0 on success, 1 on failure
454 */
Simon Glassae616512016-01-23 23:27:58 +0000455static int dediprog_spi_bulk_read(struct flashctx *flash, uint8_t *buf, unsigned int start, unsigned int len)
Carl-Daniel Hailfinger482e9742010-11-16 21:25:29 +0000456{
Nico Huberd99a2bd2016-02-18 21:42:49 +0000457 int err = 1;
Nico Huber9a11cbf2023-01-13 01:19:07 +0100458 const struct dediprog_data *dp_data = flash->mst.spi->data;
Nico Huberd99a2bd2016-02-18 21:42:49 +0000459
Carl-Daniel Hailfinger482e9742010-11-16 21:25:29 +0000460 /* chunksize must be 512, other sizes will NOT work at all. */
Simon Glassae616512016-01-23 23:27:58 +0000461 const unsigned int chunksize = 512;
Stefan Taunerc69c9c82011-11-23 09:13:48 +0000462 const unsigned int count = len / chunksize;
Carl-Daniel Hailfinger482e9742010-11-16 21:25:29 +0000463
Richard Hughes842d6782021-01-15 09:48:12 +0000464 struct dediprog_transfer_status status = { flash, 0, 0, 0 };
Nico Huberd99a2bd2016-02-18 21:42:49 +0000465 struct libusb_transfer *transfers[DEDIPROG_ASYNC_TRANSFERS] = { NULL, };
466 struct libusb_transfer *transfer;
467
Nico Huberbbaa1712018-12-05 13:26:20 +0100468 if (len == 0)
469 return 0;
470
Carl-Daniel Hailfinger482e9742010-11-16 21:25:29 +0000471 if ((start % chunksize) || (len % chunksize)) {
Nico Huberac90af62022-12-18 00:22:47 +0000472 msg_perr("%s: Unaligned start=%i, len=%i!\n"
Nico Huberc3b02dc2023-08-12 01:13:45 +0200473 "Please report a bug at flashprog@flashprog.org\n",
Simon Glassae616512016-01-23 23:27:58 +0000474 __func__, start, len);
Carl-Daniel Hailfinger482e9742010-11-16 21:25:29 +0000475 return 1;
476 }
477
David Hendricksf73f8a72018-02-21 07:34:34 -0800478 int command_packet_size;
Anastasia Klimchukb31f7ac2021-07-12 14:18:37 +1000479 switch (protocol(dp_data)) {
David Hendricksf73f8a72018-02-21 07:34:34 -0800480 case PROTOCOL_V1:
481 command_packet_size = 5;
482 break;
483 case PROTOCOL_V2:
484 command_packet_size = 10;
485 break;
486 case PROTOCOL_V3:
487 command_packet_size = 12;
488 break;
489 default:
490 return 1;
491 }
492
493 uint8_t data_packet[command_packet_size];
Simon Glassae616512016-01-23 23:27:58 +0000494 unsigned int value, idx;
Nico Huber7eb38aa2019-03-21 15:42:54 +0100495 if (prepare_rw_cmd(flash, data_packet, count, READ_MODE_STD, &value, &idx, start, 1))
496 return 1;
Simon Glassae616512016-01-23 23:27:58 +0000497
Anastasia Klimchuk7d973882021-07-14 09:33:50 +1000498 int ret = dediprog_write(dp_data->handle, CMD_READ, value, idx, data_packet, sizeof(data_packet));
Nico Huber519be662018-12-23 20:03:35 +0100499 if (ret != (int)sizeof(data_packet)) {
Nico Huberd99a2bd2016-02-18 21:42:49 +0000500 msg_perr("Command Read SPI Bulk failed, %i %s!\n", ret, libusb_error_name(ret));
Carl-Daniel Hailfinger482e9742010-11-16 21:25:29 +0000501 return 1;
502 }
503
Nico Huberd99a2bd2016-02-18 21:42:49 +0000504 /*
505 * Ring buffer of bulk transfers.
506 * Poll until at least one transfer is ready,
507 * schedule next transfers until buffer is full.
508 */
Carl-Daniel Hailfinger482e9742010-11-16 21:25:29 +0000509
Nico Huberd99a2bd2016-02-18 21:42:49 +0000510 /* Allocate bulk transfers. */
511 unsigned int i;
Nico Huber519be662018-12-23 20:03:35 +0100512 for (i = 0; i < MIN(DEDIPROG_ASYNC_TRANSFERS, count); ++i) {
Nico Huberd99a2bd2016-02-18 21:42:49 +0000513 transfers[i] = libusb_alloc_transfer(0);
514 if (!transfers[i]) {
515 msg_perr("Allocating libusb transfer %i failed: %s!\n", i, libusb_error_name(ret));
516 goto err_free;
Elyes HAOUAS124ef382018-03-27 12:15:09 +0200517 }
518 }
Nico Huberd99a2bd2016-02-18 21:42:49 +0000519
520 /* Now transfer requested chunks using libusb's asynchronous interface. */
521 while (!status.error && (status.queued_idx < count)) {
Nico Huberf84df9a2016-05-04 13:24:07 +0200522 while ((status.queued_idx < count) &&
523 (status.queued_idx - status.finished_idx) < DEDIPROG_ASYNC_TRANSFERS)
524 {
Nico Huberd99a2bd2016-02-18 21:42:49 +0000525 transfer = transfers[status.queued_idx % DEDIPROG_ASYNC_TRANSFERS];
Nico Huber821a0852024-03-24 13:34:51 +0100526 libusb_fill_bulk_transfer(transfer, dp_data->handle, dp_data->in_endpoint,
Nico Huberd99a2bd2016-02-18 21:42:49 +0000527 (unsigned char *)buf + status.queued_idx * chunksize, chunksize,
528 dediprog_bulk_read_cb, &status, DEFAULT_TIMEOUT);
529 transfer->flags |= LIBUSB_TRANSFER_SHORT_NOT_OK;
530 ret = libusb_submit_transfer(transfer);
531 if (ret < 0) {
532 msg_perr("Submitting SPI bulk read %i failed: %s!\n",
533 status.queued_idx, libusb_error_name(ret));
534 goto err_free;
535 }
536 ++status.queued_idx;
537 }
Anastasia Klimchukb31f7ac2021-07-12 14:18:37 +1000538 if (dediprog_bulk_read_poll(dp_data->usb_ctx, &status, 0))
Nico Huberd99a2bd2016-02-18 21:42:49 +0000539 goto err_free;
540 }
541 /* Wait for transfers to finish. */
Rick Altherr4f9cd8b2021-12-13 17:10:00 -0800542 if (dediprog_bulk_read_poll(dp_data->usb_ctx, &status, 1))
Nico Huberd99a2bd2016-02-18 21:42:49 +0000543 goto err_free;
544 /* Check if everything has been transmitted. */
545 if ((status.finished_idx < count) || status.error)
546 goto err_free;
547
548 err = 0;
549
550err_free:
Anastasia Klimchukb31f7ac2021-07-12 14:18:37 +1000551 dediprog_bulk_read_poll(dp_data->usb_ctx, &status, 1);
Nico Huberd99a2bd2016-02-18 21:42:49 +0000552 for (i = 0; i < DEDIPROG_ASYNC_TRANSFERS; ++i)
553 if (transfers[i]) libusb_free_transfer(transfers[i]);
554 return err;
Carl-Daniel Hailfinger482e9742010-11-16 21:25:29 +0000555}
556
Simon Glassae616512016-01-23 23:27:58 +0000557static int dediprog_spi_read(struct flashctx *flash, uint8_t *buf, unsigned int start, unsigned int len)
Carl-Daniel Hailfingerd38fac82010-01-19 11:15:48 +0000558{
Carl-Daniel Hailfinger482e9742010-11-16 21:25:29 +0000559 int ret;
560 /* chunksize must be 512, other sizes will NOT work at all. */
Stefan Taunerc69c9c82011-11-23 09:13:48 +0000561 const unsigned int chunksize = 0x200;
Nico Huberbbaa1712018-12-05 13:26:20 +0100562 unsigned int residue = start % chunksize ? min(len, chunksize - start % chunksize) : 0;
Stefan Taunerc69c9c82011-11-23 09:13:48 +0000563 unsigned int bulklen;
Nico Huber9a11cbf2023-01-13 01:19:07 +0100564 const struct dediprog_data *dp_data = flash->mst.spi->data;
Carl-Daniel Hailfinger482e9742010-11-16 21:25:29 +0000565
Anastasia Klimchukb31f7ac2021-07-12 14:18:37 +1000566 dediprog_set_leds(LED_BUSY, dp_data);
Stefan Reinauer915b8402011-01-28 09:00:15 +0000567
Carl-Daniel Hailfinger482e9742010-11-16 21:25:29 +0000568 if (residue) {
569 msg_pdbg("Slow read for partial block from 0x%x, length 0x%x\n",
570 start, residue);
Edward O'Callaghan317c67b2020-10-09 12:56:53 +1100571 ret = default_spi_read(flash, buf, start, residue);
Simon Glass25e9f402015-06-28 13:31:19 +0000572 if (ret)
573 goto err;
Carl-Daniel Hailfinger482e9742010-11-16 21:25:29 +0000574 }
575
576 /* Round down. */
577 bulklen = (len - residue) / chunksize * chunksize;
Simon Glassae616512016-01-23 23:27:58 +0000578 ret = dediprog_spi_bulk_read(flash, buf + residue, start + residue, bulklen);
Simon Glass25e9f402015-06-28 13:31:19 +0000579 if (ret)
580 goto err;
Carl-Daniel Hailfinger482e9742010-11-16 21:25:29 +0000581
582 len -= residue + bulklen;
Simon Glassae616512016-01-23 23:27:58 +0000583 if (len != 0) {
Carl-Daniel Hailfinger482e9742010-11-16 21:25:29 +0000584 msg_pdbg("Slow read for partial block from 0x%x, length 0x%x\n",
585 start, len);
Edward O'Callaghan317c67b2020-10-09 12:56:53 +1100586 ret = default_spi_read(flash, buf + residue + bulklen,
587 start + residue + bulklen, len);
Simon Glass25e9f402015-06-28 13:31:19 +0000588 if (ret)
589 goto err;
Carl-Daniel Hailfinger482e9742010-11-16 21:25:29 +0000590 }
591
Anastasia Klimchukb31f7ac2021-07-12 14:18:37 +1000592 dediprog_set_leds(LED_PASS, dp_data);
Carl-Daniel Hailfinger482e9742010-11-16 21:25:29 +0000593 return 0;
Simon Glass25e9f402015-06-28 13:31:19 +0000594err:
Anastasia Klimchukb31f7ac2021-07-12 14:18:37 +1000595 dediprog_set_leds(LED_ERROR, dp_data);
Simon Glass25e9f402015-06-28 13:31:19 +0000596 return ret;
Carl-Daniel Hailfingerd38fac82010-01-19 11:15:48 +0000597}
598
Nico Hubera4b14f72012-06-19 12:06:53 +0000599/* Bulk write interface, will write multiple chunksize byte chunks aligned to chunksize bytes.
600 * @chunksize length of data chunks, only 256 supported by now
601 * @start start address
602 * @len length
603 * @dedi_spi_cmd dediprog specific write command for spi bus
604 * @return 0 on success, 1 on failure
Carl-Daniel Hailfinger64204b52011-12-20 01:54:19 +0000605 */
Stefan Taunerffb0cf62014-05-25 07:47:47 +0000606static int dediprog_spi_bulk_write(struct flashctx *flash, const uint8_t *buf, unsigned int chunksize,
Nico Hubera4b14f72012-06-19 12:06:53 +0000607 unsigned int start, unsigned int len, uint8_t dedi_spi_cmd)
Carl-Daniel Hailfinger64204b52011-12-20 01:54:19 +0000608{
Carl-Daniel Hailfinger64204b52011-12-20 01:54:19 +0000609 /* USB transfer size must be 512, other sizes will NOT work at all.
610 * chunksize is the real data size per USB bulk transfer. The remaining
611 * space in a USB bulk transfer must be filled with 0xff padding.
612 */
Carl-Daniel Hailfinger64204b52011-12-20 01:54:19 +0000613 const unsigned int count = len / chunksize;
Nico Huber9a11cbf2023-01-13 01:19:07 +0100614 const struct dediprog_data *dp_data = flash->mst.spi->data;
Carl-Daniel Hailfinger64204b52011-12-20 01:54:19 +0000615
Nico Hubera4b14f72012-06-19 12:06:53 +0000616 /*
617 * We should change this check to
618 * chunksize > 512
619 * once we know how to handle different chunk sizes.
620 */
621 if (chunksize != 256) {
622 msg_perr("%s: Chunk sizes other than 256 bytes are unsupported, chunksize=%u!\n"
Nico Huberc3b02dc2023-08-12 01:13:45 +0200623 "Please report a bug at flashprog@flashprog.org\n",
Nico Huberac90af62022-12-18 00:22:47 +0000624 __func__, chunksize);
Nico Hubera4b14f72012-06-19 12:06:53 +0000625 return 1;
626 }
627
Carl-Daniel Hailfinger64204b52011-12-20 01:54:19 +0000628 if ((start % chunksize) || (len % chunksize)) {
Nico Huberac90af62022-12-18 00:22:47 +0000629 msg_perr("%s: Unaligned start=%i, len=%i!\n"
Nico Huberc3b02dc2023-08-12 01:13:45 +0200630 "Please report a bug at flashprog@flashprog.org\n",
Nico Huberac90af62022-12-18 00:22:47 +0000631 __func__, start, len);
Carl-Daniel Hailfinger64204b52011-12-20 01:54:19 +0000632 return 1;
633 }
634
635 /* No idea if the hardware can handle empty writes, so chicken out. */
Simon Glassae616512016-01-23 23:27:58 +0000636 if (len == 0)
Carl-Daniel Hailfinger64204b52011-12-20 01:54:19 +0000637 return 0;
Simon Glassae616512016-01-23 23:27:58 +0000638
David Hendricksf73f8a72018-02-21 07:34:34 -0800639 int command_packet_size;
Anastasia Klimchukb31f7ac2021-07-12 14:18:37 +1000640 switch (protocol(dp_data)) {
David Hendricksf73f8a72018-02-21 07:34:34 -0800641 case PROTOCOL_V1:
642 command_packet_size = 5;
643 break;
644 case PROTOCOL_V2:
645 command_packet_size = 10;
646 break;
647 case PROTOCOL_V3:
648 command_packet_size = 14;
649 break;
650 default:
651 return 1;
652 }
653
654 uint8_t data_packet[command_packet_size];
Simon Glassae616512016-01-23 23:27:58 +0000655 unsigned int value, idx;
Nico Huber7eb38aa2019-03-21 15:42:54 +0100656 if (prepare_rw_cmd(flash, data_packet, count, dedi_spi_cmd, &value, &idx, start, 0))
657 return 1;
Anastasia Klimchuk7d973882021-07-14 09:33:50 +1000658 int ret = dediprog_write(dp_data->handle, CMD_WRITE, value, idx, data_packet, sizeof(data_packet));
Nico Huber519be662018-12-23 20:03:35 +0100659 if (ret != (int)sizeof(data_packet)) {
Nico Huberd99a2bd2016-02-18 21:42:49 +0000660 msg_perr("Command Write SPI Bulk failed, %s!\n", libusb_error_name(ret));
Carl-Daniel Hailfinger64204b52011-12-20 01:54:19 +0000661 return 1;
662 }
663
Simon Glassae616512016-01-23 23:27:58 +0000664 unsigned int i;
Carl-Daniel Hailfinger64204b52011-12-20 01:54:19 +0000665 for (i = 0; i < count; i++) {
Nico Huberd99a2bd2016-02-18 21:42:49 +0000666 unsigned char usbbuf[512];
Carl-Daniel Hailfinger64204b52011-12-20 01:54:19 +0000667 memcpy(usbbuf, buf + i * chunksize, chunksize);
Simon Glassae616512016-01-23 23:27:58 +0000668 memset(usbbuf + chunksize, 0xff, sizeof(usbbuf) - chunksize); // fill up with 0xFF
Nico Huberd99a2bd2016-02-18 21:42:49 +0000669 int transferred;
Anastasia Klimchuk7d973882021-07-14 09:33:50 +1000670 ret = libusb_bulk_transfer(dp_data->handle, dp_data->out_endpoint, usbbuf, 512, &transferred,
Nico Huberd99a2bd2016-02-18 21:42:49 +0000671 DEFAULT_TIMEOUT);
672 if ((ret < 0) || (transferred != 512)) {
673 msg_perr("SPI bulk write failed, expected %i, got %s!\n", 512, libusb_error_name(ret));
Carl-Daniel Hailfinger64204b52011-12-20 01:54:19 +0000674 return 1;
675 }
Richard Hughes842d6782021-01-15 09:48:12 +0000676 flashprog_progress_add(flash, chunksize);
Carl-Daniel Hailfinger64204b52011-12-20 01:54:19 +0000677 }
678
679 return 0;
680}
681
Stefan Taunerffb0cf62014-05-25 07:47:47 +0000682static int dediprog_spi_write(struct flashctx *flash, const uint8_t *buf,
Nico Hubera4b14f72012-06-19 12:06:53 +0000683 unsigned int start, unsigned int len, uint8_t dedi_spi_cmd)
Carl-Daniel Hailfinger306b8182010-11-23 21:28:16 +0000684{
Stefan Reinauer915b8402011-01-28 09:00:15 +0000685 int ret;
Carl-Daniel Hailfinger5a7cb842012-08-25 01:17:58 +0000686 const unsigned int chunksize = flash->chip->page_size;
Carl-Daniel Hailfinger64204b52011-12-20 01:54:19 +0000687 unsigned int residue = start % chunksize ? chunksize - start % chunksize : 0;
688 unsigned int bulklen;
Nico Huber9a11cbf2023-01-13 01:19:07 +0100689 const struct dediprog_data *dp_data = flash->mst.spi->data;
Stefan Reinauer915b8402011-01-28 09:00:15 +0000690
Anastasia Klimchukb31f7ac2021-07-12 14:18:37 +1000691 dediprog_set_leds(LED_BUSY, dp_data);
Stefan Reinauer915b8402011-01-28 09:00:15 +0000692
Nico Hubera4b14f72012-06-19 12:06:53 +0000693 if (chunksize != 256) {
694 msg_pdbg("Page sizes other than 256 bytes are unsupported as "
695 "we don't know how dediprog\nhandles them.\n");
696 /* Write everything like it was residue. */
697 residue = len;
698 }
699
Carl-Daniel Hailfinger64204b52011-12-20 01:54:19 +0000700 if (residue) {
701 msg_pdbg("Slow write for partial block from 0x%x, length 0x%x\n",
702 start, residue);
Nico Huber93db6e12018-09-30 01:18:43 +0200703 /* No idea about the real limit. Maybe 16 including command and address, maybe more. */
Nico Hubere36e3dc2023-04-28 21:23:08 +0000704 ret = default_spi_write_256(flash, buf, start, residue);
Carl-Daniel Hailfinger64204b52011-12-20 01:54:19 +0000705 if (ret) {
Anastasia Klimchukb31f7ac2021-07-12 14:18:37 +1000706 dediprog_set_leds(LED_ERROR, dp_data);
Carl-Daniel Hailfinger64204b52011-12-20 01:54:19 +0000707 return ret;
708 }
709 }
Stefan Reinauer915b8402011-01-28 09:00:15 +0000710
Carl-Daniel Hailfinger64204b52011-12-20 01:54:19 +0000711 /* Round down. */
712 bulklen = (len - residue) / chunksize * chunksize;
Nico Hubera4b14f72012-06-19 12:06:53 +0000713 ret = dediprog_spi_bulk_write(flash, buf + residue, chunksize, start + residue, bulklen, dedi_spi_cmd);
Carl-Daniel Hailfinger64204b52011-12-20 01:54:19 +0000714 if (ret) {
Anastasia Klimchukb31f7ac2021-07-12 14:18:37 +1000715 dediprog_set_leds(LED_ERROR, dp_data);
Carl-Daniel Hailfinger64204b52011-12-20 01:54:19 +0000716 return ret;
717 }
Stefan Reinauer915b8402011-01-28 09:00:15 +0000718
Carl-Daniel Hailfinger64204b52011-12-20 01:54:19 +0000719 len -= residue + bulklen;
720 if (len) {
721 msg_pdbg("Slow write for partial block from 0x%x, length 0x%x\n",
722 start, len);
Nico Hubere36e3dc2023-04-28 21:23:08 +0000723 ret = default_spi_write_256(flash, buf + residue + bulklen, start + residue + bulklen, len);
Carl-Daniel Hailfinger64204b52011-12-20 01:54:19 +0000724 if (ret) {
Anastasia Klimchukb31f7ac2021-07-12 14:18:37 +1000725 dediprog_set_leds(LED_ERROR, dp_data);
Carl-Daniel Hailfinger64204b52011-12-20 01:54:19 +0000726 return ret;
727 }
728 }
729
Anastasia Klimchukb31f7ac2021-07-12 14:18:37 +1000730 dediprog_set_leds(LED_PASS, dp_data);
Carl-Daniel Hailfinger64204b52011-12-20 01:54:19 +0000731 return 0;
Carl-Daniel Hailfinger306b8182010-11-23 21:28:16 +0000732}
733
Nico Hubera96aaa32024-03-05 12:56:13 +0100734static int dediprog_spi_write_chunked(struct flashctx *flash, const uint8_t *buf,
735 unsigned int start, unsigned int len, uint8_t dedi_spi_cmd)
736{
737 /* We can write only up to 65535 pages at once: */
738 while (len) {
739 const size_t len_here = MIN(len, flash->chip->page_size * MAX_BLOCK_COUNT);
740 const int ret = dediprog_spi_write(flash, buf, start, len_here, dedi_spi_cmd);
741 if (ret)
742 return ret;
743
744 start += len_here;
745 buf += len_here;
746 len -= len_here;
747 }
748 return 0;
749}
750
Stefan Taunerffb0cf62014-05-25 07:47:47 +0000751static int dediprog_spi_write_256(struct flashctx *flash, const uint8_t *buf, unsigned int start, unsigned int len)
Nico Hubera4b14f72012-06-19 12:06:53 +0000752{
Nico Hubera96aaa32024-03-05 12:56:13 +0100753 return dediprog_spi_write_chunked(flash, buf, start, len, WRITE_MODE_PAGE_PGM);
Nico Hubera4b14f72012-06-19 12:06:53 +0000754}
755
Stefan Taunerffb0cf62014-05-25 07:47:47 +0000756static int dediprog_spi_write_aai(struct flashctx *flash, const uint8_t *buf, unsigned int start, unsigned int len)
Nico Hubera4b14f72012-06-19 12:06:53 +0000757{
Nico Hubera96aaa32024-03-05 12:56:13 +0100758 return dediprog_spi_write_chunked(flash, buf, start, len, WRITE_MODE_2B_AAI);
Nico Hubera4b14f72012-06-19 12:06:53 +0000759}
760
Edward O'Callaghan5eca4272020-04-12 17:27:53 +1000761static int dediprog_spi_send_command(const struct flashctx *flash,
Carl-Daniel Hailfinger8a3c60c2011-12-18 15:01:24 +0000762 unsigned int writecnt,
763 unsigned int readcnt,
764 const unsigned char *writearr,
765 unsigned char *readarr)
Carl-Daniel Hailfingerd38fac82010-01-19 11:15:48 +0000766{
767 int ret;
Nico Huber9a11cbf2023-01-13 01:19:07 +0100768 const struct dediprog_data *dp_data = flash->mst.spi->data;
Carl-Daniel Hailfingerd38fac82010-01-19 11:15:48 +0000769
Carl-Daniel Hailfingereac65792010-01-22 02:53:30 +0000770 msg_pspew("%s, writecnt=%i, readcnt=%i\n", __func__, writecnt, readcnt);
Nico Hubere36e3dc2023-04-28 21:23:08 +0000771 if (writecnt > flash->mst.spi->max_data_write + 5) {
Simon Glass557eb4f2015-07-05 16:53:22 +0000772 msg_perr("Invalid writecnt=%i, aborting.\n", writecnt);
Carl-Daniel Hailfingereac65792010-01-22 02:53:30 +0000773 return 1;
774 }
Nico Huber9a11cbf2023-01-13 01:19:07 +0100775 if (readcnt > flash->mst.spi->max_data_read) {
Simon Glass557eb4f2015-07-05 16:53:22 +0000776 msg_perr("Invalid readcnt=%i, aborting.\n", readcnt);
Carl-Daniel Hailfingereac65792010-01-22 02:53:30 +0000777 return 1;
778 }
Elyes HAOUAS0cacb112019-02-04 12:16:38 +0100779
Simon Glassae616512016-01-23 23:27:58 +0000780 unsigned int idx, value;
781 /* New protocol has options and timeout combined as value while the old one used the value field for
782 * timeout and the index field for options. */
Anastasia Klimchukb31f7ac2021-07-12 14:18:37 +1000783 if (protocol(dp_data) >= PROTOCOL_V2) {
Simon Glassae616512016-01-23 23:27:58 +0000784 idx = 0;
785 value = readcnt ? 0x1 : 0x0; // Indicate if we require a read
786 } else {
787 idx = readcnt ? 0x1 : 0x0; // Indicate if we require a read
788 value = 0;
789 }
Anastasia Klimchuk7d973882021-07-14 09:33:50 +1000790 ret = dediprog_write(dp_data->handle, CMD_TRANSCEIVE, value, idx, writearr, writecnt);
Nico Huber519be662018-12-23 20:03:35 +0100791 if (ret != (int)writecnt) {
Carl-Daniel Hailfingereac65792010-01-22 02:53:30 +0000792 msg_perr("Send SPI failed, expected %i, got %i %s!\n",
Nico Huberd99a2bd2016-02-18 21:42:49 +0000793 writecnt, ret, libusb_error_name(ret));
Carl-Daniel Hailfingerd38fac82010-01-19 11:15:48 +0000794 return 1;
795 }
Simon Glassae616512016-01-23 23:27:58 +0000796 if (readcnt == 0) // If we don't require a response, we are done here
Carl-Daniel Hailfingerd38fac82010-01-19 11:15:48 +0000797 return 0;
Simon Glass557eb4f2015-07-05 16:53:22 +0000798
Stefan Tauner74367bf2016-02-20 20:53:46 +0000799 /* The specifications do state the possibility to set a timeout for transceive transactions.
800 * Apparently the "timeout" is a delay, and you can use long delays to accelerate writing - in case you
801 * can predict the time needed by the previous command or so (untested). In any case, using this
802 * "feature" to set sane-looking timouts for the read below will completely trash performance with
803 * SF600 and/or firmwares >= 6.0 while they seem to be benign on SF100 with firmwares <= 5.5.2. *shrug*
804 *
805 * The specification also uses only 0 in its examples, so the lesson to learn here:
806 * "Never trust the description of an interface in the documentation but use the example code and pray."
Simon Glassae616512016-01-23 23:27:58 +0000807 const uint8_t read_timeout = 10 + readcnt/512;
David Hendricksf73f8a72018-02-21 07:34:34 -0800808 if (protocol() >= PROTOCOL_V2) {
Simon Glassae616512016-01-23 23:27:58 +0000809 idx = 0;
810 value = min(read_timeout, 0xFF) | (0 << 8) ; // Timeout in lower byte, option in upper byte
811 } else {
812 idx = (0 & 0xFF); // Lower byte is option (0x01 = require SR, 0x02 keep CS low)
813 value = min(read_timeout, 0xFF); // Possibly two bytes but we play safe here
814 }
Anastasia Klimchukb31f7ac2021-07-12 14:18:37 +1000815 ret = dediprog_read(dp_data->dediprog_handle, CMD_TRANSCEIVE, value, idx, readarr, readcnt);
Stefan Tauner74367bf2016-02-20 20:53:46 +0000816 */
Anastasia Klimchuk7d973882021-07-14 09:33:50 +1000817 ret = dediprog_read(dp_data->handle, CMD_TRANSCEIVE, 0, 0, readarr, readcnt);
Nico Huber519be662018-12-23 20:03:35 +0100818 if (ret != (int)readcnt) {
Nico Huberd99a2bd2016-02-18 21:42:49 +0000819 msg_perr("Receive SPI failed, expected %i, got %i %s!\n", readcnt, ret, libusb_error_name(ret));
Carl-Daniel Hailfingerd38fac82010-01-19 11:15:48 +0000820 return 1;
821 }
822 return 0;
823}
824
Nico Huber823a7042024-03-24 18:32:58 +0100825static int dediprog_read_devicestring(struct dediprog_data *dp_data, bool warn)
Carl-Daniel Hailfingerd38fac82010-01-19 11:15:48 +0000826{
Nico Huber274e6552024-03-24 12:34:57 +0100827 const int devstr_len = sizeof(dp_data->devicestring) - 1, old_devstr_len = 16;
828 char *const buf = dp_data->devicestring;
Carl-Daniel Hailfingerd38fac82010-01-19 11:15:48 +0000829 int ret;
Carl-Daniel Hailfingerd38fac82010-01-19 11:15:48 +0000830
Carl-Daniel Hailfingerd38fac82010-01-19 11:15:48 +0000831 /* Command Receive Device String. */
Nico Hubere76e21f2024-02-29 23:33:35 +0100832 ret = dediprog_read(dp_data->handle, CMD_READ_PROG_INFO, 0, 0, (uint8_t *)buf, devstr_len);
Nico Huber5262e292024-03-02 13:21:25 +0100833 if (ret < old_devstr_len || ret > devstr_len) {
Nico Huber823a7042024-03-24 18:32:58 +0100834 if (warn)
835 msg_perr("Incomplete/failed Command Receive Device String!\n");
Carl-Daniel Hailfingerd38fac82010-01-19 11:15:48 +0000836 return 1;
837 }
Nico Huber5262e292024-03-02 13:21:25 +0100838 buf[ret] = '\0';
Carl-Daniel Hailfingerd38fac82010-01-19 11:15:48 +0000839 msg_pdbg("Found a %s\n", buf);
Nico Hubere76e21f2024-02-29 23:33:35 +0100840 if (memcmp(buf, "SF100", 5) == 0)
Anastasia Klimchuk7d973882021-07-14 09:33:50 +1000841 dp_data->devicetype = DEV_SF100;
Nico Hubere76e21f2024-02-29 23:33:35 +0100842 else if (memcmp(buf, "SF200", 5) == 0)
Anastasia Klimchuk7d973882021-07-14 09:33:50 +1000843 dp_data->devicetype = DEV_SF200;
Nico Huber00578222024-03-02 14:00:53 +0100844 else if (memcmp(buf, "SF600PG2", 8) == 0) /* match first, before shorter, generic SF600 */
845 dp_data->devicetype = DEV_SF600PG2;
Nico Hubere76e21f2024-02-29 23:33:35 +0100846 else if (memcmp(buf, "SF600", 5) == 0)
Anastasia Klimchuk7d973882021-07-14 09:33:50 +1000847 dp_data->devicetype = DEV_SF600;
Nico Huber00578222024-03-02 14:00:53 +0100848 else if (memcmp(buf, "SF700", 5) == 0)
849 dp_data->devicetype = DEV_SF700;
Nico Huber274e6552024-03-24 12:34:57 +0100850 else
Carl-Daniel Hailfingerd38fac82010-01-19 11:15:48 +0000851 return 1;
David Woodhouse7f3b89f2016-02-18 21:42:15 +0000852
Nico Huber274e6552024-03-24 12:34:57 +0100853 return 0;
854}
855
856static int dediprog_check_devicestring(struct dediprog_data *dp_data)
857{
858 char *const buf = dp_data->devicestring;
Nico Huberbdef5c22024-03-02 13:51:39 +0100859 unsigned int sfnum;
860 unsigned int fw[3];
Nico Huber274e6552024-03-24 12:34:57 +0100861
Nico Huber0ab5c3d2024-03-02 13:53:16 +0100862 if (sscanf(buf, "SF%u", &sfnum) != 1 ||
Nico Huber00578222024-03-02 14:00:53 +0100863 sfnum != dp_data->devicetype / 100 * 100 ||
Nico Huber0ab5c3d2024-03-02 13:53:16 +0100864 sscanf(buf, "SF%*s V:%u.%u.%u ", &fw[0], &fw[1], &fw[2]) != 3) {
Simon Glassae616512016-01-23 23:27:58 +0000865 msg_perr("Unexpected firmware version string '%s'\n", buf);
Mathias Krausedb7afc52010-11-09 23:30:43 +0000866 return 1;
867 }
Nico Huber00578222024-03-02 14:00:53 +0100868
869 /* Only allow major versions that were tested. */
870 if ((dp_data->devicetype == DEV_SF600PG2 && fw[0] > 1) ||
871 (dp_data->devicetype == DEV_SF700 && fw[0] != 4) ||
872 (dp_data->devicetype <= DEV_SF600 && (fw[0] < 2 || fw[0] > 7))) {
Simon Glassae616512016-01-23 23:27:58 +0000873 msg_perr("Unexpected firmware version %d.%d.%d!\n", fw[0], fw[1], fw[2]);
Carl-Daniel Hailfingerd38fac82010-01-19 11:15:48 +0000874 return 1;
875 }
David Hendricksf73f8a72018-02-21 07:34:34 -0800876
Anastasia Klimchuk7d973882021-07-14 09:33:50 +1000877 dp_data->firmwareversion = FIRMWARE_VERSION(fw[0], fw[1], fw[2]);
Anastasia Klimchukb31f7ac2021-07-12 14:18:37 +1000878 if (protocol(dp_data) == PROTOCOL_UNKNOWN) {
David Hendricksf73f8a72018-02-21 07:34:34 -0800879 msg_perr("Internal error: Unable to determine protocol version.\n");
880 return 1;
881 }
Simon Glassae616512016-01-23 23:27:58 +0000882
Carl-Daniel Hailfingerd38fac82010-01-19 11:15:48 +0000883 return 0;
884}
885
David Hendricksc05900f2016-02-18 21:42:41 +0000886/*
Ryan O'Leary301ae222019-06-24 19:14:33 -0700887 * Read the id from the dediprog. This should return the numeric part of the
888 * serial number found on a sticker on the back of the dediprog. Note this
Nico Huber821a0852024-03-24 13:34:51 +0100889 * number is stored in writable eeprom, so it could get out of sync.
Ryan O'Leary301ae222019-06-24 19:14:33 -0700890 * @return the id on success, -1 on failure
891 */
Nico Huber821a0852024-03-24 13:34:51 +0100892static int dediprog_read_id(struct dediprog_data *const dp)
Ryan O'Leary301ae222019-06-24 19:14:33 -0700893{
Nico Huber821a0852024-03-24 13:34:51 +0100894 const int min_len = 3;
Ryan O'Leary301ae222019-06-24 19:14:33 -0700895 int ret;
Ryan O'Leary301ae222019-06-24 19:14:33 -0700896
Nico Huber821a0852024-03-24 13:34:51 +0100897 if (dp->devicetype >= DEV_SF600PG2) {
898 const uint8_t out[6] = { 0x00, 0x00, 0x00, 0x02, 0x00, 0x00 };
899 const uint8_t cmd = 0x71;
900 uint8_t buf[512];
901 int transferred;
902 int try;
903
904 /* Always query the id twice as the endpoint
905 can lock up in mysterious ways otherwise. */
906 for (try = 0; try < 2; ++try) {
907 ret = dediprog_write(dp->handle, cmd, 0, 0, out, sizeof(out));
908 if (ret != (int)sizeof(out))
909 goto failed_ret;
910
911 ret = libusb_bulk_transfer(dp->handle, dp->in_endpoint,
912 buf, sizeof(buf), &transferred, DEFAULT_TIMEOUT);
913 }
914
915 if (ret == 0 && transferred >= min_len)
916 return buf[2] << 16 | buf[1] << 8 | buf[0];
917 } else {
918 uint8_t buf[16];
919
920 if (dp->devicetype >= DEV_SF600) {
921 ret = dediprog_read(dp->handle, CMD_READ_EEPROM, 0, 0, buf, sizeof(buf));
922 } else {
923 ret = libusb_control_transfer(dp->handle, REQTYPE_OTHER_IN,
924 0x7, /* request */
925 0, /* value */
926 0xEF00, /* index */
927 buf, min_len, DEFAULT_TIMEOUT);
928 }
929
930 if (ret >= min_len)
931 return buf[0] << 16 | buf[1] << 8 | buf[2];
Ryan O'Leary301ae222019-06-24 19:14:33 -0700932 }
933
Nico Huber821a0852024-03-24 13:34:51 +0100934failed_ret:
935 msg_perr("Failed to read dediprog id: ");
936 if (ret < 0)
937 msg_perr("%s (%d)\n", libusb_strerror(ret), ret);
938 else
939 msg_perr("short read!\n");
940 return -1;
Ryan O'Leary301ae222019-06-24 19:14:33 -0700941}
942
943/*
David Hendricksc05900f2016-02-18 21:42:41 +0000944 * This command presumably sets the voltage for the SF100 itself (not the
945 * SPI flash). Only use this command with firmware older than V6.0.0. Newer
946 * (including all SF600s) do not support it.
947 */
Carl-Daniel Hailfingerd38fac82010-01-19 11:15:48 +0000948
David Hendricksc05900f2016-02-18 21:42:41 +0000949/* This command presumably sets the voltage for the SF100 itself (not the SPI flash).
950 * Only use dediprog_set_voltage on SF100 programmers with firmware older
951 * than V6.0.0. Newer programmers (including all SF600s) do not support it. */
Anastasia Klimchukb31f7ac2021-07-12 14:18:37 +1000952static int dediprog_set_voltage(libusb_device_handle *dediprog_handle)
David Hendricksc05900f2016-02-18 21:42:41 +0000953{
Nico Huberd99a2bd2016-02-18 21:42:49 +0000954 unsigned char buf[1] = {0};
955 int ret = libusb_control_transfer(dediprog_handle, REQTYPE_OTHER_IN, CMD_SET_VOLTAGE, 0x0, 0x0,
Simon Glass557eb4f2015-07-05 16:53:22 +0000956 buf, 0x1, DEFAULT_TIMEOUT);
Mathias Krausedb7afc52010-11-09 23:30:43 +0000957 if (ret < 0) {
Nico Huberd99a2bd2016-02-18 21:42:49 +0000958 msg_perr("Command Set Voltage failed (%s)!\n", libusb_error_name(ret));
Mathias Krausedb7afc52010-11-09 23:30:43 +0000959 return 1;
960 }
David Hendricksc05900f2016-02-18 21:42:41 +0000961 if ((ret != 1) || (buf[0] != 0x6f)) {
Simon Glass557eb4f2015-07-05 16:53:22 +0000962 msg_perr("Unexpected response to init!\n");
Carl-Daniel Hailfingerd38fac82010-01-19 11:15:48 +0000963 return 1;
964 }
David Hendricksc05900f2016-02-18 21:42:41 +0000965
Carl-Daniel Hailfingerd38fac82010-01-19 11:15:48 +0000966 return 0;
967}
968
Anastasia Klimchukb31f7ac2021-07-12 14:18:37 +1000969static int dediprog_standalone_mode(const struct dediprog_data *dp_data)
David Woodhouse7f3b89f2016-02-18 21:42:15 +0000970{
971 int ret;
972
Anastasia Klimchuk7d973882021-07-14 09:33:50 +1000973 if (dp_data->devicetype != DEV_SF600)
David Woodhouse7f3b89f2016-02-18 21:42:15 +0000974 return 0;
975
976 msg_pdbg2("Disabling standalone mode.\n");
Anastasia Klimchuk7d973882021-07-14 09:33:50 +1000977 ret = dediprog_write(dp_data->handle, CMD_SET_STANDALONE, LEAVE_STANDALONE_MODE, 0, NULL, 0);
David Woodhouse7f3b89f2016-02-18 21:42:15 +0000978 if (ret) {
Nico Huberd99a2bd2016-02-18 21:42:49 +0000979 msg_perr("Failed to disable standalone mode: %s\n", libusb_error_name(ret));
David Woodhouse7f3b89f2016-02-18 21:42:15 +0000980 return 1;
981 }
982
983 return 0;
984}
985
Carl-Daniel Hailfingerff30d8a2011-01-20 21:05:15 +0000986#if 0
987/* Something.
988 * Present in eng_detect_blink.log with firmware 3.1.8
989 * Always preceded by Command Receive Device String
990 */
Anastasia Klimchukb31f7ac2021-07-12 14:18:37 +1000991static int dediprog_command_b(libusb_device_handle *dediprog_handle)
Carl-Daniel Hailfingerff30d8a2011-01-20 21:05:15 +0000992{
993 int ret;
994 char buf[0x3];
995
Simon Glass557eb4f2015-07-05 16:53:22 +0000996 ret = usb_control_msg(dediprog_handle, REQTYPE_OTHER_IN, 0x7, 0x0, 0xef00,
997 buf, 0x3, DEFAULT_TIMEOUT);
Carl-Daniel Hailfingerff30d8a2011-01-20 21:05:15 +0000998 if (ret < 0) {
Nico Huberd99a2bd2016-02-18 21:42:49 +0000999 msg_perr("Command B failed (%s)!\n", libusb_error_name(ret));
Carl-Daniel Hailfingerff30d8a2011-01-20 21:05:15 +00001000 return 1;
1001 }
1002 if ((ret != 0x3) || (buf[0] != 0xff) || (buf[1] != 0xff) ||
1003 (buf[2] != 0xff)) {
1004 msg_perr("Unexpected response to Command B!\n");
1005 return 1;
1006 }
1007
1008 return 0;
1009}
1010#endif
1011
Anastasia Klimchukb31f7ac2021-07-12 14:18:37 +10001012static int set_target_flash(libusb_device_handle *dediprog_handle, enum dediprog_target target)
Carl-Daniel Hailfingerd38fac82010-01-19 11:15:48 +00001013{
Anastasia Klimchukb31f7ac2021-07-12 14:18:37 +10001014 int ret = dediprog_write(dediprog_handle, CMD_SET_TARGET, target, 0, NULL, 0);
Simon Glass557eb4f2015-07-05 16:53:22 +00001015 if (ret != 0) {
Nico Huberd99a2bd2016-02-18 21:42:49 +00001016 msg_perr("set_target_flash failed (%s)!\n", libusb_error_name(ret));
Carl-Daniel Hailfingerd38fac82010-01-19 11:15:48 +00001017 return 1;
1018 }
1019 return 0;
1020}
1021
Carl-Daniel Hailfingerad3cc552010-07-03 11:02:10 +00001022#if 0
Simon Glass557eb4f2015-07-05 16:53:22 +00001023/* Returns true if the button is currently pressed. */
Anastasia Klimchukb31f7ac2021-07-12 14:18:37 +10001024static bool dediprog_get_button(libusb_device_handle *dediprog_handle)
Carl-Daniel Hailfingerd38fac82010-01-19 11:15:48 +00001025{
Simon Glass557eb4f2015-07-05 16:53:22 +00001026 char buf[1];
1027 int ret = usb_control_msg(dediprog_handle, REQTYPE_EP_IN, CMD_GET_BUTTON, 0, 0,
1028 buf, 0x1, DEFAULT_TIMEOUT);
1029 if (ret != 0) {
Nico Huberd99a2bd2016-02-18 21:42:49 +00001030 msg_perr("Could not get button state (%s)!\n", libusb_error_name(ret));
Carl-Daniel Hailfingerff30d8a2011-01-20 21:05:15 +00001031 return 1;
1032 }
Simon Glass557eb4f2015-07-05 16:53:22 +00001033 return buf[0] != 1;
Carl-Daniel Hailfinger64204b52011-12-20 01:54:19 +00001034}
Carl-Daniel Hailfingerad3cc552010-07-03 11:02:10 +00001035#endif
Carl-Daniel Hailfingerd38fac82010-01-19 11:15:48 +00001036
Carl-Daniel Hailfingerc2441382010-11-09 22:00:31 +00001037static int parse_voltage(char *voltage)
1038{
1039 char *tmp = NULL;
Carl-Daniel Hailfinger082c8b52011-08-15 19:54:20 +00001040 int i;
1041 int millivolt = 0, fraction = 0;
Carl-Daniel Hailfingerc2441382010-11-09 22:00:31 +00001042
1043 if (!voltage || !strlen(voltage)) {
1044 msg_perr("Empty voltage= specified.\n");
1045 return -1;
1046 }
1047 millivolt = (int)strtol(voltage, &tmp, 0);
1048 voltage = tmp;
1049 /* Handle "," and "." as decimal point. Everything after it is assumed
1050 * to be in decimal notation.
1051 */
1052 if ((*voltage == '.') || (*voltage == ',')) {
1053 voltage++;
1054 for (i = 0; i < 3; i++) {
1055 fraction *= 10;
1056 /* Don't advance if the current character is invalid,
1057 * but continue multiplying.
1058 */
1059 if ((*voltage < '0') || (*voltage > '9'))
1060 continue;
1061 fraction += *voltage - '0';
1062 voltage++;
1063 }
1064 /* Throw away remaining digits. */
1065 voltage += strspn(voltage, "0123456789");
1066 }
1067 /* The remaining string must be empty or "mV" or "V". */
1068 tolower_string(voltage);
1069
1070 /* No unit or "V". */
1071 if ((*voltage == '\0') || !strncmp(voltage, "v", 1)) {
1072 millivolt *= 1000;
1073 millivolt += fraction;
1074 } else if (!strncmp(voltage, "mv", 2) ||
1075 !strncmp(voltage, "milliv", 6)) {
1076 /* No adjustment. fraction is discarded. */
1077 } else {
1078 /* Garbage at the end of the string. */
1079 msg_perr("Garbage voltage= specified.\n");
1080 return -1;
1081 }
1082 return millivolt;
1083}
1084
Anastasia Klimchukc63d9182021-07-06 16:18:44 +10001085static int dediprog_shutdown(void *data);
1086
Nico Huber93db6e12018-09-30 01:18:43 +02001087static struct spi_master spi_master_dediprog = {
Nico Huberdc5af542018-12-22 16:54:59 +01001088 .features = SPI_MASTER_NO_4BA_MODES,
Simon Glassae616512016-01-23 23:27:58 +00001089 .max_data_read = 16, /* 18 seems to work fine as well, but 19 times out sometimes with FW 5.15. */
Nico Hubere36e3dc2023-04-28 21:23:08 +00001090 .max_data_write = 16 - 5, /* Account for 5 bytes cmd/addr. */
Uwe Hermann91f4afa2011-07-28 08:13:25 +00001091 .command = dediprog_spi_send_command,
1092 .multicommand = default_spi_send_multicommand,
1093 .read = dediprog_spi_read,
1094 .write_256 = dediprog_spi_write_256,
Nico Hubera4b14f72012-06-19 12:06:53 +00001095 .write_aai = dediprog_spi_write_aai,
Anastasia Klimchukc63d9182021-07-06 16:18:44 +10001096 .shutdown = dediprog_shutdown,
Aarya Chaumal0cea7532022-07-04 18:21:50 +05301097 .probe_opcode = default_spi_probe_opcode,
Michael Karcherb9dbe482011-05-11 17:07:07 +00001098};
1099
Ryan O'Leary301ae222019-06-24 19:14:33 -07001100/*
1101 * Open a dediprog_handle with the USB device at the given index.
1102 * @index index of the USB device
Nico Huber274e6552024-03-24 12:34:57 +01001103 * @return 0 for success, -1 for error, -2 for busy device, -3 for unknown device
Ryan O'Leary301ae222019-06-24 19:14:33 -07001104 */
Anastasia Klimchukb31f7ac2021-07-12 14:18:37 +10001105static int dediprog_open(int index, struct dediprog_data *dp_data)
Ryan O'Leary301ae222019-06-24 19:14:33 -07001106{
1107 const uint16_t vid = devs_dediprog[0].vendor_id;
1108 const uint16_t pid = devs_dediprog[0].device_id;
1109 int ret;
1110
Anastasia Klimchuk7d973882021-07-14 09:33:50 +10001111 dp_data->handle = usb_dev_get_by_vid_pid_number(dp_data->usb_ctx, vid, pid, (unsigned int) index);
1112 if (!dp_data->handle) {
Ryan O'Leary301ae222019-06-24 19:14:33 -07001113 msg_perr("Could not find a Dediprog programmer on USB.\n");
Anastasia Klimchukb31f7ac2021-07-12 14:18:37 +10001114 libusb_exit(dp_data->usb_ctx);
Ryan O'Leary301ae222019-06-24 19:14:33 -07001115 return -1;
1116 }
Anastasia Klimchuk7d973882021-07-14 09:33:50 +10001117 ret = libusb_set_configuration(dp_data->handle, 1);
Ryan O'Leary301ae222019-06-24 19:14:33 -07001118 if (ret != 0) {
1119 msg_perr("Could not set USB device configuration: %i %s\n",
1120 ret, libusb_error_name(ret));
Anastasia Klimchuk7d973882021-07-14 09:33:50 +10001121 libusb_close(dp_data->handle);
Ryan O'Leary301ae222019-06-24 19:14:33 -07001122 return -2;
1123 }
Anastasia Klimchuk7d973882021-07-14 09:33:50 +10001124 ret = libusb_claim_interface(dp_data->handle, 0);
Ryan O'Leary301ae222019-06-24 19:14:33 -07001125 if (ret < 0) {
1126 msg_perr("Could not claim USB device interface %i: %i %s\n",
1127 0, ret, libusb_error_name(ret));
Anastasia Klimchuk7d973882021-07-14 09:33:50 +10001128 libusb_close(dp_data->handle);
Ryan O'Leary301ae222019-06-24 19:14:33 -07001129 return -2;
1130 }
Nico Huber274e6552024-03-24 12:34:57 +01001131
1132 /* Try reading the devicestring. If that fails and the device is old
1133 (FW < 6.0.0, which we cannot know), then we need to try the "set
1134 voltage" command and then attempt to read the devicestring again. */
Nico Huber823a7042024-03-24 18:32:58 +01001135 if (dediprog_read_devicestring(dp_data, /* warn => */false)) {
Nico Huber274e6552024-03-24 12:34:57 +01001136 if (dediprog_set_voltage(dp_data->handle))
1137 goto unknown_dev;
Nico Huber823a7042024-03-24 18:32:58 +01001138 if (dediprog_read_devicestring(dp_data, /* warn => */true))
Nico Huber274e6552024-03-24 12:34:57 +01001139 goto unknown_dev;
1140 }
Nico Huber821a0852024-03-24 13:34:51 +01001141
1142 dp_data->in_endpoint = LIBUSB_ENDPOINT_IN | 2;
1143 if (dp_data->devicetype <= DEV_SF200)
1144 dp_data->out_endpoint = 2;
1145 else
1146 dp_data->out_endpoint = 1;
1147
Ryan O'Leary301ae222019-06-24 19:14:33 -07001148 return 0;
Nico Huber274e6552024-03-24 12:34:57 +01001149
1150unknown_dev:
1151 msg_pwarn("Ignoring unknown Dediprog device. Not a SF100, SF200, SF600(Plus(G2)), or SF700!\n");
1152 libusb_release_interface(dp_data->handle, 0);
1153 libusb_close(dp_data->handle);
1154 return -3;
Ryan O'Leary301ae222019-06-24 19:14:33 -07001155}
1156
David Hendricks8bb20212011-06-14 01:35:36 +00001157static int dediprog_shutdown(void *data)
1158{
Anastasia Klimchukb31f7ac2021-07-12 14:18:37 +10001159 int ret = 0;
1160 struct dediprog_data *dp_data = data;
Carl-Daniel Hailfinger64204b52011-12-20 01:54:19 +00001161
David Hendricks8bb20212011-06-14 01:35:36 +00001162 /* URB 28. Command Set SPI Voltage to 0. */
Anastasia Klimchuk7d973882021-07-14 09:33:50 +10001163 if (dediprog_set_spi_voltage(dp_data->handle, 0x0)) {
Anastasia Klimchukb31f7ac2021-07-12 14:18:37 +10001164 ret = 1;
1165 goto out;
David Hendricks8bb20212011-06-14 01:35:36 +00001166 }
Nico Huberd99a2bd2016-02-18 21:42:49 +00001167
Anastasia Klimchuk7d973882021-07-14 09:33:50 +10001168 if (libusb_release_interface(dp_data->handle, 0)) {
Anastasia Klimchukb31f7ac2021-07-12 14:18:37 +10001169 msg_perr("Could not release USB interface!\n");
1170 ret = 1;
1171 goto out;
1172 }
Anastasia Klimchuk7d973882021-07-14 09:33:50 +10001173 libusb_close(dp_data->handle);
Anastasia Klimchukb31f7ac2021-07-12 14:18:37 +10001174 libusb_exit(dp_data->usb_ctx);
1175out:
1176 free(data);
1177 return ret;
David Hendricks8bb20212011-06-14 01:35:36 +00001178}
1179
Nico Hubere3a26882023-01-11 21:45:51 +01001180static int dediprog_init(struct flashprog_programmer *const prog)
Carl-Daniel Hailfingerd38fac82010-01-19 11:15:48 +00001181{
Ryan O'Leary301ae222019-06-24 19:14:33 -07001182 char *voltage, *id_str, *device, *spispeed, *target_str;
Patrick Georgiefe2d432013-05-23 21:47:46 +00001183 int spispeed_idx = 1;
Carl-Daniel Hailfinger082c8b52011-08-15 19:54:20 +00001184 int millivolt = 3500;
Nico Hubere8463c82024-03-24 16:50:50 +01001185 long id = -1; /* -1 defaults to enumeration order */
Ryan O'Leary301ae222019-06-24 19:14:33 -07001186 int found_id;
Nathan Laredo21541a62012-12-24 22:07:36 +00001187 long usedevice = 0;
Nico Huber5e5e8212016-05-04 12:27:58 +02001188 long target = FLASH_TYPE_APPLICATION_FLASH_1;
Nico Huber77fa67d2013-02-20 18:03:36 +00001189 int i, ret;
Carl-Daniel Hailfingerd38fac82010-01-19 11:15:48 +00001190
Nico Huber77fa67d2013-02-20 18:03:36 +00001191 spispeed = extract_programmer_param("spispeed");
1192 if (spispeed) {
1193 for (i = 0; spispeeds[i].name; ++i) {
1194 if (!strcasecmp(spispeeds[i].name, spispeed)) {
1195 spispeed_idx = i;
1196 break;
1197 }
1198 }
1199 if (!spispeeds[i].name) {
Patrick Georgiefe2d432013-05-23 21:47:46 +00001200 msg_perr("Error: Invalid spispeed value: '%s'.\n", spispeed);
Nico Huber77fa67d2013-02-20 18:03:36 +00001201 free(spispeed);
1202 return 1;
1203 }
1204 free(spispeed);
1205 }
Simon Glass557eb4f2015-07-05 16:53:22 +00001206
Carl-Daniel Hailfingerc2441382010-11-09 22:00:31 +00001207 voltage = extract_programmer_param("voltage");
1208 if (voltage) {
1209 millivolt = parse_voltage(voltage);
1210 free(voltage);
Uwe Hermann91f4afa2011-07-28 08:13:25 +00001211 if (millivolt < 0)
Carl-Daniel Hailfingerc2441382010-11-09 22:00:31 +00001212 return 1;
Carl-Daniel Hailfingerc2441382010-11-09 22:00:31 +00001213 msg_pinfo("Setting voltage to %i mV\n", millivolt);
1214 }
1215
Ryan O'Leary301ae222019-06-24 19:14:33 -07001216 id_str = extract_programmer_param("id");
1217 if (id_str) {
Nico Hubere8463c82024-03-24 16:50:50 +01001218 const char prefixes[][4] = { "SF", "DP", "S6B", };
1219 for (i = 0; i < (int)ARRAY_SIZE(prefixes); ++i) {
1220 if (!strncmp(id_str, prefixes[i], strlen(prefixes[i])))
1221 break;
1222 }
1223 if (i >= (int)ARRAY_SIZE(prefixes)) {
1224 msg_perr("Error: Could not parse dediprog `id'.\n");
1225 msg_perr("Expected a string prefixed with any of ");
1226 for (i = 0; i < (int)ARRAY_SIZE(prefixes); ++i)
1227 msg_perr("%s`%s'", i > 0 ? ", " : "", prefixes[i]);
1228 msg_perr(".\n");
1229 free(id_str);
1230 return 1;
1231 }
1232 char *endptr;
1233 id = strtol(id_str + strlen(prefixes[i]), &endptr, 10);
1234 if (strlen(id_str) <= strlen(prefixes[i]) || *endptr) {
1235 msg_perr("Error: Could not parse dediprog `id'.\n");
1236 msg_perr("Expected a number after string prefix.\n");
Ryan O'Leary301ae222019-06-24 19:14:33 -07001237 free(id_str);
1238 return 1;
1239 }
1240 if (id < 0 || id >= 0x1000000) {
Nico Hubere8463c82024-03-24 16:50:50 +01001241 msg_perr("Error: id `%s' is out of range!\n", id_str);
Ryan O'Leary301ae222019-06-24 19:14:33 -07001242 free(id_str);
1243 return 1;
1244 }
1245 msg_pinfo("Will search for dediprog id %s.\n", id_str);
1246 }
1247 free(id_str);
1248
Nathan Laredo21541a62012-12-24 22:07:36 +00001249 device = extract_programmer_param("device");
1250 if (device) {
1251 char *dev_suffix;
Ryan O'Leary301ae222019-06-24 19:14:33 -07001252 if (id != -1) {
1253 msg_perr("Error: Cannot use 'id' and 'device'.\n");
1254 }
Nathan Laredo21541a62012-12-24 22:07:36 +00001255 errno = 0;
1256 usedevice = strtol(device, &dev_suffix, 10);
1257 if (errno != 0 || device == dev_suffix) {
1258 msg_perr("Error: Could not convert 'device'.\n");
1259 free(device);
1260 return 1;
1261 }
Nico Huber961f4a12019-10-04 17:34:22 +02001262 if (usedevice < 0 || usedevice > INT_MAX) {
Nathan Laredo21541a62012-12-24 22:07:36 +00001263 msg_perr("Error: Value for 'device' is out of range.\n");
1264 free(device);
1265 return 1;
1266 }
1267 if (strlen(dev_suffix) > 0) {
1268 msg_perr("Error: Garbage following 'device' value.\n");
1269 free(device);
1270 return 1;
1271 }
1272 msg_pinfo("Using device %li.\n", usedevice);
1273 }
1274 free(device);
1275
Stefan Taunere659d2d2013-05-03 21:58:28 +00001276 target_str = extract_programmer_param("target");
1277 if (target_str) {
1278 char *target_suffix;
1279 errno = 0;
1280 target = strtol(target_str, &target_suffix, 10);
1281 if (errno != 0 || target_str == target_suffix) {
1282 msg_perr("Error: Could not convert 'target'.\n");
1283 free(target_str);
1284 return 1;
1285 }
1286 if (target < 1 || target > 2) {
1287 msg_perr("Error: Value for 'target' is out of range.\n");
1288 free(target_str);
1289 return 1;
1290 }
1291 if (strlen(target_suffix) > 0) {
1292 msg_perr("Error: Garbage following 'target' value.\n");
1293 free(target_str);
1294 return 1;
1295 }
Nico Huber5e5e8212016-05-04 12:27:58 +02001296 switch (target) {
1297 case 1:
1298 msg_pinfo("Using target %s.\n", "FLASH_TYPE_APPLICATION_FLASH_1");
1299 target = FLASH_TYPE_APPLICATION_FLASH_1;
1300 break;
1301 case 2:
1302 msg_pinfo("Using target %s.\n", "FLASH_TYPE_APPLICATION_FLASH_2");
1303 target = FLASH_TYPE_APPLICATION_FLASH_2;
1304 break;
1305 default:
1306 break;
1307 }
Stefan Taunere659d2d2013-05-03 21:58:28 +00001308 }
1309 free(target_str);
1310
Anastasia Klimchukb31f7ac2021-07-12 14:18:37 +10001311 struct dediprog_data *dp_data = calloc(1, sizeof(*dp_data));
1312 if (!dp_data) {
1313 msg_perr("Unable to allocate space for SPI master data\n");
Carl-Daniel Hailfingerd38fac82010-01-19 11:15:48 +00001314 return 1;
1315 }
Anastasia Klimchuk7d973882021-07-14 09:33:50 +10001316 dp_data->firmwareversion = FIRMWARE_VERSION(0, 0, 0);
1317 dp_data->devicetype = DEV_UNKNOWN;
Anastasia Klimchukb31f7ac2021-07-12 14:18:37 +10001318
1319 /* Here comes the USB stuff. */
Thomas Heijligen88e87c52022-08-05 17:56:20 +02001320 ret = libusb_init(&dp_data->usb_ctx);
1321 if (ret) {
Anastasia Klimchukb31f7ac2021-07-12 14:18:37 +10001322 msg_perr("Could not initialize libusb!\n");
1323 goto init_err_exit;
1324 }
Stefan Taunerfdec7472016-02-22 08:59:27 +00001325
Ryan O'Leary301ae222019-06-24 19:14:33 -07001326 if (id != -1) {
1327 for (i = 0; ; i++) {
Anastasia Klimchukb31f7ac2021-07-12 14:18:37 +10001328 ret = dediprog_open(i, dp_data);
Ryan O'Leary301ae222019-06-24 19:14:33 -07001329 if (ret == -1) {
1330 /* no dev */
Anastasia Klimchukb31f7ac2021-07-12 14:18:37 +10001331 goto init_err_exit;
Nico Huber274e6552024-03-24 12:34:57 +01001332 } else if (ret < 0) {
1333 /* busy or unknown dev */
Ryan O'Leary301ae222019-06-24 19:14:33 -07001334 continue;
1335 }
1336
1337 /* Notice we can only call dediprog_read_id() after
1338 * libusb_set_configuration() and
1339 * libusb_claim_interface(). When searching by id and
1340 * either configuration or claim fails (usually the
Nico Huberc3b02dc2023-08-12 01:13:45 +02001341 * device is in use by another instance of flashprog),
Ryan O'Leary301ae222019-06-24 19:14:33 -07001342 * the device is skipped and the next device is tried.
1343 */
Nico Huber821a0852024-03-24 13:34:51 +01001344 found_id = dediprog_read_id(dp_data);
Nico Huber38af1a12024-03-24 15:04:20 +01001345 if (found_id >= 0)
1346 msg_pinfo("Found dediprog id SF%06d.\n", found_id);
1347 if (found_id == id)
1348 break;
1349
1350 libusb_release_interface(dp_data->handle, 0);
1351 libusb_close(dp_data->handle);
Ryan O'Leary301ae222019-06-24 19:14:33 -07001352 }
1353 } else {
Anastasia Klimchukb31f7ac2021-07-12 14:18:37 +10001354 if (dediprog_open(usedevice, dp_data)) {
1355 goto init_err_exit;
Ryan O'Leary301ae222019-06-24 19:14:33 -07001356 }
Nico Huber821a0852024-03-24 13:34:51 +01001357 found_id = dediprog_read_id(dp_data);
David Woodhoused2a7e872013-07-30 09:34:44 +00001358 }
Ryan O'Leary301ae222019-06-24 19:14:33 -07001359
1360 if (found_id >= 0) {
1361 msg_pinfo("Using dediprog id SF%06d.\n", found_id);
Carl-Daniel Hailfinger482e9742010-11-16 21:25:29 +00001362 }
Nico Huber77fa67d2013-02-20 18:03:36 +00001363
Nico Huber274e6552024-03-24 12:34:57 +01001364 if (dediprog_check_devicestring(dp_data))
1365 goto init_err_cleanup_exit;
Nico Huber77fa67d2013-02-20 18:03:36 +00001366
Simon Glass25e9f402015-06-28 13:31:19 +00001367 /* Set all possible LEDs as soon as possible to indicate activity.
1368 * Because knowing the firmware version is required to set the LEDs correctly we need to this after
David Hendricksf73f8a72018-02-21 07:34:34 -08001369 * dediprog_check_devicestring() has queried the device. */
Anastasia Klimchukb31f7ac2021-07-12 14:18:37 +10001370 dediprog_set_leds(LED_ALL, dp_data);
Simon Glass25e9f402015-06-28 13:31:19 +00001371
Simon Glass557eb4f2015-07-05 16:53:22 +00001372 /* Select target/socket, frequency and VCC. */
Anastasia Klimchuk7d973882021-07-14 09:33:50 +10001373 if (set_target_flash(dp_data->handle, target) ||
Anastasia Klimchukb31f7ac2021-07-12 14:18:37 +10001374 dediprog_set_spi_speed(spispeed_idx, dp_data) ||
Anastasia Klimchuk7d973882021-07-14 09:33:50 +10001375 dediprog_set_spi_voltage(dp_data->handle, millivolt)) {
Anastasia Klimchukb31f7ac2021-07-12 14:18:37 +10001376 dediprog_set_leds(LED_ERROR, dp_data);
Anastasia Klimchuk66e04562021-06-28 17:03:52 +10001377 goto init_err_cleanup_exit;
Stefan Reinauer915b8402011-01-28 09:00:15 +00001378 }
Carl-Daniel Hailfingerd38fac82010-01-19 11:15:48 +00001379
Anastasia Klimchukb31f7ac2021-07-12 14:18:37 +10001380 if (dediprog_standalone_mode(dp_data))
Anastasia Klimchuk66e04562021-06-28 17:03:52 +10001381 goto init_err_cleanup_exit;
David Woodhouse7f3b89f2016-02-18 21:42:15 +00001382
Anastasia Klimchuk7d973882021-07-14 09:33:50 +10001383 if ((dp_data->devicetype == DEV_SF100) ||
1384 (dp_data->devicetype == DEV_SF600 && protocol(dp_data) == PROTOCOL_V3))
Nico Huber7eb38aa2019-03-21 15:42:54 +01001385 spi_master_dediprog.features &= ~SPI_MASTER_NO_4BA_MODES;
1386
Anastasia Klimchukb31f7ac2021-07-12 14:18:37 +10001387 if (protocol(dp_data) >= PROTOCOL_V2)
Nico Huber93db6e12018-09-30 01:18:43 +02001388 spi_master_dediprog.features |= SPI_MASTER_4BA;
1389
Angel Pons116d56d2021-03-22 11:28:00 +01001390 if (dediprog_set_leds(LED_NONE, dp_data))
1391 goto init_err_cleanup_exit;
Stefan Reinauer915b8402011-01-28 09:00:15 +00001392
Nico Huber89569d62023-01-12 23:31:40 +01001393 return register_spi_master(&spi_master_dediprog, 0, dp_data);
Anastasia Klimchuk66e04562021-06-28 17:03:52 +10001394
1395init_err_cleanup_exit:
Anastasia Klimchukb31f7ac2021-07-12 14:18:37 +10001396 dediprog_shutdown(dp_data);
1397 return 1;
1398
1399init_err_exit:
1400 free(dp_data);
Anastasia Klimchuk66e04562021-06-28 17:03:52 +10001401 return 1;
Carl-Daniel Hailfingerd38fac82010-01-19 11:15:48 +00001402}
Thomas Heijligencc853d82021-05-04 15:32:17 +02001403
1404const struct programmer_entry programmer_dediprog = {
1405 .name = "dediprog",
1406 .type = USB,
1407 .devs.dev = devs_dediprog,
1408 .init = dediprog_init,
Thomas Heijligencc853d82021-05-04 15:32:17 +02001409};