10 – Display LCD 20×4 con librería xlcd.h (XC8)

En la publicación #1, de este blog, se explicó como controlar el popular display LCD 16×2 con la librería xlcd.h, a raíz de esto, muchos me han consultado si podemos controlar un display con mas filas y caracteres ya que en ocasiones necesitamos mostrar mas información. Afortunadamente la librería es muy flexible y en efecto nos permite trabajar con otros tipos de display. En concreto, veremos como manipular el también popular LCD 20×4.

Las direcciones.

El código para controlar un display 20×4 es esencialmente el mismo para un display 16×2, la diferencia radica en las direcciones de las filas y las posiciones de los datos en cada una de ellas. La siguiente tabla muestra las direcciones correspondientes:

direcciones 20x4Tomando como base la información de la tabla, si deseamos colocar el caracter “C” en la tercera fila, posición 18, debemos ubicarnos en la dirección 0x25 y posteriormente enviar el caracter:

SetDDRamAddr(0x25);
putsXLCD("C");

El siguiente código de ejemplo muestra información en todas las filas del display 20×4:

#include <xc.h>
#include <stdio.h>
#include <stdlib.h>
#include <plib/xlcd.h>
#include <plib/delays.h>

//BITS DE CONFIGURACION.....
#pragma config PLLDIV = 5, CPUDIV = OSC1_PLL2, USBDIV = 2
#pragma config FOSC = HSPLL_HS, FCMEN = OFF, IESO = OFF
#pragma config PWRT = OFF, BOR = OFF, VREGEN = OFF
#pragma config WDT = OFF, WDTPS = 32768
#pragma config MCLRE = ON, LPT1OSC = OFF, PBADEN = OFF
#pragma config STVREN = ON, LVP = OFF, ICPRT = OFF, XINST = OFF

#define _XTAL_FREQ 48000000

//Funciones requeridas por la librería XLCD
void DelayFor18TCY(void);
void DelayPORXLCD(void);
void DelayXLCD(void);

int main() {
//Configurando LCD
OpenXLCD(FOUR_BIT & LINES_5X7);
//Esperar hasta que el display esté disponible.
while(BusyXLCD());
//Mover cursor a la derecha...
WriteCmdXLCD(0x06);
//Desactivando el cursor.
WriteCmdXLCD(0x0C);

while(1)
{
//Primera fila
SetDDRamAddr(0x00);
putrsXLCD("PRIMERA FILA LCD20X4");
//Segunda fila
SetDDRamAddr(0x40);
putrsXLCD("SEGUNDA FILA LCD20X4");
//Tercera fila
SetDDRamAddr(0x14);
putrsXLCD("TERCERA FILA LCD20X4");
//Cuarta fila
SetDDRamAddr(0x54);
putrsXLCD("CUARTA FILA LCD20X4");
}
}

void DelayFor18TCY(void)
{
Delay10TCYx(120);
}

void DelayPORXLCD(void)
{
Delay1KTCYx(180);
return;
}

void DelayXLCD(void)
{
Delay1KTCYx(60);
return;
}

Obtendremos el siguiente resultado:

funcionamiento20x4

Como puede apreciarse siempre que se conozcan las direcciones, es muy sencillo manipular este tipo de display con xlcd.h.

Un saludo,

07 – Interrupciones externas del PIC18F4550

Las computadoras y equipos electrónicos modernos son gobernados por microprocesadores y microcontroladores, estos equipos poseen una gran cantidad de dispositivos periféricos que por lo general requieren ser atendidos por el microcontrolador alterando el orden natural del programa. Para atender las peticiones de los dispositivos periféricos, se utilizan las interrupciones. Continuando el tema de las interrupciones, en esta ocasión veremos cómo utilizar las interrupciones externas INTx del PIC18F4550.

Interrupciones externas

Se configuran por medio de los registros INTCON, INTCON2 e INTCON3, los cuales poseen bits de habilitación, prioridad y banderas de estado. El registro INTCON es el más importante para la configuración e implementación de interrupciones externas, la estructura del registro se muestra en la siguiente figura:

Registro INTCON

En el contexto de INT0, los siguientes bits de INTCON son los mas importantes:

  • GIE, se utiliza para habilitar las interrupciones en general, debe ser = 1.
  • INT0IE, se utiliza para habilitar la interrupción INT0, debe ser = 1.
  • INT0IF, es la bandera de interrupción de INT0, se colocará en 1, cada vez que se produzca una interrupción INT0, posteriormente debe ser inicializada “manualmente” con 0.

