Difference between revisions of "Template:Device Infobox/Begin"

From Vogons Wiki
Jump to: navigation, search
(Add AGP speed)
(Transclude property pages to avoid duplicating descriptions)
Line 43: Line 43:
 
Valid parameters and examples are:
 
Valid parameters and examples are:
 
{|class="wikitable"
 
{|class="wikitable"
−
! Parameter/example !! Purpose !! Valid values
+
! Parameter !! Meaning
 
|-
 
|-
−
| Image = Image.jpg || Photo of the device || '''Use the default name''' wherever possible (i.e. do not use this option unless you have to).  If there are characters that cannot be used in a filename (e.g. a forward slash), try to find a Unicode equivalent to use instead (e.g. mathematical division slash) which are allowed in filenames and look the same.
+
| Image = Image.jpg || Photo of the device. '''Use the default name''' wherever possible (i.e. do not use this option unless you have to).  If there are characters that cannot be used in a filename (e.g. a forward slash), try to find a Unicode equivalent to use instead (e.g. mathematical division slash) which are allowed in filenames and look the same.
 
|-
 
|-
−
| Bus type = ''Value'' || Card interface || {{Property:Bus type}}
+
| Bus type = ''Value'' || {{Property:Bus type}}
 
|-
 
|-
−
| Bus width = ''Value'' || Width of bus || {{Property:Bus width}}
+
| Bus width = ''Value'' || {{Property:Bus width}}
 
|-
 
|-
−
| Bus speed = ''Value'' || Rated maximum bus speed of device || Values depend on the bus type:<ul>
+
| Bus speed = ''Value'' || {{Property:Bus speed}}
−
<li>ISA: '''8 MHz'''</li>
+
−
<li>VLB: '''40 MHz''' (VLB 1.0), '''50 MHz''' (VLB 2.0)</li>
+
−
<li>PCI: '''33 MHz''', '''66 MHz''', '''133 MHz'''</li>
+
−
<li>AGP: '''66 MHz'''</li>
+
−
<li>PCIe: ? - should be a way here of distinguishing between PCIe 1.0, 2.0, 3.0, etc.</li>
+
−
</ul>
+
 
|-
 
|-
−
| 8-bit ISA compatible = ''Value'' || 16-bit ISA only: Does the card work in an 8-bit slot? || '''Yes''', '''No''' or '''Unknown'''
+
| 8-bit ISA compatible = ''Value'' || 16-bit ISA only: {{Property:Is 8-bit ISA compatible}}
 
|-
 
|-
−
| PCI 5V = ''Value'' || PCI only: Will the card work in 5 VDC slots? || '''Yes''', '''No''' or '''Unknown'''
+
| PCI 5V = ''Value'' || PCI only: {{Property:Is PCI 5V tolerant}}
 
|-
 
|-
−
| PCI 3.3V = ''Value'' || PCI only: Will the card work in 3.3 VDC slots? || '''Yes''', '''No''' or '''Unknown'''
+
| PCI 3.3V = ''Value'' || PCI only: {{Property:Is PCI 3.3V tolerant}}
 
|-
 
|-
−
| AGP speed = ''Value'' || AGP only: Max AGP speed the device supports || '''1x''', '''2x''', '''4x''', '''8x''' or '''Unknown'''
+
| AGP speed = ''Value'' || AGP only: {{Property:Has AGP speed}}
 
|-
 
|-
−
| Manufacturer = ''Value'' || Company name of manufacturer || Be consistent so all cards with the same manufacturer are grouped together
+
| Manufacturer = ''Value'' || {{Property:Manufacturer}}
 
|-
 
|-
−
| Chipset = ''Value'' || Primary card chipset || Be consistent so all cards with the same chipset are grouped together.  If there is more than one large chip, try to pick the biggest or the one most related to network processes.
+
| Chipset = ''Value'' || {{Property:Chipset}}
 
|-
 
|-
−
| Compatible with = ''Value'' || Generic interfaces that can be used to control this card || Valid values depend on the device type, see the device-specific infobox page for a list.
+
| Compatible with = ''Value'' || {{Property:Compatible with}}
 
|-
 
|-
−
| Connectors = ''Value'' || Which connectors are on the card? || Comma separated list of '''Has connector''' elements.  Valid values depend on the device type, see the device-specific infobox page for a list.
+
| Connectors = ''Value'' || {{Property:Has connector}}
 
|-
 
|-
−
| Extra fields = ''Value'' || Additional infobox fields for more specific infoboxes to use || Zero or more whitespace-separated instances of [[Template:Infobox Item]].
+
| Extra fields = ''Value'' || Additional infobox fields for more specific infoboxes to use. Zero or more whitespace-separated instances of [[Template:Device Infobox/Item]].
 
|-
 
|-
−
| Requires -5VDC = ''Value'' || Does the card require -5V present to function correctly? || '''Yes''', '''No''' or '''Unknown'''.  PCI and newer slots do not supply 5V so this should always be set to '''No''' for those devices.
+
| Requires -5VDC = ''Value'' || {{Property:Requires -5VDC}}
 
|-
 
|-
−
| Requires -12VDC = ''Value'' || Does the card require -12V present to function correctly? || '''Yes''', '''No''' or '''Unknown'''
+
| Requires -12VDC = ''Value'' || {{Property:Requires -12VDC}}
 
|-
 
|-
−
| Config = ''Value'' || Configuration method used to set card resources (addresses, IRQ, etc.) || Comma separated list, one or more of: <ul>
+
| Config = ''Value'' || {{Property:Config method}}
−
<li>'''<nowiki>[[Config method::Jumpers]]</nowiki>''' (some or all resources are set via physical jumpers on the card)</li>
+
−
<li>'''<nowiki>[[Config method::Software]]</nowiki>''' (some or all resources are set with a manufacturer-provided configuration program)</li>
+
−
<li>'''<nowiki>[[Config method::PnP]]</nowiki>''' (some or all resources are set via the ISA/PCI plug-n-play specification, requiring a PnP BIOS or configuration manager program to be used)</li>
+
−
<li>'''<nowiki>[[Config method::None]]</nowiki>''' (none of the resources can be changed at all)</li>
+
−
</ul>
+
 
|-
 
|-
−
| Driver = ''Wikilink'' || Link to latest driver download || Avoid multiple links - if it is important to have multiple downloads, put them in a 'downloads' section in the article.  Example: '''<nowiki>Driver = [http://example.com/example.zip example.zip]</nowiki>'''
+
| Driver = ''Wikilink'' || Link to latest driver download.  Avoid multiple links - if it is important to have multiple downloads, put them in a 'downloads' section in the article.  Example: '''<nowiki>Driver = [http://example.com/example.zip example.zip]</nowiki>'''
 
|-
 
|-
−
| IsInfoboxPage = ''Value'' || Internal use only, do not use || This value is set to '''Y''' on infobox pages to avoid the infoboxes themselves being added to categories like 'missing images'.
+
| IsInfoboxPage = ''Value'' || Internal use only, do not use.  This value is set to '''Y''' on infobox pages to avoid the infoboxes themselves being added to categories like 'missing images'.
 
|}
 
|}
  

