Hardware Access/es: what changed
Revision 2 to 3. Removed lines have a minus sign; added lines have a plus sign.
| Old | New | Line | |
|---|---|---|---|
| 1 | - | ||
| 2 | - | ||
| 3 | - | ||
| 4 | - | ||
| 5 | - | ||
| 6 | - | ||
| 7 | - | ||
| 8 | - | ||
| 9 | - | ||
| 10 | - | ||
| 11 | - | ||
| 12 | - | ||
| 13 | - | ||
| 14 | - | ||
| 15 | - | ||
| 16 | - | ||
| 17 | 1 | ## Descripción | |
| 18 | 2 | ||
| 19 | - | ||
| 3 | + | Esta página es el comienzo de un tutorial que trata del acceso a dispositivos hardware. Estos dispositivos incluyen entre otros: ISA, PCI, USB, puerto paralelo, puerto serie, etc. | |
| 20 | 4 | ||
| 21 | - | ||
| 22 | - | ||
| 23 | - | ||
| 24 | - | ||
| 25 | - | ||
| 26 | - | ||
| 27 | - | ||
| 28 | - | ||
| 29 | - | ||
| 30 | - | ||
| 5 | + | El acceso a dispositivos hardware no esta implementado en la modalidad multiplataforma ni para el Runtime ni para el LCL de Free Pascal, por lo que este tutorial básicamente cubrirá los métodos de acceso a hardware en las diferentes plataformas. El código puede ser compilado en diferentes entornos utilizando compilaciones condicionales, como las siguientes: | |
| 6 | + | ||
| 7 | + | ``` pascal | |
| 8 | + | uses | |
| 9 | + | Classes, SysUtils, LResources, Forms, Controls, Graphics, Dialogs, ExtCtrls, | |
| 10 | + | {$IFDEF WIN32} | |
| 11 | + | Windows; | |
| 12 | + | {$ENDIF} | |
| 13 | + | {$IFDEF Unix} | |
| 14 | + | ports; | |
| 15 | + | {$ENDIF} | |
| 31 | 16 | ``` | |
| 32 | 17 | ||
| 33 | - | ||
| 18 | + | No se sabe todavía, hasta el momento, si MAC OS X/x86 permitirá el acceso hardware. Puede que lo permita, por lo que puede que con el tiempo aparezcan drivers como io.dll. | |
| 34 | 19 | ||
| 35 | 20 | ## Comparación entre serie y paralelo | |
| 36 | 21 | ||
| 37 | - | ||
| 22 | + | Las tarjetas ISA, PCI y el puerto paralelo se comunican con el ordenador utilizando un protocolo **paralelo**. El puerto serie y los dispositivos USB en cambio con un protocolo **serie**. Como tanto el procesador como todos los lenguajes de programación trabajan en una aproximación a datos en paralelo, el acceso a esta clase de protocolos es más fácil de implementar en la parte software. Por ejemplo, cuando se accede a una variable de tipo entero (Integer), es posible acceder a su valor asociado con un simple mandato. Con un protocolo serie, sin embargo, se puede conocer sólamente un bit en cada vez, y se hace necesario unir todos los bits para tener un dato con significado. | |
| 38 | 23 | ||
| 39 | - | ||
| 24 | + | La comunicación serie es difícil de implementar directamente, pero puede resultar razonablemente sencillo si se utiliza un componente prediseñado. También se bastante difícil en la parte hardware, por lo que algunos dispositivos utilizan Cirtuitos Integrados especializados o incluso Microcontroladores para implementarlo. | |
| 40 | 25 | ||
| 41 | - | ||
| 26 | + | A continuación se presenta una breve comparación de protocolos de acceso a hardware: | |
| 42 | 27 | ||
| 43 | - | ||
| 28 | + | | | Velocidad | Dificultad de implementación hardware | | |
| 29 | + | |----|:--:|:--:| | |
| 30 | + | | Puerto serie | Muy lenta (\< E5 bit/s) | Media | | |
| 31 | + | | Puerto Paralelo | Lenta (~ E6 bit/s) | Sencilla | | |
| 32 | + | | Tarjeta ISA | Media (~ E7 bit/s) | Media | | |
| 33 | + | | USB | Media (~ E7 bit/s) | Laboriosa | | |
| 34 | + | | Tarjeta PCI | Muy rápida (\> E9 bit/s) | Muy laboriosa | | |
| 44 | 35 | ||
| 45 | - | ||
| 46 | - | ||
| 47 | - | ||
| 48 | - | ||
| 49 | - | ||
| 50 | - | ||
| 51 | - | ||
| 52 | - | ||
| 53 | 36 | ## Comunicación Paralelo | |
| 54 | 37 | ||
| 55 | 38 | ### Usando inpout32.dll para Windows | |
| 56 | 39 | ||
| 57 | - | ||
| 40 | + | Windows tiene diferentes modos de acceder a los dispositivos hardware en las series 9x y NT. En las series 9x (95,98,Me) los programas pueden acceder al hardware directamente, al igual que se hacía en DOS. En las series NT (Windows NT y XP), no es posible tal acceso directamente, por lo que se hace necesario un driver de dispositivo que permita el acceso a los puertos como un mecanismo de seguridad. Esto ocasiona que el desarrollo de un driver implique un aumento significativo en costes y tiempo empleado. | |
| 58 | 41 | ||
| 59 | - | ||
| 42 | + | Afortunadamente existe una librería que resuelve este problema. Si se detecta un sistema con Windows NT se descomprime un controlador de dispositivo del kernel (HWInterface.sys) y lo instala, mientras que si detecta un sistema Windows 9x, entonces simplemente utiliza código en ensamblador para acceder al hardware. | |
| 60 | 43 | ||
| 61 | - | ||
| 44 | + | Pero, ¿Como utilizo esta librería?, ¡Simple!, tiene solamente dos funciones, Inp32 y Out32, y su uso es muy intuitivo. | |
| 62 | 45 | ||
| 63 | - | ||
| 64 | - | ||
| 65 | - | ||
| 66 | - | ||
| 67 | - | ||
| 46 | + | Cargaremos la libreria dinámicamente, por lo que definiremos ambas funciones primero: | |
| 47 | + | ||
| 48 | + | ``` pascal | |
| 49 | + | type | |
| 50 | + | TInp32 = function(Address: SmallInt): SmallInt; stdcall; | |
| 51 | + | TOut32 = procedure(Address: SmallInt; Data: SmallInt); stdcall; | |
| 68 | 52 | ``` | |
| 69 | 53 | ||
| 70 | - | ||
| 71 | - | ||
| 72 | - | ||
| 54 | + | - Address representa la dirección del puerto que se desea acceder | |
| 55 | + | - Out32 envía datos al puerto que se especifica como dirección (Address) | |
| 56 | + | - Inp32 retorna un byte desde el puerto que se especifica como dirección (Address) | |
| 73 | 57 | ||
| 74 | - | ||
| 75 | - | ||
| 76 | - | ||
| 77 | - | ||
| 78 | - | ||
| 79 | - | ||
| 80 | - | ||
| 81 | - | ||
| 82 | - | ||
| 83 | - | ||
| 84 | - | ||
| 85 | - | ||
| 86 | - | ||
| 87 | - | ||
| 88 | - | ||
| 89 | - | ||
| 90 | - | ||
| 91 | - | ||
| 92 | - | ||
| 93 | - | ||
| 94 | - | ||
| 95 | - | ||
| 96 | - | ||
| 97 | - | ||
| 98 | - | ||
| 99 | - | ||
| 100 | - | ||
| 101 | - | ||
| 102 | - | ||
| 58 | + | Ahora ya podemos cargar la librería. Esto puede implementarse en una sección como por ejemplo en el método OnCreate dentro del form principal: | |
| 103 | 59 | ||
| 104 | - | ||
| 105 | - | ||
| 106 | - | ||
| 107 | - | ||
| 108 | - | ||
| 109 | - | ||
| 110 | - | ||
| 111 | - | ||
| 60 | + | ``` pascal | |
| 61 | + | type | |
| 62 | + | TMyForm = class(TForm) | |
| 63 | + | ......... | |
| 64 | + | private | |
| 65 | + | { declaraciones privadas } | |
| 66 | + | Inpout32: THandle; { tipo manejador para el puerto } | |
| 67 | + | Inp32: TInp32; | |
| 68 | + | Out32: TOut32; | |
| 69 | + | ......... | |
| 70 | + | implementation | |
| 71 | + | ......... | |
| 72 | + | procedure TMyForm.FormCreate(Sender: TObject); | |
| 73 | + | begin | |
| 74 | + | {$IFDEF WIN32} | |
| 75 | + | Inpout32 := LoadLibrary('inpout32.dll'); | |
| 76 | + | if (Inpout32 <> 0) then | |
| 77 | + | begin | |
| 78 | + | // needs overtyping, plain Delphi's @Inp32 = GetProc... leads to compile errors | |
| 79 | + | Inp32 := TInp32(GetProcAddress(Inpout32, 'Inp32')); | |
| 80 | + | if (@Inp32 = nil) then Caption := 'Error'; | |
| 81 | + | Out32 := TOut32(GetProcAddress(Inpout32, 'Out32')); | |
| 82 | + | if (@Out32 = nil) then Caption := 'Error'; | |
| 83 | + | end | |
| 84 | + | else Caption := 'Error'; | |
| 85 | + | {$ENDIF} | |
| 86 | + | end; | |
| 112 | 87 | ``` | |
| 113 | 88 | ||
| 114 | - | ||
| 89 | + | Si se carga la librería en la sección OnCreate no se debe olvidar descargarlo en la sección OnDestroy: | |
| 90 | + | ||
| 91 | + | ``` pascal | |
| 92 | + | procedure TMyForm.FormDestroy(Sender: TObject); | |
| 93 | + | begin | |
| 94 | + | {$IFDEF WIN32} | |
| 95 | + | FreeLibrary(Inpout32); | |
| 96 | + | {$ENDIF} | |
| 97 | + | end; | |
| 115 | 98 | ``` | |
| 116 | - | ||
| 117 | - | ||
| 118 | - | ||
| 99 | + | ||
| 100 | + | Este es un simple ejemplo de como utilizar la función Inp32: | |
| 101 | + | ||
| 102 | + | ``` pascal | |
| 103 | + | {$IFDEF WIN32} | |
| 104 | + | myLabel.Caption := IntToStr(Inp32($0220)); | |
| 105 | + | {$ENDIF} | |
| 119 | 106 | ``` | |
| 120 | 107 | ||
| 121 | - | ||
| 108 | + | Este código ha sido testeado con una tarjeta ISA en el puerto \$0220, utilizando Lazarus 0.9.10 en Windows XP. Por supuesto es necesario tener Windows en la clausula uses para que funcione el código. Para el desarrollo solamente necesitas incluir "input32.dll" en el mismo directorio en que se encuentra la aplicación. | |
| 122 | 109 | ||
| 123 | - | ||
| 110 | + | La página principal de esta librería se encuentra en: [www.logix4u.net/inpout32.htm](http://www.logix4u.net/inpout32.htm) *ver discusión* | |
| 124 | 111 | ||
| 125 | 112 | ### Using assembler on Windows 9x | |
| 126 | 113 | ||
| 127 | - | ||
| 128 | - | ||
| 129 | - | ||
| 130 | - | ||
| 131 | - | ||
| 132 | - | ||
| 133 | - | ||
| 134 | - | ||
| 135 | - | ||
| 114 | + | En Windows 9x se permite el acceso directo al hardware por lo que es posible utilizar código ensamblador para acceder al mismo. Supongamos que queremos escribir el valor \$CC en el puerto \$320. Lo podemos realizar con las siguientes líneas de código (este ejemplo utiliza la sintaxis ATT en lugar de la de Intel): | |
| 115 | + | ||
| 116 | + | ``` pascal | |
| 117 | + | {$ASMMODE ATT} | |
| 118 | + | ... | |
| 119 | + | asm | |
| 120 | + | movl $0x320, %edx | |
| 121 | + | movb $0xCC, %al | |
| 122 | + | outb %al, %dx | |
| 123 | + | end ['EAX','EDX']; | |
| 136 | 124 | ``` | |
| 137 | 125 | ||
| 138 | 126 | ### Resolución de problemas en Windows | |
| 139 | 127 | ||
| 140 | - | ||
| 128 | + | Una posible fuente de problemas al utilizar hardware paralelo que no soporta Plug&Play en Windows es que Windows puede asignar el puerto utilizado por el hardware a otro dispositivo. Puedes encontrar instrucciones en la siguiente URL, de como indicar a Windows que no asigne la dirección del disoositivo a dispositivos Plug&Play: | |
| 141 | 129 | ||
| 142 | 130 | <http://support.microsoft.com/kb/135168> | |
| 143 | 131 | ||
| 144 | 132 | ### Utilizando ioperm para acceder puertos en Linux | |
| 145 | 133 | ||
| 146 | - | ||
| 134 | + | La mejor manera de acceder al hardware en Linux es a través de drivers de dispositivos, pero, debido a la complejidad de crear un driver, algunas veces un método rápido es más útil. | |
| 147 | 135 | ||
| 148 | - | ||
| 136 | + | En orden a usar la unit "[[doc:rtl/ports|ports]]" bajo Linux, el programa debe arrancarse como usuario root, y debe llamarse a IOPerm para establecer los permisos apropiados para acceso al puerto. Se puede encontrar documentación sobre la unit "[[doc:rtl/ports|ports]]" en la siguiente URL: [1](http://www.freepascal.org/docs-html/rtl/ports/index.html) | |
| 149 | 137 | ||
| 150 | - | ||
| 151 | - | ||
| 152 | - | ||
| 153 | - | ||
| 154 | - | ||
| 138 | + | Lo primero que debemos hacer es enlazar a (g)libc y llamar a IOPerm. En Free Pascal existe una unidad que enlaza enteramente a (g)libc, pero da lugar a problemas cuando se utiliza directamente por la aplicación y por tanto enlazarla estáticamente directamente a la librería (g)libc no es una buena idea porque siempre cambia de manera incomprensible entre versiones. Funciones como ioperm, como siempre, es poco probable que cambien. | |
| 139 | + | ||
| 140 | + | ``` pascal | |
| 141 | + | {$IFDEF Linux} | |
| 142 | + | function ioperm(from: Cardinal; num: Cardinal; turn_on: Integer): Integer; cdecl; external 'libc'; | |
| 143 | + | {$ENDIF} | |
| 155 | 144 | ``` | |
| 156 | 145 | ||
| 157 | - | ||
| 158 | - | ||
| 146 | + | - "from" representa el primer puerto a ser accedido. | |
| 147 | + | - "num" es el número de puertos despueś de acceder al primero, por lo que ioperm(\$220, 8, 1) permitirá el accceso por parte del programa a todos los puertos entre \$220 y \$227, ambos inclusive. | |
| 159 | 148 | ||
| 160 | - | ||
| 161 | - | ||
| 162 | - | ||
| 163 | - | ||
| 164 | - | ||
| 165 | - | ||
| 166 | - | ||
| 167 | - | ||
| 168 | - | ||
| 149 | + | Después de enlazar a IOPerm se puede utiliar port\[\<Address\>\] para acceder a los puertos: | |
| 150 | + | ||
| 151 | + | ``` pascal | |
| 152 | + | {$IFDEF Linux} | |
| 153 | + | i := ioperm($220, 8, 1); { se enlaza IOPerm } | |
| 154 | + | port[$220] := $00; { utilizamos port para escribir el valor $00 en el puerto $220 } | |
| 155 | + | myLabel.Caption := 'ioperm: ' + IntToStr(i); | |
| 156 | + | i := Integer(port[$220]); | |
| 157 | + | myOtherLabel.Caption := 'response: ' + IntToStr(i); | |
| 158 | + | {$ENDIF} | |
| 169 | 159 | ``` | |
| 170 | 160 | ||
| 171 | - | ||
| 161 | + | Este código fue testeado con una tarjeta ISA en el puerto \$0220, utilizando Lazarus 0.9.10 en Mandriva Linux 2005 y Damn Small Linux 1.5. | |
| 172 | 162 | ||
| 173 | 163 | ### Acceso general a hardware en UNIX | |
| 174 | - | ||
| 175 | - | ||
| 164 | + | ||
| 165 | + | {$IFDEF Unix} | |
| 176 | 166 | Uses Clib; // retrieve libc library name. | |
| 177 | 167 | {$ENDIF} | |
| 178 | - | ||
| 168 | + | ||
| 179 | 169 | {$IFDEF Unix} | |
| 180 | 170 | function ioperm(from: Cardinal; num: Cardinal; turn_on: Integer): Integer; cdecl; external clib; | |
| 181 | 171 | {$ENDIF} | |
| 182 | - | ||
| 183 | 172 | ||
| 184 | - | ||
| 185 | - | ||
| 173 | + | **Note** that FPC provides an abstraction for ioperm called "fpioperm" in [[doc:rtl/x86/index.html|unit x86]], and also defines out and inport functions. These functions are currently implemented for Linux/x86 and FreeBSD/x86. | |
| 186 | 174 | ||
| 187 | - | ||
| 175 | + | No se recomienda enlazar a libc a menos que sea absolutamente necesario debido a un posible diseño y portabilidad de funciones. | |
| 188 | 176 | ||
| 189 | - | ||
| 177 | + | Tampoco se recomienda el enlace manual a libc (declarando tal cual libc importado por funciones que son accesibles desde cualquier parte). Por ejemplo la línea de importación de libc fallará innecesariamente si la librería estandar no se llama desde libc, como por ejemplo libroot en BeOS, o en plataformas que no utilicen símbolos C estandar). | |
| 190 | 178 | ||
| 191 | - | ||
| 179 | + | **Note 2** Utilizar la unidad _unit_ libc no es recomendable bajo ninguna circunstancia salvo para compatibilidad con Kylix. Esto es debido a que esta unidad es relativamente poco portable (debido a la excesiva exposición de estructuras y otros símbolos privados) y debe modificarse solamente tan poco como sea posible fuera de lo que implique su compatibilidad con Kylix. | |
| 192 | 180 | ||
| 193 | 181 | ## Comunicación Serie | |
| 194 | 182 | ||
| 195 | - | ||
| 183 | + | La sección [[Hardware Access|External Links]] tiene tutoriales para puertos serie bajo UNIX y Windows. | |
| 196 | 184 | ||
| 197 | 185 | ## USB | |
| 198 | 186 | ||
| 199 | 187 | ### libusb | |
| 200 | 188 | ||
| 201 | - | ||
| 189 | + | Una posibilidad para múltiples plataformas, para Linux, BSDs y Mac OS X es [libusb](http://libusb.sourceforge.net/). | |
| 202 | 190 | ||
| 203 | - | ||
| 191 | + | Las cabeceras se listan en <http://www.freepascal.org/contrib/db.php3?category=Miscellaneous>: | |
| 204 | 192 | ||
| 205 | - | ||
| 206 | - | ||
| 207 | - | ||
| 208 | - | ||
| 209 | - | ||
| 210 | - | ||
| 193 | + | | Nombre | Autor | Versión | Fecha | Enlace | Aclaraciones | | |
| 194 | + | |----|----|----|----|----|----| | |
| 195 | + | | libusb.pp | nowrap \| Uwe Zimmermann | 0.1.12 | nowrap \| 2006-06-29 | <http://www.sciencetronics.com/download/fpc_libusb.tgz> | | | |
| 196 | + | | libusb.pas | Johann Glaser | | nowrap \| 2005-01-14 | <http://www.johann-glaser.at/projects/libusb.pas> | | | |
| 197 | + | | fpcusb | Joe Jared | 0.11-14 | nowrap \| 2006-02-02 | <http://relays.osirusoft.com/fpcusb.tgz> | nowrap \| enlace de descarga roto | | |
| 198 | + | ||
| 211 | 199 | ### FTDI | |
| 212 | 200 | ||
| 213 | - | ||
| 201 | + | Si utilizas uno de los circuitos integrados (IC o chips) listados en [FTDI](http://www.ftdichip.com/), puedes utilizar sus cabeceras pascal para el interface dllcon los chips. | |
| 214 | 202 | ||
| 215 | 203 | ## Enlaces externos | |
| 216 | 204 | ||
| 217 | - | ||
| 205 | + | Comparación de velocidades para protocolos de comunicación: | |
| 218 | 206 | ||
| 219 | - | ||
| 220 | - | ||
| 221 | - | ||
| 222 | - | ||
| 207 | + | 1. <http://en.wikipedia.org/wiki/Serial_port#Speed> | |
| 208 | + | 2. <http://www.lvr.com/jansfaq.htm> - Jan Axelson's Parallel Port FAQ | |
| 209 | + | 3. <http://en.wikipedia.org/wiki/USB#Transfer_Speed> | |
| 210 | + | 4. <http://en.wikipedia.org/wiki/PCI#Conventional_PCI_bus_specifications> | |
| 223 | 211 | ||
| 224 | - | ||
| 212 | + | Enlaces de comunicación serie: | |
| 225 | 213 | ||
| 226 | - | ||
| 227 | - | ||
| 228 | - | ||
| 229 | - | ||
| 214 | + | 1. Bajo UNIX: [2](http://www.easysw.com/~mike/serial/serial.html) | |
| 215 | + | 2. Bajo Windows: <http://msdn.microsoft.com/library/default.asp?url=/library/en-us/dnfiles/html/msdn_serial.asp> | |
| 216 | + | 3. Componente Synaser: <http://synapse.ararat.cz/> | |
| 217 | + | 4. Comport Delphi package: <http://sourceforge.net/projects/comport/> | |
| 230 | 218 | ||
| 231 | - | ||
| 219 | + | Osciloscopio Digital ISA - Un ejemplo de acceso a hardware con todo el código fuente incluido:[3](http://eletronicalivre.incubadora.fapesp.br/portal/english/oscilloscope/) | |
| 232 | 220 | ||
| 233 | 221 | --- | |
| 234 | - | ||
| 222 | + | *From the Free Pascal wiki, page "Hardware Access/es", as it stood on 2020-02-16 after a change by Trev, out of the wiki's dump of 2024-05-26. Copyright stays with the author who wrote it, according to the old wiki's [[Licensing]] page. If you have concerns about this material, [message the admin](/wiki-contact).* | |
| 223 | + | Category: Castellano | |
| 224 | + | Category: Español |