Annotation of sys/dev/usb/ezload.c, Revision 1.1
1.1 ! nbrk 1: /* $OpenBSD: ezload.c,v 1.8 2005/04/14 19:07:02 damien Exp $ */
! 2: /* $NetBSD: ezload.c,v 1.5 2002/07/11 21:14:25 augustss Exp $ */
! 3:
! 4: /*
! 5: * Copyright (c) 2000 The NetBSD Foundation, Inc.
! 6: * All rights reserved.
! 7: *
! 8: * This code is derived from software contributed to The NetBSD Foundation
! 9: * by Lennart Augustsson <lennart@augustsson.net>.
! 10: *
! 11: * Redistribution and use in source and binary forms, with or without
! 12: * modification, are permitted provided that the following conditions
! 13: * are met:
! 14: * 1. Redistributions of source code must retain the above copyright
! 15: * notice, this list of conditions and the following disclaimer.
! 16: * 2. Redistributions in binary form must reproduce the above copyright
! 17: * notice, this list of conditions and the following disclaimer in the
! 18: * documentation and/or other materials provided with the distribution.
! 19: * 3. All advertising materials mentioning features or use of this software
! 20: * must display the following acknowledgement:
! 21: * This product includes software developed by the NetBSD
! 22: * Foundation, Inc. and its contributors.
! 23: * 4. Neither the name of The NetBSD Foundation nor the names of its
! 24: * contributors may be used to endorse or promote products derived
! 25: * from this software without specific prior written permission.
! 26: *
! 27: * THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
! 28: * ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
! 29: * TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
! 30: * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS
! 31: * BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
! 32: * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
! 33: * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
! 34: * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
! 35: * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
! 36: * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
! 37: * POSSIBILITY OF SUCH DAMAGE.
! 38: */
! 39:
! 40: #include <sys/param.h>
! 41: #include <sys/systm.h>
! 42: #include <sys/kernel.h>
! 43: #include <sys/device.h>
! 44: #include <sys/malloc.h>
! 45: #include <sys/conf.h>
! 46:
! 47: #include <dev/usb/usb.h>
! 48: #include <dev/usb/usbdi.h>
! 49: #include <dev/usb/usbdi_util.h>
! 50:
! 51: #include <dev/usb/ezload.h>
! 52:
! 53: /*
! 54: * Vendor specific request code for Anchor Upload/Download
! 55: */
! 56:
! 57: /* This one is implemented in the core */
! 58: #define ANCHOR_LOAD_INTERNAL 0xA0
! 59:
! 60: /* This is the highest internal RAM address for the AN2131Q */
! 61: #define ANCHOR_MAX_INTERNAL_ADDRESS 0x1B3F
! 62:
! 63: /*
! 64: * EZ-USB Control and Status Register. Bit 0 controls 8051 reset
! 65: */
! 66: #define ANCHOR_CPUCS_REG 0x7F92
! 67: #define ANCHOR_RESET 0x01
! 68:
! 69: /*
! 70: * Although USB does not limit you here, the Anchor docs
! 71: * quote 64 as a limit, and Mato@activewireinc.com suggested
! 72: * to use 16.
! 73: */
! 74: #define ANCHOR_CHUNK 16
! 75:
! 76: /*
! 77: * This is a firmware loader for ezusb (Anchor) devices. When the firmware
! 78: * has been downloaded the device will simulate a disconnect and when it
! 79: * is next recognized by the USB software it will appear as another
! 80: * device.
! 81: */
! 82:
! 83: #ifdef USB_DEBUG
! 84: #define DPRINTF(x) if (ezloaddebug) printf x
! 85: #define DPRINTFN(n,x) if (ezloaddebug>(n)) printf x
! 86: int ezloaddebug = 0;
! 87: #else
! 88: #define DPRINTF(x)
! 89: #define DPRINTFN(n,x)
! 90: #endif
! 91:
! 92: usbd_status
! 93: ezload_reset(usbd_device_handle dev, int reset)
! 94: {
! 95: usb_device_request_t req;
! 96: uByte rst;
! 97:
! 98: DPRINTF(("ezload_reset: reset=%d\n", reset));
! 99:
! 100: rst = reset ? ANCHOR_RESET : 0;
! 101: req.bmRequestType = UT_WRITE_VENDOR_DEVICE;
! 102: req.bRequest = ANCHOR_LOAD_INTERNAL;
! 103: USETW(req.wValue, ANCHOR_CPUCS_REG);
! 104: USETW(req.wIndex, 0);
! 105: USETW(req.wLength, 1);
! 106: return (usbd_do_request(dev, &req, &rst));
! 107: }
! 108:
! 109: usbd_status
! 110: ezload_download(usbd_device_handle dev, const char *name, const u_char *buf,
! 111: size_t buflen)
! 112: {
! 113: usb_device_request_t req;
! 114: usbd_status err = 0;
! 115: u_int8_t length;
! 116: u_int16_t address;
! 117: u_int len, offs;
! 118:
! 119: for (;;) {
! 120: length = *buf++;
! 121: if (length == 0)
! 122: break;
! 123:
! 124: address = UGETW(buf); buf += 2;
! 125: #if 0
! 126: if (address + length > ANCHOR_MAX_INTERNAL_ADDRESS)
! 127: return (USBD_INVAL);
! 128: #endif
! 129:
! 130: req.bmRequestType = UT_WRITE_VENDOR_DEVICE;
! 131: req.bRequest = ANCHOR_LOAD_INTERNAL;
! 132: USETW(req.wIndex, 0);
! 133: for (offs = 0; offs < length; offs += ANCHOR_CHUNK) {
! 134: len = length - offs;
! 135: if (len > ANCHOR_CHUNK)
! 136: len = ANCHOR_CHUNK;
! 137: USETW(req.wValue, address + offs);
! 138: USETW(req.wLength, len);
! 139: DPRINTFN(2,("ezload_download: addr=0x%x len=%d\n",
! 140: address + offs, len));
! 141: err = usbd_do_request(dev, &req, (u_char *)buf);
! 142: if (err)
! 143: break;
! 144:
! 145: buf += len;
! 146: }
! 147: if (err)
! 148: break;
! 149: }
! 150:
! 151: return (err);
! 152: }
! 153:
! 154: usbd_status
! 155: ezload_downloads_and_reset(usbd_device_handle dev, char **names)
! 156: {
! 157: usbd_status err;
! 158: size_t buflen;
! 159: u_char *buf;
! 160: int error;
! 161:
! 162: /*(void)ezload_reset(dev, 1);*/
! 163: err = ezload_reset(dev, 1);
! 164: if (err)
! 165: return (err);
! 166: usbd_delay_ms(dev, 250);
! 167:
! 168: while (*names != NULL) {
! 169: error = loadfirmware(*names, &buf, &buflen);
! 170: if (error)
! 171: return (error);
! 172:
! 173: err = ezload_download(dev, *names, buf, buflen);
! 174: free(buf, M_DEVBUF);
! 175: if (err)
! 176: return (err);
! 177: names++;
! 178: }
! 179: if (err)
! 180: return (err);
! 181: usbd_delay_ms(dev, 250);
! 182: /*(void)ezload_reset(dev, 0);*/
! 183: err = ezload_reset(dev, 0);
! 184: usbd_delay_ms(dev, 250);
! 185: return (err);
! 186: }
CVSweb