Revision as of 19:09, 13 February 2016

Device Infobox/Begin
There is no image of this device — upload one!

Template:Infobox Item Template:Infobox Item Template:Infobox Item

Template:Infobox Item


Template:Infobox Item 

 Template:Infobox Item

Template:Infobox Item

Template:Infobox Item Template:Infobox Item


Template:Infobox Item

Template:Infobox Item Template:Infobox Item Template:Infobox Item



Driver Missing download URL

This template is used to build a more specific infobox for particular types of devices. See Template:Ethernet Infobox for example use.

Valid parameters and examples are:

Parameter Meaning
Image = Image.jpg Photo of the device. Use the default name wherever possible (i.e. do not use this option unless you have to). If there are characters that cannot be used in a filename (e.g. a forward slash), try to find a Unicode equivalent to use instead (e.g. mathematical division slash) which are allowed in filenames and look the same.
Bus type = Value The bus type is a text field containing only one of the following permitted values:
  • Expansion cards
    • ISA - original ISA bus
    • EISA - IBM's extended ISA bus (VLB cards are often mistakenly called EISA, make sure it really is EISA!)
    • VLB - VESA Local Bus
    • PCI - original PCI (not PCI Express)
    • AGP
    • PCIe - PCI Express
  • Drives
    • IDE - standard IDE drives
    • SCSI - devices connected to the SCSI bus
    • PC Floppy - standard floppy drives with Shugart 34-pin interface
      • Shugart 50-pin - older PC-compatible floppy interface for 8" drives
    • USB - devices that connect to USB
  • CPUs
    • FSB - Intel Front Side Bus

Other buses should be added to this list as needed. If a device is available with more than one bus type, a different page should be created for each version of the device, as technically those cards are slightly different models.

If a card has multiple bus connections (e.g. some POST cards support both PCI and ISA on different edges of the card) then pick the oldest one, and list the others in the article text using code similar to this: 

