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' (status %d). You can use <kernel_dir>/scripts/get_dvb_firmware to get the firmware", 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