Aprendiendo a programar Microcontroladores PIC en Lenguaje C con CCS

Los compiladores de lenguaje C hoy son ampliamente utilizados para la creacin de programas con microcontroladores PIC. El compilador que mejor soluciona las necesidades del programador enmascarando el hardware y simplificando la implementacin de una aplicacin es el fabricado por la compaa CCS. Por Andrs Ral Bruno Saravia

Entrega N 2.
En nuestra entrega anterior aprendimos a crear un proyecto dentro del MPLAB para escribir nuestro primer cdigo en lenguaje C, hoy crearemos nuestro primer cdigo y aprenderemos la funcin que cumplen sus elementos principales .

Creando Nuestro Primer Cdigo

Ya que hemos aprendido a crear nuestro primer proyecto, escribiremos nuestro primer cdigo, el cual adicionaremos a nuestro proyecto. Para ello nos moveremos con el Mouse hasta el cono de New File y haremos clic sobre el mismo:

Y se desplegar una nueva ventana en la cual escribiremos el cdigo de nuestro programa. Por ser este nuestro primer programa, simplemente haremos titilar un LED con un tiempo de flashing de 500ms. La idea es introducirnos de a poco, y muchas veces querer comenzar con un cdigo demasiado elaborado es complejo.
#include<16f887.h> #use delay(osc=4000000) //configura fusibles de configuracin #fuses XT //Oscilador a cristal standar #fuses NOWDT //sin WatchDog Timer #fuses NOPROTECT //sin proteccion de memoria de programa #fuses NOPUT //sin PowerUp Timer #fuses NOBROWNOUT //sin brownout #fuses NOLVP //sin programacin en baja tensin //rutina principal void main(void) { //abrimos la funcin principal Setup_adc_ports(NO_ANALOGS);//configuramos los puertos digitales while(1) //creamos un bucle infinito { //abrimos el bucle output_high(PIN_B0); //prendemos RB0 delay_ms(500); //esperamos 500 ms output_low(PIN_B0); //borramos RB0 delay_ms(500); //esperamos 500 ms } //cerramos el bucle //cerramos la funcin principal

Este cdigo lo hemos escrito en lo que se conoce en la jerga tcnica como codigo en C nativo ya que usamos las funciones de control de entrada / salida de CCS El cdigo inicia siempre en lo que se conoce como cabecera, es decir el principio. En esta cabecera encontraremos instrucciones dirigidas al compilador y no al microcontrolador, dichas instrucciones se denominan directivas. Las directivas se diferencian de las instrucciones en que: Siempre se encuentran en la cabecera del programa Todas comienzan con el smbolo del numeral #

En nuestro caso estas son las directivas:

#include<16f887.h> #use delay(crystal=4000000) //configura fusibles de configuracin #fuses XT //Oscilador a cristal standar #fuses NOWDT //sin WatchDog Timer #fuses NOPROTECT //sin proteccion de memoria de programa #fuses NOPUT //sin PowerUp Timer #fuses NOBROWNOUT //sin brownout #fuses NOLVP //sin programacin en baja tensin

La directiva : #include<16f887.h> nos permite decirle al compilador para que microcontrolador hemos escrito el cdigo.

Seguidamente con la directiva #use delay(crystal=4000000) le indicamos a que frecuencia esta funcionando nuestro oscilador. El orden de las directivas es crucial ya que siempre primero debemos indicarle al compilador cual es el PIC que estamos usando y luego cual es la frecuencia del oscilador. Posteriormente podemos agregar el resto de directivas. Si esto no se respeta podemos tener errores en el proceso de compilacin sobre todo cuando usamos alguna funcin propia del compilador (llamadas funciones embebidas) para manejar algn perifrico, y que la misma necesita saber la frecuencia del oscilador. La directiva puede tener distintas formas ya que amolda la configuracin interna a la frecuencia que le indicamos. As esta directiva nos permite activar multiplicadores y divisores internos, o accionar los osciladores internos cuando el microcontrolador los trae; por ejemplo:
#use delay(crystal=4000000, clock=16000000)

Le indica al compilador que tenemos un cristal externo de 4Mhz, y que la frecuencia que llega a la CPU es de 16Mhz, por lo tanto el compilador configurar correctamente el PLL de la CPU para alcanzar los 32Mhz. Otro ejemplo pero usando el reloj interno es el siguiente:
#use delay(internal=8000000, clock=16000000)

Sin embargo esta directiva debe usarse con precaucin ya que el clock que definimos nunca debe sobrepasar la mxima velocidad de procesamiento del PIC que se est usando. Este parmetro se denomina MIPS (Millones de Instrucciones por Segundo) y se obtiene dividiendo la frecuencia de entrada por cuatro.
MIPS = fosc/4

La directiva #fuse xx nos permite activar o desactivar las caractersticas del nucleo, como ser el circuito de Watch Dog Timer, que reseta al microcontrolador ante un cuelgue del mismo, el Brown Out Detect, que resetea el microcontrolador ante un fallo de la alimentacin, el tipo de oscilador, etc. Las etiquetas usadas para activar o desactivar la propiedad, estn incluidas en el archivo de cabecera y deben ser consultadas siempre, ya que las mismas suelen cambiar entre versiones del compilador o tipos de microcontroladores. En lneas generales podemos decir que anteponiendo la palabra NO al fusible de configuracin (as se llama al seteo de las propiedades), se le informa al compilador que el fusible en cuestin est desactivado, mientras que colocando solo el nombre activamos la propiedad. Por otra parte para activar o desactivar los distintos fusibles se puede realizar en varias lneas (como en el ejemplo) o se pueden activar y desactivar en una sola lnea separando cada fusible con comas:
#fuse NOWDT,HS,NOPUT,NOLVP,NOMCLR,NOPROTECT,NOBROWNOUT

