projects / linux-block.git / blame
| Commit | Line | Data |
|---|---|---|
| e90b8e91 | 1 | /* SPDX-License-Identifier: GPL-2.0 */ |
| a5c66e4b TO |
2 | /* |
| 3 | * Common Header File for the Elan Digital Systems U132 adapter | |
| 4 | * this file should be included by both the "ftdi-u132" and | |
| 5 | * the "u132-hcd" modules. | |
| 6 | * | |
| 7 | * Copyright(C) 2006 Elan Digital Systems Limited | |
| 8 | *(http://www.elandigitalsystems.com) | |
| 9 | * | |
| 10 | * Author and Maintainer - Tony Olech - Elan Digital Systems | |
| 11 | *(tony.olech@elandigitalsystems.com) | |
| 12 | * | |
| a5c66e4b TO |
13 | * The driver was written by Tony Olech(tony.olech@elandigitalsystems.com) |
| 14 | * based on various USB client drivers in the 2.6.15 linux kernel | |
| 15 | * with constant reference to the 3rd Edition of Linux Device Drivers | |
| 16 | * published by O'Reilly | |
| 17 | * | |
| 18 | * The U132 adapter is a USB to CardBus adapter specifically designed | |
| 19 | * for PC cards that contain an OHCI host controller. Typical PC cards | |
| 20 | * are the Orange Mobile 3G Option GlobeTrotter Fusion card. | |
| 21 | * | |
| 22 | * The U132 adapter will *NOT *work with PC cards that do not contain | |
| 23 | * an OHCI controller. A simple way to test whether a PC card has an | |
| 24 | * OHCI controller as an interface is to insert the PC card directly | |
| 25 | * into a laptop(or desktop) with a CardBus slot and if "lspci" shows | |
| 26 | * a new USB controller and "lsusb -v" shows a new OHCI Host Controller | |
| 27 | * then there is a good chance that the U132 adapter will support the | |
| 28 | * PC card.(you also need the specific client driver for the PC card) | |
| 29 | * | |
| 30 | * Please inform the Author and Maintainer about any PC cards that | |
| 31 | * contain OHCI Host Controller and work when directly connected to | |
| 32 | * an embedded CardBus slot but do not work when they are connected | |
| 33 | * via an ELAN U132 adapter. | |
| 34 | * | |
| 35 | * The driver consists of two modules, the "ftdi-u132" module is | |
| 36 | * a USB client driver that interfaces to the FTDI chip within | |
| 37 | * the U132 adapter manufactured by Elan Digital Systems, and the | |
| 38 | * "u132-hcd" module is a USB host controller driver that talks | |
| 39 | * to the OHCI controller within CardBus card that are inserted | |
| 40 | * in the U132 adapter. | |
| 41 | * | |
| 42 | * The "ftdi-u132" module should be loaded automatically by the | |
| 43 | * hot plug system when the U132 adapter is plugged in. The module | |
| 44 | * initialises the adapter which mostly consists of synchronising | |
| 45 | * the FTDI chip, before continuously polling the adapter to detect | |
| 46 | * PC card insertions. As soon as a PC card containing a recognised | |
| 47 | * OHCI controller is seen the "ftdi-u132" module explicitly requests | |
| 48 | * the kernel to load the "u132-hcd" module. | |
| 49 | * | |
| 50 | * The "ftdi-u132" module provides the interface to the inserted | |
| 0779bf2d | 51 | * PC card and the "u132-hcd" module uses the API to send and receive |
| a5c66e4b TO |
52 | * data. The API features call-backs, so that part of the "u132-hcd" |
| 53 | * module code will run in the context of one of the kernel threads | |
| 54 | * of the "ftdi-u132" module. | |
| 55 | * | |
| 56 | */ | |
| 57 | int ftdi_elan_switch_on_diagnostics(int number); | |
| 58 | void ftdi_elan_gone_away(struct platform_device *pdev); | |
| 59 | void start_usb_lock_device_tracing(void); | |
| 60 | struct u132_platform_data { | |
| 61 | u16 vendor; | |
| 62 | u16 device; | |
| 63 | u8 potpg; | |
| 64 | void (*port_power) (struct device *dev, int is_on); | |
| 65 | void (*reset) (struct device *dev); | |
| 66 | }; | |
| 67 | int usb_ftdi_elan_edset_single(struct platform_device *pdev, u8 ed_number, | |
| 68 | void *endp, struct urb *urb, u8 address, u8 ep_number, u8 toggle_bits, | |
| 69 | void (*callback) (void *endp, struct urb *urb, u8 *buf, int len, | |
| 70 | int toggle_bits, int error_count, int condition_code, int repeat_number, | |
| 71 | int halted, int skipped, int actual, int non_null)); | |
| 72 | int usb_ftdi_elan_edset_output(struct platform_device *pdev, u8 ed_number, | |
| 73 | void *endp, struct urb *urb, u8 address, u8 ep_number, u8 toggle_bits, | |
| 74 | void (*callback) (void *endp, struct urb *urb, u8 *buf, int len, | |
| 75 | int toggle_bits, int error_count, int condition_code, int repeat_number, | |
| 76 | int halted, int skipped, int actual, int non_null)); | |
| 77 | int usb_ftdi_elan_edset_empty(struct platform_device *pdev, u8 ed_number, | |
| 78 | void *endp, struct urb *urb, u8 address, u8 ep_number, u8 toggle_bits, | |
| 79 | void (*callback) (void *endp, struct urb *urb, u8 *buf, int len, | |
| 80 | int toggle_bits, int error_count, int condition_code, int repeat_number, | |
| 81 | int halted, int skipped, int actual, int non_null)); | |
| 82 | int usb_ftdi_elan_edset_input(struct platform_device *pdev, u8 ed_number, | |
| 83 | void *endp, struct urb *urb, u8 address, u8 ep_number, u8 toggle_bits, | |
| 84 | void (*callback) (void *endp, struct urb *urb, u8 *buf, int len, | |
| 85 | int toggle_bits, int error_count, int condition_code, int repeat_number, | |
| 86 | int halted, int skipped, int actual, int non_null)); | |
| 87 | int usb_ftdi_elan_edset_setup(struct platform_device *pdev, u8 ed_number, | |
| 88 | void *endp, struct urb *urb, u8 address, u8 ep_number, u8 toggle_bits, | |
| 89 | void (*callback) (void *endp, struct urb *urb, u8 *buf, int len, | |
| 90 | int toggle_bits, int error_count, int condition_code, int repeat_number, | |
| 91 | int halted, int skipped, int actual, int non_null)); | |
| 92 | int usb_ftdi_elan_edset_flush(struct platform_device *pdev, u8 ed_number, | |
| 93 | void *endp); | |
| 9ce8540c AB |
94 | int usb_ftdi_elan_read_pcimem(struct platform_device *pdev, int mem_offset, |
| 95 | u8 width, u32 *data); | |
| 96 | int usb_ftdi_elan_write_pcimem(struct platform_device *pdev, int mem_offset, | |
| 97 | u8 width, u32 data); |