Adicionalmente, en el registro INTCON2, el bit INTEDG0 se utiliza para definir si la interrupción se activará con un flanco de subida (Rising edge) o flanco de bajada (Falling edge) de la señal. Por defecto INTEDG0 posee un valor de 1, lo que equivale a una activación en flanco de subida.

NOTA: Las interrupciones INT1 e INT2 se configuran por medio del registro INTCON3.

Existen otras configuraciones como, la definición de prioridad de interrupciones, pero este tema no lo abordaremos aquí.

Ejemplo de implementación

A continuación, veremos una aplicación sencilla de la interrupción INT0. El circuito es el siguiente:

Circuito INT0

El microcontrolador tiene una rutina permanente que es hacer un blink en el led conectado a RA0 a intérvalos de 0.25 segundos. Cuando el botón haga una transición de 0 a 1 (Rising edge) se activará INT0, la cual activará una rutina que encenderá o apagará el led conectado a RA1 durante 1 segundo. Posteriormente, el microcontrolador continuará con la rutina del blink hasta que se produzca una nueva interrupción INT0.

El código del ejemplo es el siguiente:


#include <xc.h>

//BITS DE CONFIGURACION.....
#pragma config PLLDIV = 5, CPUDIV = OSC1_PLL2, USBDIV = 2
#pragma config FOSC = HSPLL_HS, FCMEN = OFF, IESO = OFF
#pragma config PWRT = OFF, BOR = OFF, VREGEN = OFF
#pragma config WDT = OFF, WDTPS = 32768
#pragma config MCLRE = ON, LPT1OSC = OFF, PBADEN = OFF
#pragma config STVREN = ON, LVP = OFF, ICPRT = OFF, XINST = OFF

#define _XTAL_FREQ 48000000

void retardo(int t);

void main()
{
 //Todas las entradas ANx son digitales
 ADCON1 = 0x0F;
 
 //RA0 y RA1 son salidas
 TRISAbits.RA0 = 0;
 TRISAbits.RA1 = 0;
 
 //INT0 (RB0) es entrada
 TRISBbits.RB0 = 1;
 
 //Leds apagados
 PORTBbits.RB0 = 0;
 PORTBbits.RB1 = 0;
 
 //Configuración de INT0
 INTCONbits.GIE = 1; //Habilitando interrupciones
 INTCONbits.INT0IE = 1; //Habilitar INT0
 INTCON2bits.INTEDG0 = 1; //Interrupción se activa en flanco de subida
 
 while(1)
 {
 //Blink
 PORTAbits.RA0 = 1;
 retardo(25);
 PORTAbits.RA0 = 0;
 retardo(25); 
 } 
}

void interrupt high_isr()
{
 if(INT0IF) //Si la bandera de interrupción es 1
 {
 PORTAbits.RA1 = ~PORTAbits.RA1; //Se invierte el estado del led
 retardo(100);
 //inicializar bandera
 INT0IF = 0;
 }
}

void retardo(int t)
{
 for(int i = 0; i <= t; i++)
 {
 __delay_ms(10);
 }
}

En el siguiente video se muestra la simulación del ejemplo:

Como se puede apreciar, la implementación de interrupciones externas es muy simple pero de gran utilidad para nuestros proyectos. En futuras publicaciones abordaremos el tema de las interrupciones periféricas de los módulos internos del PIC, iniciaremos con los temporizadores. ¡¡¡Un saludo a tod@s!!!

06 – Interrupción de Cambio en Puerto B del PIC18F4550

Las interrupciones son muy importantes en los sistemas electrónicos microcontrolados ya que proveen un canal a través del cual los dispositivos periféricos solicitan la atención del microprocesador (que se encuentra dentro del encapsulado) ante eventos tales como: finalización de conversión A/D, desbordamiento de un Timer, click o movimiento de un puntero (ej. ratón), presión de teclas de un teclado, etc.

Todos los dispositivos de hardware de una computadora tienen asignada una interrupción (IRQ) para comunicar al microprocesador que deben ser atendidos. De esta manera el CPU puede pausar momentáneamente la ejecución de un proceso para atender otros y así sucesivamente.

