A10/Template:NFC data

From linux-sunxi.org
< A10
Jump to navigation Jump to search


Introduction to this page

The data contained in this template is slowly replacing the collection of tables in the DVB-T_USB Devices article.

The main purpose is to collect the available information on devices that now is scattered around on device/chipset/driver pages, and at the same time make it accessible from all those places. Having a "single copy" will hopefully ease updating information on devices and drivers.

How do I add a new device?

Sticky-note-pin.png Hints: Go to your my preferences page (visible on the top row of every page when you are logged in). Click on the Editing tab and make sure you have checked the Enable section editing via [edit] links option. Also select an adequate size for your editing window (I use 80x25) and maybe activate the Widen the edit box to fill the entire screen option.

First open two more browser tabs. One tab with this page, so that you can read up on the instructions while you are editing, and one tap with DVB-T_USB_Devices_ListData/Helper, a reference page where there is a List of all the devices that are stored on this page. There you can check on how data will be shown in the tables.

Second identify a section where your device would fit in. This is not technically needed but it will help you when using an existing device as template for your new device.

Click on the [edit] link on the right of that section's title.

Look at the data of a device that is already there, and look at the reference page and the instructions to make sure you understand what the fields mean and where they show up.

Now either copy an existing device's data or copy the cut'n paste template from the instructions and fill in your device's data.

The most important field is the did as it will allow you to select that specific device on your device page. Having the did repeated in the subsection header will allow your browser to jump to the right place if you click the edit icon in a table.

Sticky-note-pin.png Note: If you edit the data below, you may have to outsmart your browser-cache and the rendering cache of the wiki. Otherwise your changes might not appear in the table renderings.

How do I show the data on a Device/Vendor/... page ?

Sticky-note-pin.png Note: The mental crutch that I use to visualize the data in my head is a simple spread sheet with one row per device and one column per property (like Vendor, Name, support status ...).

Keeping all the information in one place of course means that there will be lots of details that most users don't care about. Using some minor template voodoo, it is possible to select a limited subset of data fields per device and thus construct tables with a small subset of columns. If you think of it as a spread sheet you may have only a couple of columns shown. (Some examples are currently shown on HLPlayground2 (Warning: HUGE Page!..but look at how tiny the source is.))

Still, usually you will not want to have all the devices listed.

With some more template voodoo and the help of the ParserFunctions/StringFunctions extension it is possible to select subsets of the data by their content. Think of it as only showing rows in your spread sheet if they contain certain elements. E.g. Only show devices that use a certain tuner or only show devices by a certain vendor. ( If you are interested in the Details, go to Template:List of Device List Templates )

Some examples are currently shown on HLPlayground2/rowselection and HLPlayground2/doubleselection and in the next section...

Usage Examples on device pages

Low detail:

{{Device_List_Low_Detail/Header
| content = 
{{USB_Device_Data
|renderwith=Device_List_Low_Detail/Row
|selatt1=did
|selval1=msi-digivox-mini-ii-v3
}}
}}

Sticky-note-pin.png Note: As you can see did is set as selection attribute and msi-digivox-mini-ii-v3 as selection value. This used to be a simple device but the vendor started selling a completely different device with the same name and a different USB ID. We changed the existing device's did by appending the USB ID and since the selection is done by searching for a substring, that table above will now produce both, the old and the new device. Neat, isn't it?

If you want to show some more detail you can change Low to Medium in both template names. (The /Header and /Row template.)

{{Device_List_Medium_Detail/Header
| content = 
{{USB_Device_Data
|renderwith=Device_List_Medium_Detail/Row
|selatt1=did
|selval1=msi-digivox-mini-ii-v3
}}
}}

There is also a set of templates for Full details if you want to get the fields that are meant for filtering only, like the did field itself.

Syntax and Semantics

Here is a cut'n paste template for new devices. (Don't forget use the same XxXxXxXxXxXxX in all three places.)

</includeonly><noinclude>
==== XxXxXxXxXxXxX ====
{{DeviceDisplayMedium|XxXxXxXxXxXxX}}
</noinclude><includeonly>
{{{{{renderwith}}}|src=USB_Device_Data|selatt1={{{selatt1|}}}|selval1={{{selval1|}}}|selatt2={{{selatt2|}}}|selval2={{{selval2|}}}|selatt3={{{selatt3|}}}|selval3={{{selval3|}}}|selatt4={{{selatt4|}}}|selval4={{{selval4|}}}
| did=XxXxXxXxXxXxX
| vendor=
| device=
| standard=
| supported=
| pic=
| url=
| hostinterface=
| usbid=
| hw=
| tuner=
| demodulator=
| usbbridge=
| fw=
| comment=
}}

regid a register ID that makes it possible to render just this one register in a table and to jump directly to the device on this page. As matching in the selection templates is done on substrings you need to make sure that the regid's are unique and disjoint. Also try to only use uppercase letters, numbers, the underscore "_" and the dash "-". The regdid is not meant to be shown to average reading-only users of the wiki but rather be used by editors. So we can dispense with nice form and concentrate on function
   NFC_CTL 
bit the device manufacturer/vendor. E.g. Hauppauge. Feel free to make it a link to the vendor page in the wiki. E.g. by writing
   [[Hauppauge]] 
size the device name. E.g. Cinergy T XXS. This is also the place to put a link to a device page. Since most device pages contain the vendor in the page title, you may have to give the page title and the device name separately like this
   [[TerraTec Cinergy T USB XXS|Cinergy T XXS]] 
access the broadcasting standard or standards that the device supports E.g. Possible values would be the analog encodings "ANALOG-PAL" "ANALOG-NTSC" "ANALOG-SECAM" as well as digital encodings "DVB-T" "DVB-C" "DVB-C2" "DVB-S" "DVB-S2" "DVB-H" "DVB-SH" "ATSC" "ATSC-M/H" "ISDB-S" "ISDB-T" "1seg" "ISDB-C" "SBTVD/ISDB-Tb" "DMB-T/H" "ADTB-T" "CMMB" "DMB-T" "T-DMB" "S-DMB" "MediaFLO". Even "FM-RADIO" and "AM-RADIO" could be included in this list.

Im most cases however it will simply be

   DVB-T 
default support status.
   {{yes}} or {{no}} 
desc human readable descriptions. if those comments stretch several lines, it is time to make a device page. :-)

Data

Click on Edit to see the data.


NFC_CTL

The data for the register NFC_CTL is right here. You just can't see it because it is meant to be used in a template 'transclusion'. If you are logged in you can click on the [edit] link to the right to change the data for this register. If you are not logged in, you can click on the view source tab at the top of this page to at least see how data is stored here.

It's probably best if you open the edit link in a separate tab. That way you can use this tab to read the explanation of the syntax above or jump back to the place where you came from and see how your changes look there. (Don't forget that your browser cache or the wiki's rendering cache might need some time or persuasion to catch up with the new content.)