Comunicación USB PIC18F4550 utilizando la clase CDC
Ejemplo de comunicación USB entre un PIC 18F4550 y una aplicación de escritorio utilizando la clase CDC (Communications Device Class)
MICROCONTROLADORES
Biblioman
11/28/201025 min leer
Ejemplo de comunicación entre un PIC 18F4550 y una aplicación de escritorio, utilizando un entorno de programación Multiplataforma, que nos permita ejecutar la aplicación en diferentes sistemas operativos.
La realización de un ejemplo de comunicación USB entre un PC y un microcontrolador, la podemos dividir en varios apartados, que son:
Realización de la Proto-Board ó desarrollo del circuito en un entorno simulado como Proteus.
Desarrollo del firware ó programa que se cargará en el microcontrolador.
Instalación de los drivers en el PC.
Desarrollo de la aplicación de escritorio que servirá de interfaz de comunicación entre el usuario y el microcontrolador.
Empecemos a describir cada uno de estos puntos.
Para la realización del ejemplo se ha diseñado la siguiente placa de desarrollo a la que he llamado "Fenix V1.0" para poder referirme a ella en futuros ejemplos.
La placa es simple, del tipo modular ya que tiene disponible todas las patillas del PIC, lo que permite la adaptación a cualquier tipo de proyecto que utilice USB o no. Las características son las siguientes:
Zócalo de conexión de 40 pines donde va insertado por defecto el PIC18F4550, este PIC además de implementar una interfaz integrada para la comunicación USB dispone de un gran número de pines (idóneo para una placa de desarrollo donde a priori no sabemos los circuitos que vamos a montar en ella). Con respecto a las características de conectividad USB este Microcontrolador, presenta las siguientes: compatibilidad con USB 2.0, velocidad de trasmisión Low Speed (1.5 Mb/s) y Full Speed (12 Mb/s). Soporta transferencias del tipo: Control, Interrupción, Isocrónicas y del tipo Bulk (para grandes transferencias de datos). Soporta hasta 32 Endpoints 16 de los cuales son bidireccionales. Mas adelante veremos lo que significa cada una de estas nuevas palabras que aparecen cuando utilizamos conectividad USB.
La placa permite seleccionar su alimentación por medio de un "Jumper" desde una fuente externa o a través del propio conector USB, teniendo en cuenta en este caso que el control de la alimentación es gestionada por el Host y que en la especificación USB 2.0 ese valor no debe sobrepasar los 500 mA en el mejor de los casos (cuando el dispositivo se alimenta a través de un hub con alimentación propia), USB 3.0 soporta hasta 900 mA, pero que yo sepa por el momento no hay microcontroladores que soporten esta especificación.
Conexión ICD a través de un conector RJ-12 que permite la conexión directa a programadores/debuggers como el ICD-U64 y el ICD2 o ICD3.
Conector USB tipo A, regleta de conexiones para la alimentación de 5V externos, botón de reset para el PIC, zócalo para el cristal de cuarzo, led de alimentación y array de pines para todos los puertos del PIC.
Consideraciones de diseño.
El que la placa tenga un diseño modular permite mucha flexibilidad a la hora de probar nuestros prototipos, basta que hagas fijo la funcionalidad de un determinado pin, para que en el siguiente prototipo lo tengas que utilizar para otra cosa. Otra decisión importante que hay que tener en cuenta en el diseño de la placa son los conectores a utilizar, con respecto al conector del programador/debugger la decisión fue rápida decidí utilizar el RJ-12 ya que los programadores que utilizo (ICD-64 y el ICD2) tienen este conector y vienen ya con el cablecito incorporado para la conexión, el esquema de conexión del ICD-U64 a la placa lo tenéis aquí .
Con respecto a los conectores para los puertos del PIC personalmente prefiero los que te permiten el acceso a los pines individualmente, dentro de esta filosofía se pueden utilizar regletas de conexiones que permiten utilizar cualquier tipo de cable para conectar los módulos de expansión ó array de pines (o postes) como se les quiera llamar, que permiten la conexión fácil a través de cablecillos rígidos,
para esta placa he utilizado los array de pines, con respecto a las regletas de conexiones tienen la ventaja de que te ahorras el atornillado de los cables, ocupan menos espacio y son más baratos. Las regletas de conexiones tienen a su favor que los cables quedan mas sujetos y permiten el movimiento de los módulos sin correr el riesgo de que se desconecte algún cable. Con respecto al conector USB los que se utilizan normalmente para los dispositivos son los del tipo B, si he utilizado uno del tipo A simplemente es porque es el único que tenía disponible (reciclado de una vieja placa base de ordenador).
Con respecto al software de diseño de la placa podéis utilizar el que más os guste hay donde elegir: Altium (Antiguo Protel), Eagle, KiCAD, OrCAD, Ares, PCB Wizar, PCB Artist, etc.
Otro tema de decisión en el diseño es si utilizar componentes SMD o componentes convencionales, aunque parezca mentira no es mucho más difícil el montaje de circuitos con componentes de superficie (SMD) que hacerlo con componentes del tipo de agujeros pasantes THT (Through-Hole Technology), al utilizar componentes SMD la placa será mas pequeña y además te ahorras el taladrado de la placa, una ventaja importante si encima utilizas una placa a doble cara, en mi caso simplemente no los suelo utilizar por que la única forma de obtenerlos es por Internet con los gastos adicionales que conlleva, por lo que esta placa está diseñada íntegramente con componentes convencionales, claro que a veces no hay otra opción ya que hay componentes que solo se fabrican en encapsulado SMD.
Por último queda la decisión de utilizar para el diseño una placa de circuito impreso simple o a doble cara, el desarrollo de placas a doble capa utilizando los métodos caseros tradicionales como el insolado y la técnica de la plancha suele costar un poco más de trabajo al principio, pero una vez que perfeccionas la técnica su utilización en circuitos de mediana complejidad es aconsejable, el que solo haga sus diseños a una cara sabe el tiempo que hay que perder modificando el ruteo de la placa para incluir los tediosos puentes de conexión.
DEFINICIONES SOBRE CONCEPTOS DEL ESTÁNDAR USB
El que venga de utilizar interfaces de comunicación más simples como RS-232 se encuentra que en la comunicación USB aparecen una serie de términos nuevos como: endpoint, pipes, transacciones, clases, Enumeración, descriptores etc. que al principio pueden resultar difíciles de entender, voy a intentar dar una explicación personalizada de dichos conceptos. Quien quiera una explicación más rigurosa puede leer la bibliografía citada al final del artículo.
Interfaz física
La interfaz física está formada por cuatro hilos dos para la alimentación 5v (Rojo) GND (Negro) y dos para datos D+ (verde) y D- (Blanco) Lo del signo + y - es porque es una señal diferencial cuyo valor depende de la velocidad del bus (3,3v para low-speed y 400mV para high-speed).
Los conectores se les denomina de tipo A y de tipo B, una imagen de dichos conectores la tenéis aquí.
Nota: la fuente de la imagen está en la dirección URL.
Velocidades del Bus
Hay que decir que el Host es el que controla la velocidad en la que circulan los datos en el bus USB y que al ser un bus compartido, la velocidad real dependerá de la cantidad de dispositivos que tengamos conectados a el en un momento determinado (máximo 127 incluyendo al Host). Por tanto los datos siguientes son solo teóricos y de referencia.
Low speed: 1,5 Mbps. Soportado por las especificaciones 1.1, 2.0 y 3.0. Es la velocidad utilizada por dispositivos como teclados, ratones, joystick, etc.
Full speed: 12 Mbps. Soportado por USB 1.1, USB 2.0 y USB 3.0. Un ejemplo donde se utilizan estas velocidades es en transmisiones de audio.
High speed: 480 Mbps. Solo USB 2.0 y USB 3.0. Ejemplo transmisiones de video.
Super speed: 5Gbps solo soportado en dispositivos USB 3.0, y como he dicho antes no conozco ningún microcontrolador que soporte esta especificación.
Transferencias
Una transferencia se puede definir como el conjunto global de los datos que forman una comunicación USB, una transferencia está formada a su vez por una o varias transacciones que a su vez están formadas por diferentes paquetes de datos que contienen las tramas de una comunicación USB.
No existe un formato único de transferencia, la especificación USB permite cuatro tipos de transferencias:
Control: se utilizan para configurar y enviar comandos, por ejemplo en la enumeración del dispositivo, más adelante veremos lo que es esto.
Bulk (masivas): se utilizan cuando se precisa una transferencia de datos grande, es el tipo más rápido de transferencia, sin embargo no hay garantía de que los datos se transmitan en un tiempo determinado (no garantizada la latencia). Si que hay verificación de que los datos se han transmitido con éxito ya que dispone de sistema de corrección de errores (CRC), esta transferencia solo la pueden utilizar dispositivos que soporten velocidades Full y High Speed. Este tipo de transferencia es utilizada por dispositivos como por ejemplo: discos duros, pen drivers, escaners, impresoras, etc.
Isócronas: Es usada en dispositivos que transmiten señales de audio y de vídeo en tiempo real. Se garantiza una tasa de velocidad de transmisión determinada (latencia asegurada). Si no fuera así, por ejemplo en una transmisión de voz el audio se oiría entrecortado. No contempla la corrección de errores, si en un archivo de sonido se pierde un BIT, no es importante su recuperación. Para usar este tipo de transferencia es necesario que los dispositivos soporten velocidades Full Speed.
interrupción: latencia asegurada y verificación de que los datos se han transmitido con éxito, Se utiliza en dispositivos como: Teclados, Mouse, Sensores, Pantallas táctiles, y dispositivos que no requieran mucho ancho de banda.
Los dispositivos usan uno o más tipos de transferencia, la de control es utilizada siempre por todos los dispositivos en el proceso de enumeración. Si se utiliza otra transferencia habrá que hacerlo en función
del tipo y cantidad de datos a transmitir.
¿En que consiste la Enumeración?
El Host es el encargado de detectar cualquier dispositivo que se conecta al bus. Cuando un dispositivo es detectado el Host necesita obtener información sobre el, a este proceso es al que se le llama enumeración. Esta información que necesita el Host se encuentra definida en el dispositivo en los llamados descriptores. Los descriptores son datos que se guardan en la memoria no volátil del PIC y contienen la siguiente información: El ID del vendedor (VID) y del producto (PID), consumo de corriente del dispositivo, tipo de transferencia que se va ha utilizar, endpoint utilizados, versión USB soportada, clase utilizada, etc.
El VID (Vendor ID) y el PIC (Product ID) son dos números de 16 bits representados en Hexadecimal, si utilizamos la clase CDC (Communications Device Class) de CCS para la comunicación USB estos valores los podemos modificar en el archivo "usb_desc_cdc.h" y según el sistema operativo instalado en el Host deberemos modificarlos también en el archivo .inf, pero esto lo veremos más adelante.
Realmente el modificar estos valores solo es útil si queremos distribuir nuestro producto comercialmente, en ese caso existe una organización llamada USB Implementers Forum que se encarga de proporcionarnos previo pago correspondiente (creo que unos 1500 $) un VID valido para que nuestro dispositivo conviva sin problemas con el resto de dispositivos USB del mercado, además tendremos derecho a poner el logo USB en nuestro producto certificando de esta manera que ha pasado los controles pertinentes y cumple con el estándar USB. Todo esto es similar al proceso que se sigue a la hora de obtener una dirección MAC en una tarjeta de red.
Si esto no estuviera regulado tal y como está y cada dispositivo tuviera el VID y PID que quisiera, cuando coincidieran en un mismo sistema dos números iguales se presentaría un conflicto hardware y ambos dispositivos dejarían de funcionar.
Seguiremos con las definiciones de conceptos un poco abstractos...
¿Que es un endpoint?
Los endpoint son simplemente buffer de memoria RAM que son utilizados para el envío y recepción de datos o comandos de control durante una comunicación USB. cada endpoint puede ser de entrada o salida de datos o bidireccional, el endpoint 0 está reservado para comandos de control, el proceso de enumeración se realiza a través del endpoint número 0. Este concepto solo se aplica al dispositivo, en el host existen también buffer para el envío y recepción de datos pero no se les denomina con este nombre.
¿Que es un Pipe o Tubería?
Es una conexión lógica entre un endpoint y el software del controlador del host que se produce tras el proceso de enumeración. Los Pipes se usan mucho en Sistemas Operativos como UNIX/LINUX para enlazar la salida de un proceso con la entrada de otro, en este caso el concepto es el mismo.
¿Que es una clase?
Una clase es un modelo o plantilla que describe el estado y el comportamiento de los objetos que la comparten. La clase provee de propiedades y métodos (funciones) reutilizables por los objetos o miembros que comparten la clase. Esta definición general de clase utilizada en la programación orientada a objetos creo que es la mejor para definir este concepto utilizado en USB. La especificación USB provee de propiedades y funciones que pueden ser utilizadas por los dispositivos que tengan características similares. Por ejemplo, un teclado y un ratón por sus características pertenecerán a la misma clase la llamada Human Interface Device (HID), pues bien si yo diseño el firware de un dispositivo con las especificaciones que me exige esta clase podré beneficiarme de esas propiedades y funciones comunes a la clase, una ventaja de utilizar esta clase por ejemplo es que no se necesita instalar ningún driver para el dispositivo ya que el sistema operativo utilizará uno genérico para todos.
La especificación USB provee de muchas clases para facilitar la vida al desarrollador de dispositivos, puedes ver una información más precisa de las clases disponibles aquí.
Las clases más utilizadas con Microcontroladores son:
HID (Human Interface Device): ejemplos de dispositivos que utilizan esta clase como hemos dicho ya son: teclados, ratones, pantallas táctiles, joystick, etc. Velocidad low-speed (64 KB/s de velocidad máxima), tipos de transferencias soportadas: de control y de Interrupción. Una característica interesante al utilizar esta clase es que no se necesita instalar un driver especifico en el Sistema Operativo, se utiliza uno estándar que ya está incluido en el sistema. En el S.O Windows la aplicación de escritorio accede al dispositivo con ayuda de las APIS win32. En Linux veremos como utilizar esta clase en un futuro ejemplo.
MSD (Mass Storage Device Class): Como su propio nombre indica para dispositivos de almacenamiento masivo como discos duros, memorias flash, cámaras digitales, dispositivos ópticos externos como lectores y grabadoras de CD y DVD, etc. Esta clase se puede utilizar solo en dispositivos que soporten velocidades Full y High Speed. El tipo de transferencias utilizadas es Bulk o una combinación formada por transferencias del tipo Control, Bulk y Interrupt. Microchip tiene notas de aplicación sobre esta clase como la AN1003, CCS también implementa ejemplos sobre esta clase. No se necesita la instalación de un driver específico, se utilizan drivers genéricos instalados ya en los Sistemas Operativos, en Windows se utiliza el driver llamado usbstor.sys ubicado en C:WindowsSistem32drivers.
CDC (Communications Device Class): Un ejemplo de dispositivo que utiliza esta clase son los Modems, en este primer ejemplo utilizaremos esta clase para comunicar nuestro PIC18F4550 con la aplicación de escritorio que realizaremos con un IDE multiplataforma, que nos permitirá ejecutar la aplicación en diferentes sistemas operativos, concretamente en Windows, Linux y MAC. La velocidad máxima al utilizar esta clase será de 80 kBytes/s y el tipo de transferencias soportadas son del tipo interrupción y Bulk. Utiliza también driver estándar incluidos ya en el sistema operativo, según el sistema operativo utilizado precisará o no de la instalación del archivo .INF, cuando utilizamos esta clase en el PC nos creará un puerto serie virtual y la comunicación entre el dispositivo y la aplicación de escritorio se hará a través de el al igual que se haría con un puerto serie físico, esto supone una gran ventaja a la hora de diseñar la aplicación de escritorio, ya que cualquier IDE de programación sea del lenguaje que sea, dispone de un componente o librería que permite el acceso al puerto serie fácilmente.
Existe una clase genérica llamada "Custom Class" que se utiliza cuando el dispositivo no se asemeja a las características de ninguno de los miembros pertenecientes a otras clases. un ejemplo de dispositivo que utiliza esta clase es el ICD2 o ICD3 de Microchip.
Si el firware de nuestro dispositivo no cumple con las especificaciones de alguna de las clases que se beneficia del uso de drivers genéricos instalados ya en el sistema operativo no queda otra que diseñar un driver para nuestro dispositivo, sino el dispositivo no será reconocido por el PC, diseñar un driver desde cero es muy complicado ya que se requiere profundos conocimientos tanto de la arquitectura del PC como del Sistema Operativo que tenga instalado. Afortunadamente ya hay drivers personalizados que podemos utilizar en nuestros proyectos, algunos de ellos son los siguientes:
Naturalmente el que proporciona Microchip: para la utilización de este driver Microchip nos proporciona los siguientes archivos:
mchpusb.sys es el driver en si y solo está disponible en formato binario.
mchpusb.ini este archivo contiene información del driver y es requerido por el sistema operativo para que cuando se conecta por primera vez el dispositivo al PC este sepa que driver tiene que asignarle. El S.O también obtiene información de este archivo para configurar correctamente el dispositivo. Es un archivo de texto que se puede editar y modificar algunas cosas en el, como los valores del VID y PID que deben de coincidir con los definidos en los descriptores del dispositivo, también se pueden modificar algunas cadenas de texto que se mostraran como información del dispositivo una vez instalado el driver en el S.O, lo demás mejor no tocarlo sino queremos que nuestro dispositivo deje de funcionar.
La DLL mpusbapi: una dll es una capa software que en este caso facilita por medio de funciones la comunicación entre la aplicación de escritorio y el driver del dispositivo. Esta dll está compilada con el compilador de Borland C++ Builder 6. Microchip facilita su código fuente, por lo que hay dos formas de utilizarla. Si utilizamos el mismo IDE de Borland para crear nuestra aplicación de escritorio, simplemente tendremos que añadir la librería (el archivo mpusbapi.lib) a nuestro proyecto como una librería más (¡ojo la extensión tiene que ser .lib!), si utilizamos otro compilador diferente deberemos de compilar de nuevo los fuentes de la librería para obtener una nueva versión del archivo mpusbapi.lib que sea compatible con el compilador utilizado. La otra opción de utilización de la librería es añadirla a nuestro proyecto de forma dinámica, para ello solo se necesita el archivo con extensión .dll (mpusbapi.dll) proporcionado también por Microchip, de esta forma si utilizamos un compilador diferente como los que nos proporciona Microsoft en su plataforma .NET u otros como LabVIEW, Matlab, RealBAsic, etc. No tendremos que modificar el código fuente de la DLL, simplemente la utilizaremos importando las funciones públicas de la DLL desde nuestra aplicación de escritorio. Microchip proporciona ejemplos de ambas formas. Como veis todo esto del USB da pie a realizar las cosas de diferentes formas, más adelante en otro ejemplo veremos estás dos posibilidades. Pero ¿por que utilizar esta opción y no utilizar siempre las clase CDC, MSD o HID que a priori parece más fácil su utilización? Simplemente porque utilizando un driver personalizado en vez de los genéricos que proporciona Windows obtenemos una comunicación USB más versátil y con mayores prestaciones. Por ejemplo, en cuanto a velocidad podremos alcanzar velocidades de hasta 1MB/s frente a los 64 KB/s de la clase HID y los 80 kBytes/s de la clase CDC, además el driver de Microchip soporta todos los tipos de transferencia (Control, Isócronas, Interrup y Bulk), cosa que no ocurre igual si utilizamos las otras clases como ya hemos visto.
En su última versión este driver está soportado por los siguientes sistemas operativos: Windows 2000, Windows Server 2003, Windows XP, Windows XP 64, Windows Vista, Windows Vista 64 y Windows 7 Nota importante: cuando utilizamos el driver personalizado de Microchip los datos se transmiten en raw (crudo) y la aplicación de escritorio intercambia información con el PIC directamente a través de los enpoints utilizados por este, en este caso se usa un protocolo de comunicación que a priori no está definido. Es importante que copiemos del archivo .INF el valor del campo definido como GUI (Global Unique Identifier), que es un número que sirve para que la aplicación pueda acceder al dispositivo, luego accederemos a la dll desde el IDE que hallamos elegido para desarrollar la aplicación de escritorio editaremos las
propiedades y funciones publicas de la dll buscando un campo que se llame GUI (o algo así) y si no coincide tendremos que pegar hay ese número, si no lo hacemos no se podrá crear la tubería de conexión (pipe) entre nuestra aplicación y el driver.
Cuando utilizamos la clase CDC esto no es necesario ya que la comunicación está definida a través del puerto serie virtual creado y la información se transmite por defecto en forma de caracteres ASCII al igual que un puerto serie físico.
Otros drivers que podemos utilizar para nuestro PIC 18fx550 son:
WinUSB: es el driver genérico para USB que propone utilizar Microsof cuando nuestro dispositivo no puede ser manejado directamente por los drivers que ya incluye por defecto en su sistema operativo. Para ello al igual que Microchip proporciona los siguientes archivos: Winusb.sys, Winusb.ini y la librería dinámica Winusb.dll que al igual que la dll de Microchip nos proporciona una serie de funciones públicas para acceder fácilmente al driver y a las APIs win32 de Windows desde nuestra aplicación de escritorio.
Toda la información que proporcionada Microsof sobre este driver la podéis encontrar en el siguiente enlace.libUSB: Es un driver de código abierto con licencia GNU, se puede instalar en múltiples sistemas operativos como LInux, MAC y otros, incluyendo Windows a través de su versión libusb-win32. Toda la información de este driver lo tenéis en la página del proyecto. Además existen ejemplos ya hechos para utilizar con diferentes lenguajes y entornos de programación como: Java, Python, Ruby, .NET, etc.
Bueno y con esto se acaba la pequeña introducción sobre USB enfocada a los PIC, la mayoría de datos y valores numéricos de está información además de los datasheets está sacada de apuntes y notas tomadas por mí en las diferentes presentaciones y seminarios de Microchip a los que he podido asistir a lo largo del tiempo que estoy con esto de los PICs, por lo que no descarto que pueda haber algún error, de vosotros depende el verificar dichos datos y si encontráis algún error sería bueno para todos que lo comentarais en el foro.
Una vez dicho esto continuemos con el siguiente paso.
Desarrollo del firware ó programa que se cargará en el microcontrolador
Como dijimos al principio este ejemplo esta basado en el uso de la clase CDC, utilizando el compilador de CCS versión 4.107, me ha servido de guía el ejemplo EX_USB_SERIAL.C incluido en los ejemplos del compilador (con las modificaciones necesarias claro), como ya sabéis los ejemplos y librerías de CCS tienen copyright y su código no se puede publicar. Por lo que solo voy a comentar algunas cosas:
Unas de las cosas importantes que tenemos que tener en cuenta al programar el Microcontrolador son los fusibles, en los que entre otras cosas se define la velocidad de trabajo del PIC. Una característica que hay que tener en cuenta cuando usamos un PIC con interfaz USB, es que para que dicho módulo funcione la frecuencia de reloj en la entrada de dicho módulo debe de ser de 48 MHz, para conseguir dicha frecuencia se dispone de un multiplicador con pre-escaler y post-escaler. A la entrada del multiplicador tenemos que tener una frecuencia fija de 4 MHz. En la figura de abajo se muestra como configurar el pre-escaler del PLL cuando en nuestro circuito tenemos un cristal de 20 MHz.
Como se ve en la figura, en este caso el pre-escaler divide los 20 MHz por 5 para obtener los 4MHz requeridos a la entrada del PLL, este a su vez produce 96 MHz en su salida los cuales se distribuyen por un lado al módulo USB, dividiendo previamente la frecuencia por 2 para obtener los 48 Mz a la entrada del módulo por el otro lado alimenta el post-divisor del PLL, para que podamos elegir la frecuencia de trabajo del núcleo del micro, en este caso divide por tres por lo que tendremos 32 MHz para alimentar al "core" del PIC.
Debido a la complejidad de la comunicación USB o de otras como TCPIP lo que ha hecho tanto Microchip como otros desarrolladores de compiladores como CCS es proporcionar unas librerías que comúnmente se les llama "Stacks" o pila de software cuya finalidad es facilitar la tarea al programador de dispositivos, de tal forma que no es necesario conocer a fondo el protocolo de comunicación USB, simplemente se necesita saber que funciones públicas me proporciona el "Stack" correspondiente para poder enviar y recibir los datos a través del bus.
En el caso de este ejemplo que utiliza la clase CDC (Communications Device Class), las funciones que se han utilizado para enviar y recibir datos por el bus USB son:
usb_cdc_kbhit(): Es una función que retorna el valor booleano TRUE si hay uno o mas caracteres esperando en el buffer de recepción.
usb_cdc_getc(): Obtiene el carácter recibido en el Buffer de recepción.
usb_cdc_putc(char c): Coloca el carácter que recibe como parámetro en el buffer de transmisión para ser enviado.
Hay más funciones disponibles para su uso directo, la descripción de cada una de ellas las podéis encontrar en la cabecera del archivo usb_cdc.h.
La comunicación USB a de ser inicializada, eso se consigue llamando a la función: usb_init_cs() al principio de la función main()
Otra cosa que hay que tener en cuenta es que para que la comunicación USB se mantenga debe ser realimentada constantemente, para ello hay que llamar periódicamente a la función usb_task(), por lo que nuestro programa tendrá que tener un bucle infinito principal donde deberemos incluir la llamada a esta función.
Como veis es adaptar el algoritmo de nuestro programa a los requisitos que necesita el "Stack" para que funcione correctamente. Para ello CCS dispone de un gran número de ejemplos que nos sirven como plantillas para nuestros desarrollos.
De las librerías que nos proporciona CCS para la comunicación USB utilizando la clase CDC hay un archivo el usb_desc_cdc.h donde se guarda la información perteneciente a los descriptores del
dispositivo ese archivo podemos editarlo y modificar los descriptores perteneciente al VID, PID, consumo del dispositivo y versión del firmware.
////////// Opciones de configuración ///////////////////////////////////
#define USB_CONFIG_PID 0x0033
#define USB_CONFIG_VID 0x0461
#define USB_CONFIG_BUS_POWER 100 //100mA (rango de 0..500)
#define USB_CONFIG_VERSION 0x0100 //01.00 //range is 00.00 to 99.99
//////// Fin de la configuración //////////////////////////////////////////
Si modificamos el VID y el PID tendremos que modificarlo también en el archivo .INF
Nota: según la versión del compilador utilizado, puede que haya modificaciones en los archivos de las librerías, en la que yo tengo las opciones de configuración de los descriptores vienen definidas por etiquetas al principio del archivo.
Otra cosa que se puede modificar en este archivo son los "Strings" o cadenas de caracteres que sirven para que Windows muestre información referente al fabricante del dispositivo, como por ejemplo nombre de la compañía y nombre del producto. Estas cadenas están colocadas al final del archivo usb_desc_cdc.h y hay que colocarlas en un formato determinado según se muestra en el siguiente ejemplo:
//string 1 - Fabricante
20, //Longitud de la cadena = (Nº caracteres + 1)x2= (9+1)x2=20
USB_DESC_STRING_TYPE, //descriptor type 0x03 (STRING)
'F',0,
'A',0,
'B',0,
'R',0,
'I',0,
'C',0,
'A',0,
'N',0,
'T',0,
'E',0,
//string 2 - producto
18, //Longitud de la cadena = (Nº caracteres + 1)x2= (8+1)X2=18
USB_DESC_STRING_TYPE, //descriptor type 0x03 (STRING)
'P',0,
'R',0,
'O',0,
'D',0,
'U',0,
'C',0,
'T',0,
'O',0
En el archivo .INF también hay un campo llamado [Strings] que podemos editar para personalizar la
información que presentará el Sistema Operativo sobre nuestro dispositivo.
¿Que diferencia hay entre unas cadenas y otras?, pues bien, las que se encuentran en el archivo de los descriptores se mostrarán solo la primera vez que se conecta el dispositivo al ordenador. En Windows esa información aparecerá en el "bocadillo" informativo que sale a la derecha en la barra de herramientas, cuando el sistema detecta un nuevo hardware.
Nota: en Linux esta información no aparece y en MAC lo probaré pero claro, cuando consiga uno.
Después de que el dispositivo haya sido reconocido por el sistema esa información la cogerá el S.O desde las cadenas contenidas en el archivo .INF y la podremos ver en Windows si vamos a la ventana de "Administrador de dispositivos" seleccionamos el dispositivo y hacemos clic en propiedades.
Instalación de los drivers en el PC
Bueno este punto solo es cierto a medias, ya hemos dicho que si utilizamos la clase CDC el sistema operativo utiliza drivers genéricos instalados ya en el Sistema Operativo, pero para que Windows sepa que driver tiene que asignarle al dispositivo precisa que se instale el archivo .INF, el proceso de instalación de este archivo es como si fuera un driver completo, es decir, la primera vez que enchufemos el dispositivo al ordenador el plug and play nos detectará un hardware nuevo y nos saldrá el asistente para la instalación del nuevo hardware encontrado. Cuando nos aparezca la ventana preguntándonos si queremos que Windows se conecte a Windows Update para buscar el Software seleccionaremos la opción: No por el momento. En la siguiente ventana donde nos pregunta ¿que desea que haga el asistente? marcaremos la opción de: Instalar desde una lista o ubicación específica (avanzado) y en la siguiente ventana nos aparecerá las opciones de búsqueda en la que seleccionaremos la opción Buscar el controlador más adecuado en estas ubicaciones y marcaremos la casilla Incluir esta ubicación en la búsqueda, pulsando sobre examinar seleccionaremos la carpeta donde se encuentra nuestro archivo .INF, si todo ha ido bien comenzará el proceso de instalación. Y una vez instalado si abrimos el administrador de dispositivos (inicio -->ejecutar-->devmgmt.msc) veremos que nos ha creado un puerto serie virtual, y si quieres ver el driver que le ha asignado Windows sigue los pasos de la figura de abajo empezando por la izquierda.
El archivo .INF que he utilizado para esta Demo es el que viene con el compilador de CCS lo podéis encontrar en la ruta donde instalasteis el compilador en la carpeta drivers, este archivo está preparado para que funcione en Windows NT, Windows 2000, XP, Windows Vista y Windows 7 en sus versiones de 32 y 64 bits.
¿Y como se hace todo esto en Linux? pues muy sencillo porque no hay que instalar ningún archivo .INF automáticamente el Sistema Operativo reconoce el dispositivo y le asigna el driver correcto. Lo podemos ver si abrimos la carpeta /dev que es el directorio donde se guardan los controladores de dispositivos en Linux, como ya sabéis todo en Linux se gestiona como si de un archivo se tratara, después de conectar el dispositivo veremos que se nos ha creado un nuevo archivo (puerto COM) con el nombre ttyACM0, ese será el puerto al que tendremos que conectarnos desde la aplicación de escritorio.
La distribución de Linux con la que he probado la demo ha sido Ubuntu 10.04 LTS con el kernel 2.2.25
Bueno ya hemos conseguido que nuestro ordenador reconozca a nuestro PIC como un dispositivo válido, lo único que nos queda ahora es crear la aplicación de escritorio para que podamos comunicarnos con el.
Desarrollo de la aplicación de escritorio
El que programe habitualmente aplicaciones de escritorio no hace falta que lea esto ya que probablemente ya habrá elegido con que lenguaje y con que IDE hacer la aplicación. El que no tenga mucha experiencia en esto puede que se pregunte ¿que IDE de programación es el mejor?. Desde luego hay donde elegir: LabView, Matlab, DEV++, Gambas, Eclipse, NetBeans, Visual Studio, Boa Constructor, Borland C++ Builder, MonoDevelop, RealStudio, etc.
Cada uno de estos IDES compila o interpreta según el caso el código escrito en diferentes lenguajes como Basic,.NET, C++, Java, Python, G, etc.
Para esta demo he utilizado RealStudio en su versión para Linux, este IDE utiliza como lenguaje de programación un Basic moderno orientado a objetos, es Multiplataforma y con un solo clic de ratón compila el mismo código fuente para tres plataformas diferentes (Windows, Linux y MAC). Produce un ejecutable compilado en código nativo por lo que no necesita de ninguna máquina virtual ni de ningún pesado Framework en la máquina donde se ejecute la aplicación. Dispone de un componente (como la mayoría de los IDES) para gestionar los puertos COM y lleva integrado la base de datos SQLite, ideal para guardar datos procedentes del PIC. Es un producto comercial pero flexible en el tema de las licencias, hay varias opciones con diferentes precios, esta demo está hecha con la versión Trial completamente funcional durante treinta días (mas que suficientes para hacer este ejemplo y darse una idea de como es el entorno de programación), toda la información sobre este IDE se encuentra en la página oficial de Real Software.
¿Quiere decir que por que e elegido este IDE para hacer el ejemplo lo considero mejor que los demás?, pues ni Si ni NO. es simplemente una opción más a elegir. Cualquiera de los IDES anteriormente citados
los considero perfectamente válidos para realizar una pequeña interfaz que sirva para comunicarse con el PIC. Si que es verdad que prefiero los IDE multiplataforma para poder ejecutar la aplicación en varios Sistemas Operativos concretamente en Windows y Linux que son los que normalmente utilizo. Mas adelante haré otros ejemplos en otros IDES Multiplataforma como Boa (Python) y NetBeans (Java).
Microchip hasta ahora a discriminado a los usuarios que utilizan otros sistemas operativos diferentes a Windows ya que todo su software y aplicaciones de escritorio estaban hechas para windows, pero parece ser que está filosofía está cambiando, prueba de ello es la versión de su software estrella el MPLAB, sus desarrolladores se han puesto a trabajar en una versión Multiplataforma el MPLABX basado en Java, aunque de momento está en la versión beta su desarrollo permitirá que todo el software que proporciona Microchip se vaya portando poco a poco a este entorno y el que quiera utilizar los pics junto con las herramientas que proporciona Microchip lo pueda hacer en el sistema operativo que quiera sin la imposición de tener que usar Windows.
Bueno la realización en si de la aplicación de escritorio es bastante sencilla de hacer con el IDE de Real Studio, es recomendable aunque no inprescindible tener conocimientos sobre POO (Programación Orientada Objetos), aunque este requisito también es necesario si utilizamos otros IDES como Visual Studio.NET, Java o Python. Todos los IDES modernos están basados en la Programación Orientada a Objetos, una vez que dominas esta técnica de programación el pasarte de un IDE a otro es relativamente sencillo.
Durante la instalación del IDE del RealStudio se instala la carpeta de ejemplos donde hay un par de ellos sobre como comunicarse con el puerto serie, una vez que se sabe como funciona el componente COMM lo demás es añadir los botones, etiquetas y cuadros de texto que necesitemos según las necesidades del ejemplo que hagamos.
En esta demo se permite el envío de comandos y cadenas de caracteres en ambos sentidos, del PIC a la aplicación y viceversa.
Aquí tenéis una foto del circuito montado para esta demo:
Y un par de vídeos de la demo funcionando en Windows y en Linux.
Para Windows:
Para Linux:
Fuentes de información
Real Software (ahora llamado XOJO)
.....Mas todos los enlaces que se citan a lo largo del artículo.
Marcas Registradas
Los nombres, logotipos y programas que aquí se citan pertenecen a sus respectivos propietarios.
Y aquí termina este artículo que al final se ha extendido más de la cuenta, para el que haya tenido la paciencia de leerlo espero que le haya sido de la misma utilidad que a mí el hacerlo.
Un saludo