2 * Emagic EMI 2|6 usb audio interface firmware loader.
4 * Tapio Laxström (tapio.laxstrom@iptime.fi)
6 * This program is free software; you can redistribute it and/or modify
7 * it under the terms of the GNU General Public License, as published by
8 * the Free Software Foundation, version 2.
10 * emi26.c,v 1.13 2002/03/08 13:10:26 tapio Exp
12 #include <linux/kernel.h>
13 #include <linux/errno.h>
14 #include <linux/slab.h>
15 #include <linux/module.h>
16 #include <linux/init.h>
17 #include <linux/usb.h>
18 #include <linux/delay.h>
19 #include <linux/firmware.h>
20 #include <linux/ihex.h>
22 #define EMI26_VENDOR_ID 0x086a /* Emagic Soft-und Hardware GmBH */
23 #define EMI26_PRODUCT_ID 0x0100 /* EMI 2|6 without firmware */
24 #define EMI26B_PRODUCT_ID 0x0102 /* EMI 2|6 without firmware */
26 #define ANCHOR_LOAD_INTERNAL 0xA0 /* Vendor specific request code for Anchor Upload/Download (This one is implemented in the core) */
27 #define ANCHOR_LOAD_EXTERNAL 0xA3 /* This command is not implemented in the core. Requires firmware */
28 #define ANCHOR_LOAD_FPGA 0xA5 /* This command is not implemented in the core. Requires firmware. Emagic extension */
29 #define MAX_INTERNAL_ADDRESS 0x1B3F /* This is the highest internal RAM address for the AN2131Q */
30 #define CPUCS_REG 0x7F92 /* EZ-USB Control and Status Register. Bit 0 controls 8051 reset */
31 #define INTERNAL_RAM(address) (address <= MAX_INTERNAL_ADDRESS)
33 static int emi26_writememory( struct usb_device
*dev
, int address
,
34 const unsigned char *data
, int length
,
36 static int emi26_set_reset(struct usb_device
*dev
, unsigned char reset_bit
);
37 static int emi26_load_firmware (struct usb_device
*dev
);
38 static int emi26_probe(struct usb_interface
*intf
, const struct usb_device_id
*id
);
39 static void emi26_disconnect(struct usb_interface
*intf
);
41 /* thanks to drivers/usb/serial/keyspan_pda.c code */
42 static int emi26_writememory (struct usb_device
*dev
, int address
,
43 const unsigned char *data
, int length
,
47 unsigned char *buffer
= kmemdup(data
, length
, GFP_KERNEL
);
50 dev_err(&dev
->dev
, "kmalloc(%d) failed.\n", length
);
53 /* Note: usb_control_msg returns negative value on error or length of the
54 * data that was written! */
55 result
= usb_control_msg (dev
, usb_sndctrlpipe(dev
, 0), request
, 0x40, address
, 0, buffer
, length
, 300);
60 /* thanks to drivers/usb/serial/keyspan_pda.c code */
61 static int emi26_set_reset (struct usb_device
*dev
, unsigned char reset_bit
)
64 dev_info(&dev
->dev
, "%s - %d\n", __func__
, reset_bit
);
65 /* printk(KERN_DEBUG "%s - %d", __func__, reset_bit); */
66 response
= emi26_writememory (dev
, CPUCS_REG
, &reset_bit
, 1, 0xa0);
68 dev_err(&dev
->dev
, "set_reset (%d) failed\n", reset_bit
);
73 #define FW_LOAD_SIZE 1023
75 static int emi26_load_firmware (struct usb_device
*dev
)
77 const struct firmware
*loader_fw
= NULL
;
78 const struct firmware
*bitstream_fw
= NULL
;
79 const struct firmware
*firmware_fw
= NULL
;
80 const struct ihex_binrec
*rec
;
83 __u32 addr
; /* Address to write */
86 buf
= kmalloc(FW_LOAD_SIZE
, GFP_KERNEL
);
90 err
= request_ihex_firmware(&loader_fw
, "emi26/loader.fw", &dev
->dev
);
94 err
= request_ihex_firmware(&bitstream_fw
, "emi26/bitstream.fw",
99 err
= request_ihex_firmware(&firmware_fw
, "emi26/firmware.fw",
103 dev_err(&dev
->dev
, "%s - request_firmware() failed\n",
108 /* Assert reset (stop the CPU in the EMI) */
109 err
= emi26_set_reset(dev
,1);
113 rec
= (const struct ihex_binrec
*)loader_fw
->data
;
114 /* 1. We need to put the loader for the FPGA into the EZ-USB */
116 err
= emi26_writememory(dev
, be32_to_cpu(rec
->addr
),
117 rec
->data
, be16_to_cpu(rec
->len
),
118 ANCHOR_LOAD_INTERNAL
);
121 rec
= ihex_next_binrec(rec
);
124 /* De-assert reset (let the CPU run) */
125 err
= emi26_set_reset(dev
,0);
128 msleep(250); /* let device settle */
130 /* 2. We upload the FPGA firmware into the EMI
131 * Note: collect up to 1023 (yes!) bytes and send them with
132 * a single request. This is _much_ faster! */
133 rec
= (const struct ihex_binrec
*)bitstream_fw
->data
;
136 addr
= be32_to_cpu(rec
->addr
);
138 /* intel hex records are terminated with type 0 element */
139 while (rec
&& (i
+ be16_to_cpu(rec
->len
) < FW_LOAD_SIZE
)) {
140 memcpy(buf
+ i
, rec
->data
, be16_to_cpu(rec
->len
));
141 i
+= be16_to_cpu(rec
->len
);
142 rec
= ihex_next_binrec(rec
);
144 err
= emi26_writememory(dev
, addr
, buf
, i
, ANCHOR_LOAD_FPGA
);
149 /* Assert reset (stop the CPU in the EMI) */
150 err
= emi26_set_reset(dev
,1);
154 /* 3. We need to put the loader for the firmware into the EZ-USB (again...) */
155 for (rec
= (const struct ihex_binrec
*)loader_fw
->data
;
156 rec
; rec
= ihex_next_binrec(rec
)) {
157 err
= emi26_writememory(dev
, be32_to_cpu(rec
->addr
),
158 rec
->data
, be16_to_cpu(rec
->len
),
159 ANCHOR_LOAD_INTERNAL
);
163 msleep(250); /* let device settle */
165 /* De-assert reset (let the CPU run) */
166 err
= emi26_set_reset(dev
,0);
170 /* 4. We put the part of the firmware that lies in the external RAM into the EZ-USB */
172 for (rec
= (const struct ihex_binrec
*)firmware_fw
->data
;
173 rec
; rec
= ihex_next_binrec(rec
)) {
174 if (!INTERNAL_RAM(be32_to_cpu(rec
->addr
))) {
175 err
= emi26_writememory(dev
, be32_to_cpu(rec
->addr
),
176 rec
->data
, be16_to_cpu(rec
->len
),
177 ANCHOR_LOAD_EXTERNAL
);
183 /* Assert reset (stop the CPU in the EMI) */
184 err
= emi26_set_reset(dev
,1);
188 for (rec
= (const struct ihex_binrec
*)firmware_fw
->data
;
189 rec
; rec
= ihex_next_binrec(rec
)) {
190 if (INTERNAL_RAM(be32_to_cpu(rec
->addr
))) {
191 err
= emi26_writememory(dev
, be32_to_cpu(rec
->addr
),
192 rec
->data
, be16_to_cpu(rec
->len
),
193 ANCHOR_LOAD_INTERNAL
);
199 /* De-assert reset (let the CPU run) */
200 err
= emi26_set_reset(dev
,0);
203 msleep(250); /* let device settle */
205 /* return 1 to fail the driver inialization
206 * and give real driver change to load */
211 dev_err(&dev
->dev
,"%s - error loading firmware: error = %d\n",
214 release_firmware(loader_fw
);
215 release_firmware(bitstream_fw
);
216 release_firmware(firmware_fw
);
222 static const struct usb_device_id id_table
[] = {
223 { USB_DEVICE(EMI26_VENDOR_ID
, EMI26_PRODUCT_ID
) },
224 { USB_DEVICE(EMI26_VENDOR_ID
, EMI26B_PRODUCT_ID
) },
225 { } /* Terminating entry */
228 MODULE_DEVICE_TABLE (usb
, id_table
);
230 static int emi26_probe(struct usb_interface
*intf
, const struct usb_device_id
*id
)
232 struct usb_device
*dev
= interface_to_usbdev(intf
);
234 dev_info(&intf
->dev
, "%s start\n", __func__
);
236 emi26_load_firmware(dev
);
238 /* do not return the driver context, let real audio driver do that */
242 static void emi26_disconnect(struct usb_interface
*intf
)
246 static struct usb_driver emi26_driver
= {
247 .name
= "emi26 - firmware loader",
248 .probe
= emi26_probe
,
249 .disconnect
= emi26_disconnect
,
250 .id_table
= id_table
,
253 module_usb_driver(emi26_driver
);
255 MODULE_AUTHOR("Tapio Laxström");
256 MODULE_DESCRIPTION("Emagic EMI 2|6 firmware loader.");
257 MODULE_LICENSE("GPL");
259 MODULE_FIRMWARE("emi26/loader.fw");
260 MODULE_FIRMWARE("emi26/bitstream.fw");
261 MODULE_FIRMWARE("emi26/firmware.fw");
262 /* vi:ai:syntax=c:sw=8:ts=8:tw=80