Template:Infobox hard drive/doc

Icon

This is a documentation subpage for Template:Infobox hard drive. It contains usage information, categories and other content that is not part of the original template page.

This infobox is designed for hard drive model articles. It shows various hard drive parameters, such as speed, capacity and per-platter capacity.

Examples

This example infobox is generated using the following code:

{{infobox hard drive
|image1 = Toshiba HDWD240 top-down view.jpg
|caption1 = Top lid of a HDWD240.
|image2 = File:Toshiba HDWD240 CDI SMART printout.png
|caption2 = CrystalDiskInfo printout of SMART attributes.
|manufacturer = [[Toshiba]]
|family = [[Toshiba P300]]/[[Toshiba DT02]]
|form_factor = 3.5"
|z-height = 26.1 mm
|speed = 5,400
|capacity = 4
|capacity_unit = tb
|af = 512e
|max_transfer = 176.4 (from DT02ABA400)
|ncq = Yes
|apm = Yes
|aam = Yes
|trim = No
|scterc = Read: Disabled<br>Write: Disabled
|interface = SATA
|interface_version = SATA 3.3 (600 MB/s)
|command_set = ACS-3 Revision 5
|platters = 2
|heads = 4
|capacity_per_platter = 2
|capacity_per_platter_unit = tb
|recording_method = smr
|cache = 128
|cache_unit = mb
|mttf = None
|max_load_cycles = 600,000
|unrecoverable_error_rate = <math>1</math> in <math>10^{14}</math>
|released = 2019
}}

For detailed usage information on each parameter, see the TemplateData.

Capacity discrepancy verification

This template verifies whether the following rules are true.

1. There cannot be more heads than double the platter count. (2 platters, 4 heads is legal, since $2\times 2=4$, but 2 platters, 6 heads is not legal, since $2\times 2\ne 5$.)
2. The total capacity equals the difference between the following:
   • Platter capacity multiplied by (number of heads divided by 2)
   • Subtracted by short stroked capacity
   • Summed up by this mathematical statement: $C=(P\times h/2)-S$

If one or both of these rules are not true, the page is categorised into Category:Hard drive models with capacity, capacity per platter and short stroked capacity calculation errors, and an error is raised in the Capacity field warning that such a discrepancy was found. Please correct the following fields, preferably by consulting a source such as the RML527 HDD Platter Capacity Database, and check using preview that your edit clears the error.

• capacity and capacity_unit
• capacity_per_platter and capacity_per_platter_unit
• platters (if the problem is that there are too few platters for the number of heads)
• heads
• short_stroked_capacity and short_stroked_capacity_unit

TemplateData

Displays information on hard drive models.

Template parameters

This template prefers block formatting of parameters.