La cabecera adems puede incorporar redefinicin de nombres de pines, definicin de variables y constantes. Y prototipo de funciones. Esto ser visto en nuestras prximas lecciones.

Finalizada la cabecera, contina el cdigo, que es el que se traducir en instrucciones al microcontrolador luego del proceso de compilacin. En nuestro caso nuestro cdigo es bastante sencillo:
void main(void) { //abrimos la funcin principal setup_adc_ports(NO_ANALOGS);//configuramos los puertos digitales while(1) //creamos un bucle infinito { //abrimos el bucle output_high(PIN_B0); //prendemos RB0 delay_ms(500); //esperamos 500 ms output_low(PIN_B0); //borramos RB0 delay_ms(500); //esperamos 500 ms } //cerramos el bucle //cerramos la funcin principal

Todo programa siempre inicia en una rutina principal. En el lenguaje C las rutinas se denominan funciones. Las funciones son un conjunto de sentencias u ordenes que realizan una operacin determinada, como lo hacen las rutinas, sin embargo las funciones tiene una caracterstica extra; a ellas se les puede pasar valores de variables para que las procesen, y son capaces de devolvernos los resultados de dichos procesos. Bsicamente actan como las funciones matemticas. Todo programa C siempre inicia en la funcin principal, la cual se denomina main. Dicho nombre no puede ser distinto, todo programa debe tener una funcin main, de lo contrario el compilador nos indicar un error. La funcin encierra una serie de sentencias, las cuales forman el bloque de dicha funcin. Dicho bloque inicia con una llave { y finaliza con otra llave } . Entre estas dos llaves se encuentran las sentencias y las estructuras lgicas. La funcin main es una funcin especial ya que no puede recibir ningn valor, ni tampoco puede devolver uno. Por lo tanto observe que va acompaada por dos palabras void lo cual en el lenguaje C significa vaco; es decir que no devuelve ningn valor (primer void) ni puede recibir ningn valor, (segundo void, el cual esta encerrado entre parntesis).
void main(void) { Nuestro cdigo }

Nuestro cdigo lo hemos escrito en formato CCS nativo. Esto significa que hemos usado todas las funciones embebidas (incluidas dentro) del compilador para simplificar la escritura del cdigo y que nos ahorran mucho tiempo. Debe observarse que cada lnea la hemos decalado (separado del origen) por medio del TABULADOR; esto es una buena prctica para poder advertir a simple vista cuales sentencias son las que estas anidadas dentro de cada bloque del programa principal. La primera lnea o sentencia le indica al compilador que debe desactivar todos los puertos analgicos del PIC y que debe configurarlos como puertos digitales:
setup_adc_ports(NO_ANALOGS);

Usamos la funcin embebida setup_adc_ports, la cual esta embebida en el compilador, y que se encarga bsicamente de setear que puertos van a trabajar como analgicos y que puertos van a trabajar como digitales. La funcin configura los bits PCFG o ANSEL dependiendo con que PIC estemos trabajando y lo realiza de forma automtica. Observe que hemos escrito entre parntesis NO_ANALOGS lo cual le dice al compilador que no hay puertos analgicos. Esta etiqueta la obtenemos del archivo de cabecera del procesador (16f887.h). Es importante resaltar que las etiquetas siempre van en mayusculas, mientras que las instrucciones se escriben en minscula. Es muy importante que se respete el orden mayscula-minscula pues el compilador es sensible a ello. Si escribimos una instruccin con mayscula, NO LA IDENTIFICAR. Debe observarse tambin que las sentencias siempre terminan con un punto y coma. La siguiente sentencia de nuestro cdigo es una instruccin estructural: while El while es una instruccin condicional la cual determina la ejecucin de una o mas instrucciones en tanto y en cuanto se cumpla una condicin, la cual se encierra entre parntesis. En programacin, si una condicin se cumple, se dice que es verdadera, y esto se simboliza con el nmero 1; por el contrario, si la condicin no se cumple, es falsa y se simboliza con el nmero 0. En un while, lo que este dentro del bloque del mismo, se ejecutar, siempre que la condicin de verdadera, caso contrario no se ejecutar ninguna sentencia que se encuentre dentro del while. En nuestro caso hemos forzado la condicin 1, con lo cual el while se ejecutar eternamente. Es decir que las sentencias encerradas dentro del bloque while (limitado por las llaves{}), se ejecutaran por siempre. Observe que dentro del while usamos tambin funciones embebidas:
output_high(PIN_B0); output_low(PIN_B0);

Estas son funciones de salida de datos, se encargan de poner en uno o en cero un puerto, el cual la misma funcin se encarga de configurar como salida, no debe hacerlo el programador. Entre parntesis le indicamos el PIN a encender o apagar. En nuestro caso es el RB0, al cual CCS lo denomina dentro del archivo de cabecera del microcontrolador como PIN_B0. Este formato si bien parece en principio raro porque no se adapta al usado en el data sheet, es prctico para los programadores NO ELECTRNICOS, y es el que ha adoptado CCS. Por ejemplo el RA0 CCS lo llama PIN_A0, y al RC6, PIN_C6, y as sucesivamente. Otra de las sentencias usadas es
delay_ms(500);

La cual es una funcin de tiempo que nos permite crear un tiempo de espera en milisegundos. Tambin existe el delay_us que nos permite crear un delay de microsegundos. La exactitud de la funcin delay depende de que hayamos definido correctamente la frecuencia de clock. De esta forma hemos hecho falshear un LED en nuestro primer cdigo. Bueno, esto es todo por ahora , en las prximas entregas iremos descubriendo paso a paso las utilidades de la programacin en lenguaje C y del entorno CCS. Continuar ......