1 // SPDX-License-Identifier: GPL-2.0
2 /* dvb-usb-firmware.c is part of the DVB USB library.
3  *
4  * Copyright (C) 2004-6 Patrick Boettcher (patrick.boettcher@posteo.de)
5  * see dvb-usb-init.c for copyright information.
6  *
7  * This file contains functions for downloading the firmware to Cypress FX 1 and 2 based devices.
8  *
9  * FIXME: This part does actually not belong to dvb-usb, but to the usb-subsystem.
10  */
11 #include "dvb-usb-common.h"
12 
13 #include <linux/usb.h>
14 
15 struct usb_cypress_controller {
16 	int id;
17 	const char *name;       /* name of the usb controller */
18 	u16 cpu_cs_register;    /* needs to be restarted, when the firmware has been downloaded. */
19 };
20 
21 static struct usb_cypress_controller cypress[] = {
22 	{ .id = DEVICE_SPECIFIC, .name = "Device specific", .cpu_cs_register = 0 },
23 	{ .id = CYPRESS_AN2135,  .name = "Cypress AN2135",  .cpu_cs_register = 0x7f92 },
24 	{ .id = CYPRESS_AN2235,  .name = "Cypress AN2235",  .cpu_cs_register = 0x7f92 },
25 	{ .id = CYPRESS_FX2,     .name = "Cypress FX2",     .cpu_cs_register = 0xe600 },
26 };
27 
28 /*
29  * load a firmware packet to the device
30  */
31 static int usb_cypress_writemem(struct usb_device *udev,u16 addr,u8 *data, u8 len)
32 {
33 	return usb_control_msg(udev, usb_sndctrlpipe(udev,0),
34 			0xa0, USB_TYPE_VENDOR, addr, 0x00, data, len, 5000);
35 }
36 
37 int usb_cypress_load_firmware(struct usb_device *udev, const struct firmware *fw, int type)
38 {
39 	struct hexline *hx;
40 	u8 *buf;
41 	int ret, pos = 0;
42 	u16 cpu_cs_register = cypress[type].cpu_cs_register;
43 
44 	buf = kmalloc(sizeof(*hx), GFP_KERNEL);
45 	if (!buf)
46 		return -ENOMEM;
47 	hx = (struct hexline *)buf;
48 
49 	/* stop the CPU */
50 	buf[0] = 1;
51 	if (usb_cypress_writemem(udev, cpu_cs_register, buf, 1) != 1)
52 		err("could not stop the USB controller CPU.");
53 
54 	while ((ret = dvb_usb_get_hexline(fw, hx, &pos)) > 0) {
55 		deb_fw("writing to address 0x%04x (buffer: 0x%02x %02x)\n", hx->addr, hx->len, hx->chk);
56 		ret = usb_cypress_writemem(udev, hx->addr, hx->data, hx->len);
57 
58 		if (ret != hx->len) {
59 			err("error while transferring firmware (transferred size: %d, block size: %d)",
60 				ret, hx->len);
61 			ret = -EINVAL;
62 			break;
63 		}
64 	}
65 	if (ret < 0) {
66 		err("firmware download failed at %d with %d",pos,ret);
67 		kfree(buf);
68 		return ret;
69 	}
70 
71 	if (ret == 0) {
72 		/* restart the CPU */
73 		buf[0] = 0;
74 		if (usb_cypress_writemem(udev, cpu_cs_register, buf, 1) != 1) {
75 			err("could not restart the USB controller CPU.");
76 			ret = -EINVAL;
77 		}
78 	} else
79 		ret = -EIO;
80 
81 	kfree(buf);
82 
83 	return ret;
84 }
85 EXPORT_SYMBOL(usb_cypress_load_firmware);
86 
87 int dvb_usb_download_firmware(struct usb_device *udev, struct dvb_usb_device_properties *props)
88 {
89 	int ret;
90 	const struct firmware *fw = NULL;
91 
92 	if ((ret = request_firmware(&fw, props->firmware, &udev->dev)) != 0) {
93 		err("did not find the firmware file. (%s) Please see linux/Documentation/dvb/ for more details on firmware-problems. (%d)",
94 			props->firmware,ret);
95 		return ret;
96 	}
97 
98 	info("downloading firmware from file '%s'",props->firmware);
99 
100 	switch (props->usb_ctrl) {
101 		case CYPRESS_AN2135:
102 		case CYPRESS_AN2235:
103 		case CYPRESS_FX2:
104 			ret = usb_cypress_load_firmware(udev, fw, props->usb_ctrl);
105 			break;
106 		case DEVICE_SPECIFIC:
107 			if (props->download_firmware)
108 				ret = props->download_firmware(udev,fw);
109 			else {
110 				err("BUG: driver didn't specified a download_firmware-callback, although it claims to have a DEVICE_SPECIFIC one.");
111 				ret = -EINVAL;
112 			}
113 			break;
114 		default:
115 			ret = -EINVAL;
116 			break;
117 	}
118 
119 	release_firmware(fw);
120 	return ret;
121 }
122 
123 int dvb_usb_get_hexline(const struct firmware *fw, struct hexline *hx,
124 			       int *pos)
125 {
126 	u8 *b = (u8 *) &fw->data[*pos];
127 	int data_offs = 4;
128 	if (*pos >= fw->size)
129 		return 0;
130 
131 	memset(hx,0,sizeof(struct hexline));
132 
133 	hx->len  = b[0];
134 
135 	if ((*pos + hx->len + 4) >= fw->size)
136 		return -EINVAL;
137 
138 	hx->addr = b[1] | (b[2] << 8);
139 	hx->type = b[3];
140 
141 	if (hx->type == 0x04) {
142 		/* b[4] and b[5] are the Extended linear address record data field */
143 		hx->addr |= (b[4] << 24) | (b[5] << 16);
144 /*		hx->len -= 2;
145 		data_offs += 2; */
146 	}
147 	memcpy(hx->data,&b[data_offs],hx->len);
148 	hx->chk = b[hx->len + data_offs];
149 
150 	*pos += hx->len + 5;
151 
152 	return *pos;
153 }
154 EXPORT_SYMBOL(dvb_usb_get_hexline);
155