lineamientos para compilar la página de un dispositivo

[p]Para compilar un dispositivo de hardware por favor siga las siguientes instrucciones:[/p]

[p]También puede estar interesado en la lectura de [a]http://www.h-node.com/help/index/en#discover-hardware|de esta página de ayuda[/a][/p]

[p]Estas son las entradas que encontrará dentro de las páginas para insertar/actualizar.[/p]

[h1]Nombre del proveedor[/h1]

[h2]En el caso de laptops[/h2]

[p]En el caso de laptops tiene que insertar el nombre del proveedor al escogerlo de una lista de proveedores permitidos[/p]

[h2]En el caso de otros dispositivos[/h2]

[p]Si el dispositivo no es una laptop no tiene que insertar el nombre del proveedor, este es obtenido automaticamente del código vendorid que haya encontrado dentro de la entrada [b]vendorid:productid[/b] (ver abajo).[/p]

[p]Si el proveedor no es encontrado en la lista de los proveedores conocidos el sistema le pedirá al usuario agregar una incidencia ([b][i]issue[/i][/b]) para solicitar la introducción del nuevo vendor/vendorid.[/p]

[p]La lista de proveedores ha sido tomada del repositorio [a]http://pciids.sourceforge.net/|PCI ID[/a] y del repositorio [a]http://www.linux-usb.org/usb-ids.html|USB ID[/a]. Puede ver la [[list of the vendor id|lista de id de proveedores]] actuales[/p]

[h1]El nombre del modelo[/h1]

[p]Dentro de esta entrada tiene que escribir el [b]nombre[/b] del dispositivo (como esta impreso en el dispositivo mismo o el nombre indicado por la orden lspci)[/p]

[p]De modo que se pueda recolectar la mayor información posible, por favor use el siguiente formato cuando llene la entrada correspondiente al modelo:[/p]

[code]%nombre del proveedor% %nombre del modelo% %revisión del modelo [i]si esta presente[/i]% [/code]

[p]Donde %[b]nombre del proveedor[/b]% es el proveedor como este impreso en el dispositivo mismo (o escrito en la caja del disposiitivo) y no el indicado por la orden lspci (si existen diferentes).[/p]

[p]Como se menciona anteriormente, (si el dispositivo no es una laptop) el nombre del proveedor se obtiene automaticamente del código [b]vendorid:productid[/b]que ha introducido. Sin embargo, el nombre del proveedor es en ocasiones diferente del nombre del proveedor impreso en el dispositivo mismo (podría ser, como ejemplo, el chipset del proveedor, y no el dispositivo del proveedor, o el dispositivo pudo ser provisto por un tercero en algunos paises). Por este motivo es útil el indicar tambien el nombre del proveedor (como esta impreso en el dispositivo) dentro de la entrada del modelo (antes del nombre del modelo).[/p]

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

[h1]versión [h1]Versión de kernel[/h1]

[p]Si ha probado el dispositivo con mas de una distribución por favor especifíque la versión del kernel (entre los existentes de dichas distribuciones) de acuerdo a las siguientes directrices:[/p]
[list]
[*] si el dispositivo funciona elija la versión más antigua del kernel[/*]
[*] si el dispositivo [b]no[/b] funciona elija la versión más nueva del kernel[/*]
[/list]

[h1]vendorid:productid code[/h1]

[p]The vendorid:productid code 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]

[h1]description entry[/h1] [h1]Entrada de descripción[/h1]

[h2]if the device is a notebook[/h2] [h2]si el dipositivo es una laptop[/h2]

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

[list]
[*] Number of cores[/*] Número de proccesadores[/*]
[*] Modelo del CPU model using the obtenido de la orden [b]/proc/cpuinfo[/b] command (write it inside the [b]code[/b] tag)[/*] (escribalo dentro de una etiqueta [b]code[/b])[/*]
[*] specify if the clock frequency changing is supported or not[/*] especifique si el cambio en la frecuencia puede ser cambiada o no[/*]
[*] specify if the fan is included and if its frequency can be changed[/*] especifique si el ventilador esta incluido y si su frecuencia puede ser cambiada[/*]
[/list]

[lang]
[[guidelines on how to compile a hardware device page|English]]
[/lang]