root/drivers/media/usb/dvb-usb/dvb-usb-firmware.c

DEFINITIONS

1. usb_cypress_writemem
2. usb_cypress_load_firmware
3. dvb_usb_download_firmware
4. dvb_usb_get_hexline

   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);