El PIC18F4550 cuenta con las siguientes interrupciones:

  • Externas: en este tipo de interrupciones, el microcontrolador utiliza uno de sus pines I/O para recibir la interrupción desde un dispositivo externo. Estas a su vez pueden ser: INT: denominadas “Edge-Triggered” debido a que se pueden programar para activarse en su flanco de subida o flanco de bajada. Son las interrupciones idóneas para controlar dispositivos externos. De cambio en PORTB: “Interrupt-On-Change”, es un tipo de interrupción que utiliza los bits RB4:RB7 del PIC, la interrupción se activará cuando en alguno de estos pines se produzca un cambio de estado de 1 a 0 o viceversa.
  • Periféricas: son interrupciones que se originan en los módulos periféricos internos (dentro del encapsulado) del microcontrolador, tales como: TIMER, ADC, EUSART, CCPx, etc.

 

Interrupciones de Cambio de PORTB.

La interrupciones más simples son las de “Cambio en PORTB”, cuando están habilitadas el microcontrolador monitorea constantemente los pines KBI0, KBI1, KBI2 y KBI3 que corresponden a RB4, RB5, RB6 y RB7 respectivamente. Cualquier cambio de estado en estos pines activará una interrupción.

El registro INTCON, se utiliza para configurar y habilitar la interrupción de cambio en PORTB, su estructura es la siguiente:

INTCON

  • El bit RBIE: habilita la interrupción de cambio en PORTB al asignarle un valor de 1.
  • RBIF: es la bandera de interrupción de PORTB, se pondrá en 1 cada vez que se produzca un cambio en PORTB. Después de atender la interrupción debe ser inicializada en 0.
  • GIE: Es el bit de habilitación de interrupciones globales, debe activarse asignándole un valor de 1.

Cada vez que se produzca una interrupción, el microcontrolador ejecutará un método, cuya firma típica es: void interrupt isr(void) {}. Inicialmente, dentro de este método se debe verificar que bandera de interrupción está activada para así poder atenderla por medio del código correspondiente. El siguiente segmento de código muestra la estructura básica del método.


void interrupt isr(void)
{
 if(RBIF) //Si hay cambio de estado en PORTB
 {
 //Código de atención de la interrupción
 RBIF = 0; //Desactivar bandera...
 }
}

Siempre se debe verificar si la bandera de interrupción deseada está activada ya que en una aplicación real se tienen varias interrupciones habilitadas.

Ejemplo de implementación

Para demostrar cómo utilizar la interrupción de cambio en puerto B, utilizaremos el siguiente circuito:

10_INT_PORTB

El funcionamiento es simple, el microcontrolador mostrará constantemente un conteo de 0 a 255 en el puerto B. Si se produce un cambio en el puerto B, se detendrá el conteo y se mostrará en los leds en que bit se ha producido el cambio. Ej. Si se cambió el estado de KBI0, se mostrará 00000011, si el cambio sucedió en KBI1 se mostrará 00001100 y así sucesivamente. Pasado un segundo, se continuará con el conteo. El código es el siguiente:


#include <xc.h>;

//BITS DE CONFIGURACION.....
#pragma config PLLDIV = 5, CPUDIV = OSC1_PLL2, USBDIV = 2
#pragma config FOSC = HSPLL_HS, FCMEN = OFF, IESO = OFF
#pragma config PWRT = OFF, BOR = OFF, VREGEN = OFF
#pragma config WDT = OFF, WDTPS = 32768
#pragma config MCLRE = ON, LPT1OSC = OFF, PBADEN = OFF
#pragma config STVREN = ON, LVP = OFF, ICPRT = OFF, XINST = OFF

#define _XTAL_FREQ 48000000

void retardo(int t);
int KBIx;
int old_PORTB = 0B11110000;

void main()
{
 ADCON1 = 0x0F;
 TRISB = 0xFF;
 TRISD = 0;
 PORTD = 0;


 INTCONbits.RBIE = 1; //Habilitar interrupciones de puerto B.
 INTCONbits.RBIF = 0; //Bandera desactivada.
 INTCONbits.GIE = 1; //Interrupciones globales habilitadas.

 while(1)
 {
 for(int i = 0; i <= 255;i++)
 {
 PORTD = i;
 retardo(10);
 }
 }
}

void interrupt isr(void)
{
 if(RBIF) //Si hay cambio de estado en PORTB
 {
 //==============================================
 //Según datasheet debe incorporarse esto...
 if(PORTB)
 {
 asm("nop");
 }
 //==============================================
 KBIx = PORTB ^ old_PORTB; //Hacemos una operación XOR
 old_PORTB = PORTB;
 KBIx = KBIx >> 4;
 switch(KBIx)
 {
 case 1:
 PORTD = 0B00000011;
 break;
 case 2:
 PORTD = 0B00001100;
 break;
 case 4:
 PORTD = 0B00110000;
 break;
 case 8:
 PORTD = 0B11000000;
 break;
 }
 retardo(100);
 RBIF = 0; //Desactivar bandera...
 }
}

