Differenze tra la revisione del 21:19, 12 settembre 2014, creata da TryHardDieHard, e la revisione del 03:54, 11 settembre 2014
Nota: il testo in rosso è stato cancellato dalla revisione precedente, il testo in verde è stato aggiunto in questa revisione e il testo in grigio non è stato cambiato
differenze nel campo: il titolo
Guidelines on how to compile a hardware device page
differenze nel campo: il testo della pagina
[p]In order to compile a hardware device please follow the instructions on this page. You could also be interested in reading [[Discover your hardware|this]] help page which gives very specific instructions on how to get detailed information about your hardware.[/p]

[p]These are the entries you will find inside the inserting/updating pages:[/p]

__TOC__

[h1]Model name[/h1]

[p]Inside this entry you have to write the [b]name[/b] of the device as listed by the [b]lspci[/b] (if it is a PCI device) or [b]lsusb[/b] (if it is a USB device) commands. Please read [a]http://h-node.org/wiki/page/en/Discover-your-hardware|this guide[/a] to learn how to find it.[/p]

[h1]Possible other names of the device[/h1]

[p]In order to collect as more information as possible, please add inside this entry the name of the device [b]as printed on the device itself[/b] or [b]on the device box[/b], or [b]the name used by the shop[/b] that have sold that device to you. Add it only if it is different from the name already inserted inside the [i]model name entry[/i][/p]

[p]When inserting a new name inside this entry please use the format listed below[/p]

[code]%vendor name% %device name%[/code]

[p]where %[b]vendor name[/b]% and %[b]device name[/b]% are the vendor and the name as printed on the device itself (or written on the device box) and not the one indicated by the lspci command.[/p]

[p]In this way a user that is searching for a device has more possibilities to find it: using the name as indicated on the box or on the device or as listed in a online store or in a shop, or using the name indicated by the lspci or lsusb command.[/p]

[h1]Vendor name[/h1]

[h2]In case of notebooks[/h2]

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

[h2]In case of other devices[/h2]

[p]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 [b]vendorid:productid[/b] entry (see below).[/p]

[p]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.[/p]

[p]The vendor list has been taken from the [a]http://pciids.sourceforge.net/|PCI ID[/a] repository and from the [a]http://www.linux-usb.org/usb-ids.html|USB ID repository[/a]. You can see the [[list of the vendor id]] inserted[/p]

[h1]Does the device prevent the installation of wifi cards not-approved by the vendor?[/h1]

[p]to do[/p]

[h1]Kernel version[/h1]

