Revision of the wiki page pautas para compilar la página de un dispositivo
This is an old revision of this page, as edited by Ark74 at 09:56, 9 May 2011. It may differ significantly from the Current revision.
lineamientos para compilar la página de un dispositivo

Para compilar un dispositivo de hardware por favor siga las siguientes instrucciones:

También puede estar interesado en la lectura de de esta página de ayuda

These are the entries you will find inside the inserting/updating pages.

the vendor name
In the case of notebooks

In the case of notebooks you have to insert the vendor name of your notebook by choosing from a list of allowed vendors

In the case of other devices

If the device is not a notebook you don't have to insert the vendor name, it is automatically retrieved from the vendorid code you have inserted inside the vendorid:productid entry (see below).

If the vendor is not found in the list of known vendors the system ask the user to add an issue in order to ask the insertion of the new vendor/vendorid.

The vendor list has been taken from the PCI ID repository and from the USB ID repository. You can see the list of the vendor id inserted

the model name

Inside this entry you have to write the name of the device (as printed on the device itself or indicated by the lspci command)

In order to collect as more information as possible, please use the following format when you fill the model entry:

%vendor name% %model name% %model revision if present% 

where %vendor name% is the vendor as printed on the device itself (or written on the device box) and not the one indicated by the lspci command (if they are different).

As mentioned above, (if the device is not a notebook) the vendor name is automatically retrieved from the vendorid:productid code you have inserted. Anyway, the so obtained vendor name is sometimes different from the vendor name printed on the device itsel (it could be, for example, the chipset vendor, and not the device vendor, or the device could have been sold by a reseller in some countries). For this reason it is useful to indicate also the vendor name (as printer on the device itself) inside the model entry (before the model name).

In this way a user that is searching for a device has more possibilities to find it: using the name of the vendor as indicated on the box or on the device or as listed in a online store or in a shop, or using the vendor indicated by the lspci command or obtained from the vendorid code.

kernel version

If you have tested the device with more than one distribution please specify the kernel version (among the ones of those distributions) according to the following directives:

  • if the device works choose the oldest kernel
  • if the device does not work choose the newest kernel
vendorid:productid code

The vendorid:productid code is used to find a device in the search page.

Also, the system checks that a device with the same code is not present in the database. This is useful to avoid hardware duplication

How to find the vendorid:productid code

(Thanks Michał Masłowski and Julius22)

If the device is integrated (example: a video card)

Open a terminal and type the following command:

sudo lspci -nnk

You should obtain a list of hardware similar to the one written below

03:00.0 Network controller [0280]: Broadcom Corporation BCM4311 802.11b/g WLAN [ 14e4:4311 ] (rev 02)
	Kernel driver in use: b43-pci-bridge
	Kernel modules: ssb
05:00.0 VGA compatible controller [0300]: nVidia Corporation G86 [GeForce 8400M GS] [ 10de:0427 ] (rev a1)
	Kernel modules: nouveau, nvidiafb

The strings in bold and placed inside the square brackets (in the above list) are the code you are looking for. The first set of digits (before the colon) are the VendorID, the second set of digits are the ProductID. In the above example: the VendorID:ProductID code of the wifi card (note the strings "Network controller" and "WLAN") is 14e4:4311 while the VendorID:ProductID code of the video card (note the string "VGA") is 10de:0427

If the device is an USB device (example: an external USB wifi card)

Open a terminal and type the following command:

sudo lsusb

You should obtain a list of hardware similar to the one written below

Bus 001 Device 002: ID 0846:4260 NetGear, Inc. WG111v3 54 Mbps Wireless [realtek RTL8187B]
Bus 001 Device 001: ID 1d6b:0002 Linux Foundation 2.0 root hub
Bus 002 Device 003: ID 08ff:2580 AuthenTec, Inc. AES2501 Fingerprint Sensor

The strings in bold (in the above list) are the code you are looking for. The first set of digits (before the colon) are the VendorID, the second set of digits are the ProductID. In the above example: the VendorID:ProductID code of the external USB wifi card (note the strings "Wireless") is 0846:4260

description entry
if the device is a notebook

Below is a brief list of what could be specified inside the description entry:

  • Number of cores
  • CPU model using the /proc/cpuinfo command (write it inside the code tag)
  • specify if the clock frequency changing is supported or not
  • specify if the fan is included and if its frequency can be changed
The contents of this page are in the Public Domain. (see the CC0 page for detailed information). Anyone is free to copy, modify, publish, use, sell, or distribute the text for any purpose, commercial or non-commercial, and by any means.
h-node.org is a hardware database project. It runs the h-source PHP software, commit cdeda15, available under the GNU General Public (GPLv3) License.
JavaScript license information