void retardo(int t)
{
 for(int i = 0; i <= t; i++)
 {
 __delay_ms(10);
 }
}

El microcontrolador detectará cambios en el puerto B cuando se hace una transición de 0 a 1 y viceversa, esto último podemos comprobarlo manteniendo presionado el botón por más de un segundo y posteriormente soltarlo.

En conclusión, este tipo de interrupción es muy simple y nos ha servido como base para que en futuros artículos podamos abordar las interrupciones de los módulos internos del microcontrolador (nuestro principal objetivo). Volveré posteriormente abordando el tema de las interrupciones externas. Saludos a tod@s desde El Salvador.

03 – Conversión de Analógico a Digital con librería ADC.h de C18

Continuando con la implementación de librerías C18, ha llegado el turno de adc.h, esta librería nos facilita el trabajo de conversión A/D ahorrándonos bastante código. Como siempre nos basaremos en el documento de Microchip: MPLAB_C18_Libraries_51297f.

Circuito de aplicación

Partimos describiendo el circuito de aplicación que es el siguiente:

Circuito de aplicación

El circuito es sencillo ya que únicamente tiene como finalidad demostrar el funcionamiento del módulo AD del microcontrolador. En el circuito, se utiliza el canal AN0 (RA0), los niveles analógicos son proporcionados por el potenciómetro de 10K y monitoreados por el voltímetro, el microcontrolador realizará la conversión y mostrará el valor digital (en binario) en el puerto D por medio de un conjunto de leds.

Consideraciones sobre el módulo AD del PIC18F4550

  • El PIC18F4550 posee un modulo AD de 13 canales, esto significa que solamente podemos utilizar un canal por vez (no es posible la conversión simultánea).
  • La resolución de la conversión es de 10 bits (2∧10 = 1024), por lo tanto tendremos 1024 – 1 = 1023 posibles valores.
  • El valor del escalón de la conversión si el voltaje de entrada máximo es de 5V será de: 5V/1023 = 0.004887V. Por ejemplo, si se ajusta el potenciómetro para entregar un voltaje de 3.5V tendremos que: 3.5V /0.004887V = 716 (valor digital), al convertir 716 a binario tenemos:  1011001100 (Este será el resultado que se mostrará en el puerto D).

Librería adc.h de C18

Originalmente creada para C18, puede utilizarse con XC8 y MPLAB X. Las funciones que la librería proporciona son las siguientes:

funciones libreria adc

Las funciones que utilizaremos son:

OpenADC(), se utiliza para configurar el módulo AD, requiere tres parámetros de configuración: origen de la señal de reloj para el módulo AD, la alineación de la conversión, y el tiempo de adquisición de datos (xTAD). El segundo parámetro se utiliza para indicar: el canal a utilizar (AN0 – AN12), estado de la interrupción AD, y los voltajes de referencia positivo y negativo. Finalmente, el tercer parámetro es un valor decimal que representa la configuración del registro ADCON1.

El siguiente es el ejemplo de aplicación:

 OpenADC(ADC_FOSC_64 &
 ADC_RIGHT_JUST &
 ADC_16_TAD,
 ADC_CH0 &
 ADC_INT_OFF &
 ADC_VREFPLUS_VDD &
 ADC_VREFMINUS_VSS,
 14);

**Para información sobre el origen de los valores de configuración se sugiere leer la hoja de especificaciones del PIC18F4550 pág. 259.

Cabe aclarar, que los parámetros de OpenADC() cambian de acuerdo al PIC que se está utilizando.

ConvertADC(), inicia el proceso de conversión.

ReadADC(), devuelve un número entero que representa el valor decimal de la conversión efectuada.

BusyADC(), hace una espera mientras el proceso de conversión AD se lleva a cabo.

Código de aplicación

Creamos entonces, un nuevo proyecto en MPLAB X e incorporamos el siguiente código:

#include <xc.h>
#include <plib/adc.h>
#include <plib/delays.h>
#include "stdlib.h"

