2 * Copyright (c) 2007, Benedikt Sauter <sauter@ixbat.de>
5 * Short descripton of file:
6 * I take the function names and parameters mainly from
10 * Redistribution and use in source and binary forms, with or without
11 * modification, are permitted provided that the following conditions
14 * * Redistributions of source code must retain the above copyright
15 * notice, this list of conditions and the following disclaimer.
16 * * Redistributions in binary form must reproduce the above
17 * copyright notice, this list of conditions and the following
18 * disclaimer in the documentation and/or other materials provided
19 * with the distribution.
20 * * Neither the name of the FH Augsburg nor the names of its
21 * contributors may be used to endorse or promote products derived
22 * from this software without specific prior written permission.
24 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
25 * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
26 * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
27 * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
28 * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
29 * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
30 * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
31 * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
32 * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
33 * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
34 * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
38 ppcskel - a Free Software replacement for the Nintendo/BroadOn bootloader.
41 Copyright (C) 2009 Bernhard Urban <lewurm@gmx.net>
42 Copyright (C) 2009 Sebastian Falbesoner <sebastian.falbesoner@gmail.com>
44 # This code is licensed to you under the terms of the GNU GPL, version 2;
45 # see file COPYING or http://www.gnu.org/licenses/old-licenses/gpl-2.0.txt
50 #include "../host/host.h"
51 #include "../usbspec/usb11spec.h"
52 #include "../../malloc.h"
53 #include "../../string.h"
55 #define cleargbuf() memset(gbuf, 0, 0xffff)
56 /* internal global buffer */
57 static u8 gbuf[0xffff];
59 /******************* Device Operations **********************/
61 * Open a device with verndor- and product-id for a communication.
63 struct usb_device *usb_open(u32 vendor_id, u32 product_id)
65 struct usb_device* dev;
66 struct element * iterator = core.devices->head;
67 while(iterator != NULL) {
68 dev = (struct usb_device*)iterator->data;
70 if(dev->idVendor==vendor_id&&dev->idProduct==product_id)
73 iterator=iterator->next;
81 * Open a device with an class code for a communication.
83 struct usb_device *usb_open_class(u8 class)
85 struct usb_device* dev;
86 struct element * iterator = core.devices->head;
87 while(iterator != NULL) {
88 dev = (struct usb_device*)iterator->data;
90 if(dev->bDeviceClass==class)
93 iterator=iterator->next;
98 /* Close device after a communication.
100 s8 usb_close(struct usb_device *dev)
106 s8 usb_reset(struct usb_device *dev)
114 /******************* Control Transfer **********************/
116 * Create a control transfer.
118 s8 usb_control_msg(struct usb_device *dev, u8 requesttype, u8 request,
119 u16 value, u16 index, u16 length, u8 *buf, u16 timeout)
121 struct usb_irp *irp = (struct usb_irp*)malloc(sizeof(struct usb_irp));
125 irp->epsize = dev->bMaxPacketSize0;
126 irp->type = USB_CTRL;
128 buf[0]=(u8)requesttype;
131 buf[3]=(u8)(value >> 8);
133 buf[5]=(u8)(index >> 8);
135 buf[7]=(u8)(length >> 8);
139 irp->timeout = timeout;
147 s8 usb_get_descriptor(struct usb_device *dev, u8 type, u8 index, u8 *buf, u8 size)
149 usb_control_msg(dev, 0x80, GET_DESCRIPTOR, (type << 8) | index, 0, size, buf, 0);
153 s8 usb_get_string(struct usb_device *dev, u8 index, u8 langid)
159 char *usb_get_string_simple(struct usb_device *dev, u8 index)
162 usb_get_descriptor(dev, STRING, index, gbuf, (u8) 8);
163 usb_get_descriptor(dev, STRING, index, gbuf, gbuf[0]);
165 char *str = (char*)malloc((gbuf[0]/2));
166 memset(str, '\0', (gbuf[0]/2));
169 for(i=0; i<(gbuf[0]/2)-1; i++) {
170 str[i] = gbuf[2+(i*2)];
176 /* ask first 8 bytes of device descriptor with this special
177 * GET Descriptor Request, when device address = 0
179 s8 usb_get_desc_dev_simple(struct usb_device *dev)
182 usb_get_descriptor(dev, DEVICE, 0, gbuf, 8);
185 printf("FU: %d\n", gbuf[7]);
188 dev->bMaxPacketSize0 = gbuf[7];
192 s8 usb_get_desc_dev(struct usb_device *dev)
195 if (usb_get_desc_dev_simple(dev) < 0) {
198 usb_get_descriptor(dev, DEVICE, 0, gbuf, gbuf[0]);
200 dev->bLength = gbuf[0];
201 dev->bDescriptorType = gbuf[1];
202 dev->bcdUSB = (u16) (gbuf[3] << 8 | gbuf[2]);
203 dev->bDeviceClass = gbuf[4];
204 dev->bDeviceSubClass = gbuf[5];
205 dev->bDeviceProtocoll = gbuf[6];
206 dev->idVendor = (u16) (gbuf[9] << 8) | (gbuf[8]);
207 dev->idProduct = (u16) (gbuf[11] << 8) | (gbuf[10]);
208 dev->bcdDevice = (u16) (gbuf[13] << 8) | (gbuf[12]);
209 dev->iManufacturer = gbuf[14];
210 dev->iProduct = gbuf[15];
211 dev->iSerialNumber = gbuf[16];
212 dev->bNumConfigurations = gbuf[17];
215 struct usb_conf *conf = dev->conf = (struct usb_conf*) malloc(sizeof(struct usb_conf));
216 for(i=0; i <= dev->bNumConfigurations; i++) {
218 conf = (struct usb_conf*) malloc(sizeof(struct usb_conf));
220 usb_get_desc_config_ext(dev, i, conf);
226 s8 usb_get_desc_configuration(struct usb_device *dev, u8 index, struct usb_conf *conf)
229 usb_get_descriptor(dev, CONFIGURATION, index, gbuf, 8);
230 usb_get_descriptor(dev, CONFIGURATION, index, gbuf, gbuf[0]);
232 conf->bLength = gbuf[0];
233 conf->bDescriptorType = gbuf[1];
234 conf->wTotalLength = (u16) (gbuf[3] << 8 | gbuf[2]);
235 conf->bNumInterfaces = gbuf[4];
236 conf->bConfigurationValue = gbuf[5];
237 conf->iConfiguration = gbuf[6];
238 conf->bmAttributes = gbuf[7];
239 conf->bMaxPower = gbuf[8];
245 /* returns more information about CONFIGURATION, including
246 * INTERFACE(s) and ENDPOINT(s)
247 * usb_get_desc_configuration() must be called for this device before
249 s8 usb_get_desc_config_ext(struct usb_device *dev, u8 index, struct usb_conf *conf)
253 usb_get_desc_configuration(dev, index, conf);
254 usb_get_descriptor(dev, CONFIGURATION, index, gbuf, dev->conf->wTotalLength);
257 struct usb_intf *ifs = dev->conf->intf = (struct usb_intf*) malloc(sizeof(struct usb_intf));
258 for(i=1; i <= dev->conf->bNumInterfaces; i++) {
260 ifs->next = (struct usb_intf*) malloc(sizeof(struct usb_intf));
263 ifs->bLength = gbuf[off+0];
264 ifs->bDescriptorType = gbuf[off+1];
265 ifs->bInterfaceNumber = gbuf[off+2];
266 ifs->bAlternateSetting = gbuf[off+3];
267 ifs->bNumEndpoints = gbuf[off+4];
268 ifs->bInterfaceClass = gbuf[off+5];
269 ifs->bInterfaceSubClass = gbuf[off+6];
270 ifs->bInterfaceProtocol = gbuf[off+7];
271 ifs->iInterface = gbuf[off+8];
275 struct usb_endp *ep = ifs->endp = (struct usb_endp*) malloc(sizeof(struct usb_endp));
276 for(j=1; j <= ifs->bNumEndpoints; j++) {
277 /* skip HID Device Descriptor (see lsusb) */
278 if(gbuf[off+1] == 33) {
285 ep->next = (struct usb_endp*) malloc(sizeof(struct usb_endp));
289 ep->bLength = gbuf[off+0];
290 ep->bDescriptorType = gbuf[off+1];
291 ep->bEndpointAddress = gbuf[off+2];
292 ep->bmAttributes = gbuf[off+3];
293 ep->wMaxPacketSize = (u16) ((gbuf[off+5] << 8) | (gbuf[off+4]));
294 ep->bInterval = gbuf[off+6];
302 s8 usb_set_address(struct usb_device *dev, u8 address)
305 usb_control_msg(dev, 0x00, SET_ADDRESS, address, 0, 0, gbuf, 0);
306 hexdump((void*) gbuf, 8);
312 u8 usb_get_configuration(struct usb_device *dev)
315 usb_control_msg(dev, 0x80, GET_CONFIGURATION, 0, 0, 4, gbuf, 0);
316 printf("=============\nafter usb_get_configuration:\n");
317 hexdump((void*) gbuf, 8);
321 s8 usb_set_configuration(struct usb_device *dev, u8 configuration)
324 usb_control_msg(dev, 0x00, SET_CONFIGURATION, configuration, 0, 0, gbuf, 0);
325 printf("=============\nafter usb_set_configuration:\n");
326 hexdump((void*) gbuf, 8);
331 s8 usb_set_altinterface(struct usb_device *dev, u8 alternate)
339 /******************* Bulk Transfer **********************/
341 * Write to an a bulk endpoint.
343 s8 usb_bulk_write(struct usb_device *dev, u8 ep, u8 *buf, u8 size, u8 timeout)
345 struct usb_irp * irp = (struct usb_irp*)malloc(sizeof(struct usb_irp));
347 //irp->devaddress = dev->address;
350 irp->epsize = dev->epSize[ep]; // ermitteln
351 irp->type = USB_BULK;
355 irp->timeout = timeout;
364 * Read from an bulk endpoint.
366 s8 usb_bulk_read(struct usb_device *dev, u8 ep, u8 *buf, u8 size, u8 timeout)
368 struct usb_irp * irp = (struct usb_irp*)malloc(sizeof(struct usb_irp));
369 //irp->devaddress = dev->address;
372 irp->endpoint = ep | 0x80; // from device to host
373 irp->epsize = dev->epSize[ep]; // ermitteln
374 irp->type = USB_BULK;
378 irp->timeout = timeout;
387 /******************* Interrupt Transfer **********************/
389 * Write to an interrupt endpoint.
391 s8 usb_interrupt_write(struct usb_device *dev, u8 ep, u8 *buf, u8 size, u8 timeout)
397 * Read from an interrupt endpoint.
399 s8 usb_interrupt_read(struct usb_device *dev, u8 ep, u8 *buf, u8 size, u8 timeout)
401 struct usb_irp *irp = (struct usb_irp*)malloc(sizeof(struct usb_irp));
403 irp->endpoint = ep; //wtf? |80; //from device to host
404 irp->epsize = dev->epSize[ep]; // ermitteln
405 irp->type = USB_INTR;
409 irp->timeout = timeout;
418 /******************* Isochron Transfer **********************/
421 * Write to an isochron endpoint.
423 s8 usb_isochron_write(struct usb_device *dev, u8 ep, u8 *buf, u8 size, u8 timeout)
430 * Read from an isochron endpoint.
432 s8 usb_isochron_read(struct usb_device *dev, u8 ep, u8 *buf, u8 size, u8 timeout)