freebsd-dev/sys/boot/forth/loader.conf
Bill Paul ed63a7aaef This commit adds device driver support for the ADMtek AN986 Pegasus
USB ethernet chip. Adapters that use this chip include the LinkSys
USB100TX. There are a few others, but I'm not certain of their
availability in the U.S. I used an ADMtek eval board for development.
Note that while the ADMtek chip is a 100Mbps device, you can't really
get 100Mbps speeds over USB. Regardless, this driver uses miibus to
allow speed and duplex mode selection as well as autonegotiation.
Building and kldloading the driver as a module is also supported.

Note that in order to make this driver work, I had to make what some
may consider an ugly hack to sys/dev/usb/usbdi.c. The usbd_transfer()
function will use tsleep() for synchronous transfers that don't complete
right away. This is a problem since there are times when we need to
do sync transfers from an interrupt context (i.e. when reading registers
from the MAC via the control endpoint), where tsleep() us a no-no.
My hack allows the driver to have the code poll for transfer completion
subject to the xfer->timeout timeout rather that calling tsleep().
This hack is controlled by a quirk entry and is only enabled for the
ADMtek device.

Now, I'm sure there are a few of you out there ready to jump on me
and suggest some other approach that doesn't involve a busy wait. The
only solution that might work is to handle the interrupts in a kernel
thread, where you may have something resembling a process context that
makes it okay to tsleep(). This is lovely, except we don't have any
mechanism like that now, and I'm not about to implement such a thing
myself since it's beyond the scope of driver development. (Translation:
I'll be damned if I know how to do it.) If FreeBSD ever aquires such
a mechanism, I'll be glad to revisit the driver to take advantage of
it. In the meantime, I settled for what I perceived to be the solution
that involved the least amount of code changes. In general, the hit
is pretty light.

Also note that my only USB test box has a UHCI controller: I haven't
I don't have a machine with an OHCI controller available.

Highlights:

- Updated usb_quirks.* to add UQ_NO_TSLEEP quirk for ADMtek part.
- Updated usbdevs and regenerated generated files
- Updated HARDWARE.TXT and RELNOTES.TXT files
- Updated sysinstall/device.c and userconfig.c
- Updated kernel configs -- device aue0 is commented out by default
- Updated /sys/conf/files
- Added new kld module directory
1999-12-28 02:01:18 +00:00

190 lines
7.3 KiB
Plaintext