//Bits de configuración para Fosc = 48Mhz
#pragma config PLLDIV = 5, CPUDIV = OSC1_PLL2, USBDIV = 2
#pragma config FOSC = HSPLL_HS, FCMEN = OFF, IESO = OFF
#pragma config PWRT = OFF, BOR = OFF, VREGEN = OFF
#pragma config WDT = OFF, WDTPS = 32768
#pragma config MCLRE = ON, LPT1OSC = OFF, PBADEN = OFF
#pragma config STVREN = ON, LVP = OFF, ICPRT = OFF, XINST = OFF

#define _XTAL_FREQ 48000000

int resultado;

void main()
{
 TRISD = 0;
 PORTD = 0;

 /*Configuración del módulo AD
 * Fosc = 64
 * Alineación = derecha
 * 16 TAD
 * Canal AN0
 * Interrupción deshabilitada
 * VREF+ y VREF- conectados a VDD y VSS respectivamente
 * Valor de ADCON1 = 14 (Canal AN0 analógico, el resto digitales)
 */
 OpenADC(ADC_FOSC_64 &
 ADC_RIGHT_JUST &
 ADC_16_TAD,
 ADC_CH0 &
 ADC_INT_OFF &
 ADC_VREFPLUS_VDD &
 ADC_VREFMINUS_VSS,
 14);

 //Retardo de 50 Tcy
 Delay10TCYx(5);

 while(1)
 {
 //Iniciar la conversión
 ConvertADC();

 //Espera para que se complete la conversión
 while(BusyADC());

 //Capturando el resultado
 resultado = ReadADC();

 /*Como el resultado es de 10 bits
 * y sólo se dispone de un puerto de 8 bits
 * para mostrarlo. El resultado se convierte
 * en su equivalente de 8 bits dividiendo
 * por cuatro.
 */
 resultado = resultado / 4;

 //Mostrando el resultado
 PORTD = resultado;
 }
}

Bastará con compilar y verificar el funcionamiento en Proteus para ver los resultados, sería interesante comprobar que matemáticamente los valores digitales corresponden al nivel del voltaje entrada analógico (no olvidar que el resultado de 10 bits se está convirtiendo a 8 bits).

El siguiente video muestra la implementación en una placa de desarrollo:

Volveré posteriormente con un ejemplo de conversión A/D utilizando interrupciones.

Saludos a tod@s

02 – Modificando la librería XLCD

En el post anterior, expliqué brevemente como utilizar la librería XLCD para controlar un display LCD 16×2. Sin embargo, si tenemos circuitos en donde debido a requerimientos debemos conectar el display a otro puerto, será necesario realizar cambios en las macro de la librería, este es nuestro objetivo: explicar como realizar cambios en la librería xlcd y salir vivos en el intento.

El circuito

En mi caso particular y que utilizaré como ejemplo, dispongo de una placa de desarrollo en donde el conector para el display LCD tiene la siguiente disposición de pines:

Pines LCD

Lo cual se traduce en el siguiente diagrama esquemático:

lcd pic-ek

La nueva asignación de pines para el display LCD respecto al microcontrolador sería:

  • Puerto de datos: Puerto D.
  • Modo de operación: 8 bits (D0:D7).
  • LCD RS: B5
  • LCD RW: B4
  • LCD E: B3

Muy bien, entonces ¿Qué necesitamos para adecuar la librería a nuestra nueva distribución de pines? En esencia, lo siguiente:

  1. Proporcionar permisos de modificación a la carpeta donde se encuentran los archivos de la librerías C18 o ejecutar MPLAB como administrador.
  2. Crear un proyecto en MPLAB X y editar el código del programa (ver el post anterior).
  3. Copiar los archivos fuente de la librería XLCD a nuestro proyecto.
  4. Modificar las macro en el archivo xlcd.h
  5. Compilar y comprobar el funcionamiento.

Teniendo en cuenta todo lo anterior iremos paso a paso.

1. Proporcionando permisos de modificación a las librerías C18.

Las librerías se copian en el directorio de instalación del compilador XC8, si tienen instalado un Windows de 32 bits será:

C:\Program Files\Microchip\xc8\v1.30\include\plib

Si es de 64 bits:

C:\Program Files(x86)\Microchip\xc8\v1.30\include\plib

NOTA: Las rutas pueden cambiar dependiendo del directorio de instalación, la unidad seleccionada durante el proceso de instalación y la versión del compilador.

Una vez ubicada la carpeta, se procede a proporcionar todos los permisos a los usuarios de la computadora sobre la carpeta plib.

