diff options
Diffstat (limited to 'share')
| -rw-r--r-- | share/man/man4/oldcard.4 | 78 | ||||
| -rw-r--r-- | share/man/man4/pcic.4 | 78 |
2 files changed, 86 insertions, 70 deletions
diff --git a/share/man/man4/oldcard.4 b/share/man/man4/oldcard.4 index e466f3b..30bb3a9 100644 --- a/share/man/man4/oldcard.4 +++ b/share/man/man4/oldcard.4 @@ -26,7 +26,7 @@ .\" .Dd August 25, 2001 .Dt PCIC 4 -.Os FreeBSD +.Os .Sh NAME .Nm pcic .Nd pccard bridge driver @@ -36,20 +36,20 @@ .Sh DESCRIPTION The .Nm -driver controls the pccard subssytem. +driver controls the pccard subsystem. The .Nm driver supports most .Tn ExCA -devices attach to either +devices attached to either .Tn ISA or .Tn PCI bus. The .Nm -driver does not support the so called TCIC controllers made by -databook. +driver does not support the so-called TCIC controllers made by +Databook. Nor does it support the MECIA chipset found in some early PC98 NOTE PC machines. The mecia driver now supports that bridge. @@ -57,15 +57,16 @@ The mecia driver now supports that bridge. The following .Tn ISA devices, or true clones, are supported in the current code. -.Bl -tag -width "Intel i82365SL Step A" -compact .Pp +.Bl -tag -width "Intel i82365SL Step A" -compact .It Intel i82365SL Step A .It Intel i82365SL Step B .It Intel i82365SL Step C -.Tn Intel's +.Tn Intel Ns 's original 16-bit pccard controller. .It Intel i82365SL-DF -.Tn Intel's last version of this device. +.Tn Intel Ns 's +last version of this device. 3.3V support was added. .It VLSI 82C146 An older VLSI part with some issues on some machines. @@ -73,28 +74,27 @@ An older VLSI part with some issues on some machines. .It Cirrus Logic PD-6720 .It Cirrus Logic PD-6722 Cirrus Logic's pcic controller. -Compatible with the i82365sl STEP C with the addition of a different +Compatible with the i82365SL Step C with the addition of a different 3.3V control. .It Ricoh RF5C296 .It Ricoh RF5C396 Ricoh's pccard bridge chips. -These are compatible with the i82365sl step C, but with yet another +These are compatible with the i82365SL Step C, but with yet another different 3.3V control. .It Vadem 365 .It Vadem 465 -Compatible with i82365sl step c. +Compatible with i82365SL Step C. .It Vadem 468 .It Vadem 469 Like the earlier Vadem models, but with Vadem's own, incompatible, 3.3V control system. .It IBM PCIC .Tn IBM -clone of the original i82365sl part, with its own id register value. +clone of the original i82365SL part, with its own ID register value. Has no 3.3V ability. .It IBM KING -.Tn IBM -A strange clone of i82365sl. -This part has many restrictions not found in the i82365sl, plus some +A strange clone of i82365SL. +This part has many restrictions not found in the i82365SL, plus some strange power control. It has not been tested in ages, but is believed to work. Its use is believed to be confined to model of ISA card, available @@ -105,8 +105,8 @@ Many other vendors made parts in this arena, but most of them were compatible with one of the above chipsets. .Pp The following PCI cardbus and pcmcia bridges are supported: -.Bl -tag -width "Intel i82365SL Step A" -compact .Pp +.Bl -tag -width "Intel i82365SL Step A" -compact .It Cirrus Logic PD6729 .It Cirrus Logic PD6730 These two might be broken at the moment. @@ -147,10 +147,10 @@ have good access to machines with one of these bridges in it. .Pp .It Toshiba ToPIC95 .It Toshiba ToPIC97 -.It Toshiba ToPIC100 -.Sh +.It Toshiba ToPIC100 +.El .Sh FILES -.Bl -tag -width /dev/card0 -compact +.Bl -tag -width ".Pa /dev/card0" -compact .It Pa /dev/card0 Character device for the .Nm @@ -170,56 +170,64 @@ them. PCI interrupt routing is the default for PCI devices. Some older laptops require ISA interrupt routing to work properly. To enable ISA interrupt routing, you must set the tunable -hw.pcic.intr_path=1 in /boot/loader.conf. +.Li hw.pcic.intr_path=1 +in +.Pa /boot/loader.conf . For the present, unless you have a one slot machine, you should set -hw.pcic.irq=0 to force polling mode. +.Li hw.pcic.irq=0 +to force polling mode. Two slot machines have minor issues with using an ISA interrupt for the CSC interrupt. .Sh TUNABLES -.Bl -tag -width 0123456789 -compact -.It hw.pcic.ignore_function_1 -Needed for some, improperly manufacturered pci cards made by orinoco. +.Bl -tag -width indent +.It Va hw.pcic.ignore_function_1 +Needed for some, improperly manufactured PCI cards made by Orinoco. It disables function 1 completely. Set to 0 to enable function 1. Set to 1 to disable function 1. This tunable generally should not be needed on laptops. The default is 0. -.It hw.pcic.init_routing +.It Va hw.pcic.init_routing Some machines can tolerate interrupt routing selection at the cardbus bridge level. Others fail when you mess with these registers. -Set to 1 to force the chipset to route via parallel pci interrupts (as +Set to 1 to force the chipset to route via parallel PCI interrupts (as well as a few other little things). -Set to 0, the default, forces the code to leave these registers as the +Setting to 0, the default, forces the code to leave these registers as the code finds them. Most laptops will not need to set this tunable. -Many pci cards with cardbus chips on them are believed to need this +Many PCI cards with cardbus chips on them are believed to need this tunable set to 1. The default is 0. -.It hw.pcic.intr_path -Should pci pcic devices route interrupts via ISA or PCI. +.It Va hw.pcic.intr_path +Should PCI pcic devices route interrupts via ISA or PCI. A value of 1 means route via ISA. A value of 2 means route via PCI. This is ignored for the ISA device. -Many older laptops do not have PCI BIOS implementaitons that +Many older laptops do not have PCI BIOS implementations that .Fx can use to route interrupts properly. -These laptops may need to set this to 1 and hw.pcic.irq to a value +These laptops may need to set this to 1 and +.Va hw.pcic.irq +to a value (or 0 for polling). The default is 2. -.It hw.pcic.irq +.It Va hw.pcic.irq Overrides the IRQ to use for ISA interrupt routing of the CSC or management interrupt. If you are using the ISA device, you can set this tunable, or use the -irq N clause in config file. +.Cd "irq N" +clause in config file. If you are using a PCI device in ISA interrupt mode (see -hw.pcic.intr_path), then you must set the interrupt with this +.Va hw.pcic.intr_path ) , +then you must set the interrupt with this sysctl, or polling mode will be used. Due to limitations in the tunable system, only one interrupt can be selected for all cards. Systems with multiple PCI bridges that need to use ISA routing are encouraged to use polling mode on each of the cards. The default is 0. +.El .Sh HISTORY Too long to detail in the man page. .Sh BUGS diff --git a/share/man/man4/pcic.4 b/share/man/man4/pcic.4 index e466f3b..30bb3a9 100644 --- a/share/man/man4/pcic.4 +++ b/share/man/man4/pcic.4 @@ -26,7 +26,7 @@ .\" .Dd August 25, 2001 .Dt PCIC 4 -.Os FreeBSD +.Os .Sh NAME .Nm pcic .Nd pccard bridge driver @@ -36,20 +36,20 @@ .Sh DESCRIPTION The .Nm -driver controls the pccard subssytem. +driver controls the pccard subsystem. The .Nm driver supports most .Tn ExCA -devices attach to either +devices attached to either .Tn ISA or .Tn PCI bus. The .Nm -driver does not support the so called TCIC controllers made by -databook. +driver does not support the so-called TCIC controllers made by +Databook. Nor does it support the MECIA chipset found in some early PC98 NOTE PC machines. The mecia driver now supports that bridge. @@ -57,15 +57,16 @@ The mecia driver now supports that bridge. The following .Tn ISA devices, or true clones, are supported in the current code. -.Bl -tag -width "Intel i82365SL Step A" -compact .Pp +.Bl -tag -width "Intel i82365SL Step A" -compact .It Intel i82365SL Step A .It Intel i82365SL Step B .It Intel i82365SL Step C -.Tn Intel's +.Tn Intel Ns 's original 16-bit pccard controller. .It Intel i82365SL-DF -.Tn Intel's last version of this device. +.Tn Intel Ns 's +last version of this device. 3.3V support was added. .It VLSI 82C146 An older VLSI part with some issues on some machines. @@ -73,28 +74,27 @@ An older VLSI part with some issues on some machines. .It Cirrus Logic PD-6720 .It Cirrus Logic PD-6722 Cirrus Logic's pcic controller. -Compatible with the i82365sl STEP C with the addition of a different +Compatible with the i82365SL Step C with the addition of a different 3.3V control. .It Ricoh RF5C296 .It Ricoh RF5C396 Ricoh's pccard bridge chips. -These are compatible with the i82365sl step C, but with yet another +These are compatible with the i82365SL Step C, but with yet another different 3.3V control. .It Vadem 365 .It Vadem 465 -Compatible with i82365sl step c. +Compatible with i82365SL Step C. .It Vadem 468 .It Vadem 469 Like the earlier Vadem models, but with Vadem's own, incompatible, 3.3V control system. .It IBM PCIC .Tn IBM -clone of the original i82365sl part, with its own id register value. +clone of the original i82365SL part, with its own ID register value. Has no 3.3V ability. .It IBM KING -.Tn IBM -A strange clone of i82365sl. -This part has many restrictions not found in the i82365sl, plus some +A strange clone of i82365SL. +This part has many restrictions not found in the i82365SL, plus some strange power control. It has not been tested in ages, but is believed to work. Its use is believed to be confined to model of ISA card, available @@ -105,8 +105,8 @@ Many other vendors made parts in this arena, but most of them were compatible with one of the above chipsets. .Pp The following PCI cardbus and pcmcia bridges are supported: -.Bl -tag -width "Intel i82365SL Step A" -compact .Pp +.Bl -tag -width "Intel i82365SL Step A" -compact .It Cirrus Logic PD6729 .It Cirrus Logic PD6730 These two might be broken at the moment. @@ -147,10 +147,10 @@ have good access to machines with one of these bridges in it. .Pp .It Toshiba ToPIC95 .It Toshiba ToPIC97 -.It Toshiba ToPIC100 -.Sh +.It Toshiba ToPIC100 +.El .Sh FILES -.Bl -tag -width /dev/card0 -compact +.Bl -tag -width ".Pa /dev/card0" -compact .It Pa /dev/card0 Character device for the .Nm @@ -170,56 +170,64 @@ them. PCI interrupt routing is the default for PCI devices. Some older laptops require ISA interrupt routing to work properly. To enable ISA interrupt routing, you must set the tunable -hw.pcic.intr_path=1 in /boot/loader.conf. +.Li hw.pcic.intr_path=1 +in +.Pa /boot/loader.conf . For the present, unless you have a one slot machine, you should set -hw.pcic.irq=0 to force polling mode. +.Li hw.pcic.irq=0 +to force polling mode. Two slot machines have minor issues with using an ISA interrupt for the CSC interrupt. .Sh TUNABLES -.Bl -tag -width 0123456789 -compact -.It hw.pcic.ignore_function_1 -Needed for some, improperly manufacturered pci cards made by orinoco. +.Bl -tag -width indent +.It Va hw.pcic.ignore_function_1 +Needed for some, improperly manufactured PCI cards made by Orinoco. It disables function 1 completely. Set to 0 to enable function 1. Set to 1 to disable function 1. This tunable generally should not be needed on laptops. The default is 0. -.It hw.pcic.init_routing +.It Va hw.pcic.init_routing Some machines can tolerate interrupt routing selection at the cardbus bridge level. Others fail when you mess with these registers. -Set to 1 to force the chipset to route via parallel pci interrupts (as +Set to 1 to force the chipset to route via parallel PCI interrupts (as well as a few other little things). -Set to 0, the default, forces the code to leave these registers as the +Setting to 0, the default, forces the code to leave these registers as the code finds them. Most laptops will not need to set this tunable. -Many pci cards with cardbus chips on them are believed to need this +Many PCI cards with cardbus chips on them are believed to need this tunable set to 1. The default is 0. -.It hw.pcic.intr_path -Should pci pcic devices route interrupts via ISA or PCI. +.It Va hw.pcic.intr_path +Should PCI pcic devices route interrupts via ISA or PCI. A value of 1 means route via ISA. A value of 2 means route via PCI. This is ignored for the ISA device. -Many older laptops do not have PCI BIOS implementaitons that +Many older laptops do not have PCI BIOS implementations that .Fx can use to route interrupts properly. -These laptops may need to set this to 1 and hw.pcic.irq to a value +These laptops may need to set this to 1 and +.Va hw.pcic.irq +to a value (or 0 for polling). The default is 2. -.It hw.pcic.irq +.It Va hw.pcic.irq Overrides the IRQ to use for ISA interrupt routing of the CSC or management interrupt. If you are using the ISA device, you can set this tunable, or use the -irq N clause in config file. +.Cd "irq N" +clause in config file. If you are using a PCI device in ISA interrupt mode (see -hw.pcic.intr_path), then you must set the interrupt with this +.Va hw.pcic.intr_path ) , +then you must set the interrupt with this sysctl, or polling mode will be used. Due to limitations in the tunable system, only one interrupt can be selected for all cards. Systems with multiple PCI bridges that need to use ISA routing are encouraged to use polling mode on each of the cards. The default is 0. +.El .Sh HISTORY Too long to detail in the man page. .Sh BUGS |