Parameter		Description	Type	Status
Image 1	image1	File name for the first image on the infobox. Example TOSHIBA HDWJ110.jpg	File	suggested
Image caption 1	caption1	An image caption to accompany image 1. Also acts as alt text if not explicity provided. Example Top down view of the hard drive.	Content	suggested
Alt text 1	alt1	Alt text associated with image 1. Default {{{caption1}}}	String	optional
Image 2	image2	File name for the second image on the infobox. Example Toshiba HDWJ110 SMART printout.png	File	optional
Image caption 2	caption2	An image caption to accompany image 2. Also acts as alt text if not explicitly provided.	Content	optional
Alt text 2	alt2	Alt text associated with image 2. Default {{{caption2}}}	String	optional
Image 3	image3	File name for the third image on the infobox. Example Toshiba HDWJ110 SMART printout.png	File	optional
Image caption 3	caption3	An image caption to accompany image 3. Also acts as alt text if not explicitly provided.	String	optional
Alt text 3	alt3	Alt text associated with image 3. Default {{{caption3}}}	String	optional
Manufacturer	manufacturer	The company who manufactures or manufactured this hard drive model. Example [[Western Digital]]	Page name	required
Product family	family	The product family the hard drive model belongs to. Example [[Toshiba P300]]	Page name	suggested
Platform/Drive family	platform	The platform name (such as a WD Marvell family). Example Diablo3s	String	optional
Form factor	form_factor	The form factor of the hard drive model, expressed in inches (as in, 3.5"). Example 3.5"	String	required
z-height	z-height	The total z-height of the drive in millimetres. Most useful for 2.5"s, most 3.5"s are 26.1. Example 9.5	Number	suggested
Capacity	capacity	The total capacity of the hard drive model. Do not include units, and do not use binary capacities (such as 236 instead of 256). Example 500	Number	suggested
Capacity unit	capacity_unit	The two- or three- letter acronym for the capacity's unit. Case insensitive. Accepts all parameters that Template:Cache unit accepts. Example gb	String	required
Rotation speed	speed	The speed that the hard drive platters rotate at. Example 5,400	Number	suggested
Cache	cache	The amount of cache RAM the hard drive contains. Example 64	Number	suggested
Cache unit	cache_unit	The two- or three- letter acronym for the cache capacity's unit. Case insensitive. Accepts all parameters that Template:Cache unit accepts. Example mb	String	suggested
Maximum sustained transfer rate	max_transfer	The maximum specified transfer rate, in MB/s. Note that some datasheets specify this in Mbits for some reason; for those, provide an MB/s translation as well as the original. Example 180	Number	suggested
LBAs	lbas	The number of LBAs the hard drive has available. If left blank, this is automatically calculated using the IDEMA formula and the values of logical_sector_size or af. It should not be necessary to explicitly set this parameter; only use it when the drive model does not conform to IDEMA formulae.	Number	optional
User capacity	user_capacity	The amount of user capacity the hard drive has available. If left blank, this is automatically calculated using the IDEMA formula and the values of logical_sector_size or af. It should not be necessary to explicitly set this parameter; only use it when the drive model does not conform to IDEMA formulae.	Unknown	optional
Advanced Format status	af	Whether the hard drive supports Advanced Format, and if so, what type it supports (512e, or 4Kn) Example No	String	suggested
Logical sector size	logical_sector_size	The size of each LBA in bytes. If left blank, this is automatically detected from the drive's Advanced Format support.	Unknown	optional
Physical sector size	physical_sector_size	The size of each physical sector in bytes. If left blank, this is automatically detected from the drive's Advanced Format support.	Unknown	optional
Interface	interface	The acronym for the interface in use (pata, sata, scsi, sas). Case insensitive. Example sata	String	suggested
Interface version	interface_version	The version of the interface in use, and its speed. Example SATA 3.3 (600 MB/s)	String	suggested
Command set	command_set	The command set used for interfacing with the drive. Example ACS-3 Revision 5	String	suggested
APM?	apm	Whether the hard drive supports Advanced Power Management (APM). Example Yes	String	suggested
NCQ?	ncq	Whether the hard drive supports Native Command Queing (NCQ). Example Yes	String	required
AAM?	aam	Whether the hard drive supports Automatic Acoustic Management (AAM). Example No	String	suggested
TRIM?	trim	Whether the hard drive supports the TRIM command. Only specify "No" if the drive is SMR; leave blank otherwise. Example Yes	String	optional
SIE?	sie	Whether the hard drive model supports Sanitize Instant Erase (SIE). Default No Example Yes	String	optional
SED algorithm	sed	If supported, defines what algorithm the model uses for self-encryption. Specify "Unknown (supported)" if the drive does support self-encryption, but the algorithm used is not known. Leave blank if the drive does not support it at all. Default None Example AES-256	String	optional
SCTERC defaults	scterc	The default settings for SCTERC. Example Read: Disabled<br>Write: Disabled	String	suggested
Device Statistics?	statistics	Whether the device supports Device Statistics. Example Yes	String	required
Platter count	platters	Number of known platters in a hard drive model. Example 7	Number	suggested
Recording head count	heads	Number of recording heads in a hard drive model. Example 14	Number	suggested
Capacity per platter	capacity_per_platter	The amount of capacity stored on each platter. Example 1.43	Number	suggested
Capacity per platter unit	capacity_per_platter_unit	The two- or three- letter acronym for the capacity's unit. Case insensitive. Accepts all parameters that Template:Cache unit accepts. Accepts all parameters that Template:Cache unit accepts, but this should not be used with binary units normally. Example tb	String	suggested
Recording method	recording_method	The three, four or similar acronym for the recording. Case insensitive. Example cmr	String	suggested
Mean time to failure	mttf	Mean time to failure published by the manufacturer. Do not use crowd-sourced information such as ST3000DM001s all failing at low hour numbers. Default Not specified Example 600,000 hours	Number	suggested
Maximum load/unload cycles	max_load_cycles	Maximum load/unload cycle count published. Example 600,000	Number	suggested
Unrecoverable error rate	unrecoverable_error_rate	Unrecoverable error rate specified by the manufacturer. Use math when possible. Example <math>1</math> in <math>10^14</math> Auto value <math>1</math> in <math>10^14</math>	Content	suggested
KCC/MSIP ID	kcc	An identifier assigned by the KCC (Korean Communications Commission)/MSIP (Ministry for Science, ICT and Future Planning). Example R-R-T48-MG08ADA400N	String	suggested
KCC wikitext	kcc_wikitext	Custom wikitext to use for the KCC/MSIP ID parameter. By default, the infobox places the ID given in kcc into a wikilink; use this to disable it if that causes problems or to specify if the drive does not have a KCC or MSIP Authorization Number at all..	Unbalanced wikitext	optional
PCB part number(s)	pcb	The part numbers of all known PCBs used by this drive. Example G0066A	String	suggested
Date released	released	The year (add more precision if desired/known) the hard drive model was released. Example 2012	Date	suggested
Date discontinued	discontinued	The year (add more precision if desired/known) the model was discontinued. Example 2017	Date	optional
Force categorisation	force_cat	Force automatic categorisation to be suppressed (-1) or always show (1). Leave blank or use any other value to automatically categorise only in mainspace. Example -1	Number	optional