Ahora bien, si se nos complica mucho hacer esto, podemos ejecutar MPLAB X como administradores con lo cual tendremos los permisos necesarios. Para hacer que MPLAB X se ejecute siempre como Administrador, se da clic derecho al icono, se selecciona la pestaña Compatibilidad y se marca la casilla “Ejecutar este programa como administrador“.

2. Creando el proyecto en MPLAB X

Incorporamos el código tal cual publiqué en el post anterior, pero debemos hacer una modificación en el modo de datos ya que ahora debe ser de ocho bits, colocaremos:

//Configurando LCD 8 bits mutilínea
 OpenXLCD(EIGHT_BIT & LINES_5X7);

3. Copiando los archivos fuente de la librería.

Los archivos fuente de la librería xlcd.h (y de todas las demás), se encuentran en la siguiente ruta: C:\Program Files\Microchip\xc8\v1.30\sources\pic18\plib\XLCD

Copiamos todas los archivos y los pegamos en la carpeta de nuestro proyecto.

Archivos de la librería

Ahora en MPLAB X, procedemos a agregar los archivos copiados, para lo cual se damos clic derecho en Source Files, y seleccionamos Add Existing Item …

Agregar archivos

Seleccionamos todos los archivos y damos clic en Select.

4. Modificando las macros de la librería xlcd.h

Es momento de modificar las macros, para ello nos ubicamos en en la sentencia #include “plib/xlcd.h”, damos clic derecho, seleccionamos Navigate y posteriormente Go to Declaration.

Declaracion de xlcd

MPLAB X, abrirá el archivo de código de la librería xlcd.h, en donde haremos la primer modificación ajustando el modo de datos a 8 bits, esto lo hacemos quitando el comentario de la línea 26, dejándola así:

/* Interface type 8-bit or 4-bit
 * For 8-bit operation uncomment the #define BIT8
 */
 #define BIT8

A continuación, comentamos las líneas 34 y 35 que definen el puerto de datos y agregamos la asignación al puerto D:

/* DATA_PORT defines the port to which the LCD data lines are connected */
// #define DATA_PORT PORTB
// #define TRIS_DATA_PORT TRISB
#define DATA_PORT PORTD
#define TRIS_DATA_PORT TRISD

Cambiamos la definición de los pines RW y E del LCD, comentando el código por defecto y agregando las nuevas definiciones, dejando el código de la siguiente manera:

/* CTRL_PORT defines the port where the control lines are connected.
 * These are just samples, change to match your application.
 */
 //#define RW_PIN LATBbits.LATB6 /* PORT for RW */
 //#define TRIS_RW TRISBbits.TRISB6 /* TRIS for RW */

 #define RW_PIN LATBbits.LATB4
 #define TRIS_RW TRISBbits.TRISB4

 #define RS_PIN LATBbits.LATB5
 #define TRIS_RS TRISBbits.TRISB5

 //#define E_PIN LATBbits.LATB4 /* PORT for D */
 //#define TRIS_E TRISBbits.TRISB4 /* TRIS for E */

 #define E_PIN LATBbits.LATB3
 #define TRIS_E TRISBbits.TRISB3

5. Compilar y comprobar el funcionamiento.

Procedemos a compilar el proyecto, esto tomará un poco de tiempo ya que se procesará cada uno de los archivos de código incorporados al proyecto. Si no tenemos errores procedemos a comprobar el funcionamiento en PROTEUS.

Prueba

 

El siguiente video muestra la implementación en el circuito.

 

Conclusiones

Modificando las macros de la librería  podemos utilizarla con casi cualquier variante de conexiones de puerto que se diseñe. Aunque no se haya descrito en este post, la librería se puede configurar para que trabaje en modo de 4 bits con lo que se libera la mitad de los bits del puerto D los cuales podrían ser utilizados para otros fines, dejaré esto como una pequeña tarea a todos aquellos a quienes les haya parecido interesante utilizar la librería.

Volveré posteriormente con otro post en donde explicaré como utilizar la librería ADC.h del módulo convertidor Analógico a Digital para que posteriormente podamos integrar las librerías xlcd.h y adc.h para implementar un sencillo voltímetro digital.

Saludos a tod@s desde El Salvador…

01 – Librería XLCD para el manejo de displays LCD

XLCD.h es una librería del compilador C18 de Microchip, que se utiliza para controlar displays LCD. Esta librería puede utilizarse con XC8 para realizar la misma función.

