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 #include <linux/kernel.h>
11 #include <linux/errno.h>
12 #include <linux/slab.h>
13 #include <linux/init.h>
14 #include <linux/module.h>
15 #include <linux/usb.h>
16 #include <linux/delay.h>
17 #include <linux/firmware.h>
18 #include <linux/ihex.h>
20 /* include firmware (variables)*/
22 #define SPDIF /* if you want SPDIF comment next line */
23 //#undef SPDIF /* if you want MIDI uncomment this line */
26 #define FIRMWARE_FW "emi62/spdif.fw"
28 #define FIRMWARE_FW "emi62/midi.fw"
31 #define EMI62_VENDOR_ID 0x086a /* Emagic Soft-und Hardware GmBH */
32 #define EMI62_PRODUCT_ID 0x0110 /* EMI 6|2m without firmware */
34 #define ANCHOR_LOAD_INTERNAL 0xA0 /* Vendor specific request code for Anchor Upload/Download (This one is implemented in the core) */
35 #define ANCHOR_LOAD_EXTERNAL 0xA3 /* This command is not implemented in the core. Requires firmware */
36 #define ANCHOR_LOAD_FPGA 0xA5 /* This command is not implemented in the core. Requires firmware. Emagic extension */
37 #define MAX_INTERNAL_ADDRESS 0x1B3F /* This is the highest internal RAM address for the AN2131Q */
38 #define CPUCS_REG 0x7F92 /* EZ-USB Control and Status Register. Bit 0 controls 8051 reset */
39 #define INTERNAL_RAM(address) (address <= MAX_INTERNAL_ADDRESS)
41 static int emi62_writememory(struct usb_device
*dev
, int address
,
42 const unsigned char *data
, int length
,
44 static int emi62_set_reset(struct usb_device
*dev
, unsigned char reset_bit
);
45 static int emi62_load_firmware (struct usb_device
*dev
);
46 static int emi62_probe(struct usb_interface
*intf
, const struct usb_device_id
*id
);
47 static void emi62_disconnect(struct usb_interface
*intf
);
48 static int __init
emi62_init (void);
49 static void __exit
emi62_exit (void);
52 /* thanks to drivers/usb/serial/keyspan_pda.c code */
53 static int emi62_writememory(struct usb_device
*dev
, int address
,
54 const unsigned char *data
, int length
,
58 unsigned char *buffer
= kmemdup(data
, length
, GFP_KERNEL
);
61 err("emi62: kmalloc(%d) failed.", length
);
64 /* Note: usb_control_msg returns negative value on error or length of the
65 * data that was written! */
66 result
= usb_control_msg (dev
, usb_sndctrlpipe(dev
, 0), request
, 0x40, address
, 0, buffer
, length
, 300);
71 /* thanks to drivers/usb/serial/keyspan_pda.c code */
72 static int emi62_set_reset (struct usb_device
*dev
, unsigned char reset_bit
)
75 dev_info(&dev
->dev
, "%s - %d\n", __func__
, reset_bit
);
77 response
= emi62_writememory (dev
, CPUCS_REG
, &reset_bit
, 1, 0xa0);
79 err("emi62: set_reset (%d) failed", reset_bit
);
84 #define FW_LOAD_SIZE 1023
86 static int emi62_load_firmware (struct usb_device
*dev
)
88 const struct firmware
*loader_fw
= NULL
;
89 const struct firmware
*bitstream_fw
= NULL
;
90 const struct firmware
*firmware_fw
= NULL
;
91 const struct ihex_binrec
*rec
;
94 __u32 addr
; /* Address to write */
97 dev_dbg(&dev
->dev
, "load_firmware\n");
98 buf
= kmalloc(FW_LOAD_SIZE
, GFP_KERNEL
);
100 err( "%s - error loading firmware: error = %d", __func__
, -ENOMEM
);
105 err
= request_ihex_firmware(&loader_fw
, "emi62/loader.fw", &dev
->dev
);
109 err
= request_ihex_firmware(&bitstream_fw
, "emi62/bitstream.fw",
114 err
= request_ihex_firmware(&firmware_fw
, FIRMWARE_FW
, &dev
->dev
);
117 err( "%s - request_firmware() failed", __func__
);
121 /* Assert reset (stop the CPU in the EMI) */
122 err
= emi62_set_reset(dev
,1);
124 err("%s - error loading firmware: error = %d", __func__
, err
);
128 rec
= (const struct ihex_binrec
*)loader_fw
->data
;
130 /* 1. We need to put the loader for the FPGA into the EZ-USB */
132 err
= emi62_writememory(dev
, be32_to_cpu(rec
->addr
),
133 rec
->data
, be16_to_cpu(rec
->len
),
134 ANCHOR_LOAD_INTERNAL
);
136 err("%s - error loading firmware: error = %d", __func__
, err
);
139 rec
= ihex_next_binrec(rec
);
142 /* De-assert reset (let the CPU run) */
143 err
= emi62_set_reset(dev
,0);
145 err("%s - error loading firmware: error = %d", __func__
, err
);
148 msleep(250); /* let device settle */
150 /* 2. We upload the FPGA firmware into the EMI
151 * Note: collect up to 1023 (yes!) bytes and send them with
152 * a single request. This is _much_ faster! */
153 rec
= (const struct ihex_binrec
*)bitstream_fw
->data
;
156 addr
= be32_to_cpu(rec
->addr
);
158 /* intel hex records are terminated with type 0 element */
159 while (rec
&& (i
+ be16_to_cpu(rec
->len
) < FW_LOAD_SIZE
)) {
160 memcpy(buf
+ i
, rec
->data
, be16_to_cpu(rec
->len
));
161 i
+= be16_to_cpu(rec
->len
);
162 rec
= ihex_next_binrec(rec
);
164 err
= emi62_writememory(dev
, addr
, buf
, i
, ANCHOR_LOAD_FPGA
);
166 err("%s - error loading firmware: error = %d", __func__
, err
);
171 /* Assert reset (stop the CPU in the EMI) */
172 err
= emi62_set_reset(dev
,1);
174 err("%s - error loading firmware: error = %d", __func__
, err
);
178 /* 3. We need to put the loader for the firmware into the EZ-USB (again...) */
179 for (rec
= (const struct ihex_binrec
*)loader_fw
->data
;
180 rec
; rec
= ihex_next_binrec(rec
)) {
181 err
= emi62_writememory(dev
, be32_to_cpu(rec
->addr
),
182 rec
->data
, be16_to_cpu(rec
->len
),
183 ANCHOR_LOAD_INTERNAL
);
185 err("%s - error loading firmware: error = %d", __func__
, err
);
190 /* De-assert reset (let the CPU run) */
191 err
= emi62_set_reset(dev
,0);
193 err("%s - error loading firmware: error = %d", __func__
, err
);
196 msleep(250); /* let device settle */
198 /* 4. We put the part of the firmware that lies in the external RAM into the EZ-USB */
200 for (rec
= (const struct ihex_binrec
*)firmware_fw
->data
;
201 rec
; rec
= ihex_next_binrec(rec
)) {
202 if (!INTERNAL_RAM(be32_to_cpu(rec
->addr
))) {
203 err
= emi62_writememory(dev
, be32_to_cpu(rec
->addr
),
204 rec
->data
, be16_to_cpu(rec
->len
),
205 ANCHOR_LOAD_EXTERNAL
);
207 err("%s - error loading firmware: error = %d", __func__
, err
);
213 /* Assert reset (stop the CPU in the EMI) */
214 err
= emi62_set_reset(dev
,1);
216 err("%s - error loading firmware: error = %d", __func__
, err
);
220 for (rec
= (const struct ihex_binrec
*)firmware_fw
->data
;
221 rec
; rec
= ihex_next_binrec(rec
)) {
222 if (INTERNAL_RAM(be32_to_cpu(rec
->addr
))) {
223 err
= emi62_writememory(dev
, be32_to_cpu(rec
->addr
),
224 rec
->data
, be16_to_cpu(rec
->len
),
225 ANCHOR_LOAD_EXTERNAL
);
227 err("%s - error loading firmware: error = %d", __func__
, err
);
233 /* De-assert reset (let the CPU run) */
234 err
= emi62_set_reset(dev
,0);
236 err("%s - error loading firmware: error = %d", __func__
, err
);
239 msleep(250); /* let device settle */
241 release_firmware(loader_fw
);
242 release_firmware(bitstream_fw
);
243 release_firmware(firmware_fw
);
247 /* return 1 to fail the driver inialization
248 * and give real driver change to load */
252 release_firmware(loader_fw
);
253 release_firmware(bitstream_fw
);
254 release_firmware(firmware_fw
);
257 dev_err(&dev
->dev
, "Error\n");
261 static const struct usb_device_id id_table
[] __devinitconst
= {
262 { USB_DEVICE(EMI62_VENDOR_ID
, EMI62_PRODUCT_ID
) },
263 { } /* Terminating entry */
266 MODULE_DEVICE_TABLE (usb
, id_table
);
268 static int emi62_probe(struct usb_interface
*intf
, const struct usb_device_id
*id
)
270 struct usb_device
*dev
= interface_to_usbdev(intf
);
271 dev_dbg(&intf
->dev
, "emi62_probe\n");
273 dev_info(&intf
->dev
, "%s start\n", __func__
);
275 emi62_load_firmware(dev
);
277 /* do not return the driver context, let real audio driver do that */
281 static void emi62_disconnect(struct usb_interface
*intf
)
285 static struct usb_driver emi62_driver
= {
286 .name
= "emi62 - firmware loader",
287 .probe
= emi62_probe
,
288 .disconnect
= emi62_disconnect
,
289 .id_table
= id_table
,
292 static int __init
emi62_init (void)
295 retval
= usb_register (&emi62_driver
);
297 printk(KERN_ERR
"adi-emi: registration failed\n");
301 static void __exit
emi62_exit (void)
303 usb_deregister (&emi62_driver
);
306 module_init(emi62_init
);
307 module_exit(emi62_exit
);
309 MODULE_AUTHOR("Tapio Laxström");
310 MODULE_DESCRIPTION("Emagic EMI 6|2m firmware loader.");
311 MODULE_LICENSE("GPL");
313 MODULE_FIRMWARE("emi62/loader.fw");
314 MODULE_FIRMWARE("emi62/bitstream.fw");
315 MODULE_FIRMWARE(FIRMWARE_FW
);
316 /* vi:ai:syntax=c:sw=8:ts=8:tw=80