Template:Asic: Difference between revisions
TheRealSteve (talk | contribs) |
TheRealSteve (talk | contribs) |
||
Line 83: | Line 83: | ||
http://www.mediawiki.org/wiki/Help_talk:Templates#Gallery_In_a_Template | http://www.mediawiki.org/wiki/Help_talk:Templates#Gallery_In_a_Template | ||
--> | --> | ||
<div style="float:left;">[[{{ns:file}}:{{#explode:{{#explode:{{{pics}}}|,|0}}|:|0}}|frameless|{{#explode:{{#explode:{{{pics}}}|,|0}}|:|1}}]]{{#explode:{{#explode:{{{pics}}}|,|0}}|:|1}}</div> | <div> | ||
<div style="float:left;">[[{{ns:file}}:{{#explode:{{#explode:{{{pics}}}|,|1}}|:|0}}|frameless|{{#explode:{{#explode:{{{pics}}}|,|1}}|:|1}}]]{{#explode:{{#explode:{{{pics}}}|,|1}}|:|1}}</div> | <div style="float:left;">[[{{ns:file}}:{{#explode:{{#explode:{{{pics}}}|,|0}}|:|0}}|frameless|{{#explode:{{#explode:{{{pics}}}|,|0}}|:|1}}]]<br />{{#explode:{{#explode:{{{pics}}}|,|0}}|:|1}}</div> | ||
<div style="float:left;">[[{{ns:file}}:{{#explode:{{#explode:{{{pics}}}|,|2}}|:|0}}|frameless|{{#explode:{{#explode:{{{pics}}}|,|2}}|:|1}}]]{{#explode:{{#explode:{{{pics}}}|,|2}}|:|1}}</div> | <div style="float:left;">[[{{ns:file}}:{{#explode:{{#explode:{{{pics}}}|,|1}}|:|0}}|frameless|{{#explode:{{#explode:{{{pics}}}|,|1}}|:|1}}]]<br />{{#explode:{{#explode:{{{pics}}}|,|1}}|:|1}}</div> | ||
<div style="float:left;">[[{{ns:file}}:{{#explode:{{#explode:{{{pics}}}|,|3}}|:|0}}|frameless|{{#explode:{{#explode:{{{pics}}}|,|3}}|:|1}}]]{{#explode:{{#explode:{{{pics}}}|,|3}}|:|1}}</div> | <div style="float:left;">[[{{ns:file}}:{{#explode:{{#explode:{{{pics}}}|,|2}}|:|0}}|frameless|{{#explode:{{#explode:{{{pics}}}|,|2}}|:|1}}]]<br />{{#explode:{{#explode:{{{pics}}}|,|2}}|:|1}}</div> | ||
<div style="float:left;">[[{{ns:file}}:{{#explode:{{#explode:{{{pics}}}|,|3}}|:|0}}|frameless|{{#explode:{{#explode:{{{pics}}}|,|3}}|:|1}}]]<br />{{#explode:{{#explode:{{{pics}}}|,|3}}|:|1}}</div> | |||
</div> | |||
<!-- </gallery> --> | <!-- </gallery> --> | ||
Revision as of 12:09, 21 February 2015
Template test invocation
dev.name = Avalon
dev.web = http://www.example.com/
dev.logo = Logo-A.png
Avalonwww
codevs = alpha,beta,gamma,delta
chip.name = Blockerator 2000
chip.web = http://www.example.com/Blockerator2k/
chip.date = June 20th 2014
chip.datasheet = http://www.example.com/Blockerator2k/b2k.pdf
chip.bct = https://bitcointalk.org/index.php?topic=1.msg2#msg2
wwwBCT
Introduced: 2014-Jun-20 datasheet
pics[0].file = Lv BCorg 128px.png
pics[0].caption = Top
pics[1].file = WeLv BC 48px.png
pics[1].caption = Bottom
pics[2].file =
pics[2].caption =
pics[3].file =
pics[3].caption =
mining[0] = 200Gh:0.82J@0.78V:175Hz
mining[1] = 228Gh:0.82J@0.78V:200Hz
mining[2] =
mining[3] =
mining[0].Gh:J = 200Gh:0.82J
mining[0].Gh = 200
mining[0].J = 0.82
mining[0].V:Hz = 0.78V:175Hz
mining[0].V = 0.78
mining[0].Hz = 175
mining[0]:W: 164
mining[0]:Gh/J: 1.22
mining[0]:Gh/Hz: 1.14
die.foundry = TSMC
die.node = 55nm
die.topology = full custom
die.size = 3x3mm
die.size:lc = 3x3mm
die:WxL = 3x3
die:W = 3
die:L = 3
die:surfacearea = 9mm²
die:Gh/mm² = 22.22
package.type = QFN32
package.size = 10x10mm
package.markings = BTC2000 / [date code] / [lot #]
datecodes = 4713,4813,4913
notes = This is a template test
sources = All the things[1],Except this link[2]
showmissing = 0
showsources = 0
Extremely preliminary ASIC chip details template.
Template
dev.name = {{{dev}}}
dev.web =
dev.logo =
{{{dev}}}
codevs = {{{codevs}}}
chip.name = {{{chip}}}
chip.web =
chip.date =
chip.datasheet =
chip.bct =
No introduction date known
pics[0].file = {{{pics}}}
pics[0].caption =
pics[1].file =
pics[1].caption =
pics[2].file =
pics[2].caption =
pics[3].file =
pics[3].caption =
mining[0] = {{{mining}}}
mining[1] =
mining[2] =
mining[3] =
mining[0].Gh:J = {{{mining}}}
mining[0].Gh = {{{mining}}}
mining[0].J =
mining[0].V:Hz =
mining[0].V =
mining[0].Hz =
mining[0]:W: Expression error: Unrecognized punctuation character "{".
mining[0]:Gh/J:
mining[0]:Gh/Hz: Expression error: Unrecognized punctuation character "{".
die.foundry = {{{die}}}
die.node =
die.topology =
die.size =
die.size:lc =
die:WxL =
die:W =
die:L =
die:surfacearea = Expression error: Unexpected * operator.mm²
die:Gh/mm² = Expression error: Unrecognized punctuation character "{".
package.type = {{{package}}}
package.size =
package.markings =
datecodes = {{{datecodes}}}
notes = {{{notes}}}
sources = {{{sources}}}
showmissing = {{{showmissing}}}
showsources = {{{showsources}}}
NOTE: There is not much here but test code. Do not use this template yet.
Preliminary overview
Template to be used for ASIC chip details - e.g. developer, hashing specs, process, media.
The reason for using a template rather than a whole bunch of copy/paste scenarios is that it makes it easier to use it across different pages - e.g. entries in a list of ASICs, summary/sidebar entries on a developer's page, full entries on the page for the chip itself (if applicable - currently only Avalon seem to be using this) - and to vary presentation/update to more standards-compliant output as time goes along.
To do
- All the logic that actually outputs the above based on provided parameters
Not to do
Things that shouldn't be included in this template (and should be noted on the ASICs page instead):
- Gen / Generation labels. These mean different things to different people and is ultimately fluff.
- temperature specs. Drop the chips in liquid nitrogen and hey presto - i.e. temperature is fluff for asic specs and should be reserved for miners.
- Cores count. The number of cores is moot unless each manufacturer uses the exact same design, number of stages per core, etc. Despite plenty of commonality, implementations do differ enough that the concept of a 'core' is difficult at best to use as a distinguishing feature.
Usage
This is a relatively straight forward wiki template and many of the notes about using templates apply here.
This template only uses named parameters. Some of these parameters take multiple values, delimited by a comma, which should be treated as anonymous parameters - i.e. the order in which you specify them determines which sub-parameter you specify a value for.
As an example, the named parameter dev takes three values, name, web and logo, in that order; dev=name,web,logo
. These sub-parameters are referenced as 'dev.name and dev.web in this documentation.
Note: Whenever an arbitrary string contains a comma, you must encode it as ,. E.g. dev=Company, Inc.,http://www.example.com/
.
Visual guide
The following table serves as a visual guide, showing which parameter is inserted at which location in the output.
[dev.logo][dev.name][dev.web] [codevs] | [chip.name][chip.web] [chip.bct] Introduced: [chip.date] [chip.datasheet] |
[pics](1) [pics](2) [pics](3) [pics](4)
|
Mining specifications: [mining](1-4) |
Foundry: [die.foundry] Die: [die.size] @ [die.node]nm Package: [package.type] [package.size] Markings: [package.markings] Known date codes: [datecodes] |
|
Additional notes: [notes] | ||
Miners using this chip: [miners] | ||
Sources: [sources] (only shown if showsources=1 is set) |
Template template
Although straight forward, this template does have quite a few parameters. If you've already familiarized yourself with the parameters and their meaning, the following template template can help; just copy/paste and adjust values as appropriate.
{{asic | dev=name,web,logo | codevs=list | chip=name,web,date,datasheet,bct | pics=list(4) | mining=Gh:J@V:Hz list(4) | die=foundry,node,topology,size | package=type,size,markings | datecodes=list | notes=string | sources=string | showmissing=0/1 | showsources=0/1}}
Parameters
Parameter | Description |
---|---|
dev | Details about the primary developer of the ASIC. required multiple value parameter syntax: dev=[Company, Inc.],http://www.example.com/,logo-company_inc.png |
dev.name | Name of the primary developer. Can be a [wiki link] if the company has a page on the wiki. Note that if the name contains any commas, these should be replaced with the HTML encoded version , required string |
dev.web | Website of the primary developer. optional non-wiki link string |
dev.logo | Developer's logo. If possible, source this from the company's wiki page. If they don't have one, this would be a good excuse to make one! Otherwise, upload an image and reference simply as filename.extension optional wiki picture filename |
codevs | Names of co-developers. An example of a co-developer is an ASIC design/finishing/proofing house or a facilitator between the primary developer and the foundry. optional comma separated list of strings syntax: codevs=A6 LLC |
chip | Non-technical details of the chip required multiple value parameter syntax: chip=Blockerator 2000,http://www.example.com/destructor2k/,June 20th 2014,,https://bitcointalk.org/index.php?topic=1.msg2#msg2 |
chip.name | (Code) Name of the chip. Many developers will name their chip or use a part code as a reference. If no such name can be found, the chip may be used exclusively in a particular line of miners, which do have a name, and that name can be used instead. Otherwise, leave blank. optional, string, defaults to unknown |
chip.web | Website with information about the chip. This can be a forum thread/post but should not be a BitcoinTalk thread. See chip.bct instead. optional non-wiki link string |
chip.date | Introduction date of the chip. This can often be difficult to assess as the chip goes through various stages of development before it goes to market. If possible, find the tape-out date. If this can't be found, try to find when it was first introduced to market, e.g. in an announcement, press coverage, etc. Alternatively, if the chip package has a date code that precedes that introduction, use the date code as a basis instead. If no exact date is known, year/month will suffice . optional date string (no commas) |
chip.datasheet | Links to the chip's datasheet(s) and/or significant resource(s) of technical information, if available. optional comma separated list of link strings. |
chip.bct | BitcoinTalk thread/post with information and/or discussion about the chip. optional non-wiki link string to the BitcoinTalk forum. |
pics | Pictures to be included in the template, typically of the top and bottom of the chip and optionally die and/or design photos (up to 4 pictures total) along with simple captions that may include links to further media along the same lines (e.g. Top, [http://www.example.com/media/destructor2k Die shots]) in the following structure: filename.extension:caption optional comma separated list of up to four media structures |
mining | Specifications of the chip's Bitcoin hashing performance. Hashing performance of a typical chip is a complex issue with multiple variables. The most common two variables are core voltage and core frequency. Combined, these affect both the hash rate and the power consumption. To enforce per-setting parity for these values, they must be specified as any permutation of the following structure: mining=<Gh:J@V:Hz Where Gh is the hash rate, J is Joules/Ghash, V is the core voltage and Hz is the core frequency. The leading < can be used if a J/Gh rating is derived from at-the-wall power consumption of a miner in case there is no information on the chip. At-the-wall power consumption is always greater than that of the chip due to losses in the power supply, voltage regulators on the board, and losses in auxiliary circuitry. Trailing units may be specified for clarity but will not be used to determine how to interpret the data. For example, you could specify only the hash rate ( If more than one structure is provided, each will be included in the template separately up to a maximum of 4. This allows for minimum and maximum power consumption figures, and minimum and maximum hash rates (if not coinciding with the power consumption figures). Further values, e.g. to demonstrate non-linearity, are outside the scope of this template and should ideally be noted in a chip's datasheet. Important: If you do not have exact figures but have values from which to roughly calculate them, such as from a complete miner's specification, you can enter a mathematical expression. For example, if you know that a miner is advertised as being 800Ghash/s, and a picture tells you that it has 12 chips, you can use
|
die | Technical data about the chip die itself. optional multiple value parameter syntax: die=TSMC,28nm,full custom,3.5x3.5 |
die.foundry | The foundry that produced the chip wafers. Typically this will be one of TSMC, Global Foundries, UMC, or SMIC, but there are other foundries especially for older node sizes. optional string |
die.node | Node size. This should be specified in nanometers (nm) and may include the 'nm' suffix for clarity. Sizes should not be specified in µm. optional string |
die.topology | The topology of the chip. This can be difficult to ascertain as many manufacturers won't say, or rely on multiple technologies. This value will typically be one of hard copy, full custom or gate array. hard copy generally refers to an FPGA design that was turned into an ASIC by path of least resistance; letting software solve it. full custom may include a custom designed core but with placing and routing automated. optional string |
die.size | Physical size of the die, expressed in millimeters length'xwidth and may include the 'mm' suffix for clarity, e.g. 4x4mm optional dimensions string |
package | Details of the package used for the chip. optional multiple value parameter syntax: package=QFN,8x8mm,BTC2000 / [date code] / [lot #] |
package.type | The package type and pin count used for the chip. This will typically be one of QFN, BGA or FCBGA, followed by the number of pins. The number of pins on some packages can be difficult to determine. For example, a BGA may exist of 32 rows and 32 columns, but have its corner pins removed, or the shadow area under the die may not have any pins at all. When the pin count varies wildly from what a simple rows * columns calculation would provide, use the rows * columns calculation, append an asterisk (in this example, BGA1024*, and if possible supply media showing the pins on the chip more clearly in the media parameter if not already specified. optional string |
package.size | Physical size of the package's board presence without any leads - i.e. just the dimensions of the (plastic / ceramic) package - expressed in millimeters length'xwidth and may include the 'mm' suffix for clarity, e.g. 9x9mm optional dimensions string |
package.markings | Plaintext transcription of the markings on the package, excluding pin 1 indication markers. New lines should be substituted by / (space before and after the slash character). Bare packages should have their markings specified as 'none'. optional string |
datecodes | A list of date codes found in the wild. Date codes can help establish manufacturing runs. Typical date codes exist of a week number and a year, both as two digits, together. However, more complex date codes exist and if in use may not be easy to decipher without a datasheet. optional comma separated list of strings syntax: 3913,4013,4113 |
notes | Any additional notes that should be added. This may include trivia (back story behind a name, for example), specifications not yet addressed in the template, or anything else you feel may be of interest. optional string syntax: notes=The Blockerator 2000 doesn't actually exist. |
miners | A (non-exhaustive) list of miners that use this particular chip. These miners may be [wiki linked] or plain linked if there is information on the particular miner available. However, this should absolutely not be used to refer to miners that do not (yet) exist. As with the entirety of the wiki, it is not advertising space. optional list of comma separated strings syntax: miners=Blockerator 2K,Blockerator2K1 |
sources | A list of sources. In order to prevent a link cloud or link clutter, while acknowledging the need to prevent [citation needed], this parameter should be used to list your sources. Anybody interested in checking where information came from can then put in the small effort to find it. optional list of comma separated source citations. syntax: sources=all the things: thin air (original research) |
showmissing | Highlights missing data. If you're working on a page that includes this template and aren't sure which pieces of information you may still have to find, setting this parameter to 1 will highlight them in the output. optional boolean 0|1 syntax: showmissing=1 |
showsources | Adds the citations below the template output. If the page has a <references /> tag, they will then be listed there. optional boolean 0|1 syntax: showsources=1 |
References
- ↑ thin air
- ↑ http://www.example.com/