En la guía MPLAB para las librerías del compilador C18 (pág. 75) se explican detalladamente las funciones disponibles así como los argumentos de cada una de ellas. También, proporciona un pequeño ejemplo de implementación. Recomiendo que se revise dicho documento para comprender con mayor facilidad el código que aquí se muestra. El display que vamos a utilizar es un 16×2 basado en el controlador HITACHI HD44780, el cual es ampliamente utilizado en circuitos de visualización microcontrolados.

El circuito.

La librería viene pre configurada (xc8 ver 1.2) de la siguiente manera:

  • Puerto de datos: Puerto B.
  • Modo de operación: 4 bits, parte baja del puerto B (B0:B3). Esto significa que B0 debe conectarse a D4 del display, B1 a D5, B2 a D6 y B3 a D7.
  • LCD RS: B5
  • LCD RW: B6
  • LCD E: B4

Esta configuración es muy eficiente ya que podemos controlar el display con un solo puerto, el circuito de prueba en Proteus sería similar al siguiente:

CIrcuito LCD

En el circuito no se muestra el cristal de cuarzo a utilizar que en este caso será de 20MHZ, de manera que el oscilador se configurará convenientemente para proporcionar un Fosc = 48MHZ. De acuerdo con el datasheet del microcontrolador (pág. 30) PLLDIV debe ser = 5, para proporcionar 4MHZ al circuito PLL y HSPLL debe ser = 2 (96MHZ /2) para asegurar 48MHZ como Fosc. La definición precisa del Fosc es vital cuando se utiliza la librería XLCD por lo tanto, se debe procurar que la Fosc deseada esté correctamente configurada.

Funciones de retardo requeridas.

La librería requiere que el usuario defina los siguientes retardos para el display:

Funciones de retardo de xlcd

Estas funciones deben calcularse manualmente tomando como base la Fosc anteriormente configurada. Veamos en detalle cada una de ellas:

DelayFor18TCY: requiere 18 ciclos de instrucción, hay dos métodos para conseguir este retardo. Un método consiste en repetir secuencialmente unas doce veces la función Nop(). La otra manera es utilizar la función Delay10TCYx() pasándole como argumento un valor entero que represente el retardo equivalente a 18TCY, haciendo unos cálculos se puede decir que este valor anda por 2.5 por MHZ. Entonces, estamos trabajando con un Fosc = 48MHZ tendríamos que 2.5 x 48 = 120, la función nos quedaría Delay10TCYx(120). Personalmente prefiero este segundo método, la función completa sería así:

void DelayFor18TCY(void)
{
 Delay10TCYx(120);
}

DelayPORXLCD: se utiliza para implementar un retardo de 15ms. Para este caso se utiliza la ecuación (15ms x 48MHZ) / 4, que nos da como resultado 180000, tomamos 180 como argumento para el método, de manera que el código sería:

void DelayPORXLCD(void)
{
 Delay1KTCYx(180);
 return;
}

DelayXLCD: se utiliza para implementar un retardo de 5ms, aplicamos la misma ecuación de manera que: (5ms x 48MHZ) / 4, nos da como resultado 60000, tomamos 60 como argumento para el método:

void DelayXLCD(void)
{
 Delay1KTCYx(60);
 return;
}

Utilizando las ecuaciones anteriores, podemos adecuarnos perfectamente o cualquier otro Fosc soportado por el microcontrolador.

El código completo es el siguiente:

#include <xc.h>
#include <stdio.h>
#include <stdlib.h>
#include <plib/xlcd.h>
#include <plib/delays.h>

//CON ESTE ORDEN DE CONFIGURACION FUNCIONA RB5.....
#pragma config PLLDIV = 5, CPUDIV = OSC1_PLL2, USBDIV = 2
#pragma config FOSC = HSPLL_HS, FCMEN = OFF, IESO = OFF
#pragma config PWRT = OFF, BOR = OFF, VREGEN = OFF
#pragma config WDT = OFF, WDTPS = 32768
#pragma config MCLRE = ON, LPT1OSC = OFF, PBADEN = OFF
#pragma config STVREN = ON, LVP = OFF, ICPRT = OFF, XINST = OFF

#define _XTAL_FREQ 48000000

//Retardos requeridos por la librería XLCD
void DelayFor18TCY(void);
void DelayPORXLCD(void);
void DelayXLCD(void);