# This is loader.conf - a file full of useful variables that you can
# set to change the default load behavior of your system. You should
# not edit this file! Put any overrides into one of the
# loader_conf_files instead and you will be able to update these
# defaults later without spamming your local configuration information.
#
# All arguments must be in double quotes.
#
# $FreeBSD$
##############################################################
### Basic configuration options ############################
##############################################################
exec=".( Loading /boot/defaults/loader.conf ) cr"
kernel="/kernel"
kernel_options=""
userconfig_script_load="NO"
userconfig_script_name="/boot/kernel.conf"
userconfig_script_type="userconfig_script"
loader_conf_files="/boot/loader.conf /boot/loader.conf.local"
verbose_loading="NO" # Set to YES for verbose loader output
##############################################################
### Splash screen configuration ############################
##############################################################
splash_bmp_load="NO" # Set this to YES for bmp splash screen!
splash_pcx_load="NO" # Set this to YES for pcx splash screen!
vesa_load="NO" # Set this to YES to load the vesa module
bitmap_load="NO" # Set this to YES if you want splash screen!
bitmap_name="/boot/splash.bmp" # Set this to the name of the bmp or pcx file
bitmap_type="splash_image_data"
##############################################################
### Loader settings ########################################
##############################################################
#autoboot_delay="10" # Delay in seconds before autobooting
#bootfile="kernel,kernel.old" # Set the default boot file set
#console="vidconsole" # Set the current console
#currdev="disk1s1a" # Set the current device
#module_path="/;/boot;/modules" # Set the module search path
#prompt="\\${interpret}" # Set the command prompt
#root_disk_unit="0" # Force the root disk unit number
#rootdev="disk1s1a" # Set the root filesystem
##############################################################
### Kernel settings ########################################
##############################################################
#boot_askname="NO" # Prompt the user for the name of the root device
#boot_ddb="NO" # Instructs the kernel to start in the DDB debugger
#boot_gdb="NO" # Selects gdb-remote mode for the kernel debugger
#boot_single="NO" # Start system in single-user mode
#boot_userconfig="NO" # Run kernel's interactive device configuration program
#boot_verbose="NO" # Causes extra debugging information to be printed
#init_path="/sbin/init:/sbin/oinit:/sbin/init.bak:/stand/sysinstall"
# Sets the list of init candidates
##############################################################
### Kernel tunables ########################################
##############################################################
#kern.ipc.nmbclusters="" # Set the number of mbuf clusters
#kern.vm.kmem.size="" # Sets the size of kernel memory (bytes)
#machdep.pccard.pcic_irq="0" # Assigns PCCARD controller IRQ (0=polled)
#net.inet.tcp.tcbhashsize="" # Set the value of TCBHASHSIZE
##############################################################
### Filesystem and related modules #########################
##############################################################
# Filesystems
cd9660_load="NO" # ISO 9660 filesystem
coda_load="NO" # CODA filesystem
fdesc_load="NO" # Filedescriptors filesystem
kernfs_load="NO" # Kernel filesystem
mfs_load="NO" # Memory filesystem
msdos_load="NO" # FAT-12/16/32
nfs_load="NO" # NFS
ntfs_load="NO" # NTFS
null_load="NO" # Null filesystem
portal_load="NO" # Portal filesystem
procfs_load="NO" # Process filesystem
umap_load="NO" # User-id map filesystem
union_load="NO" # Union filesystem
# Related stuff
ccd_load="NO" # Concatenated disk driver
vinum_load="NO" # Concatenated/mirror/raid driver
vn_load="NO" # Vnode driver
##############################################################
### Screen saver modules ###################################
##############################################################
# This is best done in rc.conf
screensave_load="NO" # Set to YES to load a screensaver module
screensave_name="green_saver" # Set to the name of the screensaver module
##############################################################
### Emulation modules ######################################
##############################################################
fpu_load="NO" # Floating point emulation
gnufpu_load="NO" # GNU floating point emulation
ibcs2_load="NO" # IBCS2 (SCO) emulation
ibcs2_coff_load="NO"
linux_load="NO" # Linux emulation
svr4_load="NO" # SystemV R4 emulation
streams_load="NO" # System V streams module
##############################################################
### Networking modules #####################################
##############################################################
if_disc_load="NO" # Discard device
if_ppp_load="NO" # Kernel ppp
if_sl_load="NO" # SLIP
if_tun_load="NO" # Tunnel driver (user process ppp)
ipfw_load="NO" # Firewall
##############################################################
### Networking drivers #####################################
##############################################################
miibus_load="NO" # miibus support, needed for some drivers
if_dc_load="NO" # DEC/Intel 21143 and various workalikes
if_fxp_load="NO" # Intel EtherExpress PRO/100B (82557, 82558)
if_rl_load="NO" # RealTek 8129/8139
if_sf_load="NO" # Adaptec Duralink PCI (AIC-6915 "starfire")
if_sis_load="NO" # Silicon Integrated Systems SiS 900/7016
if_sk_load="NO" # SysKonnect SK-984x series PCI gigabit ethernet
if_ti_load="NO" # Alteon Networks Tigon 1 and Tigon 2
if_tl_load="NO" # Texas Instruments TNETE100 ("ThunderLAN")
if_vr_load="NO" # VIA Rhine I and Rhine II
if_wb_load="NO" # Winbond W89C840F
if_xl_load="NO" # 3Com Etherlink XL (3c900, 3c905, 3c905B)
##############################################################
### USB modules ############################################
##############################################################
usb_load="NO" # USB subsystem
ugen_load="NO" # USB generic device, if all else fails ...
uhid_load="NO" # Human Interface Devices
ukbd_load="NO" # Keyboard
ulpt_load="NO" # Printer
ums_load="NO" # Mouse
umass_load="NO" # Mass Storage Devices
if_aue_load="NO" # ADMtek USB ethernet
##############################################################
### Other modules ##########################################
##############################################################
bktr_load="NO" # Brooktree Bt848/Bt878 TV/Video Capture Card
##############################################################
### Module loading syntax example ##########################
##############################################################
#module_load="YES" # loads module "module"
#module_name="realname" # uses "realname" instead of "module"
#module_type="type" # passes "-t type" to load
#module_flags="flags" # passes "flags" to the module
#module_before="cmd" # executes "cmd" before loading the module
#module_after="cmd" # executes "cmd" after loading the module
#module_error="cmd" # executes "cmd" if load fails