[p]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:[/p]
[list]
[*] if the device works choose the oldest kernel (with which the device works)[/*]
[*] if the device does not work choose the newest kernel[/*]
[/list]

[h1]vendorid:productid[/h1]

[p]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[/p]

[h2]How to find the [b]vendorid:productid[/b] code[/h2]

[p](Thanks [a]http://trisquel.info/en/forum/h-nodecom-new-website-hardware-database#comment-5839|Michał Masłowski[/a] and [a]http://trisquel.info/en/forum/h-nodecom-new-website-hardware-database#comment-5837|Julius22[/a])[/p]

[h3]If the device is integrated (example: a video card)[/h3]

[p]Open a terminal and type the following command:[/p]

[code]sudo lspci -nnk[/code]


[p]You should obtain a list of hardware similar to the one written below[/p]

[code]
03:00.0 Network controller [0280]: Broadcom Corporation BCM4311 802.11b/g WLAN [ [b]14e4:4311[/b] ] (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] [ [b]10de:0427[/b] ] (rev a1)
Kernel modules: nouveau, nvidiafb
[/code]


[p]The strings in [b]bold[/b] 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 [b]14e4:4311[/b] while the VendorID:ProductID code of the video card (note the string "VGA") is [b]10de:0427[/b][/p]

[h3]If the device is an USB device (example: an external USB wifi card)[/h3]

[p]Open a terminal and type the following command:[/p]

[code]sudo lsusb[/code]


[p]You should obtain a list of hardware similar to the one written below[/p]

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


[p]The strings in [b]bold[/b] (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 [b]0846:4260[/b][/p]

[h1]Description[/h1]

[h2]In case of notebook[/h2]

[p]Below is a brief list of what could be specified inside the description entry:[/p]

[list]
[*] Number of cores[/*]
[*] CPU model using the [b]/proc/cpuinfo[/b] command (write it inside the [b]code[/b] tag)[/*]
[*] specify if the clock frequency changing is supported or not[/*]
[*] specify if the fan is included and if its frequency can be changed[/*]
[/list]

List the outputs of the lsusb, lspci, and lscpu commands like the examples below:

[h3]~$ lsusb [/h3]
[code]Bus 002 Device 002: ID 8087:0024 Intel Corp. Integrated Rate Matching Hub
Bus 002 Device 001: ID 1d6b:0002 Linux Foundation 2.0 root hub
Bus 001 Device 004: ID 04f2:b217 Chicony Electronics Co., Ltd Lenovo Integrated Camera (0.3MP)
Bus 001 Device 003: ID 147e:2016 Upek Biometric Touchchip/Touchstrip Fingerprint Sensor
Bus 001 Device 002: ID 8087:0024 Intel Corp. Integrated Rate Matching Hub
Bus 001 Device 001: ID 1d6b:0002 Linux Foundation 2.0 root hub[/code]

[h3]~$ lspci [/h3]
[code]00:00.0 Host bridge: Intel Corporation 2nd Generation Core Processor Family DRAM Controller (rev 09)
00:02.0 VGA compatible controller: Intel Corporation 2nd Generation Core Processor Family Integrated Graphics Controller (rev 09)
00:16.0 Communication controller: Intel Corporation 6 Series/C200 Series Chipset Family MEI Controller #1 (rev 04)
00:19.0 Ethernet controller: Intel Corporation 82579LM Gigabit Network Connection (rev 04)
00:1a.0 USB controller: Intel Corporation 6 Series/C200 Series Chipset Family USB Enhanced Host Controller #2 (rev 04)
00:1b.0 Audio device: Intel Corporation 6 Series/C200 Series Chipset Family High Definition Audio Controller (rev 04)
00:1c.0 PCI bridge: Intel Corporation 6 Series/C200 Series Chipset Family PCI Express Root Port 1 (rev b4)
00:1c.1 PCI bridge: Intel Corporation 6 Series/C200 Series Chipset Family PCI Express Root Port 2 (rev b4)
00:1c.3 PCI bridge: Intel Corporation 6 Series/C200 Series Chipset Family PCI Express Root Port 4 (rev b4)
00:1c.4 PCI bridge: Intel Corporation 6 Series/C200 Series Chipset Family PCI Express Root Port 5 (rev b4)
00:1d.0 USB controller: Intel Corporation 6 Series/C200 Series Chipset Family USB Enhanced Host Controller #1 (rev 04)
00:1f.0 ISA bridge: Intel Corporation QM67 Express Chipset Family LPC Controller (rev 04)
00:1f.2 SATA controller: Intel Corporation 6 Series/C200 Series Chipset Family 6 port SATA AHCI Controller (rev 04)
00:1f.3 SMBus: Intel Corporation 6 Series/C200 Series Chipset Family SMBus Controller (rev 04)
03:00.0 Network controller: Intel Corporation Centrino Advanced-N 6205 [Taylor Peak] (rev 34)
0d:00.0 System peripheral: Ricoh Co Ltd MMC/SD Host Controller (rev 07)[/code]

[h3]~$ lscpu[/h3]
[code]Architecture: x86_64
CPU op-mode(s): 32-bit, 64-bit
Byte Order: Little Endian
CPU(s): 4
On-line CPU(s) list: 0-3
Thread(s) per core: 2
Core(s) per socket: 2
Socket(s): 1
NUMA node(s): 1
Vendor ID: GenuineIntel
CPU family: 6
Model: 42
Stepping: 7
CPU MHz: 908.593
BogoMIPS: 4983.87
Virtualization: VT-x
L1d cache: 32K
L1i cache: 32K
L2 cache: 256K
L3 cache: 3072K
NUMA node0 CPU(s): 0-3[/code]

[lang]
[[pautas para compilar la página de un dispositivo|Español]]
[/lang]
I contenuti di questa pagina sono di Pubblico Dominio. (leggi la pagina CC0 per informazioni dettagliate). Chiunque è libero di copiare, modificare, pubblicare, usare, vendere, o distribuire tale contenuto per qualsiasi fine, commerciale o non commerciale, e con ogni mezzo.
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