int main() {
 //Configurando LCD 4 bits mutilínea
 OpenXLCD(FOUR_BIT & LINES_5X7);
 //Esperar hasta que el display esté disponible.
 while(BusyXLCD());
 //Mover cursor a la derecha...
 WriteCmdXLCD(0x06);
 //Desactivando el cursor.
 WriteCmdXLCD(0x0C);

 while(1)
 {
 //Primera línea
 SetDDRamAddr(0x00);
 putrsXLCD("HOLA");
 //Segunda línea
 SetDDRamAddr(0x40);
 putrsXLCD("MUNDO");
 }

}
void DelayFor18TCY(void)
{
 Delay10TCYx(120);
}

void DelayPORXLCD(void)
{
 Delay1KTCYx(180);
 return;
}

void DelayXLCD(void)
{
 Delay1KTCYx(60);
 return;
}

Al simular en Proteus veríamos lo siguiente:

Simulacion

Consideraciónes sobre la implementación en el circuito.

Como se puede observar en la configuración de los bits del microcontrolador, he colocado un comentario respecto a RB5, esto se debe a que he notado que algunas veces el puerto B funciona erróneamente cuando se coloca la configuración autogenerada por MPLABX mediante la herramienta “Configuration bits”. Por lo general utilizo esta herramienta, pero en este caso particular para evitar estos “extraños errores” prefiero editar los bits de configuración manualmente, dejándolos tal como se observa en el código anteriormente mostrado. Aclaro que este comportamiento anómalo se da únicamente en el circuito real no en la simulación. El siguiente micro video muestra la ejecución en el circuito:

Conclusiones.

Utilizar la librería XLCD es sencillo, pero que pasaría si ya tenemos un circuito previamente diseñado que no utiliza el puerto B como puerto de datos,  en este caso debemos modificar las macro de la librería y compilarla nuevamente, aprovechando que la placa de desarrollo que estoy utilizando tiene conectado el display al puerto D, explicaré posteriormente como cambiar las configuraciones por defecto.

Librerías XC8 (C18) para microcontroladores PIC18

Con esta entrada, voy a iniciar una serie de mini-guías explicando como utilizar las librerías del compilador XC8 (antes C18) para microcontroladores PIC18. Para estas guías se tomará como base el popular microcontrolador PIC18F4550 de bajo costo y muy buenas prestaciones. Aclaro, que con estas guías no pretendo sustituir ninguna otra existente, ni proponer algoritmos y estrategias de programación ya que no soy programador profesional sino un simple hobbista por lo que los circuitos y códigos propuestos son producto de la experimentación (Si, todos funcionan…) de manera que siempre será posible que se puedan encontrar mejores diseños.

Por otra parte, si bien las librerías facilitan enormemente el trabajo del programador, tienen el inconveniente de hacer que los programadores dejen de conocer los registros de control de los periféricos integrados (timers, ADC, PWM, UART, etc.) del microcontrolador. En mi humilde experiencia, es necesario conocer dichos registros para saber o al menos tener una idea de como configurar “manualmente” dichos periféricos para así comprender lo que las librerías hacen por medio de los métodos que proporcionan.

También es indispensable tener conocimiento del lenguaje C, electrónica analógica y digital, y obviamente de microcontroladores PIC. En otras palabras, estas mini-guías están orientadas a aquellos que ya han trabajado con microcontroladores y buscan una manera mas sencilla de realizar sus programas.

¿Qué se necesita?

  • Compilador XC8. En las versiones mas recientes de XC8, ya no se incluyen las librerías periféricas XC8, por lo que es necesario instalarlas por separado, consulte aquí para mayor información.
  • MPLAB X
  • Un software de simulación de circuitos microcontrolados como PROTEUS.
  • Una placa de desarrollo.
  • Un programador.
  • Microcontrolador PIC18F4550 y su datasheet.
  • Guía de referencia de las librerías del lenguaje C para microcontroladores PIC.

Respecto a la placa de desarrollo, puede ser cualquiera para PIC DIP40 o se puede montar en breadboard, en cuanto al programador yo utilizo bastante el PICKIT3 (se puede adquirir un clon en ebay por USD $30) o el CANAKIT PICKIT2.

También hay un programador buenísimo llamado BRENNER 8, el cual recomiendo para todos aquellos que quieran montar su propio programador profesional, mis alumnos han montado en varias ocasiones este programador por lo que el funcionamiento está garantizado. Eso sí, está en alemán, pero nada que no pueda solucionarse con un buen traductor, al igual que los programadores antes mencionados, el brenner 8 permite programar microcontroladores usando el ICSP.

Por el momento, llegaré hasta acá con esta pequeña introducción volveré posteriormente con la primer mini-guía que estará orientada al manejo de la librería XLCD.

Saludos,