1*4882a593Smuzhiyun // SPDX-License-Identifier: GPL-2.0+
2*4882a593Smuzhiyun /*
3*4882a593Smuzhiyun * Driver for Rio Karma
4*4882a593Smuzhiyun *
5*4882a593Smuzhiyun * (c) 2006 Bob Copeland <me@bobcopeland.com>
6*4882a593Smuzhiyun * (c) 2006 Keith Bennett <keith@mcs.st-and.ac.uk>
7*4882a593Smuzhiyun */
8*4882a593Smuzhiyun
9*4882a593Smuzhiyun #include <linux/module.h>
10*4882a593Smuzhiyun #include <linux/slab.h>
11*4882a593Smuzhiyun
12*4882a593Smuzhiyun #include <scsi/scsi.h>
13*4882a593Smuzhiyun #include <scsi/scsi_cmnd.h>
14*4882a593Smuzhiyun #include <scsi/scsi_device.h>
15*4882a593Smuzhiyun
16*4882a593Smuzhiyun #include "usb.h"
17*4882a593Smuzhiyun #include "transport.h"
18*4882a593Smuzhiyun #include "debug.h"
19*4882a593Smuzhiyun #include "scsiglue.h"
20*4882a593Smuzhiyun
21*4882a593Smuzhiyun #define DRV_NAME "ums-karma"
22*4882a593Smuzhiyun
23*4882a593Smuzhiyun MODULE_DESCRIPTION("Driver for Rio Karma");
24*4882a593Smuzhiyun MODULE_AUTHOR("Bob Copeland <me@bobcopeland.com>, Keith Bennett <keith@mcs.st-and.ac.uk>");
25*4882a593Smuzhiyun MODULE_LICENSE("GPL");
26*4882a593Smuzhiyun MODULE_IMPORT_NS(USB_STORAGE);
27*4882a593Smuzhiyun
28*4882a593Smuzhiyun #define RIO_PREFIX "RIOP\x00"
29*4882a593Smuzhiyun #define RIO_PREFIX_LEN 5
30*4882a593Smuzhiyun #define RIO_SEND_LEN 40
31*4882a593Smuzhiyun #define RIO_RECV_LEN 0x200
32*4882a593Smuzhiyun
33*4882a593Smuzhiyun #define RIO_ENTER_STORAGE 0x1
34*4882a593Smuzhiyun #define RIO_LEAVE_STORAGE 0x2
35*4882a593Smuzhiyun #define RIO_RESET 0xC
36*4882a593Smuzhiyun
37*4882a593Smuzhiyun struct karma_data {
38*4882a593Smuzhiyun int in_storage;
39*4882a593Smuzhiyun char *recv;
40*4882a593Smuzhiyun };
41*4882a593Smuzhiyun
42*4882a593Smuzhiyun static int rio_karma_init(struct us_data *us);
43*4882a593Smuzhiyun
44*4882a593Smuzhiyun
45*4882a593Smuzhiyun /*
46*4882a593Smuzhiyun * The table of devices
47*4882a593Smuzhiyun */
48*4882a593Smuzhiyun #define UNUSUAL_DEV(id_vendor, id_product, bcdDeviceMin, bcdDeviceMax, \
49*4882a593Smuzhiyun vendorName, productName, useProtocol, useTransport, \
50*4882a593Smuzhiyun initFunction, flags) \
51*4882a593Smuzhiyun { USB_DEVICE_VER(id_vendor, id_product, bcdDeviceMin, bcdDeviceMax), \
52*4882a593Smuzhiyun .driver_info = (flags) }
53*4882a593Smuzhiyun
54*4882a593Smuzhiyun static struct usb_device_id karma_usb_ids[] = {
55*4882a593Smuzhiyun # include "unusual_karma.h"
56*4882a593Smuzhiyun { } /* Terminating entry */
57*4882a593Smuzhiyun };
58*4882a593Smuzhiyun MODULE_DEVICE_TABLE(usb, karma_usb_ids);
59*4882a593Smuzhiyun
60*4882a593Smuzhiyun #undef UNUSUAL_DEV
61*4882a593Smuzhiyun
62*4882a593Smuzhiyun /*
63*4882a593Smuzhiyun * The flags table
64*4882a593Smuzhiyun */
65*4882a593Smuzhiyun #define UNUSUAL_DEV(idVendor, idProduct, bcdDeviceMin, bcdDeviceMax, \
66*4882a593Smuzhiyun vendor_name, product_name, use_protocol, use_transport, \
67*4882a593Smuzhiyun init_function, Flags) \
68*4882a593Smuzhiyun { \
69*4882a593Smuzhiyun .vendorName = vendor_name, \
70*4882a593Smuzhiyun .productName = product_name, \
71*4882a593Smuzhiyun .useProtocol = use_protocol, \
72*4882a593Smuzhiyun .useTransport = use_transport, \
73*4882a593Smuzhiyun .initFunction = init_function, \
74*4882a593Smuzhiyun }
75*4882a593Smuzhiyun
76*4882a593Smuzhiyun static struct us_unusual_dev karma_unusual_dev_list[] = {
77*4882a593Smuzhiyun # include "unusual_karma.h"
78*4882a593Smuzhiyun { } /* Terminating entry */
79*4882a593Smuzhiyun };
80*4882a593Smuzhiyun
81*4882a593Smuzhiyun #undef UNUSUAL_DEV
82*4882a593Smuzhiyun
83*4882a593Smuzhiyun
84*4882a593Smuzhiyun /*
85*4882a593Smuzhiyun * Send commands to Rio Karma.
86*4882a593Smuzhiyun *
87*4882a593Smuzhiyun * For each command we send 40 bytes starting 'RIOP\0' followed by
88*4882a593Smuzhiyun * the command number and a sequence number, which the device will ack
89*4882a593Smuzhiyun * with a 512-byte packet with the high four bits set and everything
90*4882a593Smuzhiyun * else null. Then we send 'RIOP\x80' followed by a zero and the
91*4882a593Smuzhiyun * sequence number, until byte 5 in the response repeats the sequence
92*4882a593Smuzhiyun * number.
93*4882a593Smuzhiyun */
rio_karma_send_command(char cmd,struct us_data * us)94*4882a593Smuzhiyun static int rio_karma_send_command(char cmd, struct us_data *us)
95*4882a593Smuzhiyun {
96*4882a593Smuzhiyun int result;
97*4882a593Smuzhiyun unsigned long timeout;
98*4882a593Smuzhiyun static unsigned char seq = 1;
99*4882a593Smuzhiyun struct karma_data *data = (struct karma_data *) us->extra;
100*4882a593Smuzhiyun
101*4882a593Smuzhiyun usb_stor_dbg(us, "sending command %04x\n", cmd);
102*4882a593Smuzhiyun memset(us->iobuf, 0, RIO_SEND_LEN);
103*4882a593Smuzhiyun memcpy(us->iobuf, RIO_PREFIX, RIO_PREFIX_LEN);
104*4882a593Smuzhiyun us->iobuf[5] = cmd;
105*4882a593Smuzhiyun us->iobuf[6] = seq;
106*4882a593Smuzhiyun
107*4882a593Smuzhiyun timeout = jiffies + msecs_to_jiffies(6000);
108*4882a593Smuzhiyun for (;;) {
109*4882a593Smuzhiyun result = usb_stor_bulk_transfer_buf(us, us->send_bulk_pipe,
110*4882a593Smuzhiyun us->iobuf, RIO_SEND_LEN, NULL);
111*4882a593Smuzhiyun if (result != USB_STOR_XFER_GOOD)
112*4882a593Smuzhiyun goto err;
113*4882a593Smuzhiyun
114*4882a593Smuzhiyun result = usb_stor_bulk_transfer_buf(us, us->recv_bulk_pipe,
115*4882a593Smuzhiyun data->recv, RIO_RECV_LEN, NULL);
116*4882a593Smuzhiyun if (result != USB_STOR_XFER_GOOD)
117*4882a593Smuzhiyun goto err;
118*4882a593Smuzhiyun
119*4882a593Smuzhiyun if (data->recv[5] == seq)
120*4882a593Smuzhiyun break;
121*4882a593Smuzhiyun
122*4882a593Smuzhiyun if (time_after(jiffies, timeout))
123*4882a593Smuzhiyun goto err;
124*4882a593Smuzhiyun
125*4882a593Smuzhiyun us->iobuf[4] = 0x80;
126*4882a593Smuzhiyun us->iobuf[5] = 0;
127*4882a593Smuzhiyun msleep(50);
128*4882a593Smuzhiyun }
129*4882a593Smuzhiyun
130*4882a593Smuzhiyun seq++;
131*4882a593Smuzhiyun if (seq == 0)
132*4882a593Smuzhiyun seq = 1;
133*4882a593Smuzhiyun
134*4882a593Smuzhiyun usb_stor_dbg(us, "sent command %04x\n", cmd);
135*4882a593Smuzhiyun return 0;
136*4882a593Smuzhiyun err:
137*4882a593Smuzhiyun usb_stor_dbg(us, "command %04x failed\n", cmd);
138*4882a593Smuzhiyun return USB_STOR_TRANSPORT_FAILED;
139*4882a593Smuzhiyun }
140*4882a593Smuzhiyun
141*4882a593Smuzhiyun /*
142*4882a593Smuzhiyun * Trap START_STOP and READ_10 to leave/re-enter storage mode.
143*4882a593Smuzhiyun * Everything else is propagated to the normal bulk layer.
144*4882a593Smuzhiyun */
rio_karma_transport(struct scsi_cmnd * srb,struct us_data * us)145*4882a593Smuzhiyun static int rio_karma_transport(struct scsi_cmnd *srb, struct us_data *us)
146*4882a593Smuzhiyun {
147*4882a593Smuzhiyun int ret;
148*4882a593Smuzhiyun struct karma_data *data = (struct karma_data *) us->extra;
149*4882a593Smuzhiyun
150*4882a593Smuzhiyun if (srb->cmnd[0] == READ_10 && !data->in_storage) {
151*4882a593Smuzhiyun ret = rio_karma_send_command(RIO_ENTER_STORAGE, us);
152*4882a593Smuzhiyun if (ret)
153*4882a593Smuzhiyun return ret;
154*4882a593Smuzhiyun
155*4882a593Smuzhiyun data->in_storage = 1;
156*4882a593Smuzhiyun return usb_stor_Bulk_transport(srb, us);
157*4882a593Smuzhiyun } else if (srb->cmnd[0] == START_STOP) {
158*4882a593Smuzhiyun ret = rio_karma_send_command(RIO_LEAVE_STORAGE, us);
159*4882a593Smuzhiyun if (ret)
160*4882a593Smuzhiyun return ret;
161*4882a593Smuzhiyun
162*4882a593Smuzhiyun data->in_storage = 0;
163*4882a593Smuzhiyun return rio_karma_send_command(RIO_RESET, us);
164*4882a593Smuzhiyun }
165*4882a593Smuzhiyun return usb_stor_Bulk_transport(srb, us);
166*4882a593Smuzhiyun }
167*4882a593Smuzhiyun
rio_karma_destructor(void * extra)168*4882a593Smuzhiyun static void rio_karma_destructor(void *extra)
169*4882a593Smuzhiyun {
170*4882a593Smuzhiyun struct karma_data *data = (struct karma_data *) extra;
171*4882a593Smuzhiyun
172*4882a593Smuzhiyun kfree(data->recv);
173*4882a593Smuzhiyun }
174*4882a593Smuzhiyun
rio_karma_init(struct us_data * us)175*4882a593Smuzhiyun static int rio_karma_init(struct us_data *us)
176*4882a593Smuzhiyun {
177*4882a593Smuzhiyun struct karma_data *data = kzalloc(sizeof(struct karma_data), GFP_NOIO);
178*4882a593Smuzhiyun
179*4882a593Smuzhiyun if (!data)
180*4882a593Smuzhiyun return -ENOMEM;
181*4882a593Smuzhiyun
182*4882a593Smuzhiyun data->recv = kmalloc(RIO_RECV_LEN, GFP_NOIO);
183*4882a593Smuzhiyun if (!data->recv) {
184*4882a593Smuzhiyun kfree(data);
185*4882a593Smuzhiyun return -ENOMEM;
186*4882a593Smuzhiyun }
187*4882a593Smuzhiyun
188*4882a593Smuzhiyun us->extra = data;
189*4882a593Smuzhiyun us->extra_destructor = rio_karma_destructor;
190*4882a593Smuzhiyun if (rio_karma_send_command(RIO_ENTER_STORAGE, us))
191*4882a593Smuzhiyun return -EIO;
192*4882a593Smuzhiyun
193*4882a593Smuzhiyun data->in_storage = 1;
194*4882a593Smuzhiyun
195*4882a593Smuzhiyun return 0;
196*4882a593Smuzhiyun }
197*4882a593Smuzhiyun
198*4882a593Smuzhiyun static struct scsi_host_template karma_host_template;
199*4882a593Smuzhiyun
karma_probe(struct usb_interface * intf,const struct usb_device_id * id)200*4882a593Smuzhiyun static int karma_probe(struct usb_interface *intf,
201*4882a593Smuzhiyun const struct usb_device_id *id)
202*4882a593Smuzhiyun {
203*4882a593Smuzhiyun struct us_data *us;
204*4882a593Smuzhiyun int result;
205*4882a593Smuzhiyun
206*4882a593Smuzhiyun result = usb_stor_probe1(&us, intf, id,
207*4882a593Smuzhiyun (id - karma_usb_ids) + karma_unusual_dev_list,
208*4882a593Smuzhiyun &karma_host_template);
209*4882a593Smuzhiyun if (result)
210*4882a593Smuzhiyun return result;
211*4882a593Smuzhiyun
212*4882a593Smuzhiyun us->transport_name = "Rio Karma/Bulk";
213*4882a593Smuzhiyun us->transport = rio_karma_transport;
214*4882a593Smuzhiyun us->transport_reset = usb_stor_Bulk_reset;
215*4882a593Smuzhiyun
216*4882a593Smuzhiyun result = usb_stor_probe2(us);
217*4882a593Smuzhiyun return result;
218*4882a593Smuzhiyun }
219*4882a593Smuzhiyun
220*4882a593Smuzhiyun static struct usb_driver karma_driver = {
221*4882a593Smuzhiyun .name = DRV_NAME,
222*4882a593Smuzhiyun .probe = karma_probe,
223*4882a593Smuzhiyun .disconnect = usb_stor_disconnect,
224*4882a593Smuzhiyun .suspend = usb_stor_suspend,
225*4882a593Smuzhiyun .resume = usb_stor_resume,
226*4882a593Smuzhiyun .reset_resume = usb_stor_reset_resume,
227*4882a593Smuzhiyun .pre_reset = usb_stor_pre_reset,
228*4882a593Smuzhiyun .post_reset = usb_stor_post_reset,
229*4882a593Smuzhiyun .id_table = karma_usb_ids,
230*4882a593Smuzhiyun .soft_unbind = 1,
231*4882a593Smuzhiyun .no_dynamic_id = 1,
232*4882a593Smuzhiyun };
233*4882a593Smuzhiyun
234*4882a593Smuzhiyun module_usb_stor_driver(karma_driver, karma_host_template, DRV_NAME);
235