# ==================================================================== # # usbs_at91.cdl # # USB device driver for the ATMEL AT91 family of processors. # # ==================================================================== ## ####ECOSGPLCOPYRIGHTBEGIN#### ## ------------------------------------------- ## This file is part of eCos, the Embedded Configurable Operating System. ## Copyright (C) 2006, 2010 Free Software Foundation, Inc. ## ## eCos is free software; you can redistribute it and/or modify it under ## the terms of the GNU General Public License as published by the Free ## Software Foundation; either version 2 or (at your option) any later ## version. ## ## eCos is distributed in the hope that it will be useful, but WITHOUT ## ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or ## FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License ## for more details. ## ## You should have received a copy of the GNU General Public License ## along with eCos; if not, write to the Free Software Foundation, Inc., ## 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA. ## ## As a special exception, if other files instantiate templates or use ## macros or inline functions from this file, or you compile this file ## and link it with other works to produce a work based on this file, ## this file does not by itself cause the resulting work to be covered by ## the GNU General Public License. However the source code for this file ## must still be made available in accordance with section (3) of the GNU ## General Public License v2. ## ## This exception does not invalidate any other reasons why a work based ## on this file might be covered by the GNU General Public License. ## ------------------------------------------- ## ####ECOSGPLCOPYRIGHTEND#### # ==================================================================== ######DESCRIPTIONBEGIN#### # # Author(s): Oliver Munz, Andrew Lunn # Original data: bartv # Contributors: ccoutand # Date: 2006-02-25 # #####DESCRIPTIONEND#### # ==================================================================== cdl_package CYGPKG_DEVS_USB_AT91 { display "Atmel AT91 USB Device Driver" include_dir "cyg/io/usb" parent CYGPKG_IO_USB implements CYGHWR_IO_USB_SLAVE cdl_interface CYGINT_DEVS_USB_AT91_HAS_USB { description " This interface is implemented by HALs for devices which have the USB hardware." } description " This package provides a suitable eCos device driver for AT91 USB. In this version the driver will support the AT91SAM7S. Other AT92 devices may work, but have not been tested. The Driver needs 48, 96 or 192MHz plus minus 0.25%. Buffers are allocated only in the higher level. There is no need to configure the endpoints in this CDL, because they will be configured dynamical at the set_configuration call from the host... The endpoints 1..3 can be configured as bulk or interrupt IN or OUT endpoint. Isochronous transfer is not supported." cdl_component CYGFUN_DEVS_USB_AT91_EP0 { display "Support the control endpoint 0" flavor bool default_value CYGINT_IO_USB_SLAVE_CLIENTS requires CYGPKG_IO_USB CYGPKG_IO_USB_SLAVE requires { ((CYGNUM_HAL_ARM_AT91_CLOCK_SPEED < 48120000 && CYGNUM_HAL_ARM_AT91_CLOCK_SPEED > 47880000) || (CYGNUM_HAL_ARM_AT91_CLOCK_SPEED < 96240000 && CYGNUM_HAL_ARM_AT91_CLOCK_SPEED > 95760000)) } active_if CYGINT_DEVS_USB_AT91_HAS_USB implements CYGHWR_IO_USB_SLAVE_OUT_ENDPOINTS implements CYGHWR_IO_USB_SLAVE_IN_ENDPOINTS compile usbs_at91.c compile -library=libextras.a usbs_at91_data.cxx description " Enable support for endpoint 0. If this support is disabled then the entire USB port is unusable." cdl_option CYGDAT_DEVS_USB_AT91_GPIO_SET_PULLUP_INTERNAL { display "The chip has internal pullup" flavor bool calculated { CYGHWR_HAL_ARM_AT91SAM7SE } requires { CYGDAT_DEVS_USB_AT91_GPIO_SET_PULLUP_PIN == "NONE" } description " The chip has an internal pullup resistor; the use of this pullup is mandatory (?), so there should be no external pullup resistor." } cdl_option CYGDAT_DEVS_USB_AT91_GPIO_SET_PULLUP_PIN { display "PIO-Pin who controls the pullup resistor" flavor data default_value { "AT91_GPIO_PA16" } description " Every GPIO pin is able to do it. If you don't need a pin because your HW has the pullup fixed wired then select NONE" } cdl_option CYGNUM_DEVS_USB_AT91_GPIO_SET_PULLUP_INVERTED { display "Has the signal to be inverted?" active_if {CYGDAT_DEVS_USB_AT91_GPIO_SET_PULLUP_PIN != "NONE"} flavor bool default_value 1 description " This option indicates that the pullup pin should be inverted. ie VDD is active, VCC is inactive. For the AT91SAM7SEK it needs to be inverted, hence this default." } cdl_option CYGDAT_DEVS_USB_AT91_GPIO_READ_POWER_PIN { display "PIO-Pin who see the USB-Power" flavor data default_value { "AT91_GPIO_PA13"} description " Every GPIO pin is able to do it. If you don't need a pin then select NONE" } cdl_option CYGNUM_DEVS_USB_AT91_GPIO_READ_POWER_INVERTED { display "Has the signal to be inverted?" flavor bool default_value 0 description " This option indicates that the power detect pin should be inverted. ie VDD is active, VCC is inactive." } cdl_option CYGSEM_DEVS_USB_AT91_ZERO_LENGTH_PACKET_TERMINATION { display "Allow USB driver to end data transfer with an empty data packet." flavor bool default_value 1 description " This option allows the USB driver to automatically signal the end of a data transmission with an empty packet, if the last packet fragment is equal to the endpoint buffer size." } } cdl_component CYGPKG_DEVS_USB_AT91_DEVTAB_ENTRIES { display "Provide a devtab entry for endpoints" active_if CYGFUN_DEVS_USB_AT91_EP0 default_value 0 description " This component controls if /dev/usb entries will be created." cdl_option CYGVAR_DEVS_USB_AT91_EP0_DEVTAB_ENTRY { display "Provide a devtab entry for endpoint 0" flavor bool default_value 0 requires CYGPKG_IO description " If endpoint 0 will only be accessed via the low-level USB-specific calls then there is no need for an entry in the device table, saving some memory. If the application intends to access the endpoint by means of open and ioctl calls then a devtab entry is needed." } cdl_option CYGVAR_DEVS_USB_AT91_EP1_DEVTAB_ENTRY { display "Provide a devtab entry for endpoint 1" flavor bool default_value 1 requires CYGPKG_IO description " If this endpoint will only be accessed via the low-level USB-specific calls then there is no need for an entry in the device table, saving some memory. If the application intends to access the endpoint by means of open and read calls then a devtab entry is needed." } cdl_option CYGVAR_DEVS_USB_AT91_EP2_DEVTAB_ENTRY { display "Provide a devtab entry for endpoint 2" flavor bool default_value 1 requires CYGPKG_IO description " If this endpoint will only be accessed via the low-level USB-specific calls then there is no need for an entry in the device table, saving some memory. If the application intends to access the endpoint by means of open and read calls then a devtab entry is needed." } cdl_option CYGVAR_DEVS_USB_AT91_EP3_DEVTAB_ENTRY { display "Provide a devtab entry for endpoint 3" flavor bool default_value 1 requires CYGPKG_IO description " If this endpoint will only be accessed via the low-level USB-specific calls then there is no need for an entry in the device table, saving some memory. If the application intends to access the endpoint by means of open and read calls then a devtab entry is needed." } cdl_option CYGVAR_DEVS_USB_AT91_EP4_DEVTAB_ENTRY { display "Provide a devtab entry for endpoint 4" flavor bool default_value 0 requires CYGPKG_IO description " If this endpoint will only be accessed via the low-level USB-specific calls then there is no need for an entry in the device table, saving some memory. If the application intends to access the endpoint by means of open and read calls then a devtab entry is needed." } cdl_option CYGVAR_DEVS_USB_AT91_EP5_DEVTAB_ENTRY { display "Provide a devtab entry for endpoint 5" flavor bool default_value 0 requires CYGPKG_IO description " If this endpoint will only be accessed via the low-level USB-specific calls then there is no need for an entry in the device table, saving some memory. If the application intends to access the endpoint by means of open and read calls then a devtab entry is needed." } cdl_option CYGVAR_DEVS_USB_AT91_EP6_DEVTAB_ENTRY { display "Provide a devtab entry for endpoint 6" flavor bool default_value 0 requires CYGPKG_IO description " If this endpoint will only be accessed via the low-level USB-specific calls then there is no need for an entry in the device table, saving some memory. If the application intends to access the endpoint by means of open and read calls then a devtab entry is needed." } cdl_option CYGVAR_DEVS_USB_AT91_EP7_DEVTAB_ENTRY { display "Provide a devtab entry for endpoint 7" flavor bool default_value 0 requires CYGPKG_IO description " If this endpoint will only be accessed via the low-level USB-specific calls then there is no need for an entry in the device table, saving some memory. If the application intends to access the endpoint by means of open and read calls then a devtab entry is needed." } cdl_option CYGDAT_DEVS_USB_AT91_DEVTAB_BASENAME { display "Base name for devtab entries" flavor data default_value { "\"/dev/usbs\"" } description " If the uAT91 USB device driver package provides devtab entries for any of the endpoints then this option gives control over the names of these entries. By default the endpoints will be called \"/dev/usbs0c\", \"/dev/usbs3w\" and \"/dev/usbs4r\" (assuming all three endpoints are enabled. The common part \"/dev/usbs\" is determined by this configuration option. It may be necessary to change this if there are multiple USB slave-side devices on the target hardware to prevent a name clash." } } }