This card also has a [[Bus type::PCI]] connector.
Bus width = Value The bus type is a text field containing only one of the following permitted values, which vary depending on the bus type:
  • Expansion cards
    • ISA: 8-bit, 16-bit
    • VLB: 32-bit (VLB 1.0), 64-bit (VLB 2.0)
    • PCI: 32-bit, 64-bit
    • AGP: 32-bit
    • PCIe: x1, x2, x4, x8, x16 - size of connector on the card, make a note in the article if the card is electrically less than this
  • Drives
    • PC Floppy: 1-bit (only one read and one write line)
    • IDE: 16-bit (PIO), 32-bit (UDMA)
    • SCSI: 8-bit (narrow SCSI), 16-bit (wide SCSI)
  • General
    • USB: 1-bit (only one read and one write lane)
Bus speed = Value Rated maximum bus speed of the device. The values depend on the bus type:
  • AGP: 66 MHz
  • IDE: N/A (set automatically from Bus version)
  • ISA: 8 MHz
  • PCI: 33 MHz, 66 MHz, 133 MHz
  • PCIe: N/A (PCIe version goes into Bus version parameter)
  • VLB: 40 MHz (VLB 1.0), 50 MHz (VLB 2.0)
8-bit ISA compatible = Value 16-bit ISA only: This boolean property is Yes if a 16-bit ISA card is known to work in an 8-bit ISA slot. It is No if the card is known not to work in an 8-bit slot. If the value is not set, then the card has not yet been tested in an 8-bit slot. If the card is an 8-bit card then this value is automatically set to Yes so it can be omitted. It is likewise automatically set to No for non-ISA buses so it can be omitted there as well.

This is useful for those working with XT and older computers, which only have 8-bit slots. Knowing a particular 16-bit card will work in a machine with only 8-bit slots saves the hassle of trying to find an 8-bit card to use.

If a card does not natively work in an 8-bit slot but can be made to do so with different drivers, then this value should be set to Yes, but an explanation should be given on the device's page.

PCI 5V = Value PCI only: Boolean value indicating whether the card will work in a 5 VDC PCI slot. Yes, No or Unknown.
PCI 3.3V = Value PCI only: Boolean value indicating whether the card will work in a 3.3 VDC PCI slot. Yes, No or Unknown.
AGP speed = Value AGP only: Property:Has AGP speed
Manufacturer = Value Page for the manufacturer's company name. Be consistent so all cards with the same manufacturer are grouped together.
Chipset = Value Text value containing the name of the primary chipset. Be consistent so all cards with the same chipset are grouped together. If there is more than one large chip, try to pick the biggest or the one most related to the card's primary function.
Compatible with = Value Generic interfaces that can be used to control this card. Valid values depend on the device type, see the device-specific infobox pages for examples. Each interface has a page of its own.
Connectors = Value Which externally accessible connectors are on the card? Comma separated list of Has connector page elements. Valid values depend on the device type, see Has connector for a list. An example is [[Has connector::VGA]], [[Has connector::RS232/DB25]]

Internal connectors are typically specified elsewhere in the infobox.

Extra fields = Value Additional infobox fields for more specific infoboxes to use. Zero or more whitespace-separated instances of Template:Device Infobox/Item.
Requires -5VDC = Value Boolean value indicating whether the device requires -5VDC present to function correctly. Yes, No or Unknown. This can be important since most modern power supplies no longer deliver -5VDC.
Requires -12VDC = Value Boolean value indicating whether the device requires -12VDC present to function correctly. Yes, No or Unknown.
Config = Value Configuration method used to set card resources (addresses, IRQ, etc.). Comma separated list, one or more of:
  • [[Config method::Jumpers]] (some or all resources are set via physical jumpers on the card)
  • [[Config method::DIP switches]] (similar to jumpers but via small switches instead)
  • [[Config method::Software]] (some or all resources are set with a manufacturer-provided configuration program)
  • [[Config method::PnP]] (some or all resources are set via the ISA/PCI plug-n-play specification, requiring a PnP BIOS or configuration manager program to be used)
  • [[Config method::None]] (none of the resources can be changed at all)
Driver = Wikilink Link to latest driver download. Avoid multiple links - if it is important to have multiple downloads, put them in a 'downloads' section in the article. Example: Driver = [http://example.com/example.zip example.zip]
IsInfoboxPage = Value Internal use only, do not use. This value is set to Y on infobox pages to avoid the infoboxes themselves being added to categories like 'missing images'.

Default values are shown if the parameter is omitted, so do not use any parameters unless the value is known (most of the defaults say "unknown")

Retrieved from "https://www.vogonswiki.com/index.php?title=Template:Device_Infobox/Begin&oldid=2362"