guidelines on how to compile a hardware device page

[p]In order to compile a hardware device please follow these instructions:[/p]

[h1]kernel version[/h1]

[p]If you have tested the device with more than one distribution please specify the oldest kernel version (among the ones of those distributions)[/p]

[h1]vendorid:productid code[/h1]

[p]please do not forget to insert the vendorid:productid code since it is used to find a device in the search page.[/p]
[p]
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]